Counter

A counter that increments a value on BPM-dependent trigger.

• ➡️: increment +1 (trigger)

• ➡️: reset (trigger)

• ↩️: current value

KeyInput

Monitor a computer key press either continuously or as one-shot. This unit is useful for updating canvas parameters (Voice, VFX, etc.) in live performance and debugging settings. 

• ↩️: key status (0 or 1).

• 🎚️: submenu panel

  • Key: computer key to monitor; default is 'A'

  • Continuous: whether to treat a key press as held/released (lit) or as a single click (unlit). 

MIDI_CC_R

Receive MIDI CC value at specified channel and CC number. Use this unit to communicate with audio and graphics hardware.

• ↩️: Incoming MIDI CC value.

• 🎚️: submenu panel

  • MIDI channel: default is 1

  • CC Number: default is 60

MIDI_CC_S

Send MIDI CC value at specified channel and CC number. Use this unit to communicate with audio and graphics hardware.

• ➡️: CC value to send

• 🎚️: submenu panel

  • MIDI Channel: default is 1

  • CC Number: default is 60

OSC_R

Receive OSC floating point value at specified port and OSC address. Use this unit to communicate with other audio and graphics software.

• ↩️: OSC value.

• 🎚️: submenu panel

  • port: default is 5001

  • OSC address: default is /raytone/osc-r

OSC_S

Send OSC floating point value at specified IP address, port and OSC address. Use this unit to communicate with other audio and graphics software.

• ➡️: value to send via OSC every frame. 

• 🎚️: submenu panel

  • IP address: default is localhost 127.0.0.1

  • port: default is 5000

  • OSC address: default is /raytone/osc-s

Rand

• ➡️: trigger

• ↩️: random value between 0 and 1 on trigger

Select

A "switch" unit that returns the value at the specified "key" index (starting with 0). This unit is useful for creating scene states, such as which sequencer and texture are actively used. 

• ➡️: 0

• ➡️: 1

• ➡️: 2

• ➡️: 3

• ➡️: 4

• ➡️: 5

• ➡️: 6

• ➡️: 7

• ➡️: key

• ↩️: value at the key index

Tick

• ↩️: trigger every step. This is equivalent to a sequencer with all steps at 1 with clock division=1.

Volume

Set and get current global volume. Use this unit in a project to explicitly set its volume when loaded.

• ➡️: new volume

• ↩️: current volume

You can write your custom voice units using Chuck! Open the RayTone source directory from the settings panel (top right corner) and take a look at the template.ck file in ChucK/User folder to get started. New .ck files in this folder will appear as new voice units after clicking on Rescan button from the settings panel . Additionally, you can create new voice unit categories by adding folders parallel to this User folder. 

Use the following macros to define voice unit sockets:

RAYTONE_DEFINE_INPUTS("signal1", "signal2"); audio-rate input names with double quotation marks separated by commas. 

RAYTONE_DEFINE_INLETS("dry/wet 0-1", "Inlet2Name..."); control-rate inlet names with double quotation marks separated by commas. 

RAYTONE_DEFINE_OUTLET(true); set to true to add a control-rate outlet

RAYTONE_LOADFILE(false); set to true open a file browser to load a .wav file to this script. (For example, Sampler voice unit uses this feature.)

In order to send a signal to DAC and the output socket, you must add the following to your signal chain:

(Your Signal Chain) => RAYTONE_OUTPUT => dac;

Inside the ChucK script, you can read input and inlet values using the following macros:

RAYTONE_INPUT(0) Use an index starting at 0 inside the parentheses to access an input defined by RAYTONE_DEFINE_INPUTS(). 

RAYTONE_INLET(0) Use an index starting at 0 inside the parentheses to access an inlet defined by RAYTONE_DEFINE_INLETS(). 

You can send a float variable to the control-rate outlet using the following macro only if RAYTONE_DEFINE_OUTLET() is set to true:

RAYTONE_OUTLET

If RAYTONE_LOADFILE() is set to true, you can access the file path that is loaded to a voice unit using the following macro:

RAYTONE_FILEPATH 

The tick in RayTone is defined as a ChucK global event:

RAYTONE_TICK

Putting this all together... the following code is an example taken from the Sampler voice unit:

//-----------------------------------------------------------------------------

//Define RayTone inputs & inlets & file requirement

RAYTONE_DEFINE_INPUTS();

RAYTONE_DEFINE_INLETS("trigger", "rate");

RAYTONE_DEFINE_OUTLET(false);

RAYTONE_LOADFILE(true);

//-----------------------------------------------------------------------------

// Create a signal chain using the SndBuf class to play an audio clip

SndBuf buf => RAYTONE_OUTPUT => dac;

// Load a .wav file to SndBuf

RAYTONE_FILEPATH => buf.read;

0 => buf.gain;

// infinite loop

