DragonFly On-Line Manual Pages

MIDICOPY(N)                            N                           MIDICOPY(N)

NAME
     midicopy - tclmidi command to copy a range of events in a MIDI song

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

DESCRIPTION
     midicopy is a tclmidi(1) command that copies a range of events.  These
     events can be copied from one track to another, or copied 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 copy.

     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 copied.
     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 copied.

RETURN VALUES
     midicopy does not return anything.

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

AUTHOR
     Mike Durian - durian@boogie.com

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