Skip to content

Commit

Permalink
added README in application folder
Browse files Browse the repository at this point in the history
  • Loading branch information
Nick Collins committed Oct 30, 2007
1 parent ac5414b commit 09af832
Showing 1 changed file with 43 additions and 0 deletions.
43 changes: 43 additions & 0 deletions build/README
@@ -0,0 +1,43 @@
Welcome to SuperCollider 3!

SuperCollider is an environment and programming language for real time audio synthesis and algorithmic composition. It provides an interpreted object-oriented language which functions as a network client to a state of the art, realtime sound synthesis server.

SuperCollider was written by James McCartney (audiosynth.com) over a period of many years. It is now an open source GPL'd project maintained and developed by James and various others. It is used by musicians, scientists, and artists working with sound.

http://supercollider.sourceforge.net/



This README is a first help for anyone new to SuperCollider. There are many good resources available for learning SuperCollider, with up to date links from the site listed above, including links to forums and mailing lists. Within the SuperCollider application directory you will find a Help directory containing HTML files which you can browse in a web browser or within SuperCollider itself.

The exact details of using the SuperCollider environment will depend on your platform. Some immediate comments:

1) SuperCollider is really two applications: a sound synthesiser (the Server), and a programming language (the Lang) with its own developer environment. You can use both of these or one or the other. When using SC (SuperCollider) from within the developer environment SC Lang, the SC Server is used automatically for sound synthesis as long as it's turned on! This is accomplished by pressing the 'Boot' button on a Server graphic or running the code s.boot. Further details are in the help tutorials; but we're just warning you now in case you're impatient and can't understand why you're not immediately getting sounds.

2) The Main Help page in SuperCollider (Help/Help.html) gives some immediate key commands and should be enough to help you start navigating the help system. Please also check the different menu options available with the application on your system.

Platform specific comments:

[OS X] If using a MacIntel machine, you will need to set up an Aggregate Device (under Audio/MIDI Setup) to combine audio in and audio out. In order to run this with SuperCollider, and supposing your Aggregate Device is called 'Agg' execute these two lines of SuperCollider code to prepare then boot a server:

s.options.device = 'Agg'
s.boot;

To execute a line in OS X, put the cursor on a line and press the Enter key; this is distinct from the Return key!

And be careful you're not using TextEdit or a web browser instead of the SuperCollider Lang when you execute code; SC shares the text editor interface with TextEdit.


[Windows] The windows version of SuperCollider is called PsyCollider. Key commands differ from the Mac, but almost all code should work the same. The SwingOSC Java based GUI library is used here, however, for GUIs. You must use JMouseX/JMouseY in particular; PsyCollider does not support MouseX/MouseY UGens.


[Linux] Most people use SuperCollider from emacs; there are some alternative editors available. For GUI building, the SwingOSC Java framework is a standard option.




We hope you enjoy SuperCollider; please get involved in the active community!



SuperCollider 3.1 was released on October 31, 2007

0 comments on commit 09af832

Please sign in to comment.