当前位置:编程学习 > C/C++ >>

WinAMP插件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 键或者插件所指定的键)。

// 在存储配置时,配置数据应当统一存放在 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

 

#include "vis.h"

 

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

 

// 有关配置的声明

int config_x=50, config_y=50; // 窗口在屏幕上的横纵坐标

void config_read(struct winampVisModule *this_mod); // 读配置

补充:软件开发 , C语言 ,
CopyRight © 2012 站长网 编程知识问答 www.zzzyk.com All Rights Reserved
部份技术文章来自网络,