The Angle Control component adds an angle 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. As the name suggests, Angle Control is most useful for controlling angle inputs, such as those in Perlin Noise and Motion Blur components. For a good example of the practical use of this component, see the CrossBlur filter which is included with Filter Forge.
Angle Control is a numeric control component, it can be located in the Controls category on the Components Bar. The controls added by Angle Control components appear on the Settings tab in Filter Controls. In order to appear in the list of controls, Angle Control must be connected to the subtree of the Result component or to Result directly. Like any numeric component, Angle 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 angle 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 angle 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 Angle inputs: Value goes to the target angle input unchanged.
- To Checkbox inputs: if Value is greater than 180 (half the Angle range), the target checkbox becomes 'checked', otherwise it stays 'unchecked'.
- To IntSlider inputs: the range of the Angle control (0 to 360) is proportionally mapped onto the range of the target integer slider. The 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 taken as a percentage within the range of 0 to 360. The result of the interpolation is rounded to an integer number and sent to the target input.
- To List inputs: the range of the Angle control (0 to 360) 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 taken as a percentage within the range of 0 to 360. The result of the interpolation is rounded to an integer number and sent to the target list.
- To Slider inputs: the range of the Angle control (0 to 360) 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 taken as a percentage within the range of 0 to 360.
- To Color inputs: the color for the target input is assembled according to the HLS color model using the hue defined by Value, the saturation of 100 and the lightness of 50. See Assemble HLS component for more information on the HLS color model.
- To Value inputs: the range of the Angle control (0 to 360) 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 taken as a percentage within the range of 0 to 360.
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 the Angle component 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 the Angle component to its target inputs. Remappers allow you to specify how Angle 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 Angle remappers, see the following sections:
Remapper (Angle Control to Angle)
Remapper (Angle Control to Checkbox)
Remapper (Angle Control to Color)
Remapper (Angle Control to HDR Color)
Remapper (Angle Control to IntSlider)
Remapper (Angle Control to List)
Remapper (Angle Control to Slider)
Remapper (Angle Control to Value)
