playlist~

0 stops soundfile playback. A number greater than zero begins playback of the clip with that index. Indices begin counting at 1.

Add a new soundfile to the list. First (optional) argument specifies the soundfile. Second (optional) argument specifies the slot number for the clip (starting at 1). If no arguments are listed, clicking the append message in a locked patcher will open a dialog box where you can choose a file to append.

Sets a tuning standard based on a frequency for A for pitch correction operations (440 = default, range is 400 - 500). The first argument specifies the clip, and the second argument specifies the frequency.

Remove all clips from the playlist. To remove just one clip, right-click on the file you wish to remove and choose "Remove" from the contextual menu.

Create a new playlist~ object by dragging and dropping an audio file into an unlocked patch. To load additional audio files into a playlist~ object, drag the new file onto the playlist~ UI until a line appears above or below the currently loaded file. To rearrange tracks within playlist~, click and drag the handle (dot on the left side) up or down in a locked patch. To replace a currently loaded file, drag the new file over the old one until the entire track is outlined.

When followgobaltempo is enabled for a clip in playlist~, sfplay~ will calculate the current tempo out of the ratio between originaltempo and global tempo and adapt to global tempo changes. The first argument specifies the clip, and the second argument specifies the off/on state with a zero or one.

The word formant, followed by the clip number and a floating point value, sets the amount of formant scaling for the specified clip when pitchshifting is performed.

The word formantcorrection, followed by the clip number and a zero or one, disables/enables formant correction for the specified clip when pitch correction is performed.

The word getcontent sends the contents and behavior of all clips out the last outlet of playlist~ in dictionary format. Connect the last outlet to a dict.view object to see the contents.

Turn looping on/off for a clip. First argument specifies which clip (starting at 1). Second argument is a 1 (loop) or 0 (don't loop).

Sets the timestretching mode to be used. Each mode is optimized for handling different kinds of audio material. All modes are zero latency. The first argument specifies the clip, and the second argument specifies the mode.

Use your mouse to play and stop the playlist, also use it to select small parts of the sample for playback.

Plays the next clip loaded in playlist~.

The original length of the the audio file in beats. Used by followglobaltempo to calculate the speed in relation to the global transport speed. Setting the originallength will calculate the originaltempo.

The original length of the the audio file in milliseconds.

The original tempo of the the audio file. Used by tempo to calculate the speed in relation to the global transport speed. Setting the originaltempo will calculate the originallength.

Pause playback of the current clip at the current position.

The word pitchcorrection, followed by the clip number and a zero or one, enable/disables the formant-corrected chromatic intonation correction. For more extensive real-time intonation correction, use the retune~ object.

Specify pitchshift as a factor of the original pitch (i.e. 2.0 = doubling of pitch, .5 = halving of the original pitch, etc.). The first argument specifys the clip, and the second argument specifys the pitchshift factor.

Specify pitchshift as positive or negative cent values (i.e. 100 = semitone up, -1200 = octave down). Cents may be specified as ints or floats. The first argument specifys the clip, and the second argument specifys the cents.

Choose the quality for timestretching output.

Remove a clip from the list.

Resume playback from the current position if playback has been paused.

Select playback endpoints for a clip using a normalized range (0.0 is the beginning, 1.0 is the end). First argument specifies which clip (starting at 1). Second argument is the start point for the clip. Third argument is the end point for the clip.

An input signal may be used for the sample-accurate triggering of prestored cues. When a signal value is received in the left inlet, the integer portion of the signal value is monitored. When the integer portion of the input signal changes to a value equal to the index of a prestored cue, that cue is triggered. Negative values are ignored.

Set the time it takes for the correction to reach the full correction amount. Typically, notes are a bit unstable at the beginning, because the attack phase of a sound has a higher amount of noise, and because singers gradually adjust their tuning after the onset of the note. The slur time makes the pitch correction sound natural because it models this effect. Higher values will yield a slower adaptation time and it will take longer for the correction to produce the corrected pitch. However, longer slur times will also preserve vibrato better. The first argument specifies the clip, and the second argument specifys the slur time.

Set playback speed for a clip. First argument specifies which clip (starting at 1). Second argument is the rate (1.0 = original speed, 0.5 = half-speed, etc).

The word timestretch, followed by the clip number and a zero or one, disables/enables timestretching on the specified clip. The message timestretch 2 1 would turn timestretching on for the second clip in playlist~.