HelpSource/Tutorials/Getting-Started/03-Start-Your-Engines.schelp

   1 title:: 03. Start Your Engines
   2 summary:: Getting Started With SuperCollider
   3 categories:: Tutorials>Getting-Started
   4 related:: Tutorials/Getting-Started/00-Getting-Started-With-SC
   5
   6 Before we can make any sound, we need to start or 'boot' a server application. The easiest way to do this is to use one of the server windows which is automatically created by the client app. These can be found in the bottom left-hand corner of your screen. Look for the one that says 'localhost server'. It should look like this:
   7
   8 image::Start-Your-Engines00.png::
   9
  10 'localhost' just means on your local computer, as opposed to running on a different computer connected by a network. To start the server click on the 'Boot' button, or click on the window and press the space bar. After a second or two it should look something like this:
  11
  12 image::Start-Your-Engines01.png::
  13
  14 Notice that the white status box has changed from 'inactive' to 'running', and that the 'Boot' button has changed to 'Quit'. This indicates that the server is running. As well the window provides you with some information about CPU usage, and some other things which probably aren't too clear yet. More about them soon.
  15
  16 Also take a look at the post window, where SC has given you some info, and let you know that it booted okay:
  17
  18 code::
  19 booting 57110
  20 <list-of-devices>
  21 SC_AudioDriver: sample rate = 44100.000000, driver's block size = 512\rSuperCollider 3 server ready.\rReceiving notification messages from server localhost
  22 ::
  23
  24 If for some reason it had failed to boot, there would be some information indicating that.
  25
  26 By default you can refer to the localhost server in your code by using the letter code::s::. You can thus send messages to start and stop it like so:
  27
  28 code::
  29 s.quit;
  30 s.boot;
  31 ::
  32
  33 Try this out and then leave the server running. Many examples in the documentation have code::s.boot:: at the beginning, but in general you should make sure the server is running before using any examples that generate audio, or otherwise access the server. In general the examples in this tutorial assume that the server is running.
  34
  35 You can also refer to the localhost server with the text code::Server.local::, for example:
  36
  37 code::
  38 Server.local.boot;
  39 ::
  40
  41 For more information see:
  42
  43 link::Classes/Server::
  44
  45 ____________________
  46
  47 This document is part of the tutorial strong::Getting Started With SuperCollider::.
  48
  49 Click here to go on to the next section: link::Tutorials/Getting-Started/04-Functions-and-Other-Functionality::
  50
  51 Click here to return to the table of Contents: link::Tutorials/Getting-Started/00-Getting-Started-With-SC::