Description
Use the cycle~ object to generate a periodic waveform. The default waveform is one cycle of a cosine wave. You can also use the wave~ object, which offers additional flexibility though slightly less optimization.
Examples
Discussion
The cycle~ object is an interpolating oscillator that reads repeatedly through one cycle of a waveform, using a wavetable. The wavetable can be changed using the 'set' message. This wavetable may be of any size, but historically was limited to 512 samples.
Arguments
frequency [number]
Oscillator frequency (initial) The initial frequency of the oscillator
Attributes
buffer [symbol]
Buffer containing an external waveform. Setting the buffer~ with the attribute is analogous to sending the setall message.
buffer_offset [atom_long]
First sample of a buffer (if an external buffer is providing the waveform)
buffer_sizeinsamps [atom_long]
Override the size of the buffer used for the wavetable. If using the set message the size will be 512, or if using the setall message the size will be the whole buffer~ length. Use this attribute to define a different size (the size should be a power of two). Setting this size to 0 will result in an effective size of 512 and setting it to -1 will result an effective size of the whole buffer~ length.
Possible values:
'-1'
'0'
'16'
'32'
'64'
'128'
'256'
'512'
'1024'
'2048'
'4096'
'8192'
'16384'
'32768'
'65536'
frequency [float]
Oscillator frequency
phase [float]
Phase offset
Common Box Attributes
annotation [symbol]
Sets the text that will be displayed in the Clue window when the user moves the mouse over the object.
background [int] (default: 0)
Adds or removes the object from the patcher's background layer. background 1 adds the object to the background layer, background 0 removes it. Objects in the background layer are shown behind all objects in the default foreground layer.
color [4 floats]
Sets the color for the object box outline.
fontface [int]
Sets the type style used by the object. The options are:
plain
bold
italic
bold italic
Possible values:
0 = 'regular'
1 = 'bold'
2 = 'italic'
3 = 'bold italic'
fontname [symbol]
Sets the object's font.
fontsize [float]
Sets the object's font size (in points).
Possible values:
'8'
'9'
'10'
'11'
'12'
'13'
'14'
'16'
'18'
'20'
'24'
'30'
'36'
'48'
'64'
'72'
hidden [int] (default: 0)
Toggles whether an object is hidden when the patcher is locked.
hint [symbol]
Sets the text that will be displayed in as a pop-up hint when the user moves the mouse over the object in a locked patcher.
ignoreclick [int] (default: 0)
Toggles whether an object ignores mouse clicks in a locked patcher.
patching_rect [4 floats] (default: 0. 0. 100. 0.)
Sets the position and size of the object in the patcher window.
position [2 floats]
Sets the object's x and y position in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its size unchanged.
presentation [int] (default: 0)
Sets whether an object belongs to the patcher's presentation.
presentation_rect [4 floats] (default: 0. 0. 0. 0.)
Sets the x and y position and width and height of the object in the patcher's presentation, leaving its patching position unchanged.
rect [4 floats]
Sets the x and y position and width and height of the object in both patching and presentation modes (if the object belongs to its patcher's presentation).
size [2 floats]
Sets the object's width and height in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its position unchanged.
textcolor [float]
Sets the color for the object's text in RGBA format.
textjustification [int]
Text Justification
Possible values:
0 = 'left'
1 = 'center'
2 = 'right'
varname [symbol]
Sets the patcher's scripting name, which can be used to address the object by name in pattr, scripting messages to thispatcher, and the js object.
Messages
float
Arguments
Right inlet: phase of the oscillator in the range 0.0 to 1.0
(mouse)
set
Arguments
sample-offset [int]
setall
Arguments
signal
Right inlet: phase of the oscillator in the range 0.0 to 1.0
Output
signal
A waveform (cosine by default) repeating at the specified frequency, with the specified phase.
See Also
| Name | Description |
|---|---|
| buffer~ | Store audio samples |
| buffir~ | buffer-based FIR filter |
| cos~ | Signal cosine function (0-1 range) |
| line~ | Linear ramp generator |
| phasor~ | Generate sawtooth signals |
| rect~ | Antialiased rectangular (pulse) oscillator |
| saw~ | Antialiased sawtooth oscillator |
| techno~ | Signal-driven step sequencer |
| trapezoid~ | Trapezoidal wavetable |
| tri~ | Antialiased triangular oscillator |
| triangle~ | Triangle/ramp wavetable |
| wave~ | Variable size wavetable |
| 2d.wave~ | Two-dimensional wavetable |
| MSP Basics Tutorial 2: Adjustable Oscillator | MSP Basics Tutorial 2: Adjustable Oscillator |
| MSP Basics Tutorial 3: Wavetable Oscillator | MSP Basics Tutorial 3: Wavetable Oscillator |
| Sampling Tutorial 5: Waveshaping | Sampling Tutorial 5: Waveshaping |
| MSP Sampling Tutorial 1: Recording and Playback | MSP Sampling Tutorial 1: Recording and Playback |