aboutsummaryrefslogtreecommitdiff
path: root/pd/doc/1.manual/x1.htm
diff options
context:
space:
mode:
Diffstat (limited to 'pd/doc/1.manual/x1.htm')
-rw-r--r--pd/doc/1.manual/x1.htm112
1 files changed, 112 insertions, 0 deletions
diff --git a/pd/doc/1.manual/x1.htm b/pd/doc/1.manual/x1.htm
new file mode 100644
index 00000000..946949e9
--- /dev/null
+++ b/pd/doc/1.manual/x1.htm
@@ -0,0 +1,112 @@
+<HTML>
+<HEAD>
+<TITLE>Pd Documentation 1</TITLE>
+</HEAD>
+<BODY bgcolor="#ffffff">
+<SMALL>
+<div style="width:6.5in; margin-left:.5in">
+
+<CENTER> <B>
+Pd Documentation chapter 1: introduction
+</B> </CENTER>
+<BR>
+<A href=index.htm#s1> back to table of contents </A>
+ <BR><BR>
+<P>
+This is the HTML documentation for the Pd computer program.
+Pd is free and can be downloaded from the internet;
+go to
+ <A href="http://www.crca.ucsd.edu/~msp/software.html">
+ http://www.crca.ucsd.edu/~msp/software.html</A>
+to get it.
+<H4> <A name=s1> 1.1. guide to the documentation </A> </H4>
+
+<P> Pd's documentation consists of:
+
+<UL>
+<LI> this HTML manual
+<LI> "reference" patches, one for each kind of object in Pd
+<LI> "example" patches showing how to do things
+<LI> sample C code
+</UL>
+
+<P>
+This manual has five sections:
+
+<OL>
+<LI> this overview
+<LI> <A href="x2.htm">
+ a theory of operations, explaining how Pd works </A>
+<LI> <A href="x3.htm">
+ instructions on installing Pd and getting it to run </A>
+<LI> <A href="x4.htm"> how to write C extensions to Pd </A>
+<LI> <A href="x5.htm"> release notes and known bugs </A>
+</OL>
+
+<P> In order to consult the reference and example patches, you'll first have
+to get Pd started as explained in this manual.
+
+<P>
+For a list of all the objects you can use in Pd, see the text file,
+"0.INTRO.txt" in the directory, "../5.reference". To get help on any
+Pd object you can right click on it; or you can browse the help patches
+by choosing "Pure Documentation..." in the Pd help menu and looking in
+5.reference.
+
+<P>
+The example patches are also available from the "Pure Documentation..." item
+in Pd's
+"help" menu. The example patches appear in subdirectories named
+"2.control.examples", "3.audio.examples" and "4.fft.examples." Some additional
+patches in "7.stuff" might also be helpful.
+
+<P>
+To get started writing your own C extensions, refer to chapter 4 of this manual.
+
+<H4> <A name=s2> 1.2. other resources </A> </H4>
+
+<P>
+Most of the interesting resources related to Pd show up on the Pd mailing list,
+maintained by Iohannes Zmoelnig. To subscribe or browse the archives
+visit:
+ <A href="http://iem.kug.ac.at/mailinglists/pd-list/">
+ http://iem.kug.ac.at/mailinglists/pd-list/</A>.
+
+. This is the
+best source of recent information regarding installation problems and bugs. It
+is perfectly reasonable to post "newbie" questions on this list; alternatively
+you can contact msp@ucsd.edu for help.
+
+<P> Many extensions to Pd are announced on the mailing list. In particular,
+for people interested in graphics, there is a A 3D graphics rendering package,
+named GEM, based on OpenGL, was written by Mark Danks, adapted to Linux by
+Guenter Geiger, and is now maintained by Iohannes Zmoelnig. GEM runs on
+Windows and Linux and probably will run with some coaxing on IRIX. You can get
+it from: <A href=http://iem.kug.ac.at/GEM>http://iem.kug.ac.at/GEM</A> .
+
+<P> A video processing package, Framestein, is by Juha Vehvilainen. This runs
+on Windows only: <A href=http://framestein.org> http://framestein.org </A>.
+
+<P>
+Here are some more Pd links (in the order I found them): <BR>
+
+<a href="http://www.crca.ucsd.edu/~msp"> Miller Puckette's home page</a><br>
+<a href="http://gige.epy.co.at/"> Guenter Geiger's home page</a><br>
+<a href="http://www.danks.org/mark"> Mark Dank's home page</a><br>
+<a href="http://wonk.epy.co.at">Pd page on Wonk (Klaus)</a><br>
+<a href="http://iem.kug.ac.at/~zmoelnig/index.html">
+ Johannes M Zmoelnig</a><br>
+<a href="http://iem.kug.ac.at/~math/pd/"> Norbert Math's Pd page</a> <br>
+<a href="http://iem.kug.ac.at/iemlib/"> Thomas Musil's IEMLIB</a> <br>
+<a href="http://www.pure-data.org/"> jfm3's Pure Data FAQ and downloads</a>
+(also available in Japanese translation).<br>
+<a href="http://iem.kug.ac.at/pdwiki/">
+Nicolas Lhommet's WikiWikiWeb page for Pd</a><br>
+<a href="http://iem.kug.ac.at/pdb/"> Norbert's searchable list of all known
+Pd objects</a><br>
+<a href="http://suita.chopin.edu.pl/~czaja/miXed/externs/xeq.html">
+Krzysztof Czaja's MIDI file support </a><br>
+<a href="http://www.davesabine.com/media/puredata.asp?action=pddp">
+David Sabine's Pd Documentation Project: new, highly detailed help windows</a><br>
+</BODY>
+</HTML>