home *** CD-ROM | disk | FTP | other *** search
/ Assembly 1994 - The 3rd Phase / ASMROM94.mdf / fc / utils / digiplay / manual.txt < prev    next >
Text File  |  1991-07-20  |  47KB  |  1,225 lines
  1.  
  2.                Advanced DigiPlayer V3.0ß
  3.             
  4.                  User's Guide
  5.                
  6.          Copyright (C) 1991 Sami Tammilehto
  7.          
  8.  
  9.          
  10. -----------------------------------------------------------------------------
  11.  
  12.     HOW TO USE THIS MANUAL
  13.     
  14.     It is suggested that you print this manual and test the
  15.     features described in the manual with the program right away.
  16.     This makes it easier to understand the different functions.
  17.     
  18.     To test    sample editing functions, load a sample by loading
  19.     the program with DOS command line:  DP <sample-file-name>
  20.     
  21.     In this manual the Advanced DigiPlayer is often referred to 
  22.     as ADP.
  23.  
  24. -----------------------------------------------------------------------------
  25.  
  26.     CONTENTS
  27.     
  28. 1     Executing the Advanced DigiPlayer
  29.     1.1    The DP batch file
  30.     1.2    Command line switches (all are non-case-sensitive)
  31.     1.3    Command line filenames
  32.     1.4    Program requirements
  33. 2    Memory usage
  34.     2.1    Virtual memory
  35.     2.2    Disk temporary file
  36. 3    Screen usage
  37.     3.1    Virtual screen technique
  38.     3.2    Pointer
  39.     3.3    Buttons
  40.     3.4    Sample windows
  41.     3.5    Info window
  42.     3.6    File window
  43.     3.7    Pop-up windows
  44. 4    Keyboard/Mouse
  45.     4.1    Mouse
  46.     4.2    Keyboard mouse
  47.     4.3    Global keys
  48.     4.4    Keys in message windows
  49.     4.5    Aborting processes
  50. 5    Sample windows
  51.     5.1    Selecting the current sample window
  52.     5.2    The sample outlook
  53.     5.3    Position indicator
  54.         5.3.1    What is a position indicator?
  55.         5.3.2    Moving sample position indicator
  56.     5.4    Area
  57.         5.4.1    What is an area?
  58.         5.4.2    Selecting an area
  59.     5.5    Loop
  60.         5.5.1    What is a loop?
  61.         5.5.2    Changing a loop
  62.     5.6    Infoline
  63. 6    Playing the sample
  64.     6.1    Selecting a playing mode
  65.     6.2    Selecting a loop mode
  66.     6.3    Select continuing
  67.     6.4    Playing
  68.     6.5    Stopping the sample
  69. 7    Viewing/Marking buttons
  70.     7.1    General
  71.     7.2    Commands
  72. 8    Info window usage
  73.     8.1    Different modes
  74.     8.2    Info window buttons
  75.     8.3    Scope options
  76.     8.4    Vars mode
  77. 9    Editing commands
  78.     9.1    General
  79.     9.2    Clipboard
  80.     9.3    Commands
  81. 10    Special editing commands
  82.     10.1    General
  83.     10.2    Commands
  84.         10.2.1    Commands: Misc.Modify
  85.         10.2.2    Commands: Filters
  86.         10.2.3    Commands: Volume
  87.         10.2.4    Commands: Chords
  88.         10.2.5    Commands: Position
  89.         10.2.6    Commands: Resampling
  90.         10.2.7    Commands: Special
  91. 11    File window
  92.     11.1    General
  93.     11.2    Scrolling the windows
  94.     11.3    Loading a sample
  95.     11.4    Saving a sample
  96.     11.5    Displaying a sample
  97.     11.6    Loading directly to window
  98.     11.7    Adding new empty samples
  99.     11.8    Marking samples in memory
  100.     11.9    Removing a sample
  101.     11.10    Renaming a sample
  102.     11.11    Changing directories
  103. 12    Digitizing
  104.     12.1    General
  105.     12.2    Commands
  106.     12.3    Using the scope
  107.     12.4    Hints for digitizing
  108.     12.5    SoundBlaster's oversampling problems
  109. 13    Options
  110.     13.1    General
  111.     13.2    Switches
  112. 14    SM-Lists
  113.     14.1    General
  114.     14.2    SM-List contents
  115.     14.3    Loading a SM-List
  116.     14.4    SM-List window
  117.     14.5    Commands
  118. 15    Miscellaneous commands
  119.     15.1    General
  120.     15.2    Commands
  121.  
  122. -----------------------------------------------------------------------------
  123.  
  124.  
  125.  
  126. 1.    Executing the Advanced DigiPlayer
  127.  
  128. 1.1    The DP batch file
  129.  
  130.     The ADP is normally executed with a batch file. This batch file
  131.     is called by default DP.BAT. The batch file will then execute
  132.     the actual executable file (DIGIPLAY.EXE) with correct command
  133.     line parameters to specify configuration and other options.
  134.         
  135.     The basic DP.BAT should look something like this:
  136.         DIGIPLAY %1 %2 %3 %4 %5
  137.     Add all the switches between the 'DIGIPLAY' and '%1', 
  138.     for example:
  139.         DIGIPLAY /P1 %1 %2 %3 %4 %5
  140.         
  141. 1.2    Command line switches (all are non-case-sensitive)
  142.     /H    Displays a list of all available options
  143.     /E    Enables the EMS usage. If you have expanded
  144.         memory (EMS) you can tell ADP to use it 
  145.         with this switch
  146.     /F    Force EGA mode. If you have an EGA card
  147.         but the colors are weird etc the ADP may
  148.         have recognized your card to be a VGA
  149.         compatible one. In this case this option
  150.         should help.
  151.     /K    Use keyboard mouse. This switch disables
  152.         a mouse if one is on the system and orders
  153.         ADP to use cursor keys for moving the pointer.
  154.         If no mouse is found, this option is 
  155.         automatically used.
  156.     /C    Use Covox Sound Master II -sound card.
  157.     /D    Debugmode. With this switch the ADP shows
  158.         some information while initializing. This
  159.         may help you to pinpoint where the initialization
  160.         fails (if the machine for example hangs because
  161.         of wrong settings).
  162.     /T    Testmode. Do not check for soundcard. The switch 
  163.         orders the ADP to skip the soundcard presence check. 
  164.         If soundcard is not present and ADP is executed with 
  165.         /T ADP will seem to work properly until you start 
  166.         to play/digitize something. At this point the program
  167.         will work incorrectly or even hang the machine. This
  168.         switch should be used for test purposes only. Avoid 
  169.         it unless you fully understand it.
  170.     /A###    Specifies the address of the sound card
  171.         (consult card manual for details)
  172.     /I#    Specifies the interrupt number of the sound card
  173.         (consult card manual for details)
  174.     /S####    Specifies the default samplerate for ADP.
  175.     /P#    Selects the color set for the screen. 
  176.         Following sets (palettes) are available:
  177.             0 = Gold-Velvet (default)
  178.             1 = Full-Metal
  179.             2 = Cream-Metal
  180.             3 = Wild-Neon! (VGA only)
  181.             4 = Arctic (VGA only)
  182.             5 = Desert (VGA only)
  183.  
  184. 1.3    Command line filenames
  185.  
  186.     You can specify one or more files on the command line.
  187.     For example: DP sample1 sample2 sample3
  188.     The example loads all three samples to the memory
  189.     (%#'es in the batch file will be replaced by DOS with
  190.     the correct filenames. Consult your DOS manual 
  191.     for more information on    passing command line 
  192.     parameters through batch files). First two samples
  193.     are displayed in the two windows while others 
  194.     remain in memory and can be displayed with methods
  195.     described later.
  196.     
  197. 1.4    Program requirements
  198.  
  199.     The Advanced DigiPlayer requires a SoundBlaster-card (from
  200.     Creative Labs, Inc.) or a Sound Master II -card (from Covox
  201.     Inc.) and EGA/VGA compatible display and a hard disk. It also
  202.     supports mouse and EMS (expanded memory) which both make the
  203.     program easier and faster to use. The program also uses the
  204.     hard disk as virtual memory, so the more diskspace you have, 
  205.     the larger samples you can edit.
  206.       ADP practically requires an AT or higher to operate fast
  207.     though it works with a fast PC as well. Mainly when playing/
  208.     digitizing with high speeds or looping small loops may take 
  209.     more processing    power than the PC is able to give. Also using
  210.     the scope will slow down the program. With AT or higher there
  211.     should be no speed problems.
  212.     
  213.  
  214. 2    Memory usage
  215.  
  216. 2.1    Virtual memory
  217.  
  218.     The ADP can handle multiple samples (64 to be exact) with 
  219.     combined size up to 32MB. It uses virtual memory to accomplish
  220.     this. In practice, it means that the ADP uses the harddisk as
  221.     a temporary storage. ADP can also use EMS as virtual memory, 
  222.     and if EMS is enabled (with commandline parameter) it is filled
  223.     first, and the hard disk is used only after EMS is full.
  224.     
  225. 2.2    Disk temporary file
  226.     
  227.     The ADP uses a temporary file DIGIPLAY.TMP on the harddisk. ADP
  228.     removes the file after the program has ended. If the program for
  229.     some reason terminates abnormally, the DIGIPLAY.TMP will remain
  230.     on the harddisk.  Also a number of lost clusters may appear
  231.     (because ADP fails to close the file). You can correct this
  232.     problem by running DOS'es CheckDisk with parameter /F (for fix).
  233.     Thus you type: CHKDSK /f and press enter. This will create some
  234.     files to the root directory with the appendix .CHK.  (the files
  235.     have normally a format FILE####.CHK where #### is a number). You
  236.     can remove these and after this all of the 'lost' diskspace is
  237.     freed.
  238.     
  239.  
  240. 3    Screen usage
  241.  
  242. 3.1    Virtual screen technique
  243.  
  244.     The ADP uses a virtual screen of 640x800 pixels. In practice
  245.     this means that only a part of the screen is displayed at once,
  246.     and the screen can be scrolled by moving the pointer near the
  247.     top or bottom border. Horizontally the entire screen is always
  248.     visible, but vertically you will only see about half of it
  249.     (depending on your display. VGA shows 480 pixels, EGA 350).
  250.     Because of this screen mode, the ADP requires either an IBM VGA
  251.     or IBM EGA compatible display. VGA is