Import upstream snapshot 80e710700aac9573a2230f74f7ce9e094833a0bc

Upstream: https://github.com/Rhoban/onshape-to-robot
Upstream-Commit: 80e710700aac9573a2230f74f7ce9e094833a0bc
Upstream-Branch: master

docs/source/processor_simplify_stls.rst

@@ -0,0 +1,45 @@
+Simplify STLs
+=============
+
+Introduction
+------------
+
+This processor will simplify the STLs files so that their size don't exceed a predefined limit.
+Used with :ref:`processor-merge-parts`, it will simplify the merged STLs.
+
+Requirements
+------------
+
+For this processor to work, ensure pymeshlab is installed:
+
+.. code-block:: bash
+
+    pip install pymeshlab
+
+``config.json`` entries
+-----------------------
+
+.. code-block:: javascript
+
+    {
+        // ...
+        // General import options (see config.json documentation)
+        // ...
+
+        // Simplify STL meshes (default: false)
+        "simplify_stls": true,
+        // Maximum size of the STL files in MB (default: 3)
+        "max_stl_size": 1
+    }
+
+``simplify_stls`` *(default: false)*
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If set to ``true``, the STL files will be simplified.
+
+``max_stl_size`` *(default: 3)*
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The maximum size of the STL files in MB. If the size of a file exceeds this limit, it will be simplified.
+
+You can also set it to ``"visual"`` to simplify only the visual parts, or to ``"collision"`` to simplify only the collision parts.