A short Description of the Initial-Arguments of IEMGUI-Objects.

(pd-0.35test23)

Special Structures:

<binstruct1> is a 32 Bit-struct:
bit        0: loadbang-init (0 or 1) * 1;
bit 1 .. 6: tail-length of receive-name (0 .. 63) * 2;
bit 7 .. 12: tail-length of send-name (0 .. 63) * 128;
bit 13 .. 18: dollar-number of receive-name (0 .. 63) * 8192;
bit 19 .. 24: dollar-number of send-name (0 .. 63) * 524288;
bit 25 .. 31: used for internal flags;

<binstruct2> is a 32 Bit-struct:
bit 0 .. 5: font-style (0 .. 63) * 1;
bit        6: if there is a receive-name not eqval "empty" (0 or 1) * 64;
bit        7: if there is a send-name not eqval "empty" (0 or 1) * 128;
bit        8: label-name begins with "$0" {= unique-name} (0 or 1) * 256;
bit        9: receive-name begins with "$0" {= unique-name} (0 or 1) * 512;
bit       10: send-name begins with "$0" {= unique-name} (0 or 1) * 1024;
bit 11 .. 16: tail-length of label-name (0 .. 63) * 2048;
bit 17 .. 22: dollar-number {$n} of label-name (0 .. 63) * 131072;
bit 23 .. 31: used for internal flags;

the Objects and their Arguments:

bng: 14 args

<float> size [pix] (default: 15)
<float> flash-hold-time [ms] (default: 250)
<float> flash-interrupt-time [ms] (default: 50)
<binstruct1> loadbang-init-dollar [-] (default: 0)
<symbol> send-name [-] (default: empty)
<symbol> receive-name [-] (default: empty)
<symbol> label-name [-] (default: empty)
<float> label-x-offset [pix] (default: 0)
<float> label-y-offset [pix] (default: -6)
<binstruct2> font-style-dollar [-] (default: 0)
<float> label-font-size [pix] (default: 8)
<float> background-color [-] (default: -262144)
<float> foreground-color [-] (default: -1)
<float> label-color [-] (default: -1)

hdl: 15 args (hdial)

<float> size [pix] (default: 15)
<float> new-old-value-output-behavior [-] (default: 1)
<binstruct1> loadbang-init-dollar [-] (default: 0)
<float> number of cells [-] (default: 8)
<symbol> send-name [-] (default: empty)
<symbol> receive-name [-] (default: empty)
<symbol> label-name [-] (default: empty)
<float> label-x-offset [pix] (default: 0)
<float> label-y-offset [pix] (default: -6)
<binstruct2> font-style-dollar [-] (default: 0)
<float> label-font-size [pix] (default: 8)
<float> background-color [-] (default: -262144)
<float> foreground-color [-] (default: -1)
<float> label-color [-] (default: -1)
<float> selected-cell-index [-] (default: 0)

hsl: 18 args (hslider)

<float> width [pix] (default: 128)
<float> height [pix] (default: 15)
<float> left-value [-] (default: 0)
<float> right-value [-] (default: 127)
<float> linear or logarithmical [-] (default: 0) {0 is lin; 1 is log}
<binstruct1> loadbang-init-dollar [-] (default: 0)
<symbol> send-name [-] (default: empty)
<symbol> receive-name [-] (default: empty)
<symbol> label-name [-] (default: empty)
<float> label-x-offset [pix] (default: -2)
<float> label-y-offset [pix] (default: -6)
<binstruct2> font-style-dollar [-] (default: 0)
<float> label-font-size [pix] (default: 8)
<float> background-color [-] (default: -262144)
<float> foreground-color [-] (default: -1)
<float> label-color [-] (default: -1)
<float> value, if init [-] (default: 0)
<float> steady or jump behavior [-] (default: 1) {0 is ggee-jumpy; 1 is steady}

cnv: 13 args (my_canvas)

<float> selectable square-size [pix] (default: 15)
<float> only visible width [pix] (default: 100)
<float> only visible height [pix] (default: 60)
<symbol> send-name [-] (default: empty)
<symbol> receive-name [-] (default: empty)
<symbol> label-name [-] (default: empty)
<float> label-x-offset [pix] (default: 20)
<float> label-y-offset [pix] (default: 12)
<binstruct2> font-style-dollar [-] (default: 0)
<float> label-font-size [pix] (default: 14)
<float> background-color [-] (default: -233017)
<float> label-color [-] (default: -66577)
<binstruct1> loadbang-init-dollar [-] (default: 0)

nbx: 18 args (my_numbox)

