Design

Elementos

Todos os tipos de elemento que você pode colocar na tela, para que servem e como se comportam.

Tudo o que você coloca na tela no Easelt Builder é um *elemento*. Esta página é o catálogo completo de todos os tipos de elemento que você pode adicionar — formas decorativas, texto, imagens, widgets interativos e contêineres — além das regras que todos compartilham. Todo elemento é desenhado com as funções dx do MTA:SA, portanto o que você vê no builder é exatamente o que seus jogadores veem no jogo (WYSIWYG honesto).

Como cada elemento se comporta

Antes do catálogo, aqui estão as regras que se aplicam a *todo* elemento, não importa o tipo. Elas valem quer você tenha soltado um rectangle, um button ou um group na tela.

Posição e tamanho são armazenados como frações da tela — nunca pixels fixos. É isso que mantém sua GUI responsiva, para que um layout desenhado em uma resolução caia corretamente em outra.
Selecione para estilizar, arraste para mover, alças para redimensionar. Clique em um elemento para selecioná-lo e abrir suas propriedades no inspetor, arraste seu corpo para reposicionar e puxe suas alças de canto/borda para redimensionar.
Alça de rotação onde disponível. Elementos que suportam rotação expõem uma alça de rotação dedicada para que você possa girar a caixa do elemento.
A opacidade é por elemento. Cada elemento carrega sua própria opacidade, então você pode esmaecer qualquer item individualmente, independentemente dos demais.
Qualquer elemento pode se tornar uma janela/painel Blueprint. Ative a opção Blueprint no inspetor para promover qualquer elemento a uma janela ou painel que emoldura seu layout.

ℹ️

O texto é sempre desenhado na horizontal. O dxDrawText do MTA não tem rotação, então girar um text ou button gira a *caixa* — as letras permanecem horizontais. O Easelt Builder mostra isso honestamente, em vez de fingir uma inclinação que o jogo não consegue renderizar.

Formas

Formas são decoração não interativa — os painéis, divisórias, distintivos e detalhes que dão estrutura a uma GUI. Elas não respondem a cliques no jogo; estão ali para serem vistas. Cada linha abaixo é um tipo de forma que você pode adicionar.

Forma	O que desenha	Opções notáveis
`rectangle`	Um retângulo simples e plano.	Cor de preenchimento, opacidade.
`roundedrect`	Um retângulo com cantos arredondados.	Arredondamento dos cantos, cor de preenchimento.
`circle`	Um círculo preenchido.	Cor de preenchimento, raio via tamanho.
`ellipse`	Uma elipse preenchida (um círculo esticado).	Cor de preenchimento, largura/altura.
`ring`	Um círculo vazado — um anel (rosca).	Espessura do anel, cor de preenchimento.
`pie`	Uma fatia de pizza / cunha de um círculo.	Ângulo inicial e ângulo final.
`polygon`	Um polígono regular de N lados.	Número de lados ajustável.
`star`	Uma forma de estrela.	Quantidade de pontas e proporção interna ajustáveis.
`triangle`	Um triângulo de três lados.	Cor de preenchimento, tamanho.
`gradientrect`	Um retângulo preenchido com um gradiente de cores.	Cores do gradiente.
`line`	Um único segmento reto.	Rotacionável; estilize sólido/tracejado/pontilhado com espaçamento de traço/ponto ajustável.

💡

Use line para divisórias e detalhes — é a única forma feita para ser girada livremente, e seus estilos tracejado/pontilhado com espaçamento ajustável a tornam flexível para separadores e molduras.

Texto

Há um único elemento de texto, e ele é o cavalo de batalha de todo rótulo, título e legenda da sua GUI.

text

Um rótulo. Digite qualquer string que quiser, incluindo árabe. Lembre-se de que ele sempre renderiza na horizontal — girá-lo vira a caixa delimitadora, não as letras.

Imagens

Dois tipos de elemento trazem arte para sua GUI — um para suas próprias imagens, outro para glifos vetoriais nítidos.

image

Mostra uma imagem importada. Solte sua própria arte e posicione-a em qualquer lugar da tela.

icon

Um glifo vetorial extraído de um conjunto de ícones estilo Feather integrado — nítido em qualquer tamanho, perfeito para botões e rótulos.

Widgets interativos

Widgets são os elementos que *respondem a cliques no jogo*. Estes são seus botões, campos, alternadores e medidores — as partes da GUI que os jogadores realmente operam. Cada linha abaixo é um tipo de widget.

Widget	O que é	Opções notáveis
`button`	Um botão clicável.	Texto do rótulo, estilização, opacidade.
`editbox`	Uma aparência de campo de texto para entrada.	Estilização do campo e aparência do texto de espaço reservado.
`checkbox`	Uma caixa liga/desliga com um rótulo.	A caixa pode ficar à esquerda ou à direita do rótulo.
`switch`	Um alternador liga/desliga.	Estado de alternância e estilização.
`dropdown`	Uma lista de seleção.	A lista de opções para escolher.
`progressbar`	Uma barra de preenchimento mostrando o progresso.	Posição do rótulo: dentro, esquerda, direita, topo, base ou nenhuma.
`volume`	Um controle deslizante / medidor.	Modo de preenchimento ou modo central; rótulos à esquerda e à direita.

ℹ️

Como um button contém texto, aplica-se a mesma regra de texto na horizontal: gire-o e a caixa vira enquanto a legenda permanece horizontal — exatamente como será no MTA:SA.

Contêiner

Um único tipo de elemento contém outros, permitindo que você construa painéis estruturados e móveis.

group

Um contêiner que contém outros elementos. Promova-o a uma janela ou painel Blueprint para emoldurar uma seção inteira da sua GUI e, em seguida, mova o grupo para reposicionar tudo que está dentro de uma vez só.

Janelas e painéis Blueprint

"Blueprint" não é um elemento separado — é um modo que você pode ativar para *qualquer* elemento no inspetor. Ativá-lo faz esse elemento agir como uma janela ou painel que emoldura seu layout. Um group é a escolha natural para isso, já que ele também carrega seus elementos filhos, mas a opção está disponível em todo lugar.

Esse é o catálogo completo de elementos. Adicione qualquer um deles a partir da tela e então selecione para estilizar, arraste para mover e puxe as alças para redimensionar — usando a alça de rotação onde ela é oferecida — e ajuste a opacidade e a configuração Blueprint de cada elemento no inspetor.