home *** CD-ROM | disk | FTP | other *** search
/ Audio Version 4.94 / audioversion4.94knowledgemediaresourcelibraryoctober1994.iso / msdos / music / compsd13 / composd.doc < prev    next >
Text File  |  1992-12-04  |  36KB  |  703 lines

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