aboutsummaryrefslogtreecommitdiff
path: root/pd/doc/1.manual/x1.htm
blob: 92585e692bcb48b6eaa9d4eb2ca51819df0d5567 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">

<HTML>
  <HEAD>
	 <TITLE>Pd Documentation 1</TITLE>
    <meta http-equiv="Content-Type" content="text/html">
	 <link rel="stylesheet" type="text/css" href="pdmanual.css" media="screen">
  </HEAD>

<BODY>

<H2>Pd Documentation chapter 1: introduction</H2>

<P>
<A href="index.htm#s1"> back to table of contents </A>
<BR><BR>
</P>


<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.
<H3> <A name=s1> 1.1. guide to the documentation </A> </H3>

<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>
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 "Browser..." in the Pd help menu and looking in
5.reference.

<P>
The example patches are also available from the "Browser..." item
in Pd's "help" menu.  They 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.

<H3> <A name=s2> 1.2. other resources </A> </H3>

<P> There is a very extensive Pd community web site,
<a href="http://www.pure-data.info/"> pure-data.info</a>, which aims to be the
central resource for Pd, from documentation and
downloads; to forums, member pages, and a patch exchange.

<P> More documentation is avalable on the Pd FLOSS site:
<A href=http://en.flossmanuals.net/PureData/>
en.flossmanuals.net/PureData/</A> (English) and
<A href=http://fr.flossmanuals.net/PureData/>
fr.flossmanuals.net/PureData/</A> (French).

<P>
Most of the interesting news related to Pd shows up on the Pd mailing list,
maintained by Iohannes Zmoelnig.  To subscribe or browse the archives
visit:
    <A href="http://iem.at/mailinglists/pd-list/">
    http://iem.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> the Pd Extended package, maintained by Hans-Christophe Steiner, can be
downloaded from the <A href=http://sourceforge.net/projects/pure-data/>  Pd's
sourceforge site </A>.   All this and much more is described in detail on <A
href="http://puredata.info/"> http://puredata.info/</A>.

<P> Many extensions to Pd are announced on the mailing list.  In particular,
for people interested in graphics, there is a 3D graphics rendering package,
named GEM, based on OpenGL, written by Mark Danks, adapted to Linux by
Guenter Geiger, and now maintained by Iohannes Zmoelnig.  You can get
it from: <A href="http://iem.at/GEM">http://iem.kug.ac.at/GEM</A>, or by
installing Pd Extended.

<P>
Here are some more Pd links (updated 2/2011): <BR>
<a href="http://obiwannabe.co.uk/tutorials/html/tutorials_main.html">
Andy Farnell's Tutorial</A><BR>
<a href="http://sites.google.com/site/porres/TutorialPd.zip">
Alexandre Porres's Tutorial (Portuguese)</A><BR>
<A HREF="http://www.crca.ucsd.edu/~msp/techniques.htm">
Puckette's book, <I> Theory and Techniques of Electronic Music</A> </I> <br>
<a href="http://www.crca.ucsd.edu/~msp"> Miller Puckette's home page</a><br>
<a href="http://iem.at/~zmoelnig/index.html">
    Johannes M Zmoelnig</a><br>
<a href="http://www-ccrma.stanford.edu/planetccrma/software/soundapps.html#pd">
Fernando Pablo Lopez's RPMs from Planet CCRMA</a><br>
</BODY>
</HTML>