Description
Use playlist~ to organize sets of soundfiles and play them back. Each sound is given a visual representation in a clip where a selection from the entire sound file may be choosen. Clips may be dragged within a playlist~ to re-order them, or they maybe dragged to other playlist~ objects by using the handle (dot) on the left side of the clip.
Arguments
None.
Attributes
accentcolor [4 floats]
Controls Off Color
allowreorder [int] (default: 2)
Allow the re-ordering of clips in the playlist~ by dragging the handle (dot on the left side) for a clip above or below other clips.
Possible values:
0 = 'Off'
1 = 'On'
2 = 'Automatic'
bgcolor [4 floats]
Background Color
channelcount [int] (default: 2)
Number of audio channels to playback. Changing this attribute will clear the playlist~ content.
clipheight [float] (default: 30.)
Height alloted for each clip to be displayed. This value may be altered when dragging new clips into the playlist~ according to the @expansion attribute.
color [4 floats]
Waveform/Controls Color
elementcolor [4 floats]
Clip Divider Color
expansion [symbol] (default: squeeze)
Style of accomodation for adding clips to a playlist~ with no empty space available.
Possible values:
'squeeze'
(
Maintain the size of the box and reduce the height of all clips to make room.
)
'static'
(
Maintain both the size of the box and the height of all clips. A scroll bar will need to be used to access clips out of view.
)
loopreport [int] (default: 0)
Loop Report
selectioncolor [4 floats]
Selection Color
showname [int] (default: 1)
Show File Name
style [symbol]
Sets the style to be applied to the object. Styles can be set using the Format palette.
textcolor [4 floats]
Text Color
waveformdisplay [int] (default: 1)
Display style for sound file waveforms that represent each clip.
Possible values:
0 = 'Bi-Polar'
1 = 'Rectified'
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.
adds the object to the background layer, 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
int
Arguments
append
Arguments
clip-number [int]
clear
basictuning
Arguments
(drag)
getcontent
followglobaltempo
Arguments
formant
Arguments
formantcorrection
Arguments
loop
Arguments
loop [int]
next
mode
Arguments
pause
originallength
Arguments
pitchcorrection
Arguments
pitchshift
Arguments
pitchshiftcent
Arguments
play
Arguments
originallengthms
Arguments
originaltempo
Arguments
selection
Arguments
start [float]
end [float]
signal
refresh
remove
Arguments
resume
quality
Arguments
slurtime
Arguments
speed
Arguments
speed [float]
timestretch
Arguments
Output
list
The 'mouse' message is sent together with normalized mouse coordinates and the mouse button state.
Output
dictionary
The rightmost outlet sends a dictionary summary of the playlist~ content in response to the 'getcontent' message.
list
2nd from right outlet sends messages of the form 'start N clipname' or 'done N clipname' where N is the index and 'clipname' is the name of the clip.
signal
There is one signal outlet for each of the playlist~ object's output channels.
These are followed by a signal indicating the position of the playback head. The integer part of the number is the index of the clip that is playing. The fractional part of the number is the instantaneous position within that clip.
See Also
Name | Description |
---|---|
jit.playlist | Play video files |
sfplay~ | Play audio file from disk |
waveform~ | buffer~ viewer and editor |