sflist~
Description
sflist~ stores a list of preloaded cues for sound files that can be accessed by multiple sfplay~ objects. Each sflist~ object has a unique name that sfplay~ objects use to refer to its cues. Defining a cue is the same for sflist~ as for sfplay~. You can preload cues for sflist~ without the audio being on.
Examples

Store a global list of cues that can be used by one or more sfplay~ objects
Arguments
object-name [symbol]
Names the sflist~. sfplay~ objects use this name to refer to cues stored inside the object.
buffer-size [int]
Optional
Sets the buffer size used to preload audio files. The default and minimum is 16384. Preloaded buffers are 4 times the buffer size per channel of the audio file.
Attributes
Common Box Attributes
Messages
clear
Arguments
cue-numbers
[list]
The word sflist~ object's cue list.
no arguments clears all defined cues. After a message is received, only the number will play anything (assuming there's an open file). The word followed by one or more cue numbers removes them from the cuedump
The word sflist~ to send out the outlet a listing containing all of its cues.
will cause embed
Arguments
saving-preference-flag
[int]
The message sflist~ to save all of its defined cues and the name of the current open file when the patcher file is saved. The message keeps sflist~ from saving this information when the patcher is saved. By default, the current file name and the cue information is not saved in sflist~ when the patcher is saved. If an sflist~ object is saved with stored cues, they will all be preloaded when the patcher containing the object is loaded.
, followed by any non-zero integer, causes fclose
Arguments
filename
[symbol]
The word
, followed by the name of an open file, closes the file and removes all cues associated with it. The word by itself closes the current file. open
Arguments
filename
[symbol]
The word
, followed by the name of an AIFF, WAV, or NeXT/Sun audio file, opens the file if it is located in Max's search path. Without a filename, brings up a standard open file dialog allowing you to choose a file. When a file is opened, its beginning is read into memory, and until another file is opened, playing from the beginning the file is defined as cue . Subsequent cues can be defined referring to this file using the message without a filename argument. When the message is received, the previous current file, if any, remains open and can be referred to by name when defining a cue with the message. If any cues were defined that used the previous current file, they are still valid even if the file is no longer current. preload
Arguments
cue-number
[int]
filename [symbol]
start-time [int]
end-time [int]
directional-flag [int]
playback-speed [float]
filename [symbol]
start-time [int]
end-time [int]
directional-flag [int]
playback-speed [float]
Defines a cue, an integer greater than or equal to 2, to refer to a specific region of a file. When that cue number is subsequently received by an sfplay~ object that is set to use cues from the sflist~ object, the specified region of the file is played by sfplay~. Cue number 1 is always the beginning of the current file - the file last opened with the message - and cannot be modified with the message.
There are a number of forms for the message. The word is followed by an obligatory cue number between 2 and 32767. If the cue number is followed by a filename - a file that is currently open or one that is in Max's search path - that cue number will henceforth play the specified file. Note that a file need not have been explicitly opened with the message in order to be used in a cue. If no filename is specified, the currently open file is used.
After the optional filename, an optional start time in milliseconds can be specified. If no start time is specified, the beginning of the file is used as the cue start point. After the start time, an end time in milliseconds can be specified. If no end time is specified, or the end time is , the cue will play to the end of the file. If the end time is less than the start time, the cue is defined but will not play. Eventually it may be possible to define cues that play in reverse.
After the start and/or end time arguments, a optional directional buffer flag is used to enable reverse playback of stored cues. Setting this flag to 1 enables reverse cue playback. The default setting is (bidirectional buffering off).
A final optional argument is used to set the playback speed. A float value sets the playback speed for an sfplay~ object relative to the object's global playback speed -- set by the message. The default value is .
Each cue that is defined requires approximately 40K of memory per sfplay~ channel at the default buffer size (40320), with bidirectional buffering turned off. With bidirectional buffering turned on, the amount of memory per cue is doubled.
There are a number of forms for the message. The word is followed by an obligatory cue number between 2 and 32767. If the cue number is followed by a filename - a file that is currently open or one that is in Max's search path - that cue number will henceforth play the specified file. Note that a file need not have been explicitly opened with the message in order to be used in a cue. If no filename is specified, the currently open file is used.
After the optional filename, an optional start time in milliseconds can be specified. If no start time is specified, the beginning of the file is used as the cue start point. After the start time, an end time in milliseconds can be specified. If no end time is specified, or the end time is , the cue will play to the end of the file. If the end time is less than the start time, the cue is defined but will not play. Eventually it may be possible to define cues that play in reverse.
After the start and/or end time arguments, a optional directional buffer flag is used to enable reverse playback of stored cues. Setting this flag to 1 enables reverse cue playback. The default setting is (bidirectional buffering off).
A final optional argument is used to set the playback speed. A float value sets the playback speed for an sfplay~ object relative to the object's global playback speed -- set by the message. The default value is .
Each cue that is defined requires approximately 40K of memory per sfplay~ channel at the default buffer size (40320), with bidirectional buffering turned off. With bidirectional buffering turned on, the amount of memory per cue is doubled.
Prints a list of all the currently defined cues.
Output
Cues
Cues are stored within the object for reference by other soundfile objects. A listing of internally stored cues is sent out its outlet with the
message.See Also
Name | Description |
---|---|
buffer~ | |
groove~ | |
play~ | |
sfinfo~ | |
sfplay~ | |
sfrecord~ | |
MSP Sampling Tutorial 6: Record and Play Audio Files | MSP Sampling Tutorial 6: Record and Play Audio Files |