Translations and grammatical corrections (#1060)

* Translation added * Translation added * Translation added * Grammar corrected * Translation added * Translation added
openmultiplayer · Sep 27, 2024 · 42d7272 · 42d7272
1 parent e242449
commit 42d7272
Show file tree

Hide file tree

Showing 12 changed files with 532 additions and 2 deletions.
diff --git a/docs/translations/pt-BR/scripting/functions/CreateVehicle.md b/docs/translations/pt-BR/scripting/functions/CreateVehicle.md
@@ -14,7 +14,7 @@ Cria um veículo no mundo. Pode ser usado no lugar de AddStaticVehicleEx a qualq
 | Float:spawnX                           | A coordenada X do veículo.                                                                                    |
 | Float:spawnY                           | A coordenada Y do veículo.                                                                                    |
 | Float:spawnZ                           | A coordenada Z do veículo.                                                                                    |
-| Float:angle                            | O ângulo de direçao do veículo.                                                                                    |
+| Float:angle                            | O ângulo de direção do veículo.                                                                                    |
 | [colour1](../resources/vehiclecolorid) | O ID da cor primária.                                                                                                |
 | [colour2](../resources/vehiclecolorid) | O ID da cor secundária.                                                                                              |
 | respawnDelay                           | O tempo de espera até que o veículo reapareça sem um motorista, em segundos. Usar -1 impedirá que o veículo reapareça. |
@@ -49,7 +49,7 @@ Trens só podem ser adicionados com [AddStaticVehicle](AddStaticVehicle) e [AddS
 
 ## Funções Relacionadas
 
-- [DestroyVehicle](DestroyVehicle): Destrói o veículo.
+- [DestroyVehicle](DestroyVehicle): Destroi o veículo.
 - [AddStaticVehicle](AddStaticVehicle): Adiciona um veículo estático.
 - [AddStaticVehicleEx](AddStaticVehicleEx): Adiciona um veículo estático com tempo de reaparecimento customizado.
 - [GetVehicleParamsSirenState](GetVehicleParamsSirenState): Verifique se a sirene de um veículo está ligada ou desligada.

diff --git a/docs/translations/pt-BR/scripting/functions/DestroyVehicle.md b/docs/translations/pt-BR/scripting/functions/DestroyVehicle.md
@@ -0,0 +1,43 @@
+---
+title: DestroyVehicle
+description: Destroi um veículo.
+tags: ["vehicle"]
+---
+
+## Descrição
+
+Destroi um veículo. Ele desaparecerá instantaneamente.
+
+| Nome      | Descrição                        |
+| --------- | -------------------------------- |
+| vehicleid | O ID do veículo a ser destruído. |
+
+## Retornos
+
+**true** - A função foi executada com sucesso.
+
+**false** - A função falhou ao ser executada. O veículo não existe.
+
+## Exemplos
+
+```c
+public OnPlayerCommandText(playerid, cmdtext[])
+{
+     if (strcmp(cmdtext, "/destroyveh", true) == 0)
+     {
+          if (IsPlayerInAnyVehicle(playerid))
+          {
+               new vehicleid = GetPlayerVehicleID(playerid);
+               DestroyVehicle(vehicleid);
+          }
+          return 1;
+     }
+     return 0;
+}
+```
+
+## Funções Relacionadas
+
+- [CreateVehicle](CreateVehicle): Cria um veículo.
+- [RemovePlayerFromVehicle](RemovePlayerFromVehicle): Expulsa um jogador de seu veículo.
+- [SetVehicleToRespawn](SetVehicleToRespawn): Faz um veículo reaparecer.
diff --git a/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleID.md b/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleID.md
@@ -0,0 +1,37 @@
+---
+title: GetPlayerVehicleID
+description: Esta função obtém o ID do veículo em que o jogador está atualmente.
+tags: ["player", "vehicle"]
+---
+
+## Descrição
+
+Esta função obtém o ID do veículo em que o jogador está atualmente.
+
+**Nota:** NÃO é o ID do modelo do veículo. Veja [GetVehicleModel](GetVehicleModel) para isso.
+
+| Nome      | Descrição                                                        |
+| --------- | ---------------------------------------------------------------- |
+| playerid  | O ID do jogador no veículo do qual você deseja obter o ID         |
+
+## Retornos
+
+ID do veículo ou **0** se não estiver em um veículo
+
+## Exemplos
+
+```c
+// Adiciona 10x Nitro se o jogador estiver em um carro. Pode ser chamado em um comando.
+new vehicleId = GetPlayerVehicleID(playerid);
+if (vehicleId != 0)
+{
+    AddVehicleComponent(vehicleId, 1010);
+}
+```
+
+## Funções Relacionadas
+
+- [IsPlayerInVehicle](IsPlayerInVehicle): Verifica se um jogador está em um determinado veículo.
+- [IsPlayerInAnyVehicle](IsPlayerInAnyVehicle): Verifica se um jogador está em qualquer veículo.
+- [GetPlayerVehicleSeat](GetPlayerVehicleSeat): Verifica em qual assento o jogador está.
+- [GetVehicleModel](GetVehicleModel): Obtém o ID do modelo de um veículo.
diff --git a/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleSeat.md b/docs/translations/pt-BR/scripting/functions/GetPlayerVehicleSeat.md
@@ -0,0 +1,59 @@
+---
+title: GetPlayerVehicleSeat
+description: Descobre em qual assento um jogador está.
+tags: ["player", "vehicle"]
+---
+
+## Descrição
+
+Descobre em qual assento um jogador está.
+
+| Nome      | Descrição                                       |
+| --------- | ----------------------------------------------- |
+| playerid  | O ID do jogador do qual você quer saber o assento. |
+
+## Retornos
+
+O ID do assento em que o jogador está.
+
+**-1** indica que não está em um veículo, **0** é o motorista, **1** é o passageiro da frente, e **2** e **3** são os passageiros traseiros.
+
+## Exemplos
+
+```c
+public OnPlayerCommandText(playerid, cmdtext[])
+{
+    if (strcmp(cmdtext, "/myseat", true) == 0)
+    {
+        new
+            playerSeat = GetPlayerVehicleSeat(playerid);
+
+        // Como você pode descartar suas informações.
+        if (playerSeat == 128)
+        {
+            return SendClientMessage(playerid, 0xFFFFFFFF, "Um erro impediu que retornássemos o ID do assento.");
+        }
+
+        new
+            string[24];
+
+        format(string, sizeof(string), "Seu assento: %i", playerSeat);
+        SendClientMessage(playerid, 0xFFFFFFFF, string);
+        return 1;
+    }
+    return 0;
+}
+```
+
+| ID  | Assento                       |
+| --- | ------------------------------ |
+| 0   | Motorista                     |
+| 1   | Passageiro da frente          |
+| 2   | Passageiro traseiro esquerdo   |
+| 3   | Passageiro traseiro direito    |
+| 4+  | Assentos de passageiros (coaches etc.) |
+
+## Funções Relacionadas
+
+- [GetPlayerVehicleID](GetPlayerVehicleID): Obtém o ID do veículo em que o jogador está.
+- [PutPlayerInVehicle](PutPlayerInVehicle): Coloca um jogador em um veículo.
diff --git a/docs/translations/pt-BR/scripting/functions/GetVehicleDistanceFromPoint.md b/docs/translations/pt-BR/scripting/functions/GetVehicleDistanceFromPoint.md
@@ -0,0 +1,47 @@
+---
+title: GetVehicleDistanceFromPoint
+description: Esta função pode ser usada para calcular a distância (como um float) entre um veículo e outra coordenada do mapa.
+tags: ["vehicle"]
+---
+
+## Descrição
+
+Esta função pode ser usada para calcular a distância (como um float) entre um veículo e outra coordenada do mapa. Isso pode ser útil para detectar quão longe um veículo está de um local.
+
+| Nome      | Descrição                                          |
+| --------- | -------------------------------------------------- |
+| vehicleid | O ID do veículo para calcular a distância.        |
+| Float:x   | A coordenada X do mapa.                           |
+| Float:y   | A coordenada Y do mapa.                           |
+| Float:z   | A coordenada Z do mapa.                           |
+
+## Retornos
+
+Um float contendo a distância do ponto especificado nas coordenadas.
+
+## Exemplos
+
+```c
+/* quando o jogador digitar 'vendingmachine' na caixa de chat, ele verá isso.*/
+public OnPlayerText(playerid, text[])
+{
+    if (strcmp(text, "vendingmachine", true) == 0)
+    {
+        new
+            string[64],
+            vehicleid = GetPlayerVehicleID(playerid);
+
+        new
+            Float:distance = GetVehicleDistanceFromPoint(vehicleid, 237.9, 115.6, 1010.2);
+
+        format(string, sizeof(string), "Você está a %.2f de nossa máquina de vendas.", distance);
+        SendClientMessage(playerid, 0xA9C4E4FF, string);
+    }
+    return 0;
+}
+```
+
+## Funções Relacionadas
+
+- [GetPlayerDistanceFromPoint](GetPlayerDistanceFromPoint): Obtém a distância entre um jogador e um ponto.
+- [GetVehiclePos](GetVehiclePos): Obtém a posição de um veículo.
diff --git a/docs/translations/pt-BR/scripting/functions/GetVehicleModel.md b/docs/translations/pt-BR/scripting/functions/GetVehicleModel.md
@@ -0,0 +1,41 @@
+---
+title: GetVehicleModel
+description: Obtém o ID do modelo de um veículo.
+tags: ["vehicle"]
+---
+
+## Descrição
+
+Obtém o ID do modelo de um veículo.
+
+| Nome      | Descrição                                |
+| --------- | ---------------------------------------- |
+| vehicleid | O ID do veículo para obter o modelo.     |
+
+## Retornos
+
+O [ID do modelo do veículo](../resources/vehicleid), ou **0** se o veículo não existir.
+
+## Exemplos
+
+```c
+public OnPlayerEnterVehicle(playerid, vehicleid, ispassenger)
+{
+    if (GetVehicleModel(vehicleid) == 411) // 411 é o modelo do Infernus
+    {
+        SendClientMessage(playerid, 0xFFFFFFFF, "Nice Infernus!");
+    }
+    return 1;
+}
+```
+
+## Funções Relacionadas
+
+- [GetPlayerVehicleID](GetPlayerVehicleID): Obtém o ID do veículo em que o jogador está.
+- [GetVehiclePos](GetVehiclePos): Obtém a posição de um veículo.
+- [GetVehicleZAngle](GetVehicleZAngle): Verifica o ângulo atual de um veículo.
+- [GetPlayerVehicleSeat](GetPlayerVehicleSeat): Verifica em qual assento o jogador está.
+
+## Recursos Relacionados
+
+- [IDs de Veículos](../resources/vehicleid)
diff --git a/docs/translations/pt-BR/scripting/functions/GetVehiclePos.md b/docs/translations/pt-BR/scripting/functions/GetVehiclePos.md
@@ -0,0 +1,58 @@
+---
+title: GetVehiclePos
+description: Obtém a posição de um veículo.
+tags: ["vehicle"]
+---
+
+## Descrição
+
+Obtém a posição de um veículo.
+
+| Nome       | Descrição                                                               |
+| ---------- | ----------------------------------------------------------------------- |
+| vehicleid  | O ID do veículo para obter a posição.                                   |
+| &Float:x   | Uma variável float para armazenar a coordenada X, passada por referência. |
+| &Float:y   | Uma variável float para armazenar a coordenada Y, passada por referência. |
+| &Float:z   | Uma variável float para armazenar a coordenada Z, passada por referência. |
+
+## Retornos
+
+**true** - A função foi executada com sucesso.
+
+**false** - A função falhou ao ser executada. O veículo especificado não existe.
+
+## Exemplos
+
+```c
+public OnPlayerCommandText(playerid, cmdtext[])
+{
+     if (strcmp(cmdtext, "/vehpos", true) == 0)
+     {
+          new vehicleid = GetPlayerVehicleID(playerid);
+
+          // se vehicleid for igual a 0
+          if (vehicleid == 0)
+          {
+               return SendClientMessage(playerid, -1, "Você não está em nenhum veículo!");
+          }
+
+          new
+               Float:vehX, Float:vehY, Float:vehZ,
+               string[128];
+
+          GetVehiclePos(vehicleid, vehX, vehY, vehZ);
+          format(string, sizeof(string), "As posições atuais do veículo são: %f, %f, %f", vehX, vehY, vehZ);
+          SendClientMessage(playerid, 0xFFFFFFFF, string);
+          return 1;
+     }
+
+     return 0;
+}
+```
+
+## Funções Relacionadas
+
+- [GetVehicleDistanceFromPoint](GetVehicleDistanceFromPoint): Obtém a distância entre um veículo e um ponto.
+- [SetVehiclePos](SetVehiclePos): Define a posição de um veículo.
+- [GetVehicleZAngle](GetVehicleZAngle): Verifica o ângulo atual de um veículo.
+- [GetVehicleRotationQuat](GetVehicleRotationQuat): Obtém o quaternário de rotação de um veículo.
diff --git a/docs/translations/pt-BR/scripting/functions/GetVehicleSeats.md b/docs/translations/pt-BR/scripting/functions/GetVehicleSeats.md
@@ -0,0 +1,37 @@
+---
+title: GetVehicleSeats
+description: Gets the number of seats in the vehicle.
+tags: ["vehicle"]
+---
+
+<VersionWarn version='omp v1.1.0.2612' />
+
+## Description
+
+Gets the number of seats in the vehicle.
+
+| Name      | Description        |
+| --------- | ------------------ |
+| modelid | ID of the vehicle model. |
+
+## Return Values
+
+Returns the number of seats.
+
+**255** if the model is invalid.
+
+## Examples
+
+```c
+new vehicleid = GetPlayerVehicleID(playerid);
+new modelid = GetVehicleModel(vehicleid);
+new seats = GetVehicleSeats(modelid);
+
+new string[64];
+format(string, sizeof(string), "Number of seats in this vehicle: %d", seats);
+SendClientMessage(playerid, -1, string);
+```
+
+## Related Functions
+
+- [PutPlayerInVehicle](PutPlayerInVehicle): Puts a player in a vehicle.
diff --git a/docs/translations/pt-BR/scripting/functions/IsPlayerInAnyVehicle.md b/docs/translations/pt-BR/scripting/functions/IsPlayerInAnyVehicle.md
@@ -0,0 +1,46 @@
+---
+title: IsPlayerInAnyVehicle
+description: Verifica se um jogador está dentro de qualquer veículo (como motorista ou passageiro).
+tags: ["player", "vehicle"]
+---
+
+## Descrição
+
+Verifica se um jogador está dentro de qualquer veículo (como motorista ou passageiro).
+
+| Nome      | Descrição                     |
+| --------- | ----------------------------- |
+| playerid  | O ID do jogador a ser verificado. |
+
+## Retornos
+
+**true** - O jogador está em um veículo.
+
+**false** - O jogador não está em um veículo.
+
+## Exemplos
+
+```c
+public OnPlayerCommandText(playerid, cmdtext[])
+{
+    if (strcmp(cmdtext, "/invehicle", true) == 0)
+    {
+        if (IsPlayerInAnyVehicle(playerid))
+        {
+            SendClientMessage(playerid, 0x00FF00FF, "Você está em um veículo.");
+        }
+        else
+        {
+            SendClientMessage(playerid, 0xFF0000FF, "Você não está em nenhum veículo.");
+        }
+        return 1;
+    }
+    return 0;
+}
+```
+
+## Funções Relacionadas
+
+- [IsPlayerInVehicle](IsPlayerInVehicle): Verifica se um jogador está em um determinado veículo.
+- [GetPlayerVehicleSeat](GetPlayerVehicleSeat): Verifica em qual assento o jogador está.
+