home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d960 / powerplayer.lha / PowerPlayer / Docs / PowerPlayer.English < prev    next >
Text File  |  1993-11-22  |  29KB  |  733 lines
  1. ==============================================================================
  2.  
  3.             P O W E R P L A Y E R
  4.  
  5.             .....User-Manual.....
  6.  
  7. ==============================================================================
  8.  
  9. PLEASE READ
  10. -----------
  11. PowerPlayer now is SHAREWARE.
  12.  
  13. Why SHAREWARE?  Well, I'm only a poor student and developing good software
  14. has become too expensive for me.  If you want PowerPlayer to continue to
  15. grow and to flourish or if you want to see other great products like
  16. PowerPlayer in the future consider sending 30.- DM to the author.
  17.  
  18. My shareware concept on a free basis didn't work, so I included a
  19. keyfile system in PowerPlayer - if you're not registered, the music
  20. will stop and a silly shareware requester will appear all ~5 minutes and
  21. will force you to remember that this program isn't yours (yet).
  22.  
  23. If you tried PowerPlayer and agree that it is a good program, you can send
  24. me 30 DM and then you'll get a keyfile & free support with all future
  25. versions of PowerPlayer.
  26.  
  27. Yours Stephan Fuhrmann, author of POWERPLAYER
  28.  
  29. ------------------------------------------------------------------------------
  30.  
  31. The author of this software can't be held liable for the contents of this
  32. package and every damage caused by it.
  33.  
  34.         © 1991-93 STEPHAN FUHRMANN, GERMANY
  35.  
  36. These freely distributable shared libraries are included in the
  37. PowerPlayer-Package:
  38.  
  39. -ReqTools.Library © by Nico François
  40. -PowerPacker.Library © by Nico François
  41. -Lh.Library © by Holger P.Krekel and Olaf 'Olsen' Barthel
  42.  
  43. These docs are included in the PowerPlayer-Package:
  44.  
  45. -deutsch by Stephan Fuhrmann
  46. -english by Stephan Fuhrmann
  47. -français by Jean Yves Proux
  48.  
  49. These catalogs are included in the PowerPlayer-Package:
  50.  
  51. -deutsch by Stephan Fuhrmann
  52. -english (built-in) by Stephan Fuhrmann
  53. -français by Jean Yves Proux
  54. -português by ???
  55. -norsk by Bjørn A.Lynne
  56.  
  57. Version 4.0 (25 APR 1993)
  58.  
  59. ==============================================================================
  60.  
  61. Greetings (random order)
  62. ------------------------
  63. -Delta/TCC
  64. -Flynn/TRSI for his great NoisePlayer
  65. -Holger P.Krekel & Olaf 'Olsen' Barthel for their lh.library
  66. -Bryan Ford (Mr.Multiplayer)
  67. -Nico François for his _GREAT_ reqtools.library & powerpacker.library and
  68.  his hints concerning the reqtools.library
  69. -Teijo Kinnunen for his routines & 68030 tests
  70. -Steve / Silicon Designs 3003
  71. -Thomas Eibl
  72. -Turbo / Infect
  73. -Wayne Mendoza / Masque
  74. -Bernhard Zahler
  75. -Thomas Ansorge
  76.  
  77. ==============================================================================
  78.  
  79. History
  80. -------
  81. V 1.0:    Version with BUGS & no COOL features :-(
  82. V 1.1:    Removed ALL bugs, added coool CLI-Interface & CLI-InfoPage, PMC
  83. V 1.2:    Added the 4-Channel Oktalyzer-Replay
  84. V 1.3:    Added DeltaMusic (finally got a song :-) ),
  85.     corrected PowerPlayer to recognize SoundMon for ALL Versions,
  86.     optimized ProTracker-Replay
  87. V 1.5:    Added the possibility to start the File-Requester with a specific
  88.     directory, the NoiseTracker 1.3D-Replay has been disabled for a
  89.     strange reason -» FIXED
  90. V 1.6:    In the meantime aged Req.Library has been displaced by the
  91.     ReqTools.Library that generates i.e. nice 3D-Requesters.
  92. V 1.7:    Instead of a VBlank-Interrupt, that replays songs with strange
  93.     speeds when running on Amigas with NTSC or a 10 Hz monitor a
  94.     CIA-Timerinterrupt is used.
  95. V 1.8:    Added the "Restart"-function
  96. V 1.9:    Improved the outputs for faults, the ECLOCK-Frequency will be fetched
  97.     under OS 2.0 from the System, optimized Replays again
  98.     found a bug that exists in ALL tracker-replays, that writes into
  99.     unallocated memory. I don't know whether this bug exists in all
  100.     other Module-Players, too. I recommend to use only PowerPlayer !!!
  101. V 2.0:    Added a replay for TFMX-Modules WITH built-in replay-routine
  102. V 2.1:    Added a replay for MED-Modules
  103. V 2.2:    Now features a GUI (graphical user interface) with a CD-player-like
  104.     button-system. Now uses a big Lh-Buffer for faster decrunching.
  105. V 2.3:    Pressing the right mousebutton will iconify/deiconify the window
  106.     now, the window will be centered beneath the mousepointer when
  107.     launched, new shortcuts were added, code has been optimized
  108. V 2.4:    New functions: First song, last song and random play !
  109. V 2.5:    PowerPlayer will now display a busy-mousepointer when loading &
  110.     decrunching a file and disable the IDCMP of the window.
  111. V 2.6:  PowerPlayer will now look fine on a 2 color-screen
  112. V 2.7:    A little bit more WB 2.0-feeling by adding 3D-Borders
  113. V 2.8:  Included new Protracker-replay (V2.1A), hitting return while
  114.     displaying requesters will activate the negative response
  115.     (for all pessimists ;-)), the PowerPlayer-task is running with
  116.         priority 1, optimized all replays again
  117. V 2.9:    Included Sonix Arranger-replay, new commandline parsing routine +
  118.     commandline flags, multiple modulenames can be specified in the
  119.     commandline
  120. V 3.0:    WorkBench tooltypes for all flags supported (please read the
  121.     chapter "Calling PowerPlayer"), ARexx is supported with many commands
  122.     (please read the chapter "ARexx support"), new "NoReq"-Flag for
  123.         Workbench and CLI (useful for ARexx)
  124. V 3.1:    You may optionally use the filerequester of the asl.library
  125. V 3.2:    SoundMon-Replay now 100% resetable, fixed timing for CPUs
  126.         faster than 68000, now 99.9% safe to use NoisePacker modules,
  127.         new OctaMED pro replay
  128. V 3.3:    New powerful compression, OctaMED 4.0-Replay, Soundmon fixed
  129.     to play samples correctly, new BP-Soundmon type
  130. V 3.4:    Hotkeys, now may used without window, AmigaDOS BREAKable
  131. V 3.5:    Using standard waitpointer, CBM Style Guide conform 3D design,
  132.     PowerPlayer's window is an AppWindow (read the chapter "Calling
  133.     PowerPlayer/WorkBench/AppWindow"), huge pile of new replays,
  134.     new useful ARexx commands, output of the version with '-Ver'
  135. V 3.6:    Now uses ProTracker CIA replay, new great information-requester (?!),
  136.     improved 'awake'-feature (key: 'x'), unimportant 'Bug'-fix of
  137.     CTRL-F
  138. V 3.7:    Uses new improved routine for 'RND', added ProRunner packed replay,
  139.     PMC outputs correct percentages, under OS 2.0 PowerPlayer will flush out
  140.     the data caches after decrunching
  141. V 3.8:    The position won't be pasted over the gadgets any longer - PowerPlayer
  142.     will display the percental position instead, you may load and save
  143.     songlists now (in other players they are called 'programs') - read
  144.     "Keyboard Functions" and the "Songlist" chapter, fixed NP 2.0/NP 3.0/
  145.     David Whittaker/Fred/Sonic Arranger-Recognition routines, new Promizer
  146.     replay
  147. V 3.9:    Improved PMC's CLI-interface, UNIC-replay now sounds normal on faster
  148.     AMIGAs, Window repositions correctly on OS 2.0-screens when deiconifying,
  149.     PMC doesn't write to unallocated memory, PowerPlayer restores the
  150.     initial state of the power led when exiting, added a pretty timer,
  151.     removed all ENFORCER hits (I hope), TOOLPRI WB- & CLI-Argument,
  152.     PowerPlayer-Support-Mailbox (no feature, but everybody will notice it here :)
  153. V 4.0:    POWERPLAYER IS NOW INTERNATIONALIZED!, PMC got a version string,
  154.     added ProPacker replay, new great CBM installer script, supports OS 3.0
  155.     defaultbusypointer, new moduleinfo function for ProTracker modules
  156.  
  157. ==============================================================================
  158.  
  159. This version of the PowerPlayer supports:
  160.  
  161. David Whittaker
  162. DeltaMusic 1.0 + 2.0
  163. Digital Sound System
  164. Fred
  165. Future Composer 1.0-1.4
  166. Game Music Creator
  167. Jam Cracker
  168. Jochen Hippel            (untested)
  169. Kris
  170. Maniacs Of Noise
  171. Mark II
  172. Morten Grouleff's MusicProgram
  173. Music Assembler
  174. NoisePacker 2.0 + 3.0
  175. NoiseTracker
  176. NoiseTracker 1.3D packed modules
  177. NoiseTracker 1.3D packed modules with replay routine
  178. OctaMED-Modules (MMD0 & MMD1)
  179. Oktalyzer
  180. Promizer I + II
  181. ProPacker 2.1
  182. ProRunner packed modules
  183. ProTracker CIA (V2.1a)
  184. SidMon 1.0 and 2.0
  185. Sonic Arranger with replay routine
  186. SoundFX 1.3 + 2.0
  187. SoundMon
  188. SoundTracker 2.6
  189. Startracker 4 voice
  190. Tfmx with replay routine
  191. The Musical Enlightenment
  192. Unic
  193.  
  194. ==============================================================================
  195.  
  196. Installation
  197. ------------
  198. The PowerPlayer NEEDS the PowerPacker.Library and the ReqTools.Library in
  199. your libs:-directory.  The script included in this package will install
  200. them for you.  Optionally the Lh.Library is used.  If you feel fit enough
  201. you can crunch your modules with the powerful PMC which uses the
  202. LH.Library.
  203.  
  204. ==============================================================================
  205.  
  206. Introduction
  207. ------------
  208. Hello and welcome to the world of PowerPlayer!  This fantastic tool was
  209. written in 1991-93 by Stephan Fuhrmann, using the outstanding abilities
  210. of the
  211.  
  212. -ReqTools.Library by Nico François for the File- and Text-Requestors
  213.  
  214. -PowerPacker.Library by Nico François for uncrunching powerpacked files
  215.  
  216. -Lh.Library by Holger P. Krekel and Olaf 'Olsen' Barthel for _BEST_
  217.  compression of modules, executable simple cruncher included.
  218.  
  219. The PowerPlayer is a tool for playing music made with one of the supported
  220. music-programs or compatibles with the good old AMIGA stereo digital
  221. sound-facilities !  There have been many of these programs before, but
  222. PowerPlayer is something different:
  223.  
  224. -cool fast tricky optimized 100% assembly code, most parts PC-Relative
  225. -works on CPU 68000, 68010, 68020, 68030, 68040 and it should work on the 68060
  226.  and all future CPUs
  227. -works with OS 1.3, 2.0, 3.0 without any problems
  228. -little pretty (?) play-window
  229. -maaaany optimized replays
  230. -PowerPacker-Library for using always the latest and fastest decrunch-routine
  231. -supports xpk crunched modules !
  232. -Lh-Library for deepest compression ever seen on modules (try it out !)
  233. -powerful ARexx-Port for remote control of PowerPlayer
  234. -may be used in thousands of ways from WorkBench and from CLI
  235. -allocates its audio-channels with the audio.device
  236. -great support BBS (DOOMSDAY, phone number at the end of this document)
  237.  
  238. But let us start at the beginning:
  239.  
  240. Calling PowerPlayer
  241. -------------------
  242.     WorkBench
  243.     ---------
  244.         DoubleClick
  245.         -----------
  246.             DoubleClick the icon of the PowerPlayer, choose the
  247.             file in the File-Requester, hit 'OK' and enjoy !
  248.         DefaultTool
  249.         -----------
  250.             You have a module with an icon. Select this icon and
  251.             activate the info-function of the Workbench. Now
  252.             select the DefaultTool. Enter the path of
  253.             PowerPlayer and press <RETURN> to terminate the input.
  254.             Press the SAVE-Gadget.
  255.             Now everytime you doubleclick the project-icon
  256.             PowerPlayer will be loaded and will play your song !
  257.         MultiSelect
  258.         -----------
  259.             Move the mousepointer over the PowerPlayer-Icon and
  260.             press the left mousebutton ONCE. Now press SHIFT and
  261.             leave it pressed. Select the songs you want to hear
  262.             with the mouse. Now doubleclick the last song and
  263.             release SHIFT. Your songs will be loaded !
  264.  
  265.         ToolTypes
  266.         ---------
  267.                         Place the mousepointer over the powerplayer-icon
  268.             and activate it by choosing "Info" out of the
  269.             Workbench-menus. You have got the possibility
  270.             to add/change the following ToolTypes:
  271.                         QUALIFIER=(qualifier for hotkeys)
  272.                 This specifies the qualifier you want for
  273.                 the hotkeys
  274.                         DIRECTORY=(directory you want in the filerequester)
  275.                 This specifies the directory that will be
  276.                 displayed first in the filerequester
  277.                 Example: DIRECTORY=DF0:Modules
  278.             PATTERN=(pattern you want in the filerequester)
  279.                 This specifies the pattern all files in
  280.                 the filerequester are matched with
  281.                 Example: PATTERN=MOD.#?
  282.             LED=[0|1|M]
  283.                                 This specifies the mode of the filter-LED:
  284.                 0=Force filter-led off
  285.                 1=Force filter-led on
  286.                                 M=Let the module decide (default)
  287.                 Example: LED=0
  288.             NOREQ=[TRUE|FALSE]
  289.                 Tells PowerPlayer to pop up *NO* filerequester
  290.                                 if it started without any files specified.
  291.                 Useful for ARexx since you can't control
  292.                 Nico's Filrequester with ARexx ;-).
  293.                         NOWIN=[TRUE|FALSE]
  294.                 Tells PowerPlayer to open *NO* window
  295.                 on startup.
  296.             ASL=[TRUE|FALSE]
  297.                 Tells PowerPlayer to use the filerequester
  298.                 of the asl.library. You need OS 2.0 to do
  299.                 this. If PowerPlayer failed to open the
  300.                 library or the requester the reqtools-
  301.                 requester will be used.
  302.             NOTIMER=[TRUE|FALSE]
  303.                 Tells PowerPlayer that you do/don't want
  304.                 to have a timer. The timer tends to need
  305.                 some CPU cycles once a second.
  306.             TOOLPRI=[-128..127]
  307.                 Sets the task priority of PowerPlayer to the
  308.                 specified value. DANGER! Stay in the range
  309.                 from -3 to +3, otherwise you will disturb
  310.                 important system tasks!
  311.  
  312.         AppWindow
  313.         ---------
  314.         (WB 2.0+ only)
  315.             Additional to the possibility to use awkward
  316.             filerequesters, it is possible to drag icons of modules
  317.             directly into PowerPlayer's window! PowerPlayer will
  318.             load and play all modules dropped into
  319.             its window at once.
  320.     CLI/Shell
  321.     ---------
  322.         Filerequester
  323.         -------------
  324.             Everyone knows how to handle filerequesters, so I
  325.             do not want to explain the very sophisticated one
  326.             of the reqtools.library. Type the name of PowerPlayer
  327.             in the CLI/Shell you have opened and add the
  328.             parameter '-r' to the command. You will see
  329.             a filerequester where you can select your songs.
  330.                         This flag is obsolete, PowerPlayer will pop up
  331.                         the filerequester if there are no files specified
  332.             on startup.
  333.             Example: PowerPlayer -r
  334.         Filename
  335.         --------
  336.             If you do not want to select the file by making use
  337.             of the filerequester (i.e. in scripts) you may also
  338.             add one or multipe modulenames with its/their path
  339.             to the commandline.
  340.             Example: PowerPlayer df0:MOD.PowerTheme ram:SID.Mega
  341.  
  342.         Information
  343.         -----------
  344.             If you want to see the cool information-page,
  345.             enter: PowerPlayer ?
  346.         Version
  347.         -------
  348.             If you want to find out the version of PowerPlayer,
  349.             simply enter:
  350.             PowerPlayer -Ver
  351.         Flags
  352.         -----
  353.             There are multiple flags that can make the time
  354.             you pass using the PowerPlayer more convenient:
  355.             -r........use filerequester (obsolete)
  356.             -nr.......don't pop up filerequester at start when
  357.                     there are no files specified
  358.                         -nw.......don't open a window at start
  359.             -dDIR.....set the directory of the filerequester
  360.                     i.e. '-dDF0:modules'.
  361.             -pPAT.....set the pattern of the filerequester
  362.                     i.e. '-pMOD#?'.
  363.             -qQUAL....set the qualifier for the hotkeys
  364.                     (see hotkey-chapter)
  365.             -l0/1/M...set the mode of the filter-led.
  366.                     0=force filter off
  367.                     1=force filter on
  368.                     M=module controls filter
  369.             -ASL......Tells PowerPlayer to use the filerequester
  370.                     of the asl.library. You need OS 2.0
  371.                     to do this. If PowerPlayer failed to
  372.                     open the library or the requester the
  373.                     reqtools-requester will be used.
  374.             -nt.....Tells PowerPlayer to use _NO_ timer.
  375.                 The timer tends to need
  376.                 some CPU cycles once a second. Default
  377.                 is timer on.
  378.             -ToolPri=[-128..127]..sets the task priority of
  379.                 PowerPlayer to the specified value. DANGER!
  380.                 Stay in the range from -3 to +3, otherwise
  381.                 you will disturb important system tasks !
  382.  
  383.  
  384. Play-Requester
  385. --------------
  386. The Play-Requester contains information about the module and some gadgets.
  387. If you start PowerPlayer without a window (NOWIN) and have specified a
  388. qualifier for hotkeys you are able to open the window by pressing qualifier
  389. and 'w'.
  390.  
  391. Questionmark....displays the usual information concerning copyright &
  392.         features.
  393. Eject...........ejects the current list of songs & asks you with a
  394.         filerequester for a new one.
  395. FirstSong.......will load & play the first song from the list.
  396. PrevSong........will load & play the previous song from the list.
  397. Play............will play the song. Will automatically unpause, if you
  398.         hammer the PLAY again the song will start from the
  399.         beginning.
  400. FastForward.....will play the song twice as fast as normal. This gives a
  401.         nice FF-effect ! Rehammer will switch back to normal speed.
  402. NextSong........will load & play the next song from the list.
  403. LastSong........will load & play the last song from the list.
  404. Stop............will stop the song. Automatically unpauses, unFFs and
  405.         unplays!
  406. Pause...........stops the song until you repress pause or push play.
  407. Reset...........will start the song again.
  408. RND.............will load & play a randomly chosen song.
  409.  
  410. For further information about the keyboard functions of Powerplayer read the
  411. Chapter 'Keyboard Functions'.
  412.  
  413. Pressing the right mousebutton will change to the iconify-mode. The window
  414. will shrink to a minimum height of 10 pixels. The gadgets will disappear,
  415. but you can still control PowerPlayer with the keyboard-shortcuts.
  416. To unshrink the window to its normal size you just have to hit the
  417. right mousebutton again.
  418.  
  419. The display of the window contains
  420. -the name of the module (top of window)
  421. -type of the module & length of the module in bytes (middle of window)
  422. -the gadgets and the position-indicator that displays your position in the
  423.  file-list.
  424.  
  425. My GUI works with a recolor-routine that can handle crazy palettes in a clever
  426. way. It searches for the brightest and darkest colors for the shadows and
  427. it searches for the color with the biggest contrast to the background for
  428. text-output.
  429.  
  430. Songlist
  431. --------
  432. Songlists are a replacement for the torture of selecting ever and ever
  433. the same files with the filerequester. Songlists contain the information
  434. that PowerPlayer usually gets from the filerequester.
  435.  
  436. FOR SAVING SONGLISTS YOU REQUIRE AMIGAOS 2.0 OR HIGHER.
  437.  
  438. Songlists are loaded like songs. You may load a songlist with the
  439. filerequester, you may load it by multiselecting it with PowerPlayer from
  440. the Workbench etc. If a songlist is being loaded PowerPlayer will act as if
  441. you just selected the files with the filerequester: it'll read the first
  442. song and play it.
  443.  
  444. You may save a songlist at every time you want to. Press '#' and a
  445. filerequester will appear and ask you for the name of the songlist you
  446. wish to save. Because of technical reasons the whole path of a song
  447. will be saved. This means that you can use a songlist only for one
  448. volume (disk/harddrive), the volume name will be used in the path.
  449.  
  450. Since songlists are loaded like songs, it is free to you to crunch them.
  451.  
  452.  
  453. Keyboard Functions
  454. ------------------
  455. PowerPlayer offers for advanced users shortcuts and hotkeys which enable you
  456. to control PowerPlayer much better than with gadgets. An additional feature
  457. are the hotkeys. You have got to use the normal keymapping for hotkeys, but
  458. read this later on.
  459.  
  460. Key            Function
  461. .............................................................................
  462. 'm'            Shows all instruments names of ProTracker modules
  463.             with a requester
  464. '#'            Save current songlist. A filerequester will appear,
  465.             choose the songlistfile to save. Saving the
  466.             songlist will take a little while, but loading the
  467.             songlist is as fast as usual.
  468. CTRL-F            Puts the PowerPlayer window to the front and unshrinks
  469.             it. Better: 'x'.
  470. 'x' & 'X'        Puts the Workbench and the PowerPlayer window to the
  471.             foreground, and unshrinks it. Better than CTRL-F,
  472.             CTRL-F was left in the code to reach downwards-
  473.             compatibility of the keyboard control.
  474.             CTRL-F couldn't be used as a hotkey, but 'x' can.
  475. ESC / CTRL-C        Quits PowerPlayer
  476. RETURN            loads & plays the next song
  477. '-', '[', '(', '{', '3' loads & plays the previous song
  478. '+', ']', ')', '}', '6' loads & plays the next song
  479. 'e', 'E', '2'        works like the 'Eject' gadget
  480. 'p', 'P', '4'        works like the 'Play' gadget
  481. 'f', 'F', '5'        works like the 'FastForward' gadget
  482. 's', 'S', '7'        works like the 'Stop' gadget
  483. 'r' & 'R','9'        works like the 'Reset' gadget
  484. ' ' & '*','8'        works like the 'Pause' gadget
  485. 'i' & '1'        displays the information-requester
  486. '~', '/'        works like the 'RND' gadget
  487. 'w' & 'W'        opens the PowerPlayer window, if it isn't open yet
  488.  
  489. Hotkeys
  490. -------
  491. Hotkeys enable you to use PowerPlayers standard set of keys -
  492. no matter what the active window or screen is. This means that you can
  493. control PowerPlayer from your wordprocessor without leaving the
  494. wordprocessors screen/window.
  495.  
  496. This feature is turned on by the QUALIFIER ToolType or by the -q flag.
  497. Valid qualifiers are:
  498.  
  499. LSHIFT/LEFT_SHIFT
  500. RSHIFT/RIGHT_SHIFT
  501. CAPSLOCK
  502. CONTROL
  503. LALT/LEFT_ALT
  504. RALT/RIGHT_ALT
  505. LCOMMAND/LEFT_COMMAND/LAMIGA/LEFT_AMIGA
  506. RCOMMAND/RIGHT_COMMAND/RAMIGA/RIGHT_AMIGA
  507.  
  508. To mix these qualifiers you have to seperate the qualifiers with a '!' or
  509. a '|':
  510.  
  511. CONTROL!LSHIFT!LALT
  512.  
  513. This is the recommended standard qualifier that is preset in PowerPlayers
  514. ToolType.
  515.  
  516. ==============================================================================
  517.  
  518. ARexx support
  519. -------------
  520. PowerPlayer offers an ARexx-Port named "PowerPlayer.REXX".
  521.  
  522. The ARexx-Port supports the following commands:
  523.  
  524. PlEject             acts exactly like the "Eject"-button
  525. PlFirst             acts exactly like the "First"-button
  526. PlPrevious          acts exactly like the "Previous"-button
  527. PlPlay            acts exactly like the "Play"-button
  528. PlFF            acts exactly like the "FF"-button
  529. PlNext            acts exactly like the "Next"-button
  530. PlLast            acts exactly like the "Last"-button
  531. PlStop            acts exactly like the "Stop"-button
  532. PlPause            acts exactly like the "Pause"-button
  533. PlReset            acts exactly like the "Reset"-button
  534. PlRnd            acts exactly like the "Rnd"-button
  535. PlQuit            tells PowerPlayer to quit. Don't try to access the
  536.                         ARexx-Port after this command!
  537. PlLoad "<ModName>"    loads <ModName> and plays it.
  538. PlName            returns the name of the current module
  539. PlLength        returns the length of the current module
  540. PlType            returns the type of the current module
  541. PlListPos        returns the current position in the filelist
  542. PlListLen        returns the length of the current filelist
  543. PlMemPlay <HexAdr> <DecSize> <DecMemFreeSize>
  544.             plays the module that can be found at <HexAdr>
  545.             in the memory with the size of <DecSize>
  546.             bytes. <DecMemFreeSize> bytes will be freed
  547.             at <HexAdr> after the module has been replayed.
  548.             A <DecMemFreeSize> of 0 signals that PowerPlayer
  549.             mustn't free the memory area.
  550. ==============================================================================
  551.  
  552. The PowerPlayer Music Cruncher
  553. ------------------------------
  554. PMC has been developed to crunch modules only and I think that it does its
  555. job very good. It beats the compression-ratio of _EVERY_ known cruncher/archiver
  556. on the AMIGA and it is very fast when crunching & decrunching.
  557.  
  558. I have developed the new "SFCD" (Stephan Fuhrmanns Compact Density) mode
  559. which is based upon the old "SFHD" (Stephan Fuhrmanns High Density) mode.
  560. To crunch/decrunch "SFCD"/"SFHD" type modules you require Lh.Library v1.8+.
  561.  
  562. MOD.TEST    |UNCRUNCHED    |SFCD    |SFHD    |POWERPACKER
  563. ----------------+---------------+-------+-------+-----------
  564. SIZE (bytes)    |320044        |189734    |210540    |237832
  565. SUCCESS        |00%        |40%    |34%    |25%
  566. CRUNCHTIME    |0:00        |2:37    |2:47    |2:58
  567. DECRUNCHTIME    |0:00        |0:17    |0:17    |0:07
  568.  
  569. Using PMC is rather simple:
  570.  
  571. PMC [SOURCENAME] [DESTNAME]
  572.  
  573. PMC will load [SOURCENAME], crunch it (or decrunch, if already crunched)
  574. and save it as [DESTNAME].
  575.  
  576. Another possibility is to specify only one filename. PMC will read the
  577. file you specified, crunch/decrunch it and will overwrite the old file:
  578.  
  579. PMC [FILENAME]
  580.  
  581. With this method PMC is able to work with CBM's SPat.
  582.  
  583. PMC writes "SFCD" type modules only, but it can read & decrunch "SFCD" and
  584. "SFHD" type modules.
  585.  
  586. PowerPlayer reads & decrunches "SFCD" & "SFHD" type modules automatically
  587. if the Lh.Library is in your Libs: directory.
  588.  
  589. I have seen some guys loading up modules on BBSs in the PMC-format.
  590. PLEASE use '.PMC' as suffix and note that they need PowerPlayer to replay.
  591. AND check the BBS wether there's PowerPlayer existing or not, they
  592. won't be very happy if they download the stuff and don't find the
  593. PowerPlayer !
  594.  
  595. An example BBS-entry could look like this:
  596. SONG.PMC    Very good module, use PowerPlayer to replay
  597.  
  598. I recommend uploading the modules in the PMC-format without unimportant
  599. 'trash' in an archive. You don't have to decrunch manually, the file
  600. needs less diskspace (it's still crunched) and there's last but not least
  601. the PMC-format that has been developed ONLY for the PowerPlayer, so you
  602. _NEED_ the PowerPlayer to decrunch ß-} !  By doing this you can show your
  603. consent to the PowerPlayer!
  604.  
  605. ==============================================================================
  606.  
  607. Technical Information
  608. ---------------------
  609. PowerPlayer won't create his own process.  It seems to be a modern feature
  610. to launch everything in the background, but I wanted to give the user the
  611. possibility to stop the computer i.e.  in the startup-sequence as long as
  612. the song plays.  I think this is the best way to realize this, if you want
  613. to create a background process for PowerPlayer you will have to "RunBack"
  614. it yourself !
  615.  
  616. If you examine songlists saved by PowerPlayer you'll notice that PowerPlayer
  617. stores the whole path of a file. This may fatten the songlists a little bit,
  618. but it is nessesary for WB & AppWindow filemodes.
  619.  
  620. ==============================================================================
  621.  
  622. Since there are sooo many music-proggies for the AMIGA, it is impossible to
  623. include all the existing replays.  To give you and me the possibility to
  624. expand PowerPlayer to the best moduleplayer ever written, I will built in
  625. any replay-routine sent to me, if the following work is done:
  626.  
  627. -Sourcecode of the Music-Routine in ASSEMBLY, PC-Relative if possible.
  628.  At this time I can only include replayers at the base of the
  629.  verticalblank-interrupt. The sourcecode has to be on a 3.5"-disk
  630. -Add a description how to recognize that certain kind of module or other-
  631.  wise simply enclose 3 or more of those modules and I'll find out myself
  632. -In any case,though, I would like you to add 3 or more Songs that can be
  633.  played with your replay, if possible. I have to test the routines, and
  634.  a music-proggy with less than 3 adequate songs is surely not very useful.
  635. -If the disk has only ONE error, I'll take for granted that you do not want
  636.  it back and shred it. So do use high-quality-disks formatted carefully
  637.  before using (verify) !
  638.  
  639.  
  640. SHAREWARE-INFORMATION: Only registered users receive an update for 5 DM. One
  641. update is automatically provided if you pay the 30 DM shareware fee.
  642.  
  643. If you want some cool features added to the PowerPlayer, do this:
  644.  
  645. -Write a detailed letter with all new features you think of
  646. -If you would like to have the new version include a disk for PowerPlayer
  647.  and 5 DM (DEUTSCH MARK) for my working on it !
  648.  
  649. If you want an update, do this:
  650. -Include a disk for PowerPlayer and 5 DM (DEUTSCH MARK) for all the work
  651.  (envelope, stamps...) !
  652. -I will send you the actual version of PowerPlayer
  653.  
  654. If you just want to write to an AMIGA programmer
  655. -do it!
  656.  
  657. My Address:
  658.         Stephan Fuhrmann
  659.         Erikstr. 30
  660.         24837 Schleswig
  661.         Germany
  662.  
  663. Always add the version of the PowerPlayer you are using and where you got
  664. it from!
  665.  
  666. ==============================================================================
  667.  
  668. Official PowerPlayer support BBS
  669. ================================
  670.  
  671. DOOMSDAY BBS, GERMANY
  672. ---------------------
  673.  
  674. Sysop    * Stiff! *
  675. CoSysop * Matthias *
  676.  
  677. Port 00  +49 - (0)4621 - 36796 .... Online: 24 H
  678. Port 01  +49 - (0)4621 - 36742 .... Online: 22-8 o'clock
  679.  
  680. PD-Stuff, latest Fish and more!
  681.  
  682. You'll find the most current PowerPlayer version and a special PowerPlayer
  683. board in this BBS.  For questions, ideas, bug-reports & other stuff
  684. concerning the PowerPlayer simply contact the cosysop, he'll inform me about
  685. the stuff.
  686.  
  687. If enough people register I'll buy a modem, so you can contact me direcly
  688. via this BBS.
  689.  
  690. ==============================================================================
  691.  
  692. If you want a great music editor, consider buying
  693.  
  694.         Teijo Kinnunen's OctaMED
  695.  
  696. It has 4 up to 8 Voices, a superb pattern editor, easy to create
  697. synthesizer-sounds, works perfectly in the AMIGA multitasking environment,
  698. has MIDI-support, can handle powerpacked files and much more.
  699.  
  700. Order OctaMED:
  701.     Amiganuts
  702.     12 Hinkler Road,
  703.     Southampton,
  704.     Hants,
  705.     SO2 6FT
  706.     ENGLAND
  707.  
  708. ==============================================================================
  709. AM/FM
  710.  
  711. AM/FM - short for AMIGA MUSICIANS FREEWARE MAGAZINE - is a disk-based
  712. magazine for everyone who has an Amiga and likes music.  Whether you're
  713. into composing yourself, trying to learn, studying, or simply just
  714. collecting great Amiga music, then AM/FM is made for you!
  715.  
  716. Each issue of AM/FM contains New, Reviews, Tutorials, Hints & Tips, the
  717. latest in Sound and Music PD Utility programs, great series on how to write
  718. Amiga- and MIDI music, courses in various Amiga music software, plus a lot
  719. of great Amiga-only music as well as MIDI music for use in any Amiga
  720. sequencer package.
  721.  
  722. AM/FM disks cost only as much as other PD disks.  For a free AM/FM
  723. disk-catalogue with prices, how to order, etc.  etc., please send on fully
  724. working quality disk to:
  725.  
  726. AM/FM
  727. c/o Bjorn A.Lynne
  728. Schleppegrellsgt. 10
  729. 0556 Oslo
  730. NORWAY
  731. ==============================================================================
  732. (EOF)
  733.