home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 September / PCWorld_2002-09_cd.bin / Software / Topware / winamp / wa3install-mad.exe / readme.txt < prev    next >
Text File  |  2002-06-10  |  8KB  |  170 lines
  1. Winamp3 is Copyright 1999-2001 Nullsoft, Inc.
  2. Winamp3 is a trademark of Nullsoft, Inc.
  3.  
  4. Table of Contents:
  5.   About Winamp3
  6.   Some features to try out
  7.   How to start Winamp3
  8.   Some known issues
  9.  
  10.  
  11.     About Winamp3
  12.  
  13.   What is Winamp3? Why Winamp3? Winamp3 is more than an excuse to have "mp3"
  14. built right into our product name. Winamp3 is our attempt to create a
  15. brand new methodology of complete customizability of the media playback
  16. experience via a system of component programming (which adds new functionality
  17. to the program) and a brand-new skinning system (to present the features of
  18. the program to you.) Collectively, this new technology platform is called
  19. Wasabi, or the Wasabi Coding Platform.
  20.  
  21. Our component system gives developers unprecedented access to the program by
  22. encouraging them to build directly upon our coding platform (named Wasabi) and
  23. add brand-new functionality to the entire system. We provide an SDK (downloaded 
  24. separately) packed with working C++ code taken directly from our own components
  25. and Winamp3 itself so developers can immediately start creating great new
  26. components on top of our code.
  27.  
  28.   New functionality is packaged in the form of "components". They are similar
  29. in idea to general-purpose plugins, except Wasabi components can actually
  30. leverage each others' features instead of only using the main Winamp services.
  31. Components can add a new window into the system, or just provide a new type
  32. of service to the system (like decoding a different type of media file, or
  33. displaying a brand-new type of visualization). Winamp3 comes packaged with
  34. some standard components, such as the playlist editor and skin switcher.
  35.  
  36.   Also, we have completely revamped the skinning system. In fact, we have
  37. revamped the entire idea of a skinning system. Winamp3 goes way beyond the
  38. idea of skins that are merely free-form. Our skins are both free-form
  39. and fully scriptable. Skinners (and now, scripters) can invoke nearly any
  40. UI behavior they desire in their skin, from changing a bitmap or vis mode
  41. to dynamically blending and rendering brand new interfaces on the fly.
  42.  
  43.   Another important reason for Winamp3 is portability. Wasabi currently runs on
  44. the win32 platform (Win95/98/NT/ME/2k/XP/TC). We are progressing nicely on a
  45. Linux version as well, and we have plans for more operating
  46. systems/environments to receive support in the future. This means that
  47. components built on the Wasabi Coding Platform will be easily recompilable for
  48. other OSes and architectures, and skins won't need to be modified at all to
  49. be totally portable.
  50.  
  51.  
  52.  
  53.     Some features to try out:
  54.  
  55. - Grab the little resizer control in the lower right and stretch your Winamp3!
  56.  
  57. - Click the eject button to pick some music files on your hard drive and
  58.   play them.
  59.  
  60. - Turn on the crossfader. (The button just to the right of the eject
  61.   button).
  62.  
  63. - Click on the little Winamp logo (the flashing lightning bolt icon in the
  64.   lower right of the main player piece) to bring up the Thinger, if it isn't
  65.   already displaying. The Thinger allows you to open and close component
  66.   windows (like the playlist editor, or the skin switcher, or other components
  67.   you might install) and otherwise interact with the components you have
  68.   installed.
  69.  
  70. - If you are connected to the Internet, open the Shoutcast Server List in the
  71.   Thinger and double-click on a station list (once the list displays) to listen
  72.   to that station.
  73.  
  74. - The media library, availble both through the Thinger and through the "ML"
  75.   button, can sort and display your music collection if it has been tagged
  76.   with ID3 information. At first, your database of music is empty. It grows
  77.   as you add new files to your playlist or when you add more files to it via
  78.   the "add music to db" button in the lower left. It takes a little while
  79.   to read all the info from the files after you add them, but once it's done
  80.   you can try clicking on the available queries to see what it's found.
  81.   Once you find some music, you can drag and drop it into the playlist editor.
  82.   You can also drag-and-drop files from Windows Explorer windows directly
  83.   onto the playlist editor or the main player piece.
  84.  
  85. - Right clicking on the player piece will bring up a menu with some more
  86.   options.
  87.  
  88. - All windows naturally "dock" to each other when they get near. You can undock
  89.   any docked window (including the main player) by holding down either SHIFT
  90.   key while dragging it.
  91.  
  92. - If you hold down the CONTROL and ALT keys while moving a window, every
  93.   window will move along with it.
  94.  
  95. - There's lots more, so explore!
  96.  
  97.  
  98.     How to start Winamp3:
  99.     (as originally written for the internal alphas)
  100.     (on a French keyboard)
  101.     (by a drunken Brennan)
  102.     (with my left pinky)
  103.     (blindfolded)
  104.  
  105. Start Winamp3 via whatever method you prefer. That would mean either clicking
  106. the quickstart icon, the desktop icon, or by projecting your awesome mutant
  107. powers onto a nearby human and exploding their brain in such a way as to cause
  108. variations in the sunspot cycle which causes in turn a freakish burst of
  109. neutrinos to blast forth from the sun's molten innards (the advanced student can
  110. use a nearby star and a buttload of patience) flipping a bit in your computers
  111. Instruction Pointer (usually referred to as IP except on the SPARC platform
  112. which uses the notation PC, for Program Counter) causing it to jump to the
  113. part of Windows that is secretly programmed in at the last second that causes
  114. it to feel remorse for sucking so damned bad and always crashing and deleting
  115. all your work right when you were JUST ABOUT to hit Save, no really you were,
  116. and while wallowing in this black pit of despair and self-loathing it hits it,
  117. hey, I know what would make the world a better place, if I was running
  118. Winamp 3.0, and it does.
  119.  
  120.  
  121.         Notes
  122.  
  123. - About the HTTP reader: 
  124.   The proxy string can be either: "user:password@host:port", "user@host:port" or "host:port"
  125.   If "port" is not specified, 80 is assumed.
  126.  
  127. - About the video support:
  128.   When in fullscreen, you can use any Winamp3 key to control the playback and
  129.   also use the mouse wheel to control volume.
  130.   Doubleclick on the fullscreen window or press "ESC" to go back to normal mode.
  131.  
  132. - About CD playback:
  133.   The CD reader will first try to digitally extract the tracks, so it can
  134.   provide you with gapless and crossfadable output along with visualisation.
  135.   The digital extraction relies on an ASPI manager being installed on your
  136.   computer. It'll also try to use the internal ASPI NT manager, but it might
  137.   not work on all CD drives. If digital extraction doesn't work properly, try
  138.   installing an ASPI manager. Check out the following page for detailed 
  139.   instructions:
  140.  
  141.    http://www.windac.de/eng/sup02.shtml
  142.  
  143.   If ASPI is not found, the WA3 CD playback component will then fallback 
  144.   into a MCI type CD playback (like Winamp 2 does).
  145.  
  146.  
  147.     Some known issues
  148.  
  149. - Configuration is very basic right now, but it's usable. In a few versions
  150.   we hope to have fully skinnable config in a releasable state.
  151.  
  152. - if no file is valid in a playlist, hitting play enters an endless loop
  153.  
  154.  
  155. Found one we missed? Go to http://bugzilla.nullsoft.com:3430/ and help us
  156. out by reporting it. Or email to steve@winamp.com. Or let us know your thoughts
  157. in our forums at http://forums.winamp.com/
  158.  
  159.  
  160.  
  161. Sincerely,
  162.  
  163. Brennan Underwood
  164. Francis Gastellu
  165. Christophe Thibault
  166. Justin Frankel
  167. Steve Gedikian
  168. Mig Gerard
  169.  
  170. and the whole Nullsoft team^H^H^H^Hsemi-digested hunks of meat