1137 lines
60 KiB
HTML
1137 lines
60 KiB
HTML
<HTML>
|
|
<PRE>
|
|
<A NAME="milkdrop_top">
|
|
<B>MILKDROP 1.04 (7/31/03)</B>
|
|
a Winamp visualization plug-in by Ryan Geiss
|
|
copyright (c) 2001-2003 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.milkdrop.co.uk/">www.milkdrop.co.uk, an excellent third-party site</A>
|
|
<A HREF="http://classic.winamp.com/">Nullsoft Winamp</A>
|
|
<A HREF="http://www.microsoft.com/windows/directx/">Microsoft DirectX</A>
|
|
|
|
|
|
|
|
<B>What is MilkDrop?</B>
|
|
-----------------------
|
|
MilkDrop is a Winamp audio-visualization plug-in. It uses 3D graphics hardware,
|
|
combined with iterative image-based rendering techniques, to create a visual
|
|
journey through sound.
|
|
|
|
|
|
|
|
<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, or XP.
|
|
2. Hardware-based 3D graphics acceleration (i.e. a video card with 3D support)
|
|
with at least 8 MB of video memory; however, 32 MB or more is recommended.
|
|
3. DirectX 8.0 or later ( <A HREF="http://www.microsoft.com/windows/directx/">http://www.microsoft.com/windows/directx/</A> )
|
|
4. Winamp 2.72 or later ( <A HREF="http://classic.winamp.com/">http://classic.winamp.com/</A> ),
|
|
or <A HREF="http://www.winamp.com/">Winamp 3.xx</A> with the <A HREF="http://www.winamp.com/components3/detail.jhtml?componentId=122130">Classic Visualization</A> component installed.
|
|
|
|
|
|
|
|
<A NAME="2">
|
|
<B>2. Installation</B>
|
|
-----------------------
|
|
To install MilkDrop, simply run the installation program.
|
|
|
|
To configure it, load up Winamp, and hit CTRL+K. Make sure
|
|
'MilkDrop' is selected in the list, and then click 'Configure'
|
|
to customize it, or 'Start' to start it.
|
|
|
|
You can also use the hotkeys ALT+K to configure MilkDrop,
|
|
and CTRL+SHIFT+K to start/stop it.
|
|
|
|
|
|
|
|
<A NAME="3">
|
|
<B>3. Tweaking to acheive the best image quality</B>
|
|
-----------------------
|
|
a) color (bit) depth: 16 or 32?
|
|
|
|
The ideal color (bit) depth for MilkDrop is 32 bits. That
|
|
means that you want Windows to be running in 32-bit color
|
|
so that MilkDrop, when run in windowed mode, runs in 32-bit
|
|
color. To make MilkDrop run fullscreen in 32-bit color, be
|
|
sure you've selected a fullscreen display mode (from the
|
|
config panel) that is 32 bits (i.e. one of the '8888' formats
|
|
in the list).
|
|
|
|
Some older 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.
|
|
|
|
b) 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.
|
|
|
|
|
|
|
|
<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>
|
|
spacebar: 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)
|
|
|
|
<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>)
|
|
BACKSPACE: 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>)
|
|
BACKSPACE: 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 ##
|
|
BACKSPACE: clear any digits entered.
|
|
CTRL + T/Y: kill song title and/or any custom messages
|
|
CTRL + K: kill all sprites
|
|
|
|
</FONT>
|
|
<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 BACKSPACE key to back up.
|
|
|
|
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 'BACKSPACE' to back up one digit. 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, all white, or all black, 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. [RE]INSTALL DIRECTX
|
|
|
|
Make sure you have the latest version of <A HREF="http://www.microsoft.com/windows/directx/">Microsoft DirectX</A>
|
|
(9.x at the time this documentation was written). Even if
|
|
you already have it, consider re-installing it, since files
|
|
can be corrupted over time, and because poorly-written video
|
|
drivers can sometimes break your DirectX installation.
|
|
|
|
2. UPDATE YOUR VIDEO DRIVER, OR TRY OTHER 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.
|
|
|
|
There are typically three sources for video drivers:
|
|
1) those from the card manufacturer's website
|
|
2) those from the chip manufacturer's website
|
|
("reference" drivers for the chip that powers the card)
|
|
3) those that shipped with Windows
|
|
|
|
Give them all a shot. Track down every driver you can find for
|
|
your card, and try it. If your card isn't top-of-the-line, try
|
|
uninstalling your driver and use Windows Update to install the
|
|
drive that came with Windows. If it is top-of-the-line, try the
|
|
various drivers available: the latest "beta" (pre-release)
|
|
drivers, the certified drivers, and perhaps the reference driver.
|
|
|
|
In general, though, it's a very good idea to use only Microsoft-
|
|
certified WHQL (Windows Hardware Quality Labs) 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.
|
|
|
|
Here is a list of some common card/chip manufacturers and where
|
|
to get their drivers:
|
|
[ <A HREF="http://www.nvidia.com/view.asp?PAGE=drivers">nVidia</A> ]
|
|
[ <A HREF="http://www.ati.com/">ATI</A> ]
|
|
[ <A HREF="http://www.matrox.com/mga/support/drivers/home.cfm">Matrox</A> ]
|
|
[ <A HREF="http://www.voodoofiles.com/">3dfx voodoo drivers</A> ]
|
|
[ <A HREF="http://www.diamondmm.com/default.asp?menu=support&submenu=Legacy_Graphics">Diamond</A> ]
|
|
[ <A HREF="http://www.creative.com/">Creative</A> ]
|
|
[ <A HREF="http://www.tridentmicro.com/drivers/index.html">Trident</A> ]
|
|
|
|
Here are some sites that mirror (or link to) drivers from many sources:
|
|
[ <A HREF="http://winfiles.cnet.com/">CNET</A> ] (then click 'Utilities & Drivers', then 'Display & Video')
|
|
[ <A HREF="http://www.driverzone.com/video.html">Driverzone.com</A> ]
|
|
|
|
And if those all fail, there's always Google:
|
|
[ <A HREF="http://www.google.com/">Google</A> ]
|
|
|
|
|
|
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, or
|
|
3) you might need to reinstall DirectX.
|
|
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.
|
|
|
|
It can also help (especially when running MilkDrop in
|
|
windowed mode) to set your Windows display mode to 16-bit to
|
|
free up some video memory. To do this, go to the Start Menu
|
|
-> Settings -> Control Panel -> Display -> Settings tab, and
|
|
then select "High Color (16 bit)".
|
|
|
|
Finally, you can try locking the texture size to "256" and see
|
|
if that fixes the problem. Some video cards - especially
|
|
those built-in to laptops - report that they can support texture
|
|
sizes of 512x512 or 1024x1024, but they don't seem to do it
|
|
properly (or else I've got a bug in there... still working on
|
|
this one). If 256x256 works (i.e. no garbage), try locking it
|
|
at 512x512 and see if that works as well, because the higher the
|
|
texture size, the better the image will look.
|
|
|
|
2,3) for instructions on how to reinstall DirectX or update
|
|
drivers, <A HREF="#5">click here</A>.
|
|
|
|
|
|
ENTRY 2
|
|
SYMPTOM:
|
|
-MilkDrop turns bright pink or white after running for a few
|
|
seconds in 16-bit color.
|
|
-MilkDrop is just way too bright.
|
|
CAUSE:
|
|
The extremely technical explanation is that when your video
|
|
card "blits", it rounds to the nearest color, instead of rounding
|
|
down, and because of the limited precision (5 bits per channel)
|
|
in 16-bit color video modes, the iterative decay process (that
|
|
fades pixels to black as they age) gets stuck.
|
|
SOLUTION:
|
|
Go to the config panel, find the "brightness control" slider,
|
|
and slide it to the right (to "2" or darker).
|
|
|
|
|
|
ENTRY 3
|
|
SYMPTOM:
|
|
-long pauses when MilkDrop starts, or when you change directory
|
|
CAUSE:
|
|
You could have a virus checker running that is interfering with
|
|
MilkDrop's scanning of preset files; or, your hard drive might
|
|
just have a really slow access speed.
|
|
SOLUTION:
|
|
Try disabling your virus protection software and see if this
|
|
helps; if often does. If that doesn't work, try going to the
|
|
config panel and toggling the "Disable preset rating" checkbox
|
|
so that it is checked. Disabling the preset rating system
|
|
prevents MilkDrop from having to scan all your preset files
|
|
for their ratings, which, on a rare few systems, can cause
|
|
long pauses at times.
|
|
|
|
|
|
ENTRY 4
|
|
SYMPTOM:
|
|
-MilkDrop is too dark in 16-bit color
|
|
CAUSE:
|
|
Similar to the above problem
|
|
SOLUTION:
|
|
Go to the config panel, find the "brightness control" slider,
|
|
and slide it to the left (to "2" or brighter; try "0" first).
|
|
If this causes your display to turn bright pink or white after
|
|
running MilkDrop for a few seconds, though, you'll need to
|
|
return here and try darker settings.
|
|
|
|
|
|
ENTRY 5
|
|
SYMPTOM:
|
|
-there's a pause every time MilkDrop switches presets
|
|
CAUSE:
|
|
You might have a virus scanner enabled.
|
|
SOLUTION:
|
|
Disable your virus scanning program before running MilkDrop.
|
|
|
|
|
|
ENTRY 6
|
|
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.)
|
|
|
|
|
|
|
|
<A NAME="6">
|
|
<B>6. Known Issues / Misc. / Tips:</B>
|
|
---------------
|
|
a. When Winamp is running, your screensaver will not kick in,
|
|
your monitor will be prevented from entering powersave mode,
|
|
and your system will not be able to go into standby.
|
|
b. 3DFX VOODOO 3, 4, 5, etc. ON WINDOWS 2000: you will likely
|
|
have to go to <A HREF="http://www.voodoofiles.com/">http://www.voodoofiles.com/</A> to find
|
|
good display drivers that work with MilkDrop (be warned, you might
|
|
have to try several). If you get a white screen, especially, try
|
|
other drivers.
|
|
c. ATI rage mobility 8mb chipset (on many laptops): from the Milkdrop
|
|
config panel, you must set the texture size to 256x256, otherwise
|
|
you'll get weird garbage & flickering at the bottom of the screen.
|
|
d. 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>
|
|
e. 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.
|
|
|
|
|
|
|
|
<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 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.
|
|
|
|
Also, a super special thanks go out to the following preset
|
|
authors for their excellent artistic & mathematical work:
|
|
|
|
Aderrasi
|
|
Bill Melgren
|
|
Che
|
|
CTho
|
|
Eo.S.
|
|
Idiot
|
|
Illusion
|
|
Krash
|
|
Mstress
|
|
Phat
|
|
Red Jedi
|
|
Rovastar
|
|
Rozzor
|
|
Studiomusic
|
|
Shifter
|
|
Telek
|
|
Tobias Wolf Boi
|
|
Unchained
|
|
Yin
|
|
Zylot
|
|
|
|
...and to everyone else who has contributed.
|
|
|
|
|
|
|
|
|
|
<A NAME="9">
|
|
<B>9. Version History</B>
|
|
-----------------------
|
|
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>
|
|
</HTML>
|