.. _eu.gmic.3drandomobjects:

G’MIC 3d random objects node
============================

*This documentation is for version 1.0 of G’MIC 3d random objects.*

Description
-----------

Wrapper for the G’MIC framework (http://gmic.eu) written by Tobias Fleischer (http://www.reduxfx.com) and Frederic Devernay.

Inputs
------

+--------+-------------+----------+
| Input  | Description | Optional |
+========+=============+==========+
| Source |             | No       |
+--------+-------------+----------+

Controls
--------

.. tabularcolumns:: |>{\raggedright}p{0.2\columnwidth}|>{\raggedright}p{0.06\columnwidth}|>{\raggedright}p{0.07\columnwidth}|p{0.63\columnwidth}|

.. cssclass:: longtable

+---------------------------------------------+---------+-------------+-----------------------+
| Parameter / script name                     | Type    | Default     | Function              |
+=============================================+=========+=============+=======================+
| Type / ``Type``                             | Choice  | Cube        | |                     |
|                                             |         |             | | **Cube**            |
|                                             |         |             | | **Cone**            |
|                                             |         |             | | **Cylinder**        |
|                                             |         |             | | **Sphere**          |
|                                             |         |             | | **Torus**           |
+---------------------------------------------+---------+-------------+-----------------------+
| Density / ``Density``                       | Integer | 50          |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Size / ``Size``                             | Double  | 3           |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Z-range / ``Zrange``                        | Double  | 100         |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| FOV / ``FOV``                               | Double  | 45          |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| X-light / ``Xlight``                        | Double  | 0           |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Y-light / ``Ylight``                        | Double  | 0           |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Z-light / ``Zlight``                        | Double  | -100        |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Specular lightness / ``Specular_lightness`` | Double  | 0.5         |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Specular shininess / ``Specular_shininess`` | Double  | 0.7         |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Rendering / ``Rendering``                   | Choice  | Flat shaded | |                     |
|                                             |         |             | | **Dots**            |
|                                             |         |             | | **Wireframe**       |
|                                             |         |             | | **Flat**            |
|                                             |         |             | | **Flat shaded**     |
|                                             |         |             | | **Gouraud**         |
|                                             |         |             | | **Phong**           |
+---------------------------------------------+---------+-------------+-----------------------+
| Opacity / ``Opacity``                       | Double  | 1           |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Output Layer / ``Output_Layer``             | Choice  | Layer 0     | |                     |
|                                             |         |             | | **Merged**          |
|                                             |         |             | | **Layer 0**         |
|                                             |         |             | | **Layer -1**        |
|                                             |         |             | | **Layer -2**        |
|                                             |         |             | | **Layer -3**        |
|                                             |         |             | | **Layer -4**        |
|                                             |         |             | | **Layer -5**        |
|                                             |         |             | | **Layer -6**        |
|                                             |         |             | | **Layer -7**        |
|                                             |         |             | | **Layer -8**        |
|                                             |         |             | | **Layer -9**        |
+---------------------------------------------+---------+-------------+-----------------------+
| Resize Mode / ``Resize_Mode``               | Choice  | Dynamic     | |                     |
|                                             |         |             | | **Fixed (Inplace)** |
|                                             |         |             | | **Dynamic**         |
|                                             |         |             | | **Downsample 1/2**  |
|                                             |         |             | | **Downsample 1/4**  |
|                                             |         |             | | **Downsample 1/8**  |
|                                             |         |             | | **Downsample 1/16** |
+---------------------------------------------+---------+-------------+-----------------------+
| Ignore Alpha / ``Ignore_Alpha``             | Boolean | Off         |                       |
+---------------------------------------------+---------+-------------+-----------------------+
| Log Verbosity / ``Log_Verbosity``           | Choice  | Off         | |                     |
|                                             |         |             | | **Off**             |
|                                             |         |             | | **Level 1**         |
|                                             |         |             | | **Level 2**         |
|                                             |         |             | | **Level 3**         |
+---------------------------------------------+---------+-------------+-----------------------+
