Now we have to set up each of the modules so that we have some sound to play around with:

• Input module:
  • Click the Open button and select a sound file to play. For this tutorial we recommend that you find a sound file with relative static content, e.g. a loop with one or more organ chords.
  • Turn on audio using the Audio On/Off button on top of the input module.
  • Hit the Play button, so that the sound file start playing.
  • Bring up the master gain of the input module.
• Tremolo module
  • Unmute the module by clicking the mute button.
  • Bring up the level using the gain (green) dial in the top of the module..
  • Make sure that the output from the module is 100% wet using the mix (blue) dial at the top of the module.
• Output module
  • Finally bring up the master gain of the output module so that you have sound coming out.

Receiving OSC messages from the module

You will notice that whenever you change a parameter in the tremolo module, this gets reported out the left outlet of the module and shows up in the message box. In the screen shot above you can see that the audio gain level has been set to 100.

The messages sent out from the module are all OSC messages, containing the OSC address and the value of the parameter. Here are some examples of output from the tremolo module:

/audio/gain 100.
/audio/mix 100.
/audio/mute 0
/lfo/frequency 5.
/lfo/depth 50.

One of the benefits of OSC is that the messages above are easy to read and we quickly get an idea of what parameter each of them are referring to.

Passing OSC messages to the module

We can pass messages to the module the same way. Let us try adjusting the LFO frequency and depth by sending messages to the module, by doing a few additions to the patch:

Now you are able to control the LFO frequency and depth not only in the GUI of the module, but also by passing OSC messages to the module.

Ramping to new values

Passing OSC messages this way cause the module to update to the new parameter value instantly. In real use we often want changes to happen more gradually. For instance we might want the LFO depth to change gradually from 0 % to 100 % over 5 seconds. This is something that Jamoma excels at.

Let’s make two more message boxes and connect to the leftmost inlet of the tremolo module. The content of the two message boxes will be /lfo/depth 0 ramp 5000 and /lfo/depth 100 ramp 5000 respectively:

Now try clicking first one and then the other message box. You will see that the LFO depth gradually moves to 0 % and 100 % respectively over 5 seconds (5000 ms), starting of from the value it had just before the ramp was triggered. The syntax to achieve this is really simple: Just add ramp and the amount of time you want the ramp to last for, expressed in milliseconds, to the end of the OSC message.

If you try starting one ramp before the other one is done, the new ramp takes precedence, starting from whatever value the parameter had just before.

If you change the parameter while the ramp is still running, either by interacting with the GUI of the module, or by sending a new OSC message to the module, you will see that this brings the previous ramp to a hault.

You can also try adding more message boxes to the patch, so that you can interact with several parameters simultaneously. You will find that the module is able to cope with several parameters ramping at the same time, each of which can be started independently and run for different amounts of time.

In this example, the ramp is linear. In a later tutorial we will look further into ramping in Jamoma, and see how we can use different ramping curves and more.

Summary

• The leftmost inlet and outlet of modules is reserved for OSC communication to and from the module.
• Parameters can be updated by sending OSC messages to the module.
• Parameters can also be changed gradually by applying a ramp.

comments powered by Disqus