[PD-cvs] SF.net SVN: pure-data: [9965] branches/pd-extended/v0-40/externals/pdp/ opengl/doc/objects
eighthave at users.sourceforge.net
eighthave at users.sourceforge.net
Mon Jun 2 02:05:34 CEST 2008
Revision: 9965
http://pure-data.svn.sourceforge.net/pure-data/?rev=9965&view=rev
Author: eighthave
Date: 2008-06-01 17:05:30 -0700 (Sun, 01 Jun 2008)
Log Message:
-----------
whipped up some very quick help patches from the 3dp README
Added Paths:
-----------
branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_draw.pd
branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_push-help.pd
branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_snap-help.pd
branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_view-help.pd
branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_windowcontext-help.pd
Added: branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_draw.pd
===================================================================
--- branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_draw.pd (rev 0)
+++ branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_draw.pd 2008-06-02 00:05:30 UTC (rev 9965)
@@ -0,0 +1,10 @@
+#N canvas 530 361 450 300 10;
+#X obj 153 47 3dp_draw circle;
+#X text 48 88 some simple objects can be drawn using the pdp_draw object.
+the first argument is the object: square \, cube \, sphere \, torus
+\, cone \, teapot \, dodeca \, icosa \, octa \, tetra. prepending the
+names with a w draws the wireframe version. (i.e. wcube is a wireframe
+cube). the first inlet of the object is a texture inlet. not all objects
+support this \, but cube \, square and sphere do. other inlets set
+some parameters like size \, nb of segments for sphere \, etc.. they
+can be specified by creation arguments too.;
Added: branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_push-help.pd
===================================================================
--- branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_push-help.pd (rev 0)
+++ branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_push-help.pd 2008-06-02 00:05:30 UTC (rev 9965)
@@ -0,0 +1,9 @@
+#N canvas 460 581 450 300 10;
+#X obj 159 39 3dp_push;
+#X text 57 11 If you need to branch use a 3dp_push object.;
+#X text 41 99 saving a (matrix) state can be accomplished by the 3dp_push
+object. the default matrix is the modelview matrix. it works as follows:
+both the right and the left outlet propagate the same matrix state
+as the input. so in short you can use 3dp_push to split your rendering
+tree into parallel branches. the matrix types that can be pushed are:
+modelview \, texture \, color \, projection;
Added: branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_snap-help.pd
===================================================================
--- branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_snap-help.pd (rev 0)
+++ branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_snap-help.pd 2008-06-02 00:05:30 UTC (rev 9965)
@@ -0,0 +1,13 @@
+#N canvas 23 127 436 363 10;
+#X text 38 16 couping 3dp and pdp can be done using 3dp_snap and pdp_convert.
+the correct way to do it is to put 3dp_snap in a rendering chain and
+give it arguments like this: [3dp_snap image/*/* 320 240] if you specify
+the subtype to be image/multi/* \, the packet will not be colour space
+converted: it will stay rgb. if you want to make a snapshot to store
+as a high quality png image \, snap to bitmap/rgb/* and store it in
+pdp_reg to save. to convert an image back to a texture \, use [pdp_convert
+texture/*/*] if you snap to a texture (which is the default) the dimensions
+don't need to be specified. a texture will be allocated that can contain
+the entire screen. this is because texture coordinates are relative
+and data is always interpolated. snapping only works correctly when
+the window is not covered by other windows.;
Added: branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_view-help.pd
===================================================================
--- branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_view-help.pd (rev 0)
+++ branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_view-help.pd 2008-06-02 00:05:30 UTC (rev 9965)
@@ -0,0 +1,24 @@
+#N canvas 462 243 471 316 10;
+#X text 59 136 geometric transformations can be done using the 3dp_view
+object. the first argument is the kind of transformation: scale \,
+scalex \, scaley \, scalez \, rotx \, roty \, rotz \, rota \, transx
+\, transy \, transz \, transxyz.;
+#X obj 33 19 3dp_view scale;
+#X obj 33 40 3dp_view scalex;
+#X obj 33 61 3dp_view scaley;
+#X obj 33 83 3dp_view scalez;
+#X obj 173 19 3dp_view rota;
+#X obj 173 40 3dp_view rotx;
+#X obj 173 61 3dp_view roty;
+#X obj 173 83 3dp_view rotz;
+#X obj 313 19 3dp_view transxyz;
+#X obj 313 40 3dp_view transx;
+#X obj 313 61 3dp_view transy;
+#X obj 313 83 3dp_view transz;
+#X text 60 195 repectively this scales the object \, the x \, y \,
+z axis \, rotates around the x \, y \, z axis \, rotates around an
+arbitrary axis \, translates in the x \, y \, z directions and translates
+along a vector. the initial parameters can be specified as creation
+arguments \, i.e.:;
+#X text 57 272 [3dp_view rota 1 1 1 90] rotates by 90 degrees around
+axis (1 \, 1 \, 1).;
Added: branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_windowcontext-help.pd
===================================================================
--- branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_windowcontext-help.pd (rev 0)
+++ branches/pd-extended/v0-40/externals/pdp/opengl/doc/objects/3dp_windowcontext-help.pd 2008-06-02 00:05:30 UTC (rev 9965)
@@ -0,0 +1,24 @@
+#N canvas 53 117 613 353 10;
+#X obj 67 71 3dp_windowcontext;
+#X obj 67 46 metro 40;
+#X obj 67 23 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1
+;
+#X obj 166 154 pddp/print;
+#X obj 214 129 pddp/print;
+#X obj 299 188 route drag1 drag2 drag3;
+#X obj 434 210 route press1 press2 press3;
+#X obj 166 108 route motion drag;
+#X text 223 -54 the 3dp_windowcontext creates a window to draw in.
+the window packet will be be output to the left outlet when a bang
+is received. control flow for context is right to left \, this means
+if a 3dp object has 2 context outlets \, the rightmost will be propagated
+before the leftmost. there is no fanout. all operations are accumulative
+\, including the geometric transformations. if you need to branch use
+a 3dp_push object.;
+#X connect 0 1 7 0;
+#X connect 1 0 0 0;
+#X connect 2 0 1 0;
+#X connect 5 3 6 0;
+#X connect 7 0 3 0;
+#X connect 7 1 4 0;
+#X connect 7 2 5 0;
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
More information about the Pd-cvs
mailing list