home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 48 / af048b.adf / NPlay / NPlay.doc / NPlay.doc
Text File  |  1993-05-11  |  14KB  |  262 lines
  1.  
  2.                                                                        
  3.          #####  ####  #########   ####        ########   ####    ####  
  4.          ###### ####  ####  ####  ####       ####  ####   ####  ####   
  5.          ###########  ####  ####  ####       ####  ####    ########    
  6.          ###########  ####  ####  ####       ####  ####     ######     
  7.          #### ######  #########   ####       ##########      ####      
  8.          ####  #####  ####        ####       ####  ####      ####      
  9.          ####   ####  ####        #########  ####  ####      ####      
  10.                                                                        
  11.  
  12.                                  version 2.01
  13.                               by Petter E. Stokke
  14.  
  15.  
  16.                                                                 
  17.                         ###  #   #      #  ##### #   #          
  18.                        #   # ## ##     #   #     ## ##          
  19.                        ##### # # #    #    ####  # # #          
  20.                        #   # #   #   #     #     #   #          
  21.                        #   # #   #  #      #     #   #          
  22.                                                                 
  23.                       AMIGA MUSICIANS FREEWARE MAGAZINE         
  24.                                                                 
  25.  
  26.                             !! COPYRIGHT NOTICE !!
  27.  
  28.                                                       
  29.                           PROGRAM: NPLAY v2.01        
  30.                           AUTHOR : Petter E. Stokke   
  31.                           DATE   : 15 Dec 1992        
  32.                                                       
  33.  
  34.             This  program  is copyrighted AM/FM.  The program, its
  35.             documentation  and  all  belonging  files  may only be
  36.             copied  under  the  conditions of AM/FM, i.e.  with an
  37.             original  AM/FM  disk label on the disk.  No person or
  38.             company  is allowed to sell this product, not even for
  39.             a  small  fee  for disk and/or postage.  Further, this
  40.             program may not be used on magazine cover disks or any
  41.             other compilation disks without permission from AM/FM.
  43.                           This product is Freeware.
  44.              It may be copied as long as  NO  money changes hand.
  46.             P.D.  Distributors:  To distribute AM/FM products, you
  47.             must  pay  a  royalty  to  AM/FM, in form of buying an
  48.             original  AM/FM disk label and putting one of these on
  49.             every  AM/FM  product/disk  you sell.  Get in touch at
  50.             the address below:
  51.  
  52.     AM/FM - c/o Bjørn A. Lynne - Schleppegrellsgt. 10 - 0556 Oslo - Norway
  53.  
  54.                                      ***
  55.  
  56.  
  57.                            NPLAY 2.01 - WHAT'S NEW?
  58.  
  59. For  simplicity's sake, and for those of you who've already been using v2.0
  60. for  some  time,  I'll  start the manual with summing up the two additional
  61. features I've included in version 2.01 of NPlay.
  62.  
  63. * Full ReqTools v38 support - keyboard shortcuts for ALL gadgets.
  64.  
  65. This  means  you  actually  don't  have  to use the mouse at all, if you so
  66. desire.   I use Quiet mode a lot, and I found that having to move your hand
  67. over to the mouse when leaving Quiet mode to take a look at the instruments
  68. was  too  much  work, so the new features in ReqTools v38 pleased me a lot.
  69. Labour saving forever!
  70.     By  the  way,  once  I got the underscores set up I discovered that the
  71. first  letters  (and  thus  the  hotkeys)  of the five gadgets in the About
  72. requester spell out the word 'MUSIC'!  Completely unintentional!  (Say WOW,
  73. everyone...)
  74.  
  75. * Preferences adjustable from within NPlay.
  76.  
  77. This  is the most powerful feature added to NPlay 2.01.  I've added lots of
  78. features  to  the  NPlay.Config  file,  and a hunky non-ReqTools (for once)
  79. requester  to set the preferences from within NPlay itself.  Note that this
  80. makes  the  Config  file  from NPlay 2.0 obsolete, and you MUST delete this
  81. before  installing  NPlay  2.01, else I'll not be held responsible for what
  82. happens!
  83.     The things you can configure in NPlay 2.01 are as follows:
  84.  
  85. -  Startup  directory.   The directory you loaded the last module from when
  86. saving  the  Config file will be stored as the default directory.  The file
  87. requester will automatically open up in this directory upon starting NPlay.
  88.  
  89. -  Pattern.  NPlay will use this pattern in the filerequester upon opening.
  90. NPlay  will save the pattern you used for the last file requester operation
  91. in the Config file when you choose Save from the Preferences window.
  92.  
  93. And from the Preferences window, you can set:
  94.  
  95. -  Quiet  Mode settings.  These gadgets correspond to the A switches on the
  96. command line.
  97.  
  98. -  Make  NPlayLibs  resident.   These  gadgets  correspond  to either the L
  99. switch, the S switch, or neither.
  100.  
  101. -  Detatch NPlay from CLI.  This corresponds to the D switch.
  102.  
  103. -  Start NPlay in Quiet mode.  This corresponds to the Q switch.
  104.  
  105. Selecting   the  SAVE  gadget  will  write  the  current  settings  to  the
  106. NPlay.Config  file.   If  you  press the USE gadget, the Preferences window
  107. will close without saving the Config file.
  108.     Note  that,  with the exception of the two topmost gadgets, none of the
  109. gadgets  actually  change  anything  in the currently running program, they
  110. will only take effect the next time you start NPlay.
  111.  
  112. NOTE: Command line switches override NPlay.Config settings!
  113.  
  114.  
  115.  
  116.                                  INTRODUCTION
  117.  
  118. Well, who needs another module player anyway?
  119.     I'm  happy  to inform you that NPlay is not just another module player.
  120. NPlay  was  written  with  future expansion and versatility of use in mind.
  121. NPlay  allows  you  to  play any music format you like, and if the original
  122. pack  doesn't  support it, you can stick together a playroutine and have it
  123. play the thing anyway.
  124.     So NPlay is another of those 100 kilobyte jobs, then?
  125.     No.   That's  the  whole  point with NPlay.  It is the user who decides
  126. which  music  formats  he  needs.  NPlay allows you to include just as many
  127. playroutines  as  you  like  - if you only need to play ProTracker modules,
  128. fine,  just  keep  the  ProTracker  library.  If you want to play them all,
  129. that's your choice - just give NPlay the whole works.  It doesn't mind.  It
  130. won't even protest when you pack it down to 8 kilobytes.
  131.     But  the  new  ProTracker uses PowerPacker.library to pack the modules.
  132. These can't be played by NPlay, can they?
  133.     Oh  yes,  they  can.   NPlay uses PowerPacker.library too, and not only
  134. that,  it  also  accepts  modules  packed  with  StoneCracker.  Support for
  135. CrunchMania will also be added in the near future (as soon as I can get any
  136. docs about it).
  137.     But  what  if  I  want  to  play  the music from inside my own programs
  138. instead of through a program?
  139.     Now  here's  the  novelty.  NPlay lets you do it.  You are free to load
  140. the NPlay libraries, which contain the playroutines, into your own programs
  141. and  interface  with  them as you like.  This can be done directly, through
  142. the supplied routines, or through the forthcoming NPlay.Library.
  143.  
  144.                                      USAGE
  145.  
  146. To start NPlay from the CLI, use the following syntax:
  147.  
  148.    NPLAY [Q] [D] [L|S] [a|A] [filename]
  149.  
  150. Q   Start NPlay in Quiet mode
  151. D   Detatch NPlay from the CLI
  152. L   Make all NPlayLibs in the NPlay: directory resident
  153. S   Allows you to select the NPlayLibs, if any, to be made resident
  154. a   Lets you use both mousebuttons in the Quiet mode to end NPlay
  155. A   As above, but all other Quiet mode functions are disabled
  156.  
  157. Note  that  NPlay  does  not accept quotes around the filename.  Once NPlay
  158. finds something on the command line that it does not recognize as a switch,
  159. it  assumes  it  has found the beginning of the filename.  Everything after
  160. this will be accepted as the filename.
  161.     If the command line ends before it has found a filename, it will open a
  162. file requester and ask you to pick a file to play.
  163.  
  164.                                    WORKBENCH
  165.  
  166. NPlay  can  be  started  from  Workbench  without any trouble.  However, no
  167. command  line options can be specified, and it will not accept anything you
  168. put  in the icon.  This means you cannot initially start NPlay in the Quiet
  169. mode  from  Workbench, or make any NPlayLibs resident.  I hope to have this
  170. fixed in a future version.
  171.  
  172.                                 THE QUIET MODE
  173.  
  174. The early NProps frequently bugged when I opened them on such things as the
  175. AsmOne  screen, the DirectoryOpus screen, etc.  To overcome this problem, I
  176. added  a  feature  to turn off all screen output from NProp, allowing it to
  177. run  invisibly and unobtrusively.  This feature is of course retained (and,
  178. mind you, seriously improved) in NPlay.
  179.    There  are  two  ways of entering the Quiet mode - either press the HIDE
  180. gadget  on the main requester, or add the Q switch to the CLI command line.
  181. When  the  Quiet  mode  is  active,  NPlay  will not output anything to the
  182. screen,  instead relying on keypresses for its operation.  These keypresses
  183. correspond to the gadgets on the main requester, and are as follows:
  184.  
  185. Control-Left Shift-Left Alt-S - Restart the current module
  186. Control-Left Shift-Left Alt-L - Load a new module and play it
  187. Control-Left Shift-Left Alt-X - Use the special NPlayLib functions, if any
  188. Control-Left Shift-Left Alt-H - Leave Quiet mode
  189. Control-Left Shift-Left Alt-Q - End NPlay and free all resources
  190.  
  191.                                CRUNCHER SUPPORT
  192.  
  193. NPlay v2.0 supports the following cruncher formats:
  194.  
  195. * PowerPacker (through powerpacker.library)
  196. * StoneCracker 4.01
  197.  
  198. If  you're  missing  a cruncher, just send me the decrunch routine and I'll
  199. have  it  implemented  as  soon  as  possible.   Please note that only DATA
  200. crunchers  are  accepted.   You  cannot  crunch modules with FILE crunchers
  201. (like Imploder).
  202.  
  203.                                 COMING FEATURES
  204.  
  205. First  priority  is  to upgrade my computer to KS2.0 (yes, it's true, NPlay
  206. was  written  on  a  KS1.3  system!) and then have NPlay follow me into the
  207. future. KS3.0, I'm afraid, will have to wait some time.
  208.     As  stated earlier, I'm working with CrunchMania support at the moment.
  209. Other  data  crunchers will be added if I come across any.  If you have the
  210. decrunch  source for a data cruncher NPlay does not support, please send it
  211. to me A.S.A.P.  for inclusion in the next version of NPlay.
  212.     A future version of NPlay, probably v3.0 or something, will have a much
  213. improved user interface.  Although I hate to say so, for it does mean a lot
  214. more  work,  the  ReqTools-generated user interface is not adequate for the
  215. features  I  intend  to  add  to NPlay, so in order to implement the really
  216. stunning   features,  I  have  to  make  a  better,  Intuition-based,  user
  217. interface.
  218.     Someone  suggested  to  me  that  it  would  be  real  nice if the file
  219. requester  could stay open at all times - or even better, if you could have
  220. multiple  file  requesters  open  at  the  same time.  Naturally, being the
  221. kind-hearted  guy  I  am,  I  agreed, thus condemning me to even more work.
  222. However,  I  myself  was  the  one who said I wanted to make NPlay the best
  223. there  is, so I guess I had it coming.  Anyway, multiple filerequesters are
  224. on their way.
  225.     What's  worse, that same someone (names withheld to protect the guilty)
  226. also  suggested that NPlay should be able to read LZH/LHA archives and play
  227. modules  from  within them.  Now this is real bad.  I like the concept, but
  228. it's going to be a bitch to implement.  All I can say is, perhaps.
  229.     And as always, I'll try to write some more NPlayLibs.
  230.     - but!  Remember, you can write NPlayLibs yourself too!  I'd appreciate
  231. very much if you wrote an NPlayLib I haven't yet done and sent it to me for
  232. inclusion  in  the  NPlay  pack.  I need all the work-savers I can get.  Of
  233. course, you'll get credits for it.
  234.  
  235.                               CONTACT THE AUTHOR
  236.  
  237. To  contact  me, dial +47-(0)6-833980, and leave a note to NECROLOGIC /AWE.
  238. That's  the  best way.  The alternative is to sit down, write a letter, and
  239. mail   it   to  the  address  written  on  your  latest  version  of  NPlay
  240. (About/Info/Bug Reports from the main menu).
  241.  
  242. And  remember:   I DON'T SWAP!  If that's what you're after, look somewhere
  243. else.
  244.  
  245.                                ACKNOWLEDGEMENTS
  246.  
  247. First of all, I'd like to thank all those who helped make NPlay what it has
  248. become  today (and what it will be in the future).  Apart from myself, that
  249. is everyone who uttered a word about how they think NPlay should have been,
  250. how  they  think  it shouldn't, and generally contributed to something even
  251. vaguely  connected  with NPlay.  Sorry I don't supply a list, but the thing
  252. is  I  never made one, so mentioning those I remember would probably insult
  253. those I forgot about.
  254.     In  particular,  I  would  like to thank Bjørn A.  Lynne, who added the
  255. extra incentive of money to lure me into at last finishing the long-awaited
  256. version  2.0,  and  Nico  François,  the  man  behind  ReqTools.library and
  257. PowerPacker.library,  without  which NPlay would have been nothing (or even
  258. worse, completely CLI-based).
  259.     And,  here  at  the end, a big thankyou to Ulf Widar Antonsen Dahl, who
  260. wants me to code music disks.
  261.  
  262.