From d9ba701d09fd5902c3fd83002838543ee6a7d89e Mon Sep 17 00:00:00 2001 From: devicewhite Date: Tue, 22 Oct 2024 11:56:06 -0300 Subject: [PATCH 1/2] Added translations for HideGameTextForAll and HideGameTextFor (22/10/2024 11:58) --- .../scripting/functions/HideGameTextForAll.md | 45 +++++++++++++++++++ .../functions/HideGameTextForPlayer.md | 40 +++++++++++++++++ 2 files changed, 85 insertions(+) create mode 100644 docs/translations/pt-BR/scripting/functions/HideGameTextForAll.md create mode 100644 docs/translations/pt-BR/scripting/functions/HideGameTextForPlayer.md diff --git a/docs/translations/pt-BR/scripting/functions/HideGameTextForAll.md b/docs/translations/pt-BR/scripting/functions/HideGameTextForAll.md new file mode 100644 index 000000000..dcffc6f8d --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/HideGameTextForAll.md @@ -0,0 +1,45 @@ +--- +title: HideGameTextForAll +description: Esconder um estilo de gametext para todos os jogadores. +tags: ["player", "gametext"] +--- + + + +## Descrição + +Interrompe a exibição de um estilo de gametext para todos os jogadores. + +| Nome | Descrição | +| -------------- | ----------------------------------------------------------------- | +| style | O [estilo](../resources/gametextstyles) de texto a esconder. | + +## Retornos + +Essa função não retorna nenhum valor específico. + +## Exemplos + +```c +public OnPlayerCommandText(playerid, cmdtext[]) +{ + if (!strcmp(cmdtext, "/hidegametext3", true)) + { + if (!IsPlayerAdmin(playerid)) + { + return 1; + } + + HideGameTextForAll(3); + return 1; + } + return 0; +} +``` + +## Funções Relacionadas + +- [HideGameTextForPlayer](HideGameTextForPlayer): Esconder um estilo de gametext para um jogador. +- [GameTextForPlayer](GameTextForPlayer): Exibir um gametext para um jogador. +- [GameTextForAll](GameTextForAll): Exibir um gametext para todos os jogadores. +- [TextDrawHideForAll](TextDrawHideForAll): Esconder um textdraw para todos os jogadores. diff --git a/docs/translations/pt-BR/scripting/functions/HideGameTextForPlayer.md b/docs/translations/pt-BR/scripting/functions/HideGameTextForPlayer.md new file mode 100644 index 000000000..945140dd2 --- /dev/null +++ b/docs/translations/pt-BR/scripting/functions/HideGameTextForPlayer.md @@ -0,0 +1,40 @@ +--- + +title: HideGameTextForPlayer +description: Esconder um estilo de gametext para um jogador. +tags: ["player", "gametext"] +--- + + + +## Descrição + +Interrompe a exibição de um estilo de gametext para um jogador. + +| Nome | Descrição | +| -------------- | ----------------------------------------------------------------- | +| playerid | O ID do jogador para o qual o gametext será ocultado. | +| style | O [estilo](../resources/gametextstyles) do texto a ser ocultado. | + +## Retornos + +Essa função não retorna nenhum valor específico. + +## Exemplos + +```c +public OnPlayerDeath(playerid, killerid, WEAPON:reason) +{ + HideGameTextForPlayer(playerid, 3); + return 1; +} +``` + +## Funções Relacionadas + +- [HideGameTextForAll](HideGameTextForAll): Parar de mostrar um estilo de gametext para todos os jogadores. +- [GameTextForPlayer](GameTextForPlayer): Mostrar gametext para um jogador. +- [GameTextForAll](GameTextForAll): Mostrar gametext para todos os jogadores. +- [GetGameText](GetGameText): Obtém todas as informações sobre o estilo de gametext dado. +- [HasGameText](HasGameText): O jogador tem um texto no estilo de gametext atual sendo exibido? +- [TextDrawHideForAll](TextDrawHideForAll): Esconder um textdraw para todos os jogadores. \ No newline at end of file From 8a1343b12fef42bb82279093e61684684a181e90 Mon Sep 17 00:00:00 2001 From: devicewhite Date: Tue, 22 Oct 2024 12:55:53 -0300 Subject: [PATCH 2/2] Translation added for gametextstyles and keys (22/10/2024 12:56) --- .../scripting/resources/gametextstyles.md | 93 +++++++++++++++++++ .../pt-BR/scripting/resources/keys.md | 60 ++++++++++++ 2 files changed, 153 insertions(+) create mode 100644 docs/translations/pt-BR/scripting/resources/gametextstyles.md create mode 100644 docs/translations/pt-BR/scripting/resources/keys.md diff --git a/docs/translations/pt-BR/scripting/resources/gametextstyles.md b/docs/translations/pt-BR/scripting/resources/gametextstyles.md new file mode 100644 index 000000000..553035253 --- /dev/null +++ b/docs/translations/pt-BR/scripting/resources/gametextstyles.md @@ -0,0 +1,93 @@ +--- +title: Estilos de GameText +description: Estilos de GameText usados em textdraws e gametext. +--- + +Esta página aborda tudo o que você precisa saber sobre estilos de gametext e como eles podem ser usados em textdraw e em texto renderizado para um (único) jogador. +Usado principalmente por [GameText](../functions/GameTextForPlayer) e [GameTextForAll](../functions/GameTextForAll). + +--- + +## Cores do texto +É possível desenhar certas partes do seu texto em cores diferentes. Para fazer isso, você simplesmente precisa usar os slugs de cores listados abaixo e encapsular a parte do texto que deseja desenhar em uma cor específica (ex: \~y\~Eu sou desenhado em amarelo!\~y\~). + +| Codigo | Cor | Descrição | +| -------------------- | -------------------------------------- | ------------------------------------------------ | +| N/A | ![](/images/gameTextStyles/-.png) | Cor padrão, não possui código. | +| `~h~` | ![](/images/gameTextStyles/h.png) | Versão mais clara da cor padrão | +| `~h~~h~` | ![](/images/gameTextStyles/hh.png) | Versão mais clara da cor padrão. | +| `~r~` | ![](/images/gameTextStyles/r.png) | Possui cinco níveis de clareamento. | +| `~r~~h~` | ![](/images/gameTextStyles/rh.png) | | +| `~r~~h~~h~` | ![](/images/gameTextStyles/rhh.png) | | +| `~r~~h~~h~~h~` | ![](/images/gameTextStyles/rhhh.png) | | +| `~r~~h~~h~~h~~h~` | ![](/images/gameTextStyles/rhhhh.png) | | +| `~r~~h~~h~~h~~h~~h~` | ![](/images/gameTextStyles/rhhhhh.png) | | +| `~g~` | ![](/images/gameTextStyles/g.png) | Possui quatro níveis de clareamento. | +| `~g~~h~` | ![](/images/gameTextStyles/gh.png) | | +| `~g~~h~~h~` | ![](/images/gameTextStyles/ghh.png) | | +| `~g~~h~~h~~h~` | ![](/images/gameTextStyles/ghhh.png) | | +| `~g~~h~~h~~h~~h~` | ![](/images/gameTextStyles/ghhhh.png) | O mesmo que `~y~~h~~h~`. | +| `~b~` | ![](/images/gameTextStyles/b.png) | Possui três níveis de clareamento. | +| `~b~~h~` | ![](/images/gameTextStyles/bh.png) | | +| `~b~~h~~h~` | ![](/images/gameTextStyles/bhh.png) | | +| `~b~~h~~h~~h~` | ![](/images/gameTextStyles/bhhh.png) | | +| `~p~` | ![](/images/gameTextStyles/p.png) | Possui dois níveis de clareamento. | +| `~p~~h~` | ![](/images/gameTextStyles/ph.png) | | +| `~p~~h~~h~` | ![](/images/gameTextStyles/phh.png) | | +| `~y~` | ![](/images/gameTextStyles/y.png) | Possui dois níveis de clareamento. | +| `~y~~h~` | ![](/images/gameTextStyles/yh.png) | | +| `~y~~h~~h~` | ![](/images/gameTextStyles/yhh.png) | O mesmo que `~g~~h~~h~~h~~h~`. | +| `~l~` | ![](/images/gameTextStyles/l.png) | "L" minúsculo. Não pode ser clareado. | +| `~w~ (or ~s~)` | ![](/images/gameTextStyles/w.png) | Tem um nível de clareamento. | +| `~w~~h~ (or ~s~~h~)` | ![](/images/gameTextStyles/wh.png) | Todas as cores se tornam assim quando muito iluminadas. | + +--- + +## Carácteres especiais +Diferentemente das cores de texto, esses slugs (código de texto) não exigem encapsulamento. Eles podem ser usados como estão. + +| Código | Descrição | +| ------ | ---------------------------------------------------------------------------------------------------------------------------------- | +| `~n~` | Nova linha | +| `~h~` | Clareie as cores selecionadas. O texto pode aparecer entre a cor principal e o clareamento, por exemplo `~r~Olá ~h~mundo` tornará "Olá" vermelho e "mundo" um vermelho ligeiramente mais claro. | +| `~u~` | Seta para cima (cinza) | +| `~d~` | Seta para baixo (cinza) | +| `~<~` | Seta para a esquerda (cinza) | +| `~>~` | Seta para a direita (cinza) | +| `~]~` | Exibe um `*` símbolo (somente nos estilos de texto 3, 4 e 5) | +| `~k~` | Mapeamento de teclas do teclado (ex: `~k~~VEHICLE_TURRETLEFT~` e `~k~~PED_FIREWEAPON~`). Veja [aqui](../resources/keys) uma lista de chaves. | + +:::caution + +Tenha cuidado, usar muitas cores de texto ou caracteres especiais em um gametext pode travar todos os jogadores para os quais o gametext é exibido. Além disso, evite usar o caractere `~` de forma desigual. Exemplo: `~~r~Olá, ~g~como vai ~y~você?` + +::: + +## Estilos de texto +Você pode usar os seguintes estilos de texto em gametext. + +| Estilo | Pré-visualização | Descrição | +| ------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | +| Estilo 0 | ![](/images/gameTextStyles/style0.png) | Aparece por 9 segundos, independentemente da configuração de tempo. Oculta textdraws e qualquer outro gametext na tela (corrigido em fixes.inc) | +| Estilo 1 | ![](/images/gameTextStyles/style1.png) | Desaparece após 8 segundos, independentemente do tempo definido. Se você tiver uma configuração de tempo maior que isso, ele reaparecerá após desaparecer e repetirá até que o tempo acabe (corrigido em fixes.inc) | +| Estilo 2 | ![](/images/gameTextStyles/style2.png) | N/A | +| Estilo 3 | ![](/images/gameTextStyles/style3.png) | N/A | +| Estilo 4 | ![](/images/gameTextStyles/style4.png) | N/A | +| Estilo 5 | ![](/images/gameTextStyles/style5.png) | Exibe por 3 segundos, independentemente do horário que você definir. Recusará ser exibido se for "spam" (corrigido em fixes.inc) | +| Estilo 6 | ![](/images/gameTextStyles/style6.png) | N/A | + +--- + +## Estilos de texto adicionados por [fixes.inc](https://github.com/pawn-lang/sa-mp-fixes) + +| Estilo | Pré-visualização | Descrição | +| -------- | --------------------------------------- | -------------------------------------------------- | +| Estilo 7 | ![](/images/gameTextStyles/style7.png) | Baseado em nomes de veículos. | +| Estilo 8 | ![](/images/gameTextStyles/style8.png) | Baseado em nomes de locais. | +| Estilo 9 | ![](/images/gameTextStyles/style9.png) | Baseado em nomes de estações de rádio (uma vez selecionado). | +| Estilo 10 | ![](/images/gameTextStyles/style10.png) | Baseado em nomes de estações de rádio (durante a troca). | +| Estilo 11 | ![](/images/gameTextStyles/style11.png) | Baseado em dinheiro positivo. | +| Estilo 12 | ![](/images/gameTextStyles/style12.png) | Baseado em dinheiro negativo. | +| Estilo 13 | ![](/images/gameTextStyles/style13.png) | Baseado nos bônus de acrobacias. | +| Estilo 14 | ![](/images/gameTextStyles/style14.png) | Baseado no relógio do jogo. | +| Estilo 15 | ![](/images/gameTextStyles/style15.png) | Com base no pop-up de notificação. | diff --git a/docs/translations/pt-BR/scripting/resources/keys.md b/docs/translations/pt-BR/scripting/resources/keys.md new file mode 100644 index 000000000..25321f6b9 --- /dev/null +++ b/docs/translations/pt-BR/scripting/resources/keys.md @@ -0,0 +1,60 @@ +--- +title: "Chaves" +--- + +:::note + +Aqui você pode encontrar informações sobre constantes de entrada de teclas usadas por [GetPlayerKeys](../functions/GetPlayerKeys) e [OnPlayerKeyStateChange](../callbacks/OnPlayerKeyStateChange). + +SA-MP usa bitmasking para determinar quais teclas estão pressionadas e quais não estão. Aqui está um artigo sobre bitmasking: [http://en.wikipedia.org/wiki/Mask\_(computing)]() + +::: + +--- + +| Macro | Valor | Código Embedding (A pé) (6) | Código Embedding (No Veículo) (6) | Tecla Padrão (A pé) | Tecla Padrão (No Veículo) | +| ------------------------ | --------- | ---------------------------- | ------------------------------- | -------------------------------------------------------- | ------------------------ | +| KEY_ACTION | 1 | \~k~\~PED_ANSWER_PHONE~ | \~k~\~VEHICLE_FIREWEAPON_ALT~ | TAB | ALT GR / LCTRL / NUM0 | +| KEY_CROUCH | 2 | \~k~\~PED_DUCK~ | \~k~\~VEHICLE_HORN~ | C | H / CAPSLOCK | +| KEY_FIRE | 4 | \~k~\~PED_FIREWEAPON~ | \~k~\~VEHICLE_FIREWEAPON~ | LCTRL / LMB (Botão Esquerdo do Mouse) | LALT | +| KEY_SPRINT | 8 | \~k~\~PED_SPRINT~ | \~k~\~VEHICLE_ACCELERATE~ | ESPAÇO | W | +| KEY_SECONDARY_ATTACK | 16 | \~k~\~VEHICLE_ENTER_EXIT~ | \~k~\~VEHICLE_ENTER_EXIT~ | ENTER | ENTER | +| KEY_JUMP | 32 | \~k~\~PED_JUMPING~ | \~k~\~VEHICLE_BRAKE~ | LSHIFT | S | +| KEY_LOOK_RIGHT | 64 | - | \~k~\~VEHICLE_LOOKRIGHT~ | - | E | +| KEY_HANDBRAKE/KEY_AIM(1) | 128 | \~k~\~PED_LOCK_TARGET~ | \~k~\~VEHICLE_HANDBRAKE~ | RMB (Botão Direito do Mouse) | ESPAÇO | +| KEY_LOOK_LEFT | 256 | - | \~k~\~VEHICLE_LOOKLEFT~ | - | Q | +| KEY_LOOK_BEHIND | 512 | \~k~\~PED_LOOKBEHIND~ | \~k~\~VEHICLE_LOOKBEHIND~ | NUM1 / MMB (Botão do Meio do Mouse - Clique na roda do mouse) | 2 | +| KEY_SUBMISSION | 512 | - | \~k~\~TOGGLE_SUBMISSIONS~ | NUM1 / MMB (Botão do Meio do Mouse - Clique na roda do mouse) | 2 / NUMPAD + | +| KEY_WALK | 1024 | \~k~\~SNEAK_ABOUT~ | - | LALT | - | +| KEY_ANALOG_UP | 2048 | - | \~k~\~VEHICLE_TURRETUP~ | NUM8(5) | NUM8 | +| KEY_ANALOG_DOWN | 4096 | - | \~k~\~VEHICLE_TURRETDOWN~ | NUM2(5) | NUM2 | +| KEY_ANALOG_LEFT | 8192 | \~k~\~VEHICLE_LOOKLEFT~ | \~k~\~VEHICLE_TURRETLEFT~ | NUM4 | NUM4 | +| KEY_ANALOG_RIGHT | 16384 | \~k~\~VEHICLE_LOOKRIGHT~ | \~k~\~VEHICLE_TURRETRIGHT~ | NUM6 | NUM6 | +| KEY_YES(2) | 65536 | \~k~\~CONVERSATION_YES~ | \~k~\~CONVERSATION_YES~ | Y | Y | +| KEY_NO(2) | 131072 | \~k~\~CONVERSATION_NO~ | \~k~\~CONVERSATION_NO~ | N | N | +| KEY_CTRL_BACK(2) | 262144(4) | \~k~\~GROUP_CONTROL_BWD~ | \~k~\~GROUP_CONTROL_BWD~ | H | H | +| UNDEFINED(3) | - | \~k~\~GROUP_CONTROL_FWD~ | \~k~\~GROUP_CONTROL_FWD~ | G | G | +| KEY_UP | -128 | \~k~\~GO_FORWARD~ | \~k~\~VEHICLE_STEERUP~ | CIMA | CIMA | +| KEY_DOWN | 128 | \~k~\~GO_BACK~ | \~k~\~VEHICLE_STEERDOWN~ | BAIXO | BAIXO | +| KEY_LEFT | -128 | \~k~\~GO_LEFT~ | \~k~\~VEHICLE_STEERLEFT~ | ESQUERDA | ESQUERDA | +| KEY_RIGHT | 128 | \~k~\~GO_RIGHT~ | \~k~\~VEHICLE_STEERRIGHT~ | DIREITA | DIREITA | + +--- + +**(1):** Tecla não definida nos includes do SA:MP. Você deve definir + +```c +#define KEY_AIM KEY_HANDBRAKE +``` + +ou usar KEY_HANDBRAKE. + +**(2):** Essa tecla não pode ser detectada quando o jogador está no [modo espectador](../functions/TogglePlayerSpectating). + +**(3):** GROUP_CONTROL_FWD não pode ser detectado no SA-MP, pois é usado internamente para entrar em veículos como passageiro. No entanto, a definição de gametext ainda existe. + +**(4):** Se o número da tecla "262144" não funcionar, apenas use o número "2". + +**(5):** Só é detectado quando a configuração "JOYPAD" está selecionada para o controle. + +**(6)** Códigos de embedding só funcionam para [mensagens do cliente](../functions/SendDeathMessage), [textdraws](../functions/TextDrawCreate) e [gametexts](../functions/GameTextForPlayer). \ No newline at end of file