home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 June / PCWorld_2002-06_cd.bin / Software / Topware / winamp / wa3install_beta3.exe / readme.txt < prev    next >
Text File  |  2002-02-14  |  16KB  |  417 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.   What's new (version history)
  10.  
  11.  
  12.     About Winamp3
  13.  
  14.   What is Winamp3? Why Winamp3? Winamp3 is more than an excuse to have "mp3"
  15. built right into our product name. Winamp3 is our attempt to create a
  16. brand new methodology of complete customizability of the media playback
  17. experience via a system of component programming (which adds new functionality
  18. to the program) and a brand-new skinning system (to present the features of
  19. the program to you.) Collectively, this new technology platform is called
  20. Wasabi, or the Wasabi Coding Platform.
  21.  
  22. Our component system gives developers unprecedented access to the program by
  23. encouraging them to build directly upon our coding platform (named Wasabi) and
  24. add brand-new functionality to the entire system. We provide an SDK (downloaded 
  25. separately) packed with working C++ code taken directly from our own components
  26. and Winamp3 itself so developers can immediately start creating great new
  27. components on top of our code.
  28.  
  29.   New functionality is packaged in the form of "components". They are similar
  30. in idea to general-purpose plugins, except Wasabi components can actually
  31. leverage each others' features instead of only using the main Winamp services.
  32. Components can add a new window into the system, or just provide a new type
  33. of service to the system (like decoding a different type of media file, or
  34. displaying a brand-new type of visualization). Winamp3 comes packaged with
  35. some standard components, such as the playlist editor and skin switcher.
  36.  
  37.   Also, we have completely revamped the skinning system. In fact, we have
  38. revamped the entire idea of a skinning system. Winamp3 goes way beyond the
  39. idea of skins that are merely free-form. Our skins are both free-form
  40. and fully scriptable. Skinners (and now, scripters) can invoke nearly any
  41. UI behavior they desire in their skin, from changing a bitmap or vis mode
  42. to dynamically blending and rendering brand new interfaces on the fly.
  43.  
  44.   Another important reason for Winamp3 is portability. Wasabi currently runs on
  45. the win32 platform (Win95/98/NT/ME/2k/XP/TC). We are progressing nicely on a
  46. Linux version as well, and we have plans for more operating
  47. systems/environments to receive support in the future. This means that
  48. components built on the Wasabi Coding Platform will be easily recompilable for
  49. other OSes and architectures, and skins won't need to be modified at all to
  50. be totally portable.
  51.  
  52.  
  53.  
  54.     Some features to try out:
  55.  
  56. - Grab the little resizer control in the lower right and stretch your Winamp3!
  57.  
  58. - Click the eject button to pick some music files on your hard drive and
  59.   play them.
  60.  
  61. - Turn on the crossfader. (The button just to the right of the eject
  62.   button).
  63.  
  64. - Click on the little Winamp logo (the flashing lightning bolt icon in the
  65.   lower right of the main player piece) to bring up the Thinger, if it isn't
  66.   already displaying. The Thinger allows you to open and close component
  67.   windows (like the playlist editor, or the skin switcher, or other components
  68.   you might install) and otherwise interact with the components you have
  69.   installed.
  70.  
  71. - If you are connected to the Internet, open the Shoutcast Server List in the
  72.   Thinger and double-click on a station list (once the list displays) to listen
  73.   to that station.
  74.  
  75. - The media library, availble both through the Thinger and through the "ML"
  76.   button, can sort and display your music collection if it has been tagged
  77.   with ID3 information. At first, your database of music is empty. It grows
  78.   as you add new files to your playlist or when you add more files to it via
  79.   the "add music to db" button in the lower left. It takes a little while
  80.   to read all the info from the files after you add them, but once it's done
  81.   you can try clicking on the available queries to see what it's found.
  82.   Once you find some music, you can drag and drop it into the playlist editor.
  83.   You can also drag-and-drop files from Windows Explorer windows directly
  84.   onto the playlist editor or the main player piece.
  85.  
  86. - Right clicking on the player piece will bring up a menu with some more
  87.   options.
  88.  
  89. - All windows naturally "dock" to each other when they get near. You can undock
  90.   any docked window (including the main player) by holding down either SHIFT
  91.   key while dragging it.
  92.  
  93. - If you hold down the CONTROL and ALT keys while moving a window, every
  94.   window will move along with it.
  95.  
  96. - There's lots more, so explore!
  97.  
  98.  
  99.     How to start Winamp3:
  100.     (as originally written for the internal alphas)
  101.     (on a French keyboard)
  102.     (by a drunken Brennan)
  103.     (with my left pinky)
  104.     (blindfolded)
  105.  
  106. Start Winamp3 via whatever method you prefer. That would mean either clicking
  107. the quickstart icon, the desktop icon, or by projecting your awesome mutant
  108. powers onto a nearby human and exploding their brain in such a way as to cause
  109. variations in the sunspot cycle which causes in turn a freakish burst of
  110. neutrinos to blast forth from the sun's molten innards (the advanced student can
  111. use a nearby star and a buttload of patience) flipping a bit in your computers
  112. Instruction Pointer (usually referred to as IP except on the SPARC platform
  113. which uses the notation PC, for Program Counter) causing it to jump to the
  114. part of Windows that is secretly programmed in at the last second that causes
  115. it to feel remorse for sucking so damned bad and always crashing and deleting
  116. all your work right when you were JUST ABOUT to hit Save, no really you were,
  117. and while wallowing in this black pit of despair and self-loathing it hits it,
  118. hey, I know what would make the world a better place, if I was running
  119. Winamp 3.0, and it does.
  120.  
  121.  
  122.         Notes
  123.  
  124. - About the HTTP reader: 
  125.   The proxy string can be either: "user:password@host:port", "user@host:port" or "host:port"
  126.   If "port" is not specified, 80 is assumed.
  127.  
  128. - About the video support:
  129.   When in fullscreen, you can use any Winamp3 key to control the playback and
  130.   also use the mouse wheel to control volume.
  131.   Doubleclick on the fullscreen window or press "ESC" to go back to normal mode.
  132.  
  133. - About CD playback:
  134.   The CD reader will first try to digitally extract the tracks, so it can
  135.   provide you with gapless and crossfadable output along with visualisation.
  136.   The digital extraction relies on an ASPI manager being installed on your
  137.   computer. It'll also try to use the internal ASPI NT manager, but it might
  138.   not work on all CD drives. If digital extraction doesn't work properly, try
  139.   installing an ASPI manager. Check out the following page for detailed 
  140.   instructions:
  141.  
  142.    http://www.windac.de/eng/sup02.shtml
  143.  
  144.   If ASPI is not found, the WA3 CD playback component will then fallback 
  145.   into a MCI type CD playback (like Winamp 2 does).
  146.  
  147.  
  148.     Some known issues
  149.  
  150. - Configuration is very basic right now, but it's usable. In a few versions
  151.   we hope to have fully skinnable config in a releasable state.
  152.  
  153. - if no file is valid in a playlist, hitting play enters an endless loop
  154.  
  155.  
  156. Found one we missed? Go to http://bugzilla.nullsoft.com:3430/ and help us
  157. out by reporting it. Or email to steve@winamp.com. Or let us know your thoughts
  158. in our forums at http://forums.winamp.com/
  159.  
  160.  
  161.  
  162. Sincerely,
  163.  
  164. Brennan Underwood
  165. Francis Gastellu
  166. Christophe Thibault
  167. Justin Frankel
  168. Steve Gedikian
  169. Mig Gerard
  170.  
  171. and the whole Nullsoft team^H^H^H^Hsemi-digested hunks of meat
  172.  
  173.  
  174.  
  175.     What's new:
  176. 3.0 Beta 3 days (02/08/02) build #466
  177. - video playback! (still experimental)
  178. - ogg vorbis, MIDI and MOD support!
  179. - popup menus work better
  180. - faster startup
  181. - more config options
  182. - color controls faster and better (any skin can now have color themes)
  183. - all known skin reload issues resolved
  184. - better desktopalpha support
  185. - ns_database moved into component
  186. - http proxy support
  187. - xml errors handled better
  188. - adding files to library and loading playlists MUCH faster now
  189. - component code can now hook skin functions (see SDK for examples)
  190. - many many bugs fixed, not so many added this time :)
  191. - and lots more, so explore!
  192.  
  193.  
  194. 3.0 Beta 2.5 weirzbowski (12/18/01) build #455
  195. - mostly bugfixes, and lots of em
  196. - playlists:
  197.     - load somewhat faster
  198.     - directory entries loaded only when needed
  199.     - number column auto-resizes
  200.     - editor accepts dropped playlists
  201. - popup menus don't stack up against the right side of the screen
  202. - minibrowser works again (woo?)
  203. - skin reloading crash fixed
  204. - skin pieces scale amount linked among layouts
  205. - internal NT aspi manager support in CDDA
  206.  
  207.  
  208. 3.0 Beta 2 cold (11/28/01) build #454
  209. - lots of bugfixes!
  210. - media playback:
  211.     - more accurate timekeeping
  212.     - CD audio playback! Uses digital extraction of audio so it works
  213.       with the crossfader and eq! Falls back to normal redbook audio
  214.       playback if ASPI layer not installed, see above
  215.     - long playback time crash bug fixed
  216. - skinning improvements:
  217.     - superslow loading bug fixed
  218.     - zipped skin loading bug fixed
  219.     - per-pixel alpha blending against the desktop! (in win2k/xp only)
  220.     - subtractable region objects (good for rounded corners etc.)
  221.     - more objects can be made ghosted
  222.     - generic frame support, skin one layout and wrap it around anything
  223.     - antialiased font support
  224.     - upside-down fonts bug fixed
  225.     - vertical sliders fixed
  226. - playlist editor:
  227.     - windowshade mode
  228.     - more robust m3u loading
  229. - config!
  230.     - this is the very basic version so you can play. by beta3 we should
  231.       have more fully skinnable config screens
  232.  
  233.  
  234. 3.0 Beta 1 love (10/09/01) (developer's) build #448
  235. - mostly finalized all interfaces so developers can get busy
  236. - config file in sexy XML now
  237. - crossfader switchable again
  238. - crossfade on next/previous works
  239. - playlist editor:
  240.     - faster, better, more stable
  241.     - shuffle on next now default behavior
  242.     - sorting by specific criteria, more general sorting to come later
  243.     - .pls loading
  244.     - no more "working playlist", now whatever playlist is showing is the
  245.       playlist being edited, always
  246.     - prioritizes ID3 reading for items you're looking at
  247.     - sexy skinned drop indicator
  248.     - playlist saving works again
  249.     - url selector remembers recent entries
  250. - skinning:
  251.     - groups work better
  252.     - many components now scalable (not working 100% yet)
  253.     - skins start out centered on screen on first load
  254.     - gamma groups! tintastic!
  255. - memory usage reduced
  256. - finally, some better buttons than the ones I made in MS Paint on my laptop
  257.   with a touchpad (thanks Steve!)
  258. - many many bugfixes, including the NT4 startup crash
  259. - even better SDK
  260. - lots more!
  261.  
  262.  
  263. 3.0 Alpha L8r (08/24/01) build #441
  264. - apparently we still have jobs (some of us)
  265. - so we fix the bugs
  266. - fixed assert on playlist editor's "select dups" and "delete dups" options
  267. - fixed the minimize bug
  268. - added "open location" and "open dir" options
  269. - re-enabled volume & eq settings saving (it's not a bug if it's just
  270.   commented out, right?)
  271. - p.s. to use Mozilla you also have to set
  272.   "Use Mozilla instead of IE for minibrowser=1" in studio.xnf
  273.  
  274.  
  275. 3.0 Alpha L8 (08/22/01) build #440
  276. - much faster startup time
  277. - systray ASSERT should really really be fixed now
  278. - 8-bit UTF-8 playlist names work, 16-bit ones still don't
  279. - lots more text now translated through locales system
  280. - improved component painting (more efficient, less wrong)
  281. - faster skin loading (caches unpacked skins into temp directory)
  282. - faster playlist loading
  283. - can select mozilla to be used in the minibrowser
  284.   -> go to the mozilla folder and type "regsvr32 mozctlx.dll"
  285. - ID3 tags read on a timer
  286. - many and vast improvements to the UI subsystem
  287. - hokey transparent context menus (under win2k, just 'cause they look cute)
  288. - bugs fixed, added
  289.  
  290.  
  291. 3.0 Alpha 667 (06/28/01)
  292. - autodetects MMX, no need for separate noMMX version any more
  293. - immediate music stop on shutdown
  294. - fixed systray ASSERT on WINE & litestep
  295. - mouse wheel scrolling for list windows
  296. - scripting:
  297.     - engine speedups
  298.     - mc.exe supports #include, #define, #undef, #ifdef, etc.
  299. - skinning:
  300.     - fx objects (like dmove) work on subbitmaps
  301.     - faster blitting
  302.     - more options for various GUI objects
  303.     - F5 reloads current skin
  304.     - BMP files work again (bleh... use PNG)
  305. - basic translation of strings, not everything is translated yet :)
  306. - keyboard accelerator keys
  307. - text scale up/down (use control-minus and control+equals)
  308. - truetype font loading from skins works again (no need to install into OS)
  309. - skin colors overriding in skins should work again
  310. - new script included: MiniKick
  311. - skin switcher! with preliminary wa2 skin loading support (not finished)
  312. - skin version # checking
  313. - select duplicates command in playlist editor
  314. - memory usage cut down in general
  315. - config screen almost ready (not in this alpha, tho :)
  316. - lots and lots of other internals stuff you won't see until the SDK :)
  317.  
  318.  
  319. 3.0 Alpha 666 (05/21/01) build #429
  320. - better http streaming
  321. - more responsive interface
  322. - better seeking
  323. - image loading done by components
  324. - faster startup
  325. - preliminary support for winamp 2.x visualizations
  326. - less memory usage
  327. - better crossfading (no more clicks we hope)
  328. - Shuffle on next added, edit your .xnf file to turn it on
  329. - skin love:
  330.   - faster skin switching/loading
  331.   - faster gamma tweaking
  332.   - GDI resource usage cut way down
  333.   - faster MMX optimized blitting
  334.   - bilinear filtering for stretched skin pieces
  335.   - snap points for funky-shaped skin piece love
  336. - more scripting amazingness:
  337.   - guru meditations slightly more helpful
  338.   - faster execution
  339.   - general purpose scripts
  340.   - script manager to add/remove general purpose scripts
  341. - basic field editing in dbexplorer, which will probably go into the media lib
  342. - sclist for shoutcast browsing pleasure
  343. - bugs fixed, added
  344.  
  345.  
  346. 3.0 Alpha 6 e (4/20/01) build #420
  347. - takes even less memory, smaller .exe, more stable (as usual ;)
  348. - playlist editor ASSERT bug smushed
  349. - working playlist thingy
  350. - fixed bug where files dropped on bottom of playlist showed up on top
  351. - faster window painting and resizing and shit
  352. - new avs with overlay support!
  353. - skinning:
  354.   - skin xml can include other skins' xml files for tinyness
  355.   - skin pieces can hold multiple components
  356.   - all-in-one skin ("Compact") included, takes up only about 5k
  357.   - added support for horizontal animations
  358. - accurate animatedrects are back :)
  359. - eq latency cut to 2 seconds instead of 7
  360. - eq has sexy curves again!
  361. - skin scripts can have user functions and user classes
  362. - automatically updated build numbers to aid conspiracy theorists
  363. - http status messages added
  364. - more... much more... can't remember
  365.  
  366.  
  367. 3.0 Alpha 5 UX (03/16/01)
  368. - working eq?!
  369. - even smaller default skin
  370. - fixed-width bitmap fonts
  371. - logical font names for various text objects, yay for skinners
  372. - playlists load now
  373. - open/save file dialogs remember last dir opened from/saved to
  374. - less AVS bugs
  375. - even better skin switching
  376. - did someone say scaling? =)
  377.  
  378.  
  379. 3.0 Alpha 4 n1c8 (02/13/01)
  380. - speed and size optimizations (about 18k cut from exe+dll)
  381. - far more functional playlist editor
  382.   - remembers last playlist open & vertical scroll position
  383. - skins can now overlay default.wal, so you don't have to include one of every
  384.   single bitmap from it
  385. - core playback bugs fixed
  386. - min/max sizing for components implemented
  387. - skin piece scaling!
  388. - better skin switching
  389. - component status bar now skinnable
  390. - http streaming leaks less memory
  391. - plus lots of little bugfixes & tweaks
  392.  
  393.  
  394. 3.0 Alpha 3.00ZX (02/01/01):
  395. - uses WAY less cpu when playing files.
  396. - packaged with latest SuperPimp.
  397. - volume is now saved.
  398. - optimized visual animations (sound analyzer, etc...)
  399. - "Report bugs" option in system menu
  400. - gamma component! (warning: does not actually tweak gamma)
  401. - LOTS of bugfixes including:
  402.   - skin switching 99% works!
  403.   - crossfading fixed and can now crossfades mono streams
  404.   - avs fixes
  405.   - song name display fixed
  406.   - audio playback system fixed
  407.   - playlist editor time display fixed
  408.   - a lot more :) Check our bugzilla for more
  409.  
  410.  
  411. 3.0 Alpha 2 turbo (01/27/01):
  412. - Fixed lots of bitmaps, scroll bars. Mostly cosmetic stuff.
  413.  
  414.  
  415. 3.0 Alpha 1 turbo (01/27/01):
  416. - Everything. :)
  417.