ctl

Syntax

int ctl(int id)

Arguments

id
A numeric identifier for a control.

Return

The current value of the control specified. Max range: from -9999999 (7 digits) to +99999999 (8 digits).

Description

Returns the current value of the user control specified by the id argument. There are max. 250 ctl's possible: ctl(0) through ctl(249).

Example 1

%ffp

ctl(0): STANDARD

OnFilterStart:
{
    Info("The value of control 0 is %d", ctl(0));
    return false;
}

Example 2

With additional features 
ctl( 2): "CTL_02 ",      // name
size =( 160, 6),      // dimension slider
pos =( 340, 200),      // position into dialog
editsize =( 40, 9),      // *dimension display window
theme =on,      // *new layout, you can switch it off by: theme =off
Color =RGB( 76, 89, 102),      // color slider
FontColor =RGB( 184, 200, 217),      // color name
range =( -800, 800),      // range
divisor =40,      // value will show up devised by set value, display only!
line =10,      // jump value only when using left/right tabs
val =0      // default value, must fall within range,
            // otherwise nearest value will be set

// *new from (1.0 Beta 9.1) Feb 2009 on

To make a useful step output

The value of the slider must be further worked out, since it only affects the display window:
.
1. Configure the slider as above.
2. Convert internally the ctl( n) to a float or double:
float CTn =ctl( n);
3. The same variable can be immediately overwritten by:
CTn =round( CTn /10.0) /4.0;
.
This gives a clean step output, in this case with exact increments of 0.25,
whatever the user sets.