The Alternative Csound Reference Manual
Previous |  | Next

# FLknob

FLknob -- A FLTK widget opcode that creates a knob.

## Description

A FLTK widget opcode that creates a knob.

## Syntax

kout, ihandle FLknob "label", imin, imax, iexp, itype, idisp, iwidth, ix, iy [, icursorsize]

## Initialization

ihandle -- a handle value (an integer number) that unequivocally references a corresponding widget. This is used by other opcodes that modify a widget's properties (see Modifying FLTK Widget Appearance). It is automatically output by FLknob and must not be set by the user label. (The user label is a double-quoted string containing some user-provided text placed near the widget.)

"label" -- a double-quoted string containing some user-provided text, placed near the corresponding widget.

imin -- minimum value of output range.

imax -- maximum value of output range.

iexp -- an integer number denoting the behaviour of valuator:

- 0 = valuator output is linear

- -1 = valuator output is exponential

All other positive numbers for iexp indicate the number of an existing table that is used for indexing. Linear interpolation is provided in table indexing. A negative table number suppresses interpolation.

| IMPORTANT!
| Notice that the tables used by valuators must be created with the ftgen opcode and placed in the orchestra before the corresponding valuator. They can not placed in the score. In fact, tables placed in the score are created later than the initialization of the opcodes placed in the header section of the orchestra.

itype -- an integer number denoting the appearance of the valuator.

The itype argument can be set to the following values:

- 1 - a 3-D knob

- 2 - a pie-like knob

- 3 - a clock-like knob

- 4 - a flat knob

A 3-D knob.

A pie knob.

A clock knob.

A flat knob.

idisp -- a handle value that was output from a previous instance of the FLvalue opcode to display the current value of the current valuator in the FLvalue widget itself. If the user doesn't want to use this feature that displays current values, it must be set to a negative number by the user.

iwidth -- width of widget.

iheight -- height of widget.

ix -- horizontal position of upper left corner of the valuator, relative to the upper left corner of corresponding window (expressed in pixels).

iy -- vertical position of upper left corner of the valuator, relative to the upper left corner of corresponding window (expressed in pixels).

icursorsize (optional) -- If FLknob's itype is set to 1 (3D knob), this parameter controls the size of knob cursor.

## Performance

kout -- output value

FLknob puts a knob in the corresponding container.

## Examples

Here is an example of the FLknob opcode. It uses the files flknob.orc and flknob.sco.

Example 1. Example of the FLknob opcode.

    /* flknob.orc */
    ; A sine with oscillator with flknob controlled frequency
    sr = 44100
    kr = 441
    ksmps = 100
    nchnls = 1

    FLpanel "Frequency Knob", 900, 400, 50, 50
        ; Minimum value output by the knob
        imin = 200
        ; Maximum value output by the knob
        imax = 5000
        ; Logarithmic type knob selected
        iexp = -1
        ; Knob graphic type (1=3D knob)
        itype = 1
        ; Display handle (-1=not used)
        idisp = -1
        ; Width of the knob in pixels
        iwidth = 70
        ; Height of the knob in pixels
        iheight = 70
        ; Distance of the left edge of the knob
        ; from the left edge of the panel
        ix = 125

        gkfreq, ihandle FLknob "Frequency", imin, imax, iexp, itype, idisp, iwidth, iheight, ix
    ; End of panel contents
    FLpanelEnd
    ; Run the widget thread!
    FLrun

    instr 1
        iamp = 15000
        ifn = 1
        asig oscili iamp, gkfreq, ifn
        out asig
    endin
    /* flknob.orc */

    /* flknob.sco */
    ; Function table that defines a single cycle
    ; of a sine wave.
    f 1 0 1024 10 1

    ; Instrument 1 will play a note for 1 hour.
    i 1 0 3600
    e
    /* flknob.sco */

## See Also

FLcount, FLjoy, FLkeyb, FLroller, FLslider, FLtext

## Credits

Author: Gabriel Maldonado

New in version 4.22

Example written by Iain McCurdy, edited by Kevin Conder.

Previous | Home | Next
FLkeyb | Up | FLlabel