aboutsummaryrefslogtreecommitdiff
path: root/pd/doc/5.reference/0_all_guis-INTRO.txt
blob: 4eda9f58ae6ea03b7c55f50c77d713f1077c7e4b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
HOW TO MOVE A GUI-OBJECT:

Of course by mouse, and:
select a gui-object , then navigate the object by using the
4 direction-keys: UP , DOWN , LEFT or RIGHT.
If you press the SHIFT-Key too , the object will move 10 times faster.


PROPERTIES-DIALOG-WINDOW:

"dimensions(pix): size:" = square-size of the gui-objects in pixels.
"dimensions(pix)(pix): width: height:" = width & height of the rectangular
            gui-object in pixels.
"selectable dimensions(pix): size:" = square-size of the selectable top-left
            corner of my_canvas in pixels.
"flash-time(ms)(ms): hold:" = flash-hold-time in msec = duration of activity,
            if a bang-object was activated by any message-event
            or by a mouse-click.
"flash-time(ms)(ms): intrrpt:" = flash-interrupt-time in msec = duration
            of inactivity , if an already activated bang is activated 
            once more.
"output-range: left: right:" = hslider-bounds for input- as well as
            output-values.
"output-range: bottom: top:" = vslider-bounds for input- as well as
            output-values.
"non-zero-value: value:" = toggle has 2 value-states: zero and this value.
"visible_rectangle(pix)(pix): width: height:" = width & height of a visible,
            deactivated rectangle in pixels.
"init" or "no init" = if "init"-mode is selected , the object gets a loadbang-
                behavior and puts out its in-patch-saved value.
            if "no init"-mode is selected, nothing will happen.
"new&old" or "new-only" = the hdial- and vdial-object changes its state in 2 ways:
            "new&old"-mode: output sends previous state off, current state on;
            "new-only"-mode: output sends only current state on.
"lin" or "log" = sliders and numberboxes can have linear or logarithmical scaling.
"number:" = number of buttons of hdials and vdials.
"log-height:" = is the graphical height of the numberbox in logarithmical mode.
"steady on click" or "jump on click" = the 2 slider-objects
                react to mouse-click in 2 ways:
            "steady on click"-mode: slider-knob stays in position,
                mouse and knob will move parallel;
            "jump on click"-mode: slider-knob jumps immediately to new
                mouse-position, positions of mouse and knob will be identical.
"send-symbol:" = an output-message can be received by a receive-object
            with the same send-symbol-name.
"receive-symbol:" = a send-object with the same symbol-name can send
            an input-message to the gui-object.
"label: name:" = visible name of a gui-object; it will be moved together with
            the gui-object.
"label: x_off: y_off:" = coordinates of the label in relation to top-left
            corner of gui-object.
"label: font: fontsize:" = font-properties of label.
"colors:" = a click on radiobuttons "backgd:", "front:" or
            "label:" routes the button "compose color" and/or the preset-colors
            to background- front- and label-color. 
            the 2 fields with "testlabel" and "o=||=o" will show you the 3 colors.
            "compose color" opens a tcl/tk color-dialog.
"Cancel" quits the properties-dialog without sending down the last changings in dialogbox.
"Apply"  sends down the changings.
"OK"     sends down the changings and quits the dialogbox.


THE DOLLAR-THING:

If you want to send to, or to receive from gui-objects,
you have to write into the property-entry your send- or receive-name.
If you want an unique-name, write $0 or $0-blabla, if you want to
communicate with this gui-object in an abstraction, write $1
or $1-blabla or $2 or $2-blabla in your property-entry.
(send- , receive- or label- name)
A new feature is: you can take the same send- and receive-name.
If there is a send-name, the object will loose its output-rectangle,
if there is a receive-name, the object will loose its input-rectangle;
but the connective behavior is the same.

GUI-MESSAGES:

all gui-objects (bng, hsl, vsl, nbx, tgl, hdl, vdl, cnv and vu)
            understand input-messages which change their properties.
            except cnv has no input, so you have to send messages
                to its receive-label (edit properties).
"size 15 128" = change width & height of sliders and vu in pixels.
"size 15" = change square-size of rdb, bng and tgl in pixels.
"vis_size 800 600" = change width & height of visual rectangle
            of my_canvas in pixels.
"range 0.1 10.0" = change slider-boundaries for
            input- as well as output-values.
"nonzero 127.0" = change the nonzero-value of toggle.
"flashtime 50 600" = change flash-interrupt- and
            flash-hold-time of bng-object.
"pos 150 170" = change the x-y-position of the top-left
            corner of a gui-object in pixels;
            "pos 0 0" is the top-left corner of your window;
             the positive directions of x- and y-axes are right and down.
"delta 15 17" = move the gui-object in relation to its
            current position (in pixels).
"color 0 22 22" = change background-, front- and
            label-color of object with one of 30 presets.
"color 0 22" = change background- and label-color
             of vu and my_canvas with one of 30 presets.
"color -16777216 (-1) -1" = change background-, (front-)
            and label-color of object with RGB-values.
            the RGB-value will be calculated:
                -65536*RED-value (0 .. 255)
                - 256*GREEN-value (0 .. 255)
                        - BLUE-value (0 .. 255) - 1.
"number 10" = change number of dial-buttons.
"log_height 128" = graphical dimension for logarithmical behavior
            of numberbox.
"steady 1" change slider-knob-behaviour on mouse-click.
"single_change" change dial-behaviour
            to output only the new state.
"double_change" change dial-behaviour
            to first release the previous button,
            then output the state of the new button.
"send fromgui" = change send-name of gui-objects,
            except vu and cnv.
"receive togui" = change receive-name of object.
"label its_me" = change label-text of object.
"label_pos 20 8" = change offset-coordinates of label-text.
"label_font 0 10" = change font and fontsize of label-text.
"init 1" = change initial loadbang-mode of gui-objects
            except vu and cnv.
"set 64" = change only the inner state and display
            of gui-objects, except bng and cnv;
            no output will result.
"lin" = change scale-mode of slider to linear.
"log" = change scale-mode of slider to logarithmical.
"get_pos" = if my_canvas has a receive-name and a send-name
            and you send the message "get_pos" to it,
            you receive the current x- and y-coordinates.