Texturas, shaders e render targets

Tudo o que estas funções desenham vale por um quadro. Não existe “criar um retângulo e deixá-lo lá”: a tela é redesenhada a cada quadro, então o seu desenho precisa ser refeito toda vez — de dentro de um handler do evento onClientRender.

local telaW, telaH = getScreenSize()

addEventHandler("onClientRender", root, function()
    -- fundo da barra
    dxDrawRectangle(20, telaH - 70, 240, 26, tocolor(0, 0, 0, 160))
    -- preenchimento
    dxDrawRectangle(20, telaH - 70, 240 * 0.65, 26, tocolor(80, 200, 120, 255))
    -- linha de base
    dxDrawLine(20, telaH - 44, 260, telaH - 44, tocolor(255, 255, 255, 90), 1)
end)

A ordem importa: o que é desenhado depois fica por cima.

As cores são inteiros empacotados, e não três números soltos. Monte-as com tocolor(r, g, b, a), onde os quatro canais vão de 0 a 255. Quando o argumento de cor é omitido, o padrão é branco opaco — tocolor(255, 255, 255, 255).

Quando um argumento tem o tipo errado, ou um valor fora do intervalo aceito, a maioria destas funções devolve false e escreve o motivo no console de debug. As exceções são dxDrawPrimitive, dxDrawMaterialPrimitive, dxDrawPrimitive3D, dxDrawMaterialPrimitive3D, dxDrawWiredSphere e dxDrawModel3D: um argumento inválido em qualquer uma delas gera um erro de Lua, que interrompe o código que a chamou.

Estas 36 funções existem somente no cliente. Chamá-las de um script de servidor resulta em erro de valor nulo.

O desenho de texto, retângulos e imagens fica na página de Desenho na tela.

Primitivas 2D

As coordenadas são em pixels, contadas a partir do canto superior esquerdo da tela.

Sobre o argumento postGUI

Por padrão o desenho acontece na hora, na ordem em que você chama as funções. Com postGUI igual a true ele é adiado e feito depois da GUI (chat, janelas), então fica por cima dela. Com o menu principal aberto, o desenho postGUI também acontece na hora.

dxDrawLine Desenha uma linha reta entre dois pontos.

dxDrawCircle Desenha um disco (ou uma fatia dele) usando um leque de triângulos.

dxDrawPrimitive Desenha uma figura livre a partir de uma lista de vértices.

dxDrawMaterialPrimitive O mesmo que dxDrawPrimitive, mas preenchendo a figura com uma imagem.

Tipos de primitiva

Os mesmos nomes valem para as versões 2D e 3D.

Valor	Como os vértices são ligados	Quantidade exigida
"pointlist"	Cada vértice vira um ponto solto.	1 ou mais
"linelist"	Cada par de vértices vira uma linha independente.	múltiplo de 2
"linestrip"	Uma linha contínua passando por todos os vértices.	2 ou mais
"trianglelist"	Cada trio de vértices vira um triângulo independente.	múltiplo de 3
"trianglestrip"	Faixa de triângulos: cada novo vértice fecha um triângulo com os dois anteriores.	3 ou mais
"trianglefan"	Leque: todos os triângulos partem do primeiro vértice.	3 ou mais

Radar

A área de radar é desenhada no minimapa, uma vez por quadro, a partir de coordenadas do mundo.

dxDrawRadarArea Desenha um retângulo preenchido no radar durante este quadro.

Desenho 3D

Aqui as coordenadas são as do mundo, não as da tela. O desenho continua sendo por quadro.

dxDrawLine3D Desenha uma linha entre dois pontos do mundo.

dxDrawMaterialLine3D Desenha uma linha 3D com espessura preenchida por uma imagem — útil para rastros, feixes e placas flutuantes.

dxDrawMaterialSectionLine3D Igual à anterior, mas usando apenas um recorte da imagem.

dxDrawPrimitive3D Desenha uma figura livre no mundo.

