dxSetTexturePixels

Escreve pixels dentro de uma textura.

Sintaxe

bool dxSetTexturePixels ( [ number superficie = 0, ] texture textura, string pixels [, 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 escrever (0 a 5); numa textura de volume, a camada. Ignorado nas texturas comuns.
textura	texture	—	A textura, render target ou screen source onde escrever.
pixels	string	—	Pixels no formato plain.
x, y	number	0	Onde colar o recorte.
largura, altura	number	0	Tamanho do recorte. Com altura em 0, o recorte é a textura inteira, a partir do canto superior esquerdo.

Os pixels são colados a partir do canto superior esquerdo deles, e o que ficar fora do recorte ou da textura é cortado — os tamanhos não precisam bater.

Retorno

true se a escrita foi feita. Devolve false se a string não estiver no formato plain, se não sobrar nada para copiar depois do corte ou se a escrita falhar, e false com um aviso no console de debug se algum argumento estiver errado.

Veja também

• dxGetTexturePixels — Lê os pixels 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.