home *** CD-ROM | disk | FTP | other *** search
/ Large Pack of OldSkool DOS MOD Trackers / composer.zip / COMPOSD.DOC < prev    next >
Text File  |  1992-08-09  |  36KB  |  712 lines

  1.                            Renaissance '92
  2.                               presents
  3.  
  4.                           Composer 669 v1.2
  5.                            (c) 1992, Tran
  6.  
  7.                          The first 8 channel
  8.                        digital composer/player
  9.                              for the PC.
  10.  
  11.  
  12. Disclaimer:
  13.  
  14.   Composer 669 is Copyright 1992 by the author Tran (a.k.a. Tomasz Pytel).
  15.   You are free to distribute the unregistered version of this composer and its
  16.   documentation in any maner you choose. Including uploading it to BBSs,
  17.   distributing through a software house, or including in any commercial
  18.   package, provided that all the files are included and nothing has been
  19.   modified. No fee may be charged for the composer itself other than the cost
  20.   of the media on which it is distributed and any other small misc details the
  21.   total of which shall not exceed $5.00. (This does not include the fee for
  22.   the commercial product if any). This software is provided AS-IS. The author
  23.   of this software will not be liable for any damages caused in any manner by
  24.   the use of this software. By using Composer 669 you agree to all these
  25.   terms.
  26.  
  27.  
  28. Contents:
  29.  
  30.   1-A   -       Introduction
  31.   1-B   -       Requirements
  32.   1-B-1 -       Memory
  33.  
  34.   2-A   -       General overview
  35.   2-B   -       Composer colors
  36.   2-C   -       Configuration file
  37.   2-D   -       Directories
  38.   2-E   -       Command line options
  39.   2-F   -       Keys
  40.  
  41.   3-A   -       Instruments
  42.   3-A-1 -       Loading and saving them
  43.   3-A-2 -       Instrument loops
  44.   3-B   -       The song message
  45.   3-C   -       The status bars
  46.   3-D   -       The musical keyboard
  47.   3-E   -       SBPro mixer
  48.  
  49.   4-A   -       Patterns
  50.   4-A-1 -       Pattern tempo
  51.   4-A-2 -       Order list
  52.   4-A-3 -       Pattern breaks
  53.   4-B   -       Toggling channels on/off
  54.   4-C   -       Notes
  55.   4-D   -       Special commands
  56.   4-E   -       Blocks
  57.  
  58.   5-A   -       Playing songs
  59.   5-B   -       Tracking songs
  60.   5-C   -       Saving and loading songs
  61.  
  62.   6-A   -       Misc
  63.   6-B   -       Renaissance
  64.  
  65.  
  66. Note: All values in the composer are in hexadecimal unless otherwise
  67.   specified. If you do not know hexadecimal, dont worry. You will pick it up
  68.   very quickly just by looking at the number bars in the composer.
  69.  
  70.  
  71. 1-A. Introduction.
  72.  
  73.   Composer 669 is an 8 channel digital music composer/player. Thats right,
  74.   digital. It uses digital samples as instruments in music pieces and mixes
  75.   the output in real time, 8 channels into 1 on a mono system, and 8 channels
  76.   into 2 on a stereo system. This results in much higher quality music than
  77.   FM, and since the music is stored as instruments and notes, it takes up much
  78.   less space than a full track digital music piece. Things like this have
  79.   existed before, mostly on Amiga systems, and mostly in 4 channel versions.
  80.   But lately, the technique of real time digital mixing has found its way to
  81.   the PC world. This is the first player for the PC that gives you 8 channels
  82.   to work with. The quality of the music you can create with this composer is
  83.   very good to approaching professional level.
  84.  
  85.  
  86. 1-B. Requirements.
  87.  
  88.   To run this composer you must have the following hardware:
  89.     1) A 386 or better computer.
  90.     2) 2 megz RAM. (1408k extended).
  91.     3) A VGA card.
  92.     4) A Sound Blaster or a Sound Blaster Pro sound card. (On an SB you will
  93.         get mono music, on an SBPro you will get stereo).
  94.     5) DOS 3.0 or above.
  95.  
  96.   When you run this composer, you must not have any memory managers or any
  97.   other programs that run the system in V86 mode, and you must not have DOS
  98.   loaded high. The best configuration would be a clean system, but you can
  99.   experiment to see what TSRs and device drivers you can have in memory.
  100.  
  101. Note: Your SB or SBP must be on IRQ 3,5, or 7... IRQs 2 and 10 are not
  102.  supported.
  103.  
  104.  
  105. 1-B-1. Memory.
  106.  
  107.   This composer requires you to have at least 2 megz RAM in your system, if
  108.   you have more it will not be used. This is done to ensure that all 699
  109.   musics can be played on all systems. But dont worry, you will probably
  110.   never even fill up the first half of the 1408k assigned for samples. You
  111.   must also have 640k base memory in your system, not a k less!
  112.  
  113.  
  114. 2-A. General overview.
  115.  
  116.   Composer 669 lets you create and play 8 channel digital musics. Each music
  117.   can have up to 64 instruments using a maximum of 1408k memory. The max
  118.   size of each sample (the words instrument and sample will be used
  119.   interchangably in this doc) is 1 meg. Each music can have up to 128
  120.   patterns, a pattern a small chunk of music and it will be explained in more
  121.   detail later in this doc. Each pattern is made up of 64 rows, each of which
  122.   can contain a note to be played on each of the 8 channels. Instruments
  123.   are loaded and saved as pure digital files, and you can also load and save
  124.   .VOC files as instruments. The composer runs in VGA 80x50 text mode, and I
  125.   tried to fit as much information as possible onto the screen. You will do
  126.   almost all your editing on this screen. All the commands in the composer are
  127.   usually available in 1 keystroke. The mixing and output is done at 22kHz.
  128.  
  129.  
  130. 2-B. Composer colors.
  131.  
  132.   The color setup of the composer can be changed to whatever you like. At any
  133.   one time there are 8 color sets for you to switch among instantly, and any
  134.   color in any of these sets can be changed to anything you like. To edit the
  135.   composer colors, hit ALT-F10 from the main screen. A window will appear
  136.   with the 8 color sets you have to choose from, with the currently selected
  137.   set highlighted. If you are running the composer for the first time, you
  138.   will have the 8 default color sets to choose from. To change the active
  139.   color set, press up and down on the cursor keypad, the colors will be
  140.   changed instantly to those of the set you have selected. You can change any
  141.   color in any of the sets. Do this by using the left and right arrow keys to
  142.   move the pointer on the right to the color you wish to change. Then you can
  143.   change that color by using the keypad keys 1,2,3,4,5,6,7,8, and 9. You can
  144.   select the RGB values for that color. The values range from 0 (none) to
  145.   3F (full) value for the red, green, and blue components of the color. You
  146.   can also change the name of the active color set by pressing SPACE or ENTER
  147.   and then typing in a new name. Press ESC to exit color editing. But if you
  148.   want the changes you made to remain for the next time you run the composer,
  149.   you must save the configuration file by pressing ALT-F11.
  150.  
  151.  
  152. 2-C. Configuration file.
  153.  
  154.   The composer will run with or without a configuration file. You can create
  155.   this file by pressing ALT-F11 on the main screen of the composer. This file
  156.   will be created in whatever directory the composer is in, this may or may
  157.   not be the same directory you are running it from. Every time the composer
  158.   is started, it looks for this configuratin file in the directory COMPOSD.EXE
  159.   is located in. If it does not find it, it runs with the default values for
  160.   everything and any command line options you used (command line options will
  161.   be explained later). If the file is found, it is loaded and used to set up
  162.   the composer. Any command line options that you used will be checked after
  163.   the config file is loaded so they will override any config options.
  164.   The information the config file stores is the following:
  165.     1) The mixer settings for the SBPro (to be discussed later).
  166.     2) The song and instrument directories.
  167.     3) The color sets and the active set.
  168.  
  169.   You can delete the config file if you wish, there will be no ill effects to
  170.   the composer other than loosing any info that was in the file.
  171.  
  172.  
  173. 2-D. Directories.
  174.  
  175.   The composer uses 3 basic directories. Its own base directory (usually
  176.   \COMPOSD). A .669 song file directory (usually \COMPOSD\669). And a sample
  177.   directory (usually \COMPOSD\INS). The base directory is always set to the
  178.   directory the composer resides in and is used only to save the config file.
  179.   The song directory is the directory the composer will load and save .669
  180.   music files to. The instrument directory is the directory the composer loads
  181.   and saves all instruments to. The song and instrument directories must be
  182.   specified before any of their respective file types are loaded or saved.
  183.   They can be specified in the composer by pressing F9 to enter the song
  184.   directory, and F10 for the instrument directory. They will automatically
  185.   be loaded from a configuration file if one exists. You can also specify
  186.   them from the command line, if you do specify them on the command line, they
  187.   will override the config file.
  188.  
  189.  
  190. 2-E. Command line options.
  191.  
  192.   There are 5 command line options you can specify, they are:
  193.    /s - Sets the song directory to the string directly following this switch.
  194.    /i - Sets the instrument directory.
  195.    /f - Loads the music file directly following this switch. You must not
  196.     specify a path name or extention, the music will be loaded from the
  197.     song directory from the config file or the /s switch. If there is
  198.     no config file and you did not specify the /s switch, the composer
  199.     will look in the current directory for the file.
  200.    /p - After the music is loaded, it will be played once and then the
  201.         composer will quit to DOS. This is useful for playing groups of musics
  202.     from a batch file.
  203.    /c - Sets the color scheme to the number following this switch (0-7),
  204.     overriding the default active color set.
  205.  
  206.    Example:
  207.      COMPOSD /S\MUSIC /I\VOCS /FMUSIC1 /C4 /P
  208.  
  209.      This command line will set the song directory to '\MUSIC', the instrument
  210.      directory to '\VOCS'. Then it will load the file 'MUSIC1.669' from the
  211.      song directory and play it, when the song finishes it will quit to DOS.
  212.      And it will do all this in color set #4 which is by default 'Swamp Green'
  213.  
  214.  
  215. 2-F. Keys.
  216.  
  217.   A listing of the keys is available in the file called KEYS.TXT. You may wish
  218.   to print this out and use it as a quick reference card.
  219.  
  220. 3-A. Instruments.
  221.  
  222.   The instruments used by this composer are digital samples. That is, the are
  223.   real instruments digitized. Since they are digital, they sound much better
  224.   than FM like the Adlib uses. And because they are really digital samples,
  225.   you can use anything as an instrument, voices, sound FX, or any digital
  226.   sample. You can have up to 64 different instruments, as long as the sum of
  227.   their sizes does not exceed 1408k. The maximum size of a sample you can have
  228.   is 1 megabyte, but you will probably never use instruments larger than 128k,
  229.   and most of the time you will probably use instruments in the range of 1 -
  230.   5k.
  231.  
  232. 3-A-1. Loading and saving instruments.
  233.  
  234.   Instruments are loaded and saved from the instrument edit menu. To get to
  235.   this menu, press F1 in the composer. You can move the highlighted bar around
  236.   with the cursor keys and PgUp, PgDn ect... (all the keys are listed in the
  237.   help in the composer, to get the help press ? on the main screen). The
  238.   column of numbers on the left of the instrument names are the instrument
  239.   numbers. To load an instrument press the space bar. If you have an
  240.   instrument directory specified and there are files in it, you will be
  241.   presented with a file list. Choose the file you want to load. If the file
  242.   has the extention .VOC, it will be loaded as a VOC file, that is the header
  243.   will be stripped and only the actual digital data will be loaded. A VOC file
  244.   will be loaded correctly if the following conditions are true:
  245.     1) It consists of one block.
  246.     2) It is not packed.
  247.     3) It has a standard VOC header.
  248.  
  249.   If you wish to digitize VOCs and load them as instruments, the guideline is
  250.   that the sample, played at around 8740Hz, should be the middle C of the
  251.   instrument, or whatever youre digitizing.
  252.  
  253.   Anything that does not have a .VOC extention will be loaded straight as a
  254.   pure digital file. Since there is no way of distinguishing pure digital
  255.   sample files from other files, you will be able to load any file as an
  256.   instrument. Although any files other than digital files will probably sound
  257.   like garbage.
  258.  
  259.   You can save any instrument as either a pure digital file or a .VOC file.
  260.   But you must make sure that the instrument name is a valid DOS filename.
  261.   Since some people like to replace instrument names with messages, you may
  262.   have to rename the instrument first (press enter on the instrument) to a
  263.   DOS filename. If youre saving the sample as a VOC file, any extention the
  264.   instrument had will be replaced with .VOC. The VOC will be unpacked and the
  265.   sampling rate will be 8740Hz (which should be the middle C of the sample).
  266.  
  267. 3-A-2. Instrument loops.
  268.  
  269.   Sometimes you may want an instrument to keep playing over and over without
  270.   stopping, like for instance you may want a string instrument to keep playing
  271.   a note after it has been struck. You can do this with loops. In the
  272.   instrument edit screen, there are 3 numbers following the instrument name.
  273.   They are: the loop beginning, the loop end, and the length of an instrument.
  274.   If the loop end is numerically less than the instrument length, the sample
  275.   will loop over and over. After the instrument is played, when it reaches
  276.   the loop end, the instrument will be reset to the loop beginning, that is
  277.   the offset within the instrument will be set to the value of the loop begin.
  278.   The default values for the loop beginning and loop end are 0 and FFFFF
  279.   respectively. Since the loop end is FFFFF, no matter how large the
  280.   instrument you load, it will always be smaller than the loop end number.
  281.   Examine how the loop is used in the demo song.
  282.  
  283.  
  284. 3-B. The song message.
  285.  
  286.   In the middle upper section of the screen, there is a black rectangle. This
  287.   is the song message area. You can enter any text you wish in this area and
  288.   it will be saved in the 669 music file along with the music. This is just
  289.   a little area where you can put some info like the name of the song, author,
  290.   date of creation, ect... But you can put anyting in here including leaving
  291.   it blank. To edit this message press ALT-F4 from the main screen. Use the
  292.   cursor keys to move around and type in text. Pressing ENTER or ESC will
  293.   leave the message editing. Pressing CTRL-F4 on the main screen will clear
  294.   the message.
  295.  
  296.  
  297. 3-C. The status bars.
  298.  
  299.   There are 3 status bars on the screen. One at the top of the screen, one at
  300.   the bottom, and a vertical row of values in the middle of the screen. The
  301.   status bar at the top is the simplest. It contains the Copyright notice,
  302.   the sound card detected in the system, and the filename of the song youre
  303.   currently editing. The status bar at the bottom contains 6 values:
  304.     1) Tempo   - The basic tempo of the pattern youre currently editing.
  305.     2) Octave  - The base octave for entering and playing the notes.
  306.     3) Voice   - The current voice selected for editing and playing on.
  307.     4) Pattern - The pattern youre editing, it is displayed in the largest
  308.                   part of the screen just above this status bar.
  309.     5) Order   - The location of the cursor in the order list.
  310.     6) Mem     - This value is in decimal and it represents the amount of
  311.                   memory taken up by the currently loaded samples.
  312.  
  313.   If you dont know what some of these refer to, dont worry, ill get to that
  314.   soon.
  315.  
  316.   In the middle of the screen there is a group of 6 other values, they are:
  317.     1) Vol  - The current volume selected for entering and playing notes.
  318.     2) Ord  - This and the next 2 values are used to give you information
  319.                when music is playing. This value is the order number in the
  320.                order list which is currently playing.
  321.     2) Pat  - This is the pattern that is being played.
  322.     3) Row  - This is the row in the pattern that is currently playing.
  323.     4) Loop - This is the order to which the song will loop after reaching
  324.                the end.
  325.     5) Inst - This is the instrument number youre currently editing and
  326.                playing with.
  327.  
  328.  
  329. 3-D. The musical keyboard.
  330.  
  331.   For entering notes and playing instruments, the keyboard(computer) is
  332.   partitioned a little like the keyboard(musical). That is, you have 2 full
  333.   octaves on the keyboard to enter notes with. Here is a diagram:
  334.  
  335.             C#  D#      F#  G#  A#      C#  D#      F#  G#  A#
  336.          ┌─┬─┬─┬─┬──┬──┬─┬─┬─┬─┬─┬──┬──┬─┬─┬─┬──┬──┬─┬─┬─┬─┬─┬─┐
  337.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  338.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  339.          │ │S│ │D│  │  │G│ │H│ │J│  │  │2│ │3│  │  │5│ │6│ │7│ │
  340.          │ │ │ │ │  │  │ │ │ │ │ │  │  │ │ │ │  │  │ │ │ │ │ │ │
  341.          │ └┬┘ └┬┘  │  └┬┘ └┬┘ └┬┘  │  └┬┘ └┬┘  │  └┬┘ └┬┘ └┬┘ │
  342.          │  │   │   │   │   │   │   │   │   │   │   │   │   │  │
  343.          │Z │ X │ C │ V │ B │ N │ M │ Q │ W │ E │ R │ T │ Y │ U│
  344.          │  │   │   │   │   │   │   │   │   │   │   │   │   │  │
  345.          └──┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴───┴──┘
  346.           C   D   E   F   G   A   B   C   D   E   F   G   A   B
  347.  
  348.   The lower keys represent the base octave and the upper keys play one
  349.   octave above that. When you hit one of these keys, the appropriate note
  350.   will be played using the instrument indicated by Inst in the middle group
  351.   of stats. If this happens to be a null instrument, no sound will be
  352.   generated. The note will be played on the channel indicated by Voice in the
  353.   bottom status bar. And the octave will be the octave indicated by Octave
  354.   in the same status bar, or 1 octave higher, depending on what key was
  355.   pressed. The note will be played at a volume set by Vol in the middle stat
  356.   group (a volume of 0 is silence).
  357.  
  358.  
  359. 3-E. SBPro mixer.
  360.  
  361.   If you have a Sound Blaser Pro, there will be a group of 7 vertical bars
  362.   on the screen to the left of the middle stats group. These are the volumes
  363.   of the SBPro mixer in the following order from left to right: Master volume
  364.   left, right, Voc volume left, right, Line-In volume left, right, and mic
  365.   volume. You can adjust these values to whatever you like using CTRL and one
  366.   of the following keys: A,Z,S,X,D,C,F,V,G,B,H,N,J,and M. These keys are
  367.   paired, upper and lower, to increase and decrease the volume of their
  368.   respective channels. A and Z correspond to Master volume left, S and X to
  369.   Master volume right, D and C to Voc volume left, ect... When you save a
  370.   configuration file, these values are stored in it and the composer will
  371.   set the mixer to those values whenever it is ran. These volumes only adjust
  372.   the final output level of the music, they have absolutely nothing to do
  373.   with the music itself.
  374.  
  375.   A misc note, on the SBPro the music will be in stereo, channels 1,3,5, and 7
  376.   will be played on the left and channels 2,4,6, and 8 will be played on the
  377.   right.
  378.  
  379.  
  380.  
  381. 4-A. Patterns.
  382.  
  383.   Patterns are a basic unit of music in this composer. They are groups of 64
  384.   notes on all 8 channels. Patterns make it easier to work on your music and
  385.   to repeat certain parts of it in playback. The largest part of the screen is
  386.   dedicated to editing patterns. On the lower half of the screen, you can see
  387.   32 rows of a pattern at a time. The numbers on the left are the row numbers
  388.   within the pattern.
  389.  
  390. 4-A-1. Pattern tempo
  391.  
  392.   Each pattern has its own individual basic tempo, that is a tempo that the
  393.   notes in the pattern will be played at. This basic tempo is displayed in the
  394.   bottom status bar for the pattern youre currently editing. It is also
  395.   displayed in the order list for each pattern in this list. The tempo can be
  396.   changed in the pattern itself if necessary through a special command
  397.   (special commands will be explained later). You can increase and decrease
  398.   the basic tempo of the pattern youre editing by pressing 7 and 1 on the
  399.   numeric keypad. Lower values are faster, higher is slower.
  400.  
  401. 4-A-2. Order list.
  402.  
  403.   The order list is the order in which the patterns of a music will be played.
  404.   It is displayed in the upper right corner of the screen. There are 3 columns
  405.   of numbers. The first column contains the order numbers, when setting the
  406.   loop for a song, refer to this number. The second column are the actual
  407.   pattern numbers to be played. The third column are the tempos for their
  408.   respective patterns (the second column). You can edit the patterns and the
  409.   tempos by moving to this section of the screen with F3, the pressing either
  410.   [, or ] to edit the pattern number and tempo for that pattern. For example,
  411.   if the list looks something like this:
  412.  
  413.     00 00 4
  414.     01 02 4
  415.     02 01 3
  416.     03 01 3
  417.     04 03 4
  418.     05 04 3
  419.     06 ∙∙ ∙
  420.     07 ∙∙ ∙
  421.  
  422.   In playback, pattern 0 will be played first at its tempo of 4. Then pattern
  423.   2 at its tempo of 4, then pattern 1 will be played twice at its tempo of 3,
  424.   then pattern 3, then finally pattern 4. After pattern 4 is played, the song
  425.   wil loop back to order number 0 and start over. You can specify what order
  426.   the song loop will loop to by specifying the Loop value in the middle stat
  427.   group, you do this by pressing ALT-F9.
  428.  
  429. 4-A-3. Pattern breaks.
  430.  
  431.   When a pattern is played, normally it is played all the way through from row
  432.   0 to row 3F. But you can specify where a pattern is to be played to by
  433.   setting its break-point to something other than 3F. The break-point is
  434.   displayed in the vertical column to the right of the row numbers of the
  435.   pattern. A -B- in this column indicates the location of the break-point for
  436.   the current pattern. The break point is the last row in the pattern that
  437.   will be played before going on to the next pattern, thus if you set a break
  438.   point at row 0, only row 0 of the pattern will be played whenever the
  439.   pattern is played.
  440.  
  441.  
  442. 4-B. Toggling channels on/off.
  443.  
  444.   You can toggle the 8 channels on and off. The status of the channels is
  445.   displayed right above the pattern edit part of the screen. Normally they are
  446.   all On. But you can shut off any or all of the channels by pressing ALT-1
  447.   through ALT-8, these correspond to channels 1-8. When you toggle a channel
  448.   off, its status light will change from On to Off. Anything that is played
  449.   on a channel that is off will not be heard, including just playing the
  450.   instruments from the keyboard.
  451.  
  452.  
  453. 4-C. Notes
  454.  
  455.   Ok, now for entering the notes. If you load up the demo song, you will see
  456.   a whole bunch of notes and numbers in the pattern edit area. These are the
  457.   notes to be played along with other information like the instrument to use,
  458.   the volume, and any special commands. The notes have the following format:
  459.  
  460.     C 200Fd1
  461.     ├─┘├┘│├┘
  462.     │  │ │This is the special command to apply to the note.
  463.     │  │ │
  464.     │  │ This is the volume at which the note will be played.
  465.     │  │
  466.     │  This is the instrument number to use.
  467.     │
  468.     This is the note to play and the octave to play it on.
  469.  
  470.   You enter notes by moving to the pattern edit screen with F2, then entering
  471.   notes with the keyboard just as you would play them. When you enter a note,
  472.   The note, octave, instrument, and volume will be entered. No special
  473.   commands, you must specifically enter any special commands to be applied to
  474.   the note. After you have entered a note, you may edit the instrument or
  475.   volume to be used by pressing either [ or ] (same keys as in the order edit
  476.   but you are no longer in the order edit, you are in the pattern edit).
  477.   After specifying the new sample or volume number, the current editing values
  478.   for either sample or volume will be set to the value you just entered. You
  479.   can also change these values manually by using the keys 8, 2, 5 (on the
  480.   keypad), =, and \. To find out exactly what these keys do check the key list
  481.   in the composer by pressing ?. If you press ` on a note, that notes
  482.   instrument and volume values will be copied to the current editing values.
  483.  
  484.   You do not have to enter a note though, you may enter only a volume, or only
  485.   a special command, or both. If only a volume is specified then the volume
  486.   of the output for that channel will be changed to that value. Thus you can
  487.   set an instrument to slowly fade in by first playing it at a volume of 0,
  488.   then gradually increasing the values like this:
  489.  
  490.     D#3000∙∙ (No special command was specified).
  491.     ∙∙∙∙∙1∙∙ (In the composer the instrument and volume numbers are displayed
  492.     ∙∙∙∙∙2∙∙  in different colors so you dont get confused).
  493.     ∙∙∙∙∙3∙∙
  494.     ∙∙∙∙∙4∙∙ ect...
  495.  
  496.   If the instrument does not loop and it finished playing before the the song
  497.   gets to the other volumes, they will have no effect.
  498.  
  499.  
  500. 4-D. Special commands.
  501.  
  502.   There are six special commands you can enter. To enter a special command hit
  503.   Backspace in the pattern edit screen, enter a letter (a-f) then a number
  504.   (1-F). The first 5 commands alter the way the note will be played, the
  505.   sixth, 'f', changes the tempo in the pattern and has no effect on the note
  506.   being played. All commands except 'c' can be specified as part of a note or
  507.   alone. If they are specified alone, their effect starts where they were
  508.   placed, not when the note was struck. If no instrument is playing on the
  509.   channel where the command was encountered, there will be no effect (except
  510.   for command 'f', it always changes the tempo). The commands continue to
  511.   affect the way the instrument is played untill another note or command
  512.   is encountered in the pattern (an 'f' command will cancel the effects of
  513.   any previous command, but nothing cancels the effect of the 'f' command).
  514.   The format of the commands is c#, where c is the command and # is the
  515.   command value which is the user defined parameter for how much the command
  516.   will affect the instrument. The commands are:
  517.  
  518.     a - Portamento up - This command will cause the frequency of the note to
  519.          increase over time, the command value indicates how fast the pitch
  520.          will increase. (For those of you who know what this means, the port
  521.          is linear, not logarithmic).
  522.  
  523.     b - Portamento down - Same as 'a' but in the other direction.
  524.  
  525.     c - Port to note - This is the only command that requires there to be a
  526.          note on the same line. This commands sets the note to portamento at
  527.          the speed defined by the command value towards the note on the line.
  528.          The instrument value of the note is ignored, but the volume is set
  529.          to the volume in the note on this line. When the note reaches the
  530.          destination note, the portamento is stopped and it continues playing
  531.          at the destination note frequency.
  532.  
  533.     d - Frequency adjust - This command adjusts the frequency of the note
  534.          currently playing a little bit. This is useful for when you have 2
  535.          notes playing at the same pitch using the same instrument, use this
  536.          command to adjust the frequency of one of the notes to make it sound
  537.          a little more harmonic.
  538.  
  539.     e - Frequency vibrato - This command sets the frequency of the note that
  540.          is playing to vibrate. The command value specifies how much to
  541.          vibrato the note by.
  542.  
  543. Note: A command value of 0 on any of the previous commands cancels the effect
  544.   of any previous command and sets the note to play normally.
  545.  
  546.     f - Set tempo - Usually you will set the tempo for the patterns through
  547.          their basic tempo. But there are times when you may want to change
  548.          the tempo within a pattern. Use this command to do it. The tempo will
  549.          remain at this tempo untill another set tempo command or untill
  550.          another pattern is reached in the order list (even the same pattern
  551.          that is playing now).
  552.  
  553.  
  554. 4-E. Blocks.
  555.  
  556.   When editinig a pattern, there are times when you have to reproduce whole
  557.   blocks of notes. Reentering all the notes would be extremely cumbersome.
  558.   You can do this very quickly in this composer by using the block commands.
  559.   Mark the beginning and ending rows of a block with ALT-B and ALT-E. The
  560.   highlighted section of the info bar (the one where the patter-break resides)
  561.   displays the location of the marked block. The actual block is only defined
  562.   for one channel, the channel in which the cursor is located. Use ALT-L to
  563.   mark the entire channel, this is equivalent to setting the beginning of the
  564.   block at row 0 and the end at row 3F.
  565.  
  566.   You can perform several functions on a block. Pressing ALT-Q increases the
  567.   octave of all the notes in the block, ALT-A decreases the octave. ALT-W and
  568.   ALT-S increase and decrease the notes in the block by a semitone. You can
  569.   set the volume of all the notes in the block to the current editing volume
  570.   by pressing ALT-V, you can do the same to the instrument with ALT-I. You can
  571.   set or delete a special command for all the notes in the block by pressing
  572.   ALT-Backspace or CTRL-Backspace. Pressing ALT-Z will clear everything in the
  573.   block, and ALT-U unmarks the block.
  574.  
  575.   To copy the block press ALT-C. Now you have the block saved in a buffer, you
  576.   can do anything you want to the original data including deleting it.
  577.   Pressing ALT-O copies the contents of the buffer to the row and channel the
  578.   cursor is currently on. If the size (in rows) of the data in the buffer
  579.   exceeds the size that is left between the location of the cursor and the
  580.   end of the pattern, only that much information will be copied, but the
  581.   contents of the buffer will remain unchanged.
  582.  
  583.   For example, if you wanted to copy all the contents of channel 1 in pattern
  584.   0 to channel 3 in pattern 5, you would do the following:
  585.     1) Go to pattern 0 and move the cursor to channel 0.
  586.     2) Hit ALT-L to mark the entire channel.
  587.     3) Hit ALT-C to copy the contents of the marked block to the buffer.
  588.     4) Go to pattern 5 and move the cursor to row 0 and channel 3.
  589.     5) Hit ALT-O to copy the buffer to the pattern.
  590.  
  591.   To copy an entire pattern to another one, press ALT-M. You will be asked
  592.   which pattern to copy to. The contents of the pattern you are editing will
  593.   be copied to the pattern you specify, any data that was in that pattern will
  594.   be destroyed.
  595.  
  596.  
  597.  
  598. 5-A. Playing songs.
  599.  
  600.   To play a song, press F5. This will cause the composer to start playing the
  601.   song that is currently in memory. Technically, playback will start at order
  602.   0 and continue untill a blank is found in the order list, the song will then
  603.   loop to the order specified by Loop. If the order 0 is a blank, no playback
  604.   will be started. While the song is playing you can do anything, including
  605.   editing the song itself, the order list, instruments, colors ect... You can
  606.   even load and save instruments, the config file, and you can save the song.
  607.   If you load a new song however, the playback will be stopped. You cannot
  608.   however play the instruments, if you try, no sound will be generated.
  609.  
  610.   You can start playback at any order you want, provided that there is a
  611.   pattern to play in that order. To do this, move the cursor in the order edit
  612.   screen to the order you want to start playback on and press F7. Playback
  613.   will start at that order. If you do not want to switch to the order edit
  614.   screen, you can use 9 and 6 on the numeric keypad to increase and decrease
  615.   the order. The current location of the cursor is displayed in the bottom
  616.   status bar as Order.
  617.  
  618.   You can also play one pattern individually. Press F6, the pattern played
  619.   will be the one youre currently editing. There does not have to be any valid
  620.   pattern numbers in the order list in order for this command to work, the
  621.   entire list can be blank. The pattern youre editing will be played over and
  622.   over. Again, you can do anything while the pattern is playing, including
  623.   switching to another pattern and editing it.
  624.  
  625.   Pressing F8 causes any playback to stop.
  626.  
  627.  
  628. 5-B. Tracking songs.
  629.  
  630.   If you want to watch a song as its being played, you can use the keys
  631.   ALT-F5, ALT-F6, or ALT-F7 to start playback. These keys work just like the
  632.   same keys without ALT except that the composer will begin to track the music
  633.   as its being played. You will see what notes in that pattern are playing.
  634.   You cannot do everything you can when tracking as you could when just
  635.   playing the song. The only keys that work are ALT-1 through ALT-8, the SBPro
  636.   mixer setting keys, and F5 - F8. Pressing any other key causes you to drop
  637.   out of tracking mode back to regular playback. Pressing F6 during tracking
  638.   however, works a little differently. The pattern that is currently playing
  639.   will be the one to start playing over and over, not the one you may be
  640.   editing.
  641.  
  642.   If you press any one of the tracking keys during normal playback, they will
  643.   merely start tracking the song where it is currently playing, that is the
  644.   song will not be restarted or anything.
  645.  
  646.  
  647. 5-C. Saving and loading songs.
  648.  
  649.   To save or load songs you must have a song directory specified. Press F11
  650.   to load a song. If you have the song directory specified and if there are
  651.   and 669 songs in that directory, you will be presented with a list of them,
  652.   just like when loading an instrument. Select the song you want to load and
  653.   press enter. After it is loaded you can do anything to it, edit, play, ect..
  654.  
  655.   To save a song, you must first specify a song filename. If you loaded a song
  656.   this will be the filename of the song, but if you created it from scratch,
  657.   you will have to enter a filename. Press ALT-F12 to do this, you must
  658.   specify a valid DOS filename and no extention. After you have the filename
  659.   set, press F12 to save the song. Saving the song can only be done in the
  660.   registered version of the composer however. So if you do not have a
  661.   registered version, this composer is basically only a 669 music file player
  662.   for you since you cannot save any songs you have done.
  663.  
  664.   What is saved in the song filename is all the instruments, the song message,
  665.   and any patterns that appear in the order list. This is very important
  666.   because if you create a lot of patterns, and you dont specify them in the
  667.   order list, they will not be saved! Technically, all the patterns below
  668.   and including the numerically highest pattern in the order list will be
  669.   saved. So if you specify only patterns 0 and 3 in the order list, the
  670.   patterns that will be saved are actually 0, 1, 2, and 3.
  671.  
  672. Note: Whenever entering a number or string in the composer, you can press ESC
  673.        to abort.
  674.  
  675.  
  676. 6-A. Misc.
  677.  
  678.   Composer 669 was coded entirely by Tran of Renaissance. It runs in 32bit
  679.   protected mode, using a V86 task to access only the DOS file routines.
  680.   I could not explain all the functions of all the keys in this doc (the
  681.   closest thing is the Key list which is in the file KEYS.TXT). You will
  682.   have to use the composer and experiment for yourself.
  683.  
  684.  
  685. 6-B. Renaissance.
  686.  
  687.   Renaissance is a small group started in December of 1991. We are basically
  688.   a music oriented group, but we do games and demos and stuff. We eventually
  689.   intend to start a software company and do games... A game we did a while ago
  690.   and released as freeware was a big hit here in NY, Kaeon... Like I said,
  691.   we did that game a while ago, our skill has improved greatly since then...
  692.   Our next major release will probably be Kaeon ][. This one should totally
  693.   blow away the first one...
  694.  
  695.   We would have released this composer as freeware also, but we need the
  696.   money. You know, to buy equipment and stuff, and basically for when we do
  697.   start the company legally... And we feel $20 is a fair price... if you dont
  698.   think so, dont register it, its your choice...
  699.  
  700.   You can reach us on our WHQ BBS:
  701.  
  702.     The Sound Barrier (718)979-6629, sysop Daredevil
  703.  
  704.   Our main members are:
  705.     Tran                -       Coder, some muzik and grafix.
  706.     C.C.Catch           -       Great Muzik, ANSI.
  707.     Mosaic              -       Muzik, some grafix.
  708.     Daredevil           -       Distribution, and other misc...
  709.  
  710.   Thanx go out to all those who helped out testing this thing...
  711.  
  712.