---
title: "TextDrawCreate | open.mp"
description: "Cria um desenho de texto."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawCreate
language: pt-BR
---

# TextDrawCreate

## Descrição

Cria um desenho de texto. Textdraws são, como o nome indica, texto (principalmente - pode haver caixas, sprites e visualizações de modelos (skins/veículos/armas/objetos também) que é desenhado nas telas de um jogador. Consulte [esta página](https://omp.itsneufox.com/pt-BR/docs/scripting/resources/textdraws) para obter informações abrangentes sobre textdraws.

| Nome | Descrição |
| --- | --- |
| Float:x | A coordenada X (esquerda/direita) na qual criar o textdraw. |
| Float:y | A coordenada Y (para cima/para baixo) na qual criar o textdraw. |
| const format\[\] | O texto que aparecerá no textdraw. |
| OPEN\_MP\_TAGS:... | Número indefinido de argumentos de qualquer tag. |

## Retornos

O ID do textdraw criado.

Textdraw IDs começa em **0**.

## Exemplos

```c
// Esta variável é usada para armazenar o id do textdraw
// para que possamos usá-lo em todo o script
new Text:gMyTextdraw;

public OnGameModeInit()
{
    // Esta linha é usada para criar o textdraw.
    // Nota: Isso cria um textdraw sem qualquer formatação.
    gMyTextdraw = TextDrawCreate(240.0, 580.0, "Welcome to my OPEN.MP server");
    return 1;
}

public OnPlayerConnect(playerid)
{
    //Isso é usado para mostrar ao jogador o textdraw quando ele se conecta.
    TextDrawShowForPlayer(playerid, gMyTextdraw);
    return 1;
}
```

## Notas

nota

-   A coordenada `x, y` é a coordenada superior esquerda para a área de desenho de texto com base em uma "tela" de 640x480 (independentemente da resolução da tela). Se você planeja usar [TextDrawAlignment](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawAlignment) com alinhamento 3 (`TEXT_DRAW_ALIGN_RIGHT`), a coordenada `x, y` é a coordenada superior direita para o desenho do texto.
-   Esta função apenas CREATES o textdraw, você deve usar [TextDrawShowForPlayer](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawShowForPlayer) ou [TextDrawShowForAll](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawShowForAll) para mostrá-lo.

dica

Recomenda-se usar números WHOLE em vez de posições decimais ao criar desenhos de texto para garantir um design de resolução amigável.

aviso

Os códigos de mapeamento de teclas do teclado (como `~k~~VEHICLE_ENTER_EXIT~`) não funcionam além do 255º caractere.

## Funções Relacionadas

-   [TextDrawDestroy](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawDestroy): Destrua um textdraw.
-   [TextDrawColor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawColor): Defina a cor do texto em um textdraw.
-   [TextDrawBoxColor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawBoxColor): Defina a cor da caixa em um textdraw.
-   [TextDrawBackgroundColor](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawBackgroundColor): Defina a cor de fundo de um textdraw.
-   [TextDrawAlignment](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawAlignment): Define o alinhamento de um textdraw.
-   [TextDrawFont](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawFont): Define a fonte de um textdraw.
-   [TextDrawLetterSize](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawLetterSize): Defina o tamanho da letra do texto em um textdraw.
-   [TextDrawTextSize](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawTextSize): Defina o tamanho de uma caixa de desenho de texto.
-   [TextDrawSetOutline](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawSetOutline): Escolha se o texto possui contorno.
-   [TextDrawSetShadow](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawSetShadow): Alterna sombras em um textdraw.
-   [TextDrawSetProportional](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawSetProportional): Dimensione o espaçamento do texto em um textdraw para uma proporção proporcional.
-   [TextDrawUseBox](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawUseBox): Alterna se o textdraw possui caixa ou não.
-   [TextDrawSetString](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawSetString): Defina o texto em um textdraw existente.
-   [TextDrawShowForPlayer](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawShowForPlayer): Mostra um desenho de texto para um determinado jogador.
-   [TextDrawHideForPlayer](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawHideForPlayer): Oculta um textdraw para um determinado jogador.
-   [TextDrawShowForAll](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawShowForAll): Mostra um textdraw para todos os jogadores.
-   [TextDrawHideForAll](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawHideForAll): Oculta um textdraw para todos os jogadores.
-   [IsTextDrawVisibleForPlayer](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsTextDrawVisibleForPlayer): Verifica se é mostrado um textdraw para o jogador.
-   [IsValidTextDraw](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/IsValidTextDraw): Verifica se um textdraw é válido.
-   [TextDrawGetAlignment](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetAlignment): Obtém o alinhamento do texto de um textdraw.
-   [TextDrawGetBackgroundColour](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetBackgroundColour): Obtém a cor de fundo de um textdraw.
-   [TextDrawGetBoxColour](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetBoxColour): Obtém a cor da caixa de um textdraw.
-   [TextDrawGetColour](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetColour): Obtém a cor do texto de um textdraw.
-   [TextDrawGetFont](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetFont): Obtém a fonte do texto de um textdraw.
-   [TextDrawGetLetterSize](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetLetterSize): Obtém a largura e a altura das letras.
-   [TextDrawGetOutline](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetOutline): Obtém a espessura do contorno do texto de um textdraw.
-   [TextDrawGetPos](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetPos): Obtém a posição de um textdraw.
-   [TextDrawGetPreviewModel](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetPreviewModel): Obtém o modelo de visualização de um textdraw de visualização 3D.
-   [TextDrawGetPreviewRot](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetPreviewRot): Obtém a rotação e o zoom de um desenho de texto de visualização de modelo 3D.
-   [TextDrawGetPreviewVehCol](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetPreviewVehCol): Obtém as cores do veículo de visualização de um textdraw de visualização 3D.
-   [TextDrawGetPreviewVehicleColours](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetPreviewVehicleColours): Obtém as cores do veículo de visualização de um textdraw de visualização 3D.
-   [TextDrawGetShadow](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetShadow): Obtém o tamanho da sombra do texto de um textdraw.
-   [TextDrawGetString](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetString): Obtém o texto de um textdraw.
-   [TextDrawGetTextSize](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawGetTextSize): Obtém o eixo X e o eixo Y do textdraw.
-   [TextDrawIsBox](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawIsBox): Verifica se um textdraw é caixa.
-   [TextDrawIsProportional](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawIsProportional): Verifica se um textdraw é proporcional.
-   [TextDrawIsSelectable](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawIsSelectable): Verifica se um textdraw é selecionável.
-   [TextDrawSetPos](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawSetPos): Define a posição de um textdraw.
-   [TextDrawSetStringForPlayer](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/TextDrawSetStringForPlayer): Altera o texto em um textdraw para um jogador específico.

## Recursos relacionados

-   [Sprites TextDraw](https://omp.itsneufox.com/pt-BR/docs/scripting/resources/textdrawsprites)
