This is a *WORK IN PROGRESS* snapshot of a utility I'm currently developing, which should allow us
to go straight from an OpenSCAD design, to a .3mf file usable in Bambu Studio for printing objects
in more than one colour.  Creating files that allow multicolour printing at the moment, using the
current OpenSCAD and Bambu Studio, does involve a bit of manual tweaking that this is intended to
do away with.

If anyone wants to try this out, just copy the files from here (there's also a zip and a tar archive
containing the same files) and type 'make'.  The executable this creates is called 'colorsep' and it
takes one parameter: a .csg file - email me at gtoal@gtoal.com if (or rather when) you find problems
with the rewritten csg output - I'm interested to know in what ways it fails.

You can convert the csg output to a .3mf file using openscad, which you may find quicker to do using
the command-line interface, with a command such as:

  openscad -o file.csg file.scad

after which you convert the .csg file using:

  ./colorsep file.csg > file.3mf

At the point that I'm writing this I haven't yet actually printed from the output of this process,
but I will shortly!  I'll update this README when I do.  Meanwhile if you're feeling brave, try it
out yourself on something small, or just look at the output file and compare it to the input file,
to see if you spot any obvious problems - I don't have a lot of OpenSCAD sources yet to test against.


Note there is some code in this directory for building the parser, which came from another project
of mine, 'uparse' (a Unicode-friendly parser generator) at https://github.com/gtoal/uparse - I just
included enough from that project to build the converter (which needed a CSG parser).  It's a bit of
a quick hack and when this project is working I'll try to repackage it in a way that doesn't include
all the extra code from the parser project...  You shouldn't need to look in the parser code at all!
(If you do want to look at the actual code, it's colorsep-filter.c that does the relevant work.)