home *** CD-ROM | disk | FTP | other *** search
/ Global Amiga Experience / globalamigaexperience.iso / music / composing / bars&pipespro2.5 / mtcsync.doc < prev    next >
Text File  |  1995-07-10  |  6KB  |  139 lines
  1. MTC Sync
  2. --------
  3.  
  4. This program receives MIDI Time code either via the standard serial
  5. MIDI interface or the One-Stop Music Shop MIDI Interface, displays the
  6. current MTC frame, and optionally sends syncing messages to other
  7. programs.
  8.  
  9. If a One-Stop Music Shop card is present in the system, the program
  10. will default to receive on the MIDI interface on the One-Stop card.
  11. If not, the program will receive MIDI Time Code on the standard serial
  12. MIDI interface.  This program will NOT run at the same time as
  13. Bars&Pipes or SuperJAM!.
  14.  
  15. The MTC Sync program can send messages directly to the Media Madness
  16. Player (distributed with Bars&Pipes Professional 2.0) or the One-Stop
  17. Music Shop MIDI File Player (distributed with the One-Stop Music
  18. Shop).  The MTC Sync program can also send messages via ARexx to any
  19. program.
  20.  
  21. See ADVANCED CUSTOMIZATION below for customizing this program.
  22.  
  23.  
  24. ADVANCED CUSTOMIZATION
  25. ----------------------
  26.  
  27. This program is cusomized via the use of ToolTypes.  ToolTypes are
  28. strings stored in the program's icon that can be read by the program
  29. at runtime.  If you do not know how to view or edit an icon's
  30. ToolTypes, consult your Amiga Workbench documentation.
  31.  
  32. All the ToolTypes have defaults designed to make this program run in
  33. conjunction with the Media Madness Player supplied with Bars&Pipes
  34. Professional 2.0.  You will typically need to change only a few
  35. ToolTypes.
  36.  
  37. TOOLTYPES FOR MTC Sync
  38. ----------------------
  39.  
  40. DIRECTPORT=portname             default: "MMPlayer_Direct"
  41.  
  42.     This option specified the name of the port to send direct sync
  43. messages to.  These messages are in a special format and only Blue
  44. Ribbon products are able to understand them.
  45.  
  46. DIRECT=on/off                   default: ON
  47.  
  48.     This option defines whether direct messages are sent or not.  If
  49. this option is set OFF, ARexx messages will be sent instead.
  50.  
  51. AREXXPORT=portname              default: "MMPlayer_ARexx"
  52.  
  53.     This option specified the name of the port to send ARexx messages
  54. to.  The actual ARexx messages sent are defined below.
  55.  
  56. SENDFRAME=on/off                default: ON
  57. FRAMEMSG=msg                    default: "FRAME 24/25/29/30"
  58.  
  59.     If this message is on, the actual frame rate is sent after the
  60. first full MTC packet.  The actual message is based on the frame rate
  61. of the incoming MTC packet.  You can change the values delimited by
  62. slahses to change the parameter.  For example, to change the parameter
  63. passed with drop frame time code, you might define:
  64.     FRAMEMSG="FRAME 24/25/30df/30"
  65.  
  66. SENDSTART=on/off                default: OFF
  67. STARTMSG=msg                    default: "START SMPTE %s"
  68.  
  69.     If this message is on a start message is sent when the first full
  70. MTC packet is received (this message is not necessary for the Media
  71. Madness Player and by default is off).  You can change this message to
  72. whatever you like, placing the characters "%s" (no quotes necessary)
  73. whereever you wish the current SMPTE time in HH:MM:SS.FF format to be
  74. inserted.
  75.  
  76. SENDLOCATE=on/off               default: OFF
  77. LOCATEMSG=msg                   default: "LOCATE SMPTE %s"
  78.  
  79.     If this message is on a locate message is sent when the first full
  80. MTC packet is received (this message is not necessary for the Media
  81. Madness Player and by default is off).  You can change this message to
  82. whatever you like, placing the characters "%s" (no quotes necessary)
  83. whereever you wish the current SMPTE time in HH:MM:SS.FF format to be
  84. inserted.
  85.  
  86. SENDSYNC=on/off                 default: ON
  87. SYNCMSG=msg                     default: "SYNC SMPTE %s"
  88.  
  89.     If this message is on a sync message is sent every frame while
  90. MIDI time code is being received.  You can change this message to
  91. whatever you like, placing the characters "%s" (no quotes necessary)
  92. whereever you wish the current SMPTE time in HH:MM:SS.FF format to be
  93. inserted.
  94.  
  95. SENDSTOP=on/off                 default: ON
  96. STOPMSG=msg                     default: "STOP"
  97.  
  98.     If this message is on a stop message is sent when the program
  99. detects that MIDI Time code has stopped being received.  It may take
  100. up to 2 frames to detect that MIDI time code has stopped.
  101.  
  102. DEVICE=best/serial/osms1/osms2  default: BEST
  103.  
  104.     This option defines which port MIDI Time Code will be received on.
  105. By default (the "BEST" option) if a One-Stop Music Shop board is
  106. detected then that MIDI port will be used, otherwise the standard
  107. serial MIDI interface will be used.
  108.  
  109. BIGNUM=on/off                   default: OFF
  110.  
  111.     This option defines how the program displays the SMPTE time.  With
  112. BIGNUM set to OFF, a smaller LED display is used.  With BIGNUM set to
  113. ON a larger, more visible font is used.
  114.  
  115. BURNIN=on/off                   default: OFF
  116.  
  117.     If this option is on, the program opens its own screen to be used
  118. for genlocking, with the current MTC frame being the only thing
  119. displayed.  Otherwise, a window opens up on the Workbench screen to
  120. display this information.
  121.  
  122. The following options are valid only if BURNIN=ON:
  123.  
  124. LEFTEDGE=num                    default: 84   (BIGNUM=OFF: 92)
  125. TOPEDGE=num                     default: 170  (BIGNUM=OFF: 180)
  126.  
  127.     These options define the pixel position of the top left corner of
  128. the SMPTE frame display on the BURNIN screen.
  129.  
  130. FGCOLOR=red,green,blue          default: workbench colors
  131. BKCOLOR=red,green,blue          default: workbench colors
  132.  
  133.     These options define the colors for the BURNIN screen.  Each of
  134. the red, green, and blue values are numbers from 0 to 15.  While
  135. genlocking, the background color will always be transparent - this
  136. color option is provided only for completeness.  For example, to make
  137. the forground white:
  138.         FGCOLOR=15,15,15
  139.