phasor~
Description
Use the phasor~ object to generate sawtooth waves suitable for sample-accurate control and timing tasks. For smoother sounding sawtooth generation, use the bandlimited saw~ object instead. The ramp rate can be set by frequency (Hz), or as an interval using the tempo-relative Max time format syntax.
Examples
Arguments
initial-frequency [list]
Set the initial frequency in Hz, or as an interval using the tempo-relative Max time format syntax.
Attributes
frequency [Time Value]
Ramp rate or interval
jitter [float]
The jitter attributes sets the range of random frequency variation on each phase reset. The frequency deviation above and below will be 1/100th of the value of jitter times the frequency. Example: if the current frequency is 440 and jitter is 1.0, phasor~ will generate random frequencies between 439.56 and 440.44 Hz. jitter only applies when a signal is not connected to the frequency inlet and the lock attribute is disabled.
limit [float]
The limit attribute sets an absolute amount by which the frequency can vary from its set value as a result of a non-zero jitter attribute. If jitter is reduced, the frequency may be changed gradually to bring it closer to the set value.
lock [int]
When lock is set to 1, the phasor~ is synchronized to the Max (or Max for Live) transport. When the transport is off, the phasor~ will output a frequency of zero. For accurate timing, 'Scheduler in Overdrive' and 'in Audio Interrupt' must be enabled. These settings can be changed in 'Options'-> 'Audio Status'. The lock attribute will only accept frequencies specified using notevalues.
phaseoffset [float]
The phaseoffset attribute sets the initial phase when audio is turned on as well as the phase assigned when phasor~ receives the reset message. The phaseoffset is useful when decorrelating multiple instances within an mc.phasor~. If the phaseoffset attribute has never been set or the word phaseoffset is sent with no arguments, the initial phase will nor be changed when audio processing is started. When you set the phase with a float in the right inlet, it is an immediate change but it only happens once. The phaseoffset attribute makes it possible to set up repeatable phase relationships between multiple phasor~ objects or when using mc.phasor~.
syncupdate [int]
When syncupdate is set to 1, the phasor~ frequency is only set at the end of its cycle, when the phase jumps to 0. In this mode, phasor~ will not instantly change its slope when it receives a frequency change, but will instead wait until the phase resets. This can prevent typical pitch glitches when reading from a buffer.
transport [symbol]
This attribute names a time transport. If frequency is specified using a 'relative' unit (for example: ticks, bars.beats.units, or notevalues), then the named transport is used to determine the frequency based on tempo, time-signature, and other related information. The default value is the global 'internal' transport.
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.
jspainterfile [symbol]
JS Painter File
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 [4 floats]
Sets the color for the object's text in RGBA format.
textjustification [int]
Sets the justification for the object's text.
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
bang
int
Arguments
In right inlet: Set the phase of the waveform (from 0 to 1). Signal output continues from this phase.
float
Arguments
In right inlet: Set the phase of the waveform (from 0 to 1). Signal output continues from this phase.
reset
signal
Output
signal
Waveform that increases from 0 to 1 repeatedly at the specified frequency.
See Also
| Name | Description |
|---|---|
| Timing and Sequencing Events | Timing and Sequencing Events |
| 2d.wave~ | Two-dimensional wavetable |
| cycle~ | Sinusoidal oscillator |
| line~ | Linear signal ramp generator |
| saw~ | Antialiased sawtooth oscillator |
| sync~ | Synchronize MSP with an external source |
| techno~ | Signal-driven step sequencer |
| transport | Control a clock |
| trapezoid~ | Trapezoidal wavetable |
| triangle~ | Triangle/ramp wavetable |
| updown~ | Trapezoidal Function Generator With Constant Attack and Release |
| wave~ | Variable size wavetable |
| MSP Basics Tutorial 3: Wavetable Oscillator | MSP Basics Tutorial 3: Wavetable Oscillator |
| MSP Sampling Tutorial 4: Variable-length Wavetable | MSP Sampling Tutorial 4: Variable-length Wavetable |