Конвертация ANSI-плагинов клавиатуры в международные раскладки

Это руководство покажет, как конвертировать плагины SignalRGB, созданные для ANSI-клавиатур, для работы с другими раскладками клавиатуры.

Прежде всего нужно понять разницу между ANSI и международными раскладками клавиатуры.

Определение проблемных клавиш

На изображении ниже видно множество различий между легендами клавиш на ANSI-клавиатуре и немецкой клавиатуре. Однако, глядя на светодиоды, мы видим, что только два светодиода не горят на немецкой клавиатуре по сравнению с ANSI.

Это означает, что нам нужно привязать только два дополнительных светодиода. Также нужно обратить внимание на местоположение непривязанных светодиодов.

Поняв, какие светодиоды отсутствуют или неправильно привязаны, нужно исправить неверно расположенные светодиоды.

Поиск плагина клавиатуры

Сначала откройте SignalRGB, затем перейдите на вкладку устройств. Перейдите к своей клавиатуре, нажмите значок шестерёнки, включите «show console» — имя файла плагина (обычно brand_model.js) находится слева от кнопки «Force Reload Plugin».

Перейдите по этому пути в проводнике файлов:

%localappdata%\VortxEngine\app-<current version>\Signal-x64\Plugins

Вы попадёте в это место:

Перейдите в папку бренда вашего устройства и найдите плагин, который используется. В нашем случае нужно найти плагин клавиатуры Roccat Pyro.

Скопируйте файл плагина и вставьте его в Documents/WhirlwindFX/plugins.

Теперь закройте и снова откройте SignalRGB. Это делается для того, чтобы любые изменения плагина клавиатуры вступили в силу немедленно.

Изменение плагина клавиатуры

Затем откройте плагин клавиатуры в текстовом редакторе. Вы увидите экран, похожий на показанный ниже.

Три свойства, которые нас интересуют: vKeys, vKeyPositions и vKeyNames.

• vKeys сообщает SignalRGB, какой позиции в RGB-пакете цветов соответствует каждая клавиша. Система обозначения позиций отличается у разных брендов и даже между продуктами одного бренда.
• vKeyPositions сообщает SignalRGB, где каждая клавиша находится внутри прямоугольника, представляющего клавиатуру на canvas эффектов.
• vKeyNames сообщает SignalRGB, как называется каждая клавиша на панели покраски клавиш.

Примечание: Все 3 должны быть скорректированы вместе для корректной работы SignalRGB.

Также: если в вашем устройстве отсутствует массив vKeys, присоединитесь к серверу Discord за помощью.

Вернувшись к текстовому редактору, первое свойство, которое нужно изменить — vKeyNames. Глядя на физическую клавиатуру, видим, что нужно добавить одну клавишу непосредственно перед Enter и ещё одну сразу после левого Shift, как показано ниже.

Теперь нужно добавить две новые клавиши в массив vKeyPositions.

Глядя на массивы vKeyPositions и vKeyNames, нужно найти, где разместить два новых элемента. Для этого найдём две клавиши, использованные как ориентиры для массива vKeyNames. Глядя на клавишу Enter, она находится в позиции [13,4]. Позиция [12,4] свободна, поэтому поставим туда позицию для клавиши ISO_#. С клавишей ISO_< немного сложнее. Если посмотреть на клавишу левого Shift, свободных слотов нет до [11,5]. Поставим позицию туда, фактически просто сдвинув все клавиши на одну позицию вниз.

Наконец, нужно добавить две клавиши в массив vKeys. Нужно использовать позиции из массива vKeyPositions для правильного размещения клавиш. Вопрос в том, какие ID клавиш установить на этих позициях? В большинстве случаев мы не знаем, что нужно поставить на эти позиции в массиве. Чтобы найти правильные позиции в массиве для клавиш, просто используем метод перебора. Мы поймём, что нашли правильные ID клавиш, когда они засветятся. В нашем случае правильные числа — 12 и 75.

Теперь, когда клавиши правильно привязаны, плагин готов! Если вы хотите, чтобы раскладка вашей клавиатуры была официально включена в SignalRGB, отправьте изменённый файл плагина на [email protected].