Wimamp 视觉效果插件 DIY

    我想：在回答“你用什么播放器听 MP3”这个问题时，90%的人都会回答 Winamp！那么你一定用过 Winamp 的插件功能吧，正是多样化的插件使这个“老”播放器不断地焕发青春。不管新推出什么音频格式(MP4,VQF,RM...)，只要插件一装就能播放。还有形形色色的可视插件，比如 Giess 等等，将音乐的节奏感表现的可谓淋漓尽致！

    既然插件是用程序编写的，那么我们何不来一试身手，动手做它一个出来？！用过 Winamp 的人都知道，Winamp 插件是放在 Pulgin 文件夹中一个个的 DLL(动态链接库)文件，所以编写 Winamp 插件其实就是编写 Windows 的动态链接库。当然写的时候是要遵循一定的规范的(相关文档可以从 www.winamp.com 下载)，在这方面，Winamp 作者 Justin Frankel 写的一个可视插件的例子可以作为我们很好的参考。下面我们就以这个例子(当然也是一个编写规范)为参考，认识一下 Winamp 可视插件的编写方法。
(下面的程序可从 Winamp 官方网站下载，文件名为 vis_minisdk.zip)

首先让我们看一下可视插件使用的数据结构(在文件 Vis.h 中)
// 注意:
// 任何呆在前台的插件窗口都应该将按键传送给其父(WinAMP 的)窗口，以确保
// 用户仍旧可以控制 WinAMP(除非用户按了 ESC 键或者插件所指定的键)。
// 在存储配置时，配置数据应当统一存放在 <dll directory>/plugin.ini 中。
// 请将这个插件例程看作一个框架。

typedef struct winampVisModule {
  char *description; // 模块描述(出现在插件选择列表框下面得下拉列表框中)
  HWND hwndParent; // 父窗口------------- (由主调应用填充)
  HINSTANCE hDllInstance; // 此 DLL 的实例句柄 - (由主调应用填充)
  int sRate; // 采样速率 ---------- (由主调应用填充)
  int nCh; // 声道数 ------------ (由主调应用填充)
  int latencyMs; // 从调用 RenderFrame 到真正绘制的潜伏时间(毫秒)
  // (主调应用在获取数据的时候会查看这个值)
  int delayMs; // 每两次调用之间的间隔时间(毫秒)

  // 数据依照各自的 Nch(声道数) 条目被填充
  int spectrumNch;
  int waveformNch;
  unsigned char spectrumData[2][576]; // 频谱数据
  unsigned char waveformData[2][576]; // 波形数据

  void (*Config)(struct winampVisModule *this_mod); // 模块配置函数
  int (*Init)(struct winampVisModule *this_mod); // 初始化函数(创建窗口等等)。成功返回0
  int (*Render)(struct winampVisModule *this_mod); // “表演”函数。成功返回0，如返回1表示插件应该终止
  void (*Quit)(struct winampVisModule *this_mod); // 模块退出函数。完成之后调用

  void *userData; // 用户数据 (可选)
} winampVisModule;

typedef struct {
  int version; // VID_HDRVER (当前模块的版本)
  char *description; // 插件的描述(出现在选择插件对话框的插件列表框中)
  winampVisModule* (*getModule)(int); // 用来获取模块结构
} winampVisHeader;

// 定义导出标识
typedef winampVisHeader* (*winampVisGetHeaderType)();

// 当前模块的版本 (0x101 == 1.01)
#define VIS_HDRVER 0x101

    上面列出的是一个编写可视插件必须包含的头文件，里面列出了可视插件用到的数据结构。在探讨具体插件程序之前，有一些概念必须搞清：一个可视插件中可以包含若干个模块(每一模块都是一种演示效果，可以在插件选择对话框中选择用哪个模块来演示)，这些模块通过某种方法(后面将会看到)被 Winamp 获取，从而得到“表演”的机会。简而言之，Winamp 利用所有插件 DLL 中导出的一个统一名称的函数获得了一个插件头数据结构，然后通过此数据结构中的一个函数再去获取各个模块的信息(这个过程与 COM 的 QueryInterface() 用法有些神似，看来好的设计思想是相通的)，进而利用多线程(通过 DLL View 观察得知)实现可视插件的展示。下面就是可视插件的源程序：
// Winamp 测试用可视插件 v1.0
// 版权所有 (C) 1997-1998, Justin Frankel/Nullsoft
// 基于此框架可自由的编写任何可视插件...

#include <windows.h>

#include "vis.h"

char szAppName[] = "SimpleVis"; // 窗口类名

// 有关配置的声明
int config_x=50, config_y=50; // 窗口在屏幕上的横纵坐标
void config_read(struc