Table of Contents Pure Data............................................................................................................................................................1 What is real-time graphical programming?....................................................................................................2 Graphical Programming...........................................................................................................................2 Real Time................................................................................................................................................2 Installing on Mac OS X......................................................................................................................................3 Installing on Microsoft Windows......................................................................................................................6 Installing Pure Data on Ubuntu......................................................................................................................16 Installing libflac7 and libjasper.............................................................................................................16 Installing Pure Data...............................................................................................................................18 Installing Pure Data on Debian.......................................................................................................................21 Configuring Pure Data....................................................................................................................................25 Basic Configuration...............................................................................................................................25 Audio drivers..................................................................................................................................25 MIDI drivers (Linux only).............................................................................................................26 Audio Settings.................................................................................................................................26 Sample rate......................................................................................................................................26 Delay (msec)...................................................................................................................................26 Input Device...................................................................................................................................27 Output Device.................................................................................................................................27 MIDI Settings.................................................................................................................................27 Test Audio and MIDI.....................................................................................................................28 Advanced Configuration........................................................................................................................28 Startup Flags...................................................................................................................................30 Path..................................................................................................................................................31 Platform-Specific Configuration Tools...........................................................................................32 Starting Pure Data...........................................................................................................................................35 Starting PD with the Clickable Icon.....................................................................................................35 Starting Pd via Command Line.............................................................................................................35 Linux (from xterm).........................................................................................................................35 Mac OSX (from Terminal.app)......................................................................................................35 Windows (from the DOS shell or Command Prompt)..................................................................35 Starting Pd from a Script.......................................................................................................................36 Windows..........................................................................................................................................37 Linux and OS X...............................................................................................................................37 Advanced Scripting for Starting Pd.......................................................................................................37 The Interface....................................................................................................................................................39 The main PD window............................................................................................................................39 Starting a New Patch..............................................................................................................................40 Interface Differences in Pure Data.........................................................................................................41 Linux...............................................................................................................................................41 Mac OS X........................................................................................................................................41 Placing, Connecting and Moving Objects in the Patch..........................................................................42 Edit Mode and Play Mode.....................................................................................................................45 Messages, Symbols and Comments.......................................................................................................47 GUI Objects...........................................................................................................................................48 GUI Object Properties.....................................................................................................................49 i Table of Contents The Interface Arrays and graphs..................................................................................................................................50 Graph...............................................................................................................................................51 A Note on using GUI Objects................................................................................................................51 Troubleshooting...............................................................................................................................................52 I don't hear any sound!..........................................................................................................................52 There are clicks, glitches or crackles in the test tone!..........................................................................52 The test tone sounds distorted!.............................................................................................................52 I'm not seeing any audio input!.............................................................................................................52 I don't see any MIDI input!...................................................................................................................52 I get the message "... couldn't create" when I type an object's name and there's a dashed line around my object!.................................................................................................................................52 I get the message "... couldn't create" when I open a patch and there's a dashed line around my object! ..................................................................................................................................................53 I get the message "error: signal outlet connect to nonsignal inlet (ignored)" when I open a patch. .....53 I get the message "error: can't connect signal outlet to control inlet" and I cannot connect two objects together!....................................................................................................................................53 I get the message"error: DSP loop detected (some tilde objects not scheduled)" when I click "Audio ON", and the sound is not working!.........................................................................................53 I get the message "error: stack overflow" when I connect two Dataflow Objects together!.................54 I get the error message "connecting stream socket: Network is unreachable" when I start Pd!............54 What is digital audio? ......................................................................................................................................56 Frequency and Gain...............................................................................................................................56