home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / trjoy094.zip / TRACKJOY.HLP < prev    next >
Text File  |  1995-01-09  |  21KB  |  564 lines

  1.  ────────────────────────────────────────────────────────────────────────
  2.  WELCOME TO TRACKJOY
  3.  ────────────────────────────────────────────────────────────────────────
  4.  
  5.  
  6.  
  7.            version 0.94ß
  8.  
  9.  
  10.  
  11.                                 Trackjoy is Copyright (c) 1995 by Tomi Joy
  12.                                  See documentation for more information on
  13.                                     copying, distributing and your license
  14.  
  15.  
  16. January 1995
  17.  
  18.                               ───────────
  19.  
  20.  
  21.  Welcome to the Trackjoy music composition program. Trackjoy is a
  22.  simple sample & module type tracker.
  23.  
  24.  Here are some of its main features:
  25.  
  26.  ■ Varying pattern length, width and channel formats
  27.    (length: 1 ─ 255, width: 1 ─ 17, channel types:
  28.    full, stripped and global)
  29.  
  30.  ■ Up to 64 samples can be used
  31.  
  32.  ■ Supports 8- or 16-bit-samples, uni- and bidirectional looping
  33.  
  34.  ■ In addition to ordinary special commands, supports
  35.    special commands entered in the instrument field of a note.
  36.  
  37.  ■ Supports the GUS only
  38.  
  39.  ■ Loads raw 8-bit, raw 16-bit, Digiplayer and Trackjoy's
  40.    own samples
  41.  
  42.  ■ Fully controllable stereo panning
  43.  
  44.  ■ Continuous effects (scheme differs from the .mod system)
  45.  
  46.  ■ Easy global song control (with the "global" channel type)
  47.  
  48.  ─────────────────────────────────────────────────────────────────────────
  49.  GETTING STARTED
  50.  
  51.  
  52.  When you have started Trackjoy, you are presented with a very 
  53.  dull-looking screen with lots of lines on it. On the left are the line 
  54.  numbers in decimal and at the top and bottom of the screen are two 
  55.  status lines. This is the pattern editing window, in which you enter 
  56.  notes.
  57.  
  58.  Pressing Esc (as you will probably have done, since you are reading 
  59.  this) gives you the menu bar.
  60.  
  61.  You might like to start by loading one of the demo modules. If you 
  62.  haven't configured Trackjoy so that it knows where to look for songs, 
  63.  you will have to give it the directory from the file selector box 
  64.  presented to you when you select "Load module".
  65.  
  66.  Play the module with F5 or Shift-F5 when in the pattern editing screen, 
  67.  or choose Play from the menu. The Stop key is the same as the play key, 
  68.  although you can use Shift-Enter as well. Shift-Enter always stops all 
  69.  sound. Note that the keys only work when you are in the pattern editing 
  70.  window.
  71.  
  72.  To view the samples in a module (or song), press F1 or choose Sample 
  73.  Manager from the menu. To test a sample in the Sample Manager, move the 
  74.  cursor bar on it and press F2. Then use the keyboard to play (details 
  75.  can be found in the documentation).
  76.  
  77.  
  78.  The rest should be simple. Finding all the keys might be a little 
  79.  difficult at first, and a large portion of Trackjoy's functions can't 
  80.  be located on the main menu at all, so you will just have to learn 
  81.  the keys. Sorry about this.
  82.  
  83.  
  84.                             ───────────────
  85.  
  86.  
  87.  I hope you enjoy Trackjoy. When you need more information on Trackjoy 
  88.  functions (key definitions, for instance), see the other part of this 
  89.  help system, and for details, please see the documentation 
  90.  (TRACKJOY.DOC).
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107. 
  108.  
  109.   TRACKJOY COMMANDS, KEYBOARD & MAIN MENU
  110.   ────────────────────────────────────────────────────────────────────────
  111.  
  112.  
  113.  
  114.   Command                      Key           Menu
  115.   ────────────────────────────────────────────────────────────────────────
  116.  
  117.   ─── PATTERN EDITING SCREEN ─────────────────────────────────────────────
  118.  
  119.   Allocate new pattern         F2            *
  120.   Clear pattern                Ctrl-X        *
  121.   Delete pattern               Ctrl-E        *
  122.   Duplicate pattern            Ctrl-D        *
  123.   Go to pattern                Alt-G         *
  124.   Insert pattern               Ctrl-I        *
  125.   Next pattern                 + (E)         *
  126.   Previous pattern             - (E)         *
  127.   Resize pattern               Ctrl-R        *
  128.  
  129.   Delete note                  Del, Alt-D
  130.   Insert note                  Ins, Alt-I
  131.   Set cell field to empty      ' (configurable)
  132.   Toggle multichannel mode     < (configurable)
  133.   Channel on/off               ⌡ (configurable)
  134.   Select octave                / & *
  135.   Go to previous pos. & damp   Backspace
  136.  
  137.   Block on/off                 Alt-F4
  138.   Copy block to buffer         Alt-C
  139.   Cut block to buffer (zap)    Ctrl-Z
  140.   Copy channel to buffer       Alt-L
  141.   Copy pattern to buffer       Alt-T
  142.   Free block (buffer)          Alt-F
  143.   Paste block from buffer      Alt-P
  144.   Transparent paste            Alt-N
  145.   Write block (buffer)         Alt-W         *
  146.   Read block (buffer)          Alt-R         *
  147.  
  148.   Increase advance             Alt-S
  149.   Decrease advance             Alt-A
  150.   Define horiz-o-helpers       Ctrl-F
  151.   Select bottom statusline     Ctrl-A
  152.  
  153.   Enter a FREQ. CTRL MXX       F7
  154.   Enter a STOP MXX             F8
  155.   Field Editing Tools          F3            *
  156.   Scale channel volumes        Alt-V
  157.   Interpolate                  Ctrl-V
  158.   Chord mode setup             F4            *
  159.   Add semitone                 Alt-K
  160.   Subtract semitone            Alt-J
  161.   Mark a line                  Alt-E
  162.   Remove mark                  Alt-H
  163.   Toggle status line mode      Ctrl-A
  164.  
  165.   Toggle multichannel modes    Alt-B
  166.   Use defined chord            Alt-1...Alt-0
  167.  
  168.   *** Debug screen ***         F9
  169.   (ß-versions only)
  170.  
  171.   Monitor playback             F10
  172.   Toggle line-in               Alt-m
  173.  
  174.   New song                                   *
  175.   Load song                    Ctrl-L        *
  176.   Load module                                *
  177.   Quit                         Alt-x         *
  178.   Save as module                             *
  179.   Save as song                 Ctrl-S        *
  180.   Shell                        Alt-Z         *
  181.  
  182.   Stop playing                 Esc           *
  183.   Play song                    F5            *
  184.   Play song (no trace)         Shift-F5
  185.   Play pattern                 F6            *
  186.   Play pattern (no trace)      Shift-F6
  187.   Play from order              Alt-F6        *
  188.   Play from marker             Ctrl-F6       *
  189.   Pause                        Alt-F5        *
  190.   Mute all voices              Ctrl-M        *
  191.   Mute all voices & stop play  Shift-Enter
  192.   Monitor playback             F10           *
  193.  
  194.   General setup                Ctrl-G        *
  195.   Edit order                   Ctrl-O        *
  196.   Edit song information        Ctrl-W        *
  197.   Help                         Ctrl-H        *
  198.  
  199.  
  200.   ─── SAMPLE MANAGER ─────────────────────────────────────────────────────
  201.  
  202.   Load sample                  F1
  203.   Tune sample                  F2
  204.   Enter name                   F3
  205.   Enter description            F4
  206.   Clear sample                 F5
  207.   Set frequency                F6
  208.   Set volume                   F7
  209.   Test beats                   F8
  210.   Write sample                 F9
  211.  
  212.   Reload all samples           Shift-F1
  213.   Write all samples            Shift-F9
  214.  
  215.   ─── SAMPLE MANAGER / TUNING WINDOW ─────────────────────────────────────
  216.  
  217.   Multichannel mode            F1
  218.   Set loop locations           F2
  219.   Fine-tune "qwerty" octave    F3/F4
  220.   Fine-tune "zxcvbn" octave    F7/F8
  221.   Divide keyboard              F5
  222.   Set volume                   F6
  223.   # of multichannels           F9/F10
  224.   Temporary transpose up       *
  225.   Temporary transpose down     /
  226.   Change sample volume         Alt-Q / Alt-W
  227.   Change global volume         Alt-A / Alt-S
  228.   Add/subtract semitone        Arrows left & right
  229.   Add/subtract octave          Arrows up & down
  230.   Change sample                Ctrl- arrows left & right
  231.   Damp all voices              Del, Space
  232.  
  233.   ─── TRACE WINDOW ───────────────────────────────────────────────────────
  234.  
  235.   Decrease tempo               - (P)
  236.   Increase tempo               + (P)
  237.   Stop polling                 Space
  238.   Adjust damper time           / & *
  239.   Select viewable channels     Arrows left & right
  240.   Force to play from order     PgUp & PgDn
  241.   Exit / stop playing          Esc
  242.   Exit / continue playing      x
  243.  
  244.   ─── GRAPHICAL PLAYING MONITOR (F10) ────────────────────────────────────
  245.  
  246.   Select channel               Left & right arrow keys
  247.   Channel on/off               Space
  248.   Increase/decrease step size  +/-
  249.   Pitch bend using step        F1/F2
  250.   Global volume change w/step  F3/F4
  251.   Exit                         Esc
  252.  
  253.   ────────────────────────────────────────────────────────────────────────
  254.  
  255.   A blank in either column means the command can't be invoked in that way
  256.   An asterisk (*) means the command is available through the main menu.
  257.   In most dialog boxes at least some of the most important keys are listed
  258.   seperately, and if not, then they are listed directly in front or after
  259.   the item they are assigned to.
  260.  
  261.  
  262. 
  263.  
  264.   TRACKJOY'S SPECIAL COMMANDS
  265.   ────────────────────────────────────────────────────────────────────────
  266.  
  267.   Full channel type:
  268.  
  269.   Command   Field    Purpose                  Parameters P1, P2
  270.   ────────────────────────────────────────────────────────────────────────
  271.   A         CMD      Volume ramp up           Speed = P1*(P2+1)
  272.   B         CMD      Volume ramp down         Speed = P1*(P2+1)
  273.   C         CMD      Set balance to centre    -
  274.   S         CMD      Set balance              Bal = P1 (0-100)
  275.   D         CMD      Frequency adjust up      Speed = P1*(P2+1)
  276.   U         CMD      Frequency adjust down    Speed = P1*(P2+1)
  277.   G         CMD      Portamento to note       Speed = P1, Note = P2
  278.   L         CMD      Pan channel to left      Speed = P1
  279.   R         CMD      Pan channel to right     Speed = P1
  280.   T         CMD      Set tempo                New tempo = P1
  281.   P         CMD      Poll                     -
  282.   V         CMD      Vibrato                  Speed = P1, Depth=P2
  283.   X         CMD      Cancel all commands      -
  284.   Y         CMD      Vibrato smooth-out       Speed = 1/P1
  285.   Z         CMD      Set linear tempo         Resulting T = 3600/Z
  286.  
  287.   99=FC     INS      Don't restart voice      -
  288.   98=ST     INS      Stop voice               -
  289.   97=ÖR     INS      (Something fishy here)   -
  290.   96=DD     INS      Detune down 0.5 semit.   -
  291.   95=DU     INS      Detune up 0.5 semitones  -
  292.   94=RL     INS      Release loop             -
  293.  
  294.  
  295.   *** NOTE: Volume changes in cells with no note information do affect 
  296.             the volume. Continuous volume changes are the main way of 
  297.             achieving some kind of articulation in melody channels.
  298.  
  299.             More commands are on the way, and will probably be available 
  300.             in version 0.95ß. These commands include relative tempo 
  301.             changes, limited (easy-to-use) volume and frequency changes,
  302.             tremolo, "stereo rotation", note delay, retrig and trill
  303.             commands. Some of these may be implemented as MXX commands or
  304.             normal commands ─ or both ─ because it would be well worth 
  305.             having as many powerful MXX commands as possible.
  306.  
  307.             ADSR support ─ when it *is* supported ─ will be controlled 
  308.             mainly through more MXX commands. We have got down to 94 now 
  309.             by using a slightly suspicious MXX command number 97, the 
  310.             Örörör! command (you might like to refer to the discussion 
  311.             about the .BLK file format in TECH.DOC). As yet, nobody has 
  312.             found out what this command was actually supposed to dp. 
  313.             ADSR support? Who said anything about that? ADSR will 
  314.             probably appear somewhere around version 1.2 or 1.3 (or 
  315.             1.never), ie. certainly not in any crappy ß-versions.
  316.             However, supporting instruments with ADSR seems like a
  317.             very important feature, and so you do have hope of
  318.             getting such things in the future.
  319.  
  320.  
  321.   Global channel type ─ these *don't work* in version 0.94ß (not even a bit).
  322.                               
  323.   Command   Field    Purpose                  Parameters P1, P2
  324.   ────────────────────────────────────────────────────────────────────────
  325.   A         CMD      Volume ramp up           Speed = P1*(P2+1)
  326.   B         CMD      Volume ramp down         Speed = P1*(P2+1)
  327.   C         CMD      Set balance to centre    -
  328.   D         CMD      Frequency adjust up      Speed = P1*(P2+1)
  329.   H         CMD      Stop all voices          -
  330.   U         CMD      Frequency adjust down    Speed = P1*(P2+1)
  331.   T         CMD      Set tempo                New tempo = P1
  332.   P         CMD      Poll                     -
  333.   Z         CMD      Set linear tempor        T = 3600/Z
  334.  
  335.  
  336.  
  337.  
  338. 
  339.  
  340.   USING THE BLOCK
  341.   ────────────────────────────────────────────────────────────────────────
  342.  
  343.   The block is operated with the following keys:
  344.  
  345.   Alt-C ················ Make copy of marked area to memory
  346.   Alt-F ················ Free memory used by allocated block
  347.   Alt-F4 ··············· Block mode on/off (for selecting a block)
  348.   Alt-L ················ Make copy of current channel
  349.   Alt-P ················ Paste block to current pattern
  350.   Alt-R ················ Read block from disk
  351.   Alt-T ················ Make copy of current pattern
  352.   Alt-W ················ Write block to disk
  353.   
  354.   The following commands can be used with the block as well as with
  355.   a single channel or pattern.
  356.  
  357.   Alt-J ················ Transpose down (one semitone)
  358.   Alt-K ················ Transpose up (one semitone)
  359.   Ctrl-T ··············· Tranpose by value
  360.   F3 ··················· Field editing tools
  361.  
  362.   *** NOTE: If you want to use the block instead of a channel or
  363.             pattern with Field Editing Tools, select "Block" in the 
  364.             "Object" selector.
  365.  
  366.             Alt-C will now ─ thanks to some pesky beta-testers
  367.             (H. Joy) ─ unmark the block.
  368.  
  369.   All these commands (except Field Editing Tools) will automatically use
  370.   the block if you have one selected. Otherwise they will use the current
  371.   channel. There is no need to copy the block (Alt-c) with these commands,
  372.   since Trackjoy only uses the coordinates for these functions.
  373.  
  374.  
  375. 
  376.  
  377.   TRACKJOY'S SAMPLE MANAGER
  378.   ────────────────────────────────────────────────────────────────────────
  379.  
  380.   Invoke Sample Manager either with the F1 key or by selecting it from
  381.   the "Editor" menu.
  382.  
  383.   1. Selecting a sample:
  384.  
  385.  
  386.        After you have selected a sample, and if you have set "Ask for 
  387.        sample type" to On, Trackjoy will ask for a file type, P for PC8 
  388.        (most common), A for A8 or S for S16. PC8 and A8 are the 8-bit 
  389.        sample types, S16 is unsigned low-high byte order 16-bit. The 
  390.        format of the 16-bit samples is the same as in the GF1 patch file 
  391.        format, which makes sample ripping from patches pretty easy.
  392.          
  393.    2. Loading a sample
  394.  
  395.      ─ If you have just selected a sample file, and if you have
  396.        set "Load sample directly" On, Trackjoy will automatically
  397.        load your sample.
  398.  
  399.      ─ To load a sample for the first time or to reload it, position the 
  400.        cursor over a line with a valid filename and press F1. If the 
  401.        file can be loaded, it will be loaded according to the type 
  402.        displayed in the rightmost filed of a line. If not, Trackjoy will 
  403.        let you type in a new directory or abort.
  404.  
  405.    3. Playing & tuning a sample
  406.  
  407.      ─ If you have "Tune sample directly" On, the tuning window
  408.        will appear every time you have selected and loaded a sample.
  409.  
  410.      ─ When you have successfully loaded a sample, you can tune it with
  411.        F2, after which you can play the sample with the normal
  412.        Trackjoy piano keyboard keys, ie. q, 2, w, 3, e...
  413.  
  414.      ─ The following editing keys can be used to tune a sample:
  415.  
  416.        F3 & F4 ─ Fine-tune a sample
  417.        Arrows Right & Left ─ add/subtract semitone from frequency
  418.        Arrows Up & Down ─ raise/lower by octave
  419.  
  420.      ─ To play a sample in polychannel mode (ie., from 1 to n, 
  421.        changing channels on each note played), press F1. To change the 
  422.        number of polychannels, use F9 & F10.
  423.  
  424.      ─ To play two samples at a time, press F5 and enter a sample 
  425.        number. The sample you entered will be played with the "zxcvbn"
  426.        octave, and the original sample with the "qwerty" octave.
  427.  
  428.      ─ Changing loop modes is done by pressing F2. You are presented 
  429.        with the Loop Setup window.
  430.  
  431.        'L' toggles wheter looping is on at all.
  432.        'D' toggles looping direction, mono- or bidirectional.
  433.        'B' lets you enter the loop beginning
  434.        'E' lets you enter the loop end
  435.  
  436.        The arrow keys adjust the beginning and end by one.
  437.  
  438.    4. Entering name & description
  439.  
  440.      ─ To enter a new name, press F3 and type in the name.
  441.      ─ To enter a description, press F4, and type the text.
  442.  
  443.    5. Clearing sample information
  444.  
  445.      ─ When you are in the first Sample Manager screen, select the entry 
  446.        you want to clear. Press F5 and 'y', if you do want to clear that
  447.        entry. The memory used by that sample will be freed for use by 
  448.        other samples.
  449.  
  450.    6. Entering a new frequency
  451.  
  452.      ─ If you need to type in a new frequency for a sample, mote the 
  453.        cursor over it and press F6. Then enter a frequency. The default 
  454.        is 4000.
  455.  
  456.  
  457.        
  458.  
  459.  
  460.  
  461. 
  462.  
  463.  WORKING WITH PATTERNS
  464.  ────────────────────────────────────────────────────────────────────────
  465.  
  466.  
  467.  
  468.  A. What you have to do before Trackjoy will play anything
  469.  
  470.  
  471.      1. You must have a sample selected and loaded in Sample Manager.
  472.  
  473.      2. There must be a sample number in the second (2-character) field 
  474.         of a note (full and stripped channels)
  475.  
  476.      3. There must be a volume (third field) for the *first* note with 
  477.         that volume. You might like to choose a default volume for your 
  478.         own purposes, and I suggest a round one hundred. This will still 
  479.         give you the possibility of notes with 2,54 times the default 
  480.         volume.
  481.  
  482.      4. Enter a note in the first field with the keyboard.
  483.  
  484.      5. There must be an order list.
  485.  
  486.      ■ With points 2, 3 and 5, Trackjoy will try to help you, so
  487.        you shouldn't need to worry about them.
  488.  
  489.      *** NOTE: Only enter the instrument and volume for the *first* note
  490.                that uses those values. Trackjoy will use the first 
  491.                values until something else comes up. This also applies 
  492.                to a new pattern, which will use the previous volume if
  493.                no new volume is specified at its beginning.
  494.  
  495.  
  496.  B. The pattern allocation & deletion commands and their definitions:
  497.     ("Pattern" menu)
  498.  
  499.  ─ Previous pattern
  500.  
  501.    If you are in a pattern whose number is 1 or more, you will go to the 
  502.    previous one. This is the same as the '-' key.
  503.  
  504.  ─ Next pattern
  505.  
  506.    If the next pattern exists, you will go to it. This is the same as 
  507.    the '+' key.
  508.  
  509.  ─ Goto pattern
  510.  
  511.    Go to any pattern, if it exists.
  512.  
  513.  ─ Duplicate pattern
  514.  
  515.    This command is the same as the Allocate pattern command, only it 
  516.    copies the default values for the pattern (ie., width, rows and 
  517.    channel formats) from the current pattern. If you choose to allocate 
  518.    a new pattern, it will be added to the end of the pattern list.
  519.  
  520.  ─ Allocate (next) pattern
  521.  
  522.    This command will let you allocate the next pattern. It will be added 
  523.    the the end of the pattern list.
  524.  
  525.  ─ Insert pattern
  526.  
  527.    This command allocates and inserts a new pattern. This means that if 
  528.    you select this command and the current pattern is, say, number 2, 
  529.    then it will change to three (and everything after it will be moved 
  530.    forward) and the new pattern you are about to allocate will be the 
  531.    new number 2.
  532.  
  533.    After pattern insertion Trackjoy will ask if you want to change the 
  534.    order accordingly so that the old numbers in the order list would 
  535.    still point to the right note information. If you do, press Y.
  536.  
  537.  ─ Delete pattern
  538.  
  539.    This removes the pattern you are in from the pattern list and frees 
  540.    the memory used by it. This command will ─ like the Insert pattern 
  541.    command ─ ask whether you want to process the order list. (See 
  542.    previous command). If you do, press Y.
  543.  
  544.  ─ Clear pattern
  545.  
  546.    Clears the current pattern completely by setting all the bytes 
  547.    allocated to it to the value 255 or FFh.
  548.  
  549.  ─ Resize pattern
  550.  
  551.    This command is for changing the pattern format. You can change a 
  552.    pattern to any new size you like. All the data in that pattern that 
  553.    can be saved will be copied to the new pattern. Be careful when 
  554.    converting full channels to stripped, because you will lose any 
  555.    special command information by doing so.
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  *** End of Help File ***
  564.