Global Amiga Experience/globalamigaexperience.iso/compressed/music/bars&pipes25demo.lha/Bars&PipesProfessional/MTCSync.doc

Text File | 1994-06-01 | 6KB | 139 lines

MTC Sync
--------

This program receives MIDI Time code either via the standard serial
MIDI interface or the One-Stop Music Shop MIDI Interface, displays the
current MTC frame, and optionally sends syncing messages to other
programs.

If a One-Stop Music Shop card is present in the system, the program
will default to receive on the MIDI interface on the One-Stop card.
If not, the program will receive MIDI Time Code on the standard serial
MIDI interface.  This program will NOT run at the same time as
Bars&Pipes or SuperJAM!.

The MTC Sync program can send messages directly to the Media Madness
Player (distributed with Bars&Pipes Professional 2.0) or the One-Stop
Music Shop MIDI File Player (distributed with the One-Stop Music
Shop).  The MTC Sync program can also send messages via ARexx to any
program.

See ADVANCED CUSTOMIZATION below for customizing this program.


ADVANCED CUSTOMIZATION
----------------------

This program is cusomized via the use of ToolTypes.  ToolTypes are
strings stored in the program's icon that can be read by the program
at runtime.  If you do not know how to view or edit an icon's
ToolTypes, consult your Amiga Workbench documentation.

All the ToolTypes have defaults designed to make this program run in
conjunction with the Media Madness Player supplied with Bars&Pipes
Professional 2.0.  You will typically need to change only a few
ToolTypes.

TOOLTYPES FOR MTC Sync
----------------------

DIRECTPORT=portname             default: "MMPlayer_Direct"

    This option specified the name of the port to send direct sync
messages to.  These messages are in a special format and only Blue
Ribbon products are able to understand them.

DIRECT=on/off                   default: ON

    This option defines whether direct messages are sent or not.  If
this option is set OFF, ARexx messages will be sent instead.

AREXXPORT=portname              default: "MMPlayer_ARexx"

    This option specified the name of the port to send ARexx messages
to.  The actual ARexx messages sent are defined below.

SENDFRAME=on/off                default: ON
FRAMEMSG=msg                    default: "FRAME 24/25/29/30"

    If this message is on, the actual frame rate is sent after the
first full MTC packet.  The actual message is based on the frame rate
of the incoming MTC packet.  You can change the values delimited by
slahses to change the parameter.  For example, to change the parameter
passed with drop frame time code, you might define:
    FRAMEMSG="FRAME 24/25/30df/30"

SENDSTART=on/off                default: OFF
STARTMSG=msg                    default: "START SMPTE %s"

    If this message is on a start message is sent when the first full
MTC packet is received (this message is not necessary for the Media
Madness Player and by default is off).  You can change this message to
whatever you like, placing the characters "%s" (no quotes necessary)
whereever you wish the current SMPTE time in HH:MM:SS.FF format to be
inserted.

SENDLOCATE=on/off               default: OFF
LOCATEMSG=msg                   default: "LOCATE SMPTE %s"

    If this message is on a locate message is sent when the first full
MTC packet is received (this message is not necessary for the Media
Madness Player and by default is off).  You can change this message to
whatever you like, placing the characters "%s" (no quotes necessary)
whereever you wish the current SMPTE time in HH:MM:SS.FF format to be
inserted.

SENDSYNC=on/off                 default: ON
SYNCMSG=msg                     default: "SYNC SMPTE %s"

    If this message is on a sync message is sent every frame while
MIDI time code is being received.  You can change this message to
whatever you like, placing the characters "%s" (no quotes necessary)
whereever you wish the current SMPTE time in HH:MM:SS.FF format to be
inserted.

SENDSTOP=on/off                 default: ON
STOPMSG=msg                     default: "STOP"

    If this message is on a stop message is sent when the program
detects that MIDI Time code has stopped being received.  It may take
up to 2 frames to detect that MIDI time code has stopped.

DEVICE=best/serial/osms1/osms2  default: BEST

    This option defines which port MIDI Time Code will be received on.
By default (the "BEST" option) if a One-Stop Music Shop board is
detected then that MIDI port will be used, otherwise the standard
serial MIDI interface will be used.

BIGNUM=on/off                   default: OFF

    This option defines how the program displays the SMPTE time.  With
BIGNUM set to OFF, a smaller LED display is used.  With BIGNUM set to
ON a larger, more visible font is used.

BURNIN=on/off                   default: OFF

    If this option is on, the program opens its own screen to be used
for genlocking, with the current MTC frame being the only thing
displayed.  Otherwise, a window opens up on the Workbench screen to
display this information.

The following options are valid only if BURNIN=ON:

LEFTEDGE=num                    default: 84   (BIGNUM=OFF: 92)
TOPEDGE=num                     default: 170  (BIGNUM=OFF: 180)

    These options define the pixel position of the top left corner of
the SMPTE frame display on the BURNIN screen.

FGCOLOR=red,green,blue          default: workbench colors
BKCOLOR=red,green,blue          default: workbench colors

    These options define the colors for the BURNIN screen.  Each of
the red, green, and blue values are numbers from 0 to 15.  While
genlocking, the background color will always be transparent - this
color option is provided only for completeness.  For example, to make
the forground white:
        FGCOLOR=15,15,15