| Pakket | flash.display3D.textures |
| Klasse | public final class Texture |
| Overerving | Texture  TextureBase EventDispatcher Object |
Definieert een 2D-structuur voor gebruik tijdens het renderen.
Structuur kan niet rechtstreeks worden geïnstantieerd. Maak instanties met gebruik van de Context3D-methode createTexture().
Verwante API-elementen
Openbare eigenschappen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergevenOpenbare methoden
| Methode | Gedefinieerd door | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | |
|
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | |
|
Maakt alle aan deze structuur gekoppelde GPU-bronnen vrij. | TextureBase | |
|
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Uploadt een gecomprimeerde structuur in de ATF-indeling (Adobe Texture Format) van een ByteArray-object. | Texture | ||
Uploadt een structuur van een BitmapData-object. | Texture | ||
Uploadt miplevel 0 voor een structuur van een BitmapData-object op asynchrone wijze. | Texture | ||
Uploadt een structuur van een ByteArray. | Texture | ||
Uploadt miplevel 0 voor een structuur van een ByteArray-object op asynchrone wijze. | Texture | ||
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
|
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | |
Gebeurtenissen
Methodedetails
uploadCompressedTextureFromByteArray | () | methode |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3 |
Uploadt een gecomprimeerde structuur in de ATF-indeling (Adobe Texture Format) van een ByteArray-object. ATF-bestandsversie 2 vereist SWF-versie 21 of hoger en ATF-bestandsversie 3 vereist SWF-versie 29 of hoger. Voor ATF-bestanden die zijn gemaakt met een PNG-afbeelding zonder alfa moet deformat-tekenreeks die wordt opgegeven tijdens Context3DObject::createTexture, gelijk zijn aan 'COMPRESSED'. Voor ATF-bestanden die zijn gemaakt met een PNG-afbeelding met alfa moet de format-tekenreeks die wordt opgegeven tijdens Context3DObject::createTexture, gelijk zijn aan 'COMPRESSED_ALPHA'.
Parameters
data:ByteArray — Een bytearray die een gecomprimeerde structuur bevat, inclusief mipmaps. Het ByteArray-object dient gebruik te maken van de little endian-indeling.
| |
byteArrayOffset:uint — De positie in de bytearray waarbij moet worden begonnen met het lezen van de structuurgegevens.
| |
async:Boolean (default = false)CubeTexture-object verzendt Event.TEXTURE_READY bij een correct voltooid uploadproces. Standaardwaarde: false.
|
Gegenereerde uitzondering
TypeError — Null-aanwijzerfout: wanneer data de waarde null heeft.
| |
ArgumentError — Decodering van structuur mislukt: wanneer de compressie-indeling van dit object niet kan worden afgeleid van de indeling voor gecomprimeerde gegevens in data, of wanneer de SWF-versie niet compatibel is met de ATF-bestandsversie.
| |
ArgumentError — Structuurformaat komt niet overeen: wanneer de breedte en hoogte van de gedecomprimeerde structuur niet overeenkomen met de afmetingen van dit Texture-object.
| |
ArgumentError — Mip-niveau te groot: als het mip-niveau van de gedecomprimeerde structuur groter is dan het niveau dat wordt geïmpliceerd door de grootte van de structuur.
| |
ArgumentError — Niet-overeenkomende structuurindeling: als de gedecodeerde ATF-bytes geen structuur bevatten die compatibel is met de indeling van deze structuur.
| |
Error — 3768: De Stage3D-API kan niet worden gebruikt tijdens uitvoering op de achtergrond.
| |
RangeError — Onjuiste invoergrootte: bij een integeroverloop van byteArrayOffset of als byteArrayOffset + 6 groter is dan de lengte van data, of als het aantal bytes dat beschikbaar is van byteArrayOffset tot aan het einde van de data-bytearray kleiner is dan de hoeveelheid gegevens die wordt vereist voor de ATF-structuur.
|
Verwante API-elementen
uploadFromBitmapData | () | methode |
public function uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3 |
Uploadt een structuur van een BitmapData-object.
Parameters
source:BitmapData — een bitmap.
| |
miplevel:uint (default = 0) |
Gegenereerde uitzondering
TypeError — Null-aanwijzerfout: wanneer source de waarde null heeft.
| |
ArgumentError — Mip-niveau te hoog: wanneer het opgegeven mip-niveau hoger is dan het niveau dat wordt geïmpliceerd door de grootste afmeting van de structuur.
| |
ArgumentError — Ongeldige BitmapData-fout: wanneer het BitmapData-object source geen geldige waarde voor het kubusstructuurvlak bevat. De zijden van de afbeelding moeten overeenkomen met een macht van twee en het juiste formaat moet zijn opgegeven voor het mip-niveau.
| |
ArgumentError — Niet-overeenkomende structuurindeling: in geval van de structuurindeling Context3DTextureFormat.COMPRESSED of Context3DTextureFormat.COMPRESSED_ALPHA en als de code wordt uitgevoerd op een mobiel platform waarop structuurcompressie tijdens de runtime niet wordt ondersteund.
| |
Error — 3768: De Stage3D-API kan niet worden gebruikt tijdens uitvoering op de achtergrond.
|
uploadFromBitmapDataAsync | () | methode |
public function uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 24 |
Uploadt miplevel 0 voor een structuur van een BitmapData-object op asynchrone wijze. Elke tekenmethode waarbij de structuur wordt gebruikt zal pas lukken nadat het uploadproces correct en volledig is uitgevoerd. Dit Texture-object verzendt Event.TEXTURE_READY bij een correct voltooid uploadproces. Event.TEXTURE_READY is een callback waarmee wordt aangegeven dat de asynchrone aanroepen die voor het structuurobject zijn ontvangen, zijn uitgevoerd. Als er een fout optreedt tijdens het uploaden van de achtergrond, verzendt dit Texture-object de gebeurtenis Event.ERROREVENT.
Parameters
source:BitmapData — een bitmap
| |
miplevel:uint (default = 0) |
Gegenereerde uitzondering
TypeError — Null-aanwijzerfout: wanneer source de waarde null heeft.
| |
ArgumentError — Ongeldige BitmapData-fout: wanneer het BitmapData-object source geen geldige structuur bevat. De afbeelding moet overeenkomen met een macht van twee en het juiste formaat moet zijn opgegeven voor het mip-niveau.
| |
ArgumentError — Niet-overeenkomende structuurindeling: in geval van de structuurindeling Context3DTextureFormat.COMPRESSED of Context3DTextureFormat.COMPRESSED_ALPHA en als de code wordt uitgevoerd op een mobiel platform waarop structuurcompressie tijdens de runtime niet wordt ondersteund.
| |
ArgumentError — Asynchroon uploadproces alleen ondersteund voor miplevel 0.
| |
Error — 3768: De Stage3D-API kan niet worden gebruikt tijdens uitvoering op de achtergrond.
|
Verwante API-elementen
uploadFromByteArray | () | methode |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3 |
Uploadt een structuur van een ByteArray.
Parameters
data:ByteArray — een bytearray die voldoende bytes bevat in de interne indeling van de structuur om de structuur te vullen. rgba-structuren worden gelezen als bytes per texel-component (1 of 4). float-structuren worden gelezen als floats per texel-component (1 of 4). Het ByteArray-object dient gebruik te maken van de little endian-indeling.
| |
byteArrayOffset:uint — De positie in het bytearray-object waarbij moet worden begonnen met het lezen van de structuurgegevens.
| |
miplevel:uint (default = 0) |
Gegenereerde uitzondering
TypeError — Null-aanwijzerfout: wanneer data de waarde null heeft.
| |
ArgumentError — Mip-niveau te hoog: wanneer het opgegeven mip-niveau hoger is dan het niveau dat wordt geïmpliceerd door de grootste afmeting van de structuur.
| |
RangeError — Onjuiste invoergrootte: als het aantal bytes dat beschikbaar is van byteArrayOffset tot aan het einde van de data-bytearray kleiner is dan de hoeveelheid gegevens die wordt vereist voor een structuur van dit mip-niveau, of als byteArrayOffset groter is dan of gelijk aan de lengte van data.
| |
ArgumentError — Niet-overeenkomende structuurindeling: in geval van de structuurindeling Context3DTextureFormat.COMPRESSED of Context3DTextureFormat.COMPRESSED_ALPHA en als de code wordt uitgevoerd op een mobiel platform waarop structuurcompressie tijdens de runtime niet wordt ondersteund.
| |
Error — 3768: De Stage3D-API kan niet worden gebruikt tijdens uitvoering op de achtergrond.
|
uploadFromByteArrayAsync | () | methode |
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 24 |
Uploadt miplevel 0 voor een structuur van een ByteArray-object op asynchrone wijze. Elke tekenmethode waarbij de structuur wordt gebruikt zal pas lukken nadat het uploadproces correct en volledig is uitgevoerd. Dit Texture-object verzendt Event.TEXTURE_READY bij een correct voltooid uploadproces. Event.TEXTURE_READY is een callback waarmee wordt aangegeven dat de asynchrone aanroepen die voor het structuurobject zijn ontvangen, met succes zijn uitgevoerd. Als er een fout optreedt tijdens het uploaden van de achtergrond, verzendt dit Texture-object de gebeurtenis Event.ERROREVENT.
Parameters
data:ByteArray — een bytearray die voldoende bytes bevat in de interne indeling van de structuur om de structuur te vullen. rgba-structuren worden gelezen als bytes per texel-component (1 of 4). float-structuren worden gelezen als floats per texel-component (1 of 4). Het ByteArray-object dient gebruik te maken van de little endian-indeling.
| |
byteArrayOffset:uint — De positie in het bytearray-object waarbij moet worden begonnen met het lezen van de structuurgegevens.
| |
miplevel:uint (default = 0) |
Gegenereerde uitzondering
TypeError — Null-aanwijzerfout: wanneer data de waarde null heeft.
| |
RangeError — Onjuiste invoergrootte: als het aantal bytes dat beschikbaar is van byteArrayOffset tot aan het einde van de data-bytearray kleiner is dan de hoeveelheid gegevens die wordt vereist voor een structuur met mip-niveau 0, of als byteArrayOffset groter is dan of gelijk is aan de lengte van data.
| |
ArgumentError — Niet-overeenkomende structuurindeling: in geval van de structuurindeling Context3DTextureFormat.COMPRESSED of Context3DTextureFormat.COMPRESSED_ALPHA en als de code wordt uitgevoerd op een mobiel platform waarop structuurcompressie tijdens de runtime niet wordt ondersteund.
| |
ArgumentError — Asynchroon uploadproces alleen ondersteund voor miplevel 0.
| |
Error — 3768: De Stage3D-API kan niet worden gebruikt tijdens uitvoering op de achtergrond.
| |
Error — als een asynchroon uploadproces is gestart voor een Texture-object en een ander asynchroon uploadproces wordt aangeroepen voor hetzelfde Texture-object.
|
Verwante API-elementen
Wed Jun 13 2018, 11:42 AM Z