From 4cde391f5f1ba80c803fc02adece857e5eb720f7 Mon Sep 17 00:00:00 2001 From: Miller Puckette Date: Sun, 21 Aug 2005 17:46:52 +0000 Subject: Fixed scalar_redraw to check if glist is visible; moved 'data' doc and updated it somewhat. svn path=/trunk/; revision=3441 --- pd/doc/4.data.structures/00.intro.txt | 113 ++ pd/doc/4.data.structures/01.scalars.pd | 63 ++ pd/doc/4.data.structures/02.getting.data.pd | 77 ++ pd/doc/4.data.structures/03.setting.data.pd | 141 +++ pd/doc/4.data.structures/04.append.pd | 36 + pd/doc/4.data.structures/05.array.pd | 120 +++ pd/doc/4.data.structures/06.file.pd | 69 ++ pd/doc/4.data.structures/07.sequencer.pd | 148 +++ pd/doc/4.data.structures/08.selection.pd | 81 ++ pd/doc/4.data.structures/09.scaling.pd | 74 ++ pd/doc/4.data.structures/10.beat-patterns.pd | 455 ++++++++ pd/doc/4.data.structures/11.sliderule.pd | 205 ++++ pd/doc/4.data.structures/12.sinedecomposer.pd | 250 +++++ pd/doc/4.data.structures/13.partialtracer.pd | 839 +++++++++++++++ pd/doc/4.data.structures/add-trace.pd | 152 +++ pd/doc/4.data.structures/beat-maker.pd | 44 + pd/doc/4.data.structures/data-array.pd | 64 ++ pd/doc/4.data.structures/data-start.pd | 40 + pd/doc/4.data.structures/file.txt | 39 + pd/doc/4.data.structures/osc-voice.pd | 54 + pd/doc/4.data.structures/output~.pd | 66 ++ pd/doc/4.data.structures/voice.pd | 119 +++ pd/doc/4.data.structures/z.txt | 64 ++ pd/doc/4.fft.examples/00.INTRO.txt | 13 - pd/doc/4.fft.examples/12.sinedecomposer.pd | 308 ------ pd/doc/4.fft.examples/13.partialtracer.pd | 1181 --------------------- pd/doc/4.fft.examples/add-trace.pd | 152 --- pd/doc/4.fft.examples/osc-voice.pd | 54 - pd/doc/7.stuff/data-structures/0.intro.txt | 113 -- pd/doc/7.stuff/data-structures/1.scalars.pd | 63 -- pd/doc/7.stuff/data-structures/2.getting.data.pd | 77 -- pd/doc/7.stuff/data-structures/3.setting.data.pd | 141 --- pd/doc/7.stuff/data-structures/4.append.pd | 36 - pd/doc/7.stuff/data-structures/5.array.pd | 120 --- pd/doc/7.stuff/data-structures/6.file.pd | 69 -- pd/doc/7.stuff/data-structures/7.sequencer.pd | 193 ---- pd/doc/7.stuff/data-structures/8.beat-patterns.pd | 452 -------- pd/doc/7.stuff/data-structures/9.sliderule.pd | 196 ---- pd/doc/7.stuff/data-structures/beat-maker.pd | 44 - pd/doc/7.stuff/data-structures/data-array.pd | 64 -- pd/doc/7.stuff/data-structures/data-start.pd | 40 - pd/doc/7.stuff/data-structures/file.txt | 39 - pd/doc/7.stuff/data-structures/score.txt | 94 -- pd/doc/7.stuff/data-structures/voice.pd | 119 --- pd/doc/7.stuff/data-structures/z.txt | 64 -- pd/src/g_scalar.c | 3 +- pd/src/g_template.c | 8 +- pd/src/makefile | 2 +- pd/src/makefile.dependencies | 1073 ------------------- pd/src/notes.txt | 2 + 50 files changed, 3322 insertions(+), 4711 deletions(-) create mode 100644 pd/doc/4.data.structures/00.intro.txt create mode 100644 pd/doc/4.data.structures/01.scalars.pd create mode 100644 pd/doc/4.data.structures/02.getting.data.pd create mode 100644 pd/doc/4.data.structures/03.setting.data.pd create mode 100644 pd/doc/4.data.structures/04.append.pd create mode 100644 pd/doc/4.data.structures/05.array.pd create mode 100644 pd/doc/4.data.structures/06.file.pd create mode 100644 pd/doc/4.data.structures/07.sequencer.pd create mode 100644 pd/doc/4.data.structures/08.selection.pd create mode 100644 pd/doc/4.data.structures/09.scaling.pd create mode 100644 pd/doc/4.data.structures/10.beat-patterns.pd create mode 100644 pd/doc/4.data.structures/11.sliderule.pd create mode 100644 pd/doc/4.data.structures/12.sinedecomposer.pd create mode 100644 pd/doc/4.data.structures/13.partialtracer.pd create mode 100644 pd/doc/4.data.structures/add-trace.pd create mode 100644 pd/doc/4.data.structures/beat-maker.pd create mode 100644 pd/doc/4.data.structures/data-array.pd create mode 100644 pd/doc/4.data.structures/data-start.pd create mode 100644 pd/doc/4.data.structures/file.txt create mode 100644 pd/doc/4.data.structures/osc-voice.pd create mode 100644 pd/doc/4.data.structures/output~.pd create mode 100644 pd/doc/4.data.structures/voice.pd create mode 100644 pd/doc/4.data.structures/z.txt delete mode 100644 pd/doc/4.fft.examples/00.INTRO.txt delete mode 100644 pd/doc/4.fft.examples/12.sinedecomposer.pd delete mode 100644 pd/doc/4.fft.examples/13.partialtracer.pd delete mode 100644 pd/doc/4.fft.examples/add-trace.pd delete mode 100644 pd/doc/4.fft.examples/osc-voice.pd delete mode 100644 pd/doc/7.stuff/data-structures/0.intro.txt delete mode 100644 pd/doc/7.stuff/data-structures/1.scalars.pd delete mode 100644 pd/doc/7.stuff/data-structures/2.getting.data.pd delete mode 100644 pd/doc/7.stuff/data-structures/3.setting.data.pd delete mode 100644 pd/doc/7.stuff/data-structures/4.append.pd delete mode 100644 pd/doc/7.stuff/data-structures/5.array.pd delete mode 100644 pd/doc/7.stuff/data-structures/6.file.pd delete mode 100644 pd/doc/7.stuff/data-structures/7.sequencer.pd delete mode 100644 pd/doc/7.stuff/data-structures/8.beat-patterns.pd delete mode 100644 pd/doc/7.stuff/data-structures/9.sliderule.pd delete mode 100644 pd/doc/7.stuff/data-structures/beat-maker.pd delete mode 100644 pd/doc/7.stuff/data-structures/data-array.pd delete mode 100644 pd/doc/7.stuff/data-structures/data-start.pd delete mode 100644 pd/doc/7.stuff/data-structures/file.txt delete mode 100644 pd/doc/7.stuff/data-structures/score.txt delete mode 100644 pd/doc/7.stuff/data-structures/voice.pd delete mode 100644 pd/doc/7.stuff/data-structures/z.txt diff --git a/pd/doc/4.data.structures/00.intro.txt b/pd/doc/4.data.structures/00.intro.txt new file mode 100644 index 00000000..a1df9a88 --- /dev/null +++ b/pd/doc/4.data.structures/00.intro.txt @@ -0,0 +1,113 @@ +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