DragonFly On-Line Manual Pages

MIDIMOVE(N)                            N                           MIDIMOVE(N)

NAME
     midimove - tclmidi command to move a range of events in a MIDI song

SYNOPSIS
     midimove {destMidiID destTrack} destStartTime {srcMidiID srcTrack}
              srcStartTime srcEndTime

DESCRIPTION
     midimove is a tclmidi(1) command that moves a range of events.  These
     events can be moved from one track to another, or moved within the same
     track.  The source range may overlap with the destination.

     The first argument is a list specifying a particular track in a MIDI
     song.  The first element of this list is a MIDI song identifier as
     returned by midimake(n), or midinew(n).  The second element is a valid
     track number in the MIDI song.  This list specifies the destination track
     for the move.

     The third argument is the time to start depositing the events specified
     in the source range.  Note, the first event might not be placed at
     exactly the requested time if an event does not occur at the start time
     for the source range.  The offset between the first event and the
     destination start time will be the same as the offset between the first
     event found in the source range and the start time of the source range.

     The fourth argument is another list identical in form to the list
     identifying the destination track.  This list specified the source track.

     The fifth and last arguments specify the range of events to be moved.
     They determine the start and end times of the range.  All events found at
     time srcStartTime up to, but not including events found at time
     srcEndTime will be moved.

RETURN VALUES
     midimove does not return anything.

SEE ALSO
     tclmidi(1), midiread(n), midimake(n), midicopy(n)

AUTHOR
     Mike Durian - durian@boogie.com

DragonFly 6.5-DEVELOPMENT       April 13, 1994       DragonFly 6.5-DEVELOPMENT