From 00d709decc47771afe25ae47c620d0a7cc252324 Mon Sep 17 00:00:00 2001
From: musil <tmusil@users.sourceforge.net>
Date: Fri, 10 Nov 2006 14:29:42 +0000
Subject: binary help

svn path=/trunk/externals/iem/iem_ambi/; revision=6254
---
 help/ambi_decode3-help.pd | 256 +++++++++++++++++++++++++++++++++++++++
 help/ambi_encode-help.pd  | 302 ++++++++++++++++++++++++++++++++++++++++++++++
 help/ambi_rot-help.pd     | 194 +++++++++++++++++++++++++++++
 3 files changed, 752 insertions(+)
 create mode 100644 help/ambi_decode3-help.pd
 create mode 100644 help/ambi_encode-help.pd
 create mode 100644 help/ambi_rot-help.pd

diff --git a/help/ambi_decode3-help.pd b/help/ambi_decode3-help.pd
new file mode 100644
index 0000000..66c93f6
--- /dev/null
+++ b/help/ambi_decode3-help.pd
@@ -0,0 +1,256 @@
+#N canvas 12 5 961 699 10;
+#X text 27 436 1.arg: <float> ambisonic order;
+#X text 794 41 -180 <= phi <= +180;
+#X text 494 172 input: <ambi_weight> one mul-factor for each;
+#X text 490 505 output in case of 3d: <matrix> ((n_ao+1)*(n_ao+1)*n_ls+2)
+;
+#X text 490 443 output in case of 2d: <matrix> ((2*n_ao+1)*n_ls+2)
+;
+#X text 835 505 <float> :;
+#X text 794 442 <float> :;
+#X text 731 527 number of ambisonic-channels;
+#X text 702 538 <float> elements of a matrix;
+#X text 504 538 + (n_ao + 1) * (n_ao + 1) * n_ls;
+#X text 504 473 + (2*n_ao + 1) * n_ls <float> elements of a matrix
+;
+#X text 42 454 (1 .. 5 in case of 3 dimensional);
+#X text 42 445 (1 .. 12 in case of 2 dimensional);
+#X text 27 464 2.arg: <float> dimension (2 or 3);
+#X text 106 564 IEM KUG;
+#X text 90 552 musil;
+#X text 120 552 @;
+#X text 126 552 iem.at;
+#X text 89 574 Graz \, Austria;
+#X text 41 541 (c) Thomas Musil 2000 - 2006;
+#X obj 109 347 cnv 15 126 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#X obj 108 368 round_zero 1e-006;
+#X obj 38 33 bng 35 250 50 0 empty empty empty 0 -6 0 8 -24198 -42246
+-1;
+#X msg 246 121 ambi_weight 1 1 1 0.3904;
+#X msg 108 121 ambi_weight 1 1 1 1;
+#X msg 124 99 mirror_weight 0.7;
+#X obj 80 220 pp pht_ls;
+#X obj 38 77 t b b b b b b b;
+#X msg 94 143 1 90 0 \, 2 45 45 \, 3 45 135 \, 4 45 225 \, 5 45 315
+\, 6 0 0 \, 7 0 45 \, 8 0 90 \, 9 0 135 \, 10 0 180 \, 11 0 225 \,
+12 0 270 \, 13 0 315;
+#X obj 94 177 pp real_ls;
+#X msg 66 243 begin_pseudo_inverse;
+#X obj 108 346 ambi_decode3 3 3 13 6;
+#X msg 38 313 end_pseudo_inverse;
+#X msg 80 199 1 -45 0 \, 2 -45 90 \, 3 -45 180 \, 4 -45 270 \, 6 -90
+0;
+#X msg 52 289 ipht_ireal_muladd \$1 \$2 \$3;
+#N canvas 337 146 567 517 mirror_phantom_ls_____ 0;
+#X msg 142 186 1 6 \$1;
+#X obj 102 58 inlet;
+#X obj 101 441 outlet;
+#X obj 162 59 inlet;
+#X obj 71 135 f;
+#X obj 103 135 f;
+#X obj 157 106 * 0.25;
+#X obj 214 106 * 0.5;
+#X msg 163 211 2 8 \$1;
+#X msg 40 187 1 13 \$1 \, 1 7 \$1;
+#X msg 61 212 2 7 \$1 \, 2 9 \$1;
+#X msg 179 241 3 10 \$1;
+#X msg 77 242 3 9 \$1 \, 3 11 \$1;
+#X msg 199 271 4 12 \$1;
+#X msg 87 271 4 11 \$1 \, 4 13 \$1;
+#X obj 162 81 route mirror_weight;
+#X obj 380 60 inlet;
+#X connect 0 0 2 0;
+#X connect 1 0 4 0;
+#X connect 1 0 5 0;
+#X connect 3 0 15 0;
+#X connect 4 0 9 0;
+#X connect 4 0 10 0;
+#X connect 4 0 12 0;
+#X connect 4 0 14 0;
+#X connect 5 0 0 0;
+#X connect 5 0 8 0;
+#X connect 5 0 11 0;
+#X connect 5 0 13 0;
+#X connect 6 0 4 1;
+#X connect 7 0 5 1;
+#X connect 8 0 2 0;
+#X connect 9 0 2 0;
+#X connect 10 0 2 0;
+#X connect 11 0 2 0;
+#X connect 12 0 2 0;
+#X connect 13 0 2 0;
+#X connect 14 0 2 0;
+#X connect 15 0 7 0;
+#X connect 15 0 6 0;
+#X restore 52 268 pd mirror_phantom_ls_____;
+#X text 18 9 ambi_decode3;
+#X text 160 14 AMBISONIC DECODING;
+#X text 131 40 up to 12.Order 2-dimensional;
+#X text 128 28 up to 5.Order 3-dimensional or;
+#X text 508 5 n_ao = ambisonic-order;
+#X text 520 42 all angles in degree;
+#X text 539 183 ambisonic order group to suppress the side-lobe-phenomena
+;
+#X text 493 274 input: <begin_pseudo_inverse> starts the encoding;
+#X text 536 285 of all (real + phantom) loudspeaker positions \,;
+#X text 537 309 and calculates the pseudo inverse.;
+#X text 540 297 multiplicates the ambi order weight;
+#X msg 276 230 sing_range 1e-010;
+#X text 799 328 mirror_weight;
+#X text 545 354 phantom speaker with the factor "mirror_weight" and
+adds;
+#X text 544 367 this column to the column "rl_ls_index" of real speaker
+;
+#X text 494 202 input: <sing_range> singularity range;
+#X text 537 213 when calculating the inverse of the matrix by gauss
+;
+#X text 537 223 algorithm \, you have to divide a row by a certain
+number \,;
+#X text 537 243 outside of this range (> sing_range \, or < -sing_range).
+;
+#X text 493 385 input: <end_pseudo_inverse> outputs only the first
+part of;
+#X text 539 398 the inverted matrix (row 1 to row n_pht_ls). The part
+;
+#X text 541 410 with the phantom speakers \, we ignore.;
+#X obj 221 576 cnv 15 192 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#X obj 221 601 cnv 15 228 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#X text 537 255 Otherwise we say \, this matrix is singular.;
+#N canvas 149 60 405 450 real_speaker_example 0;
+#X obj 65 32 bng 35 250 50 0 empty empty empty 0 -6 0 8 -24198 -42246
+-1;
+#X obj 84 216 cnv 15 120 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#X obj 83 260 print;
+#X obj 83 237 round_zero 1e-006;
+#X obj 102 120 pp real_ls;
+#X msg 83 143 begin_pseudo_inverse;
+#X msg 65 166 end_pseudo_inverse;
+#X obj 83 215 ambi_decode3 2 2 5 0;
+#X obj 65 74 t b b b;
+#X msg 102 97 1 5 \, 2 2.5 \, 3 0 \, 4 -2.5 \, 5 -5;
+#X text 51 299 ambisonic system 2.order;
+#X text 78 312 2 dimensional;
+#X text 76 326 5 real speakers;
+#X text 41 346 arranged in a very small arc between;
+#X text 58 359 +5 degrees and -5 degrees;
+#X connect 0 0 8 0;
+#X connect 3 0 2 0;
+#X connect 4 0 7 0;
+#X connect 5 0 7 0;
+#X connect 6 0 7 0;
+#X connect 7 0 3 0;
+#X connect 8 0 6 0;
+#X connect 8 1 5 0;
+#X connect 8 2 9 0;
+#X connect 9 0 4 0;
+#X restore 220 575 pd real_speaker_example singular;
+#N canvas 250 68 390 499 phantom_speaker_example 0;
+#X obj 38 31 bng 35 250 50 0 empty empty empty 0 -6 0 8 -24198 -42246
+-1;
+#X obj 143 251 cnv 15 132 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#X obj 142 300 print;
+#X obj 142 275 round_zero 1e-006;
+#X obj 161 165 pp real_ls;
+#X msg 142 188 begin_pseudo_inverse;
+#X msg 124 211 end_pseudo_inverse;
+#X obj 124 119 t b b b;
+#X msg 161 142 1 5 \, 2 2.5 \, 3 0 \, 4 -2.5 \, 5 -5;
+#X text 110 344 ambisonic system 2.order;
+#X text 137 357 2 dimensional;
+#X text 135 371 5 real speakers;
+#X obj 38 191 pp pht_ls;
+#X obj 38 72 for++ 0 138;
+#X obj 38 95 t f f;
+#X obj 38 126 + 1;
+#X obj 63 117 * 2.5;
+#X obj 63 139 + 7.5;
+#X obj 38 169 pack 0 0;
+#X obj 142 250 ambi_decode3 2 2 5 139;
+#X text 116 396 -5 degrees and +5 degrees;
+#X text 125 411 139 phantom speakers;
+#X text 99 383 arranged on a very small arc between;
+#X text 109 423 arranged on an arc between;
+#X text 113 437 +7.5 degrees and -7.5 degrees;
+#X connect 0 0 13 0;
+#X connect 3 0 2 0;
+#X connect 4 0 19 0;
+#X connect 5 0 19 0;
+#X connect 6 0 19 0;
+#X connect 7 0 6 0;
+#X connect 7 1 5 0;
+#X connect 7 2 8 0;
+#X connect 8 0 4 0;
+#X connect 12 0 19 0;
+#X connect 13 0 14 0;
+#X connect 13 1 7 0;
+#X connect 14 0 15 0;
+#X connect 14 1 16 0;
+#X connect 15 0 18 0;
+#X connect 16 0 17 0;
+#X connect 17 0 18 1;
+#X connect 18 0 12 0;
+#X connect 19 0 3 0;
+#X restore 220 600 pd phantom_speaker_example nonsingular;
+#X text 537 233 to achieve the identity matrix. This number has to
+be;
+#X obj 108 391 mtx_print;
+#X text 516 453 <float> n_row = (n_ls) = number of loudspeakers;
+#X text 504 463 + <float> n_col = (2*n_ao+1) = number of ambisonic-channels
+;
+#X text 493 328 input: <ipht_ireal_muladd> im_ls_index re_ls_index
+;
+#X text 546 341 multiplies the column "im_ls_index + re_ls_index" of
+;
+#X text 27 476 3.arg: <float> number of real existing loudspeakers
+;
+#X text 27 488 4.arg: <float> number of virtual phantom_loudspeakers
+;
+#X text 493 16 n_re_ls = number of real loudspeakers;
+#X text 493 28 n_vi_ls = number of virtual phantom loudspeakers;
+#X text 494 78 input: <real_ls> re_ls_index + phi .. 2-dimensional
+;
+#X text 494 88 input: <real_ls> re_ls_index + theta + phi .. 3-dimensional
+;
+#X text 494 118 input: <pht_ls> vi_ls_index + phi .. 2-dimensional
+;
+#X text 494 129 input: <pht_ls> vi_ls_index + theta + phi .. 3-dimensional
+;
+#X text 794 29 -90 <= theta <= +90;
+#X text 786 5 1 <= re_ls_index <= n_re_ls;
+#X text 786 16 1 <= vi_ls_index <= n_vi_ls;
+#X text 59 423 initial arguments:;
+#X text 334 18 calculates a ambisonic;
+#X text 358 29 decoder matrix;
+#X text 529 100 encodes the re_ls_index row of a matrix;
+#X text 525 141 encodes the (re_ls_index + vi_ls_index) row of a matrix
+;
+#X text 532 153 we need them to achieve a nonsingular matrix;
+#X text 516 516 <float> n_row = (n_ls) = number of loudspeakers;
+#X text 504 527 + <float> n_col = (n_ao+1)*(n_ao+1) =;
+#X connect 21 0 64 0;
+#X connect 22 0 27 0;
+#X connect 23 0 31 0;
+#X connect 24 0 31 0;
+#X connect 25 0 35 1;
+#X connect 26 0 31 0;
+#X connect 27 0 32 0;
+#X connect 27 1 35 0;
+#X connect 27 2 30 0;
+#X connect 27 3 33 0;
+#X connect 27 4 28 0;
+#X connect 27 5 24 0;
+#X connect 27 6 25 0;
+#X connect 28 0 29 0;
+#X connect 29 0 31 0;
+#X connect 30 0 31 0;
+#X connect 31 0 21 0;
+#X connect 32 0 31 0;
+#X connect 33 0 26 0;
+#X connect 34 0 31 0;
+#X connect 35 0 34 0;
+#X connect 47 0 31 0;
diff --git a/help/ambi_encode-help.pd b/help/ambi_encode-help.pd
new file mode 100644
index 0000000..0b40a5a
--- /dev/null
+++ b/help/ambi_encode-help.pd
@@ -0,0 +1,302 @@
+#N canvas 61 22 864 676 10;
+#X obj 375 244 cnv 15 78 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#X obj 374 243 ambi_encode 2;
+#X obj 374 288 print;
+#X text 478 247 1.arg: <float> ambisonic order;
+#X text 489 259 (1 .. 12 for 2 dimensional use);
+#X msg 461 178 col 2 \$1;
+#X msg 425 97 row 1 \$1;
+#X msg 288 211 col 3 \$1 \$2;
+#X obj 288 188 pack 0 0;
+#X obj 306 166 t b f;
+#X obj 374 265 round_zero 1e-006;
+#X obj 184 193 pack 0 0;
+#X obj 202 171 t b f;
+#X floatatom 100 161 5 -180 180 0 - - -;
+#X floatatom 51 162 5 -90 90 0 - - -;
+#X obj 82 222 pack 0 0;
+#X obj 100 200 t b f;
+#X text 48 143 delta;
+#X text 102 142 phi;
+#X text 21 12 ambi_encode;
+#X text 34 291 ambisonic-order = n_ao;
+#X text 346 320 -> output: <list> of (2*n_ao+1) <float>;
+#X text 346 331 -> output: <list> of (n_ao+1)*(n_ao+1) <float>;
+#X text 387 356 -> output: <row> + index + (2*n_ao+1) <float>;
+#X text 387 368 -> output: <row> + index + (n_ao+1)*(n_ao+1) <float>
+;
+#X text 383 394 -> output: <col> + index + (2*n_ao+1) <float>;
+#X text 383 406 -> output: <col> + index + (n_ao+1)*(n_ao+1) <float>
+;
+#X text 432 424 for crossfading of 2 ambisonic-systems;
+#X msg 605 183 ambi_weight 1 1 1;
+#X msg 588 162 ambi_weight 1 1 0.3904;
+#X text 299 424 ambisonic-order-group;
+#X text 89 452 -90 <= delta <= +90;
+#X text 89 464 -180 <= phi <= +180;
+#X text 415 439 or for bluring a signal-source-direction;
+#X text 31 496 order of ambisonic-channels in 2d-case: W X1 Y1 X2 Y2
+X3 Y3;
+#X text 391 496 X4 Y4 X5 Y5 ....;
+#X text 167 510 W := 1 \, X-term ... cos(i*phi) \, Y-term ... sin(i*phi)
+;
+#X text 30 550 order of ambisonic-channels in 3d-case: W Z1X1 Z1Y1
+Z1;
+#X text 358 550 Z2X2 Z2Y2 Z2X1 Z2Y1 Z2 Z3X3 Z3Y3 Z3X2 Z3Y2 Z3X1 Z3Y1
+Z3 ...;
+#X text 166 564 W := 1 \, X-term ... cos(i*phi) \, Y-term ... sin(i*phi)
+\,;
+#X text 489 564 Z-term ... cos(j*delta)*sin(k*delta);
+#X text 33 318 input: <float> phi [degree] .. 2-dimensional;
+#X text 33 331 input: <list> delta + phi [degree] .. 3-dimensional
+;
+#X text 33 356 input: <row> index + phi [degree] .. 2-dimensional;
+#X text 34 368 input: <row> index + delta + phi [degree] .. 3-dimensional
+;
+#X text 31 395 input: <col> index + phi [degree .. 2-dimensional;
+#X text 31 407 input: <col> index + delta + phi [degree] .. 3-dimensional
+;
+#X text 31 424 input: <ambi_weight> one mul-factor for each;
+#X text 267 482 |0| 1 | 2 | 3 | 4 | 5 |;
+#X text 687 539 |;
+#X text 263 537 |0| 1 | 2 | 3;
+#X floatatom 226 142 5 -180 180 0 - - -;
+#X floatatom 177 143 5 -90 90 0 - - -;
+#X text 174 124 delta;
+#X text 228 123 phi;
+#X floatatom 327 139 5 -180 180 0 - - -;
+#X floatatom 278 140 5 -90 90 0 - - -;
+#X text 275 121 delta;
+#X text 329 120 phi;
+#X floatatom 370 65 5 -180 180 0 - - -;
+#X text 372 46 phi;
+#X floatatom 425 79 5 -180 180 0 - - -;
+#X text 427 60 phi;
+#X floatatom 461 160 5 -180 180 0 - - -;
+#X text 463 141 phi;
+#X text 491 272 (1 .. 5 for 3 dimensional use);
+#X msg 184 218 row 4 \$1 \$2;
+#X text 82 849 "float"-message: <float> azimuth-angle phi [degree]
+-> two-dimensional ambisonic-system -> output a <list> of (2*n_ao +
+1) <float> elements;
+#X text 478 850 "list"-message: 1.item <float> elevation-angle delta
+[degree] \, 2.item <float> azimuth-angle phi [degree] -> three-dimensional
+ambisonic-system -> output a <list> of (n_ao + 1)^2 <float> elements
+;
+#X text 87 914 "row"-message: <float> row-index of ambisonic-encoder-matrix
+\, <float> azimuth-angle phi [degree] -> two-dimensional ambisonic-system
+-> output a "row"-message + <float> row-index + (2*n_ao + 1) <float>
+elements;
+#X text 480 919 "row"-message: 1.item <float> elevation-angle delta
+[degree] \, 2.item <float> azimuth-angle phi [degree] -> three-dimensional
+ambisonic-system -> output a <list> of (n_ao + 1)^2 <float> elements
+;
+#X text 105 441 1 <= index <= nr_sources;
+#X text 120 6 AMBISONIC ENCODING;
+#X text 112 32 up to 12.Order 2-dimensional;
+#X text 109 20 up to 5.Order 3-dimensional or;
+#X text 366 8 calculates a row or column of;
+#X text 372 20 a ambisonic-encoder-matrix;
+#X obj 539 62 cnv 15 126 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#N canvas 0 0 624 486 3D-5.Order-example 0;
+#X obj 83 104 pack 0 0;
+#X floatatom 83 62 5 -90 90 0 - - -;
+#X floatatom 126 63 5 -180 180 0 - - -;
+#X text 68 31 delta;
+#X text 49 45 -90 .. +90;
+#X text 152 33 phi;
+#X text 125 47 -180 .. +180;
+#X obj 101 83 t b f;
+#X obj 102 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 112 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 122 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 132 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 142 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 152 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 162 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 172 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 182 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 192 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 202 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 212 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 222 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 232 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 242 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 252 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 262 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 272 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 282 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 292 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 302 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 312 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 322 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 332 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 92 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 427 96 ambi_encode 4;
+#X floatatom 427 75 5 -180 180 0 - - -;
+#X text 439 38 phi;
+#X text 412 52 -180 .. +180;
+#X obj 147 209 print 3d;
+#X obj 427 139 print 2d;
+#X obj 83 208 route row;
+#X obj 147 187 round_zero 1e-006;
+#X floatatom 47 251 5 0 0 0 - - -;
+#X obj 83 131 pp row 7;
+#X text 18 261 row-index;
+#X obj 427 118 round_zero 1e-006;
+#X text 453 267 +1;
+#X text 453 367 -1;
+#X text 456 318 0;
+#X obj 83 158 ambi_encode 5;
+#X obj 83 229 unpack 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
+0 0 0 0 0 0 0 0 0 0 0 0 0 0;
+#X obj 342 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 352 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 362 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 372 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 382 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 392 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 402 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 412 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 422 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 432 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X obj 442 275 vsl 8 101 -1 1 0 0 empty empty empty 0 -8 0 8 -225280
+-1109 -1 0 1;
+#X msg 265 64 ambi_weight 1 1 1 1 1 1;
+#X msg 265 102 ambi_weight 1 1 1 1 0 0;
+#X msg 265 121 ambi_weight 1 1 1 0 0 0;
+#X msg 265 141 ambi_weight 1 1 0 0 0 0;
+#X msg 265 161 ambi_weight 1 0 0 0 0 0;
+#X msg 265 83 ambi_weight 1 1 1 1 1 0;
+#X text 95 409 IEM KUG;
+#X text 79 397 musil;
+#X text 109 397 @;
+#X text 115 397 iem.at;
+#X text 78 419 Graz \, Austria;
+#X text 30 386 (c) Thomas Musil 2000 - 2006;
+#X connect 0 0 42 0;
+#X connect 1 0 0 0;
+#X connect 2 0 7 0;
+#X connect 7 0 0 0;
+#X connect 7 1 0 1;
+#X connect 33 0 44 0;
+#X connect 34 0 33 0;
+#X connect 39 0 49 0;
+#X connect 40 0 37 0;
+#X connect 42 0 48 0;
+#X connect 44 0 38 0;
+#X connect 48 0 39 0;
+#X connect 48 0 40 0;
+#X connect 49 0 41 0;
+#X connect 49 1 32 0;
+#X connect 49 2 8 0;
+#X connect 49 3 9 0;
+#X connect 49 4 10 0;
+#X connect 49 5 11 0;
+#X connect 49 6 12 0;
+#X connect 49 7 13 0;
+#X connect 49 8 14 0;
+#X connect 49 9 15 0;
+#X connect 49 10 16 0;
+#X connect 49 11 17 0;
+#X connect 49 12 18 0;
+#X connect 49 13 19 0;
+#X connect 49 14 20 0;
+#X connect 49 15 21 0;
+#X connect 49 16 22 0;
+#X connect 49 17 23 0;
+#X connect 49 18 24 0;
+#X connect 49 19 25 0;
+#X connect 49 20 26 0;
+#X connect 49 21 27 0;
+#X connect 49 22 28 0;
+#X connect 49 23 29 0;
+#X connect 49 24 30 0;
+#X connect 49 25 31 0;
+#X connect 49 26 50 0;
+#X connect 49 27 51 0;
+#X connect 49 28 52 0;
+#X connect 49 29 53 0;
+#X connect 49 30 54 0;
+#X connect 49 31 55 0;
+#X connect 49 32 56 0;
+#X connect 49 33 57 0;
+#X connect 49 34 58 0;
+#X connect 49 35 59 0;
+#X connect 49 36 60 0;
+#X connect 61 0 48 0;
+#X connect 62 0 48 0;
+#X connect 63 0 48 0;
+#X connect 64 0 48 0;
+#X connect 65 0 48 0;
+#X connect 66 0 48 0;
+#X restore 538 61 pd 3D-5.Order-example;
+#X text 90 632 IEM KUG;
+#X text 74 620 musil;
+#X text 104 620 @;
+#X text 110 620 iem.at;
+#X text 73 642 Graz \, Austria;
+#X text 25 609 (c) Thomas Musil 2000 - 2006;
+#X connect 1 0 10 0;
+#X connect 5 0 1 0;
+#X connect 6 0 1 0;
+#X connect 7 0 1 0;
+#X connect 8 0 7 0;
+#X connect 9 0 8 0;
+#X connect 9 1 8 1;
+#X connect 10 0 2 0;
+#X connect 11 0 66 0;
+#X connect 12 0 11 0;
+#X connect 12 1 11 1;
+#X connect 13 0 16 0;
+#X connect 14 0 15 0;
+#X connect 15 0 1 0;
+#X connect 16 0 15 0;
+#X connect 16 1 15 1;
+#X connect 28 0 1 0;
+#X connect 29 0 1 0;
+#X connect 51 0 12 0;
+#X connect 52 0 11 0;
+#X connect 55 0 9 0;
+#X connect 56 0 8 0;
+#X connect 59 0 1 0;
+#X connect 61 0 6 0;
+#X connect 63 0 5 0;
+#X connect 66 0 1 0;
diff --git a/help/ambi_rot-help.pd b/help/ambi_rot-help.pd
new file mode 100644
index 0000000..c7ec4e9
--- /dev/null
+++ b/help/ambi_rot-help.pd
@@ -0,0 +1,194 @@
+#N canvas 277 -7 864 706 10;
+#X floatatom 52 76 6 -180 180 0 - - -;
+#X obj 29 76 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X floatatom 128 76 6 -180 180 0 - - -;
+#X text 129 59 rho_y;
+#X text 54 59 rho_z;
+#X floatatom 195 76 6 -180 180 0 - - -;
+#X text 197 59 rho_x;
+#X obj 127 149 pack 0 0 0;
+#X obj 195 120 t b f;
+#X obj 128 120 t b f;
+#X obj 52 93 deg2rad;
+#X obj 128 94 deg2rad;
+#X obj 195 95 deg2rad;
+#X text 16 11 ambi_rot;
+#X text 130 8 AMBISONIC ROTATION;
+#X text 112 32 up to 12.Order 2-dimensional;
+#X text 109 20 up to 4.Order 3-dimensional or;
+#X text 617 153 o-;
+#X text 625 148 _____;
+#X text 655 153 > +y;
+#X text 617 146 |;
+#X text 617 140 |;
+#X text 617 134 |;
+#X text 617 128 |;
+#X text 617 124 ^;
+#X text 613 114 +z;
+#X text 605 158 +x;
+#X text 616 139 +;
+#X text 621 139 -;
+#X text 613 139 -;
+#X text 625 140 -;
+#X text 566 139 +rho_x <;
+#X text 628 139 .;
+#X text 629 139 .;
+#X text 630 139 .;
+#X text 631 140 .;
+#X text 632 140 .;
+#X text 633 141 .;
+#X text 634 142 .;
+#X text 635 143 .;
+#X text 439 148 _____;
+#X text 471 140 |;
+#X text 471 146 |;
+#X text 471 134 |;
+#X text 471 128 |;
+#X text 471 124 ^;
+#X text 467 114 +z;
+#X text 470 136 +;
+#X text 475 136 -;
+#X text 461 136 .;
+#X text 465 153 -o;
+#X text 414 153 +x <;
+#X text 482 136 > +rho_y;
+#X text 476 158 +y;
+#X text 467 136 -;
+#X text 463 137 -;
+#X text 460 136 .;
+#X text 459 136 .;
+#X text 458 137 .;
+#X text 457 137 .;
+#X text 456 138 .;
+#X text 455 139 .;
+#X text 454 140 .;
+#X text 310 148 _____;
+#X text 342 140 |;
+#X text 342 146 |;
+#X text 342 134 |;
+#X text 342 128 |;
+#X text 342 124 ^;
+#X text 336 153 -o;
+#X text 338 114 +x;
+#X text 285 153 +y <;
+#X text 347 158 +z;
+#X text 341 136 +;
+#X text 346 136 -;
+#X text 338 136 -;
+#X text 350 137 -;
+#X text 353 136 .;
+#X text 354 136 .;
+#X text 355 136 .;
+#X text 356 137 .;
+#X text 357 137 .;
+#X text 358 138 .;
+#X text 359 139 .;
+#X text 360 140 .;
+#X text 291 136 +rho_z <;
+#X text 302 60 rho_z ... rotation angle resp. z-axe;
+#X text 302 71 rho_y ... rotation angle resp. y-axe;
+#X text 302 82 rho_x ... rotation angle resp. x-axe;
+#X obj 84 250 cnv 15 60 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#X obj 153 250 cnv 15 60 15 empty empty empty 20 12 0 14 -260818 -66577
+0;
+#X obj 83 299 mtx_mul;
+#X obj 152 229 pack 0 0 0;
+#X obj 152 189 unpack 0 0 0;
+#X obj 152 209 * -1;
+#X obj 127 169 t l l;
+#X obj 101 320 mtx_mul;
+#X obj 119 340 mtx_mul;
+#X obj 138 360 mtx_mul;
+#X obj 185 209 * -1;
+#X obj 219 209 * -1;
+#X obj 152 249 ambi_rot 4;
+#X obj 83 249 ambi_rot 4;
+#X obj 357 476 round_zero 0.0001;
+#X obj 357 418 round_zero 0.0001;
+#X obj 351 359 round_zero 0.0001;
+#X obj 355 299 round_zero 0.0001;
+#X symbolatom 475 309 0 0 0 0 - - -;
+#X symbolatom 475 344 0 0 0 0 - - -;
+#X symbolatom 476 423 0 0 0 0 - - -;
+#X symbolatom 476 536 0 0 0 0 - - -;
+#X obj 357 496 mergefilename blank;
+#X obj 355 321 mergefilename blank;
+#X obj 351 380 mergefilename blank;
+#X obj 357 438 mergefilename blank;
+#X text 382 282 1st order;
+#X text 385 341 2nd order;
+#X text 380 400 3rd order;
+#X text 378 456 4th order;
+#X text 327 6 calculates a matrix message;
+#X text 331 17 for each ambisonic order;
+#X text 235 250 1.arg.: <float> ambisonic order;
+#X text 285 190 inlet: <float> rotation angle in degree for 2-D;
+#X text 324 204 or a list of 3 floats in degree for 3-D:;
+#X text 336 216 1.) <float> rotation angle of z-axe;
+#X text 336 236 3.) <float> rotation angle of x-axe;
+#X text 336 226 2.) <float> rotation angle of y-axe;
+#X obj 749 134 ambi_rot 4;
+#X obj 749 44 ambi_rot 1;
+#X obj 749 74 ambi_rot 2;
+#X obj 749 104 ambi_rot 3;
+#X obj 749 164 ambi_rot 5;
+#X obj 749 194 ambi_rot 6;
+#X obj 749 224 ambi_rot 7;
+#X obj 709 254 ambi_rot 12 ________;
+#X text 13 437 with "matrix" \, followed by number;
+#X text 13 449 of rows and columns and the >float> elements.;
+#X text 25 462 1.outlet is the ambisonic rotation matrix;
+#X text 14 474 for the components of 1.order ambisonc domain.;
+#X text 25 487 2.outlet is the ambisonic rotation matrix;
+#X text 14 499 for the components of 2.order ambisonc domain.;
+#X text 107 513 aso.;
+#X text 12 425 outlets: matrix message beginning;
+#X text 90 632 IEM KUG;
+#X text 74 620 musil;
+#X text 104 620 @;
+#X text 110 620 iem.at;
+#X text 73 642 Graz \, Austria;
+#X text 25 609 (c) Thomas Musil 2000 - 2006;
+#X connect 0 0 10 0;
+#X connect 1 0 0 0;
+#X connect 2 0 11 0;
+#X connect 5 0 12 0;
+#X connect 7 0 95 0;
+#X connect 8 0 7 0;
+#X connect 8 1 7 2;
+#X connect 9 0 7 0;
+#X connect 9 1 7 1;
+#X connect 10 0 7 0;
+#X connect 11 0 9 0;
+#X connect 12 0 8 0;
+#X connect 91 0 106 0;
+#X connect 92 0 101 0;
+#X connect 93 0 94 0;
+#X connect 93 1 99 0;
+#X connect 93 2 100 0;
+#X connect 94 0 92 0;
+#X connect 95 0 102 0;
+#X connect 95 1 93 0;
+#X connect 96 0 105 0;
+#X connect 97 0 104 0;
+#X connect 98 0 103 0;
+#X connect 99 0 92 1;
+#X connect 100 0 92 2;
+#X connect 101 0 91 1;
+#X connect 101 1 96 1;
+#X connect 101 2 97 1;
+#X connect 101 3 98 1;
+#X connect 102 0 91 0;
+#X connect 102 1 96 0;
+#X connect 102 2 97 0;
+#X connect 102 3 98 0;
+#X connect 103 0 111 0;
+#X connect 104 0 114 0;
+#X connect 105 0 113 0;
+#X connect 106 0 112 0;
+#X connect 111 0 110 0;
+#X connect 112 0 107 0;
+#X connect 113 0 108 0;
+#X connect 114 0 109 0;
-- 
cgit v1.2.1