home *** CD-ROM | disk | FTP | other *** search
/ Chip: Special Sound & MIDI / Chip-Special_Sound-und-Midi-auf-dem-PC.bin / dostools / voc386 / voc386.doc < prev    next >
Text File  |  1992-07-19  |  15KB  |  430 lines
  1.  
  2. IMPORTANT:
  3.  
  4. This DOCumentation belongs to Version 1.6
  5. of VOC386. So if you want to get the new printed 
  6. documentation and a registered User of VOC386 
  7. with all the advantages, send $40 to the adress 
  8. at the end of this File.
  9. You may use the ShareWare version up to 14 Days.
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16. VOC386 Version 1.6 Documentation           (C)1991 by Christoph Vaessen
  17. --------------------------------
  18.  -- Please read this manual --
  19.    -- before starting the --
  20.      ---  program !!!  ---
  21.        ---------------
  22.  
  23.  
  24.  
  25.  
  26. VOC386 V1.6 may be copied for free, even if it can stand comparisons
  27. with many or is better than professional programs !!
  28. Because of this fact I hope that many of you'll register 
  29. (for only $40 including shipping costs, it's a bargain !) for this 
  30. program and recieve a speed-optimized-copy of all maior future-updates 
  31. for free! But last not least, your name will be put in each DOC-File of 
  32. VOC386. The more people register the program, the more time can be
  33. invested in developing and de-bugging VOC386 !!
  34. My adress and account-number is written at the end of this textfile.
  35. NOTE: There is a german version of VOC386 avaliable, contact me
  36. when you need one...
  37. If you are equipped with a modem, you can always get the latest version
  38. of VOC386 in the 
  39. * ENIGMA-BBS (+49-6151-424596,1200-14400bps,HST,V42b)
  40.   FIDO 2:243/700 (MAGIC-filename is VOC386 for german version)
  41. * ADLATUS-BBS (+49-6258-6183,1200-14400bps,HST-DS,V32,V32b,V42,V42b)
  42.   FIDO 2:243/44 
  43. The english version is avaliable as 'VOC3EN??.*', the german as 'VOC386??.*'.
  44. The two questionmarks can be replaced with the version-number of VOC386
  45. (e.g., V1.5 is VOC38615.ARJ).
  46.  
  47.  
  48. System-requ.:
  49. ^^^^^^^^^^^^^
  50. * minimal:
  51.   - 80386SX/16MHz
  52.   - 1 MByte RAM
  53.   - Harddisk
  54.   - SoundBlaster-card
  55.   - 8bit VGA-Card with 256kByte Video-RAM
  56.   - 2-button mouse with VGA-compatible mouse-driver loaded
  57.  
  58. * suggested:
  59.   - 80386DX/25MHz
  60.   - 4 Mbyte RAM
  61.   - a fast Harddisk with at least 3 MByte free-space
  62.   - SoundBlaster-card
  63.   - 16bit or 32bit VGA-Card with 256 or 512kByte Video-RAM
  64.   - 3-button mouse with VGA-compatible mouse-driver loaded
  65.   - MF-II (enhanced) keyboard with F11 and F12
  66.   
  67.  
  68.  
  69. I hope that nobody got a shock when reading the hardware-reqs. above ;-)
  70. But I feel angry about many programs (like DOS...:-)) that don't
  71. use the enhanced capabilities of high-end hardware like 386/486 PCs,
  72. VGA-display, 3-button-mouse or the SoundBlaster-card.
  73. As a conclusion of this, my program makes an attempt of using the
  74. 32bit hardware to their full possibilities, so it cannot run
  75. on any PC without 32bit CPU like 80286,80186 or 8086/8088.
  76. Therefore, your system must be equipped with a 80386 or 80486 CPU,
  77. a SoundBlaster-card, Video Graphics Array (VGA), a mouse with it's 
  78. driver loaded (nevertheless nearly all functions can be accessed with
  79. the keyboard!) and it should have 1 MB of RAM to avoid
  80. harddrive-swapping !
  81.  
  82. VOC386 makes it possible for you to load,record or replay VOC-files
  83. (or sample-files without a specific format) in multivarious ways !
  84. It works in the protected mode of the 386/486 and is by that capable 
  85. of using the hole extended memory linear and in 32bit-mode,so
  86. that many operations can be executed very fast.
  87. Since version 1.6 VOC386 is capable of handling QEMM386/EMM/HIMEM
  88. and 386MAX protected-mode interfaces (VCPI and the VDISK/HIMEM-method).
  89. The windows-3 interface won't work with VOC386, perhapes in a 
  90. later version....
  91. Take care of enough extended memory,XMS or EMS (from QEMM etc !)
  92. being left free for VOC386 and that disk-cache-software, ramdrives etc.
  93. don't use too much !
  94.  
  95. Before starting the program the first time you'll have to edit a
  96. file named 'VOC386.INI' that is similar to SSTOOLS.INI from FractINT etc.
  97. The following information MUST be given in VOC386.INI:
  98. (e.g., it'll refuse to run without these parameters).
  99.  
  100. EditSize= xxx
  101. BufferSize= yyy
  102. FileMask= zzz
  103.  
  104. at which xxx is the memory (in bytes) that VOC386 uses for the direct
  105. editing of samples (e.g., you can't generate a larger sample or load
  106. a larger file than xxx bytes).
  107. yyy must be replaced with the number of bytes that will be avaliable to
  108. the cut-buffer (e.g., you can't cut out, replace, insert or mix a part
  109. of the sample at a time in the edit-buffer that is greater than yyy bytes).
  110. The amount of memory allocated by VOC386 can be calculated with the 
  111. following formula:
  112. xxx+yyy+150000   (an approximate value, however!).
  113.  
  114. It is of no importance how much memory is avaliable to DOS and how
  115. much is extended, because VOC386 switches in the protected mode
  116. and can, as mentioned above, access the hole computer-memory
  117. linear with 32bit adresses.
  118. If you have specified a larger value in VOC386.INI with EditSize and 
  119. BufferSize than RAM avaliable, VOC386 will attempt to use your
  120. harddisk to swap out unused parts of program or sample-data.
  121. This can be very slow when much data is beeing moved, so I'd suggest
  122. that you should reduce the values in VOC386.INI as long as your PC will
  123. swap out when starting VOC386 !
  124. Maximum RAM that can be used by VOC386:  128MegaByte 
  125. Maximum Harddisk space that can be used: 128MegaByte 
  126.  
  127. The meaning of zzz is the filemask that is used the first time when VOC386
  128. has been launched. This can be a simple mask (e.g. '*.VOC' [default]) but
  129. it can also consist of a path-information like 'd:\sound\samples\f*.snd' etc.
  130. This mask can easily be modified in the program itself, of course !
  131. The following parameters in VOC386.INI are optional (e.g., you can delete
  132. them if you don't need them):
  133.  
  134. Repeat= yes/no
  135. TimeDisplay= yes/no
  136. SoundOutput= yes/no
  137. Oszi= big/small/no
  138.  
  139. These parameters can also be changed when the program is running, 
  140. but you can specify the default-values in VOC386.INI.
  141.  
  142. 'Repeat=yes' means that all samples which will be played
  143. will repeat after they reached the end until you stop them via
  144. the left control-key.
  145.  
  146. 'TimeDisplay= yes' means that all sample-length information given 
  147. in the program will be displayed in "minutes:seconds" this sample(part)
  148. would be played with the actual sampling-rate.
  149.  
  150. 'SoundOutput=yes' means that the sound-output of the
  151. SoundBlaster remains on while digitizing or when the oszillograph 
  152. is active (only for volume-adjusting purposes).
  153.  
  154. 'Oszi=big' means, that a big (filling the upper part of the screen !)
  155. oscilloscop will be shown when digitizing or playing samples.
  156. 'Oszi=small' means, that a small oscilloscop in the lower right 
  157. corner of the screen will be shown.
  158. `Oszi=off' is self-explaining...
  159.  
  160.  
  161. If you recieve the VOC3861?.EXE-archiv, VOC386.INI should
  162. look like the following:
  163.  
  164. [VOC386 V1.6]
  165.  
  166. FileMask= *.voc
  167. EditSize= 500000
  168. BufferSize= 100000
  169. Repeat= no
  170. TimeDisplay= yes
  171. SoundOutput= no
  172. Oszi=small
  173.  
  174. A system starting VOC386 with these parameters should have
  175. a minimum of 750kbyte free memory avaliable !!
  176. If your PC has more RAM, increase the value EditSize and BufferSize 
  177. corresponding to your free-memory...
  178.  
  179. The following is a description of each function avaliable in
  180. VOC386 version 1.6:
  181.  
  182.  
  183.  
  184. IMPORTANT: When any of the following functions is activated with
  185.        the right mouse-button, this funktion will work on
  186.        the hole used edit-buffer. When called with the left
  187.        button, it'll work with the (red) marked part of
  188.        the edit-buffer. If pressed with a middle-button, 
  189.        it will use the actually shown part of the edit-buffer.
  190.        When using the keyboard (the corresponding keys are shown
  191.        in brackets), pressing the key without SHIFT will work
  192.        with the marked part. Pressing a key while holding down
  193.        the SHIFT-Key it will work on the hole used edit-buffer.
  194.     
  195.  
  196.  
  197.  
  198. [F10/SHIFT F10]
  199. Load:        Loads a sample-file from disk or harddisk. This file can
  200.         be '*.VOC' (Creative Voice Format) or without any format.
  201.         You will see the filemask (default can be set in 
  202.         VOC386.INI, s.a.) that you can edit with cursor-keys
  203.         and backspace. After pressing ENTER all matching files
  204.         will be displayed. Now you can select one file with the 
  205.         cursor up/down and PageUp/PageDown-keys or switch back to
  206.         the filemask with the TAB-key. If only one file matches the
  207.         filemask, it is loaded immediately.
  208.         When called with left mouse-button (or F10), the file
  209.         is loaded at the position where the marking starts; 
  210.         when called by the right mouse-button (SHIFT-F10)
  211.         the edit-buffer is cleared and the file is loaded 
  212.         at the beginning of the edit-buffer.
  213.         There is a demosample-file included in the archiv,
  214.         so try TECNOMIX.VOC ... ;-)
  215.  
  216. [F9/SHIFT F9]
  217. Save:        Similar to 'load', but a file will be saved in VOC-format.
  218.         Clicking the left mouse-button (F9), the marked part of
  219.         the Edit-buffer is saved. Clicking the right m-button
  220.         saves the whole used part of the edit-buffer.
  221.         With the middle mouse-button, the actual viewed part of
  222.         the edit-buffer is saved.
  223.  
  224.  
  225. [TAB/SHIFT-TAB]
  226. Digitize:    Sound is digitized and the scope is used if enabled. 
  227.         Called by the left m-button (TAB) digitizes only in 
  228.         the marked area, called by the right m-button digitizes 
  229.         from the beginning of the edit-buffer to its end. 
  230.         This process can be aboarded with the left CTRL-key.
  231.  
  232. [b/B]
  233. Time/Size:    Here you can switch the display at the right-side of the
  234.         screen from time-display in minutes:seconds to size-display
  235.         in byte-format. The time-value shows how long this
  236.         sample will play with the current samplerate.
  237.         The default-setting can be adjusted in the VOC386.INI-file,s.a.
  238.  
  239. [X]
  240. show all:    Shows (zoom out) the whole edit-buffer on the screen.
  241.  
  242.  
  243. [F1]
  244. Help:        Shows 3 help-pages [only avaliable in the German version !]
  245.  
  246.  
  247. [Q]
  248. Quit:           Exit VOC386 immediately, without any warning !!
  249.  
  250.  
  251.  
  252. [F6/SHIFT-F6]
  253. Cut:        Copies the marked area in the Cut-Buffer when called
  254.         by the left m-button (F6). Clicked by the left
  255.         m-button (SHIFT-F10), the marked area will also be 
  256.         removed from the edit-buffer and copied in the Cut-Buffer.
  257.  
  258. [F7/SHIFT-F7]
  259. Insert:        If called by the left mouse-button (F7), the samples
  260.         in the Cut-Buffer is inserted at the beginning of
  261.         the marking. Clicked by the right m-button (SHIFT-F7), 
  262.         the contens of the CutBuffer is mixed to the samples
  263.         from the beginning of the marking.
  264.  
  265. [F8]
  266. Replace:    The contens of the CutBuffer overwrites (!!) the
  267.         samples after the beginning of the marking. 
  268.  
  269.  
  270. [ENTER/SPACE]
  271. Play:        The marked part (left m-button or ENTER) or the whole used
  272.         part of the edit-buffer (right m-button or SPACE) is
  273.         played and the scope is shown when enabled.
  274.         This process can be aboarded with the left CTRL-key.
  275.  
  276.  
  277. [BackSpace]
  278. Play Buffer:    The contens of the CutBuffer is played with 
  279.         scope when enabled.
  280.  
  281.  
  282. [Crsr left/CTRL-Crsr left]
  283. Speed +:    The sample-rate (unit: Hz) is increased by 100
  284.         (left m-button of Crsr-left) or 1000 (right m-button 
  285.         or CTRL-Crsr-left).
  286.         The maximum sample-rate for digitizing with the SoundBlaster
  287.         is 11 kHz, for playing sounds it depends on the computer-
  288.         performence (a 25MHz/386/64cache/16bit-VGA should do up to
  289.         30KHz).
  290.  
  291.  
  292. [Crsr right/CTRL-Crsr right]
  293. Speed -:    The sample-rate decreases by 100 (left m-button
  294.         or Crsr-right) or 1000) right m-button or CTRL-Crsr-right).
  295.  
  296. [F5]
  297. Repeat on/off:    'Repeat on' means, that when playing sounds the program
  298.         repeats it until you press the left CTRL-key.
  299.         The actual setting is underlined.
  300.          A default-value can be set in VOC386.INI, s.a.
  301.  
  302. [l/L]
  303. Erase:        The (selected) sample is set to silence, but
  304.         it won't be removed or cut-off !
  305.         For (re)moving parts of the edit-buffer, refer to
  306.         the 'Cut'-function (s.a.).
  307.  
  308. [y]
  309. Zoom in:    The marked part will be enlarged on the screen, if it is
  310.         more than 640byte. 
  311.  
  312.  
  313. [x/X/CTRL-X]
  314. Zoom out:    If called by the left m-button (x), the last zoom-view
  315.         is shown; by right m-button (SHIFT-x) the whole 
  316.         used (!) part of the edit-buffer is shown. 
  317.         Clicked by the middle m-button (CTRL-x), the whole
  318.         edit-buffer is displayed, even the unused ones !
  319.         (this is equal to the function 'Zoom all').
  320.         
  321. [4/SHIFT-4]
  322. Soft:        The volume of the marked/used part will be decreased.
  323.  
  324. [5/SHIFT-5]
  325. Loud:        The volume of the marked/used part will be increased.
  326.  
  327.  
  328. [F11/SHIFT-F11]
  329. slow down:    The marked/used part of the edit-buffer is slowed
  330.         down. (This requieres deleting the CutBuffer !).
  331.  
  332. [F12/SHIFT-F12]
  333. speed up:    The speed of the marked/used part of the edit-buffer
  334.         is made faster.
  335.  
  336. [h/H]
  337. Highpass:    Performes a highpass (make low sounds softer). A 
  338.         pass-value from 1 to 9 is asked for, ESC aboards.
  339.  
  340. [t/T]
  341. Lowpass:    Performes a lowpass (make high sounds softer). A pass-value
  342.         from 1 to 9 is asked for, ESC aboards.
  343.  
  344. [F2/F3/F4]
  345. Oszi:        (at the lower right corner of the screen)
  346.         At every mouse-click the scope-setting
  347.         is switched from small [F2] to big [F3] to off [F4] and 
  348.         again to small.
  349.         The default-value can be set in the VOC386.INI-file, s.a.
  350.  
  351. [m/M]
  352. max-Volume:    The volume of the marked/used part is set to the
  353.         maximum.
  354.  
  355. [e/E]
  356. Fade in:    The volume of the marked/used part is set linear from
  357.         zero (silence) to full.
  358.  
  359. [a/A]
  360. Fade out:    The volume of the marked/used part is set linear from
  361.         full to zero (silence).
  362.  
  363. [r/R]
  364. Reverse:    The used/marked part is reverted (sounds like playing a
  365.         tape backwards).
  366.  
  367. [2/SHIFT-2]
  368. resound:    The used/marked part sounds like speaking in a 
  369.         big empty room. (this function was designed for voices).
  370.  
  371.  
  372. [1/SHIFT-1]
  373. Echo:        The used/marked part sounds like spoken in
  374.         a big canyon or valley. A value from 1 to 9 
  375.         is asked for, the higher this value is, the longer
  376.         the echo-delay will be. (this function was designed 
  377.         for voices)        
  378.  
  379. [s/S]
  380. Sound on/off:    With this feature the sound-output (while the scope or
  381.         the digitizer is active) can be set on or off (left/right 
  382.         m-button). The default-value can be set in the VOC386.INI
  383.         File, s.a.
  384.  
  385. [z/Z]
  386. trim silence:    This features enables you to convert a noisy background
  387.         to silence. The program asks for a value between 1-9;
  388.         the higher this value, the more periods will be converted
  389.         to silence. (this function was designed for voices)
  390.  
  391. [u/U]
  392. Enh. high:    All high sounds in the marked/used part will be enhanced.
  393.         The requested value means, what height is necessary to 
  394.         enhance the sound.        
  395.  
  396.  
  397. [c/C]
  398. PC <> Amiga:    The samples in the marked/used part are converted into
  399.         the Amiga-sampleformat, if they are in PC-format and 
  400.         vice versa. This can be used for importing sounds from 
  401.         SoundTracker-files (*.MOD/NST/STM etc...).
  402.  
  403. [Home]:        This function cannot be activated by mouse. It
  404.         sets actual the sampling-rate to 11kHz.
  405.  
  406.  
  407. In case of questions, proposals for improvment and registrations
  408. ($40, s.b.) I am at your disposal.
  409.  
  410. Address:
  411. Christoph Vaessen
  412. Mozartstr. 4
  413. 6104 Seeheim
  414. FR Germany
  415. BBS line 1: 06257-86308
  416. BBS line 2: 06257-85546
  417. FIDO 2:2405/11
  418.  
  419.  
  420. If you want to register, please send a check to my adress
  421. or remittance to my account in Frankfurt, Germany:
  422.  
  423. Christoph Vaessen
  424. Account-No.:  2917 20-606 
  425. Bank: Postgiroamt Frankfurt a.M. 
  426. Bank-Code: BLZ 500 100 60
  427.  
  428.  
  429. Thank you in advance!
  430.