Convertendo Plugins de Teclado ANSI para Layouts Internacionais

Este tutorial mostrará como converter plugins do SignalRGB feitos para teclados ANSI para funcionar com outros layouts de teclado.

A primeira coisa que precisamos fazer é entender a diferença entre os layouts de teclado ANSI e Internacional.

Identificando as Teclas Problemáticas

Observando a imagem abaixo, você pode ver muitas diferenças entre as legendas das teclas no teclado ANSI e no teclado alemão. Olhando para os LEDs, porém, vemos que apenas dois deles não estão acesos no teclado alemão comparado ao ANSI.

Isso significa que, no nosso caso, precisamos mapear apenas dois LEDs adicionais. Também precisamos prestar atenção em onde estão nossos LEDs não mapeados.

Agora que entendemos quais LEDs estão faltando ou estão mapeados incorretamente, precisamos corrigir esses LEDs mal posicionados.

Encontrando o Plugin do seu Teclado

Primeiro, abra o SignalRGB, depois vá à aba de dispositivos. Navegue até o seu teclado, clique no ícone de engrenagem, ative “show console”. O nome do arquivo do plugin (geralmente brand_model.js) está localizado à esquerda do botão “Force Reload Plugin”.

Navegue até este caminho no seu explorador de arquivos:

%localappdata%\VortxEngine\app-<versão atual>\Signal-x64\Plugins

Isso deve levá-lo a esta localização:

Agora navegue até a pasta da marca do seu dispositivo e encontre o plugin que o seu dispositivo está usando. No nosso caso, precisamos encontrar o plugin do teclado Roccat Pyro.

Copie o arquivo do plugin e cole-o em Documents/WhirlwindFX/plugins.

Agora feche e reabra o SignalRGB. Isso é feito para que quaisquer alterações feitas ao plugin do seu teclado entrem em vigor imediatamente.

Modificando o Plugin do Teclado

Em seguida, precisamos abrir nosso plugin de teclado em um editor de texto. Você verá uma tela semelhante à mostrada abaixo.

As três propriedades com as quais nos importamos são vKeys, vKeyPositions e vKeyNames.

• vKeys informa ao SignalRGB a que posição cada tecla corresponde dentro de um pacote de cor RGB. O sistema usado para indicar a qual posição cada tecla corresponde é diferente entre marcas e até mesmo entre produtos da mesma marca.
• vKeyPositions informa ao SignalRGB onde cada tecla está dentro do retângulo que representa o teclado na tela de efeitos.
• vKeyNames informa ao SignalRGB como cada tecla é nomeada no painel de pintura de teclas.

Nota: Todos os 3 devem ser ajustados juntos para que o SignalRGB funcione corretamente.

Também é importante notar: se o seu dispositivo não tiver um array vKeys, entre neste servidor discord para obter ajuda.

Voltando ao nosso editor de texto, a primeira propriedade que vamos mudar é o vKeyNames. Olhando nosso teclado físico, vemos que precisamos adicionar uma tecla logo antes da tecla Enter e também adicionar mais uma tecla diretamente após nossa tecla Shift esquerdo, conforme mostrado abaixo.

Agora precisamos adicionar nossas duas novas teclas ao array vKeyPositions.

Olhando nosso array vKeyPositions e nosso array vKeyNames, precisamos encontrar onde colocar nossas duas novas teclas. Para fazer isso, vamos encontrar as duas teclas que usamos como referência para o nosso array vKeyNames. Olhando nossa tecla Enter, ela está na posição [13,4]. A posição [12,4] está vazia, então vamos colocar uma posição lá para nossa tecla ISO_#. Nossa tecla ISO_< é um pouco mais complicada. Se olharmos nossa tecla Shift esquerdo, não há slots livres até [11,5]. Vamos colocar uma posição lá, pois estamos efetivamente apenas deslocando todas as nossas teclas uma posição para baixo.

Por fim, precisamos adicionar nossas duas teclas ao nosso array vKeys. Precisamos usar as posições do array vKeyPositions para colocar nossas teclas corretamente. A questão é: o que definimos como IDs de tecla nessas posições? Na maioria dos casos, não sabemos o que essas posições precisam ser definidas. Para encontrar as posições corretas no array para nossas teclas, usaremos simplesmente tentativa e erro. Saberemos que encontramos os IDs de tecla corretos quando nossas teclas acenderem. No nosso caso, os números corretos das teclas foram 12 e 75.

Agora que temos nossas teclas mapeadas corretamente, nosso plugin está completo! Se você quiser que seu layout de teclado seja incluído oficialmente no SignalRGB, envie seu arquivo de plugin modificado para [email protected].