home *** CD-ROM | disk | FTP | other *** search
/ Millennium Time Capsule / AC2000.BIN / disks / ac9_disk / n_play31 / doc / n_player.txt < prev    next >
Encoding:
Text File  |  1998-03-08  |  7.8 KB  |  265 lines
  1. --------------------------------------------------------------
  2.  
  3.                       NED Player v3.1
  4.                       ~~~~~~~~~~~~~~~
  5.                        (c) 1996-1998
  6.  
  7.                    written by Petr Sumbera
  8.                 (xsumbe00@stud.fee.vutbr.cz)
  9.                 
  10.                        (March 8 1998)
  11.  
  12.     This version is specially for ATARI COMPUTING magazine.
  13.  
  14. --------------------------------------------------------------
  15.  
  16.   TABLE OF CONTENTS
  17.   -----------------
  18.  
  19.   1.  What is NED Player?
  20.   2.  Files in archive
  21.   3.  Features
  22.   4.  File formats (*)
  23.   5.  Flags
  24.   6.  Keyboard commands
  25.   7.  Info file (n_player.inf)
  26.   8.  Memory
  27.   9.  Direct from disk playing 
  28.   10. Shell parameters
  29.   11. RSC files
  30.   12. FALCON version (*)
  31.   13. Thank to
  32.   14. Program availability (*)
  33.   15. Contact address (*)
  34.   
  35.   Note: (*) means update from the last version
  36.  
  37.  
  38. -(1)-What is NED Player---------------------------------------
  39.  
  40. Simple sample player for ATARI STE/TT/FALCON. It can 
  41. change smooth frequency from 6 to 25 kHz (SW MODE).  
  42. And it automatically recognize some sound formats
  43. (SAM, DVS, SND/AU, WAV, AVR, HSN, AIF, IFF).
  44.  
  45. This version of NED PLAYER is SHAREWARE!!! Please read file
  46. SHAREWAR.TXT.
  47.  
  48.  
  49. -(2)-Files in archive-----------------------------------------
  50.  
  51. N_PLAYER.APP    = main program
  52. N_PLAY_H.RSC    = RSC file one (for bigger resolution)
  53. N_PLAY_L.RSC    = RSC file two (for smaller resolution) 
  54.  
  55. DOC\N_PLAYER.TXT   = this file
  56.    \HISTORY.TXT    = something about history
  57.    \FUTURE.TXT     = future plans
  58.    \SHAREWAR.TXT   = important information :)
  59.    \N_PLAYER.INF   = example of info file
  60.  
  61. SOURCE\N_AV_SER.C  = you can use it in your programs
  62.  
  63. CYBER\ORDER_FM.TXT = CyberSTrider's informations
  64.      \SUPPORT.TXT  
  65.      
  66.          
  67. -(3)-Features-------------------------------------------------
  68.  
  69. - It runs as ACC or PRG
  70. - You can use Drag & Drop
  71. - MultiTOS compatible
  72. - SW MODE (smooth frequency change from 6 to 25 kHz)
  73. - Automatic file format recognize
  74. - Keyboard commands
  75. - Shell parameters
  76. - AV protocol
  77. - ability to play 16 bit files
  78. - Microsoft ADPCM and DVI/IMA ADPCM (WAV)
  79. - Fast RAM support
  80. - Direct from disk playing
  81. - Sample file informations
  82.  
  83.  
  84. -(4)-File formats---------------------------------------------
  85.  
  86. It recognizes and plays this sound formats:
  87.  
  88. - AVR (ATARI)
  89. - WAV (PC)
  90. - HSN (ATARI 'CrazySounds')
  91. - SAM (ATARI 'STOS Maestro')
  92. - AIFF (Mac, ATARI (Cubase))
  93. - DVSM (ATARI Falcon 'WinRec')
  94. - SND, AU (Sun, Mac, NeXT)
  95. - IFF, SVX (Amiga)
  96.  
  97.     data storage              |   format type
  98.   -----------------------------------------------
  99.     8/16 bits linear - PCM    |      
  100.     8 bits mu-law             |   WAV, SND/AU
  101.     8 bits A-law              |   WAV, SND/AU
  102.     4 bits Microsoft ADPCM    |   WAV
  103.     4 bits DVI ADPCM          |   WAV
  104.     8 bits delta pack         |   DVSM
  105.   
  106.  
  107. Note:
  108.  
  109. 1) If you press LOAD with CONTROL, it will load file
  110.    as normal binary data.
  111. 2) NED Player can decode 4-bits mono DVI ADPCM files only.
  112.  
  113.  
  114. -(5)-Flags----------------------------------------------------
  115.  
  116. Flags are letters that can appear behind the name of
  117. file. It is for information.
  118.  
  119. D  - direct from disk playing mode
  120. H  - only part of file is loaded (not enough memory)
  121. F  - sample is situated in FAST RAM (see memory section)
  122. 16 - it will play in 16 bits mode [FALCON VERSION ONLY]
  123.  
  124.  
  125. -(6)-Keyboard commands----------------------------------------
  126.  
  127.  CONTROL-Q  as APP quit
  128.             as ACC close window
  129.  
  130.  [P]  PLAY  (also RETURN)
  131.  [L]  LOAD
  132.  [S]  STOP   
  133.  [I]  (?) informations
  134.  
  135.  
  136. -(7)-Info file (n_player.inf)---------------------------------
  137.  
  138. This file must be in the same directory as the main program.
  139.  
  140. name "..."      - registration name and key
  141. key  "..."        (see SHAREWAR.TXT)
  142. playonce        - set to playonce mode
  143. dfdbig          - set direct from disk only for big files
  144. dfd             - set direct from disk for all files
  145.  
  146.  
  147. -(8)-Memory---------------------------------------------------
  148.  
  149. NED Player should be runing in ST RAM. Not in Fast RAM. There
  150. is no ability to play by DMA sound. 
  151.                      
  152. From version 2.8 NED Player use Fast RAM for sound data 
  153. (If no free space in ST RAM). If has been sound data situated
  154. in Fast RAM, you will see flag "F" behind the name of file.
  155. In this case you will not be able to use clasical "HW MODE"
  156. (6, 12, 25, 50 kHz).
  157.  
  158. Note: If you have MAGNUM RAM (FALCON with FX card ?) you will
  159. be probably able to use all playing modes and you will be also
  160. able to run NED Player from it.
  161.  
  162.  
  163. -(9)-Direct from disk playing---------------------------------
  164.  
  165. From version 3.0 NED PLAYER can play sound data directly from
  166. disk. I mean mainly from harddisk and CD ROM. But you can
  167. use others. For example I have tested flopy disk on FALCON.
  168. Maximum speed was 9 kHz. I am also using HDD_DMN for mapping
  169. my PC's logical disks through parallel port (For speed between
  170. my 8 MHz STE and PC is about 30 kB/s I can play 25 kHz sound
  171. files).
  172.  
  173. For using direct from disk you should set it up. Press on
  174. informatory button [?] or press [I] and switch to the required
  175. mode:
  176.  
  177. NEVER  - NED PLAYER will play all samples from memory
  178. BIG    - if it is not enough memroy It will play directly from
  179.          disk
  180. ALWAYS - all files will be played directly from disk
  181.  
  182. If NED PLAYER is playing directly from disk it uses 50 kB of
  183. memory. If it is stoped it uses 0 bytes of memory.
  184.  
  185. Direct from disk is written for multitasking use. I recommend
  186. to you test it. Run NED PLAYER as ACC or in multitasking
  187. environment and try to work with others applications. It works!
  188. But sometimes it is stopped. And it can caused others troubles.
  189. But I think it is cool enough, isn't it.
  190.  
  191. You can also set playing mode (NEVER/BIG/ALWAYS) in INF
  192. file or from the command line.
  193.  
  194.   
  195. -(10)-Shell parameters----------------------------------------
  196.  
  197.  N_PLAYER.GTP [-po] [filename]
  198.            [-w]  [filename]
  199.  
  200.  p - it will try automatic play
  201.  o - set to PLAY ONCE mode
  202.  
  203.  w - no window
  204.      set to PLAY ONCE mode
  205.      start play
  206.      (you will have to wait to the end of sample)
  207.  
  208.  1 - direct form disk playing for big files 
  209.  2 - direct from disk for all files
  210.  
  211. Note: N_PLAYER.TTP -w [filename] should works too.
  212.  
  213.          
  214. -(11)-RSC files-----------------------------------------------
  215.  
  216. RSC files of version 3.x are not compatible with previous from
  217. version 2.x. On my page are also available 3D RSC files.
  218. (In this time only for version 2.x. For version 3.x it will be
  219. soon)
  220.  
  221.  
  222. -(12)-Falcon version------------------------------------------
  223.  
  224. FALCON version is developed together with the normal version.
  225. It supports the 16 bits sound system. But it no means that
  226. the FALCON's owners can't use the normal version.
  227.  
  228. FALCON version is distributed in separate package. There is
  229. executable program only. Others files you need, you have to
  230. use from the clasical distribution (N_PLAYxx.LZH).
  231.  
  232. In this time is available 2.A FALCON ALFA only.
  233. Version 3.1 FALCON will be out soon.
  234.  
  235.  
  236. -(13)-Thank to------------------------------------------------
  237.  
  238. - EMPTY HEAD for his help with Falcon debugging,
  239. - FUFIN for his advice about GEM dialog in window.
  240. - Claude Labelle for converting RSC files to 3D interface
  241.   (these files are available on my WWW site [v2.x])
  242.   
  243.       
  244. -(14)-Program availability------------------------------------
  245.  
  246. http://www.stud.fee.vutbr.cz/~xsumbe00 
  247.  
  248. This site is weekly mirrored on this address:
  249.  
  250. http://www.sumbera.cyberstrider.org
  251.  
  252.  
  253. -(15)-Contact address-----------------------------------------
  254.  
  255. Send suggestions, criticism, comments, bug reports to:
  256.  
  257. Petr Sumbera
  258.  
  259. Post:  ul. 24. dubna 283, Zelesice, 664 43, Czech republic
  260. Email: xsumbe00@stud.fee.vutbr.cz
  261.        (sumbera@cyberstrider.org)
  262. FIDO:  2:421/16.14
  263.  
  264. If you want to me continu in programming NED PLAYER, please
  265. let me know.