FLvalue
Prev | Orchestra Opcodes and Operators | Next

## FLvalue

FLvalue — Shows the current value of a FLTK valuator.

## Description

Plugin opcode in widgets. This opcode is part of the plugin repository and has to be installed separately. These FLTK widgets do not work on the Mac. The plugin repository can be found here: https://github.com/csound/plugins

FLvalue shows current the value of a valuator in a text field.

## Syntax

    ihandle FLvalue "label", iwidth, iheight, ix, iy

## Initialization

ihandle -- handle value (an integer number) that unequivocally references the corresponding valuator. It can be used for the idisp argument of a valuator.

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

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).

## Performance

FLvalue shows the current values of a valuator in a text field. It outputs ihandle that can then be used for the idisp argument of a valuator (see the FLTK Valuators section). In this way, the values of that valuator will be dynamically be shown in a text field.

| Note
Note that FLvalue is not a valuator and its value cannot be modified.The value for an FLvalue widget should be set only by other widgets, and NOT from FLsetVal or FLsetVal_i since this can cause Csound to crash.

## Examples

Here is an example of the FLvalue opcode. It uses the file FLvalue.csd.

Example 348. Example of the FLvalue opcode.

See the sections Real-time Audio and Command Line Flags for more information on using command line flags.

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    ; Audio out   Audio in    No messages
    -odac           -iadc     -d     ;;;RT audio I/O
    ; For Non-realtime ouput leave only the line below:
    ; -o FLvalue.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    ; Using the opcode flvalue to display the output of a slider
    sr = 44100
    kr = 441
    ksmps = 100
    nchnls = 1

    FLpanel "Value Display Box", 900, 200, 50, 50
        ; Width of the value display box in pixels
        iwidth = 50
        ; Height of the value display box in pixels
        iheight = 20
        ; Distance of the left edge of the value display
        ; box from the left edge of the panel
        ix = 65
        ; Distance of the top edge of the value display
        ; box from the top edge of the panel
        iy = 55

        idisp FLvalue "Hertz", iwidth, iheight, ix, iy
        gkfreq, ihandle FLslider "Frequency", 200, 5000, -1, 5, idisp, 750, 30, 125, 50
        FLsetVal_i 500, ihandle
    ; End of panel contents
    FLpanelEnd
    ; Run the widget thread!
    FLrun

    instr 1
        iamp = 15000
        ifn = 1
        asig oscili iamp, gkfreq, ifn
        out asig
    endin

    </CsInstruments>
    <CsScore>

    ; 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

    </CsScore>
    </CsoundSynthesizer>

## See Also

FLbox, FLbutBank, FLbutton, FLprintk, FLprintk2

## Credits

Author: Gabriel Maldonado

New in version 4.22

Example written by Iain McCurdy, edited by Kevin Conder.

Prev | Up | Next
fluidSetInterpMethod | Home | FLvkeybd