.. _eu.gmic.Asciiart:

G’MIC Ascii art node
====================

*This documentation is for version 1.0 of G’MIC Ascii art.*

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                     |
+===============================================+=========+===================+==============================+
| Charset / ``Charset``                         | Choice  | Ascii             | |                            |
|                                               |         |                   | | **Custom**                 |
|                                               |         |                   | | **Binary digits**          |
|                                               |         |                   | | **Digits**                 |
|                                               |         |                   | | **Lowercase letters**      |
|                                               |         |                   | | **Uppercase letters**      |
|                                               |         |                   | | **Ascii**                  |
|                                               |         |                   | | **Card suits**             |
|                                               |         |                   | | **Math symbols**           |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Custom dictionary / ``Custom_dictionary``     | String  | .oO0              |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Analysis scale / ``Analysis_scale``           | Integer | 16                |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Analysis smoothness / ``Analysis_smoothness`` | Double  | 15                |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Synthesis scale / ``Synthesis_scale``         | Integer | 16                |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Result type / ``Result_type``                 | Choice  | Colored on black  | |                            |
|                                               |         |                   | | **White on black**         |
|                                               |         |                   | | **Black on white**         |
|                                               |         |                   | | **Colored on black**       |
|                                               |         |                   | | **Colored on transparent** |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Gamma / ``Gamma``                             | Double  | 0                 |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Smoothness / ``Smoothness``                   | Double  | 0.2               |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Colors / ``Colors``                           | Choice  | Full colors       | |                            |
|                                               |         |                   | | **Full colors**            |
|                                               |         |                   | | **2 colors**               |
|                                               |         |                   | | **3 colors**               |
|                                               |         |                   | | **4 colors**               |
|                                               |         |                   | | **8 colors**               |
|                                               |         |                   | | **12 colors**              |
|                                               |         |                   | | **16 colors**              |
|                                               |         |                   | | **Grayscale**              |
|                                               |         |                   | | **2 grays**                |
|                                               |         |                   | | **3 grays**                |
|                                               |         |                   | | **4 grays**                |
|                                               |         |                   | | **8 grays**                |
|                                               |         |                   | | **12 grays**               |
|                                               |         |                   | | **16 grays**               |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Output ascii file / ``Output_ascii_file``     | Boolean | Off               |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Output folder / ``Output_folder``             | N/A     |                   |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| Output filename / ``Output_filename``         | String  | gmic_asciiart.txt |                              |
+-----------------------------------------------+---------+-------------------+------------------------------+
| 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**                |
+-----------------------------------------------+---------+-------------------+------------------------------+
