Foo_Vis_Shpeck, Winamp visual plugin wrapper for Foobar2000 v0.9x
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
(c) 2007-2008 by Yirkha

Requires NSCRT.DLL distributed with Winamp 5.x. Copy it into a folder where
the Windows DLL loader can find it (e.g. Foobar2000 main folder).

For the latest version and discussion please visit:
http://www.hydrogenaudio.org/forums/index.php?showtopic=59388&st=0


Changelog:
~~~~~~~~~~

v0.2.4
 · New: Plugins which use spectrum data now use the new FFT behavior for spectrum-generating methods
        available in v0.9.5.2 and newer (normalized output, Gauss window used instead of rectangular
        for better quality & less aliasing)
 · New: Embedded window titlebar customizability - background color, text color, title font and
        button images. Button images can be loaded from external BMP file, whose width must be
        divisible by 5 (for five buttons - prev., next, random, fullscreen and menu) and its
        height must be divisible by 3 (for three states - normal, hover and pushed).
        32bit format with alpha/opacity is supported (as is the default image).
        Windows desktop    settings with adaptive semi-transparent buttons    are used by default.
 · New: Option to prevent running plugin's thread on lower priority (might help with random pauses)
 · Fix: The playlist titleformatting code could not be edited.
        I believe this bug must have been present since the first version and nobody noticed.
        Another proof that nobody cares about hacking titleformatting strings.
 · Fix: Some visualizations don't need to be clicked first to get keyboard input anymore
 · Fix: "???" occassionally displayed as current song title
 · Fix: Titlebar disappearing after stopping plugin in a panel
 · Maybe something else I don't remember, like changing the default title formatting strings.

v0.2.3
 · Keyboard shortcuts not processed by plugin are correctly forwarded to the main window now
 · Blank spectrum data is used when not available instead of fake "gradient"
 · Contents of the default Winamp installation directory is scanned automatically on first run
 · Fixed preferences page layout ("Available plugins" listbox border, scrollbars, etc.)
 · Using better method to get icon for "embedded windows"

v0.2.2
 · Fix: Crash on files with sample rate < 44.1 kHz or on song change between files with different sample rate.
 · Fix: Reporting possibly invalid waveform/spectrum data from files with non-standard channel count.

v0.2.1
 · Reverted "feature" #3 of v0.2.0.

v0.2.0
 · Optimized processing of multichannel audio & spectrum data.
 · More acurate waveform data are now passed to the plugins.
 · The command "Next" goes to random entry if random playlist order is selected. (see below)
 · Fix: Milkdrop 1.04 fake fullscreen option results in close.
 · Fix: Closing AVS window does not stop it completely, it has to be closed again by "Shpeck/Stop" command afterwards.
 · Fix: Position of the fake Winamp's window is illegal. (Now uses v2.4 skin window size @ 0,0.)
 · Panel integration improvements:
   · Rewritten panel embedding interface for better compatibility.
   · Fix: Context menu of some plugins is not accessible because it's being overriden by the Column UI's default one.
   · Fix: MilkDrop2 in panel cannot be run twice ("Can't register window class.").
   · Fix: MilkDrop2/AVS in panel creates multiple windows when switching to/from fullscreen mode.

v0.1.3
 · Handling of "embedded windows" changed again (saving position only if moved around, occasional behaviour)
 · Fixed random preset toggling
 · Fixed and added commands (seeking backwards, non-standard previous song command, repeat, shuffle)
 · Fixed fake Winamp window title for compatibility (e.g. GeekAmp)

Known issues:
 · MilkDrop v1.04 closes itself when attempted to enter the "fake fullscreen" mode. Uncheck "Integrate
   with Winamp skin" in MilkDrop configuration to rectify temporarily.

v0.1.2
 · "Wasabi services API" has been partially implemented, MilkDrop v2.0d and "Nullsoft Tiny Fullscreen" work now
 · Positioning of "embedded windows" has been rewritten, position of plugin windows should stay the same between
   runs and reflect what the plugin wants correctly.
   Warning: This could have a negative impact on usage inside a CUI/DUI panel, which I haven't tested much
 · "Embedded windows" now have a fb2k icon instead of windows default
 · Fixed bug which caused AVS to stay active after closing its window instead of invoking "Shpeck - stop" command
 · Some things I don't remember

v0.1.1
 · Fixed some crash issues

v0.1.0
 · Each plugin now has its own menu item, there's no need to choose the "active one" in the preferences anymore.
   (Note: Plugin list isn't refreshed automatically anymore.)
 · Plugins can now be changed without manual stop-start cycle
 · Plugins running in a embedded window now have a toolbar with next/prev/random/fullscreen/menu buttons to send
   commands. Can be hidden in preferences or popup menu.
 · Plugins running in a embedded window now get keyboard focus correctly and can be controlled
 · Title is correctly reseted when playback is stopped
 · Works in Columns UI panel now, too

 Notes:
 The standard plugins work as usual, i.e. creating their own window or running in fullscreen. Embedded window
 plugins run in a CUI panel or in an external window if panel is not available. Only one instance of the panel
 is allowed. Current version of CUI allows you to create more instances during "Live editing mode", but it's
 only a temporary bug. Known plugins embeddable in a panel are Milkdrop v1/v2 and AVS. AVS is supposed to be
 only run this way. For MilkDrop check "Integrate with Winamp" in their configuration. Embedded window toolbar
 buttons don't work for MilkDrop v1.

 One plugin can be selected to be run in the panel after start automatically - click on the caption/title and
 use the popup menu.
 
 If you prefer old Milkdrop v1.04 behaviour change vis_milk.dll at offset 0002A12B from 74h to EBh.

Failed to load DLL: foo_vis_shpeck.dll
Reason: This application has failed to start because the application configuration is incorrect. Reinstalling the application may fix this problem.  

%artist% - %title%' | from: '%album%' ('%date%')' $if($or($strcmp($left(%path%,4),'Y:\u'),$strcmp($left(%path%,4),'X:\u')),,' *NOT Über*')

6. Known Issues / Misc. / Tips:
-------------------------------
    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\\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.