From 8dbec761cf858ea65900c8a094599857208d8c3a Mon Sep 17 00:00:00 2001 From: "N.N." Date: Tue, 5 Jan 2010 22:49:36 +0000 Subject: svn path=/trunk/; revision=12907 --- desiredata/doc/4.data.structures/00.intro.txt | 113 -------------------------- 1 file changed, 113 deletions(-) delete mode 100644 desiredata/doc/4.data.structures/00.intro.txt (limited to 'desiredata/doc/4.data.structures/00.intro.txt') diff --git a/desiredata/doc/4.data.structures/00.intro.txt b/desiredata/doc/4.data.structures/00.intro.txt deleted file mode 100644 index a1df9a88..00000000 --- a/desiredata/doc/4.data.structures/00.intro.txt +++ /dev/null @@ -1,113 +0,0 @@ -Pd release 0.23 and onward include objects for managing lists of data. The -objects allow you to describe data structures and how they are viewed -("template objects") and to traverse lists ("traversal objects.") - -The rest of this file gives a highly condensed summary of what's there; the -patches, starting with "1.scalars.pd", act as a tutorial. - -1. TEMPLATE OBJECTS. - -templates describe data structures. You can add an item to a data structure -using "field" or ask for a shape to be drawn using a "display command." - -1.1. "template" -- data structure. - -usage, "template ..." - -where the fields are either "float ", "symbol ", "list " -(don't try that yet); or "array . - -1.2. DISPLAY COMMANDS. - - -These are objects which ask Pd to draw a shape corresponding to some fields -of the datum. - -1.2.1. POLYGONS and CURVES. - -polygons: polygon ... -filled polygons: fpolygon ... -curves: curve ... -filled curves: fcurve ... - -Each argument can either be a number or a symbol. If a symbol, it's the -name of a field (which must be a "float) which specifies the vaiue. -So for instance in the "1.scalar.pd" example, in the template "template1", -the object "fpolygon 244 q 5 0 0 20 z 40 0" draws a filled polygon whose -interior color is 244 (red 2, green 4, blue 4) but whose outline color -depends on the value of the field "q". Its coordinates describe a triangle -whose altitude is given by "z." - -1.2.2 PLOT. - -The "plot" objects plots an array field as shown in 5_array.pd. - -2. TRAVERSAL. - -In this release of Pd, you can only traverse lists all of whose elements -belong to the same template; this restriction will be relaxed in a future -release. You "traverse" a list either to build it, to get its elements, -or to change their values. - -2.1. POINTER. - -The "pointer" object can be used to refer to an element of a list. Its -methods are: - -2.1.1. traverse . - -Point to the "head" of a list. The symbol should match the name of a Pd -window holding the list. The pointer is output, but you can't set or get the -fields of the "head" pointer; you can only get the "next" element or "append" -to the list. - -2.1.2. next. Goes to the next element of the list. Either the pointer -is output on the left side, or else a "bang" at right tells you that no -more objects are forthcoming. - -2.1.3. bang. -outputs the current pointer. - -2.2. APPEND. Adds an element of the specified template to the list. You -specify what fields you want to supply and the last inlet takes a pointer to -the element you want to "append" after. - -2.3. GET. - - get