From e15b939258ab79ea135f6e2b9c717d534882cb07 Mon Sep 17 00:00:00 2001 From: RodZill4 Date: Fri, 27 Mar 2020 09:08:03 +0100 Subject: [PATCH] Added documentation for the Tones node --- .../doc/images/node_filter_tones.png | Bin 0 -> 6853 bytes material_maker/doc/node_filter_tones.rst | 38 ++++++++++++++++++ material_maker/doc/nodes_filter.rst | 1 + 3 files changed, 39 insertions(+) create mode 100644 material_maker/doc/images/node_filter_tones.png create mode 100644 material_maker/doc/node_filter_tones.rst diff --git a/material_maker/doc/images/node_filter_tones.png b/material_maker/doc/images/node_filter_tones.png new file mode 100644 index 0000000000000000000000000000000000000000..a2acbf26d7ef3b25144dde5886c10c9272b096b3 GIT binary patch literal 6853 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 literal 0 HcmV?d00001 diff --git a/material_maker/doc/node_filter_tones.rst b/material_maker/doc/node_filter_tones.rst new file mode 100644 index 0000000..e4cbb26 --- /dev/null +++ b/material_maker/doc/node_filter_tones.rst @@ -0,0 +1,38 @@ +Tones node +~~~~~~~~~~ + +The **Tones** node provides an easy interface to adjust the tones of its input. It can be applied +homogeneously to the R, G and B channels, or separately on R, G, B and A. + +The nodes shows an histogram of all channels of its input, and 3 cursors to modify the input +adjustment at the top, and 2 cursors to modify the output adjustment. + +.. image:: images/node_filter_tones.png + :align: center + +Inputs +++++++ + +The **Tones** node requires an RGBA input texture. + +Outputs ++++++++ + +The **Tones** node provides a single RGBA texture. + +Parameters +++++++++++ + +At the top of the node, a control can be used to select the active channel (Luminance, Red, +Green, Blue and Alpha). + +The button can be used to adjust automatically the Tones to the node's input to obtain better +contrast. + +The 3 cursors at the top of the histogram can be used to select the input colors that will be +remapped to black (value = 0 for single channel), mid-grey (value = 0.5) and white (value = 1). +Values between those defined by cursors are interpolated linearly, and all values are clamped +between 0 and 1. + +The 2 bottom cursors define the output color for black (value = 0 for single channel) and +white (value = 1). \ No newline at end of file diff --git a/material_maker/doc/nodes_filter.rst b/material_maker/doc/nodes_filter.rst index 06d11e9..1d04094 100644 --- a/material_maker/doc/nodes_filter.rst +++ b/material_maker/doc/nodes_filter.rst @@ -9,6 +9,7 @@ The filter nodes accept one or several inputs and generate one or several images node_filter_invert node_filter_brightness_contrast node_filter_adjust_hsv + node_filter_tones node_filter_greyscale node_filter_colorize node_filter_combine