while (true)

{

// Advance time until the global clock

RAYTONE_TICK => now;

// Check if inlet0 received a trigger

If (RAYTONE_TRIG(0) == 1)

{

// Reset SndBuf gain

RAYTONE_LOCAL_GAIN => buf.gain;

// Read playback rate from inlet1.

// If inlet1 is not connected, set playback rate to 1.

if (RAYTONE_INLET_STATUS(1) == 1)

{

RAYTONE_INLET(1) => buf.rate;

}

else

{

1 => buf.rate;

}

// Read playback position in ms from inlet2.

(RAYTONE_INLET(2) / (buf.length() / 1::ms) * buf.samples()) $ int => buf.pos;

}

}

ExportPNG

Export the connected texture as .png in the Exports folder of RayTone source directory, which you can access from the global settings panel.

*Please use this unit with caution as you can accidentally export many high-res .png files if you trigger this unit with the Sequencer or Tick units.

• ➡️: export (trigger)

• ➡️: texture to be exported

Frame

The previous frame of VFX unit as a texture. You can connect this to the Textures unit to allow VFX unit to sample itself to draw graphics on top of its previous frame.

• ➡️: export (trigger)

• ➡️: texture to be exported

Image

Load a .png or .jpg image on canvas. The image can be passed as a texture to the VFX shader when it is connected to an inlet of Textures unit.

• ➡️: width

• ➡️: height

• ➡️: opacity

Text

Double click on the purple circle and use keyboard to edit text. Use this to write comments in your patch...

• ➡️: size

• ➡️: opacity

Textures

Load RayTone Graphics Assets (Image, Video, Webcam units) as textures to the GLSL fragment shader in the VFX unit. Use RAYTONE_TEXTURE(0-7) and RAYTONE_TEXTURE_RESOLUTION(0-7) (where the value in parentheses is the texture index starting at 0) in the fragment shader to read a texture and its resolution from RayTone.

*Only a single Textures Unit is allowed in a RayTone patch.

• ➡️: texture1

• ➡️: texture2

• ➡️: texture3

• ➡️: texture4

• ➡️: texture5

• ➡️: texture6

• ➡️: texture7

• ➡️: texture8

VFX

Load a GLSL fragment shader to display on canvas. Use RAYTONE_INLET(0-7) (where the value in parentheses is the inlet index starting at 0) in the fragment shader to read an inlet value from RayTone.

*Only a single VFX Unit is allowed in a RayTone patch.

• ➡️: inlet1

• ➡️: inlet2

• ➡️: inlet3

• ➡️: inlet4

• ➡️: inlet5

• ➡️: inlet6

• ➡️: inlet7

• ➡️: inlet8

Video

Load an .mp4 video on canvas. The video can be passed as a texture to the VFX shader when it is connected to an inlet of Textures unit.

• ➡️: play trigger

• ➡️: playback rate (default: 1, max: 10)

• ➡️: playhead position in milliseconds (only set on play trigger)

• ➡️: loop ("on" if value is larger than 1)

• ➡️: width

• ➡️: height

• ➡️: opacity

Webcam

Capture the default webcam device on OS as a dynamic image on canvas. The webcam can be passed as a texture to the VFX shader when it is connected to an inlet of Textures unit.

• ➡️: width

• ➡️: height

• ➡️: opacity

Template Shader Code

The following is a template GLSL fragment shader code that you can use with the VFX unit.

#version 410

//-----------------------------------------------------------------------------

//RAYTONE HEADER

uniform vec3 iResolution;

uniform float iTime;

uniform float inlets[8];

uniform sampler2D textures[8];

uniform vec3 textureResolutions[8];

#define RAYTONE_RESOLUTION iResolution

#define RAYTONE_TIME iTime

#define RAYTONE_INLET(i) inlets[i]

#define RAYTONE_TEXTURE(i) textures[i]

#define RAYTONE_TEXTURE_RESOLUTION(i) textureResolutions[i]

//-----------------------------------------------------------------------------

out vec4 fragColor;

void main()

{

// Define UV coordinates based on canvas resolution

vec2 uv = gl_FragCoord.xy / RAYTONE_RESOLUTION.xy;

// Read inlet 0 to create yellow columns

float r = sin(uv.x * RAYTONE_INLET(0) * 100);

float g = sin(uv.x * RAYTONE_INLET(0) * 100);

float b = uv.y * (sin(RAYTONE_TIME) * 0.5 + 0.5);  // flashing blue

// Define texture coordinates based on its resolution

vec2 tex1_uv = gl_FragCoord.xy / RAYTONE_TEXTURE_RESOLUTION(0).xy;

// Sample texture

vec4 tex1 = texture(RAYTONE_TEXTURE(0), tex1_uv);

// Output is RGB + texture

fragColor = vec4(r, g, b, 1.0) + tex1;

}