From 137df5a46ca10a9215419a212c6c34078140c93a Mon Sep 17 00:00:00 2001 From: AndersonTorres Date: Mon, 23 Aug 2021 10:06:54 -0300 Subject: [PATCH] ptBR translations: docs/ptBR/encoder.md --- docs/ptBR/encoder.md | 64 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 docs/ptBR/encoder.md diff --git a/docs/ptBR/encoder.md b/docs/ptBR/encoder.md new file mode 100644 index 0000000..2abec3a --- /dev/null +++ b/docs/ptBR/encoder.md @@ -0,0 +1,64 @@ +# Encoder + +Aumente o volume! Acrescente zoom, volume ou qualquer coisa do gênero ao seu +teclado! + +## Habilitando a Extensão + +O construtor toma no mínimo três argumentos: uma lista de pinos `pad_a`, uma +lista de pinos `pad_b`, e um `encoder_map`. O `encoder_map` é modelado de acordo +com o teclado e funciona da mesma forma. Ele deve ter tantas teclas qyanto seu +teclado, e usar teclas `KC.NO` para camadas que não exijam ação alguma. O +encoder suporta um modo de velocidade se você deseja fazer algo com edição de +áudio ou vídeo. A direção de incremento/decremento pode ser mudada a fim de +fazer par com a direção que o botão está orientado, atribuindo à flag `is_inverted`. + +## Configuração + +Eis um exemplo completo no `main.py` do Atreus62. + +Crie suas teclas especiais: + +```python +Zoom_in = KC.LCTRL(KC.EQUAL) +Zoom_out = KC.LCTRL(KC.MINUS) +``` + +Crie o `encoder_map`. + +Anatomia de uma tupla de `encoder_map`: `(increment_key, decrement_key, teclas +pressionadas por clique do encoder)` + +```python + +# create the encoder map, modeled after the keymap +encoder_map = [ + [ + # Only 1 encoder is being used, so only one tuple per layer is required + # Increment key is volume up, decrement key is volume down, and sends 2 + # key presses for every "click" felt while turning the encoder. + (KC.VOLU,KC.VOLD,2), + [ + # only one key press sent per encoder click + (Zoom_in, Zoom_out,1), + ], + [ + # No action keys sent here, the resolution is a dummy number, to be + # removed in the future. + (_______,_______,1),# + ] +] + +# create the encoder instance, and pass in a list of pad a pins, a lsit of pad b +# pins, and the encoder map created above +encoder_ext = EncoderHandler([board.D40],[board.D41], encoder_map) + +# if desired, you can flip the incrfement/decrement direction of the knob by +# setting the is_inerted flag to True. If you turn the knob to the right and +# the volume goes down, setting this flag will make it go up. It's default +# setting is False +encoder_ext.encoders[0].is_inverted = True + +# Make sure to add the encoder_ext to the modules list +keyboard.modules = [encoder_ext] +```