Pacote | flash.display3D.textures |
Classe | public final class Texture |
Herança | Texture TextureBase EventDispatcher Object |
Define uma textura 2D para utilizar durante a renderização.
A instância Texture não pode ser criada diretamente. Cria ocorrências usando o método Context3D::CreateTexture()
.
Elementos da API relacionados
Método | Definido por | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Liberta todos os recursos de GPU associados a essa textura. | TextureBase | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Carrega uma textura compactada no Adobe Texture Format (ATF) de um objeto ByteArray. | Texture | ||
Carrega uma textura de um objeto BitmapData. | Texture | ||
Carrega o miplevel 0 de uma textura para um objeto BitmapData de maneira assíncrona. | Texture | ||
Carrega uma textura de ByteArray. | Texture | ||
Carrega o miplevel 0 de uma textura para um objeto ByteArray de maneira assíncrona. | Texture | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher |
uploadCompressedTextureFromByteArray | () | método |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 11, AIR 3 |
Carrega uma textura compactada no Adobe Texture Format (ATF) de um objeto ByteArray. A versão 2 do arquivo ATF requer a versão 21 do SWF ou outra mais recente, e a versão 3 do arquivo ATF requer a versão 29 do SWF ou outra mais recente. Para arquivos ATF criados com imagem png sem alfa, a string de formato
fornecida durante Context3DObject::createTexture
deve ser "COMPRESSED" e, para arquivos ATF criados com imagem png com alfa, a string de formato
fornecida durante Context3DObject::createTexture
deve ser "COMPRESSED_ALPHA".
Parâmetros
data:ByteArray — Uma matriz de bytes que contém uma textura compactada que inclui mipmaps. O objeto ByteArray deverá utilizar o pequeno formato endiano.
| |
byteArrayOffset:uint — A posição na matriz de bytes na qual iniciar a leitura dos dados de textura.
| |
async:Boolean (default = false ) — Se true, a função retorna imediatamente. Qualquer método de desenho que tenta usar a textura, falhará até que o upload seja concluído com êxito. Após o upload com êxito, esse objeto Texture despacha Event.TEXTURE_READY . Valor padrão: false.
|
Lança
TypeError — Erro de Ponteiro Nulo: quando data é null.
| |
ArgumentError — Falha na decodificação da textura: quando o formato de compactação desse objeto não pode ser derivado do formato dos dados compactados nosdados , ou quando a versão do SWF é incompatível com a versão do arquivo ATF.
| |
ArgumentError — Tamanho da textura não corresponde: quando a largura e a altura da textura descompactada não igualam às dimensões deste objeto de Textura.
| |
ArgumentError — Nível mip grande demais: se o nível mip da textura descompactada for maior do que indicado pelo tamanho da textura.
| |
ArgumentError — Incompatibilidade no formato de textura: se os bytes decodificados de ATF não contêm uma textura compatível com o formato da textura.
| |
Error — 3768: a API do Stage3D não pode ser usada durante a execução de fundo.
| |
RangeError — Tamanho de entrada incorreto: quando há excesso de números inteiros do byteArrayOffset , quando o byteArrayOffset + 6 for maior do que o comprimento dos dados ou quando o número de bytes disponíveis nobyteArrayOffset até o fim da matriz de bytes dos dados for menor que a quantidade de dados necessários para a textura do ATF.
|
Elementos da API relacionados
uploadFromBitmapData | () | método |
public function uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 11, AIR 3 |
Carrega uma textura de um objeto BitmapData.
Parâmetros
source:BitmapData — um bitmap.
| |
miplevel:uint (default = 0 ) — nível mip a ser carregado, sendo que o nível zero é a imagem de resolução completa.
|
Lança
TypeError — Erro de ponteiro nulo: quando source é nulo.
| |
ArgumentError — Nível mip grande demais: se o nível mip especificado for maior do que indicado pela maior das dimensões de Textura.
| |
ArgumentError — Erro de BitmapData inválido: se o objeto BitmapData source não contém um rosto de textura de cubo válido. A imagem deve ter lados iguais com uma potência de dois, e o tamanho correto de nível mip especificado.
| |
ArgumentError — Incompatibilidade no formato de textura: se o formato da textura é Context3DTextureFormat.COMPRESSED ou Context3DTextureFormat.COMPRESSED_ALPHA e o código está sendo executado em uma plataforma móvel em que a compactação de textura de tempo de execução não é suportada.
| |
Error — 3768: a API do Stage3D não pode ser usada durante a execução de fundo.
|
uploadFromBitmapDataAsync | () | método |
public function uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 24 |
Carrega o miplevel 0 de uma textura para um objeto BitmapData de maneira assíncrona. Qualquer método de desenho que tente usar a textura, retornará um erro até que o upload seja concluído com êxito. Após o upload com êxito, esse objeto Texture
despacha Event.TEXTURE_READY
. Event.TEXTURE_READY é um retorno para indicar que as chamadas assíncronas recebidas para o objeto de textura foram executadas com êxito. Na ocorrência de qualquer erro durante o carregamento em segundo plano, esse objeto Texture
despacha Event.ERROREVENT.
Parâmetros
source:BitmapData — um bitmap
| |
miplevel:uint (default = 0 )
|
Lança
TypeError — Erro de ponteiro nulo: quando source é nulo.
| |
ArgumentError — Erro de BitmapData inválido: se o objeto BitmapData source não contém uma de textura de válida. A imagem deve ser igual a uma potência de dois, e o tamanho correto de nível mip especificado.
| |
ArgumentError — Incompatibilidade no formato de textura: se o formato da textura é Context3DTextureFormat.COMPRESSED ou Context3DTextureFormat.COMPRESSED_ALPHA e o código está sendo executado em uma plataforma móvel em que a compactação de textura de tempo de execução não é suportada.
| |
ArgumentError — Upload assíncrono compatível apenas com o miplevel 0.
| |
Error — 3768: a API do Stage3D não pode ser usada durante a execução de fundo.
|
Elementos da API relacionados
uploadFromByteArray | () | método |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | Flash Player 11, AIR 3 |
Carrega uma textura de um ByteArray.
Parâmetros
data:ByteArray — uma matriz de bytes que contém bytes suficientes no formato interno das texturas para preencher a textura. texturas rgba são lidas como bytes por componentes texel (1 ou 4). texturas float são lidas como bytes por componentes texel (1 ou 4). O objeto ByteArray deverá utilizar o pequeno formato endiano.
| |
byteArrayOffset:uint — a posição no objeto da matriz de bytes em que iniciar a leitura dos dados de textura.
| |
miplevel:uint (default = 0 ) — o nível mip a ser carregado, sendo que o nível zero é a imagem de resolução completa.
|
Lança
TypeError — Erro de ponteiro nulo: quando data é nulo.
| |
ArgumentError — Nível mip grande demais: se o nível mip especificado for maior do que indicado pela maior das dimensões de Textur.
| |
RangeError — Tamanho de entrada incorreto: quando o número de bytes disponíveis no byteArrayOffset até o fim da matriz de bytes de dadosdados for menor que a quantidade de dados necessários para a textura deste nível mip, ou quandobyteArrayOffset for maior do que ou igual ao comprimento dos dados .
| |
ArgumentError — Incompatibilidade no formato de textura: se o formato da textura é Context3DTextureFormat.COMPRESSED ou Context3DTextureFormat.COMPRESSED_ALPHA e o código está sendo executado em uma plataforma móvel em que a compactação de textura de tempo de execução não é suportada.
| |
Error — 3768: a API do Stage3D não pode ser usada durante a execução de fundo.
|
uploadFromByteArrayAsync | () | método |
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 24 |
Carrega o miplevel 0 de uma textura para um objeto ByteArray de maneira assíncrona. Qualquer método de desenho que tente usar a textura, retornará um erro até que o upload seja concluído com êxito. Após o upload com êxito, esse objeto Texture
despacha Event.TEXTURE_READY
. Event.TEXTURE_READY é um retorno para indicar que as chamadas assíncronas recebidas para o objeto de textura foram executadas com êxito. Na ocorrência de qualquer erro durante o carregamento em segundo plano, esse objeto Texture
despacha Event.ERROREVENT.
Parâmetros
data:ByteArray — uma matriz de bytes que contém bytes suficientes no formato interno das texturas para preencher a textura. texturas rgba são lidas como bytes por componentes texel (1 ou 4). texturas float são lidas como bytes por componentes texel (1 ou 4). O objeto ByteArray deverá utilizar o pequeno formato endiano.
| |
byteArrayOffset:uint — a posição no objeto da matriz de bytes em que iniciar a leitura dos dados de textura.
| |
miplevel:uint (default = 0 )
|
Lança
TypeError — Erro de Ponteiro Nulo: quando data é null.
| |
RangeError — Tamanho de entrada incorreto: quando o número de bytes disponíveis no byteArrayOffset até o fim da matriz de bytes de dados for menor que a quantidade de dados necessários para a textura deste nível mip, ou quando byteArrayOffset for maior do que ou igual ao comprimento dos dados .
| |
ArgumentError — Incompatibilidade no formato de textura: se o formato da textura é Context3DTextureFormat.COMPRESSED ou Context3DTextureFormat.COMPRESSED_ALPHA e o código está sendo executado em uma plataforma móvel em que a compactação de textura de tempo de execução não é suportada.
| |
ArgumentError — Upload assíncrono compatível apenas com o miplevel 0.
| |
Error — 3768: a API do Stage3D não pode ser usada durante a execução de fundo.
| |
Error — se um upload assíncrono foi iniciado em um objeto texture e existe outro upload assíncrono para chamar o mesmo objeto de textura.
|
Elementos da API relacionados
Wed Jun 13 2018, 11:10 AM Z