<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.77 [en] (X11; U; Linux 2.4.16-686-smp i686) [Netscape]">
</head>
<body>
<h2>
A short Description of the Initial-Arguments of IEMGUI-Objects.</h2>
<h3>
(pd-0.35test23)</h3>
<hr WIDTH="100%">
<h3>
Special Structures:</h3>
<binstruct1> is a 32 Bit-struct:
<br> bit 0: loadbang-init
(0 or 1) * 1;
<br> bit 1 .. 6: tail-length of receive-name (0 .. 63)
* 2;
<br> bit 7 .. 12: tail-length of send-name (0 .. 63) * 128;
<br> bit 13 .. 18: dollar-number of receive-name (0 .. 63) * 8192;
<br> bit 19 .. 24: dollar-number of send-name (0 .. 63) * 524288;
<br> bit 25 .. 31: used for internal flags;
<br>
<br><binstruct2> is a 32 Bit-struct:
<br> bit 0 .. 5: font-style (0 .. 63) * 1;
<br> bit 6: if there is
a receive-name not eqval "empty" (0 or 1) * 64;
<br> bit 7: if there is
a send-name not eqval "empty" (0 or 1) * 128;
<br> bit 8: label-name
begins with "$0" {= unique-name} (0 or 1) * 256;
<br> bit 9: receive-name
begins with "$0" {= unique-name} (0 or 1) * 512;
<br> bit 10: send-name begins
with "$0" {= unique-name} (0 or 1) * 1024;
<br> bit 11 .. 16: tail-length of label-name (0 .. 63) * 2048;
<br> bit 17 .. 22: dollar-number {$n} of label-name (0 .. 63) * 131072;
<br> bit 23 .. 31: used for internal flags;
<p>
<hr WIDTH="100%">
<h3>
the Objects and their Arguments:</h3>
<h4>
<b>bng: 14 args</b></h4>
<float> size [pix] (default: 15)
<br> <float> flash-hold-time [ms] (default: 250)
<br> <float> flash-interrupt-time [ms] (default: 50)
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<br> <symbol> send-name [-] (default: empty)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: 0)
<br> <float> label-y-offset [pix] (default: -6)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label-font-size [pix] (default: 8)
<br> <float> background-color [-] (default: -262144)
<br> <float> foreground-color [-] (default: -1)
<br> <float> label-color [-] (default: -1)
<p>
<hr WIDTH="100%">
<h4>
hdl: 15 args (hdial)</h4>
<float> size [pix] (default: 15)
<br> <float> new-old-value-output-behavior [-] (default: 1)
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<br> <float> number of cells [-] (default: 8)
<br> <symbol> send-name [-] (default: empty)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: 0)
<br> <float> label-y-offset [pix] (default: -6)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label-font-size [pix] (default: 8)
<br> <float> background-color [-] (default: -262144)
<br> <float> foreground-color [-] (default: -1)
<br> <float> label-color [-] (default: -1)
<br> <float> selected-cell-index [-] (default: 0)
<p>
<hr WIDTH="100%">
<h4>
hsl: 18 args (hslider)</h4>
<float> width [pix] (default: 128)
<br> <float> height [pix] (default: 15)
<br> <float> left-value [-] (default: 0)
<br> <float> right-value [-] (default: 127)
<br> <float> linear or logarithmical [-] (default: 0) {0 is lin;
1 is log}
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<br> <symbol> send-name [-] (default: empty)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: -2)
<br> <float> label-y-offset [pix] (default: -6)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label-font-size [pix] (default: 8)
<br> <float> background-color [-] (default: -262144)
<br> <float> foreground-color [-] (default: -1)
<br> <float> label-color [-] (default: -1)
<br> <float> value, if init [-] (default: 0)
<br> <float> steady or jump behavior [-] (default: 1) {0 is ggee-jumpy;
1 is steady}
<p>
<hr WIDTH="100%">
<h4>
cnv: 13 args (my_canvas)</h4>
<float> selectable square-size [pix] (default: 15)
<br> <float> only visible width [pix] (default: 100)
<br> <float> only visible height [pix] (default: 60)
<br> <symbol> send-name [-] (default: empty)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: 20)
<br> <float> label-y-offset [pix] (default: 12)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label-font-size [pix] (default: 14)
<br> <float> background-color [-] (default: -233017)
<br> <float> label-color [-] (default: -66577)
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<br>
<br>
<hr WIDTH="100%">
<h4>
nbx: 18 args (my_numbox)</h4>
<float> box-width [digits] (default: 5)
<br> <float> box-height [pix] (default: 14)
<br> <float> minimum-value [-] (default: -1e+37)
<br> <float> maximum-value [-] (default: 1e+37)
<br> <float> linear or logarithmical [-] (default: 0) {0 is lin;
1 is log}
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<br> <symbol> send-name [-] (default: empty)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: 0)
<br> <float> label-y-offset [pix] (default: -6)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label- and front-font-size [pix] (default: 10)
<br> <float> background-color [-] (default: -262144)
<br> <float> foreground-color [-] (default: -1)
<br> <float> label-color [-] (default: -1)
<br> <float> value, if init [-] (default: 0)
<br> <float> virtuell height, if logarithmical [pix] (default:
256)
<p>
<hr WIDTH="100%">
<h4>
tgl: 14 args (toggle)</h4>
<float> size [pix] (default: 15)
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<br> <symbol> send-name [-] (default: empty)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: 0)
<br> <float> label-y-offset [pix] (default: -6)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label-font-size [pix] (default: 8)
<br> <float> background-color [-] (default: -262144)
<br> <float> foreground-color [-] (default: -1)
<br> <float> label-color [-] (default: -1)
<br> <float> on-off-state [-] (default: 0)
<br> <float> non-zero-value [-] (default: 1)
<br>
<br>
<hr WIDTH="100%">
<h4>
vdl: 15 args (vdial)</h4>
<float> size [pix] (default: 15)
<br> <float> new-old-value-output-behavior [-] (default: 1)
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<br> <float> number of cells [-] (default: 8)
<br> <symbol> send-name [-] (default: empty)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: 0)
<br> <float> label-y-offset [pix] (default: -6)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label-font-size [pix] (default: 8)
<br> <float> background-color [-] (default: -262144)
<br> <float> foreground-color [-] (default: -1)
<br> <float> label-color [-] (default: -1)
<br> <float> selected-cell-index [-] (default: 0)
<p>
<hr WIDTH="100%">
<h4>
vsl: 18 args (vslider)</h4>
<float> width [pix] (default: 15)
<br> <float> height [pix] (default: 128)
<br> <float> bottom-value [-] (default: 0)
<br> <float> top-value [-] (default: 127)
<br> <float> linear or logarithmical [-] (default: 0) {0 is lin;
1 is log}
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<br> <symbol> send-name [-] (default: empty)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: 0)
<br> <float> label-y-offset [pix] (default: -8)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label-font-size [pix] (default: 8)
<br> <float> background-color [-] (default: -262144)
<br> <float> foreground-color [-] (default: -1)
<br> <float> label-color [-] (default: -1)
<br> <float> value, if init [-] (default: 0)
<br> <float> steady or jump behavior [-] (default: 1) {0 is ggee-jumpy;
1 is steady}
<p>
<hr WIDTH="100%">
<h4>
vu: 12 args</h4>
<float> width [pix] (default: 15)
<br> <float> height [pix] (default: 120)
<br> <symbol> receive-name [-] (default: empty)
<br> <symbol> label-name [-] (default: empty)
<br> <float> label-x-offset [pix] (default: -1)
<br> <float> label-y-offset [pix] (default: -8)
<br> <binstruct2> font-style-dollar [-] (default: 0)
<br> <float> label-font-size [pix] (default: 8)
<br> <float> background-color [-] (default: -66577)
<br> <float> label-color [-] (default: -1)
<br> <float> visible scale [-] (default: 1) {0 is no scale; 1
is show scale}
<br> <binstruct1> loadbang-init-dollar [-] (default: 0)
<p>
<hr WIDTH="100%">
<br>
<h3>
Examples:</h3>
<p><br><b>colors:</b> 0 .. 29 are the presets of prop.-dialog-window, top-left-color
is 0, top-right is 9, middle-left is 10, ..
<br> and bottom-right is 29;
<br> if negativ numbers: you can compose RGB-colors; each component
from 0 to 63; GREEN-component * 64; RED-comp. * 4096;
<br> and then add RED + GREEN + BLUE, negate it and add -1. (rgb_color
= -BLUE -64*GREEN -4096*RED - 1);
<p><b>send-receive-label:</b> if you want to give the object a send- or
receive-name, replace the "empty"-symbol
<br>
with "my_name".
<br> if you want to give the object an unique-name, replace "empty"
with "\$0-my_name" and set BIT 10, 9 or 8
<br> of <binstruct2> (add 1024, 512 or 256 to font-style-dollar).
<br> if you want to give the object a dollar-argument-send-name,
replace 1st "empty" with e.g. "\$12-my_send" and
<br> add to <binstruct1> loadbang-init-dollar: 524288
* 12 = 6291456;
<br> add to <binstruct1> loadbang-init-dollar: 128
* 8 = 1024; ("-my_send" is the tail and has 8 characters)
<br> <i>(1024 + 6291456 = 6292480).</i>
<br> if you want to give the object a dollar-argument-receive-name,
replace 2nd "empty" with e.g. "\$3-my_receive" and
<br> add to <binstruct1> loadbang-init-dollar: 8192
* 3 = 24576;
<br> add to <binstruct1> loadbang-init-dollar: 2 *
11 = 22; ("-my_receive" is the tail and has 11 characters)
<br> <i>(22 + 24576 = 24598).</i>
<br>
<br>
</body>
</html>