home *** CD-ROM | disk | FTP | other *** search
/ Esprit de Apple Corps / EDAC-1.iso / MOD.Utilities / Deskplay / Deskplay.Docs < prev   
Text File  |  1996-01-09  |  10KB  |  208 lines

  1.  
  2.                      Deskplay2.0.1
  3.                            Coding: Jesse Blue Ñ Art & Design: Clue
  4.                       Copyright 1995 Ninjaforce Ñ All rights reserved!
  5.  
  6.        Deskplay is using Shellplay 0.71 Ñ Copyright 1993 Brian C. Bening
  7.  
  8.  
  9. What it is...
  10.  
  11. Deskplay is a New Desk Accessory that lets you listen to Amiga¬ music module files (also referred to as MOD files) while under the desktop.
  12.  
  13. Deskplay works hand in hand with the famous Shellplay MOD player by Brian C. Bening to provide easy handling and excellent playback quality of Amiga¬ MOD files. (Hi Tony Morales: ╥Sonobox? What the hell...╙)
  14.  
  15. NOTE: If you have an Apple Hi╨Speed SCSI Card, Deskplay won╒t be of much use to you. This is because of a bug in Shellplay that causes the GS to crash whenever music is playing and the hard╨disk is accessed. Turning DMA on the Hi╨Speed Card off is the only way to prevent this...
  16.  
  17.  
  18. Installation...
  19.  
  20. Copy the files ╘Deskplay╒ and ╘SP╒ into the Desk.Accs folder of your boot╨volume, then reboot. You can, of course, also use IR¬ and double╨click on ╘Deskplay╒ to use it, but make sure ╘Deskplay╒ and ╘SP╒ are in the same folder.
  21.  
  22.  
  23. Using Deskplay...
  24.  
  25. If you are familiar using a common CD╨Player, you won╒t have any problems with Deskplay at all.
  26.  
  27. Deskplay╒s interface is devided into two sections: The playback and the songlist section (more on this later). The playback part along with all its buttons and displays operates like a standard CD╨Player.
  28.  
  29. The four small buttons from top left to down right are:
  30.  
  31.     Ñ     Power (╨SPACE): Pressing this button enlarges the Deskplay window 
  32.         to allow access to the songlist section.
  33.  
  34.     Ñ     Eject/Open (╨O): Allows you to load a new set of modules (see 
  35.         below) or just new modules. As the name implies, it removes all 
  36.         songs from the current song list. Deskplay automatically puts 
  37.         itself in playback mode once the songs have been loaded.
  38.  
  39.         NOTE: MOD file are loaded independent of their names/suffixes,
  40.         three filetypes (ASCII, Binary, Unknown) are supported. Only 
  41.         limitation: Deskplay won╒t load more than 400 MOD files, sorry 
  42.         (╥ohhh!╙). Shellplay supports NoiseTracker, ProTracker and
  43.         StarTrekker (4 channel) formats.
  44.  
  45.     Ñ     Info (╨I): Gives information on the current song in memory. 
  46.         Normally, the author of a music module has a lot to say about his 
  47.         masterpiece, but it may happen that this place is left completely 
  48.         blank or contains some weird instrument names.
  49.  
  50.         NOTE: If you have the Genesys.8 font (comes with Genesys) 
  51.         installed, Deskplay will use it instead of Shaston.8 to display
  52.         the information of a song.
  53.  
  54.     Ñ     Options (╨!): Opens a dialog with all options referring to the
  55.         playback of modules. These are as follows:
  56.  
  57.             Volume: Sets the playback volume (in percent from 0 to 100).
  58.  
  59.             Stereo: Sets the percentage of stereo. 0 means monophonic,
  60.             100 means full stereo. In╨between values mix channels, so
  61.             you won╒t turn dizzy when listening to MODs via headphones.
  62.     
  63.             Channel Doubling (╨D): Allows the percentage of stereo to be
  64.             set to values from 100 to 200. These values do not affect
  65.             channel mixing (since it will always be full stereo), but
  66.             rather make the music sound louder. Value 200 pushes the 
  67.             Ensoniq to its output limits! Beware...
  68.  
  69.             Tempo:     Smart PT/ Constant (╨S): Guesses the playback tempo 
  70.                 method (Amiga¬ ProTracker or constant) to use by 
  71.                 examining each song before playing it (this is the 
  72.                 default setting).
  73.  
  74.                 ProTracker (╨P): Uses Amiga¬ ProTracker tempo
  75.  
  76.                 Constant (╨C): Uses constant speed tempo (otherwise
  77.                 known as VBL timing). Constant tempo may be set to:
  78.  
  79.                     50Hz (╨5) or 60Hz (╨6)
  80.  
  81.             Follow Position Jumps (╨F): Postion jumps are commands used 
  82.             within MODs to create infinite loops or to hide songs (the 
  83.             default setting is off).
  84.  
  85.  
  86. The six large buttons are (from left to right):  
  87.  
  88.     Ñ Previous Song (╨<): Skips to the previous song. Can also be used
  89.         to select a certain track when no music is playing.
  90.  
  91.     Ñ Fast Forward (╨F): Plays the current song back three times as fast 
  92.         (150Hz) as normal. Hit ╘Fast Forward╒ again for normal playback.
  93.  
  94.     Ñ Next Song (╨>): Skips to the next song. Can also be used
  95.         to select a certain track when no music is playing.
  96.  
  97.     Ñ Play (╨P): Either plays the song that has been selected by the
  98.         ╘Previous Song╒ or ╘Next Song╒ buttons or the song selected in the 
  99.         song list. If no songs have been loaded, ╘Play╒ will also let you 
  100.         load songs or a set of songs, and then automatically put Deskplay 
  101.         in playback mode. Playback mode is indicated by a green ╘Play╒ 
  102.         symbol in the large display.
  103.  
  104.         NOTE: Once in playback mode, you may close the Deskplay NDA if you 
  105.         want, because Shellplay is capable of real background╨playing, i.e.
  106.         you can switch between applications while the music is playing.
  107.         However, playing Amiga¬ MODs ╥eats╙ a lot of processer time, so 
  108.         your system may be slowed down significantly. Also, be warned that 
  109.         your system might crash if you start an application that uses the 
  110.         GS Sound Tools while playing an Amiga¬ MOD in the background. And 
  111.         another, very important point: The system WILL CRASH some time 
  112.         while playing a lot of MODs. This is a bug in Shellplay, and there╒s 
  113.         currently no way around it. Sorry! The best solution is to hit ╘Stop╒
  114.         from time to time. Also, do not enter ProDOS 8 while a music is
  115.         playing. Again, the system WILL crash.
  116.  
  117.     Ñ Stop (╨.): Stops playing the current song(s). Also removes 
  118.         Shellplay from memory.
  119.  
  120.     Ñ Pause (╨Space): Pauses the current song. Pause mode is indicated by 
  121.         a green ╘Pause╒ symbol in the large display. ╘Pause╒ also ╥frees╙ all 
  122.         processor time, so this is handy if ╤ for example ╤ you need to print 
  123.         out something quickly but still want to have Deskplay/ Shellplay 
  124.         active. Pressing ╘Pause╒ again continues playing the current song.
  125.  
  126.  
  127. The Songlist...
  128.  
  129. ...contains all songs that have been loaded. The songlist is much like the contents of a real audio CD, except that you can customize it completely. Note that you can╒t modify the list while the music is playing.
  130.  
  131. The songlist is also the fastest way to access a certain song: Once the song has been highlighted in the list, it can be played by clicking the ╘Play╒ button. You can also double╨click on a song name, and it will immediately be played.
  132.  
  133. You can also select multiple songs for playback (using ╘Shift╒ & ╘Open Apple╒). The small number in the large display then stands for the number of ╘programmed╒ songs. A small ╘PRG╒ will indicate that you are in program mode. All other songs in the songlist will be dimmed. You can leave program mode by pressing ╘Stop╒.
  134.  
  135.  
  136. The buttons that directly affect the songlist are:
  137.  
  138.     Ñ    ADD: Adds more MODs or module sets to the songlist.        
  139.  
  140.     Ñ    DEL: Deletes selected entries from the songlist.
  141.  
  142.     Ñ     CLR: Clears the songlist.
  143.  
  144.  
  145. The other three buttons are:
  146.  
  147.     Ñ    RND: Plays all or the selected songs in random order. Random mode
  148.         is indicated by a small green ╘RND╒. You can also press this button
  149.         if the music is already playing (in normal mode) to put Deskplay
  150.         in random mode. If you are already playing songs in random mode, 
  151.         pressing this button causes the songs to be re╨randomized and jumps 
  152.         to a new song. You can leave random mode by pressing ╘Stop╒.
  153.  
  154.         If no songs have been loaded, pressing ╘RND╒ will allow you to load
  155.         modules and then put Deskplay in random playback mode.
  156.  
  157.     Ñ     SAV (╨S): Saves the current songlist. We call the result a set of 
  158.         modules. This gives you the ability to create your own ╥MOD CDs╙. 
  159.         A set is treated like a normal music module. It can be loaded, or 
  160.         appened to the current songlist.
  161.  
  162.     Ñ About Deskplay (╨?): Info on Deskplay and hellos from Ninjaforce!
  163.         (Go and find the easter╨egg within!)
  164.  
  165. Instantly ╥Shutting Down╙ Deskplay... ...was Clue╒s idiotic idea.
  166.  
  167. When the Deskplay window is frontmost, hit ╨K to stop the current music, clear the songlist and close the NDA.
  168.  
  169.  
  170. Saving Deskplay Settings...
  171.  
  172. Deskplay automatically saves all its settings (options, current song directory) to disk when you close the NDA. Deskplay writes its settings in its resource fork, so you don╒t have to mess around with stupid config files...
  173.  
  174.  
  175. Special NDA Access Keys... ...sind geil!
  176.  
  177. To make Deskplay even easier (and faster) to use, you may hold down the following special keys while choosing Deskplay from the Apple Menu:
  178.  
  179.     Ñ ╘Option╒: Brings up the Deskplay options dialog
  180.     Ñ ╘Shift╒: Stops playing the current music
  181.     Ñ ╘Open Apple╒: Pauses/continues playing the current music
  182.     Ñ ╘Control╒: Same as Eject/Open
  183.  
  184. NOTE: The keys will only work if the Deskplay window is not open!
  185.  
  186.  
  187. Accessing Deskplay in 320 Mode...
  188.  
  189. ...is not possible (yet). However, all of the NDA Special Access Keys work fine; the options dialog is available, too.
  190.  
  191.  
  192. Some Final Words...
  193.  
  194. Deskplay is dedicated to Brian C. Bening. Brian wrote the very best MOD player for the GS in 1993, the ╥year of GS MOD players╙. Back then, the Shellplay documentation mentioned a possible full featured music program that might appear in the future and a desktop version of Shellplay. Unfortunately, those two programs never came out. And while there are some NDA MOD players available these days, they are all, and perhaps this is not only our opinion, very poorly done. This (among other reasons) is mainly why we did Deskplay, and we hope you enjoy the result.
  195.  
  196. Have fun with it!
  197.  
  198.        (╥Not bad for our first ╘real╒ desktop program, eh?!╙)
  199.  
  200. Send comments, praises and flames to:
  201.  
  202.     Snail Mail:    Ninjaforce
  203.                 Adolf-Rausch-Str. 24
  204.                 69124 Heidelberg
  205.                 Germany
  206.  
  207.     e-Mail:    ug0a@rzstud1.rz.uni-karlsruhe.de
  208.