home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 12 / MA_Cover_12.iso / ppc / amigaamp / amigaamp.readme < prev    next >
Encoding:
Text File  |  1999-07-03  |  20.9 KB  |  544 lines
  1. Short:    MPEG audio player with GUI (68k/PPC)
  2. Uploader: Thomas Wenzel (wenzel@act-net.com)
  3. Author:   Thomas Wenzel (wenzel@act-net.com)
  4. Type:     mus/play
  5. Version:  2.6
  6.  
  7.  
  8. Homepage
  9. --------
  10. http://amigaamp.amiga-software.com
  11.  
  12.  
  13. Introduction
  14. ------------
  15. AmigaAMP is a GUI based MPEG audio player using mpega.library on the 68k
  16. processor or the amp decoding engine in the PPC version.  Sound is played
  17. back using the AHI audio system.  AmigaAMP is NOT another frontend for the
  18. CLI based mpega.  Anyway, if you've got problems not related to the user
  19. interface but with AHI, AsyncIO or mpega.library, PLEASE contact the
  20. corresponding author directly.  I wouldn't be able to help you in this
  21. case.
  22.  
  23. Important: AmigaAMP is optimized for visual appearance and accuracy, not
  24. for extremely low cpu load!
  25.  
  26. What does that mean? Well...if there's a percussion hit, you see it on the
  27. analyzer immediately. Not half a second later, not half a second earlier.
  28. People who say "I don't care about this, I just want to see some movement in
  29. the display" should use another player :-)
  30.  
  31. However, if anyone has a fast PowerPC and a fast graphics card which ain't
  32. got nothing to do but run the PPC version of Heretic, AmigaAMP is just
  33. right :)
  34.  
  35.  
  36. Requirements (not included in this archive!)
  37. --------------------------------------------
  38. AmigaOS 3.0 or higher
  39. 68030-50MHz processor or better
  40. mpega.library      (Aminet:util/libs/mpega_library.lha)
  41. asyncio.library    (Aminet:dev/c/AsyncIO.lha)
  42. AHI audio system   (Aminet:mus/misc/ahiusr.lha)
  43.  
  44.  For most of the skins:
  45.  - picture.datatype v43
  46.  - ilbm.datatype v44
  47.  - bmp.datatype v40
  48.  
  49.  
  50. An important note on graphics patches
  51. -------------------------------------
  52.  
  53. There are numerous programs around that patch functions of graphics.library
  54. to make some routines faster or to redirect calls to CyberGraphX. I strongly
  55. recommend NOT to use those patches but to upgrade to *real* AmigaOS 3.1 and
  56. use a graphic card instead. GFXPatch made AmigaAMP think it was running
  57. under 3.1 and as a result some other functions didn't work as expected.
  58. PatchWPA8 caused deadlocks because several subprocesses of AmigaAMP may
  59. call the patched routine at the same time. NewWPA8 has been reported to
  60. work so far but I won't rely on that! Now get a soundcard, get a graphics
  61. card, get AmigaOS 3.1 and stop bothering me! :-)
  62.  
  63. Recommended
  64. -----------
  65. PowerUP and ppc.library v46
  66. AmigaOS 3.1 (OS3.1 or CGFX is needed for the internal spectrum analyzer!)
  67.  
  68. Features
  69. --------
  70.  - FREEWARE!  No nag requesters and no expiry date!
  71.  - GadTools based font sensitive user interface
  72.  - Alternatively WinAMP compatible user interface
  73.  - Fast, synchronous spectrum analyzer (almost no latency)
  74.  - Workbench application (you can drop icons on its window)
  75.  - Easily configurable
  76.  - AHI device-level access (uses default audio mode automatically)
  77.  - ID3 tag editor (artist, title, albm, etc.)
  78.  - Visualisation plugin system
  79.  
  80.  - support for:                                         -> file needed:
  81.  
  82.    * hardware based decoders
  83.      -----------------------
  84.      - MPEGit (MPEG audio decoder module for Prelude)   -> libs:prelude.library
  85.  
  86.    * software based decoders
  87.      -----------------------
  88.      - internal PowerUP decoding engine (amp 0.7.6)     -> Engines/Internal
  89.      - mpega.library (either PowerUP, WarpUP or 680x0)  -> libs:mpega.library
  90.      - external decoder plugin (based on whatever)      -> Engines/External
  91.  
  92.  
  93. Limitations
  94. -----------
  95.  - The PPC version doesn't support MPEG2.5
  96.  - No realtime spectrum when using AmigaOS 3.0 without gfx card
  97.  
  98.  
  99. Directory structure
  100. -------------------
  101.  * AmigaAMP
  102.    The main executable, the docs and the icons reside here.
  103.  
  104.  * AmigaAMP/Engines
  105.    This directory contains AmigaAMP's 'internal' PowerUP decoding
  106.    engine. Any third party engines (called 'external') must be copied
  107.    here.
  108.  
  109.  * AmigaAMP/Plugins
  110.    Put all your visualisation plugins in here
  111.  
  112.  * AmigaAMP/Skins
  113.    This is the place for all the graphic extensions (skins)
  114.  
  115. There are two versions of the main executable:
  116.  
  117.  - AmigaAMP        compiled for 68060 (runs on 040, too)
  118.  - AmigaAMP.NoFPU  compiled for processors without FPU
  119.  
  120. History
  121. -------
  122. v2.6  - graphic EQ (PowerPC only!)
  123.       - faster skin loading
  124.       - windows can be set to backdrop and immovable
  125.       - priority slider now affects PowerUP decoder priority as well
  126.         but only after you quit and restart the program
  127.       - finer pitch-control: now four steps per semitone
  128.       - new tooltype PLAYLIST for default playlist to load at startup
  129.       - warning requester if no stereo++ mode ist selected for AmigaAMP's
  130.         AHI unit
  131.       - Dropping files on the playlist window now adds them to the list
  132.         instead of replacing the old ones
  133.  
  134. v2.5  - removed a routine that caused problems with some AHI installations
  135.         (SP2)
  136.       - less clicking noise when starting MP3 playback on MPEGit (SP1)
  137.       - fixed a bug in the playlist saver which caused the filenames to
  138.         be truncated sometimes
  139.       - extended plugin data available including title, artist and more
  140.       - Fixed the PowerUP based MP2 decoder (thanks to Jan Uerpmann!)
  141.       - new decoder plugin system, can be configured from within AmigaAMP
  142.       - sealed some memory leaks
  143.       - Ahi.device will be closed every time you hit the stop button. If
  144.         you don't want this to happen, tick "keep AHI open" in the config
  145.         window.
  146.       - ID3v2 support (currently read-only)
  147.       - better variable-bitrate (vbr) mpeg support
  148.       - ready for graphic eq, but not yet built in
  149.       - NewMouse support (Aminet:hard/misc/NewMouse11.lha)
  150.  
  151. v2.4  - Due to lack of time it may take a while until I can answer your
  152.         email. Perhaps I won't be able to answer it at all :-(
  153.         You can be sure that I _read_ each and every mail. I'm always
  154.         happy to receive feedback :)
  155.       - visualisation plugins didn't receive data when AmigaAMP was run
  156.         in GadTools mode -- fixed that
  157.       - yet another bug in the ID3 loader/saver detected and eliminated
  158.       - new fullscreen plugin added to the distribution archive
  159.       - built in visualisation now supports cybergraphics as well
  160.  
  161. v2.3  - reworked the skin display once again
  162.       - 68k based spectrum analyzer that works with mpega.library, too
  163.         (68060 processor and/or PPC version of mpega needed)
  164.       - visualisation plugin system (only makes sense when using the
  165.         internal PPC decoder)
  166.       - fixed a bug that caused some MP3s to be treated as playlists
  167.       - activated shuffle gadget now shuffles the playlist each time
  168.         you start playing the first track
  169.       - included an 060 optimized version
  170.  
  171. v2.2  - better CyberGraphX compatibility
  172.       - editable playlist including loading and saving (from the menu)
  173.       - time/remain display
  174.       - freaky animation in the bottom right corner :)
  175.       - autoscrolling song/artist text in WinAMP mode
  176.       - skin display while loading on highcolor/truecolor screens
  177.       - random play (shuffle)
  178.       - more alphabetically sorted genres
  179.       - key sensitive genre requester
  180.       - pitch shift (+ and - keys on numeric keypad, * resets speed)
  181.       - improved PUBSCREEN and SCREENMODE capabilities
  182.       - fixed internal crossfader
  183.         Start two aamps and hold shift while dragging the volume slider
  184.       - support for 'nums_ex' and 'volbar' named skin images
  185.  
  186. v2.1  - configurable playback buffer size (should cure many problems!)
  187.       - fixed a bug that caused truecolor skins to be dithered even on
  188.         truecolor screens
  189.       - Skin pictures can have any extension you like as long as the name
  190.         is correct.
  191.       - Fixed a bug in the PPC loader for 48 kHz MPEGs
  192.       - asynchronous filerequester
  193.       - Skins can be reloaded at any time.
  194.       - auto-play after opening a file if playback was active before opening
  195.       - corrected some skin positions
  196.       - visualisation for the 68k version, too (level meters)
  197.       - MaxFreq finally works
  198.  
  199. v2.0  - so many changes it was worth bumping the version number :-)
  200.       - position of genre listview gadget fixed
  201.       - fixed bugs when playing mono or 22.05 kHz files
  202.       - digital volume control
  203.       - AREXX interface (see AREXX.readme)
  204.       - automatic detection if another AmigaAMP task is already
  205.         running
  206.       - alphabetically sorted playlist (not editable yet)
  207.       - configurable buffersize
  208.       - WinAMP lookalike GUI (see below)
  209.       - Improved fontsensitivity of old GUI
  210.       - cached taginfo -- will be written when the file is closed
  211.  
  212. v1.1  - name changed to AmigaAMP
  213.       - PPC version
  214.       - ID3 tag editor
  215.       - commandline support
  216.  
  217. v1.0  - initial release called MPEGAHI
  218.  
  219. Getting started (configuration)
  220. -------------------------------
  221. Important! You need a properly installed and configured AHI audio system
  222. to run AmigaAMP. Without a correct setup the sound may be very poor and
  223. AHI will draw too much CPU power!
  224.  
  225. First of all run the AHI setup program in your Prefs drawer. Select
  226. one of the units from 0 to 3 but not the Music unit. If you don't use
  227. unit 0 for anything already I recommend using that one.
  228.  
  229. Select one of the "fast stereo++" audiomodes that matches your audio
  230. hardware. For Prelude playback I recommend "Prelude:Fast 16 bit stereo++
  231. realtime".
  232.  
  233. Now you need to know what sampling rate most of your MPEG files
  234. have. Probably it's 44100 Hz because that's the standard CD rate. If
  235. you have a slow processor you may want to run AmigaAMP in frequency division
  236. mode to reduce CPU load. Have a look at the table below for the recommended
  237. settings.
  238.  
  239. It is important to set the frequency slider to your mostly used frequency
  240. divided by your chosen frequency divisor. For example, if you're going to
  241. playback lots of 44100 Hz MPEGs and frequency division is 1:2, set the
  242. Frequency slider to 22050 Hz.
  243.  
  244. If you don't plan to have several programs playing back audio at the
  245. same time, please leave the Channels slider at position 1. The remaining
  246. settings depend on your audio hardware.
  247.  
  248. Ok, press the "Save" button in the bottom left corner.
  249.  
  250. Now it's time to configure AmigaAMP itself. If you've chosen another
  251. AHI device than 0, you have to change the AHIUNIT tooltype of AmigaAMP
  252. first. If not, just start it by double clicking on its icon and pop up
  253. the setup window by chosing Config... from the menu.
  254.  
  255. Set the sliders and checkmarks to the recommended settings, save them using
  256. the menu and close the settings window again.
  257.  
  258. That's it! AmigaAMP is now configured. You may want to fine-tune the
  259. settings later. The overall performance depends on the speed of mpega.library
  260. AND the the speed of your soundcard's AHI driver.
  261.  
  262. Recommended settings (tested with Prelude:Fast 16 bit stereo++ realtime)
  263. ------------------------------------------------------------------------
  264.  
  265.           |     Layer 1/2        |        Layer 3
  266. Processor | Quality|FreqDiv|Mono | Quality|FreqDiv|Mono
  267. ----------+--------+-------+-----+--------+-------+-----
  268. 68040-40  |  high  |  1:2  | off | medium |  1:2  | on 
  269. 68060-50  |  high  |  1:1  | off |  high  |  1:1  | off
  270. PPC604e   |  high  |  1:1  | off |  high  |  1:1  | off
  271.  
  272. Note: In fact only the 68k version is affected by these settings.
  273.  
  274.  
  275. Advanced settings
  276. -----------------
  277. * Bufsize:
  278. Set the size of the read ahead buffer. Try playing with it until you
  279. get best results. (Normally 16 to 32K is best)
  280. Setting the buffersize to FILE means that the read ahead buffer will
  281. be as large as the current track eliminating all disk access during
  282. play. Attention! This option isn't 100% stable yet!
  283.  
  284. * TaskPri:
  285. Set the running task priority of AmigaAMP. The recommended value for
  286. uninterrupted playback is 1. God knows what happens if some 3rd party
  287. task rescheduler starts fiddling around with AmigaAMP's internal task
  288. priorities...
  289.  
  290. * Read ID3 TagInfo
  291. Try to read information about artist, title, etc. Because those are stored
  292. at the end of the file it may slow down loading a bit. If this function
  293. is switched off, TagInfo can neither be edited nor saved!
  294.  
  295. * Allow multiple instances
  296. Normally when you click on an MPEG file project icon while AmigaAMP is
  297. already playing another one, no second AmigaAMP task will be launched but
  298. the already running task will start playing the new file. This behaviour
  299. can be switched off. You have to start AmigaAMP twice manually and then
  300. save the config with "Allow multiple instances" switched on from both
  301. running tasks.
  302.  
  303. * Limit volume to 0dB
  304. The volume slider ranges from silence to +6dB volume so that you can boost
  305. more silent recordings. If you don't want to turn the volume above normal
  306. accidentally, you can switch on this option.
  307.  
  308. * ToolType: MPEGIT
  309. REMOVED! Please use the "Engines" cycle gadget instead.
  310.  
  311. * ToolType: DIRECTORY
  312. Default directory to display in filerequester.
  313.  
  314. * ToolType/Keyword: SCREENMODE
  315. Tell AmigaAMP to use its own screen. The mode has to be specified in
  316. decimal or hexadecimal format. Hex values have to be preceeded by
  317. <0x> or <$>. Example: SCREENMODE=0x50021303
  318.  
  319. * ToolType/Keyword: PUBSCREEN
  320. Name of the public screen that AmigaAMP will display its GUI on.
  321. Example: PUBSCREEN=DOPUS.1
  322.  
  323. Usage (how to load and play sounds)
  324. -----------------------------------
  325. Most of the buttons should be self-explanatory because they can be found
  326. on almost every CD player or tapedeck. However, as a computer program,
  327. AmigaAMP is based on files, so there may be slight differences. The bottom
  328. line buttons from left to right are:
  329.  
  330.  - Eject      Stops playback, empties the current playlist and opens a
  331.               requester to select one or more files
  332.  - Skip back  Moves to the previous track in the playlist if there is one.
  333.  - Stop       Simply stops playback. (What else did you expect? :-)
  334.  - Play       Starts playback if there's at least one track in the current
  335.               playlist. If it's not, opens a requester to select tracks.
  336.  - Skip fwd   Moves to the next track in the playlist if there is one.
  337.  - Pause      Pauses playback at the current position
  338.  
  339. Just above the control button's there's a position slider. As you play
  340. a file, it's button moves from left to right to display the relative
  341. playback position within the current track. You can use the mouse to drag
  342. this slider to a new position.
  343.  
  344. Keyboard shortcuts
  345. ------------------
  346. CURSOR RIGHT        skip 10s forward
  347. CURSOR LEFT         skip 10s backward
  348. CURSOR UP           increase volume
  349. CURSOR DOWN         decrease volume
  350. SPACE               play/stop
  351. P                   pause
  352. NUM +               increase speed by one semitone
  353. NUM -               decrease speed by one semitone
  354. NUM *               normal playback speed
  355. Z                   skip back one track
  356. X                   play
  357. C                   pause
  358. V                   stop
  359. B                   skip fwd one track
  360. N                   eject
  361.  
  362. About the WinAMP GUI
  363. --------------------
  364. Since WinAMP v1.80 you can load customizeable textures (so called skins) for
  365. the GUI. The skins consist of several bitmapped pictures together in one
  366. directory and contain the the look of the window itself as well as images
  367. for all the gadgets. Because more and more people ask me to make AmigaAMP
  368. look like WinAMP I now included an alternative GUI routine that can load
  369. those WinAMP skins!
  370.  
  371. To keep the archive small I'm just including the base skin from now on.
  372.  
  373. To activate one of those GUIs you have to switch on "Skin display" in the
  374. config window.
  375.  
  376. Although the pictures all have the extension .iff they can be any format
  377. that you have a datatype for. If you find a working BMP datatype (try
  378. loading the pictures with multiview first) you can even copy WinAMP skins
  379. direcly. AmigaAMP will try to load pictures with different extensions
  380. automatically.
  381.  
  382.  
  383. Legal stuff
  384. -----------
  385. AmigaAMP is copyrighted freeware. It may be distributed freely as long as
  386. no modifications are made to the executable and this document. A nominal
  387. fee may be asked to cover distribution costs.
  388.  
  389. AmigaAMP may not be used for any commercial purposes or included with any
  390. commercial product without the written permission of the author. It may not
  391. be advertised, offered or distributed together or in conjunction with
  392. commercial products. The only exception is the Aminet archive.
  393.  
  394. AmigaAMP makes use of the MPEG Layer-3 audio compression technology licensed
  395. by Fraunhofer IIS and THOMSON multimedia.
  396.  
  397. No responsibilities are taken for damaged speakers, amplifiers, Amigas
  398. or any other components or data involved while using AmigaAMP.
  399.  
  400. Although I've done some beta testing I can't guarantee that AmigaAMP will
  401. not crash! If you find any bugs, let me know.
  402.  
  403. Here's the original amp.readme:
  404. -------------------------------
  405. amp MPEG audio decoder readme file (version 0.7.5)
  406. (C) Tomislav Uzelac  1996,1997
  407.  
  408. amp is free software and can be _used_ freely by anyone. If you want to
  409. do anything else with it, be sure to check the Legal section of this
  410. document for legal issues.
  411.  
  412. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  413. of this document.
  414.  
  415. 1. Introduction
  416. 2. Installation
  417. 3. Running
  418. 4. Feedback
  419. 5. Contributing
  420. 6. Legal
  421.  
  422.  
  423. 1. Introduction
  424.  
  425. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  426. putting together as a side project of the MPEG hardware design project at 
  427. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  428. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  429. defined in MPEG2), layers 2 and 3. 
  430.  
  431. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  432. available at the amp home site ftp://ftp.rasip.fer.hr
  433.  
  434. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  435.  
  436. The following people contributed their time and knowledge to amp:
  437. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  438. Edouard Lafargue, Andrew Richards, George Colouris,
  439. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  440.  
  441. amp home location is
  442.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  443.  
  444. and the mailing list: send 'HELP' in the body of the message to:
  445.     multimedia@rasip.fer.hr
  446.  
  447. If you want to find out more about MPEG, best places to start are
  448.     http://www.mpeg.org
  449.     http://www.mpeg2.de 
  450.  
  451.  
  452. 2. Installation
  453.  
  454. Installation should be simple enough if amp was ported to your system,
  455. just do a 
  456.  
  457. ./configure
  458. make 
  459.  
  460. You can edit the makefile further to suit your system. If configure fails 
  461. to make a usable Makefile, you'll _have_ to edit it yourself.
  462.  
  463. Linux users should try real-time playing support, as described
  464. in doc/realtime.txt. Some people that might pass on this feature are
  465. those with slower machines (i.e. 486's), or SMP systems (see the
  466. doc/linuxrealtime.txt file). 
  467. Some versions of the linux C library produce an error when compiling
  468. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  469. and replace _P in the offending line with __P.
  470.  
  471. ./configure --enable-realtime
  472. make
  473. chown root.root amp
  474. chmod u+s amp
  475.  
  476. ... this requires /dev/dsp to be both world readable and writeable. If you
  477. have a special group for people allowed to use the sound device (for
  478. instance, a group called sound), you can do a:
  479.  
  480. chmod g+s amp
  481.  
  482. or make your audio card world read/writeable (not recomended)
  483.  
  484. chmod o+rw /dev/dsp*
  485.  
  486. 3. Running:
  487.  
  488. 'amp -h' gives you usage & options. If your computer is on the slower
  489. side, direct playback might not work, but you can decode it
  490. to .wav or raw pcm and play it later.
  491.  
  492.  
  493. 4. Feedback
  494.  
  495. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  496. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  497.  
  498. If you find any mpeg audio files that amp has trouble decoding, please tell
  499. me about this via e-mail <tuzelac@rasip.fer.hr>.
  500.  
  501.  
  502. 5. Contributing
  503.  
  504. Please contribute to amp. If you want to know what is going on in amp 
  505. development, you can join the developers mailing list
  506.  
  507.     mpeg_audio_developers@rasip.fer.hr
  508.  
  509. There are certain debugging facilities that I made in amp, but are disabled
  510. in the current release (they are neither nice nor user-friendly). If anyone
  511. enhances them (they are in dump.c) to the point that they're actually
  512. usable I'll be happy to include the changes in the release. I think this
  513. kind of debug output would be very useful to people studying these audio
  514. algorithms.
  515.  
  516.  
  517. 6. Legal
  518.  
  519. This software can be used freely for any purpose. It can be distributed
  520. freely, as long as it is not sold commercially without permission from
  521. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  522. on CD_ROMs containing other free software is explicitly permitted even 
  523. when a modest distribution fee is charged for the CD, as long as this
  524. software is not a primary selling argument for the CD.
  525.  
  526. Building derived versions of this software is permitted, as long as they
  527. are not sold commercially without permission from Tomislav Uzelac 
  528. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  529. such, and must be called by a name other than amp. Any derived versions
  530. must retain this copyright notice.
  531.  
  532. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  533.  * not mention being copyrighted itself :)
  534.  */
  535.  
  536. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  537. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  538. any damages that might occur to your computer, software, etc. in
  539. consequence of you using this freeware program.
  540.  
  541.  
  542. Tomislav Uzelac
  543. <tuzelac@rasip.fer.hr>
  544.