home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / RAVELUTL.ZIP / RAVLCONV.ZIP / CTOR.MAN < prev    next >
Encoding:
Text File  |  1989-01-07  |  6.9 KB  |  178 lines
  1.         ctor                            RAVEL                             ctor
  2.  
  3.         NNAAMMEE
  4.  
  5.         ctor - CAKEWALK ASCII to Ravel translator
  6.  
  7.         SSYYNNOOPPSSIISS
  8.  
  9.         ccttoorr [-b][-n][-t][-s scale] [-p poff] <filename>
  10.  
  11.         DDEESSCCRRIIPPTTIIOONN
  12.  
  13.         ccttoorr is a program that translates from the CAKEWALK ASCII file
  14.         format to a subset of the Ravel music programming language.
  15.         CAKEWALK is a popular and affordable sequencer program available
  16.         from
  17.  
  18.         Twelve Tone Systems
  19.         P.O. Box 226
  20.         Watertown, MA 02272
  21.  
  22.         Like Ravel, it runs on ibm-pc's and compatibles and uses the
  23.         mpu-401.  Rtoc and ctor are Ravel utilities that allow
  24.         translation between a subset of Ravel (actions) and "events" in
  25.         the CAKEWALK system. CAKEWALK provides translation utilities
  26.         called asc2cake and cake2asc that translate between CAKEWALK's
  27.         internal binary format and an external CAKEWALK ASCII event file
  28.         format. The CAKEWALK system also provides utilities for
  29.         translation from CAKEWALK format to other formats. As a result
  30.         Ravel + CAKEWALK can work together as a tool system, each taking
  31.         advantage of it's own strengths.
  32.  
  33.              One might typically use ccttoorr to do the following: record a
  34.         track in cakewalk from a MIDI instrument. Save the ".wrk" file.
  35.         Translate the ".wrk" file with the cakewalk utility called
  36.         "cake2asc"; producing a ".asc" cakewalk ASCII file. Then use the
  37.         ccttoorr utility with appropriate switches to produce a Ravel
  38.         notelist. This can be edited with Ravel and put in a Ravel
  39.         piece.
  40.  
  41.              Ctor takes an input file that is a ".asc" ASCII file format
  42.         as produced by the version 2 CAKEWALK utility called "cake2asc".
  43.  
  44.              The input file is read and is sent to the console; i.e.,
  45.         standard output. It may be redirected to a file using a shell
  46.         redirect '>'; e.g.,
  47.  
  48.         dos> ctor input.asc > output.ma
  49.  
  50.         The resulting ".ma" file may be translated by "mc" and played
  51.         with "mos". Since it is an ASCII file, it can be edited with an
  52.         normal editor.
  53.  
  54.              Ctor handles only note, patch (program change), continuous
  55.  
  56.  
  57.  
  58.      January 7, 1989                                                 page 1
  59.  
  60.         controller, and pitch bend events at the present time. It
  61.         currently only looks at [STREAM] records and translates the
  62.         events found there. Each [STREAM] is made into a voicelist. More
  63.         than one can be handled. It will also look at the EndAllTime
  64.         variable set in the [VARS] section to determine how many events
  65.         maximum are to be found in the file. The last event in all
  66.         streams is set accordingly.
  67.  
  68.  
  69.              Note that switches are optional. This is denoted by placing
  70.         [] characters around the switch. The switch notation is "-",
  71.         which recognizes Unix conventions. Msdos switches will not work.
  72.         The program is looking for "-".
  73.  
  74.              The [[--ss ssccaallee]] scale switch is used for scaling down event
  75.         times. CAKEWALK treats a quarter note as 120 events. Ravel
  76.         treats it as 24 events. As a result the translator will scale
  77.         down (divide) all events by a factor of 5. The scale switch may
  78.         be used to specify a different scaling factor (non-zero). A
  79.         scaling factor of 1 would preserve the CAKEWALK units, but of
  80.         course the piece would run slower at the same meter. Division
  81.         may cause loss of precision. All event times (elapsed events and
  82.         durations) are scaled.
  83.  
  84.              The [[--pp ppooffff]] switch is optional and will set the pitch
  85.         bend offset to whatever non-zero value is given. The pitch bend
  86.         offset defaults to 64 if not set. The pitch bend range in MIDI
  87.         is a 14 bit unsigned number; in decimal this is 0 to 16383. A
  88.         centered wheel has the value 8192. Ravel uses a "pseudo-op"
  89.         called the "poff" or pitch bend offset that is multiplied
  90.         internally against the value used with the pitch bend action;
  91.         e.g.,
  92.  
  93.         bend q 128
  94.  
  95.         is the value for a centered wheel, since 128 * 64 = 8192. Note
  96.         that a pitch offset of 1 will leave the units unscaled. This may
  97.         be a useful thing to do when translating from CAKEWALK to Ravel,
  98.         since loss of precision may result from division.
  99.  
  100.              The [[--nn]] switch will cause note constants to be translated
  101.         to the appropriate Ravel constant form; E.g., 60 = C. The key of
  102.         C is used.
  103.  
  104.              Time constants are not translated unless the [[--tt]] switch is
  105.         given. Time constants are translated if and only if there is a
  106.         suitable Ravel constant; otherwise they are left in decimal.
  107.  
  108.              If the [[--bb]] switch is given, pitch bend information is
  109.         removed from the streams. If a pitch bend has a non-zero event
  110.         time, this is translated into a tie. This is useful for removing
  111.         extraneous pitch bends that might be produced by a guitar
  112.  
  113.  
  114.  
  115.  
  116.  
  117.      January 7, 1989                                                 page 2
  118.  
  119.         controller.
  120.  
  121.              The translation program tracks Cakewalk events and spits
  122.         out measure information in a Ravel comment, whenever a 4/4
  123.         measure boundary is crossed. This information will appear as
  124.         follows:
  125.  
  126.         # measure 1 (96,480,96,0,0)
  127.  
  128.         The number in parenthesis refer to the following: 1. the elapsed
  129.         number of Ravel events so far., 2. the elapsed number of
  130.         Cakewalk events so far., 3. the number of Cakewalk events
  131.         divided by the scale factor; i.e., the TRUE number of Ravel
  132.         events which may not match the number of elapsed Ravel events
  133.         since it is subject to round-off error, and 4. the number of
  134.         Ravel events elapsed since we entered the measure; i.e.,
  135.         (Cakewalk events % 480) / scale. 5. the ravel slop factor.
  136.  
  137.              In order to minimize roundoff error, excess cakewalk events
  138.         that would be lost to roundoff are retained and added to the
  139.         next event whenever their sum is greater than "scale" (5). This
  140.         seems to permit a reasonable translation of a cakewalk sequence
  141.         to a Ravel series of actions, since error is in effect averaged
  142.         out. The "ravel slop factor" represents the number of cakewalk
  143.         events that have not yet been added to a ravel event.
  144.  
  145.         SSEEEE AALLSSOO
  146.  
  147.         rtoc, mc, mos.
  148.  
  149.         BBUUGGSS
  150.  
  151.         Ctor is a new utility and has not been tested much at this
  152.         point. There are undoubtedly some flaws.
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.      January 7, 1989                                                 page 3
  177.  
  178.