aboutsummaryrefslogtreecommitdiff
path: root/musikcube_win32_with_milkdrop2_0.98.1/plugins/Milkdrop2/docs/milkdrop.html
diff options
context:
space:
mode:
authorIndrajith K L2022-12-03 17:00:20 +0530
committerIndrajith K L2022-12-03 17:00:20 +0530
commitf5c4671bfbad96bf346bd7e9a21fc4317b4959df (patch)
tree2764fc62da58f2ba8da7ed341643fc359873142f /musikcube_win32_with_milkdrop2_0.98.1/plugins/Milkdrop2/docs/milkdrop.html
downloadcli-tools-windows-f5c4671bfbad96bf346bd7e9a21fc4317b4959df.tar.gz
cli-tools-windows-f5c4671bfbad96bf346bd7e9a21fc4317b4959df.tar.bz2
cli-tools-windows-f5c4671bfbad96bf346bd7e9a21fc4317b4959df.zip
Adds most of the toolsHEADmaster
Diffstat (limited to 'musikcube_win32_with_milkdrop2_0.98.1/plugins/Milkdrop2/docs/milkdrop.html')
-rw-r--r--musikcube_win32_with_milkdrop2_0.98.1/plugins/Milkdrop2/docs/milkdrop.html1427
1 files changed, 1427 insertions, 0 deletions
diff --git a/musikcube_win32_with_milkdrop2_0.98.1/plugins/Milkdrop2/docs/milkdrop.html b/musikcube_win32_with_milkdrop2_0.98.1/plugins/Milkdrop2/docs/milkdrop.html
new file mode 100644
index 0000000..5d12d5a
--- /dev/null
+++ b/musikcube_win32_with_milkdrop2_0.98.1/plugins/Milkdrop2/docs/milkdrop.html
@@ -0,0 +1,1427 @@
+<HTML>
+<HEAD>
+<TITLE>MilkDrop Documentation</TITLE>
+</HEAD>
+<BODY>
+<PRE>
+<A NAME="milkdrop_top">
+<B>MILKDROP 2.1 (February 2009)</B>
+ a Winamp visualization plug-in by Ryan Geiss
+ copyright (c) 2001-2009 Nullsoft, Inc.
+
+
+Useful Links:
+ <A HREF="http://www.nullsoft.com/free/milkdrop/">official milkdrop homepage</A>
+ <A HREF="http://forums.winamp.com/forumdisplay.php?forumid=81">online forums</A> - for preset sharing, troubleshooting,
+ comments, and feature requests
+ <A HREF="http://www.winamp.com/">Nullsoft Winamp</A>
+ <A HREF="http://www.microsoft.com/windows/directx/">Microsoft DirectX</A>
+ <A HREF="http://www.milkdrop.co.uk/">milkdrop.co.uk</A> - an excellent third-party preset community site
+
+
+
+<B>What is MilkDrop?</B>
+-----------------------
+<B>MilkDrop</B> is a music-visualization "plug-in" for the Winamp music player.
+As you listen to music through Winamp, MilkDrop renders the soundwaves in a
+visual feedback loop, driven by 3D graphics hardware, to create a
+rich visual journey through sound. MilkDrop can also be driven by a live
+audio feed (microphone or line-in) - see the documentation for details.
+
+<B>MilkDrop 2</B> is a major upgrade to the original MilkDrop visualizer, opening up
+the power of modern graphics chips and programmable pixel shaders to the realm
+of music visualization. Pixel shaders allow dozens, even hundreds of complex
+instructions to be executed for every pixel on the screen, every frame.
+Other new features include jpg textures, gaussian blurring, a preset "mash-up"
+feature, and a prest "back" button. MilkDrop 2 is backwards-compatible with
+presets from MilkDrop 1.
+
+
+
+<B>Section Listing</B>
+-----------------------
+ 1. <A HREF="#1">requirements</A>
+ 2. <A HREF="#2">installation</A>
+ 3. <A HREF="#3">tweaking</A>
+ 4. <A HREF="#4">usage</A>
+ 4.a. <A HREF="#4a">keyboard commands</A>
+ 4.b. <A HREF="#4b">config panel</A>
+ 4.c. <A HREF="#4c">preset authoring</A>
+ 4.d. <A HREF="#4d">rating system</A>
+ 4.e. <A HREF="#4e">custom messages</A>
+ 4.f. <A HREF="#4f">sprites</A>
+ 5. <A HREF="#5">troubleshooting</A>
+ 6. <A HREF="#6">known issues / misc. / tips</A>
+ 7. <A HREF="#7">using line-in</A> (for live audio input)
+ 8. <A HREF="#8">acknowledgements</A>
+ 9. <A HREF="#9">version history</A>
+
+
+
+<A NAME="1">
+<B>1. Requirements</B>
+-----------------------
+ 1. Windows 98, ME, 2000, XP, or later.
+ 2. Hardware-based 3D graphics acceleration (i.e. a video card with 3D support)
+ supporting DirectX 9 with at least 8 MB of video memory;
+ however, we strongly recommend a GeForce 5700 (or better),
+ or a Radeon 9600 (or better).
+ 3. Winamp 5.12 or later ( <A HREF="http://www.winamp.com/">http://www.winamp.com/</A> ).
+ 4. DirectX 9.0 or later ( <A HREF="http://www.microsoft.com/windows/directx/">http://www.microsoft.com/windows/directx/</A> ).
+
+
+
+<A NAME="2">
+<B>2. Installation</B>
+-----------------------
+ MilkDrop 2 comes with Winamp. To install it, just download and
+ install the latest version of Winamp. During the installation,
+ make sure the "MilkDrop 2" visualizer option is checked, so that
+ it gets installed, too.
+
+ Once Winamp is installed, launch it. Load some music files into
+ your playlist and start playing some music. (Be sure to play some music
+ before trying to launch the visualizer - otherwise you'll just see a
+ black screen.)
+
+ Once music is playing, hit <B>CTRL+K</B> and a list of visualization
+ plug-ins will appear. Select "MilkDrop 2" from the list. Then click
+ the "Start" button, and it will launch the visualizer.
+
+ Quick Tips:
+ * If you want to go full-screen, double-click on the visualizer itself.
+ * CTRL+SHIFT+K starts or stops the visualizer.
+ * To configure MilkDrop's options, exit the visualizer and hit ALT+K.
+
+ If you have trouble getting MilkDrop to run properly after installation,
+ try installing various recent WHQL drivers for your video card, or installing
+ DirectX; doing these two things (especially the first) will fix 99% of
+ problems. See the Troubleshooting section of the documentation for more
+ information.
+
+
+
+<A NAME="3">
+<B>3. Tweaking to achieve the best image quality</B>
+-----------------------
+ a) Fullscreen Display Mode [first tab of config screen]
+
+ When you run MilkDrop fullscreen, it changes the display
+ mode to whatever you select here. Generally speaking,
+ the speed (framerate) and smoothness of MilkDrop will drop
+ as the resolution (number of pixels on the screen)
+ increases. So, if it's running to slow in fullscreen
+ mode, try selecting a smaller fullscreen display mode.
+
+ b) Canvas Stretch [second tab]
+
+ This option lets you trade resolution [crispness] for
+ speed. If MilkDrop runs too slow, in any mode (windowed/
+ fullscreen/desktop), try cranking up the canvas stretch
+ to, say, 1.5X or 2X. The image will not look as crisp,
+ but MilkDrop will probably run much faster. (Assuming
+ that your graphics chip was the bottleneck.)
+
+ c) Mesh Size [second tab]
+
+ This is the main option that affects how much processor
+ (CPU) MilkDrop uses. If you crank it up far beyond the
+ default, expect to be CPU-bound (where your framerate drops
+ because the CPU is the bottleneck). To get MilkDrop to
+ speed up, drop the Mesh Size back down. The Mesh Size
+ decides how many points on the screen the per-vertex
+ equations will be executed for; the higher the mesh size,
+ the more fidelity you will see in the motion.
+
+ d) tips for LCD and laptop users
+
+ LCD screens: Note that most LCD screens (flatpanels) usually run
+ at a fixed frequency only - usually 60 Hz - meaning that they update
+ the screen 60 times per second. However, sometimes the video driver
+ reports that it supports other refresh rates, such as 72, 75, 85, etc.
+ It is strongly recommended that [for fullscreen mode, and for Windows
+ in general] you choose a display mode with a 60 Hz refresh rate, for
+ the smoothest possible animation. For this plugin, you will also want
+ to choose Maximum Framerates that divide evenly into 60 - such as 60,
+ 30, 20, 15, 12, 10, 6, 5, and so on - so that the # of times the LCD
+ shows each frame of animation remains constant, resulting in the
+ smoothest possible animation.
+
+ e) color (bit) depth: 16 or 32?
+
+ The answer, nowadays, is a resounding "32". Video memory
+ is plentiful these days; use 32 bit color, for both your
+ windows desktop (...so that MilkDrop's windowed mode can
+ run at 32 bits) and for MilkDrop's Fullscreen Display Mode
+ setting (where "8888" denotes 32 bits).
+
+ Some ancient video cards don't have enough memory to run MilkDrop
+ properly (or smoothly) in 32 bits, though; you might want to
+ try 16-bit color if your card has less than 32 MB of video
+ memory, if you are using a laptop, or if your video card is
+ significantly old. In the MilkDrop config panel, 16-bit modes
+ show up as "555" or "565".
+
+ If you find that your card runs best in 32-bit color, you should
+ have no problems with brightness levels while running MilkDrop.
+ However, if your card runs best in 16-bit color, you should
+ then adjust the Brightness slider on the second tab of the config
+ panel (which only affects 16-bit color video modes!). The goal
+ is to make the image as bright as possible, without oversaturating
+ it (washing it out, often to bright pink or white). This setting
+ also varies for different cards, depending on how the card rounds
+ color values, so we recommend seeing how bright you can set the
+ slider (closer to '0') without oversaturating the image. Usually,
+ a setting of '0' or '2' works the best.
+
+
+
+
+<A NAME="4">
+<B>4. Usage</B>
+-----------------------
+ <A NAME="4a">
+ <B>4.a. Keyboard Commands</B>
+
+ The following keys can be used to control MilkDrop while it is running.
+ (Note: pressing F1 while MilkDrop is running will show you this list)
+ <FONT SIZE="3">
+ <B>GENERAL</B>
+ escape: exit to winamp
+
+ <B>PRESET LOADING</B>
+ BACKSPACE: return to previous preset
+ SPACE: transition to next preset
+ H: instant Hard cut (to next preset)
+ R: toggle random (vs. sequential) preset traversal
+ L: load a specific preset (invokes the 'Load' menu)
+ +/-: rate current preset (better/worse)
+ scroll lock: lock/unlock current preset
+ (keyboard light on means preset is locked)
+ (prevents random switch to new preset)
+ A: aggregate preset - loads a random preset,
+ steals the warp shader from a different random preset,
+ and steals the composite shader from a third random preset.
+ D: cycle between various lock-states for the warp and
+ composite shaders. When one of these shaders is locked,
+ loading a new preset will load everything *except* the
+ locked shaders, creating a mix between the two presets.
+
+ <B>PRESET EDITING AND SAVING</B>
+ M: show/hide the preset-editing menu
+ S: save new preset (asks you for the new filename)
+ N: show per-frame variable moNitor
+ (see <A HREF="milkdrop_preset_authoring.html">milkdrop_preset_authoring.html</A>)
+
+ <B>MUSIC PLAYBACK</B>
+ z/x/c/v/b: navigate playlist (prev/play/pause/stop/next)
+ U: toggle shuffle
+ P: show playlist
+ up/down arrows: volume up/down
+ left/right arrows: rewind/ffwd 5 seconds
+ SHIFT + left/right arrows: rewind/ffwd 30 seconds
+
+ <B>FUNCTION KEYS</B>
+ F1: show help screen
+ F2: show song title
+ F3: show song length
+ F4: show preset name
+ F5: show fps (frames per second)
+ F6: show rating of current preset
+ F7: re-read custom message file (milk_msg.ini) from disk
+ F8: jump to new directory (for presets)
+ F9: toggle stereo 3D on/off
+
+ <B>SPRITES AND CUSTOM MESSAGES (FOR VJ's)</B>
+ T: launch song title animation
+ Y: enter custom message mode
+ ##: load message ## (where ## is a 2-digit numeric code (00-99)
+ of a message defined in <B>milk_msg.ini</B>)
+ *: clear any digits entered.
+ DELETE: clear message (if visible)
+ F7: re-read <B>milk_msg.ini</B> from disk
+ K: enter sprite mode
+ ##: load sprite ## (where ## is a 2-digit numeric code (00-99)
+ of a sprite defined in <B>milk_img.ini</B>)
+ *: clear any digits entered.
+ DELETE: clear newest sprite
+ SHIFT + DELETE: clear oldest sprite
+ CTRL+SHIFT+DELETE: clear all sprites
+ F7: no effect (<B>milk_img.ini</B> is never cached)
+ SHIFT + K: enter sprite kill mode
+ ##: clear all sprites with code ##
+ *: clear any digits entered.
+ CTRL + T/Y: kill song title and/or any custom messages
+ CTRL + K: kill all sprites
+ </FONT>
+ Note that there are more keys available, but because many
+ are only relevant to people designing their own presets,
+ they are listed in the <A HREF="milkdrop_preset_authoring.html">preset authoring guide</A> instead.
+
+
+ <A NAME="4b">
+ <B>4.b. config panel</B>
+
+ The configuration panel lets you customize the way MilkDrop runs.
+ To learn how to get to the configuration panel, see the "Installation"
+ section above.
+
+ Once you're in the config panel, you'll see a number of tabs
+ at the top, some dropdown boxes, and some checkboxes. Each
+ of the tabs at the top brings you to a different page of
+ configuration options. To get help on a setting, simply click
+ on the '?' in the upper-right corner of the config panel,
+ and then click on the setting you want help with.
+
+
+
+ <A NAME="4c">
+ <B>4.c. preset authoring</B>
+
+ Please see the included text file, <A HREF="milkdrop_preset_authoring.html">milkdrop_preset_authoring.html</A>,
+ for instructions on how to create and save your own presets.
+
+
+ <A NAME="4d">
+ <B>4.d. rating system</B>
+
+ The built-in rating system allows you to rate each preset on a scale
+ from 0 to 5. A rating of 5 is very good, while a rating of 0 is
+ the worst. The ratings decide how often the presets will be randomly
+ loaded. If a preset has a rating of 0, it will never be randomly
+ loaded (unless they're all zero; then they all have an equal chance).
+
+ To show the rating for a preset, press F6. You can adjust the
+ rating for a preset with the +/- keys. When you make adjustments,
+ they save automatically; there's no need to save the preset to make
+ the rating change permanent.
+
+ Here's a recommended interpretation of the numeric values:
+ 0 = I never want to see this preset again
+ 1 = very ugly
+ 2 = mediocre
+ 3 = fair
+ 4 = good
+ 5 = downright stimulating
+
+ If a preset seems "lost" because you set its rating to 0 and it
+ won't ever come back, you can always load it up by hitting 'L'
+ to conjure the 'Load Preset' menu, finding the preset you want,
+ loading it, then hitting +.
+
+
+
+ <A NAME="4e">
+ <B>4.e. custom messages</B>
+
+ ABOUT CUSTOM MESSAGES
+ The "Custom Message" feature of MilkDrop allows you to display
+ short text messages on the screen while MilkDrop is running.
+ They are highly configurable; you can set all of the following
+ parameters: the font, the size, the positioning, color, bold
+ state, italic state, and so on; and you can even have it
+ randomize some of these properties.
+
+ CREATING THE MESSAGES
+ You can save up to 100 messages in the file MILK_MSG.INI in
+ your Winamp\Plugins\ folder. To open this file, go to the
+ MilkDrop configuration screen (ALT+K from Winamp) and click the
+ "Edit Custom Messages" button. Or, you can just edit it
+ manually if you know how; it's plain-text.
+
+ The first thing you see when you open the file is a bunch of
+ lines that start with two forward slashes (//). These are
+ comment lines, and they explain the syntax for adding a font
+ or a message to the file. This is your main reference for
+ finding out what all the parameters do for the fonts & messages;
+ it is recommended that you leave this information in the file,
+ although it can be removed or (modified) and the messages will
+ still work.
+
+ After the comments come first the fonts, then the messages.
+ The fonts are simply a way to specify a typeface, bold state,
+ italics state, and red/green/blue color for the font. You can
+ configure up to 16 fonts like this (numbered 00-15). These fonts
+ will serve as template fonts for the custom messages.
+
+ The next section is the actual messages. Each one has a
+ text message (the 'text' parameter) that will be shown to the
+ user, and each one references one of the 16 fonts that were
+ defined in the previous section. You can also specify the
+ size (size), position (x,y), a growth factor (growth) that
+ will grow/shrink the message over its lifetime, the number
+ of seconds to show the message (time), and the fraction of that
+ time that is spent fading in (fade).
+
+ You can also randomize some of these values: 'randx' and 'randy'
+ will randomly perturb the (x,y) coordinates every time the message
+ is shown to the user, and 'randr'/'randg'/'randb' will randomly
+ perturb the (r,g,b) color in the same way.
+
+ Finally, you can override any of the default properties for the
+ font that this message uses: (face, bold, ital, r, g, b).
+
+ INVOCATION AND USAGE
+ There are two ways to invoke custom messages: one automatic,
+ the other manual.
+
+ The automatic way is to go to the MilkDrop config panel (ALT+K),
+ click the 'More Options' button, and set the value in the
+ 'Time between RANDOM custom messages' box to something greater
+ than zero. This will cause MilkDrop to randomly display custom
+ messages while it is running, and the average time (in seconds)
+ between messages will be the value you entered here. If you
+ wish to disable random custom messages, set this value to -1
+ (or any negative number). Note that all messages in the file
+ have an equal change of being picked.
+
+ The manual way is to type in the two-digit code (00-99) of the
+ message while MilkDrop is running. However, you can't use the
+ numeric keypad for this - you have to use the numbers at the
+ TOP of your keyboard to do it. If you mess up while entering
+ the first digit, just press the '*' key to start over.
+
+ Note that if you change the MILK_MSG.INI file while MilkDrop
+ is running, you will not be able to see the changes until
+ you hit F7, which tells MilkDrop to re-read the MILK_MSG.INI
+ file from disk.
+
+
+ <A NAME="4f">
+ <B>4.f. sprites</B>
+
+ ABOUT SPRITES
+ The "Sprite" feature of MilkDrop allows you to display
+ any image of your choice in the foreground (on top of
+ MilkDrop) while it runs. The sprites can fade in and out,
+ move around, respond to the music, and so on. You define
+ them in a file - <B>milk_img.ini</B> in your winamp\plugins
+ directory - much like you define custom messages, each
+ having an identifying code number from 00 through 99 (used
+ to invoke them). However, the way the individual sprites
+ are defined is different; <EM>you write code for them</EM>, instead
+ of just setting parameter values. This is a little bit
+ tougher to do (it's very much like preset authoring), but
+ adds a great deal of flexibility to what you can do with
+ the sprites.
+
+ CREATING THE SPRITES
+ You can define up to 100 sprites in the file MILK_IMG.INI in
+ your Winamp\Plugins\ folder. To open this file, go to the
+ MilkDrop configuration screen (ALT+K from Winamp) and click the
+ "Edit Sprites" button. Or, you can just edit it manually if
+ you know how; it's plain-text.
+
+ The first thing you see when you open the file is a bunch of
+ lines that start with two forward slashes (//). These are
+ comment lines, and they explain the syntax for creating a sprite.
+ This is your main reference for finding out what all the
+ parameters do for the fonts & messages; it is recommended that
+ you leave this information in the file, although it can be removed
+ (or modified) and the sprites will still work.
+
+ After the comments come the sprite definitions. Each sprite is
+ made up of one parameter that indicates the image file to use
+ (this is the 'img=...' line), and two types of code: initialization
+ code, and regular code.
+
+ The first - initialization code - is executed only once, when you
+ launch the sprite. Use it to do one-time initialization of variables
+ (such as the opacity (a), rotation angle (rot), position (x,y),
+ and so on) or to invent new variables that you will access later.
+ This code is marked by the 'init_1=...', 'init_2=...', etc. lines.
+
+ The second type of code - marked by 'code_1=...', 'code_2=...', etc.
+ - is executed every frame, just prior to plastering the sprite on
+ the screen. Use it to animate the sprite, moving it around (changing
+ x,y), scaling it up and down (sx,sy), fading it in and out (a),
+ changing its color, and so on.
+
+ Please see the comments included in the sample milk_img.ini file
+ for full details and examples on how to author sprites.
+
+ INVOCATION AND USAGE
+ There is currently only one way to invoke sprites: manually.
+ To do this, first press 'K' to enter 'sprite mode' (while
+ running MilkDrop). Now, whenever you type in a two-digit
+ code (00-99), MilkDrop will try to find & launch the sprite
+ you've requested, from the milk_img.ini file. If there is
+ an error, it will display an error message in the upper-right
+ corner. Note that to enter the two-digit code, you can't use
+ the numeric keypad; you have to use the numbers at the TOP of
+ your keyboard.
+
+ If you make an error entering the first digit of the code,
+ just press '*' to start over. If you want to
+ clear the most recently-invoked sprite, press DELETE. If you
+ want to clear the oldest sprite, press SHIFT + DELETE. If you
+ want to clear all sprites, press SHIFT + CTRL + DELETE.
+
+ If you want to clear sprites by their 2-digit code, press
+ SHIFT + K (instead of just 'K') to enter 'sprite kill mode.'
+ Now, when you enter a two-digit code, instead of invoking
+ the sprite, MilkDrop clears all running sprites with that
+ two-digit code.
+
+
+
+<A NAME="5">
+<B>5. TROUBLESHOOTING</B>
+-----------------------
+
+ If MilkDrop has a critical problem (e.g. fails to load, freezes, etc.)
+ or if the image is distorted, torn, corrupted, or all one solid color,
+ try the following two suggestions to resolve the problem. In 90%
+ of these cases it can be fixed. If you have a different problem,
+ scroll down past this part and try to find the appropriate symptom
+ and its solution.
+
+ 1. UPDATE YOUR VIDEO DRIVER, OR TRY OTHER DRIVERS
+
+ Almost all display problems are caused by buggy video drivers!
+
+ A "driver" is a piece of software that translates graphics-related
+ commands from programs, like MilkDrop, into the native language of
+ your specific graphics hardware.
+
+ For desktop machines, there are typically three sources for video drivers:
+ 1) those from the *chip* manufacturer's website (usually
+ nvidia.com or ati.com) (best source)
+ 2) those from the card manufacturer's website (LeadTEK, PNY, etc.)
+ 3) those that shipped with Windows (yuck)
+
+ For laptops:
+ 1) the driver from the *laptop* manufacturer
+ 2) (maybe) the driver from the graphics chip manufacturer
+ (ATI, Nvidia, etc) - however, it's fairly common to find
+ that the laptop requires a custom driver written by the
+ laptop manufacturer.
+ 3) the driver that shipped with Windows (yuck)
+
+ Give them all a shot. Track down every driver you can find for
+ your card, and try it. Try the WHQL ones first - these versions of
+ the drivers have passed "Windows Hardware Quality Labs" certification
+ and are usually the more stable and reliable ones.
+
+ In general, it's a very good idea to use only Microsoft-certified
+ WHQL drivers for your video card. Often people want to get the newest,
+ fastest beta drivers, but these drivers are almost ALWAYS riddled
+ with new bugs. You can also watch the version number of the drivers
+ a company releases - if the version number just jumped to a new
+ series (such as from the 70's to the 80's), watch out, it probably
+ has a lot of bugs that need worked out - give it 3-4 months before
+ expecting the new driver series to work well. With video drivers,
+ the newest isn't always the best!
+
+ Here is a list of some common card/chip manufacturers and where
+ to get their drivers. Don't forget to choose the WHQL driver!
+
+ [ <A HREF="http://www.nvidia.com/page/drivers.html">NVIDIA driver</A> ]
+ Card manufacturers using NVIDIA (GeForce) graphics chips:
+ (note - most of these just link you to the nvidia driver above)
+ [ <A HREF="http://www.xfxforce.com/web/support/showSearchDriversProductCode.jspa">XFX</A> ]
+ [ <A HREF="http://www.evga.com/support/drivers/">EVGA</A> ]
+ [ <A HREF="http://www.bfgtech.com/driverdownload.aspx">BFG</A> ]
+ [ <A HREF="http://www2.pny.com/support/support.aspx">PNY</A> ]
+ [ <A HREF="http://ati.amd.com/support/driver.html">ATI driver</A> ]
+ Card manufacturers using ATI (Radeon) graphics chips:
+ [ <A HREF="http://www.visiontek.com/teksupport/drivers/drivers.html">VisionTek</A> ]
+ [ <A HREF="http://www.dmmdownload.com/current.php">Diamond</A> ]
+ [ <A HREF="http://downloadcenter.intel.com/">Intel</A> ] - then click 'graphics' on the left
+ [ <A HREF="http://www.sis.com/download/">SiS</A> ] - agree, then select 'graphics drivers'
+ [ <A HREF="http://www.s3graphics.com/">S3</A> ] - then click 'drivers'
+ [ <A HREF="http://www.via.com.tw/en/products/graphics/">VIA</A> ]
+ [ <A HREF="http://www.matrox.com/graphics/en/corpo/support/drivers/home.php">Matrox</A> ]
+ [ <A HREF="http://www.creative.com/language.asp?sDestUrl=/support/downloads">Creative Labs</A> ]
+
+ For others - or in general - if your graphics chip is made by Trident,
+ for example, then try a <A HREF="http://www.google.com/">google</A> search for:
+
+ Trident graphics driver
+
+ Then click on "support", then "drivers" (or "downloads"), then
+ "graphics driver", and so on.
+
+
+ 2. [RE]INSTALL DIRECTX
+
+ Make sure you have a quasi-recent version of <A HREF="http://www.microsoft.com/windows/directx/">Microsoft DirectX</A>
+ installed. In reality, though, almost every PC in the world has
+ DirectX 9 on it at this point, so this shouldn't be a problem.
+ If you go to download it, you'll only be able to find DirectX 10 -
+ this is fine to install, though, as it includes DirectX 9 inside
+ it. As a last resort, though, if you are having problems,
+ you could try re-installing DirectX to see if it helps.
+
+
+ If you're having a non-critical problem, browse the following list of
+ common problems and their causes and solutions. Note that for each symptom-
+ cause-solution block, there can be multiple symptoms with the same cause and
+ solution, and the same symptom might be listed in multiple blocks.
+
+ If the solutions below don't work for you, please visit the forums at
+ <A HREF="http://www.nullsoft.com/free/milkdrop">http://www.nullsoft.com/free/milkdrop</A>, where you can read the most
+ recent troubleshooting issues and solutions.
+
+
+ ENTRY 1
+ SYMPTOM:
+ -any error message saying "Failed to create ..."
+ or "not enough memory...", or
+ -only a portion of the screen displays correctly; the rest is
+ either filled with garbage or badly flickering
+ CAUSE:
+ 1) Your video card might not have enough memory to run MilkDrop at
+ the resolution (screen width and height) you've picked,
+ 2) your drivers might be out of date,
+ 3) you might need to reinstall DirectX (very very rare), or
+ 4) your graphics card might be to crappy to *actually* run
+ pixel shaders well.
+ SOLUTION:
+ 1) To battle video memory problems:
+
+ Go to the config panel and try smaller video modes (e.g.,
+ 320x240 is smaller than 640x480). Even better is to try
+ a lower color bit depth; if you'd selected a 32-bit ("8888")
+ video mode before, try a 16- ("565" or "555") or 24-bit ("888")
+ one, for example. Note that it might only work in one of them;
+ so make sure you try them all. Trying these things is especially
+ important on laptops with limited video memory, or older video
+ cards with a small amount of video memory.
+
+ Finally, you can try locking the texture size (or "canvas size")
+ to 256x256 pixels, just to see if that fixes the problem.
+ If it does, try using a smaller fullscreen video mode to
+ free up some memory, or if running windowed, close other
+ graphics-hungry applications.
+
+ 2,3) for instructions on how to reinstall DirectX or update
+ drivers, <A HREF="#5">go here</A>.
+
+ 4) Go to the MilkDrop config panel (hit ALT+K) and on the second tab,
+ in the "Pixel Shaders" box, select "None." Now does MilkDrop run
+ ok? If so, your video card probably just can't reliably run
+ pixel shaders, due to either inferior hardware, or it could
+ be the driver. You can always try setting "Pixel Shaders"
+ back to "Auto" and then installing a newer (preferably WHQL)
+ video driver.
+
+
+ ENTRY 2
+ SYMPTOM:
+ -When I go to the Load Preset menu ('L') in MilkDrop, some of the
+ presets on disk are missing.
+ -I downloaded some new presets and put them in my Plugins\MilkDrop2\Presets
+ directory, but I can't access them from within MilkDrop.
+ CAUSE:
+ You probably have an older video card that can't handle the pixel
+ shaders needed to run some of the presets. MilkDrop automatically
+ hides any presets from you that you can't run.
+ SOLUTION:
+ * You could buy a new graphics card - one that meets the minimum
+ recommendation for MilkDrop 2. These cost less than $40.
+ * You could try forcing MilkDrop to try to run these presets.
+ Sometimes MilkDrop just hides them from you because it predicts
+ they will run horribly slow on your graphics card; in case it
+ is wrong about that, try this. Go into the MilkDrop config
+ panel (ALT+K) and go to the More Settings tab. Under the
+ "Pixel Shaders" option, change it from "Auto" to "Shader Model 2"
+ or "Shader Model 3". Then try to run MilkDrop and see if the
+ presets appear. If they do, you're in luck; if they don't, your
+ GPU really doesn't support those shader models.
+
+
+ ENTRY 3
+ SYMPTOM:
+ MilkDrop always looks the same - it's always showing the same
+ preset, and it never changes to a new preset unless I tell it to.
+ CAUSE:
+ Scroll Lock is on.
+ SOLUTION:
+ The Scroll Lock key is how you tell MilkDrop to lock the current
+ preset - i.e. don't randomly transition to a new preset unless you
+ do it. The state of the Scroll Lock key is remembered when you
+ start or stop MilkDrop, too, so be careful of that. If you are
+ experiencing this problem, you can fix it in any of the following
+ three ways:
+ 1. hit Scroll Lock while MilkDrop is running (and the viz window is active);
+ 2. load up the MilkDrop config panel (ALT+K), go to the More Settings
+ tab, and uncheck the "Start milkdrop with preset lock (scroll lock)
+ key ON" box;
+ 3. if you're using a modern skin, there is a "random" button on
+ the frame of the window, which is the inverse of the Scroll Lock
+ state - i.e. you probably have Scroll Lock on and "random" off.
+ Click the "Random" button to turn random transitions back on
+ (and notice that scroll lock gets turned off as a result).
+
+ ENTRY 4
+ SYMPTOM:
+ I was browsing for presets from within MilkDrop ('L') key and
+ got lost. How do I get back to my presets?
+ SOLUTION:
+ Two ways to fix this. The easiest is to just reset MilkDrop
+ to its defaults - hit ALT+K to load the MilkDrop config panel,
+ then click the 'Defaults' button. The next time you launch
+ MilkDrop, it will start you in the default preset directory.
+
+ To fix it manually (and preserve all your settings), run
+ MilkDrop, hit F8, and paste in this path:
+ C:\Program Files\Winamp\Plugins\Milkdrop2\presets
+ [or equivalent].
+
+ Another way to fix it is to hit 'L', and browse all the way
+ down to the root folder (repeatedly select ".."), then
+ go into Program Files, Winamp, Plugins, MilkDrop2, and finally,
+ presets.
+
+
+ ENTRY 5
+ SYMPTOM:
+ -things flicker through (such as my AIM window ticker, taskbar
+ clock, web page animations, etc.) when I'm running MilkDrop
+ in fullscreen mode.
+ CAUSE:
+ You're probably running MilkDrop fullscreen at the same
+ resolution & color depth as your desktop, and Windows isn't
+ properly handling MilkDrop's request for exclusive access to the
+ screen, and is still letting other applications paint (draw)
+ themselves.
+ SOLUTION:
+ Change either your Windows desktop resolution or color depth, or
+ MilkDrop's fullscreen resolution or color depth, so that there
+ is some difference between the two. (To change your Windows
+ display settings, go to the Start Menu -> Settings -> Control
+ Panel -> Display -> Settings tab, and then change the "colors"
+ or "screen area" settings from there.) Also make sure you're
+ not using "fake" fullscreen mode (...uncheck this box on the
+ main screen of the config panel).
+
+
+
+<A NAME="6">
+<B>6. Known Issues / Misc. / Tips:</B>
+---------------
+ a. Tip for video capture: if you'd like to save sequences of video
+ from this plugin, there are several programs out there that will
+ let you do this. Warning: you will need a ton of free hard drive
+ space, and a fast CPU helps. A few of these programs are:
+ "FRAPS" <A HREF="http://www.fraps.com/">http://www.fraps.com/</A>
+ "Hypercam" <A HREF="http://www.hyperionics.com">http://www.hyperionics.com</A>
+
+ b. Close other apps:
+ For the best graphics performance, try to close as many other
+ applications as you can, before running the plugin, especially
+ those that tend to work in the background, such as anti-virus
+ or file-swapping software. Also, if you must leave other
+ applications open, try to minimize them (i.e. shrink the window
+ down to the taskbar) so that they stay out of the painting loop.
+
+ c. Windows Vista / Winamp with per-user settings
+ Be aware that if you're running Vista as a non-admin user,
+ you can't write to (or delete from) files in the Program Files
+ directory, which is were MilkDrop 2 is installed. So, anything
+ you try to write or save (like milkdrop's settings file, milk2.ini;
+ or presets) will probably end up deep in some user-specific,
+ virtualized "Program Files" directory somewhere on your hard
+ drive. Yell at Microsoft for this one!
+
+ Also, if you installed Winamp with per-user settings (instead of
+ shared settings) - on any OS, not just Vista - be aware that your
+ .INI files (milk2.ini, milk2_img.ini, milk2_cfg.ini) are all
+ stored in a folder like this:
+
+ C:\Documents and Settings\<username>\Application Data\Winamp\Plugins
+
+ (Note that 'Application Data' is a hidden folder.) However,
+ presets, textures, and things like that are all shared between
+ users, in the real [c:\Program Files]\winamp\plugins\milkdrop2 folder.
+ If you want to keep your presets separate, you can still do that,
+ though - just put them in a personal folder, and then seek to it
+ from within MilkDrop. If you're using per-user settings in Winamp,
+ it will remember which folder you last used.
+
+
+<A NAME="7">
+<B>7. Using Line-In</B>
+-----------------------
+ If you want to use your sound card's Line-In or CD Audio inputs for
+ sound data (instead of mp3 files), you can do this. Do the following:
+ 1. CONNECT WIRES
+ Connect your audio source (a stereo, a live feed, whatever) into
+ the line-in (or microphone) 1/8" jack on your sound card. You
+ might want to test & verify that your cable is good before doing
+ this.
+ 2. SELECT SOUND INPUT CHANNEL & ADJUST VOLUME
+ In Windows, double-click the speaker icon in your systray (where
+ the clock is). Then, on the menu, go to Options -> Properties
+ and select the "Recording" option. Then make sure the Line In
+ (or Microphone) input channel (whichever is appropriate for
+ your case) is SELECTED (with a check mark) and that the volume
+ is close to, or at, the maximum. Hit OK.
+ 3. TELL WINAMP TO USE LINE-IN
+ Open Winamp, and hit CTRL+L (the "Open Location" hotkey). Now
+ type in "linein://" as the location you want to open. (Leave out
+ the quotes and make sure you use FORWARD slashes.) Hit PLAY
+ ('x' key for the lazy), and the little built-in oscilloscope (or
+ spectrum analyzer) in Winamp should start showing your signal.
+ 4. RUN MILKDROP
+ Run MilkDrop as usual. If the waves are too small or large,
+ either adjust the volume from Windows' Volume Control, or adjust
+ the sound level at the source.
+
+ If you are doing shows using live audio, and if you have a multiple monitor
+ setup, you might also want to use the "VJ mode" feature, which lets you
+ control MilkDrop (even editing shaders on the fly, etc.) via a separate monitor.
+
+
+
+<A NAME="8">
+<B>8. Acknowledgements</B>
+-----------------------
+ A very special thanks & triple word scores out to Francis Gastellu
+ and Justin Frankel for the use of their quite-excellent
+ realtime mathematical expression evaluation library, evallib.
+
+ A huge thanks to Rovastar for running milkdrop.co.uk and all
+ of the work and passion he has put into making MilkDrop great.
+
+ Also, a super special thanks go out to the following preset
+ authors for their excellent artistic & mathematical work:
+
+ Aderrasi
+ Bill Melgren
+ Che
+ CTho
+ Idiot
+ Illusion
+ Krash
+ Mstress
+ Rovastar
+ Rozzor
+ Studiomusic
+ Telek
+ Tobias Wolf Boi
+ Unchained
+ Zylot
+
+ ...and to everyone else who has contributed.
+
+
+
+
+<A NAME="9">
+<B>9. Version History</B>
+-----------------------
+2.2 - November 2009
+ - updated to use ns-eel2 (thanks Justin)
+
+2.1 - January 2009
+ -pixel shader 2.0 & 3.0 support tweaks
+ -unicode support for F2 key feature
+ -removed some older Milkdrop presets and added some newer ones to Winamp installer
+
+2.0e - August 2008
+ -added localization support
+ -unicode support for milkdrop playlist and title
+ -tweaked menus
+
+2.0d - January 2008
+ -worked around colossal Intel driver bugs. See (or skip) long description in next item.
+ -tightened up various uses of the DX9 api, to decrease the chances of bugs due to poor DX9 compliance
+ by drivers for lower-end graphics chips (namely Intel integrated graphics). Most importantly,
+ all Intel drivers seem to implement DrawIndexedPrimitiveUP() incorrectly, which was killing
+ MilkDrop. Since Intel has has this collosal failure in their driver for eons, I decided to work
+ around it, and removed all calls to this function. MilkDrop should now run properly on Intel
+ graphics chips.
+ -also did the following little things to help decrease chances of buggy driver interactions:
+ -now using more exact D3DFVF_TEXCOORDSIZE2(0,1,2) specifiers, in addition to _TEX2, etc.
+ -cleaned up headers (vertex declarations) in data\*.fx files to more closely match the vertex buffers.
+ -set z==0 for all vertices during the composite shader
+ -fixed some bugs w/giant mesh sizes
+
+2.0c - December 2007 (bundled with winamp 5.51)
+ -if a texture (used in a shader) is not found, MilkDrop now also looks in the current preset folder
+ to try and find it. This makes it so that preset downloaders can be lazy and just put
+ the presets, along with the textures that come with them, into the same directory.
+ -fixed a bug where blur textures weren't always being sampled with bilinear filtering
+ -fixed a bug where it would sometimes crash when exiting fullscreen mode while using a modern skin
+ (needed to tell Winamp that we were the viz window, via SET_EMBED_GUID(avs_guid))
+ -desktop mode no longer causes explorer to crash in Windows Vista; it instead just shuts
+ off the icon-re-creation code.
+ -desktop mode: fixed default placement of icons, when taskbar is on the left/top side of the screen.
+ -removed Winamp version check, so people can run it with older winamps (within reason)
+ -if warand() function can't be found (older winamps), it calls a wrapper fn to rand()
+ -fixed font face for custom messages - was errantly using song title font face for custom msgs
+ -song title texture size is now based on max of screen width vs. height, rather than just width.
+ -simple waveform no longer draws itself when its alpha is less than 1/256 (0.004).
+ -added some cool new presets / filtered out some old crummy ones & repeats
+ -changes of note for preset authors:
+ -added "pixelsx" and "pixelsy" to preset's main per-frame and per-vertex equations.
+ (equiv. of "texsize.xy" in shaders)
+ -custom waves: you can now vary the # of samples from the custom wave per-frame code.
+ Added new var, "samples", to custom wave init code [read only] and per-frame code [r/w] -
+ tells you (and lets you set) the # of samples to draw for the wave.
+ -'time' value in shaders now wraps back to 0, after 10,000 seconds spent on a preset
+ (to avoid precision jitters)
+ -fixed bug where 'Draw Thick' was never working for custom waves.
+ -added "#define tex3d tex3D" to include.fx
+ ---( changes after this point were made in v2.0a, 25 Oct 2007, which wasn't officially released... )---
+ -Preset list scan (when milkdrop launches) now happens in a background thread,
+ so there is no drop in framerate while the scan is done.
+ -added instancing to custom shapes!!
+ -you can now set the # of instances for each of the 4 custom shapes
+ [1..1024]
+ -the per-frame code will actually be called 'num_inst' times,
+ and each time, the variable 'instance' will increment (0,1,2,... num_inst-1).
+ -lots of new presets
+ -plugin no longer has a taskbar icon when running in desktop mode
+ -shader writing: tex2d() now works (before only tex2D() worked)
+ -fixed default fullscreen display mode (...if you'd never gone to the config
+ panel and saved your settings, it defaulted you to 1024x768; now it
+ defaults you to your desktop res).
+ -fixed a few blending bugs (and greatly cleaned up the code)
+ for transitioning between presets with mixed pixel shader versions
+ -transitions: when booleans from the old comp shader interpolate
+ during a blend, if the old & new shaders did & didn't use a comp shader
+ (or vice versa), then it will now be smart about when it switches the
+ boolean, so you don't see any avoidable jumps. (mostly for darken,
+ video echo orientation, brighten, solarize, etc.)
+ -presets now save with a few less decimal places for most of the values (less waste)
+ -finally fixed seldom-seen wave bug; it was due to per-frame code "wave_mystery = time*0.03;" when used with wave types 0,1,4. Now those wave types repeat the waveparam value in the [-1..1] range, so it always looks good.
+ -fixed preset list selected pos after preset delete
+ -found and fixed bug with custom wave/shape import
+ -Fixes to documentation, driver link updates, etc.
+ -Fixed bug with the 'texture wrap' and 'sustain level' menu items'
+ visibility (...they should, and now only do, show if the current preset
+ doesn't use pixel shaders).
+ -fixed bug with 'edit sprites' and 'edit custom messages' buttons on the config
+ panel - they were trying to edit the milkdrop 1.0 ini files (milk_*.ini
+ rather than milk2_*.ini).
+ -fixed bug with desktop mode - when paused, if you dragged the mouse around
+ on the desktop, milkdrop would update [new] frames instead of just redrawing
+ the exact same last [paused] frame.
+ -fixed bug with desktop mode - if you made winamp run just in the systray,
+ then ran MD2 in desktop mode, then minimized winamp to the systray,
+ then used a global hotkey to pause the song, then clicked on some
+ random window (say, calc.exe) and then clicked back on milkdrop,
+ the taskbar would disappear. This no longer happens because the
+ viz window, in desktop mode, now only covers the visible portion
+ of the desktop, and not the area occupied by the taskbar.
+ -docs: updated links & text for drivers section
+
+2.0 - 10 October 2007 (bundled with winamp 5.5)
+ -MilkDrop has been upgraded from DirectX 8 to DirectX 9.
+ -This means it now supports Pixel Shaders.
+ -Each preset can now have two shaders in it: a warp shader
+ and a composite shader.
+ -The "warp" shader performs the frame-to-frame image-warping operation.
+ -The "composite" shader performs the final display of the feedback
+ image to the user.
+ -See the <A HREF="milkdrop_preset_authoring.html">preset authoring guide</A> for more information.
+ -Added a "back" button for presets! You can now use the 'backspace' key
+ to go back to up to 64 presets that recently played.
+ -Presets can now load textures (jpg, png, etc.) from disk and use them
+ (in shaders) for whatever they want.
+ -Also added several built-in 2D and 3D procedural noise textures.
+ -You can edit the warp & composite shaders on-screen.
+ -Per-pixel equations have been renamed to per-vertex equations, because
+ that's what they really were. These equations determine how each point
+ moves - on a big grid that covers the screen. For all the pixels in between,
+ the motion was interpolated. Now, that motion data comes into the warp
+ shader as a "uv" coordinate, and you can use it like before, or you can
+ do more work on top of it - but because the pixel shader truly executes
+ (independently) on each pixel, the warp shader truly operates at a "per-pixel"
+ resolution.
+ -When editing per You can now copy and paste to and from the *Windows* clipboard.
+ CTRL+C copy
+ CTRL+X cut
+ CTRL+V paste
+ -The internal canvas (texture) size is no longer locked to power-of-2 squares;
+ it can now match the window size perfectly (...or you can override it
+ to use the old NP2 method).
+ -Max gridsize is up from 128 to 192.
+ -Added 'A' key (aggregate) - loads a random preset, then loads the warp shader
+ from another random preset, and then loads the composite shader from
+ a third random preset.
+ -Added 'D' key - cycles between various lock-states for the warp and
+ composite shaders. When one of these shaders is locked,
+ loading a new preset will load everything *except* the
+ locked shaders, creating a mix between the two presets.
+ -Ditched 'stereo 3D' mode. It never worked that well anyway.
+ -Added "aspectx" and "aspecty" (read-only) to per-frame and per-vertex variables,
+ to help presets deal with widescreen display modes properly.
+ Multiply an X,Y coord by these to make it fit the window properly.
+ -The q1-q8 variables have been expanded; the range is now q1-q32.
+
+1.04L - 04 May 2007
+ -added localization support
+ -fixed Milkdrop DEP incompatibility
+ -fixed theming of preferences under XP+
+
+1.04d - 13 February 2007
+ -fixed some multi-user issues
+
+1.04c - 21 June 2006
+ -added missing files to Winamp installer
+ -added multi user support
+ -fixed 100% cpu usage when paused
+ -added over 200 new Milkdrop presets to Winamp installer!
+
+
+1.04b - 10 October 2003
+ -slimmed down the presets for bundling w/Winamp 5
+ -fixed blurry text when running in wa5 w/skinning,
+ before first window resize
+ -can now start plugin w/o music (Winamp 5+)
+ -(hopefully Justin shrank the DLL some, too)
+
+1.04 - 31 July 2003
+ -upgraded to VMS (VisMegaSDK) 1.05 and DirectX 8. That means a revolutionized
+ Desktop Mode, better driver support, better multimon support, winamp
+ skinning (when running in windowed mode), increased general stability,
+ and much, much more.
+ -added CUSTOM SHAPES and CUSTOM WAVEFORMS.
+ -added the following variables for per-frame scripting: (all booleans, except
+ 'gamma') wave_usedots, wave_thick, wave_additive, wave_brighten
+ gamma, darken_center, wrap, invert, brighten, darken, solarize
+ (also, note that echo_zoom, echo_alpha, and echo_orient were already in there,
+ but weren't covered in the documentation!)
+ -added 'meshx' and 'meshy' [read-only] variables to the preset init, per-frame,
+ and per-pixel equations
+ -cranked max. mesh size up to 128x96
+ -added alphanumeric seeking to the playlist; while playlist is up,
+ you can now press A-Z and 0-9 to seek to the next song in the playlist
+ that starts with that character. SHIFT+A-Z seeks upward (while lowercase/
+ regular a-z seeks downward).
+ -added some options to config panel
+ -sprites & custom messages: added 'kill' keys
+ -CTRL+K kills all running sprites
+ -CTRL+T kills current song title anim
+ -CTRL+Y kills current custom message
+ -sprites:
+ -for sprites, color key can't be a range anymore; it's
+ now limited to just a single color. 'colorkey_lo' and
+ 'colorkey_hi' have been replaced with just one setting,
+ 'colorkey'.
+ -also, behavior of the 'burn' variable has changed; now,
+ a sprite can be burned in on any frame, not just on the
+ last frame before it dies. See the sample sprite config
+ file, milk_img.ini, for more information.
+ -preset ratings are no longer read in all at once; instead, they are scanned in
+ 1 per frame until they're all in. This fixes the long pauses when you switch
+ to a directory that has many hundreds of presets. If you want to switch
+ back to the old way (read them all in at once), there is an option for it
+ in the config panel.
+ -internal texture size now has a little more bias toward a finer texture,
+ based on the window size, when set to 'Auto'. (Before, for example,
+ to reach 1024x1024, the window had to be 768x768 or greater; now, it
+ only has to be 640x640 (25% of the way there). I adjusted it because
+ before, at in-between resolutions like 767x767, it looked very grainy;
+ now it will always look nice and crisp, at any window size, but still
+ won't cause too much aliasing (due to downsampling for display).
+ -..and much many massive amounts of more!
+
+1.03 final - 19 June 2002
+ -fixed bug with motion vectors; when there were 64 of them on X
+ and 48 and Y (the upper limits), stray lines would sometimes
+ be drawn along the top and right edges of the screen.
+ -revamped the help screen
+ -added some cool new presets
+ -touched up the documentation
+
+1.03 beta 3 - 15 May 2002
+ -letter 'g' no longer gets cut off in custom messages
+ -(oops... it's 'wave_mode', not 'wave_type'.)
+ -fixed 'q1'..'q8' in the preset init code.
+ -revamped the way presets are loaded & blended; transitions
+ should be cleaner now.
+ -made motion vectors morph more smoothly during transitions;
+ if the old preset had motion vectors on but the new one
+ doesn't, then the #, drift speed, length, and color
+ of motion vectors does not change as they fade out;
+ and vice versa if the mv's are fading in.
+ -added optional 'burn-in' for sprites, so when they are finished,
+ they leave an imprint in the background. The sprite will
+ burn into the background at the end of its lifetime
+ if the variable 'burn' is set to a nonzero value; if 'burn'
+ is zero, the sprite will not burn in.
+ -motion vectors: reverted to 1.02 functionality, following
+ krash's advice. So mv's should now be backwards-compatible
+ (with 1.02 versions and earlier). Now, dx and dy are constant
+ offsets for the motion vectors; if you want them to scroll,
+ alter dx and dy based on the time (or frame).
+ -finished writing critical notes in milk_img.ini.
+ -revamped the keyboard interface for custom messages & sprites.
+ see the documentation. The realtime help screen won't
+ provide too useful, though (not enough space to lay it all
+ down there).
+
+1.03 beta 2 - 1 May 2002
+ -preset comments are in; start them with '//' anywhere on the line,
+ and the rest of the line will be ignored.
+ -added variables:
+ -fps (read-only)
+ -video echo options: echo_zoom (0..1..+inf), echo_alpha (0..1),
+ echo_orient (0,1,2,3)
+ -motion vector drift: mv_dx, mv_dy (a la geiss)
+ -wave_mode[0-7], wave_a(0..?)
+ -fixed texel alignment
+ -nVidia: dx|dy += -1/(texsize*2)
+ -same for: http://forums.winamp.com/showthread.php?threadid=83401
+ All nVidia Cards (Many confirmed tested),
+ 3dfx Voodoo Cards (Voodoo 3 confirmed tested),
+ ATI Cards (ATI All-In-Wonder confirmed Tested)
+ Kyro II Confirmed Tested
+ even Illusion's antiquated Intel Card needs it.
+ -(untested: the matrox cards)
+ -super thanks to Rovastar for researching & cracking this one
+ -added option for thicker waves; see wave menu.
+ -note: only takes effect when texture size is >= 512x512!
+ -modified presets for new texel alignment fix:
+ -Zylot - Tunnel of Illusion
+ -Zylot - S. Pulse Virus
+ -Most of Krash' s presets
+ -Illusion and Rovastar - Grand Odyssey Mod
+ -Unchained: Goo Kung Foo and Perverted dialect.
+ -optimized some, thanks to Rovastar for pointing out lines in
+ per-pixel code that could be migrated into per-frame code.
+ -many of my own: made waveforms thick
+ -some new presets
+ -(bipolar 4,5; supernova 2; calligraphy; others from milkdrop.co.uk)
+ -fixed bug with sound analysis where sound variables in expressions
+ (bass, bass_att, treb, etc.) could be NAN on the first frame
+ that milkdrop ran. (symptoms could be bad if the value was
+ used over & over in subsequent frames!)
+ -saved about 100k on the installer by updating to NSIS 1.98 and
+ using the new bzip2 compression. (thanks again to rovastar)
+ -made the texture used for song titles & custom messages take 1/4
+ as much video memory (was square before, blech - now it tries
+ 4:1; if that fails it tries 2:1; then 1:1 as a last resort.)
+ -added config panel option to mute all errors/warnings that might
+ appear in the upper-right corner.
+ -revamped the configuration for desktop mode w/software blit.
+ Now, you have a choice of 3 different ways to bring the image
+ across the bus (from video to system memory). Then the image
+ is converted from RGB to YUV on the cpu, and then you also get
+ to select how to send the image across the bus again, back to
+ video memory, for display on the desktop. The 3 methods are
+ 1) copy the data using an mmx-accelerated memory copy routine
+ (never-fail cornbread)
+ 2) use directx to blit from one surface to another
+ (sometimes drivers flake out on this)
+ 3) skip it; read/write directly to/from video memory
+ (never-fail cornbread)
+ Regarding 1 vs. 3: they'll both always work; usually #1 is
+ faster going from video to system memory, and #3 is faster
+ going from system back to video; but not always. Try different
+ combinations out on your card and see what happens.
+ -sprites!
+ users can edit 'milk_img.ini' and write their own code to control
+ the sprites. Each sprite is an instance of a jpeg image from disk,
+ displayed according to the code in the .ini file. Up to 16 sprites
+ can be running at once.
+ -stole Y + K keys for use with custom messages & sprites.
+ Hit 'y' to enter custom message mode, then enter two-digit
+ codes to launch custom messages. Hit 'k' to enter sprite
+ mode, then enter three-digit codes to launch sprites.
+ -added 'preset initialization code', so you can initialize
+ your custom variables when the preset is first loaded.
+ -increased number of 'q' variables from 5 to 8. (q1..q8 are
+ used to carry values from the per-frame equations to the
+ per-pixel equations. Note that they can now also carry
+ values from the preset init equations, on to the per-frame
+ AND per-pixel equations!)
+ -automated the brightness slider in the config panel; now there's
+ a checkbox that says, 'guess, based on my video card'. Currently,
+ the auto-brightness algorithm is simple: if you have an nVidia
+ card, it will set it to 2; otherwise, it sets it to 0.
+
+1.02 - 2/7/02
+ -added CUSTOM MESSAGES - you can edit them in the file MILK_MSG.INI in your
+ WINAMP\PLUGINS directory. They are displayed by either keying in their
+ 2-digit numerical code ('##') at runtime, or randomly if you choose this
+ option from the config panel (see the 'More Options' dialog).
+ -also added RANDOMIZATION FOR SONG TITLE ANIMATIONS (also see the 'More
+ Options' dialog from the config panel).
+ -added INSTANT HARD CUT HOTKEY: 'H'
+ -for preset authors:
+ -per_frame and per_pixel code use to get cut off if they didn't fit
+ on the screen; this is now fixed (flips to next page as needed)
+ -when editing per-frame/per-pixel equations, the line that the cursor
+ is on is now highlighted!
+ -fixed an old bug where if the per-pixel or per-frame code had nothing
+ in it except spaces & linefeeds, it would display an error message
+ saying "error in per-{pixel|frame} code".
+ -added a 'trail length' parameter to the motion vectors.
+ -added a bunch of per-frame variables to control the motion vectors:
+ mv_x, mv_y, mv_l, mv_r, mv_g, mv_b, mv_a. Also got rid of the
+ motion vectors on/off setting; now the opacity controls this.
+ -cranked up max. # of user variables from 23 to 33. (Added 16 slots,
+ but used 6 of them for motion vectors.)
+ -added a per-frame variable called 'monitor'. Set the value of this
+ variable in the per-frame code, and then press 'N' to monitor (show)
+ its value in the top-right corner of the screen. Should be very
+ useful for debugging. (Thanks to Krash for the great suggestion
+ on how to implement this!)
+ -added the int() function, which turns the argument into an integer
+ (whole number). Rounding is toward zero. Examples:
+ int(-1.1) -> -1, int(-1) -> -1, int(-0.9) -> 0;
+ int(0.9) -> 0, int (1.0) -> 1, int(1.1) -> 1;
+ int (2.1) -> 2.
+ -improved 3D mode:
+ -drastically improved quality of stereo 3D images by changing default
+ 3d colors to CYAN (full green + blue; was just full blue) for the
+ left eye and RED for the right eye. It turns out that this provides
+ an equivalent 3d image, but gives you the full range of colors for
+ all presets, which in turn probably makes the 3Dness more visible
+ to your brain anyway.
+ -also, when in 3D mode, made the waveforms 60% white and 40% their
+ original color (used to be 100% white because so much color was lost
+ in the green channel).
+ -song titles:
+ -(added randomization, as mentioned above)
+ -improved max. resolution of song titles by increasing the max.
+ allowable GDI font size
+ -fixed longstanding bug with the "burning in" of song titles after
+ they're done displaying; the old, floating location wouldn't exactly
+ match where the title would be burned into the background & melt away.
+ -timing & animation:
+ -protected against milkdrop's animation running super-fast because the
+ clock jumped way ahead when no frames were rendered (i.e. milkdrop
+ got stalled somehow).
+ -smoothed the animation by assuming the time for each frame to be 80%
+ of 1/fps and 20% the actual time reported.
+ -misc:
+ -converted ANSI_CHARSET to DEFAULT_CHARSET in CreateFont() calls (should
+ fix some display of funky/foreign character sets)
+ -added 'R' key to toggle random vs. sequential order for loading presets
+ -fixed alphanumeric sorting of presets (used to have minor errors such
+ as putting "galaxy 2" before "galaxy", and so forth - unfortunately
+ this is how strcmp() - even Windows Explorer - sorts them. I rewrote
+ strcmp() to make it sort in a more 'natural' order.)
+ -'&' characters in preset filenames no longer show up as an '_' character,
+ although it still looks funny if you try to save one with an '&' already
+ in it, but don't worry, it will preserve the '&' (even though it looks
+ messed up). Note that you still can't type a *new* '&' into the filename
+ when you go to save a preset. It is safe to rename it from outside
+ MilkDrop, though, and use it in MilkDrop later.
+ -fixed preset-to-preset blending bugs for the 10 border variables.
+ -fixed a bug in blending from a preset using waveform #7 (two horizontal
+ waveforms) to waveform #0 (a circular waveform), where the right edge
+ of the top horizonal wave would get connected (via a straight line)
+ to the left edge of the bottom horizontal wave, as soon as the blend
+ began.
+ -m_debug.txt: added some caps detection info at init time; screened out
+ logging of WM_MOUSEMOVE, WM_NCHITTEST, and WM_SETCURSOR messages.
+ -improved motion vector motion prediction so that the tips of the motion
+ vectors should be perfectly matched from frame to frame, when the
+ trail length is set to 1. **Note that it defaults to 0.9, so that
+ the look is similar to the old, mismatched version! (so the presets
+ are backwards compatible.) **Also note that for video cards that
+ do not support anti-aliased edges, there could be up to 1 pixel of
+ error here. Check m_debug.txt for whether or not your driver/card
+ supports anti-aliased edges for lines.)
+
+1.01 - 12/7/01
+ -playlist feature ('p' key) no longer crashes on Windows ME/98SE.
+ -fixed problems with ampersand ('&') character in song titles/playlist
+ -fixed bug with previous max. of 23 user variables per session. (Now,
+ it's a max of 23 user variables per preset, as it should be.)
+
+1.0 - 10/30/01
+ -added a section to the documentation on using "line-in" as your
+ audio source (instead of mp3's)
+ -lowered minimum frame time (enforced by winamp) from 25 ms to 10ms,
+ so now, the max. possible fps is 100 instead of 40.
+ -tightened A/V sync by 5 ms (raised audio latency from 25 to 30 ms).
+ -fixed &'s in song titles (as displayed when you hit F2)
+ -F7,F8 were switched in the help screen (F1)
+ -when running in desktop mode, if you have a pattern on your windows
+ background, it gets nuked. Before, if you had a pattern, the
+ pattern would remain and you'd only be able to see milkdrop through
+ the small boxes of your desktop icons' background text. I didn't
+ bother restoring the pattern upon exit because I am lazy and assume
+ that nobody intentionally uses these things anymore. =)
+ -improved warning message for windowed/desktop modes, when auto-texture-
+ size is scaled down due to insufficient video memory. It previously
+ just reported the downsizing, but now, it also recommends that you
+ drop your color depth to 16 bits (if you haven't already) and that
+ you try decreasing your screen resolution.
+ -might have fixed a bug with the playlist feature ('p') crashing people's
+ machines.
+
+0.99g - 9/11/01
+ -added playlist browsing (hit 'p')
+ -added checkbox to fix slow text (finally!)
+ -song titles fixed too (on some cards, they were garbled) (also, in low
+ video mem. situations, they might have never appeared - that's fixed too)
+ -added checkbox to allow double buffering for desktop mode; default is
+ UNCHECKED; can provide significant speed boost, but you might see some
+ tearing during the vertical retrace; if so, enable double-buffering.
+ It used to always be double-buffered, which is slower, though it is
+ page-tearing-artifact-free.
+ -added always-on-top option for windowed mode
+ -added "page x of y" footnote to the preset and playlist menus
+ -improved the auto-texture-size management code, so users will be less
+ likely to get the "couldn't create offscreen surface #1" (or #2) error.
+ Instead, the textures are continally downsized until there is enough
+ memory for them. This might mean blockier images, but at least it will run.
+ -desktop mode can now do software blit when an RGB overlay surface is created.
+ (before, software blit was really only available for YUV-type overlays.)
+ -desktop mode compatibility improved: more likely to work at higher resolutions now
+ -desktop mode: fixed YUV-type *non-mmx* software blits when Windows is in 16-bit color.
+ (weren't implemented before; it just assumed windows was in 32-bit color,
+ and the result would look munged.)
+ -improved mmx memcpy: will now copy as long as the (difference between two
+ pointers) % 8 is zero. (before, they both had to be a multiple of 8).
+ -reorganized the config panel; nice
+ -centered the config panel on the screen (by removing winamp as hwndparent - der)
+ -centered the 3 color picker dialogs (by specifying current dialog window
+ as the parent - der)
+ -(also cleaned up redundant code for color picker dialogs)
+ -super-slight optimizations to speed of waveform blending
+ -tweaked the way the "clear screen at startup" option works, since some
+ users had problems with it
+ -fixed aspect ratio, so when window is at an extreme AR, it clips the extra
+ (instead of fitting the image to the window)
+ -fixed a fullscreen lost surface bug introduced in 0.99f that blacked
+ the screen out if you ALT-TABBED out of milkdrop & returned.
+ -fixed bug where tooltips were lost on some systems (left variable in,
+ but no way to change it - locked to TRUE for now)
+ -fixed bug where 'try for RGB overlay...' and 'try for YUV overlay...'
+ checkboxes were disabled when software blit was on. (Don't know what
+ I was thinking there!)
+ -tweaked presets; added some cool shift-on-beat effects
+
+0.99f - 8/22/01
+ -added graphical song titles
+ -added screen borders; can be used to create interesting feedback patterns when
+ zooming out
+ -waveforms now blend smoothly!
+ -finally gave milkdrop an application icon
+ -added 'U' key to toggle winamp's shuffle feature on/off
+ -fixed bug with handling of 'r' key when preset menu is up; now, to rename a file,
+ use INSERT
+ -fixed a 1-frame-delay bug for warping (caused a lag for audio-driven 'warps')
+ -fixed bug where 'progress' variable's value was always 0 in per-pixel eq's
+ (thanks rovastar)
+ -removed "F7: show tooltips for menu items" hotkey (needed it for title animations)
+ -removed U, I keys (for warp)
+ -moved T key (for zoom) to I (i=zoom in, I=zoom out) (T is now used for song titles)
+ -speed optimization: now using memcpy_MMX to copy 576*2*4=4608 bytes of sound data
+ per frame
+ -size optimizations: painstakingly shaved 8k off the .dll
+ -in windowed mode, when a user resizes the window to a size that's too large and
+ there's not enough video memory and MilkDrop closes, it now resets the size
+ of the window for the next time you run MilkDrop. (before it would just try
+ to start the next time with the same window position/size and keep failing.)
+ -added 'try for RGB overlay before trying YUV-types' checkbox
+ -added 'try for YUY2 overlay surface before trying UYVY' checkbox
+ -added "stereo 3d always on" option (unchecked by default)
+ -added "clear screen at startup" option (checked by default)
+ -made soft cut timer reset on hard cuts
+
+0.99e - 7/5/01
+ -added beat-driven HARD CUTS; very cool
+ -added a VJ mode, where you can make all the text draw in a separate
+ window instead of to the main graphics display; should be very
+ handy for concerts
+ -added preset rating; use + and - keys (volume control is only available
+ w/up,down arrows now); use F6 to show rating of current preset
+ -you can now use any color lenses for left/right stereo vision; just tell
+ it what color you've got (by speaking aloud)
+ -desktop mode optimization: block copy from video memory is now optional,
+ because on 5-10% of systems, it actually makes things slower.
+ -transitions between 2 presets both using video echo, but in different
+ orientations, are now smooth
+ -added 'progress' variable to per-frame and per-pixel equations; tells you
+ how far through the preset you are (temporally) (0..1), so you can make
+ gradually-shifting effects
+ -added mystery param to per-frame eq's (variable name is 'wave_mystery')
+ -settings such as showing song titles, times, fps, ratings, tooltips, etc.
+ are all now preserved from session to session
+ -when Load menu is up, added seeking by typing in first char of name
+ -also disabled left/right arrows when Load menu is up, so music
+ won't skip on you
+ -windowed mode now remembers the window's final size, position between sessions
+ -safe for 2nd monitor, too
+ -fixed bug with ALT-TABBING in and out of fullscreen mode
+ -fixed bug with vertical spacing of song title/time readout when the fancy
+ font size was set to anything but "normal"
+ -plugin listing (in Winamp prefs screen) and the window title now show the
+ version #
+ -fonts now scale with the window
+ -protected against trying to run MilkDrop while the config panel is still open
+ -fixed the 1-pixel-wide garbage that sometimes sat at the right and bottom
+ edges, in windowed mode
+ -fixed bug where after going to another app, fullscreen, while in Desktop Mode,
+ upon your return from fullscreen the overlay surface was lost (and just sat
+ there, black).
+ -stopped sending WM_KEYUPs to Winamp (oops; never sent WM_KEYDOWNS to begin
+ with anyway)
+ -load menu: '[..]' now reads '[..] (parent directory)'
+ -config panel: broke some stuff off into a 'more options' dialog
+
+0.99d - 6/5/01
+ -desktop mode is officially in
+ -added new waveforms
+ -added temporal wave alignment
+ -added fps limiting
+ -added "view documentation" button to config panel
+ -added UP/DOWN keys for volume up/down
+ -improved seeking for CTRL-LEFT, CTRL_RIGHT: now seeks by breaks between groups of
+ alphabetic characters, instead of just looking for spaces.
+ -added 5 new variables (q1..q5) for passing values from the per-frame to the per-pixel
+ equations (user-defined variables don't carry over like permanent variables)
+ -added brighten (square root), darken (square), invert, and solarize filters
+ -tweak: made transitions slightly sharper (10% more toward a cosine curve than a
+ linear curve now)
+ -now setting D3DRENDERSTATE_SHADEMODE to D3DSHADE_GOURAUD (used to be FLAT,
+ and combined with per-vertex coloration, which seemed to be asking for trouble)
+ -added warning messagebox for if first call to SetRenderTarget fails
+ -fixed bugs with the values of "x" and "y" for per-pixel equations
+ -x: range was -1..1; should have been 0..1
+ -y: range was 0..2; should have been 0..1
+ -(all presets using x,y in their per-pixel equations had to be adjusted)
+ -fixed bug where if the previous preset folder disappeared, you couldn't hit 'L'
+ to browse to a new folder
+ -fixed a potential bug with dither not being a hardware capability
+ -fixed a bug with scroll lock (didn't reset the LED state when MilkDrop started)
+ -fixed a bug with loading presets with blank lines in the per-frame or per-pixel
+ equations
+ -(the blank line, and everything after it, would not be read in)
+ -revamped gamma loop
+
+0.99c - 5/21/01
+ -added red-blue stereo; use F9 to toggle it on/off
+ -note: you need those cheesy glasses with the red & blue plastic
+ lenses for this to work!
+ -added a bunch of 3D presets in the \3D subdir
+ -added the ability to browse the directory structure
+ -added F8 to jump to new directory (or drive)
+ -changed the 'fix pink/white color saturation artifact' checkbox
+ into a simple brightness slider, so you have more freedom with it
+ -"+", "-" keys now work for the numeric keypad and regular keys.
+ -fixed a video memory leak for windowed mode (the manually-created backbuffer wasn't
+ being released; once you exited winamp, though, the memory was freed)
+ -fixed a bug with closing Winamp while milkdrop was running in windowed mode
+ -fixed a weird bug with hitting ESC from the config panel sometimes doing nothing
+ -fixed a weird bug where when milkdrop was launched in windowed mode,
+ keystrokes to winamp don't work until you moused-over the winamp window
+
+0.99b - 5/16/01
+ -added windowed mode
+ -added +/- keys for volume control
+ -added SHIFT + left/right arrows to rewind/ffwd 30 seconds
+ -improved various error messages
+ -protected vs. running config panel while MilkDrop is running
+ -protected vs. running milkdrop without music playing
+
+0.99 - 5/11/01
+ -first version
+
+
+<A HREF="#milkdrop_top">return to top</A>
+</PRE>
+</BODY>
+</HTML>