The Slider Control component adds a slider 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 value of the control on the Settings tab, the target inputs change their values accordingly.
Slider Control is most useful for controlling slider inputs such as Roughness in Perlin Noise. A good example of the practical use of the Slider Control can be found in the Electricity filter which is included with Filter Forge – in this filter, a single slider controls multiple inputs within different ranges. Slider Control is not recommended for controlling discrete inputs such as Repeat in Bricks or Mode in Blend – use the IntSlider Control component instead.
Slider Control is a numeric control component, it can be located in the Controls category on the Components Bar. The controls added by Slider Control components appear on the Settings tab in Filter Controls. In order to appear in the list of controls, Slider Control must be connected to the subtree of the Result component or to Result directly. Like any numeric component, Slider Control 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 slider 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).
Value
Defines the slider value that goes to the target inputs. The target inputs interpret Value differently, depending on their type. The way Value 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), Value is passed as follows:
- To Slider inputs: the Slider Control range (0 to 100) 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 Value.
- To Color inputs: the Slider Control range (0 to 100) is mapped onto a black-to-white gradient. The resulting color is determined by a linear interpolation between black and white, where the interpolation coefficient is defined by Value.
- To Angle inputs: the Slider Control range (0 to 100) 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 Value.
- To IntSlider inputs: the Slider Control range (0 to 100) 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 Value. The result of the interpolation is rounded to an integer number and sent to the target input.
- To List inputs: the Slider Control range (0 to 100) 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 Value. The result of the interpolation is rounded to an integer number and sent to the target input.
- To Checkbox inputs: if Value is greater than 50 (half the Slider Control range), the target checkbox becomes 'checked', otherwise it stays 'unchecked'.
- To Value inputs: the Slider Control range (0 to 100) 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 Value.
Value can be adjusted both from within the component properties in the Filter Editor, or from the Settings tab in Filter Controls. The current Value is saved to the default preset of the filter – see the Presets Tab for more information. If Slider is not connected to any inputs, Value has no effect on other components and the resulting image.
Use Remapping
When turned on, enables Remappers for all connections of Slider Control to its target inputs. Remappers allow you to specify how Slider Control affects the resulting value of each target input. Depending on the type of the target input, remappers have different settings. For more info on Slider Control remappers, see the following sections:
Remapper (Slider Control to Angle)
Remapper (Slider Control to Checkbox)
Remapper (Slider Control to Color)
Remapper (Slider Control to HDR Color)
Remapper (Slider Control to IntSlider)
Remapper (Slider Control to List)
Remapper (Slider Control to Slider)
Remapper (Slider Control to Value).