dxDrawMaterialPrimitive3D O mesmo, preenchendo a figura com uma imagem.

dxDrawWiredSphere Desenha uma esfera de arame — prática para marcar um raio de ação enquanto você depura algo.

dxDrawModel3D Desenha um modelo do jogo em uma posição, sem criar objeto nenhum.

Profundidade

As funções de linha e primitiva 3D aceitam um argumento de estágio, que é um booleano ou o nome de um estágio de renderização (maiúsculas ou minúsculas):

Valor	Efeito
false ou "postfx" (padrão)	Desenhado depois do filtro de cor do jogo. O desenho respeita o mundo — o que estiver na frente esconde o traço.
"prefx"	Desenhado antes do filtro de cor do jogo, então o filtro também se aplica a ele. Também respeita o mundo.
true ou "postgui"	Desenhado depois da GUI, por cima de tudo. Com o menu principal aberto, cai para "postfx".

Materiais

Materiais são os elementos que guardam imagem: texturas, render targets, screen sources e shaders. Todos podem ser usados onde uma imagem é pedida.

Materiais criados por um resource são liberados quando ele para, mas você também pode soltá-los na hora com destroyElement.

dxCreateTexture Cria uma textura, a partir de um arquivo do resource, de dados de imagem já em memória, ou em branco.

dxCreateRenderTarget Cria uma textura na qual você mesmo desenha.

dxCreateScreenSource Cria uma textura que recebe uma cópia do que está na tela.

dxUpdateScreenSource Copia o conteúdo atual da tela para dentro de um screen source.

dxSetRenderTarget Escolhe para onde o desenho vai: para um render target ou de volta para a tela.

dxGetMaterialSize Devolve o tamanho de um material em pixels.

dxSetTextureEdge Muda o que acontece quando a imagem é amostrada fora dos seus limites.

Modos de borda

Valor	O que acontece fora da imagem
"wrap"	A imagem se repete.
"mirror"	A imagem se repete espelhada a cada repetição.
"clamp"	Os pixels da borda são esticados.
"border"	Tudo fora vira a cor de borda escolhida.
"mirror-once"	Espelha uma vez e depois estica a borda.

dxCreateShader Compila um shader a partir de um arquivo do resource ou de um texto com o código.

dxSetShaderValue Define um valor de entrada do shader.

dxSetShaderTessellation Divide o quadrado do shader em uma grade, dando mais vértices para o shader trabalhar.

dxSetShaderTransform Aplica rotação e perspectiva ao desenho do shader.

Pixels

Uma string de pixels é a imagem crua, que você pode ler e alterar em Lua. Existem quatro formatos:

Formato	Descrição
"plain"	Pixels sem compressão. É o único formato que pode ser lido e alterado pixel a pixel.
"png"	Imagem PNG comprimida.
"jpeg"	Imagem JPEG comprimida.
"dds"	Imagem DDS.

dxGetTexturePixels Lê os pixels de uma textura.

dxSetTexturePixels Escreve pixels dentro de uma textura.

dxGetPixelsSize Devolve o tamanho de uma string de pixels.

dxGetPixelsFormat Descobre em que formato está uma string de pixels.

dxConvertPixels Converte uma string de pixels de um formato para outro.

dxGetPixelColor Lê a cor de um pixel.

dxSetPixelColor Altera a cor de um pixel.

Estado do desenho

dxSetBlendMode Escolhe como as cores desenhadas se misturam com o que já está na tela.

dxGetBlendMode Devolve o modo de mistura em uso.

dxSetTestMode Simula pouca memória de vídeo ou uma placa sem suporte a shaders, para testar como o seu resource reage.

dxSetAspectRatioAdjustmentEnabled Ajusta a posição vertical do desenho 2D feito para outra proporção de tela.

dxIsAspectRatioAdjustmentEnabled Diz se o ajuste de proporção de tela está ligado e qual proporção de origem ele usa.

dxGetStatus Devolve uma tabela com informações da placa de vídeo e do estado do desenho.