Play sound files with multichannel output Use mc.playlist~ to organize sound files and play them back using multichannel outputs. Each file's waveform is shown in a clip where you can select a portion of the file for playback. Drag clips within an mc.playlist~ to re-order them, or drag clips to other mc.playlist~ objects by using the dotted handle on the clip's left edge. Cycling '74 MC Audio Soundfiles Messages TEXT_HERE Output mc.playlist~ produces a multichannel signal containing the number of channels specified by the channelcount attribute. Sync Output The second outlet provides a single-channel sync signal. The integer part of the signal value is the index of the clip that is playing. The fractional part is the instantaneous position within that clip. Playback Notifications The third outlet sends the message start followed by a clip index and name when a clip starts playing and done followed by a clip index and name when a clip stops playing. Current content mc.playlist~ outputs a dictionary describing its current contents out the right outlet in response to a getcontent message. Start/stop playing a soundfile 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 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. Remove all sound files Remove all clips from the playlist. To remove just one clip, right-click on the file you wish to remove in a locked patcher and choose "Remove" from the contextual menu. Drag and drop audio files Create a new mc.playlist~ object by dragging and dropping a multichannel audio file into an unlocked patch. To load additional audio files into an mc.playlist~ object, drag the new file onto the mc.playlist~ UI until a line appears above or below the currently loaded file. To rearrange tracks within mc.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 highlighted. Get the content and behavior of all clips The word getcontent sends the contents and behavior of all clips out the last outlet of mc.playlist~ in dictionary format. Connect the last outlet to a dict.view object to see the contents. Please note that for the "absolutepath" entry, the full file path for each clip will only be displayed if the file is not in Max's search path. If the file is in Max's search path, only the file name will be displayed. Press play/loop and make selections Use your mouse to play and stop the playlist, also use it to select small parts of the sample for playback. Play the next clip Plays the next clip loaded in mc.playlist~. Pause playback Pause playback of the current clip at the current position. Remove a clip The word remove, followed by a clip number starting at 1, removes that clip from the list. Resume playback Resume playback from the current position if playback has been paused. This message has no effect when using signal-driven playback. Select playback endpoints for a clip Select playback endpoints for a clip using a normalized range (0.0 is the beginning, 1.0 is the end). The first argument specifies which clip (starting at 1). The second argument is the start point for the clip, and the third argument is the end point. If only two arguments are given, they serve as the start and end points for all clips in mc.playlist~. If only one argument is given, it serves as the clip number and clears any selection from that clip. Select playback endpoints for a clip in milliseconds Select playback endpoints for a clip in milliseconds. The first argument specifies which clip (starting at 1). The second argument is the start point for the clip, and the third argument is the end point. If only two arguments are given, they serve as the start and end points for all clips in mc.playlist~. If only one argument is given, it serves as the end point for all clips in mc.playlist~. Set an attribute state for a specific clip sfplay~ attributes are available in mc.playlist~. To control a specific clip, use the "setclip" message followed by the clip number, attribute name, and value. The message "setclip 2 loop 1" will turn looping on for clip 2. Trigger a stored cue with sample accuracy 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. Indexes start at 1. A signal value of 0 stops audio. Negative values are ignored. Controls Off Color Set the color of the loop icon when turned off. Allow the re-ordering of clips Allow the re-ordering of clips in mc.playlist~ by dragging the handle (dot on the left side) of a clip above or below other clips. TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE Basic tuning (from A) Set a tuning standard based on a frequency for A for pitch correction operations (440 = default, range is 400 - 500). Both timestretch and pitchcorrection need to be enabled to adjust the basic tuning. Background Color Set the background color of mc.playlist~. Number of audio channels Number of audio channels to playback. Changing this attribute will clear the mc.playlist~ content. Height alloted for each clip to be displayed Height alloted for each clip to be displayed. This value may be altered when dragging new clips into the mc.playlist~ according to the expansion attribute. Waveform/Controls Color Set the color for the waveform and controls. Clip Divider Color Set the clip divider color. Style of accomodation for adding clips Style of accomodation for adding clips to an mc.playlist~ with no empty space available. Maintain the size of the box and reduce the height of all clips to make room. TEXT_HERE 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. TEXT_HERE Expand the size of the box downward, while maintaining the height of all clips. TEXT_HERE Follow global tempo When followgobaltempo is enabled for a clip in mc.playlist~, mc.sfplay~ will calculate the current tempo out of the ratio between originaltempo and global tempo and adapt to global tempo changes. Formant Scale Set the amount of formant scaling when pitchshifting is performed. timestretch must be enabled to adjust the formant scaling. Turn on formant correction Turn on formant correction when pitch correction is performed. Both timestretch and pitchcorrection need to be enabled first. Turn looping on/off Turn looping on/off. Loop Report When enabled, the message "loopnotify", followed by the clip number and file name, is sent out the fourth outlet of mc.playlist~ every time a loop occurs. Timestretching Mode Set the timestretching mode to be used. Each mode is optimized for handling different kinds of audio material. All modes are zero latency. timestretch must be enabled first. TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE Name TEXT_HERE Original Length The original length of the the audio file. This can be measured in ticks, bars.beats.units, or notevalues. Used by followglobaltempo to calculate the speed in relation to the global transport speed. Setting the originallength will calculate the originaltempo. followglobaltempo must be enabled first. Original Tempo The original tempo of the the audio file. Used by followglobaltempo to calculate the speed in relation to the global transport speed. Setting the originaltempo will calculate the originallength. followglobaltempo must be enabled first. Parameter Mode Enable Enables use of this object with Max for Live Parameters and allows for setting initial parameter values in the Max environment. Visible to Mapping When parameter_mappable is enabled, the object will be available for mapping to keyboard or MIDI input using the Mappings feature. Turn on pitch correction Enable/disables the formant-corrected chromatic intonation correction. timestretch must be enabled first. For more extensive real-time intonation correction, use the retune~ object. Pitch Shifting Factor Specify pitchshift as a factor of the original pitch (i.e. 2.0 = doubling of pitch, .5 = halving of the original pitch, etc.). timestretch must be enabled first. Pitch Shifting in Cents Specify pitchshift as positive or negative cent values (i.e. 100 = semitone up, -1200 = octave down). Cents may be specified as ints or floats. timestretch must be enabled first. Timestretching Quality Choose the quality for timestretching output. TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE Report Progress Report the progress (0. - 1.) of the currently playing media file via the notification output. Selection Color Set the color of selections. Show File Name Show the file name for each clip. Slur time Set the time it takes for the correction to reach the full corrected 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. timestretch and pitchcorrection must be enabled first. Playback speed Set the playback speed. 1.0 = original speed, 0.5 = half-speed, etc. Object style Sets the style to be applied to the object. Styles can be set using the Format palette. Text Color Set the color of the file name text. Turn on timestretching Disable/enable timestretching. When timestretch is set to 1, you can control the quality of the conversion with the mode, quality, and formant attributes. Display style for waveforms Display style for waveforms that represent each clip. TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE mc.playlist~ outputs a multichannel signal with a number of channels specified by the channelcount attribute.

The second outlet provides a single-channel sync signal. The integer part of the signal value is the index of the clip that is playing. The fractional part is the instantaneous position within that clip. The third 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. The rightmost outlet sends a dictionary summary of the mc.playlist~ content in response to the 'getcontent' message.