Update of /cvsroot/pure-data/pd/doc/1.manual In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv15408/pd/doc/1.manual

Modified Files: x1.htm x3.htm x5.htm Log Message: release 0.41-0

Index: x1.htm =================================================================== RCS file: /cvsroot/pure-data/pd/doc/1.manual/x1.htm,v retrieving revision 1.4 retrieving revision 1.5 diff -C2 -d -r1.4 -r1.5 *** x1.htm 11 Nov 2004 04:58:13 -0000 1.4 --- x1.htm 24 Jan 2008 00:39:50 -0000 1.5 *************** *** 103,121 **** 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%22%3E PDP ! <A> 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/> 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>.

--- 103,119 ---- is Framestein, by Juha Vehvilainen. This runs on Windows only: <A href="http://framestein.org"> http://framestein.org </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 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.

! <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/%22%3E http://puredata.info/</A>.

*************** *** 126,137 **** <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> --- 124,129 ---- *************** *** 143,147 **** <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: <A HREF="http://www.crca.ucsd.edu/~msp/techniques.htm" <I> Theory and Techniques of Electronic Music </I> <br> --- 135,139 ---- <a href="http://suita.chopin.edu.pl/~czaja/miXed/externs/cyclone.html"> Cyclone - Krzysztof Czaja's Max compatibility library</a><br> ! On-line book: <A HREF="http://www.crca.ucsd.edu/~msp/techniques.htm" <I> Theory and Techniques of Electronic Music </I> <br>

Index: x3.htm =================================================================== RCS file: /cvsroot/pure-data/pd/doc/1.manual/x3.htm,v retrieving revision 1.6 retrieving revision 1.7 diff -C2 -d -r1.6 -r1.7 *** x3.htm 18 May 2005 04:28:31 -0000 1.6 --- x3.htm 24 Jan 2008 00:39:50 -0000 1.7 *************** *** 18,27 **** </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> Installation instructions are platform-specfic; the following four --- 18,26 ---- </P>

! <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 *************** *** 146,152 **** 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. !

<H3> <A name=s1.1> 3.2. Installing Pd in Microsoft Windows </A> </H3> --- 145,150 ---- you want.

! <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> *************** *** 212,233 **** 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.

<H4> Getting Pd as a .tar.gz </H4> --- 210,216 ---- to the list.)

! <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> *************** *** 235,241 **** <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.

<P> --- 218,224 ---- <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. It's almost ! always enough to load "tcl-devel" and "tk-devel" packages using yum or ! apt-get.

<P> *************** *** 255,259 **** <P> <BR> ./configure - <BR> make depend <BR> make </P> --- 238,241 ---- *************** *** 411,423 **** 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> Then, just as for linux, just unload pd-whatever.tar.gz into a directory --- 393,398 ---- Mac OS X.

! <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 *************** *** 447,553 **** 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>

--- 422,425 ---- *************** *** 640,650 ****

(linux specific audio:) - -frags &lt;n&gt; -- specify number of audio fragments (defeats audiobuf) - -fragsize &lt;n&gt; -- 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 &lt;n&gt; ----- obsolete: use -audiodev ! -32bit ---- (probably obsolete) -- use 32 bit OSS extension

(Windows specific audio:) --- 512,521 ----

(linux specific audio:) -oss -- use ALSA audio drivers -alsa -- use ALSA audio drivers -pa -- use portaudio (experimental version 19) ! -alsadev &lt;n&gt; -- obsolete: use -audiodev ! -32bit -- (probably obsolete) -- use 32 bit OSS extension ! -alsaadd &lt;dev&gt; -- add a device to the ALSA device list

(Windows specific audio:) *************** *** 659,662 **** --- 530,534 ---- -nomidiout -- suppress MIDI output -nomidi -- suppress MIDI input and output + -alsamidi -- use ALSA midi API

general flags: *************** *** 679,682 **** --- 551,555 ---- -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>

Index: x5.htm =================================================================== RCS file: /cvsroot/pure-data/pd/doc/1.manual/x5.htm,v retrieving revision 1.9 retrieving revision 1.10 diff -C2 -d -r1.9 -r1.10 *** x5.htm 9 Oct 2006 04:36:12 -0000 1.9 --- x5.htm 24 Jan 2008 00:39:50 -0000 1.10 *************** *** 21,24 **** --- 21,74 ---- <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 --------------------------