Farbe 2.009

Diese Komponente ist veraltet und ihre Verwendung in Filtern wird nicht empfohlen. Benutze die aktuelle Version der Komponente.

The Color component adds a color control to the Settings tab in Filter Controls, providing the ability to manipulate the component parameters from outside the Filter Editor. When the user adjusts the color on the Settings tab, the target inputs change their values accordingly. This component works best for controlling color inputs, its use with other types of controls such as sliders or checkboxes is not recommended because it may lead to non-intuitive filter controls.

Color is a control component, it can be located in the Controls category on the Components Bar. The controls added by Color components appear on the Settings tab in Filter Controls. In order to appear in the list of controls, Color must be connected to the subtree of the Result component or to Result directly. Like any control component, Color can be connected to any input except the required ones (shown in red). The position of the control in the list can be customized in the Order of Controls dialog.

Name

Lets you specify the name under which the color control will be displayed on the Settings tab in Filter Controls. By default, the control gets the name of the first input it is connected to. If the control is not connected to any component yet, it will be named 'Untitled' (shown in red).

Color

Defines the color that goes to the target inputs. The alpha channel of Color cannot be changed and is always set to 100% (to modify the alpha channel, use the Set Alpha component).

The target inputs interpret Color differently, depending on their type. The way Color is passed to each target input can be fine-tuned with Remappers – see Use Remapping below for details. When Use Remapping is turned off (or when the remapper is set to its default settings), Color is passed as follows:

• To Color inputs: Color is passed to the target input unchanged.
• To Slider inputs: the grayscale range of Color (from black to white) is proportionally mapped onto the range of the target slider. The resulting value of the target slider is determined by a linear interpolation between its minimum and maximum values, where the interpolation coefficient is defined by the grayscale level of Color which is obtained by averaging its R, G and B channels.
• To Angle inputs: the grayscale range of Color (from black to white) is proportionally mapped onto the range of 0 to 360 degrees. The resulting angle is determined by a linear interpolation between 0 and 360, where the interpolation coefficient is defined by the grayscale level of Color which is obtained by averaging its R, G and B channels.
• To IntSlider inputs: the grayscale range of Color (from black to white) is proportionally mapped onto the range of the target integer slider. The resulting value of the target integer slider is determined by a linear interpolation between its minimum and maximum values, where the interpolation coefficient is defined by the grayscale level of Color which is obtained by averaging its R, G and B channels. The result of the interpolation is rounded to an integer number and sent to the target input.
• To List inputs: the grayscale range of Color (from black to white) is proportionally mapped onto the range of the target list. The item number in the target list is determined by a linear interpolation between 1 and the item count of the list, where the interpolation coefficient is defined by the grayscale level of Color which is obtained by averaging its R, G and B channels. The result of the interpolation is rounded to an integer number and sent to the target input.
• To Checkbox inputs: if the grayscale level of Color (obtained by averaging its R, G and B channels) is greater than 50%, the target checkbox becomes 'checked', otherwise it stays 'unchecked'.
• To Value inputs: the grayscale range of Color (from black to white) is proportionally mapped onto the range of 0 to 1. The resulting value of the target Value input is determined by a linear interpolation between 0 and 1, where the interpolation coefficient is defined by the grayscale level of Color which is obtained by averaging its R, G and B channels.

Color can be adjusted both from within the component properties in the Filter Editor, or from the Settings tab in Filter Controls. The current Color is saved to the default preset of the filter – see the Presets Tab for more information. If this component is not connected to any inputs, Color has no effect on other components and the resulting image.

Use Remapping

When turned on, enables Remappers for all connections of the Color control to its target inputs. Remappers allow you to specify how the Color control affects the resulting value of each target input. For more info on Color remappers, see the following sections:

Remapper (Color 2.009 to Angle)
Remapper (Color 2.009 to Checkbox)
Remapper (Color 2.009 to Color)
Remapper (Color 2.009 to HDR Color)
Remapper (Color 2.009 to IntSlider)
Remapper (Color 2.009 to List)
Remapper (Color 2.009 to Slider)
Remapper (Color 2.009 to Value)