| Pakket | flash.display3D.textures |
| Klasse | public final class CubeTexture |
| Overerving | CubeTexture  TextureBase EventDispatcher Object |
Hiermee wordt een kubustoewijzingsstructuur gedefinieerd die tijdens het renderen wordt gebruikt. Kubustoewijzing wordt gebruikt voor vele renderingtechnieken, zoals omgevingstoewijzingen, skyboxes en avondverlichting.
U kunt niet rechtstreeks een CubeTexture-object maken, u dient Context3D-createCubeTexture() te gebruiken.
Meer informatie
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 kubusstructuur in de ATF-indeling (Adobe Texture Format) van een bytearray. | CubeTexture | ||
Uploadt een component van een kubustoewijzingsstructuur vanuit een BitmapData-object. | CubeTexture | ||
Uploadt een component van een kubustoewijzingsstructuur vanuit een ByteArray-object. | CubeTexture | ||
|
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 kubusstructuur in de ATF-indeling (Adobe Texture Format) van een bytearray.
De bytearray dient alle vlakken en mipmaps voor de structuur te bevatten.
Parameters
data:ByteArray — Een bytearray die een gecomprimeerde kubusstructuur bevat, inclusief mipmaps. Het ByteArray-object dient gebruik te maken van de little endian-indeling.
| |
byteArrayOffset:uint — Een optionele verschuiving voor de locatie waar wordt begonnen met het lezen van de structuurgegevens.
| |
async:Boolean (default = false)Texture-object verzendt Event.TEXTURE_READY bij een correct voltooid uploadproces. Standaardwaarde: false.
|
Gegenereerde uitzondering
TypeError — Null-aanwijzerfout: wanneer data de waarde null heeft.
| |
ArgumentError — Structuurdecodering mislukt: wanneer de compressie-indeling van dit object niet kan worden afgeleid van de indeling van de gecomprimeerde gegevens in data.
| |
ArgumentError — Structuur moet vierkant zijn: wanneer de breedte en hoogte van de gedecomprimeerde structuur niet gelijk zijn.
| |
ArgumentError — Structuurformaat komt niet overeen: wanneer de breedte en hoogte van de gedecomprimeerde structuur niet overeenkomen met de lengte van de structuurrand.
| |
ArgumentError — Mip-niveau te groot: als het mip-niveau van de gedecomprimeerde structuur groter is dan het niveau dat wordt geïmpliceerd door de lengte van de structuurrand.
| |
ArgumentError — Niet-overeenkomende structuurindeling: als de gedecodeerde ATF-bytes geen structuur bevatten die compatibel is met de indeling van deze structuur of die geen kubusstructuur is.
| |
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, side:uint, miplevel:uint = 0):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3 |
Uploadt een component van een kubustoewijzingsstructuur vanuit een BitmapData-object.
Deze functie uploadt een mip-niveau van een zijde van de kubustoewijzing. Roep uploadFromBitmapData() aan als dat nodig is om elk mip-niveau en vlak van de kubustoewijzing te uploaden.
Parameters
source:BitmapData — een bitmap.
| |
side:uint — Een code die aangeeft welke zijde van de kubus moet worden geüpload:
| |
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 afmetingen van de structuur.
| |
ArgumentError — Ongeldige kubusgrootte: wanneer side groter is dan 5.
| |
ArgumentError — Ongeldige BitmapData-fout: wanneer het BitmapData-object source geen geldige waarde voor het kubusstructuurvlak bevat. De afbeelding moet vierkant zijn, de zijden 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.
|
uploadFromByteArray | () | methode |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | Flash Player 11, AIR 3 |
Uploadt een component van een kubustoewijzingsstructuur vanuit een ByteArray-object.
Deze functie uploadt een mip-niveau van een zijde van de kubustoewijzing. Roep uploadFromByteArray() aan als dat nodig is om elk mip-niveau en vlak van de kubustoewijzing te uploaden.
Parameters
data:ByteArray — een bytearray die de afbeelding bevat in de indeling die is opgegeven tijdens het maken van dit CubeTexture-object. Het ByteArray-object dient gebruik te maken van de little endian-indeling.
| |
byteArrayOffset:uint — lezen van de bytearray begint hier.
| |
side:uint — Een code die aangeeft welke zijde van de kubus moet worden geüpload:
| |
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 afmetingen 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.
|
Wed Jun 13 2018, 11:42 AM Z