RNBO Objects & Operators rnbo~
Open Help

rnbo~

The rnbo~ object is a Max wrapper for RNBO technology

Description

The rnbo~ object creates a special patcher that allows you to program in the rnbo patching environment, then export your code to a variety of targets.

Arguments

None.

Attributes

active [int] (default: 1)

Enable/disable event and signal processing within the rnbo~ object.

annotation_name [symbol] (default: )

The string that is prepended to annotations. This shows up in the Info pane in Live, and the clue window in Max.

autobuild [int] (default: 1)

When Automatic Rebuild is enabled, changes to the rnbo~ patcher will cause the rnbo~ patcher to recompile. Disabling this will disable the auto-compilation feature of the rnbo~ patcher.

autosave [int] (default: 1)

Allows for snapshots of the rnbo~ object to be saved as presets.

exposevoiceparams [int] (default: 0)

Expose parameters for each polyphonic voice. The number of voices will be determined by the polyphony attribute

optimization [symbol]

Set the Optimization of compilation speed. Possible values:

'O0' ( No Optimization )
'O1' ( Normal Optimization (default) )
'O2' ( Fast Optimization )
'O3' ( Fastest Optimization )

parameter_enable [int]

Parameter Mode Enable

parameter_mappable [int] (default: 1)

Visible to Mapping

polyphony [int] (default: 0)

Set the number of polyphonic voices for each parameter when exposevoiceparams is set to 1 .

tabswitchesaudio [int] (default: 0)

When enabled, tabswitchaudio enables audio output from the currently open tab, and simultaneously disables audio output from closed tabs.

title [symbol]

The title sets the name of the rnbo~ object. This name appears as the patcher windows name and the default name for presets.

transport [symbol]

The name of the host platforms transport object to synchronize to. These objects will be metros and phasors in the rnbo~ patcher that are locked to the transport with the lock attribute set to 1 .

Common Box Attributes

Snapshot Attributes

Parameter Attributes

Messages

bang

Send a bang from rnbo~'s default inlet. This will be received within the rnbo~ patchers' rnbo_in objects.

int

Arguments

value [int]
Set integer values in RNBO through rnbo~'s default inlet. This will be received within the rnbo~ patchers rnbo_in objects.

float

Arguments

value [float]
Set float value in RNBO through rnbo~'s default inlet. This will be received within the rnbo~ patchers rnbo_in objects.

list

Arguments

value [list]
Set lists in RNBO through rnbo's default inlet. This will be received within the rnbo~ patchers rnbo_in objects.

(mouse)

Double-click to open the RNBO Patcher

message

Send a message to set the value for parameters and rnbo_inport objects in rnbo~. rnbo_inport 's' value can be set using the following format : inport-tag {value}
Set rnbo_param and rnbo_param~ s' value by using the following format : param-name {value}

midievent

Send Midi formatted messages to RNBO via the rnbo~ objects MIDI inlet.

midiin

Send Midi messages to RNBO via the rnbo~ objects MIDI inlet.

open

Open the rnbo~ patcher. If the rnbo~ patcher is already open, the rnbo~ window will appear in front of all windows.

reset

Reset parameters to their initial value. The initial value of parameters is set with the value attribute of rnbo_param and rnbo_param~ objects in the rnbo~ patcher.

reset_param

Arguments

symbol [list]
Reset a specific rnbo_param or rnbo_param~ object's value attribute to its initial value.

setnormalized

Arguments

name [symbol]
value [float]
Set the normalized value of a rnbo_param or rnbo_param~ object. The normalized value (0.0 - 1.0) will be scales to rnbo_param or rnbo_param~ s' minimum and maximum attributes.

wclose

Close the rnbo~ patcher window.

Snapshot Messages

Inlets

Default Inlet

The leftmost inlet(s) of the rnbo~ object accept event and signal messages.

Midi Inlet

The MIDI inlet will appear if the rnbo~ subpatcher includes a MIDI input object, like rnbo_midiin, rnbo_notein, rnbo_ctlin, rnbo_bendin, or rnbo_sysexin. This inlet accepts MIDI streams, so it's common to connect it to a "midiformat" object in Max.

Outlets

MIDI Outlet

If the rnbo~ subpatcher contains a MIDI output object (e.g. rnbo_midiout, rnbo_noteout, rnbo_ctlout, rnbo_bendout, rnbo_sysexout), then the rnbo~ parent object will have a MIDI outlet as its rightmost outlet. This outlet will output a MIDI stream, so it's common to connect it to a "midiparse" object in Max.

Message Outlets

Message outlets output event data from the rnbo~ object. The message outlets appear to the right of the Port outlets with the creation of rnbo_out objects in the rnbo~ patcher.

Port Outlet

Output data from rnbo_outport objects. The rightmost outlet will appear whenever a rnbo_outport is added to the rnbo~ patcher.

Signal Outlets

Signal outlets output signal from the rnbo~ object. The signal outlets appear to the right of the Port outlets with the creation of rnbo_out~ objects in the rnbo~ patcher.

See Also

Name Description
rnbo.remote Communicate with a remote rnbo device