.. _eu.gmic.Relieflight:

G’MIC Relief light node
=======================

*This documentation is for version 1.0 of G’MIC Relief light.*

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              |
+=================================================+=========+===============+=======================+
| Ambient lightness / ``Ambient_lightness``       | Double  | 0.3           |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| Specular lightness / ``Specular_lightness``     | Double  | 0.2           |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| Specular size / ``Specular_size``               | Double  | 0.2           |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| Darkness / ``Darkness``                         | Double  | 0             |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| Light smoothness / ``Light_smoothness``         | Double  | 1             |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| XY-light / ``XYlight``                          | Double  | x: 0.5 y: 0.5 |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| Z-light / ``Zlight``                            | Double  | 5             |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| Z-scale / ``Zscale``                            | Double  | 0.5           |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| Opacity as heightmap / ``Opacity_as_heightmap`` | Boolean | Off           |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| Image smoothness / ``Image_smoothness``         | Double  | 0             |                       |
+-------------------------------------------------+---------+---------------+-----------------------+
| 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**         |
+-------------------------------------------------+---------+---------------+-----------------------+
