Плагин "Simple Keys" для программы WinAmp предназначен для управления программой с помощью настраиваимых пользователем комбинаций "горячих клавиш". В отличие от большинства программ, выполняющих аналогичные функции, предлагаемый плагин обладает рядом преимуществ: он загружается автоматически вместе с WinAmp, выгружается при завершении работы проигрывателя, при работе использует мало памяти и других системных ресурсов, не создает иконок в системном трее и других лишних проявлений своей активности. Наконец, он распространяется совершенно бесплатно.
Текущая версия плагина "Simple Keys" (далее Программы), документация и сопутствующие файлы могут свободно использоваться, копироваться, передаваться и распространяться любыми способами при соблюдении следующих условий: - Файлы Программы должны распространяться в неизменном исходном виде. Это должен быть исходный дистрибутив, сформированный автором. - Программа распространяется бесплатно и для некоммерческого использования. Никто не в праве взимать плату за Программу в каком бы то ни было виде, а также использовать Программу для извлечения прибыли без письменного разрешения автора. - Вы не можете сдавать Программу в наем или аренду, продавать код Программы, передавать Программу или любые из ее составляющих, иначе, чем определено настоящим лицензионным соглашением. - Любое нелегальное использование Программы означает автоматическое и немедленное прекращение действия настоящего лицензионного соглашения. Программа распространяется по принципу "как есть". Любые последствия, финансовые и другие потери, могущие наступить вследствие использования Программы самой по себе и/или совместно с другим программным обеспечением не могут являться поводом для предъявления каких-либо претензий к автору Программы. Использование Программы означает, что вы прочитали настоящее лицензионное соглашение и полностью его принимаете.
В состав дистрибутива плагина входит DLL с самим плагином, настоящая инструкция по установке и настройке и пример файла конфигурации.
Для установки плагина необходимо:
Если плагин успешно загрузился, он будет отображаться в разделе "Plug-ins / General Purpose" диалога настроек программы.
Для настройки плагина необходимо внести изменения в системный реестр Windows. Это можно сделать двумя способами: непосредственно отредактировать реестр с помощью Редактора реестра (например, программы regedit.exe из стандартных программ Windows), либо отредактировать файл с настройками simple_keys_setting.reg с помощью любого текстового редактора, не форматирующего текст (например, notepad.exe), после чего внести (импортировать) настройки из файла в реестр. В любом случае необходимо иметь ввиду, что редактирование реестра является довольно опасной операцией и в случае ошибочного изменения важных параметров способно привести к неработоспособности системы. Поэтому вы должны быть точно уверенными в правильности своих действий, также рекомендуется сделать резервную копию реестра перед внесением изменений.
Настройки плагина находятся в ветви реестра HKEY_CURRENT_USER\Software\Winamp\Plugins\DenVo\Simple_Keys. Настройки представляют собой список параметров реестра, каждое из которых сопоставляет действие программы (например, запустить воспроизведение) с определенной комбинацией клавиш. Параметры должны иметь имена, по которым они ассоциируются с действиями. В данной версии плагина поддерживаются следующие имена (в скобках приведены действия программы):
Имена можно указывать без учета регистра (например, play или PLAY).
Значение параметра определяет комбинацию клавиш для выполнения соответствующего действия. Оно должно иметь тип DWORD и в шестнадцатеричном виде выглядит так: 000X00YY, где X -- флаги модификаторов Shift, Control, Alt и Win, YY -- шестнадцатеричный виртуальный код клавиши на клавиатуре. Флаги модификаторов и коды клавиш для вашего удобства приведены в конце данной инструкции.
В качестве примера можно использовать файл simple_keys_setting.reg, который подробно комментирует каждый параметр. Текст этого файла также приводится здесь:
REGEDIT4 ; Пример файла настроек плагина "Simple Keys" для WinAmp ; Имя ключа с настройками плагина [HKEY_CURRENT_USER\Software\Winamp\Plugins\DenVo\Simple_Keys] ; Параметры задают комбинации клавиш для команд WinAmp. ; Формат кода в шестнадцатеричном виде следующий: 000X00YY, ; где X – флаги модификаторов, а YY – виртуальный код клавиши. ; Команда остановки воспроизведения ; Комбинация: Alt+S. Флаг модификатора: 1. Виртуальный код клавиши: 53. ; Код "горячей клавиши": 00010053 "Stop"=dword:00010053 ; Команда приостановить/продолжить воспроизведение ; Комбинация: Alt+P. Флаг модификатора: 1. Виртуальный код клавиши: 50. ; Код "горячей клавиши": 00010050 "PlayPause"=dword:00010050 ; Команда перехода к предыдущему треку ; Комбинация: Win+Стрелка влево. Флаг модификатора: 8. Виртуальный код клавиши: 25. ; Код "горячей клавиши": 00080025 "PrevTrack"=dword:00080025 ; Команда перехода к следующему треку ; Комбинация: Win+Стрелка вправо. Флаг модификатора: 8. Виртуальный код клавиши: 27. ; Код "горячей клавиши": 00080027 "NextTrack"=dword:00080027
Для удаления плагина необходимо завершить работу программы WinAmp, затем удалить файл gen_simple_keys.dll из каталога плагинов программы. Также при желании вы можете удалить ветвь HKEY_CURRENT_USER\Software\Winamp\Plugins\DenVo\Simple_Keys из системного реестра, чтобы удалить настройки плагина. При редактировании реестра необходимо соблюдать меры предосторожности, описанные выше.
По всем вопросам, связанным с работой плагина, вы можете обращаться на сайта автора: http://www.denvo.ru.
Код "горячей клавиши", используемый в качестве значения в параметре реестра, состоит из флагов модификаторов (клавиш Shift, Control, Alt и Win) и виртуального кода клавиши. Формат кода в шестнадцатеричном виде следующий: 000X00YY, где X – флаги модификаторов, а YY – виртуальный код клавиши.
В первой таблице приведены флаги модификаторов.
| Значение флага | Shift | Control | Alt | Win |
|---|---|---|---|---|
| 0 | ||||
| 1 | Нажата | |||
| 2 | Нажата | |||
| 3 | Нажата | Нажата | ||
| 4 | Нажата | |||
| 5 | Нажата | Нажата | ||
| 6 | Нажата | Нажата | ||
| 7 | Нажата | Нажата | Нажата | |
| 8 | Нажата | |||
| 9 | Нажата | Нажата | ||
| A | Нажата | Нажата | ||
| B | Нажата | Нажата | Нажата | |
| C | Нажата | Нажата | ||
| D | Нажата | Нажата | Нажата | |
| E | Нажата | Нажата | Нажата | |
| F | Нажата | Нажата | Нажата | Нажата |
Во второй таблице приведены коды виртуальных клавиш.
| Старшая цифра | Младшая цифра | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | A | B | C | D | E | F | |
| 0 | Bkspc | Tab | Enter | |||||||||||||
| 1 | Shift | Ctrl | Alt | Pause | Caps | Esc | ||||||||||
| 2 | Space | PgUp | PgDn | End | Home | Left | Up | Right | Down | PrScr | Ins | Del | ||||
| 3 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | ||||||
| 4 | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | |
| 5 | P | Q | R | S | T | U | V | W | X | Y | Z | LWin | RWin | Apps | Sleep | |
| 6 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | * | + | - | . | / | |
| 7 | F1 | F2 | F3 | F4 | F5 | F6 | F7 | F8 | F9 | F10 | F11 | F12 | F13 | F14 | F15 | F16 |
| 8 | F17 | F18 | F19 | F20 | F21 | F22 | F23 | F24 | ||||||||
| 9 | Num | Scrl | ||||||||||||||
| A | LShift | RShift | LCtrl | RCtrl | LAlt | RAlt | Back | Fwd | Refr | Stop | Search | Fav | Home | Mute | Vol- | Vol+ |
| B | Next | Prev | Stop | PlPaus | Media | App1 | App2 | ; : | + = | , < | - = | . > | / ? | |||
| C | ` ~ | |||||||||||||||
| D | [ { | \ | | ] } | ' " | ||||||||||||
Цветовая кодировка обозначает различные типы клавиш:
| Alt | Системная клавиша |
| * | Клавиша цифровой клавиатуры |
| Media | Мультимедиа-клавиша (поддержка в Win2k/XP) |
Комбинация: Alt+P. Флаг модификатора: 1. Виртуальный код клавиши: 50. Код "горячей клавиши": 00010050 (шестнадцатеричный).
Комбинация: Ctrl+Win+Del. Флаг модификатора: A. Виртуальный код клавиши: 2E. Код "горячей клавиши": 000A002E (шестнадцатеричный).