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