diff options
Diffstat (limited to 'pd/doc')
| -rw-r--r-- | pd/doc/1.manual/x1.htm | 26 | ||||
| -rw-r--r-- | pd/doc/1.manual/x3.htm | 167 | ||||
| -rw-r--r-- | pd/doc/1.manual/x5.htm | 50 |
3 files changed, 79 insertions, 164 deletions
diff --git a/pd/doc/1.manual/x1.htm b/pd/doc/1.manual/x1.htm index a9d8caaf..f1f884d1 100644 --- a/pd/doc/1.manual/x1.htm +++ b/pd/doc/1.manual/x1.htm @@ -102,21 +102,19 @@ it from: <A href="http://iem.kug.ac.at/GEM">http://iem.kug.ac.at/GEM</A> . <P> At least three video processing packages are available for Pd. The oldest is Framestein, by Juha Vehvilainen. This runs on Windows only: <A href="http://framestein.org"> http://framestein.org </A>. - -<P> The newer <A> href="http://zwizwa.fartit.com/pd/pdp/overview.html"> PDP -<A> library, by Tom Schouten, and its extension <A +The newer PDP +library, by Tom Schouten, and its extension <A href="http://ydegoyon.free.fr/pidip.html"> PiDiP </A> by Yves Degoyon, run well -in linux and has been ported to Windows and MacOS. Video is extremely fast in -PDP, but is currently limited to 240x320 resolution. - -<P> Mathieu Bouchard has written <A href=http://artengine.ca/gridflow/> +in linux and have been ported to Windows and MacOS. +Mathieu Bouchard has written <A href=http://artengine.ca/gridflow/> Gridflow </A>, which runs on linux and MacOSX. The mathematical operators are more powerful than in PDP, and the design makes smarter use of cache behavior in modern CPUs. -All this and much more is described in detail at the -<A href="http://puredata.info/community/projects/convention04/"> -first Pd Convention </A>. +<P> the Pd extended package, maintained by Hans-Christof 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> @@ -125,14 +123,8 @@ 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/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"> @@ -142,7 +134,7 @@ new, highly detailed help windows</a><br> Fernando Pablo Lopez's augmented Pd RPMs from Planet CCRMA</a><br> <a href="http://suita.chopin.edu.pl/~czaja/miXed/externs/cyclone.html"> Cyclone - Krzysztof Czaja's Max compatibility library</a><br> -On-line book project: +On-line book: <A HREF="http://www.crca.ucsd.edu/~msp/techniques.htm" <I> Theory and Techniques of Electronic Music </I> <br> diff --git a/pd/doc/1.manual/x3.htm b/pd/doc/1.manual/x3.htm index 9bc0f537..833d6ac7 100644 --- a/pd/doc/1.manual/x3.htm +++ b/pd/doc/1.manual/x3.htm @@ -17,12 +17,11 @@ <BR><BR> </P> -<P>Pd runs under Irix, Microsoft Windows, Linux, and MacOS 10.2 (Jaguar). -How to get Pd up and running depends on your operating system, -but the overall strategy is the same. -You must first get and install it, and -then untangle whatever problems arise in handling audio and MIDI input -and output, and finally get Pd to meet its real-time obligations reliably. +<P>Pd runs under Microsoft Windows, Linux, and MacOS (10.2 or later). How to +get Pd up and running depends on your operating system, but the overall strategy +is the same. You must first get and install it, and then untangle whatever +problems arise in handling audio and MIDI input and output, and finally get Pd +to meet its real-time obligations reliably. <P> Installation instructions are platform-specfic; the following four sections @@ -145,9 +144,8 @@ port, 17-32 the second one, and so on. The midiin, sysexin, midiout objects give you a separate inlet to specify which of the open MIDI port numbers you want. -<P> System exclusive MIDI message input and output is theoretically supported -in version 0.37 but does not work correctly on windows, even in 0.38. - +<P> System exclusive MIDI message input and output are theoretically supported +but does not work uniformly across all operating systems.. <H3> <A name=s1.1> 3.2. Installing Pd in Microsoft Windows </A> </H3> @@ -211,32 +209,17 @@ your situation. (If not, you can read the Pd mailing list archives for recent problems; if you have found a new problem you're welcome to post it to the list.) -<P> If you're running RedHat or Mandrake you might want to use RPM to install -Pd. For other linux distributions, download the "tar.gz" version and compile -Pd. - -<H4> Getting Pd as an RPM </H4> - -<P> Download Pd, perhaps from - <a href="http://www.crca.ucsd.edu/~msp/software.html"> - http://www.crca.ucsd.edu/~msp/software.html</A> , -to a file such as "pd-0.33-0.i386.rpm". -Open a "shell" window, cd to -the directory containing the file, and type the command, -<PRE> - rpm -i pd-0.33-0.i386.rpm -</PRE> - -<P> (substituting the real file name.) Then you should be able to type "pd" -to a shell and watch the Pd main window appear. +<P> Pd is available via the package systems for some linux distributions, +but not always in the most recent version possible. It's relatively easy to +compile your own copy of Pd and that is the approach described here. <H4> Getting Pd as a .tar.gz </H4> <P> Before you start, you might want to check that you have the resources Pd needs. The main things you need are the C compiler, X windows (including -the X development package for Pd to link against) and TK. If you're running -Redhat or Mandrake 7.x or up, I think these are all present by default. -The RedHat X client developer "RPM" package is called XFree86-devel. +the X development package for Pd to link against) and TK. It's almost +always enough to load "tcl-devel" and "tk-devel" packages using yum or +apt-get. <P> Download Pd, perhaps from @@ -254,7 +237,6 @@ to "pd/src" and type <P> <BR> ./configure -<BR> make depend <BR> make </P> @@ -410,15 +392,8 @@ always compile Pd for yourself, whether to make your own improvements, or possibly so that you can get the newest version before it shows up compiled for Mac OS X. -<P> To be able to compile Pd, you must have installed Tcl/Tk -specifically in -/Applications/Wish Shell.app -and /Library/Frameworks/Tk.framework and /Library/Frameworks/Tcl.framework. - -<P> First download and install TK for OSX. I get it from: -<A href=http://tcltkaqua.sourceforge.net/> -http://tcltkaqua.sourceforge.net/. </A> - +<P> To be able to compile Pd, you must have Tcl/Tk installed in the standard +places. I think this is true fro all reasoably recent releases of OSX. <P> Then, just as for linux, just unload pd-whatever.tar.gz into a directory such as ~/pd-0.36-0, cd to pd-0.36-0/src, type "./configure" @@ -446,109 +421,6 @@ as needed. MIDI interface installed. I've seen this done with Midisport devices and I think you just download the OSX driver and follow directions. -<H3> <A name=s1.4> 3.5. Installing Pd in IRIX (SGI machines) </A> </H3> - -<P> (NOTE: as of release 0.35 I haven't had an IRIX machine to compile -Pd on. Soeren Bovbjerg has kindly compiled 0.35 and 0.36 for IRIX; -you can find these at -<A href="http://www.cvmt.dk/~sb/"> http://www.cvmt.dk/~sb/ </A>.) - -<P> Download Pd, which will be a "tar.Z" file. You can unpack this by -typing "zcat [name].tar.Z | tar xf -" to a shell. This creates a directory -named "pd". - -<P> -Starting with release 0.25, Pd should come in "n32" and "o32" versions. -"o32" is the default and will run on IRIX 5.x and up. "n32" runs faster, -but only on 6.x and up. Also, "externs" have to be updated for n32. The -"pd" executable (bin/pd in the distribution) is a symbolic link to either -"pd-o32" or "pd-n32." - -<P> NOTE: "externs" appear to be broken in the N32 version... I'm not sure -how long this has been true. If you want to use external objects, you have -to use the O32 version. - -<P> -If for example you put Pd in ~, the executable program -will be ~/pd/bin/pd. The program looks at its command line to -figure out where it is, so it's best to invoke Pd by its full pathname. -You should always invoke Pd from a Unix shell because many important -messages appear on the standard error. - -<P> -The simplest way to invoke Pd is to -make an alias in your ".cshrc" file (assuming you use the "c" shell) such as: -</P> -<PRE> - - alias pd ~/pd/bin/pd - -</PRE> -<P>(assuming your Pd distribution landed in ~, for example). - -<P> -Pd will open the "default" audio input and output devices, without regard -for whether they are in sync or not. This will be bad if they aren't; use -the "-noadc" or "-nodac" flag to disable either the input or output. Pd is -supposed to handle up to 8 channels of audio in and/or out. (But at least -one user had to recompile Pd on his Onyx to get 8 channels working.) - -<P> -As to MIDI, Pd simply attempts to open all available MIDI devices for input and -output, which is probably very bad on anything more recent than my Indy. If -any MIDI ports fail to open either for input or output, all MIDI is disabled. - -<P> Pd has not been fixed to request real-time priority from Irix; it will -compete with all other processes on your machine for CPU time. - -<H4> Audio and MIDI in IRIX </H4> - -<P> -Pd takes command line arguments to set the number of input and output channels -and the sample rate. These don't affect the SGI's audio settings, which you -have to set separately using the "audio panel." Pd does detect the audio -sample rate if you don't specify one on the command line. - -<P> -On SGI machines, you have to work to get MIDI running. Before you start Pd, verify -that least one MIDI port is configured open. Pd opens the FIRST MIDI port -that's open. You might want to get rid of the "software" MIDI port if you're -running 6.x. On Indys, the usual practice is to open serial port number 2 -because some systems configure port 1 as "console" by default. You can use the -GUI if you want, or else just type -<PRE> - - startmidi -d /dev/ttyd2 - -</PRE> - -<P>to get port 2 speaking MIDI, and - -<PRE> - - stopmidi - -</PRE> - -<P>to stop it. You can test whether MIDI is configured by typing, - -<PRE> - - ps -dafe | grep midi - -</PRE> - -<P>and looking for "startmidi" processes. - -<P> -It's a good idea to connect your serial port to your MIDI interface before -typing the "startmidi" command, not afterward, at least in 5.x. We use the -Opcode Studio 3 interface but in principle any Mac-compatible one should work. - -<P> -The O2 apparently has RS232 ports, not RS422. I think SGI's web site says -something about how to deal with this. - <H3> <A name=s4> 3.6. Preferences and startup options </A> </H3> <P> Pd's behavior may be customized to instruct it where to find files, which @@ -639,13 +511,12 @@ audio configuration flags: -listdev -- list audio and MIDI devices (linux specific audio:) --frags <n> -- specify number of audio fragments (defeats audiobuf) --fragsize <n> -- specify log of fragment size ('blocksize' is better...) -oss -- use ALSA audio drivers -alsa -- use ALSA audio drivers -pa -- use portaudio (experimental version 19) --alsadev <n> ----- obsolete: use -audiodev --32bit ---- (probably obsolete) -- use 32 bit OSS extension +-alsadev <n> -- obsolete: use -audiodev +-32bit -- (probably obsolete) -- use 32 bit OSS extension +-alsaadd <dev> -- add a device to the ALSA device list (Windows specific audio:) -mmio -- use MMIO drivers and API @@ -658,6 +529,7 @@ MIDI configuration flags: -nomidiin -- suppress MIDI input -nomidiout -- suppress MIDI output -nomidi -- suppress MIDI input and output +-alsamidi -- use ALSA midi API general flags: -path <path> -- add to file search path @@ -678,6 +550,7 @@ general flags: -send "msg..." -- send a message at startup (after patches are loaded) -rt or -realtime -- use real-time priority (needs root privilege) -nrt -- don't use real-time priority +-nosleep -- never relinquish CPU (only for multiprocessors!) </PRE> diff --git a/pd/doc/1.manual/x5.htm b/pd/doc/1.manual/x5.htm index ab950b9e..70744f90 100644 --- a/pd/doc/1.manual/x5.htm +++ b/pd/doc/1.manual/x5.htm @@ -20,6 +20,56 @@ <H3> <A name="s2"> 5.1. release notes </A> </H3> +<P> ------------------ 0.41 ---------------------------- + +<P> Pd may be compiled in 64 bit address spaces; this is well tested on +linux and at least seems to work on Microsoft and MacOS. On linux, in fact, +if you compile Pd in a 64-bit version of the OS it's automatically in the +64 bit address space. + +<P> In linux, a "-nosleep" flag causes Pd to poll instead of sleeping as it +waits for dac and adc; this is useful on multiprocessors when you don't mind +having Pd occupy 100% of one processor and want to get latency as low as +possible. (If you don't use this, latency on multiprocessors - Intel Core 2 at +least - is much worse for some reason than it is on uniprocessors.) It's +"experimental" but I use it every day. + +<P> added an experimental callback scheduler. This might reduce latency in +MacOS and/or Microsoft, although I haven't seen that actually happen yet. + +<P> removed limitation on huge messages from text files; this prevented long +"data" arrays from reloading from disk correctly. + +<P> fixed crash bug closing patches with open GOPs. + +<P> changed selection strategy so that, right after duplicating a collection +of objects, clicking tends to select an already-selected object. + +<P> the cursor changes slightly more apprpriately when switching between edit +to run modes. + +<P> got really confused about the proper role of "declare 'path" in abstractions; +for the moment they are ignored. I the future, it may be worthwhile to allow +them but to have them act only locally to the abstraction; but this might mean +a lot more computation overhead when opening files. + +<P> limited window sizes to that of the screen (otherwise, on Mac OS, it's +impossible to resize them.) + +<P> fixed "startup" dialogs to allow unlimited "path" and "lib" entries + +<P> started, but didn't finish, the process of getting Pd to compile with +t_float as 64 bits. This would slow Pd down but improve tabread4~'s accuracy. + +<P> made IEM Guis respect "-font" flag and friends. New startup flags: +"-font-face" (badly named); "-font-size" sysnonym of "-font". (Large patch from +HC). + +<P> String overflow protection here and there. + +<P> migrated to ".net" compiler ("VC 2005", a free download). + + <P> ------------------ 0.40-1 -------------------------- <P> Fixed "declare" which wasn't working properly yet in 0.40-0, and |