.. _eu.gmic.Blackwhite:

G’MIC Black & white node
========================

*This documentation is for version 1.0 of G’MIC Black & white.*

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                   |
+==================================================+=========+===============+============================+
| Red level / ``Red_level``                        | Double  | 0.299         |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Red smoothness / ``Red_smoothness``              | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Green level / ``Green_level``                    | Double  | 0.587         |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Green smoothness / ``Green_smoothness``          | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Blue level / ``Blue_level``                      | Double  | 0.114         |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Blue smoothness / ``Blue_smoothness``            | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Brightness (%) / ``Brightness_``                 | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Contrast (%) / ``Contrast_``                     | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Gamma (%) / ``Gamma_``                           | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Hue (%) / ``Hue_``                               | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Saturation (%) / ``Saturation_``                 | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Grain (shadows) / ``Grain_shadows``              | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Grain (midtones) / ``Grain_midtones``            | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Grain (highlights) / ``Grain_highlights``        | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Grain tone fading / ``Grain_tone_fading``        | Double  | 2             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Grain scale / ``Grain_scale``                    | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Grain type / ``Grain_type``                      | Choice  | Gaussian      | |                          |
|                                                  |         |               | | **Gaussian**             |
|                                                  |         |               | | **Uniform**              |
|                                                  |         |               | | **Salt and pepper**      |
|                                                  |         |               | | **Poisson**              |
+--------------------------------------------------+---------+---------------+----------------------------+
| Local contrast / ``Local_contrast``              | Double  | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Radius / ``Radius``                              | Integer | 16            |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Contrast smoothness / ``Contrast_smoothness``    | Double  | 4             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Pseudo-gray dithering / ``Pseudogray_dithering`` | Integer | 0             |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Use maximum tones / ``Use_maximum_tones``        | Boolean | Off           |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Preview type / ``Preview_type``                  | Choice  | Full          | |                          |
|                                                  |         |               | | **Full**                 |
|                                                  |         |               | | **Forward horizontal**   |
|                                                  |         |               | | **Forward vertical**     |
|                                                  |         |               | | **Backward horizontal**  |
|                                                  |         |               | | **Backward vertical**    |
|                                                  |         |               | | **Duplicate top**        |
|                                                  |         |               | | **Duplicate left**       |
|                                                  |         |               | | **Duplicate bottom**     |
|                                                  |         |               | | **Duplicate right**      |
|                                                  |         |               | | **Duplicate horizontal** |
|                                                  |         |               | | **Duplicate vertical**   |
|                                                  |         |               | | **Checkered**            |
|                                                  |         |               | | **Checkered inverse**    |
+--------------------------------------------------+---------+---------------+----------------------------+
| Preview split / ``Preview_split``                | Double  | x: 0.5 y: 0.5 |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| 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           |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Preview/Draft Mode / ``PreviewDraft_Mode``       | Boolean | Off           |                            |
+--------------------------------------------------+---------+---------------+----------------------------+
| Log Verbosity / ``Log_Verbosity``                | Choice  | Off           | |                          |
|                                                  |         |               | | **Off**                  |
|                                                  |         |               | | **Level 1**              |
|                                                  |         |               | | **Level 2**              |
|                                                  |         |               | | **Level 3**              |
+--------------------------------------------------+---------+---------------+----------------------------+
