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