To use the sequenceXtra behavior kit You will need Director 7 or later with sequenceXtra installed in the Xtras folder.

The behavior package contains a folder named "sequenceXtra" with the following castLibs inside:

• Song Handling
• Track Handling
• Transport Controls
• Realtime Controls
• Graphical Editors
Additional

To make the behaviors visible in Directors "Library Palette" follow these steps:

1. Quit Director if it´s running
2. Move the folder with the castLibs into the "libs"-folder in your Director folder
3. Start Director
4. Now you will see a new menu in the Library Palette called "sequenceXtra" with five sub menus. Use them as normal behaviors in the library palette - drag them to a sprite or to the script channel and they will be copied to your internal castLib.

Some basic steps to make it work:

1. Create the graphics you need
2. Put them on the stage
3. Add the behaviors you need to make your movie work
4. Write your own LINGO to do additional functions

Please take a few moments to do the sequenceXtra tutorial (you find it on http://www.sourceforce.nu). This will give you an idea of what you can do with the sequenceXtra behaviors.

SequenceXtra behavior descriptions

1 Song Handling

CREATE NEW SONG

This behavior creates an empty song in witch the user can do recordings and it make this song "the current song".

PARAMETERS:

• New song on...
  Select the event that opens the file.

• Song ID
  An ID for the song that make it possible to work with diffrent songs at the same time.

• Number Of Tracks
  The initial number of tracks.

• Tempo (bpm)
  The initial tempo.

• Time Signature
  The initial Time Signatur.

OPEN MID file

With this behavior you can create an "open MIDI-file button". It also makes this song "the current song".

PARAMETERS:

• Open MIDI-file On...
  Select the event that opens the file.

• Song ID
  An ID for the song that make it possible to work with diffrent songs at the same time.

OPEN SXS (sequenceXtra) file

With this behavior you can create an "open button". It also makes this song "the current song".

PARAMETERS:

• Open SXS-file On...
  Select the event that opens the file.

• Song ID
  An ID for the song that make it possible to work with diffrent songs at the same time.

SAVE MID-FILE

Use this behavior to create a "save SMF button".

PARAMETERS:

• Save Song On
  Selects the event that saves the file.

SAVE SXS (sequenceXtra) FILE

Use this behavior to create a "save button".

PARAMETERS:

• Save Song On
  Selects the event that saves the file.

PLAY SXS/MID FILE

Use this behavior to play a selected SXS or MIDI-file. The file has to be in the same directory as the movie. You can put the behavior on a button that starts the file or on any sprite and select Play File On "beginSprite" to make it play automatic.

NOTE:
This behavior does NOT work in shockwave runmode.

PARAMETERS:

• Play File On
  Selects the event that plays the file.

• File:
  The first time you put the behavior on a sprite you will get a dialog where you can select the file. If you want to change it later, you can edit the path manually. The path will work on both Mac and Windows.

• Song ID
  An ID for the song that make it possible to work with diffrent songs at the same time.

• PLAY/STOP toggle
  With this option selected the button will toggle between the start and stop function.

DOWNLOAD MID OR SXS FILE

Use this behavior to download and (optional) play a SMF or SXS (sequenceXtra) file from an URL.

PARAMETERS:

• Download File On
  Select the event that starts the downloading of the file.

• Play File On
  Select the event that (optional) plays the file.

• URL
  Specify the URL to your file.

• Song ID
  An ID for the song that makes it possible to work with diffrent songs at the same time.

FIELD TO SONG

Use this behavior to recreate and play songs from data stored in a field created with the behavior "SXS/MID-file to field" (in the category "6 - Additional"). It works fine with short files but is very slow on normal MID-files.

PARAMETERS:

• Play song on..
  Selects the event that creates the song.

• SongID
  An ID for the song that make it possible to work with diffrent songs at the same time.

• Field with song dataSong ID
  The field member with the data created with the behavior "SXS/MID-file to field".

• PLAY/STOP toggle
  Makes the button toggle between PLAY and STOP.

SELECT SONG

Many of the sequenceXtra behaviors refers to a specific song (like "play song", "Set Tempo", "Set Locators"). Use this behavior to make them refer to the song you specify here. You refer to the song with it´s songID. Type it without spaces.

PARAMETERS:

• Select Song On...
  Selects the event that selects the song.

• SongID
  The ID of the song you want to select. (If you´r not sure, check the property inspector of the behavior that created or opened the song you want to select)
  

2 Track Handling

SHOW/SET TRACK NAME

Use this behavior on a field or a text member to show (and set) the track name. You can either specify a track number or you can let it refer to the track selected with the "Select Track"-behavior.

PARAMETERS:

• Track Number
  Type the track number or leave it with with a 'zero' to make a dynamic reference.

• Editable
  Give the user the possibility (if selected) to edit the track name.

SHOW TRACK INSTRUMENT

Use this behavior on a text- or a field member to show the selected instrumentfor a track. You can either specify a track number or you can let it refer to the track selected with the "Select Track"-behavior. Use the behavior "Track Instrument PopUp Menu" to set the track instrument.

PARAMETERS:

• Track Number
  Type the track number or leave it with with a 'zero' to make a dynamic reference.

• Default Text
  The default text.

TRACK INSTRUMENT POPUP MENU

Use this behavior to create a popup menu for selecting instrument. Two new scrolling #field members are created and stored in your Internal castlib ("sxInstrumentNames"). You can change their content if you prefere another font or other instrumnet names.

PARAMETERS:

• Track Number
  Type the track number or leave it with with a 'zero' to make a dynamic reference.

• Visible Lines
  Select the number of lines of the PopUp menu.

SET INSTRUMENT FOR ALL TRACKS

Create a button that sets the instruments for the whole band (track 1-16) with this behavior.

PARAMETERS:

• Send on beginsprite
  If checked the Instrument data will be sent on beginSprite.

• Instrument on channel 1-16
  Select the desired instrument for each track.

SHOW/SET MIXER FUNCTIONS

Use this behavior to create a movable slider that shows and sets one of the track parameters #volume, #panpot, #reverb or #chorus. You can specify one or more track numbers (comma separated) or you can let it refer to the track selected with the "Select Track"-behavior.

NOTE:
Place the sprite in its 'lowest' position on the stage.

PARAMETERS:

• Track Number
  Type one or more track numbers (comma separated) or leave it with with a 'zero' to make a dynamic reference.

• Function
  Selects the mixer function for this slider.

• Direction
  Selects Horizontal or Vertical direction for the slider.

• Slider Length
  The number of pixels from the sliders lowest to its highest position.

• Initial Value
  This parameter moves the slider to the selected value on beginSprite.

• Allow screen recording
  If checked and you have a "record track behavior" somewhere, the movings during recording will be stored.

• Send Initial Value
  Send the selected value to the track on beginSprite.

• Rollover/MouseDown Cursors
  Sets the cursor to the selected ones during sliding.

TRACK TRANSPOSE (all track but ch 10)

Use this behavior to create a movable slider or a text field that shows and sets the transpose value of all tracks but tracks with channel 10 (drums in GM-synths).

NOTE:
Place the sprite in its 'lowest' position on the stage.

PARAMETERS:

• Direction
  Selects Horizontal or Vertical direction for the slider.

• Slider Length
  The number of pixels from the sliders lowest to its highest position.

• Initial Value
  This parameter moves the slider to the selected value on beginSprite.

• Min Transpose
  Set the lowest posible transpose value.

• Max Transpose
  Set the highest posible transpose value.

• Send Initial Value
  Send the selected value to the track on beginSprite.

• Rollover/MouseDown Cursors
  Sets the cursor to the selected ones during sliding.

SHOW TRACK QUANTIZE

Use this behavior on a text- or a field member to show the quantize value for a track. You can either specify a track number or you can let it refer to the track selected with the "Select Track"-behavior. Use the behavior "Track Quantize PopUp Menu" to set the track quantize value.

PARAMETERS:

• Track Number.
  Type the track number or leave it with with a 'zero' to make a dynamic reference.

• Default Text
  The default text.

TRACK QUANTIZE POPUP MENU

Use this behavior to create a popup menu for selecting instrument. One new scrolling #field member are created and stored in your Internal castlib ("sxQuantize"). You can change its content if you prefere another font or other labels and values. The quantize values corresponding to the labels are stored in the 'comments' of member("sxQuantize").

NOTE:
You MUST manually activate the parameter "Include Cast Member Comments" in File > Publish Settings > Compression to make this behavior work in Shockwave mode.

PARAMETERS:

• Track Number
  Type the track number or leave it with with a 'zero' to make a dynamic reference.

• Visible Lines
  Select the number of lines of the PopUp menu.

SELECT TRACK

With this behavior you can create a track mute button.

PARAMETERS:

• Set Mute State on...
  Selects the event that mutes the track.

• Turn mute
  Selects the function of the button.

• Track nr.
  Selects the specified track nr.

SHOW/SET TRACK INFO

Use this behavior on a text member to create a "track inspector". Use it to show and set different track parameters such as transpose, volume, mute and quantize. If you use it on a field member it´s not possible to use TAB to separate the columns. You can either specify a track number or you can let it refer to the track selected with the "Select Track"-behavior.

PARAMETERS:

• Track Number
  Type the track number or leave it with with a 'zero' to make a dynamic reference.

• Item Delimiter, User Defined Delimiter
  The item between the different beats and subbeats. If you select "user defined" you can type your own sign/signs in the field "User Defined Delimiter".

• Track Name, Track Transpose, Track Channel etc.
  Show or hide the different parameters in the text member.

SHOW TRACK EVENT LIST

Use this behavior on a text member to create a typical "list edit" (as they are called in sequencer programs). If you use it on a field member it´s not possible to use TAB to separate the columns. You can either specify a track number or you can let it refer to the track selected with the "Select Track"-behavior.

PARAMETERS:

• Track Number
  Type the track number or leave it with with a 'zero' to make a dynamic reference.

• Item Delimiter, User Defined Delimiter
  The item between the different beats and subbeats. If you select "user defined" you can type your own sign/signs in the field "User Defined Delimiter".

• Merge Parts
  Check this option to merge the parts on the track before displaying the event list. This is the only solution to get all types of events displayed in the right order.

SELECT TRACK

Many of the behaviors for the sequenceXtra refers to a track (like "Record Track", "Show/Set Mixer Functions", "Delete Track Events" etc. By selecting at track with this behavior, you can make all (or some) of the other behaviors refer to the same track - "the selected track".

PARAMETERS:

• Select track on...
  Selects the event that selects the track.

• Track nr.
  Selects the specified track nr.

• Ink when track is selected
  Sets the ink of this sprite to the selected value when track is selected (useful for creating inverted trackNames on selected tracks).

• Set Midi Thru
  Determines if this behaviors will set Midi Thru to its track when it is selected.

DELETE TRACK EVENTS

Use this behavior to make an "erase button" for a track. You can either specify a track number or you can let it refer to the track selected with the "Select Track"-behavior.

PARAMETERS:

• Delete On...
  Selects the event that deletes the events.

• Track number...
  Type the track number or leave it with with a 'zero' to make a dynamic reference.

• Delete From
  Select the start point for deleting.

• to
  Select the end point for deleting.

3 Transport Controls

PLAY SONG

Plays a song from a chosen position. To specify a special song (if there are several in RAM), use the behavior "Select Song".

NOTE:
Set the parameter "Play from..." to "the current position" if you want this behavior to interact with the behaviors "rewind/forward" and "position".

PARAMETERS:

• Play song on...
  Select the event that plays the song.

• Play from...
  select 'the beginning', the current position or the left locator.

PLAY SELECTION

Plays a specified section of a song. To specify a special song (if there are several in RAM), use the behavior "Select Song".

PARAMETERS:

• Play song on...
  Select the event that opens the file.

• Left Locator
  Sets the start of the section.

• Right Locator
  Sets the end of the section. (the bar just to the right of the last bar you want to to be played)

• Loop Times
  Sets the number of repeats of the section ("-1" means an infinte loop).

RECORD TRACK

Create a record button with this behavior. You can record both with a MIDI-keyboard or with the mouse (try the "Keyboard Control"-behaviors). To specify "the current song" and/or "the current track" for recording - use the "select song" and "select track" behaviors.

PARAMETERS:

• Record track on...
  Select the event that records the track.

• Track Number
  Specifies the target track. If you select "0" the target track is "the current track".

• Record Mode
  Specifies the record mode.

  "overdub" adds the new recording to the old one.
  "replace" deletes the old events and add the new ones.
  "replace - merge parts" deletes the old events and merges old parts.

• Start/Stop recording
  Specifies the start and stop positions for the recording.

STOP SONG

Create a stop button with this behavior.

PARAMETERS:

• Stop song on...
  Select the event that stops the song.

REWIND/FORWARD

Use this behavior to create rewind or fast forward buttons. When you use it, you can press 'SHIFT' while clicking the sprite to increase thespeed. Sprites with a "Position Pointer" behavior will be auto updated when you use this behavior.

NOTE:
If the song is playing, it will jump to the new position when the user release the mousebutton.

PARAMETERS:

• Direction
  Select "forward" or "rewind".

• Speed
  Select speed 1-10. The speed is framerate dependent. Try different values to get the result you want.

SHOW STATE

Make PLAY and RECORD buttons show their state depending on the xtra with this behavior.You select a member for each state - STOPPED, PLAYING & RECORDING.

PARAMETERS:

• Member when...
  Select a member for each state.

SHOW/SET TEMPO

Use this behavior together with either a field or text member to create a editable display for songtempo or use it with other membertypes to create a movable temposlider. In any case the text or the position will be automatic updated if the song contains tempo changes. If you move the slider during recording, the tempochanges will be recorded.

PARAMETERS:

• Direction
  The direction you want to move the slider.

• Slider Length
  The distance from the current position to the maxposition.

• Min Tempo
  The minimum value for the slider.

• Max Tempo
  The maximum value for the slider

• Initial Tempo
  Moves the slider to the specified value on start.

• Send initial tempo on start
  Sends the selected tempo on start if selected.

• Rollover/MouseDown cursor
  Gives the possibility to change cursor when dragging the slider.

SET METRONOME

Create a metronome ON/OFF button with this behavior.

PARAMETERS:

• Turn metronome
  Selects the function of the behavior.

• Init state
  Selects the initial metronome state.

• Set Metronome on...
  Selects the event that sets the metrnome state.

SET LOOP

Create a loop ON/ON button with this behavior.

PARAMETERS:

• Turn loop
  Selects the function of the behavior.

• Init state
  Selects the initial loop state.

• Set Metronome on...
  Selects the event that sets the metrnome state.

SET LOCATORS (Numerical)

Use this behavior with a text och field member to display and set the left/right locator or with another memberType to set the locator to a predefined value. The locators can be used with the "Play Song" and "Record Track" behaviors to define a section for playback/loop/recording.

PARAMETERS:

• Left or right locator?
  Selects wich locator this sprite will show.

• Item Delimiter, User Defined Delimiter
  The item between the different beats and subbeats. If you select "user defined" you can type your own sign/signs in the field "User Defined Delimiter".

• Bar, Beat, 1/16, Tick
  You can choose what you want to be visible.

SHOW/SET POSITION (Numerical)

Use this behavior with fields or text members. It creates an editable display of the current position.

PARAMETERS:

• Item Delimiter, User Defined Delimiter
  The item between the different beats and subbeats. If you select "user defined" you can type your own sign/signs in the field "User Defined Delimiter"

• Bar, Beat, 1/16, Tick
  You can choose what you want to be visible.

JUMP TO BAR

Create a button to jump to a specific bar with this behavior.

PARAMETERS:

• Jump To Bar on...
  Select the event that jumps to the bar.

• Target Bar
  Select the desired bar number.

4 Realtime Controls

PLAY NOTE

With this behavior you can build your own screen keyboard. Placing it on a sprite creates a simulated piano key. Placing it in the script channel will play a note when passing that frame.

NOTE:
If you use this behavior together with the behavior "Record track" it is possible to make recordings by playing on the screen.

PARAMETERS:

• Play Note on...
  Select the event that plays the note.

• Note
  Select the note (the menu uses sharps, not flats).

• Octave
  Select octave. the numbering uses the MIDI-standard. The 'middle C' is in the 3rd octave.

• Velocity
  Select the how hard the note will play on the synt.

• Length
  Select a predefined length for the note or let the mouseUp release the note.

PITCH BEND

Use this behavior to simulate a pitch bender on a keyboard. The sprite you attach it to will act like a slider and will send out a pitch bend message to the synth.

NOTE:
If you use this behavior together with the behavior "Record track" it is possible to make recordings by playing on the screen.

PARAMETERS:

• Direction
  The direction you want to move the slider.

• Slider Length
  The distance from the current position to the maxposition.

• Rollover/MouseDown cursor
  Gives the possibility to change cursor when dragging the slider.

CONTROLLER SLIDER

Use this behavior to create a movable slider that sends any controller message to the synt. The value will raise from 0 to 127.

NOTE:
If you use this behavior together with the behavior "Record track" it is possible to make recordings by playing on the screen.

PARAMETERS:

• Function
  Any continous Controller (some are specified).

• Direction
  The direction you want to move the slider.

• Slider Length
  The distance from the current position to the maxposition.

• Initial Value
  Moves the slider to the specified value on start.

• Send Init Value
  Sends the selected value on start if selected.

• Rollover/MouseDown cursor
  Gives the possibility to change cursor when dragging the slider.

5 Graphical Editors

ARRANGE EDIT

With this behavior you can create a graphical editor for the song arrangement. It works almost like standard sequencer programs do. Just drop it on a sprite with the size you want for your arrange editor.

PARAMETERS:

• First visible track
  Select the first track you want to be visible in the editor.

• Number of tracks
  Select the number of tracks you want to be visible in the editor.

• V-space for parts
  Select vertical distance between the parts (pix).

• The number of... on the x-axis is...:
  These two parameters selects the scale of the bar ruler.

• Editable
  Select if the user will have the possibility to edit the parts or just see them.

• Snap to...
  This parameter sets the quantize value for drawing and moving parts

• Constrain moving
  Constrains the moving of parts to the rect of this sprite if checked.

• Default tool
  Selects the default tool for this editor. There is another behavior called "set tool" that works fine together with this behavior.

• Set MIDI Thru to current track
  Sets MIDI Thru to the track the user changed (or selected a part on) - this change the instrument on the connected keyboard to the instrument on the current track.

• Group ID
  Set all behaviors working together with this one to the same Group ID.

• Master
  If you uncheck this one you will get a "Slave Arrange Editor". It scroll and zoom together with the "Master Arrange Editor"-behavior.

KEY EDIT

Draw a square with the Vector Tool, put it on the stage and add this behavior to create a graphical editor for a part. It works almost like the key editor in a standard sequencer program.

PARAMETERS:

• The highest note is a...in octave... (3 = "middle C")
  Select the highest note (with name and octave) you want to be visible in the editor.

• The number of...on the y-axis is...
  Select the number of keys you want to be visible in the editor.

• Draw piano keys with a width of (pix)
  Set the width of the piano keys.

• The number of...on the x-axis is...:
  These two parameters selects the scale of the bar ruler.

• Snap to...
  This parameter sets the quantize value for drawing and moving notes.

• Default velocity
  Sets the velocity value for the inserted notes.

• Play notes when drawing
  Select if you want to hear notes you are painting.

• Default tool
  Selects the default tool for this editor. There is another behavior called "set tool" that works fine together with this behavior.

• Group ID
  Set all behaviors working together with this one to the same Group ID.

BAR NUMBERS

This behavior works together with the "Arrange Edit" and "Key Edit" behaviors in combination with "Position Pointer (graphical)". Place it on a text member above the sprite with the "arr" or "key" behavior, select the same group ID, add a position pointer with its behavior and you will get bar numbers that update on scroll, zoom etc.

PARAMETERS:

• Group ID
  Select the same group ID as you have set in the "Arrange Edit" or "Key Edit" property inspector.

POSITION POINTER (GRAFICAL)

Works together with the "Arrange Edit" and "Key Edit"-behaviors. It turns a sprite into a following position pointer When it in play or record mode reaches the left or right side of the grafical edit sprite, it will autoscroll the content. It¥s also possible to set the position by moving the sprite.

PARAMETERS:

• Allow dragging
  Select if you want the position pointer to be manually movable.

• Rollover cursor
  Select the cursor you want for rollOver.

• MouseDown cursor
  Select the cursor you want for mouseDown.

• Group ID
  Select the ID that corresponds with your "Arrange" or "KeyEdit" behavior.

POSITION POINTER (GRAPHICAL)

With this behavior you can create a grafical locator that works together with the "Arrange Edit" and "Key Edit"-behaviors.

PARAMETERS:

• Left or right locator?
  Select locator

• Default Bar
  Select the initial bar for this locator (0 = no change)

• Rollover cursor
  Select the cursor you want for rollOver

• MouseDown cursor
  Select the cursor you want for mouseDown

ZOOM BUTTON

Works together with the "Arrange Edit" and "Key Edit"-behaviors. It zooms the content of a graphical edit sprite in the decided direction

PARAMETERS:

• Target sprite
  Select the sprite with the "Arrange" or "KeyEdit" behavior.

• Zoom axis
  Select the axis you want to zoom the content of the graphical edit sprite.

• Zoom direction
  Select the direction you want to zoom the content of the graphical edit sprite (in or out).

SCROLL BUTTON

Works together with the "Arrange Edit" and "Key Edit"-behaviors. It scrolls the content of a graphical edit sprite in the decided direction. If you press "shift" while scrolling the speed of the scrolling increases.

PARAMETERS:

• Target sprite
  Select the sprite with the "Arrange" or "KeyEdit" behavior.

• Scroll direction
  Select the direction you want to scroll the content of the graphical edit sprite.

• Speed
  Select the default scroll speed.

SET TOOL

With this behavior you can create a button to select tool for sprite with the "Arrange" or "Key Edit" behavior.

PARAMETERS:

• Select Tool
  Select the tool you want to be selected by this sprite

• Autoselect this tool on beginSprite
  If selected, then this tool will be the default tool for the graphical edit sprite.

TRACK INDICATOR

Works together with the "Arrange Edit" behavior. It moves the sprite on the y-axis to indicate the selected track.

PARAMETERS:

• no parameters

6 Additional

CHECK MIDI SYSTEM

Use this behavior to check the users MIDI system in the beginning of your movie. Put it in the script channel or on a graphical sprite in frame 1

PARAMETERS:

• Check xtra
  Checks if the user accepted to download sequenceXtra and if it´s downloaded and installed correctly

• If no sequenceXtra then go go marker
  Select a marker where you inform the user to reload the page and install sequenceXtra

• Check MIDI
  Checks if there is a MIDI-system on the users computer.

• If no MIDI system the go marker
  Select a marker where you inform the user to check his MIDI system

• Check outputs
  Checks if there are no MIDI outputs on the users system i.e. if there are no software or hardware MIDI instruments installed

• If no MIDI outputs then go go marker
  Select a marker where you inform the user to install a MIDI instrument

SHOW MIDI OUTPUT

Use this behavior field or text member to show the MIDI output selected with the behavior "MIDI output Popup menu".

PARAMETERS:

• Default Text
  Type the text you want as the default text.

MIDI OUTPUT POPUP MENU

Use this behavior to create a popup menu for selecting MIDI output. One new scrolling #field member are created and stored in your Internal castlib ("sxOutput"). You can change it's look after it´s created. Use the behavior "Show MIDI output" to show the name of the output you select.

PARAMETERS:

• Visible Lines
  Select the number of lines of the PopUp menu.

SET MIDI THRU

Set the MIDI thru (the track on wich the incoming MIDI signals are routed thru) to the desired track number.

PARAMETERS:

• Set MIDI Thru on...
  Select the event that sets the MIDI trhu.

• Track nr.
  Select the specified track nr.

SET MASTERVOLUME

Use this behavior together with either a field or text member to set the master volume numerically or use it with other membertypes to create a movable mastervolume slider.

NOTE:
This behavior uses a rather complicated sollution with relative track volumes to set the master volume. There is a master volume parameter on some synths, but not on all GM-synths so at the moment I prefere this tricky version.

PARAMETERS:

• Direction
  The direction you want to move the slider.

• Slider Length (pix)
  The distance from the current position to the maxposition.

• Min Volume
  The minimum value for the slider

• Max Volume
  The maximum value for the slider

• Initial Volume
  Moves the slider to the specified value on start

• Send initial volume on start
  Sends the selected tempo on start if selected

• Rollover/MouseDown cursor
  Gives the possibility to change cursor when dragging the slider.

BUTTON GROUP

This is a simple behavior for creating button groups. Place it on the graphic member intended for the "OFF state". The member will be replaced by the next member in the same castlib when the button is turned ON.

PARAMETERS:

• Default ON
  Select if the button will default on its ON or OFF state

• Group ID
  Select the same group ID for all buttons in the same group.

BUTTON TOGGLE

This is a simple behavior for creating toggle buttons. Place it on the graphic member intended for the "OFF state". The member will be replaced by the next member in the same castlib when the button is turned ON.

PARAMETERS:

• Default ON
  Select if the button will default on its ON or OFF state

STOP ALL SONGS (on stopMovie)

Stops all songs on stop movie. It also sets the global variable used by all sequenceXtra behaviors - "gXtraSongs" to VOID

PARAMETERS:

• no parameters

SXS/MID-FILE TO FIELD

Use this behavior in Author mode to create fields with data from a SXS-song or an MID-file. Together with the behavior "Field To Song", this behavior makes it possible to save and use MIDI-songdata INSIDE the director file. Mainly for use with small files, larger files will take a LONG time to write into the field.

NOTE:
This behavior is only for Author mode.

PARAMETERS:

• ChannelSort when importing.
  If checked, the behavior sorts the music into a 16 track arrangement based on the MIDI channels in the file.

Adding your own LINGO - for advanced users

It is possible to write Your own Lingo that interacts with these behaviors. To do that You need to understand the basic concept behind these behaviors. We really want to ask You to be very careful mixing behaviors and custom Lingo. We created this set of behaviors to make it possible to use sequenceXtra without having to deal with advanced lingo. They are not optimized for mixing with your own sequenceXtra code.

The sequenceXtra behaviors rely on a fairly sophisticated propertyList structure that is stored in the global variable gXtraSongs. In this List, every song has it´s own SongID.

If you want to create a simple script that plays a song that was created with a sequenceXtra behavior and has the SongID #song1, use this syntax:

global gXtraSongs
gXtraSongs.song1.sxPlay()

If you want to manually create a song that can be controlled by the sequenceXtra behaviors:

global gXtraSongs
gXtraSongs[#userSong1] = new(xtra "sequenceXtra", 16)

(for subsequent songs use #userSong2, #userSong3 etc)

If you want to play this song with your own code, write:

global gXtraSongs
gXtraSongs.userSong1.sxPlay()

If you want to select a song (so the Transport Controls behaviors refer to this song):

global gXtraSongs
gXtraSongs.parameters.curSong = #userSong1    (or whatever song You want to control)

If you want to select a track (so all of the Track Handling behaviors refer to this track):

global gXtraSongs
gXtraSongs.parameters.curTrack = 10