<float> box-width [digits] (default: 5)
<float> box-height [pix] (default: 14)
<float> minimum-value [-] (default: -1e+37)
<float> maximum-value [-] (default: 1e+37)
<float> linear or logarithmical [-] (default: 0) {0 is lin; 1 is log}
<binstruct1> loadbang-init-dollar [-] (default: 0)
<symbol> send-name [-] (default: empty)
<symbol> receive-name [-] (default: empty)
<symbol> label-name [-] (default: empty)
<float> label-x-offset [pix] (default: 0)
<float> label-y-offset [pix] (default: -6)
<binstruct2> font-style-dollar [-] (default: 0)
<float> label- and front-font-size [pix] (default: 10)
<float> background-color [-] (default: -262144)
<float> foreground-color [-] (default: -1)
<float> label-color [-] (default: -1)
<float> value, if init [-] (default: 0)
<float> virtuell height, if logarithmical [pix] (default: 256)

tgl: 14 args (toggle)

<float> size [pix] (default: 15)
<binstruct1> loadbang-init-dollar [-] (default: 0)
<symbol> send-name [-] (default: empty)
<symbol> receive-name [-] (default: empty)
<symbol> label-name [-] (default: empty)
<float> label-x-offset [pix] (default: 0)
<float> label-y-offset [pix] (default: -6)
<binstruct2> font-style-dollar [-] (default: 0)
<float> label-font-size [pix] (default: 8)
<float> background-color [-] (default: -262144)
<float> foreground-color [-] (default: -1)
<float> label-color [-] (default: -1)
<float> on-off-state [-] (default: 0)
<float> non-zero-value [-] (default: 1)

vdl: 15 args (vdial)

vsl: 18 args (vslider)

<float> width [pix] (default: 15)
<float> height [pix] (default: 128)
<float> bottom-value [-] (default: 0)
<float> top-value [-] (default: 127)
<float> linear or logarithmical [-] (default: 0) {0 is lin; 1 is log}
<binstruct1> loadbang-init-dollar [-] (default: 0)
<symbol> send-name [-] (default: empty)
<symbol> receive-name [-] (default: empty)
<symbol> label-name [-] (default: empty)
<float> label-x-offset [pix] (default: 0)
<float> label-y-offset [pix] (default: -8)
<binstruct2> font-style-dollar [-] (default: 0)
<float> label-font-size [pix] (default: 8)
<float> background-color [-] (default: -262144)
<float> foreground-color [-] (default: -1)
<float> label-color [-] (default: -1)
<float> value, if init [-] (default: 0)
<float> steady or jump behavior [-] (default: 1) {0 is ggee-jumpy; 1 is steady}

vu: 12 args

<float> width [pix] (default: 15)
<float> height [pix] (default: 120)
<symbol> receive-name [-] (default: empty)
<symbol> label-name [-] (default: empty)
<float> label-x-offset [pix] (default: -1)
<float> label-y-offset [pix] (default: -8)
<binstruct2> font-style-dollar [-] (default: 0)
<float> label-font-size [pix] (default: 8)
<float> background-color [-] (default: -66577)
<float> label-color [-] (default: -1)
<float> visible scale [-] (default: 1) {0 is no scale; 1 is show scale}
<binstruct1> loadbang-init-dollar [-] (default: 0)

Examples:

colors: 0 .. 29 are the presets of prop.-dialog-window, top-left-color is 0, top-right is 9, middle-left is 10, ..
and bottom-right is 29;
if negativ numbers: you can compose RGB-colors; each component from 0 to 63; GREEN-component * 64; RED-comp. * 4096;
and then add RED + GREEN + BLUE, negate it and add -1. (rgb_color = -BLUE -64*GREEN -4096*RED - 1);

send-receive-label: if you want to give the object a send- or receive-name, replace the "empty"-symbol
                      with "my_name".
if you want to give the object an unique-name, replace "empty" with "\$0-my_name" and set BIT 10, 9 or 8
    of <binstruct2> (add 1024, 512 or 256 to font-style-dollar).
if you want to give the object a dollar-argument-send-name, replace 1st "empty" with e.g. "\$12-my_send" and
    add to <binstruct1> loadbang-init-dollar: 524288 * 12 = 6291456;
    add to <binstruct1> loadbang-init-dollar: 128 * 8 = 1024; ("-my_send" is the tail and has 8 characters)
    (1024 + 6291456 = 6292480).
if you want to give the object a dollar-argument-receive-name, replace 2nd "empty" with e.g. "\$3-my_receive" and
    add to <binstruct1> loadbang-init-dollar: 8192 * 3 = 24576;
    add to <binstruct1> loadbang-init-dollar: 2 * 11 = 22; ("-my_receive" is the tail and has 11 characters)
    (22 + 24576 = 24598).