1 files changed, 258 insertions, 0 deletions
diff --git a/help/pix_opencv_calibration-help.pd b/help/pix_opencv_calibration-help.pd
new file mode 100644
index 0000000..ea6bd56
--- /dev/null
+++ b/help/pix_opencv_calibration-help.pd
@@ -0,0 +1,258 @@
+#N canvas 479 182 1188 810 10;
+#X obj 20 33 cnv 15 430 580 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X obj 20 -13 cnv 15 430 40 empty empty empty 20 12 0 14 -195568 -66577
+0;
+#X text 29 -9 Arguments:;
+#X obj 19 -109 cnv 15 430 90 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X text 24 -145 Class: pix_opencv;
+#X text 25 -161 Synopsis: [pix_opencv_calibration];
+#X text 37 37 getting started with camera calibration :;
+#X text 65 123 3 Check calibration toggle to start and move the chessboard
+in front of the camera (or move the camera in front of your screen).
+Your computer may slow down during searching chessboard corners. When
+all corners are found it takes a snapshot (and the image will be negative)
+;
+#X text 65 103 2 Plug a supported camera and start rendering;
+#X text 66 73 1 Print the chessboard ona rigid paperboard (or just
+show it on the screen);
+#X text 65 194 4 When enought chessboard have been found (20 by default)
+it computes transformation matrix and map to undistord the image;
+#X text 65 244 5 Then all incoming images are undistord \, you can
+save the transformation and distorsion matrix to files to load it next
+times;
+#X text 31 287 for more information about this calibration see :;
+#X text 41 327 - A flexible new technique for camera calibration \,
+Zhang \, 1998 \, Microsoft Research;
+#X text 41 307 - Learning Opencv \, Bradski and Kaehler \, 2008 \,
+O'Reilly;
+#X text 50 11 none;
+#X obj 455 -188 cnv 15 720 800 empty empty empty 20 12 0 14 -228992
+-66577 0;
+#X obj 615 374 cnv 15 400 160 empty empty empty 20 12 0 14 -4034 -66577
+0;
+#X obj 815 -160 gemhead;
+#X obj 619 569 pix_texture;
+#X obj 795 538 cnv 15 220 70 empty empty empty 20 12 0 14 -195568 -66577
+0;
+#N canvas 3 81 454 304 gemwin 0;
+#X obj 67 89 outlet;
+#X obj 67 10 inlet;
+#X obj 65 41 route create;
+#X msg 67 70 set destroy;
+#X msg 182 68 set create;
+#N canvas 87 154 247 179 Gem.init 0;
+#X obj 118 46 loadbang;
+#X msg 118 81 reset;
+#X obj 118 113 outlet;
+#X connect 0 0 1 0;
+#X connect 1 0 2 0;
+#X restore 289 80 pd Gem.init;
+#X obj 162 241 gemwin;
+#X msg 342 184 destroy;
+#X msg 283 161 frame 25;
+#X obj 164 126 t b b b;
+#X msg 161 189 dimen 640 560 \, create \, 1;
+#X connect 1 0 2 0;
+#X connect 2 0 3 0;
+#X connect 2 0 9 0;
+#X connect 2 1 4 0;
+#X connect 2 1 7 0;
+#X connect 3 0 0 0;
+#X connect 4 0 0 0;
+#X connect 7 0 6 0;
+#X connect 8 0 6 0;
+#X connect 9 0 10 0;
+#X connect 9 2 8 0;
+#X connect 10 0 6 0;
+#X restore 805 584 pd gemwin;
+#X msg 805 564 destroy;
+#X obj 485 570 pix_texture;
+#X obj 619 216 separator;
+#X obj 827 -133 bng 25 250 50 0 load empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 884 42 bng 15 250 50 0 empty empty end_reached 20 7 0 10 -262144
+-1 -1;
+#X floatatom 866 7 5 0 10000 1 frame# - -, f 5;
+#X obj 827 -104 openpanel;
+#X msg 827 -84 open \$1;
+#X obj 815 25 pix_film;
+#X msg 833 -41 auto \$1;
+#X obj 833 -59 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 1
+1;
+#X text 803 544 Create window and render;
+#X msg 928 -58 colorspace RGBA;
+#X msg 942 -35 colorspace RGB;
+#X msg 957 -13 colorspace Grey;
+#X obj 928 -86 loadbang;
+#X obj 619 197 pix_separator;
+#X obj 485 217 separator;
+#X obj 485 198 pix_separator;
+#N canvas 1 184 299 199 vswitch 0;
+#X obj 36 128 outlet;
+#X obj 36 26 inlet;
+#X obj 130 26 inlet;
+#X obj 175 27 inlet;
+#X obj 81 61 == 0;
+#X obj 36 83 spigot 1;
+#X obj 130 84 spigot 0;
+#X connect 1 0 5 0;
+#X connect 2 0 6 0;
+#X connect 3 0 4 0;
+#X connect 3 0 6 1;
+#X connect 4 0 5 1;
+#X connect 5 0 0 0;
+#X connect 6 0 0 0;
+#X restore 485 67 pd vswitch;
+#X obj 581 68 tgl 15 0 empty load empty 17 7 0 10 -262144 -1 -1 1 1
+;
+#X obj 485 34 pix_video;
+#X obj 485 -160 gemhead;
+#X msg 504 -88 dimen 640 480;
+#X msg 502 -113 dimen 320 240;
+#X text 681 432 load distorsion coefficients and intrinsic matrix;
+#X msg 531 -18 driver v4l2;
+#X msg 515 -65 driver dc1394 \, dimen 640 480 \, colorspace grey;
+#X msg 540 3 driver dc1394;
+#X obj 619 494 pix_opencv_calibration;
+#X obj 485 165 pix_grey;
+#X obj 485 236 translateXYZ 0 -2 0;
+#X obj 619 236 translateXYZ 0 2 0;
+#X obj 485 590 rectangle 2.666 2;
+#X obj 619 590 rectangle 2.666 2;
+#X msg 682 451 loadDist \$1;
+#X msg 698 471 loadIntra \$1;
+#X msg 652 391 writeDist \$1;
+#X msg 663 413 writeIntra \$1;
+#X text 651 372 write distorsion coefficients and intrinsic matrix
+;
+#X obj 746 117 cnv 15 420 240 empty empty empty 20 12 0 14 -4034 -66577
+0;
+#X obj 754 128 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 1
+1;
+#X msg 754 148 calibration \$1;
+#X msg 754 192 view \$1;
+#X text 793 170 number of view to take during calibration;
+#X floatatom 754 174 5 0 0 0 - - -, f 5;
+#X obj 754 233 pack f f;
+#X msg 754 253 patternSize \$1 \$2;
+#X floatatom 754 215 5 0 0 0 - - -, f 5;
+#X floatatom 807 215 5 0 0 0 - - -, f 5;
+#X text 844 211 number of inner corners on the chessboard;
+#N canvas 130 67 612 325 advance-options 0;
+#X msg 55 161 findChessFlag \$1 \$2 \$3;
+#X obj 68 91 t b f;
+#X obj 55 142 pack f f f;
+#X obj 118 111 t b f;
+#X obj 55 51 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 1
+;
+#X obj 68 71 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0 1
+;
+#X obj 118 91 tgl 15 0 empty empty empty 17 7 0 10 -262144 -1 -1 0
+1;
+#X obj 55 267 outlet;
+#X text 53 27 findChessBoardCorner option;
+#X text 75 50 CV_CALIB_CB_ADAPTIVE_TRESH : adaptive threhold (default
+1);
+#X text 84 70 CV_CALIB_CB_NORMALIZE_IMAGE : normalize image (default
+0);
+#X text 135 91 CV_CALIB_CB_FILTER_QUADS: advance filtering (default
+1);
+#X connect 0 0 7 0;
+#X connect 1 0 2 0;
+#X connect 1 1 2 1;
+#X connect 2 0 0 0;
+#X connect 3 0 2 0;
+#X connect 3 1 2 2;
+#X connect 4 0 2 0;
+#X connect 5 0 1 0;
+#X connect 6 0 3 0;
+#X restore 753 315 pd advance-options;
+#X floatatom 754 274 5 0 0 0 - - -, f 5;
+#X msg 754 292 wait \$1;
+#X text 792 273 number of frame to wait between two takes during calibration
+;
+#X text 773 128 start callibration;
+#X obj 544 166 pix_rgba;
+#X obj 485 140 spigot 1;
+#X text 598 66 switch source (camera / film);
+#X obj 530 95 tgl 15 0 empty load empty 17 7 0 10 -262144 -1 -1 1 1
+;
+#X text 547 93 switch color mode ( grey / rgba );
+#X msg 524 -41 device 1;
+#X obj 530 118 == 0;
+#X obj 544 140 spigot 0;
+#X msg 753 335 reset;
+#X text 797 334 reset corrections;
+#X obj 748 516 print;
+#X text 784 516 print some infos;
+#X obj 635 351 t a;
+#X text 26 -100 Description: pix_opencv_calibration does camera calibration.
+You need to move a checkboard in front of the camera during the calibration.
+;
+#X connect 18 0 30 0;
+#X connect 19 0 56 0;
+#X connect 21 0 22 0;
+#X connect 22 0 21 0;
+#X connect 23 0 55 0;
+#X connect 24 0 54 0;
+#X connect 25 0 28 0;
+#X connect 26 0 27 0;
+#X connect 27 0 30 1;
+#X connect 28 0 29 0;
+#X connect 29 0 30 0;
+#X connect 30 0 41 1;
+#X connect 30 2 26 0;
+#X connect 31 0 30 0;
+#X connect 32 0 31 0;
+#X connect 34 0 30 0;
+#X connect 34 0 43 0;
+#X connect 35 0 30 0;
+#X connect 36 0 30 0;
+#X connect 37 0 34 0;
+#X connect 37 0 32 0;
+#X connect 38 0 24 0;
+#X connect 39 0 53 0;
+#X connect 40 0 39 0;
+#X connect 41 0 79 0;
+#X connect 41 0 85 0;
+#X connect 42 0 41 2;
+#X connect 43 0 41 0;
+#X connect 44 0 43 0;
+#X connect 45 0 43 0;
+#X connect 46 0 43 0;
+#X connect 48 0 43 0;
+#X connect 49 0 43 0;
+#X connect 50 0 43 0;
+#X connect 51 0 19 0;
+#X connect 51 1 88 0;
+#X connect 52 0 40 0;
+#X connect 52 0 38 0;
+#X connect 53 0 23 0;
+#X connect 54 0 51 0;
+#X connect 57 0 51 0;
+#X connect 58 0 51 0;
+#X connect 59 0 51 0;
+#X connect 60 0 51 0;
+#X connect 63 0 64 0;
+#X connect 64 0 90 0;
+#X connect 65 0 90 0;
+#X connect 67 0 65 0;
+#X connect 68 0 69 0;
+#X connect 69 0 90 0;
+#X connect 70 0 68 0;
+#X connect 71 0 68 1;
+#X connect 73 0 90 0;
+#X connect 74 0 75 0;
+#X connect 75 0 90 0;
+#X connect 78 0 40 0;
+#X connect 78 0 38 0;
+#X connect 79 0 52 0;
+#X connect 81 0 84 0;
+#X connect 81 0 85 1;
+#X connect 83 0 43 0;
+#X connect 84 0 79 1;
+#X connect 85 0 78 0;
+#X connect 86 0 90 0;
+#X connect 90 0 51 0;