File: matrixctrl-help.pd

package info (click to toggle)
pd-jmmmp 0.61-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 7,060 kB
  • sloc: makefile: 12
file content (258 lines) | stat: -rw-r--r-- 10,318 bytes parent folder | download
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
#N struct 1011-color float x float y float farbe;
#N struct 1011-color-display float x float y float farbe;
#N struct 1014-color float x float y float farbe;
#N struct 1014-color-display float x float y float farbe;
#N struct 1008-matrixctrl float x float y float size float color float
state;
#N struct 1028-color float x float y float farbe;
#N struct 1028-color-display float x float y float farbe;
#N struct 1031-color float x float y float farbe;
#N struct 1031-color-display float x float y float farbe;
#N struct 1025-matrixctrl float x float y float size float color float
state;
#N struct 1046-color float x float y float farbe;
#N struct 1046-color-display float x float y float farbe;
#N struct 1049-color float x float y float farbe;
#N struct 1049-color-display float x float y float farbe;
#N struct 1043-matrixctrl float x float y float size float color float
state;
#N struct 1063-color float x float y float farbe;
#N struct 1063-color-display float x float y float farbe;
#N struct 1066-color float x float y float farbe;
#N struct 1066-color-display float x float y float farbe;
#N struct 1060-matrixctrl float x float y float size float color float
state;
#N struct 1080-color float x float y float farbe;
#N struct 1080-color-display float x float y float farbe;
#N struct 1083-color float x float y float farbe;
#N struct 1083-color-display float x float y float farbe;
#N struct 1077-matrixctrl float x float y float size float color float
state;
#N struct 1097-color float x float y float farbe;
#N struct 1097-color-display float x float y float farbe;
#N struct 1100-color float x float y float farbe;
#N struct 1100-color-display float x float y float farbe;
#N struct 1094-matrixctrl float x float y float size float color float
state;
#N struct 1115-color float x float y float farbe;
#N struct 1115-color-display float x float y float farbe;
#N struct 1118-color float x float y float farbe;
#N struct 1118-color-display float x float y float farbe;
#N struct 1112-matrixctrl float x float y float size float color float
state;
#N struct 1132-color float x float y float farbe;
#N struct 1132-color-display float x float y float farbe;
#N struct 1135-color float x float y float farbe;
#N struct 1135-color-display float x float y float farbe;
#N struct 1129-matrixctrl float x float y float size float color float
state;
#N struct 1149-color float x float y float farbe;
#N struct 1149-color-display float x float y float farbe;
#N struct 1152-color float x float y float farbe;
#N struct 1152-color-display float x float y float farbe;
#N struct 1146-matrixctrl float x float y float size float color float
state;
#N struct 1167-color float x float y float farbe;
#N struct 1167-color-display float x float y float farbe;
#N struct 1170-color float x float y float farbe;
#N struct 1170-color-display float x float y float farbe;
#N struct 1164-matrixctrl float x float y float size float color float
state;
#N canvas 118 50 939 601 10;
#N canvas 0 50 448 416 license 0;
#X text 8 47 All rights reserved.;
#X text 8 227 The names of its contributors may not be used to endorse
or promote products derived from this software without specific prior
written permission.;
#X text 8 87 Redistribution and use in source and binary forms \, with
or without modification \, are permitted provided that the following
conditions are met:;
#X text 8 127 Redistributions of source code must retain the above
copyright notice \, this list of conditions and the following disclaimer.
;
#X text 8 297 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES \, INCLUDING
\, BUT NOT LIMITED TO \, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT \, INDIRECT
\, INCIDENTAL \, SPECIAL \, EXEMPLARY \, OR CONSEQUENTIAL DAMAGES (INCLUDING
\, BUT NOT LIMITED TO \, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES
;
#X text 8 167 Redistributions in binary form must reproduce the above
copyright notice \, this list of conditions and the following disclaimer
in the documentation and/or other materials provided with the distribution.
;
#X text 8 27 jmmmpais@gmail.com;
#X text 8 7 Copyright 2017 \, Joo Pais;
#X restore 61 576 pd license;
#X text 13 266 Inputs;
#X obj 86 359 sig~ 1;
#X obj 59 469 snaps~;
#X obj 87 449 snaps~;
#X obj 114 429 snaps~;
#X obj 140 409 snaps~;
#X obj 140 359 sig~ 2;
#X text 67 250 Outputs;
#X text 60 96 To control the GUI \, either click with your mouse \,
or send messages. These are formated as a list with the horizontal
& vertical positions starting from 0 \, and state (0/1):;
#X msg 59 168 0 0 \$1;
#X obj 59 148 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
1;
#X obj 59 198 t a;
#X obj 119 148 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
1;
#X msg 119 168 2 1 \$1;
#X obj 179 148 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
1;
#X msg 179 168 3 0 \$1;
#X text 101 199 The layout is like Max/MSP's matrixctrl object.;
#X text 154 309 The output is a matrix message;
#X text 119 267 this is [matrixctrl 4 2];
#X text 100 517 == [matrixctrl 5 5 6];
#X text 509 136 Inlets;
#X text 509 336 Outlets;
#X text 509 356 - output for [iemmatrix/mtx_mul~];
#X text 509 106 - cell size (default is 13);
#X text 509 226 - "mode AND" / "mode OR" - matrix behaviour (default
is AND);
#X text 508 86 - number of inputs/rows;
#X text 509 66 - number of outputs/columns;
#N canvas 331 210 437 323 SIZE+CELLSIZE 0;
#X msg 19 117 size 2 4;
#X msg 29 137 size 2 3;
#X msg 19 217 cellsize 25;
#X msg 29 237 cellsize 13;
#X text 19 47 !! Mind \, for "size" and "cellsize" the object doesn't
get saved with the new parameters !! You must edit the object itself.
;
#X text 19 17 Change matrix size and cellsize:;
#X obj 19 257 matrixctrl 2 2;
#X obj 19 157 matrixctrl 2 2;
#X text 19 97 "size \$1 \$2" changes matrix size;
#X text 19 197 "cellsize \$1" changes cell size \, Standard is 13 points.
;
#X connect 0 0 7 0;
#X connect 1 0 7 0;
#X connect 2 0 6 0;
#X connect 3 0 6 0;
#X restore 509 458 pd SIZE+CELLSIZE;
#N canvas 218 139 517 433 COLOR 0;
#X msg 39 177 color 50 100;
#X msg 29 157 color 57 600;
#X msg 19 127 color 899 800;
#X text 119 127 standard values;
#X text 49 207 == [matrixctrl 2 8 10];
#X text 18 17 Change colors:;
#X obj 437 77 pd-colors;
#X text 89 357 == [matrixctrl 3 3 20];
#X msg 19 327 color;
#X text 19 307 Or send only the message "color" to open a color selector.
;
#X text 19 78 The colors follow the data structures color scheme. Look
at;
#X text 19 91 for a complete palette.;
#X obj 19 206 matrixctrl 2 8 10;
#X obj 19 356 matrixctrl 3 3 20;
#X text 19 37 Send the message "color \$1 \$2" to set the matrix colors.
;
#X text 19 57 \$1 = off color \, \$2 = on color;
#X connect 0 0 12 0;
#X connect 1 0 12 0;
#X connect 2 0 12 0;
#X connect 8 0 13 0;
#X restore 509 488 pd COLOR;
#X text 579 488 Change colors;
#X text 629 458 Change matrix size and cellsize;
#X text 509 46 Arguments - ALWAYS USE THE FIRST TWO ARGUMENTS;
#X text 509 306 - matrix ... - read matrix definitions;
#X text 583 518 Read matrix messages;
#N canvas 218 139 458 347 MATRIX 0;
#X text 11 8 Read matrix messages \;;
#X text 89 271 == [matrixctrl 8 8 8];
#X text 88 115 == [matrixctrl 5 2];
#X msg 15 168 matrix 5 2 1 0 0 1 1 0 0 0 0 1;
#X msg 15 69 matrix 5 2 1 0 0 1 0 0 1 0 0 0;
#X msg 25 89 matrix 5 2 0 0 0 0 0 1 1 0 1 1;
#X text 12 28 Send the message "matrix ... " to import matrix definitions.
With this you can save your settings.;
#X msg 15 227 matrix 8 8 0 0 0 0 0 1 1 0 0 1 0 1 0 0 0 0 0 0 0 0 0
0 1 0 1 0 1 0 0 0 0 1 0 0 0 0 1 0 0 1 1 0 0 0 0 0 0 0 0 0 1 0 1 1 0
1 0 1 0 0 0 0 0 0;
#X text 15 207 A more complex example:;
#X obj 15 273 matrixctrl 8 8 8;
#X obj 15 117 matrixctrl 5 2;
#X obj 15 148 prepent set;
#X connect 4 0 10 0;
#X connect 5 0 10 0;
#X connect 7 0 9 0;
#X connect 10 0 11 0;
#X connect 11 0 3 0;
#X restore 509 518 pd MATRIX;
#X text 509 186 - reset - resets matrix;
#N canvas 455 181 457 289 MODES+RESET 0;
#X msg 19 98 mode AND;
#X msg 29 118 mode OR;
#X text 109 137 == [matrixctrl 5 3];
#X text 19 47 There are two modes: AND allows for multiple selection
\, OR keeps only one selected field \, setting all other fields to
0 AND is the standard mode.;
#X text 19 17 Interaction modes:;
#X msg 19 228 reset;
#X text 19 207 Reset a matrix - the "reset" message sets all fields
to 0;
#X obj 19 138 matrixctrl 6 3;
#X obj 19 248 matrixctrl 2 2;
#X connect 0 0 7 0;
#X connect 1 0 7 0;
#X connect 5 0 8 0;
#X restore 509 428 pd MODES+RESET;
#X text 613 428 Interaction modes and reset;
#X text 509 398 Other features are:;
#X text 509 206 - bang - outputs current setting;
#N canvas 564 268 494 344 META 0;
#X text 12 55 AUTHOR Joo Pais <jmmmpais@gmail.com>;
#X text 12 95 LICENSE BSD;
#X text 12 75 LIBRARY jmmmp;
#X text 13 115 WEBSITE http://puredata.info/Members/jmmmp;
#X text 12 6 DESCRIPTION GUI for [iemmatrix/mtx_mul~];
#X text 12 36 KEYWORDS matrix mtx_mul~ matrix~;
#X text 12 135 VERSION 0.48;
#X restore 151 576 pd META;
#X obj 89 228 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
-1;
#X text 109 227 bang outputs the current setting;
#X obj 61 516 matrixctrl 5 5 6;
#X text 509 246 - size \$1 \$2 - change matrix size;
#X text 509 266 - cellsize \$1 - change cell size;
#X text 509 286 - color \$1 \$2 - change colors;
#X text 509 156 - \$1 \$2 \$3 - list with horizontal & vertical positions
\, and state (0/1);
#X text 59 498 The third argument sets cell size. Here with 6 points:
;
#X obj 69 309 prepent set;
#X obj 59 389 mtx_mul~ 4 2;
#X text 58 558 (C) 2013-2017 Joo Pais - jmmmpais@gmail.com;
#X text 12 41 Clone of Max/MSP's matrixctrl. Can also be used for normal
matrixes. Click in the cells or send messages to change state.;
#X obj 59 268 matrixctrl 4 2;
#X text 11 11 [matrixctrl \$1 \$2 \$3] - GUI for [iemmatrix/mtx_mul~]
;
#X msg 69 329;
#X connect 2 0 51 1;
#X connect 7 0 51 2;
#X connect 10 0 12 0;
#X connect 11 0 10 0;
#X connect 12 0 54 0;
#X connect 13 0 14 0;
#X connect 14 0 12 0;
#X connect 15 0 16 0;
#X connect 16 0 12 0;
#X connect 42 0 12 0;
#X connect 50 0 56 0;
#X connect 51 0 3 0;
#X connect 51 1 4 0;
#X connect 51 2 5 0;
#X connect 51 3 6 0;
#X connect 54 0 50 0;
#X connect 54 0 51 0;