home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / CP15.ZIP / CP.DOC < prev    next >
Encoding:
Text File  |  1995-10-08  |  36.6 KB  |  1,002 lines

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