.. _eu.gmic.Charcoal:

G’MIC Charcoal node
===================

.. raw:: html

   <!-- Do not edit this file! It is generated automatically by Natron itself. -->

*This documentation is for version 1.0 of G’MIC Charcoal (eu.gmic.Charcoal).*

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

Author: David Tschumperle. Latest Update: 2011/17/03.

Inspired from the Charcoal script by micomicon :

http://registry.gimp.org/node/25078

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                   |
+=======================================================================+=========+=====================+============================+
| Granularity / ``Granularity``                                         | Integer | 65                  |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Lowlights Crossover Point / ``Lowlights_Crossover_Point``             | Integer | 70                  |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Highlights Crossover Point / ``Highlights_Crossover_Point``           | Integer | 170                 |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Boost Contrast / ``Boost_Contrast``                                   | Boolean | Off                 |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Resize Image for Optimum Effect / ``Resize_Image_for_Optimum_Effect`` | Boolean | On                  |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Add Chalk Highlights / ``Add_Chalk_Highlights``                       | Boolean | Off                 |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Minimal Highlights / ``Minimal_Highlights``                           | Integer | 50                  |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Maximal Highlights / ``Maximal_Highlights``                           | Integer | 70                  |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Background Color / ``Background_Color``                               | Color   | r: 1 g: 1 b: 1 a: 1 |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Foreground Color / ``Foreground_Color``                               | Color   | r: 0 g: 0 b: 0 a: 0 |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Invert Background / Foreground / ``Invert_Background__Foreground``    | 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                 |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Global Random Seed / ``Global_Random_Seed``                           | Integer | 0                   |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Animate Random Seed / ``Animate_Random_Seed``                         | Boolean | Off                 |                            |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+
| Log Verbosity / ``Log_Verbosity``                                     | Choice  | Off                 | |                          |
|                                                                       |         |                     | | **Off**                  |
|                                                                       |         |                     | | **Level 1**              |
|                                                                       |         |                     | | **Level 2**              |
|                                                                       |         |                     | | **Level 3**              |
+-----------------------------------------------------------------------+---------+---------------------+----------------------------+