dxGetTexturePixels

Lê os pixels de uma textura.

Sintaxe

string dxGetTexturePixels ( [ number superficie = 0, ] texture textura [, string formatoPixels = "plain" [, string formatoTextura, bool mipmaps = true ] ] [, number x = 0, number y = 0, number largura = 0, number altura = 0 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
superficie	number	0	Primeiro argumento opcional. Numa textura cube, a face a ler (0 a 5); numa textura de volume, a camada. Ignorado nas texturas comuns.
textura	texture	—	A textura (ou render target, screen source ou SVG) a ler.
formatoPixels	string	"plain"	Formato da string devolvida: "plain", "png", "jpeg" (qualidade 90) ou "dds".
formatoTextura	string	o da própria textura	Só com "dds": o formato gravado no DDS, com os mesmos nomes de dxCreateTexture.
mipmaps	bool	true	Só com "dds": se o DDS inclui mipmaps.
x, y	number	0	Canto superior esquerdo do recorte.
largura, altura	number	0	Tamanho do recorte. Com altura em 0, o recorte é ignorado e a textura inteira é lida.

Retorno

Uma string de pixels no formato pedido. Devolve false se os pixels não puderem ser lidos ou codificados, e false com um aviso no console de debug se algum argumento estiver errado.

Exemplo

local pixels = dxGetTexturePixels(logo)
local r, g, b, a = dxGetPixelColor(pixels, 0, 0)
outputDebugString("primeiro pixel: " .. r .. " " .. g .. " " .. b)

Veja também

• 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.