home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / misc / amigalib.lha / edplayer.lha / edplayer / EdPlayer.DOCs / EdP2.0.Intro.README_FIRST < prev    next >
Text File  |  1992-07-11  |  12KB  |  227 lines
  1.  
  2. ============================================================================
  3.                          EdPlayer version 2.0
  4.                              by Ed Mackey
  5. ============================================================================
  6.  
  7. All new releases and upgrades of PD/Shareware/Freeware by Ed & Al Mackey
  8. (such as EdPlayer) are uploaded FIRST to our official support BBS:
  9.      ____   __          ___  ___  _____  __   
  10.     /      /  \ |\  /| |__  |___)   |   /  \ |\ |            On-Line
  11.     \____  \__/ | \/ | |___ |  \    |   \__/ | \|          Information
  12.        __\______  ___       ___  ___  __                     Systems
  13.      ____/ |     |__  |    |__  /    /  \ |\  /| |\  /|
  14.            |     |___ |___ |___ \___ \__/ | \/ | | \/ |   Est. 10/17/87
  15.            |
  16.            |    Modem: (215) 464-6775       HST: (215) 464-4461
  17.  
  18.  Supporting:    Amiga/IBM/Mac/][gs/UNIX     Storage:    670 Megabytes
  19.  Message Confs: 160+ (23 Specific Forums)   File Areas: 50+ (& Personal)
  20.  Active Nodes:  8 (Soon to be 12 Nodes)     PCPursuit:  PAPHI
  21.  Baud Rates:    3/12/24/48/96/14.4 (HST)    Graphics:   ANSI/IBM/SkyPix
  22.  Online Doors:  30+ (6+ Categories)         Location:   Philadelphia, PA
  23.  FIDOnet:       * Coming Soon *             Users from: U.S./Canada/Europe     
  24.  
  25.  Features:      Teleconferencing            Global 'GO' Commands
  26.                 Multi-Player Games          Inter-User Chatting
  27.                 Live Conference RPG's       ANSI & Skypix Pictures
  28.                 Areas on ALL Topics         Special Over & Under 18 Bases
  29.                 Friendly Staff              Over 500 Active Users
  30.  
  31. ============================================================================
  32.  
  33. The sysop of Somerton is Eric Parkin, a good friend of mine.  If you call
  34. his board in the evening or at night, there's a chance you might meet me
  35. or Al (or both) messing around in the live teleconference area.  Such fun
  36. it is to have a BBS that understands multitasking, and has so many phone
  37. lines going into it.  It's running on an Amiga with a 25MHz '030.
  38. But enough about that...  You came here to read about EdPlayer...
  39.  
  40. ----------------------------------------------------------------------------
  41.  
  42. ORGANIZATION OF THESE FILES:
  43.     These docs are organized so that you don't have to read all of them at
  44. once, but can skip to the part you want or need.  Aren't you glad??
  45. As of v2.0, I have split the DOCs into separate files:
  46.  
  47. EdP2.0.Intro.REDME_FIRST
  48.     -- This file.  Please read!!  Then you can fiddle with the buttons.
  49. EdP2.0.Buttons.DOC
  50.     -- After you fiddled, read this if you don't "get it".
  51. EdP2.0.LEDs.DOC
  52.     -- What all the blinking things mean.
  53. EdP2.0.Commands.DOC
  54.     -- Another way of controlling EdP.  ARexx is OPTIONAL!
  55. EdP2.0.ErrorCodes.DOC
  56.     -- Errors and POSSIBLE CAUSES!  Read if/when you get one.
  57.  
  58. NOVICE AMIGA USERS:  Don't be scared by the "ARexx" section!!  You don't
  59. need to know anything about ARexx itself to use EdPlayer commands, in
  60. fact, you don't even NEED ARexx (although it's recommended).  Please
  61. glance at this section.  There are many useful commands, and a lot of
  62. EdPlayer's functions that are too complicated for a simple point-and-click
  63. panel are stored here.
  64.  
  65. ============================================================================
  66.  
  67.                           I N T R O D U C T I O N
  68.  
  69. ============================================================================
  70.  
  71. Hello, and welcome to EdPlayer!!
  72.  
  73. First, distribution:  EdPlayer is shareware.  You can distribute it by any
  74. means, including BBSs, PD disks, and FTP services like AB20, etc.  You can
  75. also distribute EdPlayer with your own programs, as long as you include a
  76. note that EdPlayer is freely distributable, and do not make any copyright
  77. claims on EdPlayer.  If you want to distribute EdPlayer with a commercial
  78. package, please contact me first (address at end of document).  I would
  79. LIKE for you to keep this document with EdPlayer whenever possible, because
  80. many important things are explained here (like EdPlayer's ARexx interface)
  81. that aren't explained anywhere else.  However, if you MUST distribute
  82. EdPlayer without this file, you may.  Also, note that if you distribute the
  83. kd_freq.library, you MUST keep its DOC file with it.  This is explained
  84. later in this file, in the "Buttons" section under "OPEN", the only button
  85. that uses the kd_freq.library.
  86.  
  87.                     EdPlayer is copyright 1992 Ed Mackey.
  88. ----------------------------------------------------------------------------
  89.  
  90. BUT, what IS it??
  91.  
  92. EdPlayer is a music player.  It can play both NoiseTracker modules and
  93. MED version 3.21 (or greater??) modules.  Note that SOME MED 3.00 modules
  94. will work also, however, others will show up as "Unknown or corrupt module"
  95. because MED 3.00 had a serious bug in the module-saving routines (it didn't
  96. word-align the chunks sometimes, and caused other MED players to GURU, but
  97. EdPlayer has a check for this and will only report a "corrupt module"
  98. error).  To fix a MED 3.00 or earlier module, simply load it into MED 3.21
  99. and save it back out as a MODULE.  As far as #?Tracker modules go, I
  100. am now using the ProTracker 1.1b replay routine by Lars "Zap" Hamre/Amiga
  101. Freelancers 1991.  This may make some old NT mods not work properly
  102. anymore, but I think that PT mods are far more popular by now.
  103.  
  104. What EdPlayer can be used for:
  105.  
  106. I had MANY uses in mind as I was designing EdPlayer.  I wanted a music
  107. player that could be used directly for entertainment, or multitask while
  108. the user did word-processing or whatever, and also be able to run from both
  109. ARexx and CLI scripts for use in IFF slide shows, presentations with
  110. background music (AmigaVision, DVideo III, Director 2, etc.), music for
  111. games written in AmigaBasic or other languages for which there are no
  112. music-playing routines available, and basically any situation at all where
  113. someone wants their Amiga to play some tunes.   ;->
  114.  
  115. ----------------------------------------------------------------------------
  116. Starting EdPlayer:  There are four ways to start EdPlayer...
  117.  ---> (1) Workbench Icon.        Brings up some CD-player like controls.
  118.       (2) CLI: "run EdPlayer"    Also brings up the CD controls.
  119.       (3) CLI: "run EdPlayer -i" Brings up a tiny "iconified" WB window.
  120.       (4) CLI: "run EdPlayer -h" NO user interface, ARexx port ONLY!
  121.  
  122. Note that I recommend using the "runback" command rather than "run" if you
  123. have it, so that the CLI window itself can close before EdPlayer does.
  124. NOTE: A simmilar effect can be achieved with "run <NIL: >NIL: EdPlayer".
  125.  
  126. Note that ALL 4 startup methods open the EDPLAYER message port, which can
  127. accept instructions from AREXX (if you have it) as well as the "telled"
  128. command explained in the ARexx section.
  129.  
  130.              *************** STARTUP SCRIPTS *****************
  131.  
  132. As of version 2.0, EdPlayer now attempts to run a startup script IF
  133. ARexx is present when EdP is launched.  The startup script should be
  134. called REXX:Startup.EdP.  An example startup script is contained in
  135. this archive; please modify that to your liking rather than attempting
  136. to create one from scratch.  If you create one from scratch you might
  137. forget some features or something, whereas the provided startup shows
  138. how to set everything.  Of course, if you know all the ARexx commands,
  139. feel free to make one from scratch.
  140.  
  141. Please don't distribute modified startups.
  142. ----------------------------------------------------------------------------
  143.  
  144. OK, now that you know how to run it, you can start playing with it even
  145. before you finish reading these DOCs.  This is because there is an ONLINE
  146. HELP FUNCTION that is self-explanatory.  However, this function includes a
  147. lot of scrolling text, and so when you get tired of reading that, you can
  148. come back here because ALL OF THE ONLINE HELP IS ALSO AVAILABLE HERE IN THE
  149. DOCs.  Plus, some features, like the AREXX port, are ONLY described here in
  150. the DOCs!!
  151.  
  152. ============================================================================
  153.  
  154. Well, go on, play with the buttons; I know it's killing you to sit here
  155. reading this DOC file when you could be messing with new software.
  156.  
  157. ============================================================================
  158.  
  159. OK, so by now you should have some experience with EdPlayer, and if you
  160. bothered to come back here and read this (I hope you did!!) then
  161. you get to see my address and other cool stuff (don't you feel lucky).
  162.  
  163. I personally really hate programs who's DOC files are as big or
  164. bigger than the program itself, and so I'm not too happy about the fact
  165. that despite all my efforts to make this thing user-friendly, I still wound
  166. up with MonsterDOCs.
  167.  
  168. ----------------------------------------------------------------------------
  169.  
  170. If you use EdPlayer, or ESPECIALLY if you would like to use EdPlayer but
  171. there's some little vital feature missing that's stopping you, then I WANT
  172. to hear from you!!
  173.  
  174. For instance, if you have, say, an ASM source code that plays mods
  175. much better than the player built into EdPlayer, send me a copy!  I'll see
  176. if I can include it in the next release or not...  (This is assuming you
  177. can legally send me this copy, and I can legally use it!  If not, DON'T.)
  178.  
  179. At this point I'm also going to suggest maybe possibly sending me a
  180. donation, if you like EdPlayer or want to see improved versions of it.  I'm
  181. not going to expect everyone who sends me mail to give a donation, just the
  182. people who want to see EdPlayer improve, or have found it useful.  Most
  183. people so far have decided to send me $10 for a donation.  That seems
  184. to be a reasonable price.
  185.  
  186. Also I'm open to comments & suggestions about almost every aspect of the
  187. program, with the possible exception of people who think that naming the
  188. "EdPlayer" after myself was an egotistical, stuck-up move.  It's only a
  189. $10 program.  And I'm not a creative naming genius, obviously.  If you think
  190. YOU are, send your much-improved names, money, software, and/or comments to:
  191.  
  192. US mail:                Ed Mackey
  193.                         PO Box 475
  194.                         Wayne, PA 19087
  195.                            * USA *
  196. Or:
  197.     Internet:  ELM4@Lehigh.edu  <== NOTICE, new address from last version!
  198.     IRC: LineNoise
  199.  
  200.     Somerton Telecomm BBS email (see top of this document): Ed Mackey
  201.     Somerton BBS conference room: LineNoise
  202.  
  203. As you might have guessed from the network address, I'm a student at
  204. Lehigh University in Bethlehem, PA.  I'm about to start my senior
  205. year at Lehigh, being a Computer Science major.  This message was written
  206. on July 10, 1992.  I may not be at Lehigh after '93, and I may even move my
  207. home address from Wayne, PA before then, so I didn't provide EITHER of
  208. those US mail addresses here.  The only one I provided is the PO Box in
  209. Wayne (above), which I will keep EVEN if I move, so that address should be
  210. valid for years and years to come.
  211.  
  212. About my brother, Al Mackey:  He just graduated from High School and is
  213. on his way to Rider college.  (Good luck Al!!)  He and I work together
  214. on programs, usually splitting the workload as follows:  All code - me.
  215. All music - Al.  All graphics - first drawn by Al and then modified
  216. and rearranged by myself, making the gfx sort of a 50%/50% project.  This
  217. is the way we did our game Ball, our game MegaBall (Fred Fish #477), and
  218. also this project (EdPlayer).  I'm sorry I can't really distribute a bunch
  219. of Al's great music with this program, but I'm trying to keep the archive
  220. as small as I reasonably can.  Of course, Al uploads a lot of his modules
  221. to our support board, Somerton BBS (215-464-6775), where you can DL them. 
  222.  
  223. ----------------------------------------------------------------------------
  224.  
  225. Thanks for downloading EdPlayer.  Hope you like it....
  226.                                                        --Ed.
  227.