Pure Data
From Wikicliki
Contents
Learning by reading Pure Data examples
Today's goal is to read 12 tutorials to understand how PD works.
Patch 1 - Hello World
I made a loadbang. Hooked it to a [Message( with any text inside. Finally, it leads to a [print] object. If you press the loadbang it will print to the display. In the example image above i have pressed it many many times. This is like the trace function that will come in useful further on for debugging and troubleshooting.
- Shortcut for switching between edit and play mode is ⌘-E
- List of keyboard shortcuts for different things you will write within PD (its good to be familiar with the terminologies)
Patch 2 - Flossmanual's GEM Basic Drawing
From Flossmanual's Basic Gem Tutorial, which helps explain the basics of GEM ("Graphics Environment for Multimedia"). This example loads an image in and maps it to a simple geo, a rectangle.
- Image has to be placed in the same folder as the pd patch
- Objects that deal with textures are called pix objects and have the prefix "pix_" in their object name.
- Why do we still need [pix_texture] with the other [pix_image]? Because this is the pix_texture is the part that indicates that the texture is to be mapped onto the geo (in this case a rectangle).
- List of Gem controls (From List of Gem Objects
- gemhead - the start of rendering chain
- gemwin - the window manager
- gemmouse - outputs the mouse position and buttons in the GEM window
- gemkeyboard - outputs the keycode of a key pressed when you are in the GEM window (there might be different keycodes in Windows/Linux)
- gemkeyname - outputs a symbolic description of a key pressed when you are in the GEM window (there might be different symbols in Windows/Linux)
- gemorb - outputs the position, rotation, and buttons for a Space Orb
- gemtablet - outputs the pen position, pressure, and buttons in the GEM window
- List of possible Geos (From List of Gem Objects
- circle - render a circle
- colorSquare - render a colored square (evtl. with color gradients)
- cone - render a cone
- cube - render a cube
- cuboid - render a box
- curve - render a Bezier curve
- curve3d - render a surface
- cylinder - render a cylinder
- disk - render a disk
- imageVert - make pixel colors to a height field map
- model - render an Alias|Wavefront model
- multimodel - render a series of Alias|Wavefront models, render by number
- newWave - render a wave (that is evolving over time)
- polygon - render a polygon
- primTri - a triangle primitive
- rectangle - render a rectangle
- ripple - a rectangle with distorted (over time) texture-coordinates
- rubber - a grid where you can move one of the grid-points
- slideSquare - render a number of sliding squares
- sphere - render a sphere
- square - render a square
- teapot - render a teapot
- text2d - render 2-D text (a bitmap)
- text3d - render 3-D text (polygonal)
- textextruded - render an extruded 3D-text
- textoutline - render outlined text (polygonal)
- triangle - render a triangle
- Teapot example:
- BONUS!!! I found an extra shape while reading another page: the pqtorusknots... (note there is no pqtorus... just pqtorusknots)
- (a torus knot is like a big fat knotted math cushion. this is a better description of a pqtorus knot.)
Patch 3 - Feedback Loop patch by hellocatfood
From http://www.hellocatfood.com/2012/03/23/feedback-loops-in-pure-data/
- Noticed there was no connection between the original loading video geo and the feedback geos. Apparently the different geos do not need to be connected up. in this example [gemhead 4] runs first followed by whatever gemhead number next in order. it could be any number bigger than 4. if the second one was gemhead 3 it wouldnt work. the higher the number, the later the [gemhead] is drawing...
- No soundtrack. Found out from this flossmanuals page on Images, Movies and Live Video that "Sound is not supported by [pix_film] ([pix_movie] neither). If you want to sync a soundtrack of a video to your images, you have to first extract it using an external video editor."
- List of the messages that the gemwin understands
- create - makes the window for output and an OpenGL rendering context
- destroy - removes the output window and the OpenGL context
- 1 - starts rendering
- 0 - stops rendering
- bang - swaps buffers in double buffered mode; clears the window in single buffered mode
- frame $1 - the number sets the frames per second the render chain executes\
- cursor 0/1 - turns the cursor on (1) or off (0)
- border 0/1 - (1) draws a border around the window, (0) removes it
- offset x y - sets the position where the window is drawn. this is usually the screen coordinates for the top left corner of the window. the units are pixels.
- dimen x y - sets the size of the output window. x is the horizontal dimension in pixels, y is the vertical dimension in pixels.
- fullscreen 0/1 - draws the window as the entire size of the screen.
- title 'name' - puts a title on top of the window where applicable
- color R G B - changes the background color to the mixture of the Red Green and Blue values. The values are floating point numbers between 0 and 1 where 0 0 0 is black and 1 1 1 is white (1 0 0 is Red etc.)
see also
- max neupert's tutorials
