Delphi: Создание плагинов к Winamp

Windows все свое рабочее время (в промежутках между зависаниями) занимается тем, что рассылает и принимает сообщения. Например, изменил пользователь разрешение экрана, Windows тут же сообщает эту новость всем окнам (извините за тавтологию), мол, пора бы и перерисоваться. Разумеется, каждая программа может реагировать на любое сообщение по-своему. Многие приложения определяют для себя некоторые специфичные команды, которые зачастую бывают просто необходимы. Возьмем, к примеру, Microsoft Word. У него есть главное внешнее окно, внутри которого располагаются дочерние окна, в которых открываются документы. Предположим, пользователь запустил Word и редактирует какой-нибудь документ. И вдруг он где-то в "Проводнике" увидел еще один файл, который ему срочно нужно редактировать в том же Word. Юзер два раза кликает по файлу, и опять запускается Word. Word-копия проверяет, единственный ли он и неповторимый, или уже есть его запущенный собрат. Если есть, то он посылает некое сообщение оригиналу и благополучно закрывается. Word-оригинал ловит это сообщение и из него узнает, что нужно открыть такой-то файл, и открывает его, а пользователь даже и не заметил, что Word запускался второй раз. Winamp поддерживает ряд нестандартных сообщений. Благодаря этим сообщениям существует огромное количество плагинов к нему и программ, которые умеют управлять Winamp'ом.

Чтобы послать Winamp'у какое-либо сообщение, нужно прежде всего определить идентификатор его окна. Делается это при помощи WinApi-функции:

FindWindow(lpClassName, lpWindowName: PChar): HWND;

(здесь и далее используется синтаксис Object Pascal);

• lpClassName - название класса искомого окна;
• lpWindowName - заголовок искомого окна.

Для посылки сообщения используется еще одна WinApi-функция:

SendMessage(hWnd:HWND;Msg:UINT;wParam:WPARAM;lParam:LPARAM):LRESULT;

• hWnd - идентификатор окна, которому посылается сообщение;
• Msg - посылаемое сообщение;
• wParam - первый параметр сообщения;
• lParam - второй параметр сообщения.

Winamp поддерживает два основных типа сообщения (параметр Msg):

• WM_COMMAND: служит только для подачи определенных команд Winamp'у (Play, Stop, Next, Close и т.д.);
• WM_USER: используется не только для выполнения действий, но и для определения различной информации (версия, текущая композиция, количество композиций и т.д.).

В таблице 1 приведены основные константы для первого параметра сообщения WM_COMMAND.

Для их использования можно применять процедуру:

Procedure WinampCommand(Command:Integer);
 var
  WinampHWND:HWND;
begin
 //поиск окна Winamp'a
 WinampHWND:=findwindow('Winamp v1.x',nil);
 //если поиск успешен, то посылаем сообщение
 if WinampHWND<>0 then
  SendMessage(WinampHWND, WM_Сommand, Command, 0);
end;

Теперь для подачи сообщения типа WM_COMMAND нужно выбрать из таблицы понравившуюся константу и передать ее в качестве параметра процедуре WinampCommand. Пример:

WinampCommand(40044); - переход к предыдущей композиции.

В таблице 2 перечислены основные константы для сообщений WM_USER.

Для их использования запишите следующую функцию:

Function WinampUser(data:Integer, id:Integer):integer;
 var
  WinampHWND:HWND;
begin
 WinampHWND:=findwindow ('Winamp v1.x', nil);
 if WinampHWND<>0 then
  result:=SendMessage (WinampHWND,WM_USER,data, id)
 else result:=-1;
end;

Пример:

WinampUser(1, 105); - возвращает длину текущей композиции в секундах.

Управлять Winamp'ом мы уже научились, это умение пригодится для написания плагинов к нему.

Плагины к Winamp'у бывают пяти видов:

1. Input - плагины для проигрывания различных форматов;
2. Output - для записи музыки в различных форматах;
3. General Purpose - плагины общего назначения, в них наиболее часто используются сообщения, которые мы рассмотрели выше;
4. DSP/Effect - для обработки звука;
5. Visualization - плагины, которые делают что-нибудь в такт музыке.

На сайте http://www.winamp.com/ можно скачать шаблоны всех типов плагинов. Для примера рассмотрим маленький визуализационный плагин, который заставит мигать лампочки Num Lock, Caps Lock и Scroll Lock в такт музыке. Для этого воспользуемся соответствующим шаблоном (vis_minisdk). В нем присутствует функция Render, которая через заданный промежуток времени получает от Winamp'a информацию о текущих уровнях частот проигрываемой музыки. Остается только написать обработчик этих данных:

{Если плагин пишется не на C, то не следует забывать, что параметры процедур должны передаваться так же, как в этом языке. Поэтому в данном случае нужно использовать служебное слово cdecl (c-declaration)}

function Render(this_mod: PwinampVisModule): integer;cdecl;

//внутренняя процедура, которая будет гаситьзажигать нужные лампочки
 Procedure SetLock(n, state:byte);
  var
   KS: TKeyboardState;
   c: byte;
 begin
  //смотрим, с какой лампочкой будем работать
  case n of
   0: c:=VK_NUMLOCK;
   1: c:=VK_CAPITAL;
   2: c:=VK_SCROLL;
  end;
  //в зависимости от параметра state, зажигаем либо гасим лампочку
  GetKeyboardState(KS);
  KS[c]:=state;
  SetKeyboardstate(KS);
 end;

 var
  i:byte;
begin
 //в зависимости от уровня звука, гасимзажигаем
 //соответствующие лампочки
 for i:=0 to 2 do
 if this_mod.spectrumData [0,i]>40 then SetLock(i, 1)
  else SetLock(i, 0);
 result:=0;
end;

Весь исходный код и готовый плагин можно найти на странице www.IvanFDC.narod.ru/download.html. Хочу отметить, что данный плагин управляет только состоянием лампочек, а сами клавиши не трогает. Поэтому при использовании плагина можно набирать текст безо всяких проблем.

Как видим, всю работу по обработке звука Winamp берет на себя, поэтому создавать плагины к этому популярнейшему плееру может даже человек, весьма далекий от музыки.