A newer version of Max is available. Click here to access the latest version of the documentation

pitchshift~ Reference

Ztx-based real-time pitchshifting

pitchshift~

Description

Use the pitchshift~ object to load a perform pitch-shifting on an input signal.

Arguments

channels [int]

Optional

An optional argument can be used to specify the number of channels of the signal to be processed (default = 1).

Attributes

enabled [int]

Enable or disable pitchshifting.

pitchshift [float] (default: 1.)

Set the pitchshifting as a factor of the original pitch (i.e. 2.0 = doubling of pitch, .5 = halving of the original pitch, etc.).

pitchshiftcent [int] (default: 0)

Set the amount of pitchshift as positive or negative cent values (i.e. 100 = semitone up, -1200 = octave down). Cents may be specified as ints or floats.

quality [int]

Pitch shifting output quality.


Possible values:

'basic' ( Basic quality (the default) )
'good' ( Good quality )
'better' ( Better quality )
'best' ( Highest quality )

reportlatency [int]

Enable/disable reporting latency, in samples, introduced by the pitchshift~ object's calculations. Latency is output from the object's right-hand outlet in the form of a message in the form latency [number-of-samples].

usecents [int]

Enable/disable the use of cent values in the second inlet of the pitchshift~ object to specify pitch change.

Common Box Attributes

Messages

getlatency

The word getlatency, followed by a zero or one, toggles reporting the latency, in samples, introduced by the pitchshift~ object's calculations. Latency is output from the object's right-hand outlet in the form of a message in the form latency [number-of-samples].

signal

The pitch of signal(s) in the left input(s) will be shifted. A signal in the rightmost inlet defines the shifting as a factor of the original pitch or in cents (when usecents is enabled).

See Also

Name Description
retune~