Csound tutorials: Difference between revisions

From OLPC
Jump to navigation Jump to search
Line 20: Line 20:


wget http://csounds.com/4csEditor.zip
wget http://csounds.com/4csEditor.zip

=== Unpack Files ===

Downloaded files usually come in one of three archival formats: tar, tar.gz and zip. This section describes how to unpack both types.

==== tar ====

tar xvpf file.tar

==== tar.gz ====

tar xvpfz file.tar.gz

==== zip ====

unzip file.zip


=== Flags ===
=== Flags ===

Revision as of 18:45, 28 March 2008

These Csound tutorials are designed to showcase various aspects of using Csound on an XO computer.

Tutorials and Resources

Exploring Csound from the XO Terminal

Downloading with wget

The terminal utility wget downloads files directly from the internet. The following example downloads 4csEditor.zip, a library of approximately 500 Csound csd files:

 wget http://csounds.com/4csEditor.zip

Unpack Files

Downloaded files usually come in one of three archival formats: tar, tar.gz and zip. This section describes how to unpack both types.

tar

 tar xvpf file.tar

tar.gz

 tar xvpfz file.tar.gz

zip

 unzip file.zip

Flags

Flags change the behavior of Csound, and can be set either in a Csound csd file or by specifying them at the command prompt. The following is a list of the most common used flags in both Csound-based activities and the Terminal activity:

  • --help A complete list of supported command-line flags for Csound.
  • -odac Output audio stream to the Digital-to-analog_converter, sound card
  • -iadc Read audio from the Analog_to_digital_converter, built-in microphone
  • -d Suppress all displays
  • -m0 Set message level to 0
  • -b2048 Set sample frames per software sound I/O buffer to 2048
  • -B4096 Set samples per hardware sound I/O buffer 20 4096
  • -+rtaudio=alsa Set real time audio to the device alsa
  • -+rtmidi=alsa Set real time MIDI to device alsa

The following line shows one possible example of rendering a Csound csd file named foo.csd in real time.:

 csound -odac -d -m0 -b2048 -B4096 -+rtaudio=alsa foo.csd

Users can hardcode flags directly in a Csound csd between the markup tags <CsOptions> and </CsOptions> with a text editor such as vi:

 <CsOptions>
 -odac -d -m0 -b2048 -B4096 -+rtaudio=alsa
 </CsOptions>