Skip to content
footils edited this page Sep 14, 2010 · 2 revisions

Overview

The rj-subdirectory of RjLib includes a big collection of useful Pd object for creating scenes. To get an overview you should open the file rj/OVERVIEW.pd. The abstractions can be freely distributed according to the GPL v3 rsp. the “Standard Improved BSD License” known from Pd itself. Which license applies is indicated by a subpatch in each abstraction. See the file source:trunk/rjlib/rj/LICENSE.txt for the full license texts.

These abstraction are all in a directory called “rj” which can be used as a prefix in order to distinguish between rjlib abstractions and abstractions which are used from the scene directory directly. In order to make things shorter we refer to the abstraction by their name (without the rj prefix) in this document.

All abstraction that will be directly used have a type prefix, where the current types are as follows:

  • s_ synthesizers and instruments
  • m_ mapping objects (translate events into parameters of synths and effects)
  • e_ effects and filters
  • c_ control data generation objects
  • u_ utilities
  • g_ GUI objects

For each section, there is a textfile briefly listing the objects and a short description like this:

s_blsaw – bandlimited sawtooth wave
s_blsquare – bandlimited square wave with PWM

This is used to dynamically generate an object’s listing in rj/OVERVIEW.pd

Communication

The commands that are sent within rjlib are “typed” in a sense that it is differentiated between midi pitches, frequencies, amplitudes, etc.

Suggested standard commands and their arguments are:

  • note 67 100: a MIDI note with velocity ranging fro 0-127
  • pitch 60: pitch value in midi terms ranging from 0-127
  • freq 440: frequency value
  • vel 100: velocity value in midi terms ranging from 0-127
  • amp 0.4: an amplitude value
  • ampdb 99: amplitude value in Pd-dB terms (0=silent, 100=full volume)

Preset system

rjlib uses a preset system based on the sssad.pd abstraction. Generally the rightmost inlet is reserved for messages whose last state can be saved. Some objects like [s_fm4] use the rightmost outlet as a shortcut to report their state. See the help files for [u_dispatch] and [u_loader] for details on the saving system.

Clone this wiki locally