Настройка плагина
Принципы настройки плагина
Для настройки плагина необходимо внести изменения в системный реестр Windows. Это можно сделать двумя способами: непосредственно отредактировать реестр с помощью Редактора реестра (например, программы regedit.exe из стандартных программ Windows), либо отредактировать файл с настройками simple_keys_setting.reg с помощью любого текстового редактора, не форматирующего текст (например, notepad.exe), после чего внести (импортировать) настройки из файла в реестр. В любом случае необходимо иметь ввиду, что редактирование реестра является довольно опасной операцией и в случае ошибочного изменения важных параметров способно привести к неработоспособности системы. Поэтому вы должны быть точно уверенными в правильности своих действий, также рекомендуется сделать резервную копию реестра перед внесением изменений.
Настройки плагина находятся в ветви реестра HKEY_CURRENT_USER\Software\Winamp\Plugins\DenVo\Simple_Keys. Настройки представляют собой список параметров реестра, каждое из которых сопоставляет действие программы (например, запустить воспроизведение) с определенной комбинацией клавиш. Параметры должны иметь имена, по которым они ассоциируются с действиями. В данной версии плагина поддерживаются следующие имена (в скобках приведены действия программы):
- Play (начать воспроизведение)
- Stop (остановить воспроизведение)
- Pause (приостановить воспроизведение)
- PlayPause (если идет воспроизведение, приостановить, иначе начать/продолжить)
- NextTrack (перейти к следующей песне)
- PrevTrack (перейти к предыдущей песне)
Имена можно указывать без учета регистра (например, 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
Cоставление кодов "горячих клавиш"
Код "горячей клавиши", используемый в качестве значения в параметре реестра, состоит из флагов модификаторов (клавиш 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 (шестнадцатеричный).
Для настройки плагина вы можете также воспользоваться онлайн-конфигуратором.