bb87928bce
Upstream: https://github.com/Rhoban/onshape-to-robot Upstream-Commit: 80e710700aac9573a2230f74f7ce9e094833a0bc Upstream-Branch: master
69 lines
2.0 KiB
ReStructuredText
69 lines
2.0 KiB
ReStructuredText
OpenSCAD pure shapes approximation
|
|
==================================
|
|
|
|
Introduction
|
|
------------
|
|
|
|
This processor provides you a way to manually approximate your robot into pure shapes.
|
|
|
|
You can follow the following `video tutorial <https://www.youtube.com/watch?v=C8oK4uUmbRw>`_. Some of the steps are outdated, but the general idea is still the same.
|
|
|
|
Requirements
|
|
------------
|
|
|
|
For this processor to work, you need to install the OpenSCAD package:
|
|
|
|
.. code-block:: bash
|
|
|
|
sudo apt-get install openscad
|
|
|
|
Process
|
|
-------
|
|
|
|
When the OpenSCAD processor is enabled (see below), it will check for the presence of ``.scad`` files in the output directory. If some are present, they will be parsed and pure shapes will be exported.
|
|
|
|
.. note::
|
|
|
|
By default, exporters will use pure shapes for collisions instead of meshes.
|
|
|
|
You can use the following convenient command to run OpenSCAD on a specific ``.stl`` you want to approximate:
|
|
|
|
.. code-block:: bash
|
|
|
|
onshape-to-robot-edit-shape <path_to_stl>
|
|
|
|
This will open a window similar to the following:
|
|
|
|
.. image:: _static/img/pure-shape.png
|
|
:align: center
|
|
:width: 400px
|
|
|
|
Editing the ``.scad`` file with the same name as the ``.stl`` file. Pure shapes present here will be used as approximation.
|
|
|
|
``config.json`` entries
|
|
-----------------------
|
|
|
|
.. code-block:: javascript
|
|
|
|
{
|
|
// ...
|
|
// General import options (see config.json documentation)
|
|
// ...
|
|
|
|
// Simplify STL meshes (default: false)
|
|
"use_scads": true,
|
|
// Can be used to enlarge/shrink the pure shapes (default: 0.0)
|
|
"pure_shape_dilatation": 0.0
|
|
}
|
|
|
|
``use_scads`` *(default: false)*
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
If set to ``true``, the processor will use OpenSCAD pure shapes approximation (see above)
|
|
|
|
``pure_shape_dilatation`` *(default: 0.0)*
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
A float that can be used to enlarge or shrink the pure shapes. This can be useful to avoid collisions between parts.
|
|
|
|
Use a negative value to shrink the shapes. |