HelpSource/Tutorials/Mark_Polishook_tutorial/11_Test_functions.schelp

   1 title:: 11_Test_functions
   2 summary:: Mark Polishook tutorial
   3 categories:: Tutorials>Mark_Polishook_tutorial
   4 related:: Tutorials/Mark_Polishook_tutorial/00_Introductory_tutorial
   5
   6 section::Functions and .scope messages
   7
   8 An easy way to audition synthesis processes is to test them within a function. To do this, append a .scope or a .play message to a function. The .scope message, which works only with the internal server, displays a visual representation of a sound wave.
   9
  10 ////////////////////////////////////////////////////////////////////////////////////////////////////
  11
  12 Boot (turn on) the internal server
  13
  14 code::
  15 Server.internal.boot;
  16 ::
  17
  18 Run this example, and look at the scope window.
  19
  20 code::
  21 // test a synthesis process in a function
  22 (
  23         {
  24                 SinOsc.ar([440.067, 441.013], 0, 1)
  25                 *
  26                 SinOsc.ar([111, 109], 0, 0.2)
  27         }.scope;
  28 )
  29 ::
  30
  31 ////////////////////////////////////////////////////////////////////////////////////////////////////
  32
  33 Code can be transfered from a test function into a synthdef. In the following example, the code from the function (above) is the second argument to the Out ugen.
  34
  35 code::
  36 (
  37 SynthDef("ringMod", {
  38         Out.ar(
  39                 0,
  40                 SinOsc.ar([440.067, 441.013], 0, 1)
  41                 *
  42                 SinOsc.ar([111, 109], 0, 0.2)
  43         )
  44 }).add;
  45 )
  46
  47 Synth("ringMod")
  48 ::
  49
  50 section::Multi-channel expansion
  51
  52 Expand a ugen to two channels with an array in any of the argument (control) slots.
  53
  54 code::
  55 { Saw.ar([500, 933], 0.1) }.scope;
  56 ::
  57
  58 Another (longer) way to write the same thing is
  59
  60 code::
  61 { [ Saw.ar(500, 0.1), Saw.ar(933, 0.1)] }.scope;
  62 ::
  63
  64 Expand a ugen to three channels by adding values to the array.
  65
  66 code::
  67 { Saw.ar([500, 933, 2033], 0.1) }.scope;
  68
  69 // 4 channels
  70
  71 { Saw.ar([500, 933, 2033, 895], 0.1) }.scope;
  72 ::
  73
  74 ////////////////////////////////////////////////////////////////////////////////////////////////////
  75
  76 go to link::Tutorials/Mark_Polishook_tutorial/12_UnaryOp_synthesis::