<commit_before>Mandoline: A faster way to slice 3D models.
Copyright 2010 Belfry Software.  All rights reserved.

Licensing:
  Released under the BSD "2-clause" license.
  Check the LICENSE.txt file for full licensing info.

Description:
  Mandoline is a command-line program that slices 3D files into toolpaths for
  home-build thermoplastic-extrusion 3D printers like the RepRap or MakerBot.
  It can currently parse 3D input files in the .STL binary or ASCII formats.
  Output will be in G-Code or .S3G formatted files.  (Not yet implemented)

Compilation and Installation:
  UNIX, Linux and OS X:
      cd src
      ./configure
      make
      make install

  Windows:
    At this point, there is not yet a GUI wrapper for Mandoline.
    You can compile and use it from the CygWin environment, though.
    You'll need CygWin installed with gcc/g++ compilers and GNUMake.
      cd src
      ./configure
      make
    Then install the mandoline.exe file someplace useful.

    //TODO: verify that it compiles and works under Cygwin.

Calibration:
  Mandoline comes with reasonable starting defaults for slicing files for
  printing on a MakerBot CupcakeCNC with a Mk5 extruder.  Machines vary a
  lot, though, so you'll need to calibrate for your machine.

  //TODO: Come up with a good calibration scheme.

Usage:
  //TODO: document settings.
<commit_msg>added text from Wiki to Usage section of README.txt<commit_after>Mandoline: A faster way to slice 3D models.
Copyright 2010 Belfry Software.  All rights reserved.

Licensing:
  Released under the BSD "2-clause" license.
  Check the LICENSE.txt file for full licensing info.

Description:
  Mandoline is a command-line program that slices 3D files into toolpaths for
  home-build thermoplastic-extrusion 3D printers like the RepRap or MakerBot.
  It can currently parse 3D input files in the .STL binary or ASCII formats.
  Output will be in G-Code or .S3G formatted files.  (Not yet implemented)

Compilation and Installation:
  UNIX, Linux and OS X:
      cd src
      ./configure
      make
      make install

  Windows:
    At this point, there is not yet a GUI wrapper for Mandoline.
    You can compile and use it from the CygWin environment, though.
    You'll need CygWin installed with gcc/g++ compilers and GNUMake.
      cd src
      ./configure
      make
    Then install the mandoline.exe file someplace useful.

    //TODO: verify that it compiles and works under Cygwin.

Calibration:
  Mandoline comes with reasonable starting defaults for slicing files for
  printing on a MakerBot CupcakeCNC with a Mk5 extruder.  Machines vary a
  lot, though, so you'll need to calibrate for your machine.

  //TODO: Come up with a good calibration scheme.

Usage:
Mandoline is a lightning-fast command-line program that slices 3D files into toolpaths for home-build thermoplastic-extrusion 3D printers like the RepRap or MakerBot. It can currently parse 3D input files in .STL binary or ASCII formats. Output will be in G-Code or .S3G formatted files. (Not yet implemented)

At the moment it doesn't yet output toolpaths of any sort, so it's far less than useful. It's an alpha state progress demo, really.

You can dump SVG files for each layer, for debugging purposes. What is implemented is the basic carve and interior infill. And that's buggy. It won't do multiple shells and insets and rafts and comb yet.

What is implemented, though, is extremely fast. I mean OMGWTFBBQ fast. Don't take my word for it. Download the code and compile it, and slice a complex STL file with it. If comparing it to another slicer, compare the Carve and Infill times.

Usage:
mandoline [OPTIONS] FILE.stl
Options include:

  -i FLOAT    Infill density.  From 0.0 to 1.0.
  -l FLOAT    Layer thickness. (mm)
  -f FLOAT    Filament diameter. (mm)
  -F FLOAT    Filament feedrate. (mm/sec)
  -r FLOAT    Width/Thickness ratio.
  -p INT      Number of perimeter shells. (Not implemented yet)
  -s FLOAT    Scale model by factor.
  -r FLOAT    Rotate by X degrees around Z axis.
  -t INT      Number of Threads in threadpool.
  -d STRING   For every layer, saves an SVG file with the given prefix.
{'fraction_non_alphanumeric': 0.048274197441467534, 'fraction_numerical': 0.00724112961622013, 'mean_word_length': 3.202839756592292, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2160992', 'n_tokens_mistral': 1259, 'n_tokens_neox': 1172, 'n_words': 612}