AdjustmentCurve

Component Type: Processor (Subcategory: Signal Shaping)

The AdjustmentCurve component allows transformation of an incoming signal to an outgoing signal. The signal mapping can be freely arranged in a drawing window (GUI) during runtime of the model. The resulting mapping can be saved as a curve file. The GUI is optional - an existing curve can be loaded to perform the signal mapping without the GUI.

AdjustmentCurve plugin

AdjustmentCurve GUI during runtime

Input Port Description

• in [double]: This port receives the input values which will be mapped to output values.
• CurveName [string]: When this port receives a string, the plugin tries to load a curve file of this name from the plugin's data subdirectory (ARE/data/processor.adjustmentcurve).

Output Port Description

• out [double]: This port provides the resulting output value.

Event Listener Description

• displayGui: An incoming event makes the GUI visible.
• hideGui: An incoming event makes the GUI invisible.
• loadCurve: An incoming event loads a curve of the current filename (as given in the plugin property or received from the input port "curveName").
• saveCurve: An incoming event saves the current mapping curve under the given filename. This event has teh same function like the "save"-button which is available in the GUI window of the plugin.

Properties

• filename [string]: The filename of the curve file. If the curve file exists in the plugin's subdirectory (ARE/data/processor.adjustmentcurve), this curve is loaded. If the file does not exist, a new curve can be drawn in the GUI and saved under this name into the plugin's data subfolder (ARE/data/processor.adjustmentcurve).
• display GUI [boolean]: If checked, the GUI of the adjustment curve plugin will be shown and the user can modify and save the curve in real time by dragging, creating or deleting curve points.
• intMin [double]: Sets the minimum value of the input range.
• outMax [double]: Sets the maximum value of the input range.
• outMin [double]: Sets the minimum value of the output range.
• outMax [double]: Sets the maximum value of the output range.
• mode [combobox]: "autoupdate min and max" modifies the input range if incoming values exceed the current minimum or maximum, "clip to min and max" which keeps the values as set by the min/max properties.
• fontSize [integer]: The size of the font for dispaying text in the GUI.
• caption [string]: The caption of the AdjustmentCurve GUI.