home *** CD-ROM | disk | FTP | other *** search
/ The Games Machine 6 / XENIATGM06.ISO / cubic / cp.doc < prev    next >
Text File  |  1995-05-29  |  34KB  |  923 lines

  1.        
  2.        ▄▄▄▄▄▄▄▄   ▄▄▄    ▄▄▄   ▄▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄▄
  3.      ▄▀        █ █   █  █   █ █        ▀▄ █        █ ▄▀        █
  4.      █  ▄▀▀▀▀▀▀  █   █  █   █ █  ▄▀▀▀▄  █  ▀▀▄  ▄▀▀  █  ▄▀▀▀▀▀▀
  5.      █  █        █   █  █   █ █   ▀▀▀ ▄▀     █  █    █  █
  6.      █  █        █   █  █   █ █   ▄▄▄ ▀▄     █  █    █  █
  7.      █  ▀▄▄▄▄▄▄  █   ▀▄▄▀   █ █  ▀▄▄▄▀  █  ▄▄▀  ▀▄▄  █  ▀▄▄▄▄▄▄
  8.      ▀▄        █ ▀▄        ▄▀ █        ▄▀ █        █ ▀▄        █
  9.        ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀
  10.  
  11.                                ·P·L·A·Y·E·R·
  12.  
  13.                                    v 1.0
  14.  
  15.                              "simply the best!"
  16.  
  17.  
  18.    Table of contents
  19.    ==================
  20.    1......................................Introduction
  21.    
  22.    2......................................Using Cubic Player
  23.      2.1..................................General Keys
  24.      2.2..................................Modes and Related Keys
  25.      2.3..................................File Selector
  26.      2.4..................................Command Line Options
  27.    
  28.    3......................................Special Features
  29.      3.1..................................Surrround Sound
  30.      3.2..................................Midi Usage
  31.      3.3..................................Cubic Player and OS/2
  32.      3.4..................................Intelligent Memory Multiplying (IMM)
  33.      3.5..................................Coprocessor
  34.    
  35.    4......................................Notes, Bugs etc.
  36.    
  37.    5......................................Information on Cubic Player
  38.    
  39.    6......................................Greets, Credits
  40.      6.1..................................Adresses
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48. =============================================================================
  49.  
  50.        Attention ! Read the following BEFORE using Cubic Player.
  51.     
  52. =============================================================================        
  53.  
  54.     This material  is  not  freeware.  You  are  allowed to 
  55.     copy it  without  restrictions for non-commercial  use.
  56.     No payment  of any kind may be charged for this product 
  57.     or  any combination of products  or services  including 
  58.     this  product  without our  authorization  and official 
  59.     written  license.  Commercial use,  especially the 
  60.     industrial manufacturing on any  data storage media and 
  61.     their  distribution  without  the expressed  permission 
  62.     of  the producer, is strictly prohibited.  This program 
  63.     or the data files contained therein may  not be altered 
  64.     or modified without the permission of the author.
  65.     You  take full responsibility for the operation of this 
  66.     software and any consequences thereof.  We the creators 
  67.     cannot accept liability for damages or failures arising 
  68.     from the use of this software.
  69.  
  70. =============================================================================
  71.  
  72.  
  73.    1: Introduction
  74.    ================
  75.  
  76.       Cubic Player (CP) is a music player which plays a variety of
  77.       sound formats on several sound cards.
  78.       The player supports the following sound cards:
  79.        -Gravis UltraSound / 16bit daughterboard
  80.        -SoundBlaster / Pro / 16 & compatibles
  81.        -WSS compatible cards / UltraSound MAX
  82.        -Quiet Player =)
  83.       and the following music formats:
  84.        MOD/NST/WOW, XM, S3M, DMF, MTM, ULT, 669, OKT and MIDI.
  85.       If you encounter any problems with this product NOT mentioned
  86.       in the text, feel free to contact us. (adresses listed below).
  87.  
  88.       And in case you wanted to run the player under Microsoft Windows 3.x
  89.       we'll tell you RIGHT HERE that this is NOT possible!
  90.       It seems to work ok with WINDOWS '95. (not tested by us)
  91.       This player does support OS/2 v3. See section 5.3 on this.
  92.  
  93.  
  94.  
  95.    2: Using Cubic Player
  96.    ======================
  97.  
  98.       Take your time to read this chapter, or you'll miss some of
  99.       the advanced options of Cubic Player...
  100.  
  101.       You can simply start the player without command line options [and
  102.       filenames], the player will try to detect your sound device and start
  103.       playing the specified files.
  104.       If you have not specified any files, you will enter the fileselector
  105.       and can select a list of files of your choice.
  106.       After that you'll most probably find yourself in the instruments
  107.       screen.
  108.  
  109.  
  110.    2.1: General Keys:
  111.    -------------------
  112.  
  113.       these keys are valid throughout the player. (not in the fileselector)
  114.  
  115.       2.1.1: Very very general keys...
  116.       ---------------------------------
  117.  
  118.        F1 / ? / H   : Online HELP
  119.               scroll with pgup and pgdn or ctrl-pgup/dn.
  120.               if the Help window :) is too small press z
  121.  
  122.        return       : next module
  123.  
  124.        p            : II / =>   (pause and play)  have fun... ;)
  125.        ctrl-p       : this is a faster version of pause...
  126.  
  127.        d            : advanced dos-shell!
  128.        ctrl-d       : less advaned dos-shell... (no top line patching)
  129.  
  130.        f            : fileselector (see. 2.3 for usage)
  131.  
  132.        z            : toggle vertical screen size (25/50 lines)
  133.        alt-z        : toggle horizontal screen size (80/132 rows)
  134.        ctrl-z       : toggle vertical screen size (25/30 lines)
  135.  
  136.            esc esc      : the taboo keys... :)
  137.                quite useless feature, I think
  138.  
  139.  
  140.       2.1.2: Module Specific Keys
  141.       ----------------------------
  142.  
  143.     with these keys you can walk around in the song,
  144.     you have to press ctrl for all of them.
  145.  
  146.        ctrl-right   : go to next pattern
  147.        ctrl-left    : go to previous pattern
  148.        ctrl-up      : go 8 rows up in current pattern (rewind)
  149.        ctrl-down    : go 8 rows down in current pattern (forward)
  150.        ctrl-home    : restart the current song
  151.  
  152.  
  153.       2.1.3: Channel Options
  154.       -----------------------
  155.     The channels are displayed in all textmodes. In the graphic modes
  156.     there is a small box with the channel to let you know which channels
  157.     are active at the moment and which channel is selected.
  158.     There are 3 channel display modes toggled by c:
  159.       -no display: does exactly what it implies.
  160.       -small channels: shows from left to right:
  161.         instrument number, note, volume, effect and volume bars
  162.       -big channels: shows from left to right:
  163.         instrument name, note, note effect, volume, volume effect,
  164.         panning, panning effect, effect (written) and volume bars
  165.  
  166.     If a note is struck it will be cyan for the current row.
  167.     The note, volume and panning effects are described in 2.2.2.2.2
  168.  
  169.     2.1.3.1: Channel Keys
  170.     ----------------------
  171.  
  172.        c            : changes the size of the channel display
  173.  
  174.        left / right : go to previous / next channel
  175.        up   / down  : go to prev / next channel with wrap-around
  176.        q            : toggle currently selected channel
  177.        s            : solo channel
  178.        1 2 3 .. 0   : goto and toggle channel 1 .. 10
  179.        ctrl-1 .. 0  : goto and solo channel   1 .. 10
  180.        ctrl-q/ctrl-s: turn on all channels
  181.  
  182.  
  183.       2.1.4: Volume Options
  184.       ----------------------
  185.  
  186.     these keys are for volume, stereo fx, speed etc.
  187.     they are arranged like the 2nd line on the screen for easy usage.
  188.  
  189.        F2 F3        : dec/inc the master volume
  190.         + -         : this lets you adjust the m.vol. more precisely
  191.  
  192.        ctrl-F2/F3   : dec/inc the amplification level,
  193.               this takes a little bit of time on sb, so be careful
  194.               (We won't take responsibility for your ears..)
  195.  
  196.        F4           : toggle surround (only stereo and Sound Blaster)
  197.               flips one channel, makes the sound surround you...
  198.               a nice options for headphones or if you have 
  199.               4 speakers installed, (you can find a description 
  200.               of how to set them up below) and even if you don't.
  201.               You will only hear it if some of the output is
  202.               equal on both channels... (combine it with panning)
  203.               does not work on a GUS of course!
  204.  
  205.        F5 F6        : slide panning. panning shifts the sound to
  206.               the middle or exchanges the channels with each other
  207.  
  208.               if you use headphones, set the panning to somewhere
  209.               in between middle and full. it will sound much much
  210.               much much better!!!
  211.         , .         : finer panning
  212.  
  213.        F7 F8        : slide balance
  214.         / *         : fine balance
  215.  
  216.        F9  F10      : dec/inc playback speed (see ctrl-F12)
  217.        F11 F12      : dec/inc pitch (see ctrl-F12)
  218.  
  219.        ctrl-F12     : toggle speed and pitch lock.
  220.               if on, a change in speed also will affect the pitch
  221.                 and vice versa
  222.  
  223.        backspace    : toggle the amazing 32-bit-fast-fourier-interpolation
  224.               (SB only !)
  225.  
  226.        ct-backspace : change filter, pretty useless with high sampling
  227.               rates... 3 different filters with increasing effect
  228.               and 32-bit-fast-fourier-interpolation
  229.               (SB only again !)
  230.  
  231.        alt-F2       : save the current values for panning, balance,
  232.               amplification, filter/FFI, pitch etc.
  233.        alt-F3       : load previously saved values
  234.        alt-F4       : load manufactory default settings / reset
  235.  
  236.  
  237.  
  238.  
  239.    2.2: Modes and Related Keys
  240.    ----------------------------
  241.  
  242.       Note: all previously listed keys are still valid in all modes.
  243.  
  244.        h    ?   F1  : Help Mode (should be self-explanatory)
  245.        i            : Instrument Mode (2.2.1)
  246.        m            : View Song Message (MTM/DMF), keys like in help mode
  247.        t            : Pattern View (2.2.2)
  248.        a            : Text Mode Spectrum Analyser (2.2.3)
  249.        g            : Graphic Spectrum Analyer (2.2.4)
  250.        o            : Scopes (2.2.5)
  251.        n            : Note Dots (2.2.6)
  252.        w            : Würfel mode, höhö.. (see yourself)
  253.        x            : EXTENDED MODE... beat it!!!
  254.        e            : Echo Editor (2.2.7)
  255.  
  256.  
  257.       2.2.1: Instrument Mode   <i>
  258.       -----------------------------
  259.     The usual instrument display... a bit more comfortable than others!
  260.  
  261.        tab          : toggle between short and long instruments
  262.        pgup / pgdn  : scroll
  263.        ctrl-pgup/dn : scroll fast
  264.        home         : go home!
  265.        alt-i        : clear instrument used flags... wow!
  266.  
  267.  
  268.       2.2.2: Pattern View   <t>
  269.       --------------------------
  270.  
  271.     it's really simple:
  272.     colors indicate the type of effect:
  273.  
  274.     2.2.2.1: Global Effects
  275.     ------------------------
  276.        green   speed commands     (tempo, speed)
  277.        red     position commands  (break, goto, patloop, patdelay)
  278.        blue    global vol fx      (set glob vol, glob vol slide)
  279.  
  280.     2.2.2.2: Channel Effects
  281.     -------------------------
  282.        white   instrument effect  (set instrument, play note, etc.)
  283.        green   pitch effect       (porta, vibrato, arpeggio, etc.)
  284.        blue    volume effect      (set volume, volslide, tremolo, etc.)
  285.        purple  panning effect     (set panning, panning slide)
  286.        red     note effect        (cut note, delay note, etc.)
  287.  
  288.     the symbols/letters indicate the effect, the values are given in hex
  289.     volumes: 00-FF in contrast to volumes in most module formats (00-40)
  290.     panning: 00-FF from full left to full right
  291.     first instrument is 00 not 01.
  292.  
  293.     2.2.2.2.1: Global Effects
  294.     --------------------------
  295.        green   t??       tempo, the number of ticks per row
  296.            s??       speed, the number of ticks per time
  297.        red     down??    break pattern and start next one in row ??
  298.            right??   goto pattern
  299.            pl?       pattern loop: 0 set label, others: loop ? times
  300.            pd?       delay pattern for ?*tempo ticks
  301.        blue    v??       set global volume
  302.            up??      global volume slide up
  303.            down??    global volume slide down
  304.            updown00  continue last global volume slide
  305.  
  306.     2.2.2.2.2: channel effects
  307.     --------------------------
  308.        white   i??       set instrument
  309.            C-4...    play note C, octave 4
  310.            off       key off (XM only)
  311.            right??   set envelope position (XM only)
  312.        green   C-4...    set porta to note note         (porta to note)
  313.            up??      pitch slide up   00: cont      (porta up)
  314.            down??    pitch slide down 00: cont      (porta down)
  315.            +??       row pitch slide up             (finetune)
  316.            -??       row pitch slide down           (finetune)
  317.            note??    pitch slide to note 00: cont   (porta to note)
  318.            ~??       vibrato
  319.            ~right?   vibrato set speed
  320.            ~=?       vibrato set waveform
  321.            ≡??       arpeggio
  322.        blue    v??       set volume
  323.            up??      volume slide up
  324.            down??    volume slide down
  325.            +??       row volume slide up            (finevol)
  326.            -??       row volume slide down          (finevol)
  327.            ~??       tremolo
  328.            ~=?       set tremolo waveform
  329.            ⌐??       tremor, does anyone use it?
  330.        purple  p??       set panning
  331.            right??   panning slide right
  332.            left??    panning slide left
  333.            >face<    enable surroud sound for channel (see below)
  334.        red     d??       delay, delays anything, usually notes
  335.            !!??      retrigger
  336.            right??   sample offset
  337.            ^??       note cut
  338.  
  339.     2.2.2.3: Keys in Pattern View
  340.     ------------------------------
  341.  
  342.          space  : toggle auto / manual mode
  343.       ctrl-pgup/dn  : scroll instruments
  344.           home  : set optimum mode for current module
  345.  
  346.            auto mode:
  347.        pgup / pgdn  : change number of channels: 32,24,16,8,4
  348.            tab  : toggle mode (fx on/off etc)
  349.  
  350.          manual mode:
  351.        pgup / pgdn  : move through patterns
  352.        [shift]-tab  : change # of channels, mode
  353.  
  354.  
  355.       2.2.3: Text Mode Spectrum Analyser   <a>
  356.       -----------------------------------------
  357.     On faster computers the spectrum analyser can look a bit dirty.
  358.     This is because the player does not wait for a refresh when displaying.
  359.     A decay speed is not yet included.
  360.  
  361.        a / alt-F5   : toggle channel mode (all/current)
  362.       ctrl-pgup/dn  : scroll instruments
  363.        pgup / pgdn  : change visible frequency range
  364.        home         : set maximum freq to approximately 3000Hz
  365.  
  366.  
  367.       2.2.4: Graphic Spectrum Analyser   <g>
  368.       ---------------------------------------
  369.     That kind of stripes that are used in voice recognition...
  370.     Watch the vibratos!!! wow.. that's cool..
  371.       have a look at guitarsl.mod, armani.s3m and space.mod
  372.  
  373.        g / alt-F3   : toggle channel mode:
  374.                 - both output channels
  375.                 - mixed output channels
  376.                 - currently selected channel only
  377.        alt-g        : toggle between fast and fine mode
  378.        pgup / pgdn  : change visible frequency range
  379.        home         : set maximum frequency to approximately 3000 Hz
  380.        tab ctrl-tab : change scale / palette
  381.        
  382.        NEW: shift-g : The Big-GSA !!!! on amazing 1024x768 resolution
  383.               (we wish you a Pentium for this mode :-)
  384.  
  385.  
  386.       2.2.5: Scopes   <o>
  387.       --------------------
  388.  
  389.     Just simple oscilloscopes for all or one channel
  390.     The background piccy needs an extra 250k of memory, if you don't have
  391.     that much you can disable the picture with a command line option.
  392.  
  393.        o alt-F2     : toggle mode (single/all channels)
  394.        alt-o        : toggle trigger, starts the output on a
  395.               polarity change
  396.        pgup / pgdn  : stretch scopes
  397.  
  398.  
  399.       2.2.6: Note Dots <n>
  400.       ---------------------
  401.  
  402.     They really look cool, because they use the real frequency and
  403.     the real volume...
  404.  
  405.        n            : toggle between dots, bars, stereo cones and
  406.               stereo dots !
  407.  
  408.  
  409.       2.2.7: Echo Editor <e>
  410.       -----------------------
  411.  
  412.     Yeah, now it's here. The ultimate Echo Online Editor you have
  413.     long waitet for. Create your own Echos with 8 or 16bit quality and
  414.     up to 8 different generators. Or simply pick one of the predefined
  415.     Echos and enjoy your tunes with the glorious sound of Cathedral II.
  416.     (Echos are only available on SB and GUS MAX/WSS)
  417.  
  418.     Selector Keys
  419.     --------------
  420.  
  421.        enter        : use the currently selected echo
  422.  
  423.        ctrl-up/down : move the echo in list
  424.        ctrl-del     : delete echo from list
  425.        ctrl-ins     : store the echo from the editor at the current
  426.               position and save the echo list.
  427.  
  428.        tab          : jump to editor copying the current echo
  429.  
  430.        esc          : leave echo selector / editor returning to cp
  431.  
  432.     Editor Keys / Usage
  433.     --------------------
  434.  
  435.       At first you have to select how many Operators your echo should
  436.       have in the field OPNUM. Up to 8 Operators are possible.
  437.       Then you should define the maximum delay in 0.1 ms. This will have
  438.           an effect on the memory requierements of the echo. Then the general
  439.       feedback FB should be set. The higher the value the more often the
  440.       echo signal is passed in the generator (the louder and stronger the
  441.       echo will appear).
  442.       Now type in the delay of the Operators in 0.1 ms and their feedback
  443.       volume (volumes can be negative, that means the samples will be
  444.       player reversed).
  445.       At last you can choose a name and 8 or 16bit mixing (of course
  446.       16bit mixing takes more resources, but especially with modules
  447.       above 16 channels or MIDIs 8bit mixing does not work anymore,
  448.       you have to choose 16bit mixing (this has technical reasons))
  449.           You can also slide the values by pressing pgup/dn
  450.  
  451.       If you have created interesting and new echos or any comments
  452.       the the echo function feel free to contact us!
  453.  
  454.  
  455.  
  456.    2.3: FileSelector   <f> <ins>
  457.    ------------------------------
  458.  
  459.       An easy way to search and play your favourite modules
  460.  
  461.       At first it scans the current directory for modules (files with
  462.       the extension .MOD .S3M .XM, .MID...) and lets you select
  463.       files. While you do this, it scans the modules for the titles
  464.       and number of voices. This can be very slow on disks and CDs and you
  465.       can stop it by pressing ctrl-backspace. If you've found a nice module
  466.       you can either play it now by pressing return or put it in the
  467.       playlist with -> or ins. There is also a quickfind feature: Simply
  468.       type the name of the module and the fileselector will go to the
  469.       file. (You don't need to complete the name or type it correctly,
  470.       it will take the name that is most similar to the typed name)
  471.       When you have finished the playlist, hit esc. Remember: return plays
  472.       the currently selected module.
  473.  
  474.       2.3.1: Keys for Fileselector
  475.  
  476.        up, down,
  477.        pgup, pgdn,
  478.        home, end    : the usual stuff...
  479.  
  480.        abc123...    : quickfind
  481.  
  482.        return       : play selected module RIGHT NOW!
  483.        esc          : leave fileselector, don't interrupt current mod
  484.  
  485.        ins    ->    : add mod to list      (both windows)
  486.        del    <-    : remove mod from list (both windows)
  487.  
  488.        ctrl-left,
  489.        ctrl-ins     : add all mod in current directory to list
  490.        ctrl-right,
  491.        ctrl-del     : clear playlist
  492.  
  493.        tab          : toggle "window"
  494.  
  495.        ctrl-up, down: move mod in playlist
  496.        pgup, pgdn,  :  (my god, why do i do this?? no one will ever use
  497.        home, end    :   this feature...)
  498.  
  499.        ctrl-backspc : stop reading module info
  500.        alt-s        : if ctrl-backspace does not work
  501.  
  502.        alt-z        : toggle 25/50 lines mode
  503.        alt-o        : toggle scramble playlist order (shuffle play)
  504.               randomly picks the next module from the playlist
  505.                 (hint for ?hook: x means on, o off...)
  506.        alt-r        : toggle remove from list
  507.               if on removes mods from list when played,
  508.               if off puts mods to end of list when played =>
  509.                  endless play
  510.        alt-l        : toggle loop module flag
  511.                 if off you sometimes hear the first note after
  512.                 the loop... well not really good, but easy to
  513.                 program :]  wait for v1.0 or later...
  514.                 this does not affect MIDs at the moment, they
  515.                 will be looped either way.
  516.        alt-a        : scan archives
  517.        alt-m        : load old modules
  518.        alt-t        : MOD: command Fxx is always tempo change.
  519.        ctrl-k       : kill the selected file. (also works in archives)
  520.  
  521.  
  522.    2.4: Command Line
  523.    ------------------
  524.  
  525.     At the command line you can specify the modules you wish to play.
  526.     This works very much like the dos DIR command, e.g. type
  527.       cp d:\mods\guitarsl
  528.       cp \mods
  529.       cp \mods\.xm
  530.       cp .
  531.       cp c:
  532.  
  533.     You can also give a playlist: cp @d:\mods\favorite.lst
  534.     (playlists can be nested, though this feature has not yet
  535.      been tested extensively)
  536.  
  537.     if you have not specified any modules or none of them could be found
  538.     cp will start up with the file selector.
  539.  
  540.  
  541.       2.4.1: Usage of Command Line Options etc.
  542.       ------------------------------------------
  543.  
  544.     The command line options are arranged in groups:
  545.        -h[n]:  view help screen #n
  546.        -c:  2.4.2: Sound Device Specific Switches
  547.        -v:  2.4.3: Volume Specific Switches
  548.        -w:  2.4.4: Screen Specific Switches
  549.        -l:  2.4.5: Playlist Specific Switches
  550.        -m:  2.4.6: Midi Switches
  551.  
  552.     You can use switches everywhere in the command line, you can
  553.     also set default values with the environment variables CP in the 
  554.     file CP.CFG in CP.EXE's path.
  555.     The format is always the same, all switches begin with - or /
  556.     Switches of the same group can be put together separated by a ,
  557.     (no whitespaces in between!):
  558.       -cb -cc0 == -cb,c0
  559.  
  560.       -h            : This is a pretty good feature if you don't know
  561.       -?            : all the switches by heart
  562.  
  563.       2.4.2: Sound Device Specific Switches
  564.       --------------------------------------
  565.       -c...
  566.         c??         : sounddevice  
  567.                 0  : quiet
  568.                 1  : sb 1.x
  569.                 2  : sb 2.x
  570.                 3  : sbpro
  571.                 4  : sb 16 (asp)
  572.                 10 : gus
  573.                 20 : Windows Sound System WSS,
  574.                  GUS + 16bit daughterboard
  575.                 21 : GUS MAC CODEC
  576.               ATTENTION ! ALL GUS IRQs MUST BE BELOW 8
  577.         p???        : port in hex
  578.         i??         : irq in dec
  579.         d?          : dma
  580.         e?          : 16 bit dma for sb16
  581.         r?????      : sampling rate in Hz or kHz
  582.         b[-]        : bypass mode [off], bypasses the detect/check
  583.               routines, make sure to set all parameters correctly!
  584.         m           : mono
  585.         s           : ______, fill in the gap!
  586.         8           : -E-I-G-H-T- bit
  587.         16          : -_-_-X-T-_-_-N bit, hint: two of the missing
  588.                             letters are equal
  589.         l[+]        : small buffer, if you think the sound output is too
  590.               much behind. this could cause trouble on slower
  591.               systems, mods with many channels or if echo is
  592.               enabled
  593.         g[+]        : slow gus upload: if cp hangs when loading mods.
  594.  
  595.  
  596.       2.4.3: Volume Specific Switches
  597.       --------------------------------
  598.       -v...
  599.         v??       : master volume: 0%..100%, default 100%
  600.         a???      : amplify: 0%..400%, default 100%
  601.         p???      : panning: -100%..+100%, default 100%
  602.         b???      : balance: -100%..+100%, default 0%
  603.         s[-]      : surround sound [off]
  604.         f?        : lowpass filter 0..4 -
  605.                 0 : none
  606.                 1 : very soft
  607.                 2 : soft
  608.                 3 : effective
  609.                 4 : 32-bit-fast-fourier-interpolation
  610.  
  611.       2.4.4: Screen Specific Switches
  612.       --------------------------------
  613.       -w...
  614.         c[+/-]      : channels: short, +:long, -:none
  615.         zxx         : text mode: 0: 80x25, 1: 80x30, 2: 80x50, 3: 80x60
  616.                      4:132x25, 5:132x30, 6:132x50, 7:132x60
  617.         cxx         : channel display type xx:
  618.               0:none, 1:short, 2:long, 3:side
  619.         ixx         : instrument display type xx:
  620.               0:none, 1:short, 2:long, 3:side
  621.         a[-]        : turn spectrum analyser on [off]
  622.         t[-]        : turn pattern view on [off]
  623.         x           : display very much! (extended mode)
  624.         sx          : startup screen x: o/g/i/a/t/w  (see 2.2)
  625.         p[+]        : don't [do] load scope background picture
  626.               [requires 200k mem]
  627.  
  628.       2.4.5: Playlist / Module Loader Specific Switches
  629.       ----------------------------------
  630.       -l...
  631.         l[+]        : don't [do] loop modules
  632.         o[-]        : don't [do] scramble playlist order
  633.         r[-]        : [don't] remove mods from list if played
  634.         a[+]        : don't [do] scan archives
  635.         n[+]        : don't [do] scan module names
  636.         m           : [don't] read MODs without a signature
  637.         t           : the f***in' calming the Sodomist down feature:
  638.               makes the MOD loader ignore BPM changes when 
  639.               reading the first MOD.
  640.  
  641.       2.4.6: Midi Switches
  642.       ---------------------
  643.       -m...
  644.         cnn         : use nn channels for midi output
  645.         ppath       : path of the gus-patches
  646.  
  647.       2.4.7: Misc
  648.       ------------
  649.       -pentium      : fixes the division bug on the pentium
  650.  
  651.  
  652.  
  653.  
  654.    3: Special Features
  655.    ====================
  656.  
  657.    3.1: Surround Sound
  658.    --------------------
  659.  
  660.    This sounds pretty nice if you have a stereo non-wavetable soundcard.
  661.    Just buy 1,2 or 3 additional speakers, connect them as showed below
  662.    and press F5 twice and F4 in Cubic Player.
  663.    (don't try this with the GUS driver, this is a Sound Blaster only Mode !)
  664.  
  665.                Stereo
  666.         + L -           - R +
  667.            +-+ +-+         +-+ +-+
  668.            +-+ +-+         +-+ +-+
  669.         I   I           I   I
  670.         I   I           I   I
  671.        +----+   +-----+-----+   +-----+
  672.        I    I         I         I     I
  673.        I    I         I         I     I
  674.        I    I         -         I     I
  675.        I    I     M-Speaker     I     I
  676.        I    I         +         I     I
  677.        I    I         I         I     I
  678.        I    +   - ----+---- -   +     I
  679.        I  L-Speaker        R-Speaker  I
  680.        I                              I
  681.        I                              I
  682.        +---+  +-------------+  +------+
  683.            I  I             I  I
  684.            +  -             -  +
  685.          S1-Speaker      S2-Speaker
  686.  
  687.        Thanks to Micheal Erdmann for this diagram.
  688.        (we cannot be made liable for burning equipment, etc.)
  689.  
  690.  
  691.  
  692.    3.2: Midi usage
  693.    ----------------
  694.  
  695.    You have to have the GUS patches for midi support. If you haven't got a
  696.    GUS you can find them on many BBSs, they usually come as "GUS-drivers"
  697.    and are about 5-6 disks big. GUS users can skip the following part.
  698.    (hey, don't mess around with the default.cfg, this can cause errors,
  699.     if you make changes to the default.cfg, that refuse to work with cp,
  700.     make a copy of the original one and call it cpmidi.cfg)
  701.    After installing them into any directory, add the following statement
  702.    to cp.cfg:  (if there is no cp.cfg yet, create it in the cp directory)
  703.  
  704.     -mpPATH    where PATH is the directory of your gus-patches.
  705.  
  706.    In midi mode, some options are disabled and some will look different.
  707.    (not all midi effects are processed at the moment, so if you've got
  708.    information on midis or the gus patches, contact us!)
  709.  
  710.  
  711.    3.3: Cubic Player and OS/2
  712.    ---------------------------
  713.  
  714.    Yes, Cubic Player works with OS/2 v3. Simply create a Program-Object
  715.    from the Template-Folder. Select DOS-Fullscreen from the Session-Settings
  716.    (NO, it does NOT run in a window.) Make sure to put DOS4GW.EXE as the
  717.    executable and CP.EXE as parameter. Cubic Player should now work with the
  718.    standard DOS-Settings.
  719.    If your soundcard is not detected properly, specify it manually in your
  720.    cp.cfg (See section 2.4 on this).
  721.    Now you have the ONLY Multi-format player that works well with OS/2!
  722.    There may be a small clicks or interruptions during task-switching,
  723.    but hey, thats OS/2...!
  724.  
  725.    another thing... running CP with OS/2 may cause random disk writes... :]
  726.  
  727.  
  728.    3.4: Intelligent Memory Multiplying (IMM)
  729.    ---------------------------------------
  730.    What is Memory Multiplying? Well, that's exactly what it tells you. It
  731.    can increase the amount of GUS-memory when playing large modules or
  732.    MIDIs with many patches.
  733.    CUBIC-Player can make up to 8MB out of 1MB of GUS-Ram, so there 
  734.    shouldn't be any problem with loading large modules.
  735.    IMM is enabled automatically when playing on a GUS and low of GUS-RAM.
  736.    There is no way of disabling it, because otherwise your modules wouldn't
  737.    be played correctly (there're just samples missing :-)
  738.    What it does? The first step is to look if any 16bit samples exist.
  739.    These are converted to 8bit samples, because the quality loss between
  740.    8 and 16bit is almost neglictable (If you only have ONE intrument at
  741.    moderate volume 8bit are enough, not for a complete audio track
  742.    such as on CD of course). If the samples now don't fit into GUS-RAM
  743.    CP tries to crunch the lowest sample. So your HiHats and other
  744.    instruments that requiere high sampling rates should survive the process
  745.    of crunching sample data.
  746.    Other GUS-Player just crunch EVERY sample, not CP. We test after every
  747.    attempt to crunch if the tune does now fit into your GUS.
  748.    You'll here the difference!
  749.  
  750.  
  751.    3.5: Use of Co-Processor
  752.    -------------------------
  753.    You can disable the use of your Co-Processor with the -cf+ switch.
  754.    [default setting is Co-Processor enabled]
  755.    Co-Processor is only used for Fast-Fourier-Calculations, that means
  756.    all modes where spectrum analyser appear (text and graphic modes).
  757.    Normally the integer calculations are faster (386-486). But we don't
  758.    know for fast Pentiums, because of their new Co-Processor unit. If you
  759.    are the lucky owner of a Pentium try for yourself.
  760.  
  761.  
  762.  
  763.  
  764.    4: Notes, bugs, etc.
  765.    =====================
  766.  
  767.    4.1: Notes on the Implementation of the Formats
  768.    ------------------------------------------------
  769.  
  770.      MOD: old mods without header will not be played anymore!
  771.      XM: -Older XMs do not load. (claustr2.xm, shelter.xm), because that
  772.       format is completely different and will not be supported.
  773.       (unless I get a description...) Rewrite them with ft2!
  774.       Does anyone know exactly how to handle the auto vibrato effect?
  775.  
  776.  
  777.    4.2: Known Bugs
  778.    ----------------
  779.  
  780.     - midis are not played 100% correctly all the time..
  781.       (docs, docs, docs, please! (but not the standard ones))
  782.     - the first-note-after-a-loop in no-loops-mode bug
  783.     - If you press the <pause> key, the player may stop playing.
  784.       We could remove this bug, but then there will be another bug...
  785.       some keystrokes will be missed... hmm, there sure is another way... :)
  786.     - my GUS does not work :-(
  787.       OK, we know, that's because CP can't handle IRQs greater than 7.
  788.       (Apparantly that's not our fault but DOS4GW's. The DOS Extender does
  789.        not pass IRQs above 7 from real mode correctly) As Every GUS owns a
  790.       second IRQ, that is normaly set to IRQ5 in 95% GUSes do work. If you
  791.       have set your second (or MIDI) GUS IRQ to above 7 CP will take 2 or
  792.       more seconds longer to load all the modules and will most probably
  793.       stop playing after a few seconds). You can solve this by changing your
  794.       SET ULTRASOUND=port,dma1,dma2,irq1,irq2 commmand in the autoexec.bat
  795.       to any free IRQ below 8.
  796.     -the IMM may convert very quiet and high pitched samples too early
  797.  
  798.  
  799.    4.3: Future Enhancements
  800.    -------------------------
  801.     -better fileselector (cache file, etc..)
  802.     -Pro Audio Spectrum support (no more messages, please! :)
  803.  
  804.  
  805.   5: Information on Cubic Player
  806.   ===============================
  807.  
  808.     The player was started somewhere in 1993, (was it?) using Borland C++ 3.1
  809.     and TASM 3.1, and was used in VEX-intro, which was presented at the
  810.     Assembly '94. That version was still quite buggy, but the bugs did not
  811.     appear in the VEX-tune... In late September '94 I got Watcom C++ v10 and
  812.     transformed the sources to Watcom's C++ implementaton. Then the player
  813.     was given a user interface, which was worked out in the following
  814.     three months. The playback quality was also improved, so you now have
  815.     one of the best and fastest module players. It is especially fast
  816.     (that's what my speed test program told me, a simple loop per time count
  817.     program, no tricks) with multi channel modules that use panning, faster
  818.     than any other players I know of.
  819.     This is quite astonishing, since less than 5% of the player was coded in
  820.     assembler, the rest in C/C++. (600k source in C++, 15k source in ASM,
  821.     10k assembler object code, the rest in C/C++, takes 10 min to compile ;)
  822.     Cubic Player uses Rational Systems' DOS4G DOS extender, so the player
  823.     can use all (or 16M at maximum) your extended / expanded memory.
  824.  
  825.  
  826.  
  827.  
  828.    6: Greets, Credits
  829.    ===================
  830.  
  831.       thanks go to:
  832.       --------------
  833.     Glenn & Marc Moore / Sound Solutions
  834.     Jens Uwe Rumstich / Green Apple
  835.     Scholar / $EEN
  836.     Matthias Beilicke
  837.     Iron Eagle / TC
  838.     Abyss / FC
  839.     SS.C
  840.  
  841.  
  842.       for ß-testing:
  843.       ---------------
  844.     the Sodomist
  845.     Scholar / $EEN
  846.     Green Apple
  847.     Zomb
  848.     Shadow Dancer
  849.     Encounter
  850.     the Frontier
  851.  
  852.  
  853.       messages:
  854.       ----------
  855.     everybody: x-posure's songs want to be played with cp, so get them
  856.            at Zomb's Musicbox!!! -> distlist
  857.            DJ Enjoy's XMs are c00l! (but do not play them with
  858.              ***-****!)
  859.     Simon Kissel: clean your area from all those suckers! :)
  860.     Cosmic: so sorry for you and your bbs, but i was faster!
  861.  
  862.       greets:
  863.       --------
  864.     THE COEXiSTENCE
  865.     Green Apple
  866.     Future Crew
  867.     Legend Design
  868.     K.L.F.
  869.     Cascada
  870.     X-Posure
  871.  
  872.     Libertine / TC
  873.     Jinx! / TC
  874.     AVATAR / LD
  875.     Zodiak / Cascada
  876.     SiPiYou for newer DMF docs...
  877.     Christophe Yvon
  878.  
  879.         Chaos, Pole & Garlick
  880.     Michael Erdmann
  881.  
  882.  
  883.  
  884.   6.1: Adresses
  885.   --------------
  886.  
  887.     SNAILMAIL:
  888.       Niklas Beisert  (pascal)
  889.       Oberstraße 84
  890.       20149 Hamburg
  891.       Germany
  892.  
  893.     INTERNET:
  894.       bertolt.meyer@hamburg.netsurf.de
  895.  
  896.     FiDO-NET: (Oh man, FiDO-Deutschland ist ja sooo scheisse!)
  897.       Niklas Beisert, 2:240/5121
  898.  
  899.     SUPPORT BBS:
  900.    +---------------------------------------+
  901.    |     MEDIA BBS,  5.2 GB online         |
  902.    |                                       |
  903.    |   +49-40-677 95 53 [16.8 ZyXEL]       |
  904.    |      FIDO: 2:240/5121                 |
  905.    |      SFX: 747:49/4002                 |
  906.    |      WOS: 46:4920/110                 |
  907.    |      OA-NET: 123:4003/23              |
  908.    |   +49-40-675 38 78 [28.8 V.Fast]      |
  909.    |      FIDO: 2:240/5122                 |
  910.    |      SFX: 747:49/4001                 |
  911.    |                                       |
  912.    | with a special menu for cubic player  |
  913.    +---------------------------------------+
  914.  
  915.  
  916.  
  917.        Have fun with CUBIC-Player...
  918.  
  919.  
  920.                 pascal / doj / ?hook
  921.  
  922. PS: please vote for VEX-Intro on the Assembly '94 CD-ROM Voting Card (64k)
  923.