Time-scale the output of a phasor~
|multiplier||float||opt||The multiplier value used to scale the output signal.|
||Converted toin any inlet.|
|| In left inlet: Sets the phase value for the rate~ object's signal output.
In right inlet: The signal multiplier value used to scale the phasor~ signal input. Float values less than 1.0 create several ramps per phase cycle. Numbers greater than 1.0 create fewer ramps. This can be useful for synchronizing multiple processes to a single reference phasor~ object, preserving their ratio relationships.
|goto||jump-to-value and time-of-action [list]
||In left inlet: The word rate~ object to jump immediately to the specified value. An optional second argument may be used to specify the time at which to jump to the value (e.g., will output a value of 1.0 at the halfway point of the phasor~ object's input signal ramp)., followed by a float, causes the|
|oneshot||loop-flag (0 or nonzero) [int]
||The message rate~ outputs only one cycle of a ramp. The message will turn "oneshot"-mode off whereby rate~ can cycle through ramps continuously when instructed to do so (i.e. by the message).will turn on "oneshot"-mode whereby|
|reset||In left inlet: The wordwill lock the output to the input on its next reset. It is equivalent to the message .|
|signal||In left inlet: An input signal from a phasor~ object. The rate~ object time scales the input signal from a phasor~ by a multiplier value. The multiplier value can be specified as an argument or received as a float to the rate~ object's right inlet.|
|sync||sync-mode-flag (0 through 2) [list]
|| In left inlet: The word rate~ object. The sync mode determines whether or not the rate~"in" will stay in phase with the input signal, and the method used for synchronization. When the output of the rate~ object is "in phase," the input and output signals align precisely at the least common multiple of their periods (i.e., they pass through zero and begin a new cycle at precisely the same time). If the signals are in phase, and a new multiplier value is received, the rate~ object changes the frequency of its output ramp accordingly. However, the change in multiplier values means that the two signals may be out of phase. The rate~ object handles this situation in one of three different ways, depending on the sync mode:
, followed by a number between 0 and 2 or the words , , or , sets the sync mode of the |
The sync modes are:
: The messages or set the cycle mode of the rate~ object (the default mode). In cycle mode, the rate~ object does not change the phase of its output until the end of the current cycle. When the input ramp reaches its peak and starts over from zero, the rate~ object immediately restarts the output ramp, causing a discontinuity in the output signal, and immediate phase synchronization.
: The messages or set the lock mode of the rate~ object. In sync lock mode, the rate~ object performs synchronization whenever a new multiplier is received. The rate~ object immediately calculates the proper ramp position which corresponds to being "in phase" with the new multiplier value, and jumps to that position.
: The messages or disables the sync mode of the rate~ object. In this mode rate~ never responds to phase differences; when a new multiplier is received, the rate~ object adjusts the speed of its output ramps and they continue without interruption. Since this mode never introduces a discontinuous jump in the ramp signal, it may be useful if phase is unimportant.