Pakket | flash.display3D |
Klasse | public final class Program3D |
Overerving | Program3D Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 11, AIR 2 |
Programma's die worden beheerd door een Program3D-object besturen de volledige rendering van driehoeken tijdens een Context3D-aanroep drawTriangles()
. Upload de binaire bytecode met gebruik van de methode upload
naar de renderingcontext. (Na het uploaden wordt niet langer verwezen naar het programma in de oorspronkelijke array; wanneer de bronbytearray wordt gewijzigd of verwijderd, verandert het programma niet.)
Programma's bestaan altijd uit twee gekoppelde delen: een hoekpunt- en een fragmentprogramma.
- Het hoekpuntprogramma verwerkt de gegevens die zijn gedefinieerd in VertexBuffer3D-objecten, verzorgt de projectie van hoekpunten in de clipruimte en geeft alle vereiste hoekpuntgegevens, zoals kleur, door aan de fragmentshader.
- De fragmentshader verwerkt de kenmerken die worden doorgegeven door het hoekpuntprogramma en produceert een kleur voor elk gerasterd fragment van een driehoek, hetgeen resulteert in pixelkleuren. In literatuur over programmeren in 3D worden fragmentprogramma's ook wel fragmentshaders of pixelshaders genoemd.
Bepaal welke twee programma's moeten worden gebruikt voor volgende renderingbewerkingen door de corresponderende Program3D-instantie door te geven aan de Context3D-methode setProgram()
.
U kunt niet rechtstreeks een Program3D-object maken; daarvoor dient u de Context3D-methode createProgram()
te gebruiken.
Verwante API-elementen
Methode | Gedefinieerd door | ||
---|---|---|---|
Ontlast alle aan dit object gekoppelde bronnen. | Program3D | ||
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 | ||
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 | ||
Uploadt twee renderingprogramma's die zijn uitgedrukt in AGAL-bytecode (Adobe Graphics Assembly Language). | Program3D | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
dispose | () | methode |
public function dispose():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 11, AIR 3 |
Ontlast alle aan dit object gekoppelde bronnen. Na het verwijderen van een Program3D-object, mislukt het aanroepen van upload() en rendering met gebruik van dit object.
upload | () | methode |
public function upload(vertexProgram:ByteArray, fragmentProgram:ByteArray):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 11, AIR 3 |
Uploadt twee renderingprogramma's die zijn uitgedrukt in AGAL-bytecode (Adobe Graphics Assembly Language).
Programmabytecode kan worden gemaakt met behulp van de Pixel Bender 3D-offlinehulpmiddelen. Deze kan ook dynamisch worden gemaakt. De AGALMiniAssembler-klasse is een hulpprogrammaklasse die programma's in de AGAL-assembleertaal compileert in AGAL-bytecode. De klasse maakt niet deel uit van de runtime. Wanneer u de shaderprogramma's uploadt, wordt de bytecode gecompileerd in de native shadertaal voor het actieve apparaat (bijvoorbeeld OpenGL of Direct3D). De runtime valideert de bytecode tijdens het uploaden.
De programma's worden uitgevoerd wanneer de Context3D-methode drawTriangles()
wordt aangeroepen. Het hoekpuntprogramma wordt één keer uitgevoerd voor elk hoekpunt in de lijst met driehoeken die moeten worden getekend. Het fragmentprogramma wordt één keer uitgevoerd voor elke pixel op een driehoekvlak.
De "variabelen" die door een shaderprogramma worden gebruikt, worden registers genoemd. De volgende registers zijn gedefinieerd:
Naam | Aantal per fragmentprogramma | Aantal per hoekpuntprogramma | Doel |
---|---|---|---|
Kenmerk | n.v.t. | 8 | Hoekpuntshaderinvoer; lezen uit een hoekpuntbuffer die is opgegeven met Context3D.setVertexBufferAt(). |
Constante | 28 | 128 | Shaderinvoer; ingesteld met gebruik van de Context3D.setProgramConstants()-functies. |
Tijdelijke opslag | 8 | 8 | Tijdelijk register voor berekeningen, niet toegankelijk buiten programma. |
Uitvoer | 1 | 1 | Shaderuitvoer: in een hoekpuntprogramma is de uitvoer de positie van de clipruimte. In een fragmentprogramma heeft de uitvoer de vorm van een kleur. |
Variabele | 8 | 8 | Geïnterpoleerde gegevens overbrengen tussen hoekpunt- en fragmentshaders. De variabele-registers van het hoekpuntprogramma worden als invoer toegepast op het fragmentprogramma. De waarden worden geïnterpoleerd op basis van de afstand tot de hoekpunten van de driehoek. |
Sampler | 8 | n.v.t. | Fragmentshaderinvoer; gelezen vanuit een structuur die is opgegeven met gebruik van Context3D.setTextureAt(). |
Een hoekpuntprogramma ontvangt invoer uit twee bronnen: hoekpuntbuffers en constante-registers. Geef met gebruik van de Context3D-methode setVertexBufferAt()
op welke hoekpuntgegevens u wilt gebruiken voor een bepaald kenmerkregister voor hoekpunten. U kunt maximaal acht invoerregisters definiëren voor hoekpuntkenmerken. De waarden voor de hoekpuntkenmerken worden gelezen vanuit de hoekpuntbuffer voor elk hoekpunt in de driehoeklijst en in het kenmerkenregister geplaatst. Geef constante-registers op met gebruik van de Context3D-methode setProgramConstantsFromMatrix()
of setProgramConstantsFromVector()
. Constante-registers behouden dezelfde waarde voor elk hoekpunt in de driehoeklijst. (U kunt de constante-waarden alleen wijzigen tussen aanroepen van drawTriangles()
.)
Het hoekpuntprogramma verzorgt de projectie van de hoekpunten van de driehoek in de clipruimte (het canonieke weergavegebied binnen ±1 op de x- en y-as en 0-1 op de z-as) en de positionering van de getransformeerde coördinaten in het uitvoerregister. (Doorgaans ontvangt de shader de desbetreffende projectiematrix in een set constante-registers.) Het hoekpuntprogramma dient bovendien alle hoekpuntkenmerken of berekende waarden die het fragmentprogramma nodig heeft te kopiëren naar een speciale set variabelen die het variabele-register wordt genoemd. Wanneer een fragmentshader wordt uitgevoerd, wordt de waarde in een variabele-register lineair geïnterpoleerd op basis van de afstand van het huidige fragment tot elk hoekpunt van de driehoek.
Een fragmentprogramma ontvangt invoer van de variabele-registers en van een afzonderlijke set constante-registers (die zijn ingesteld met setProgramConstantsFromMatrix()
of setProgramConstantsFromVector()
). U kunt ook structuurgegevens lezen van structuren die met gebruik van sampler-registers zijn geüpload naar de renderingcontext. Bepaal aan de hand van de Context3D-methode setTextureAt()
welke structuur u wilt openen met een bepaald samplerregister. Het fragmentprogramma verzorgt het instellen van het uitvoerregister op een kleurwaarde.
Parameters
vertexProgram:ByteArray — AGAL-bytecode voor het hoekpuntprogramma. Het ByteArray-object dient gebruik te maken van de little endian-indeling.
| |
fragmentProgram:ByteArray — AGAL-bytecode voor het fragmentprogramma. Het ByteArray-object dient gebruik te maken van de little endian-indeling.
|
Gegenereerde uitzondering
TypeError — Null-aanwijzerfout: wanneer vertexProgram of fragmentProgram de waarde null heeft.
| |
Error — Object verwijderd: als het Program3D-object rechtstreeks is verwijderd door het aanroepen vandispose() of indirect door het aanroepen van de Context3D-methodedispose() of omdat de renderingcontext is verwijderd wegens apparaatverlies.
| |
ArgumentError — Agal-programma te klein: wanneer de programmacode-array minder dan 31 bytes lang is. Dit is de grootte van de shaderbytecode van een programma met één instructie.
| |
ArgumentError — Programma moet little endian zijn: als een van de twee bytecodearrays van de programma's geen little endian is.
| |
Error — Native shadercompilatie mislukt: als de uitvoer van de AGAL-conversie geen compileerbaar native shadertaalprogramma is. Deze fout wordt alleen gegenereerd in releaseplayers.
| |
Error — Native shadercompilatie OpenGL mislukt: wanneer de uitvoer van de AGAL-conversie geen compileerbaar OpenGL-shadertaalprogramma is en compilatiediagnoses bevat. Deze fout wordt alleen gegenereerd in foutopsporingsplayers.
| |
Error — Native shadercompilatie D3D9 mislukt: wanneer de uitvoer van de AGAL-conversie geen compileerbaar Direct3D-shadertaalprogramma is en compilatiediagnoses bevat. Deze fout wordt alleen gegenereerd in foutopsporingsplayers.
De volgende fouten worden gegenereerd als de validatie van de AGAL-bytecode mislukt: | |
Error — Geen AGAL-programma: als de ''magic byte'' in de header onjuist is. De eerste byte van de bytecode moet 0xa0 zijn. Deze fout kan aangeven dat de bytearray niet in de goede endian-volgorde is ingesteld.
| |
Error — Onjuiste AGAL-versie: wanneer de AGAL-versie niet wordt ondersteund door de huidige SWF-versie. De AGAL-versie dient voor SWF-versie 13 te worden ingesteld op 1.
| |
Error — Onjuist AGAL-programmatype: als de id van het AGAL-programmatype niet geldig is. De derde byte in de bytecode moet 0xa1 zijn. Deze fout kan aangeven dat de bytearray niet in de goede endian-volgorde is ingesteld.
| |
Error — Onjuist AGAL-shadertype: wanneer de code van het shadertype niet fragment of hoekpunt is (1 of 0).
| |
Error — Ongeldige AGAL-op-code buiten bereik: wanneer een ongeldige op-code wordt aangetroffen in de tokenstream.
| |
Error — Ongeldige AGAL-op-code niet geïmplementeerd: wanneer een ongeldige op-code wordt aangetroffen in de tokenstream.
| |
Error — AGAL-op-code alleen toegestaan in fragmentprogramma: als in de tokenstream van het hoekpuntprogramma een op-code wordt gevonden die alleen in fragmentprogramma's is toegestaan, zoals KIL of TEX.
| |
Error — Onjuiste AGAL-bronoperanden: als beide bronoperanden constante-registers zijn. U dient het resultaat buiten het shaderprogramma om te berekenen en het door te geven met gebruik van één constante-register.
| |
Error — Beide operanden zijn indirect gelezen: als beide operanden indirect zijn gelezen.
| |
Error — Op-code-doel moet helemaal nul zijn: als een token met een op-code (zoals KIL) maar zonder doel een andere waarde dan nul instelt voor het doelregister.
| |
Error — Op-code-doel vereist masker: als een op-code die alleen een resultaat met drie componenten produceert, zonder maskering wordt gebruikt.
| |
Error — Te veel tokens: als er te veel tokens (meer dan 200) in een AGAL-programma zijn.
| |
Error — Type fragmentshader: als het fragmentprogrammatype (byte 6 van de parameter fragmentProgram) niet op 1 is ingesteld.
| |
Error — Type hoekpuntshader: als het hoekpuntprogrammatype (byte 6 van de parameter vertexProgram) niet op 0 is ingesteld.
| |
Error — Variabele gelezen, maar er is niet naar geschreven: als de fragmentshader een variabele-register leest waarnaar de hoekpuntshader nooit heeft geschreven.
| |
Error — Variabele gedeeltelijk geschreven: als slechts gedeeltelijk naar een variabele-register is geschreven. Er moet naar alle componenten van een variabele-register worden geschreven.
| |
Error — Alle componenten schrijven naar fragment: als slechts gedeeltelijk naar een fragmentkleuruitvoer wordt geschreven. Er moet naar alle vier componenten van de kleuruitvoer worden geschreven.
| |
Error — Alle componenten schrijven naar hoekpunt: als slechts gedeeltelijk naar de clipruimte-uitvoer van een hoekpunt wordt geschreven. Er moet naar alle componenten van de clipruimte-uitvoer van een hoekpunt worden geschreven.
| |
Error — Ongebruikte operand: wanneer een ongebruikte operand in een token niet volledig op nul is ingesteld.
| |
Error — Samplerregister alleen in fragment: wanneer een structuursamplerregister wordt gebruikt in een hoekpuntprogramma.
| |
Error — Samplerregister tweede operand: wanneer een samplerregister wordt gebruikt als een doel of eerste operand van een AGAL-token.
| |
Error — Indirect alleen toegestaan in hoekpunt: wanneer indirecte adressering wordt gebruikt in een fragmentprogramma.
| |
Error — Alleen indirect naar constante-registers: wanneer indirecte adressering wordt gebruikt in een niet-constante-register.
| |
Error — Indirect brontype: wanneer het indirecte brontype geen kenmerk-, constante- of tijdelijk register is.
| |
Error — Indirecte adresseringsvelden moeten nul zijn: wanneer niet alle indirecte adresseringsvelden nul zijn voor directe adressering.
| |
Error — Variabele-registers alleen gelezen in fragment: wanneer een variabele-register wordt gelezen in een hoekpuntprogramma. Variabele-registers kunnen alleen worden geschreven in hoekpuntprogramma's en gelezen in fragmentprogramma's.
| |
Error — Kenmerkenregisters alleen gelezen in hoekpunt: wanneer een kenmerkenregister wordt gelezen in een fragmentprogramma. Kenmerkenregisters kunnen alleen worden gelezen in hoekpuntprogramma's.
| |
Error — Kan uitvoerregister niet lezen: wanneer een uitvoerregister (positie of kleur) wordt gelezen. Er kan alleen naar uitvoerregisters worden geschreven, deze kunnen niet worden gelezen.
| |
Error — Tijdelijk register gelezen zonder schrijven: wanneer een tijdelijk register wordt gelezen zonder dat er eerder naar is geschreven.
| |
Error — Tijdelijke registercomponent gelezen zonder schrijven: wanneer een tijdelijke registercomponent wordt gelezen zonder dat er eerder naar is geschreven.
| |
Error — Kan niet schrijven naar samplerregister: wanneer naar een samplerregister wordt geschreven. Samplerregisters kunnen alleen worden gelezen, er kan niet naar worden geschreven.
| |
Error — Schrijven naar variabele-registers: wanneer in een fragmentprogramma naar een variabele-register wordt geschreven. Variabele-registers kunnen alleen worden geschreven in hoekpuntprogramma's en gelezen in fragmentprogramma's.
| |
Error — Kan niet schrijven naar kenmerkenregister: wanneer naar een kenmerkenregister wordt geschreven. Kenmerkenregisters zijn alleen-lezen.
| |
Error — Kan niet schrijven naar constante-register: wanneer in een shaderprogramma naar een constante-register wordt geschreven.
| |
Error — Schrijfmasker van bestemming is nul: wanneer het schrijfmasker van een bestemming nul is. Alle componenten van een uitvoerregister moeten worden ingesteld.
| |
Error — Door AGAL gereserveerde bits moeten nul zijn: wanneer gereserveerde bits in een token niet nul zijn. Dit verwijst naar een fout bij het maken van de bytecode (of naar onjuist gevormde bytecode).
| |
Error — Onbekend registertype: wanneer een ongeldige index voor het registertype wordt gebruikt.
| |
Error — Samplerregister buiten bereik: wanneer een ongeldige index voor het samplerregister wordt gebruikt.
| |
Error — Variabele-register buiten bereik: wanneer een ongeldige index voor het variabele-register wordt gebruikt.
| |
Error — Kenmerkenregister buiten bereik: wanneer een ongeldige index voor het kenmerkenregister wordt gebruikt.
| |
Error — Constante-register buiten bereik: wanneer een ongeldige index voor het constante-register wordt gebruikt.
| |
Error — Uitvoerregister buiten bereik: wanneer een ongeldige index voor het uitvoerregister wordt gebruikt.
| |
Error — Tijdelijk register buiten bereik: wanneer een ongeldige index voor het tijdelijke register wordt gebruikt.
| |
Error — Kubustoewijzingssampler moet vastzetten gebruiken: wanneer een kubustoewijzingssampler de wrap-modus niet op vastzetten instelt.
| |
Error — Onbekende samplerdimensie: wanneer een sample een onbekende samplerdimensie gebruikt. (Alleen ondersteuning voor 2D- en kubusstructuren.)
| |
Error — Onbekende filtermodus: wanneer een sampler een onbekende filtermodus gebruikt. (Alleen de filtermodi Naaste buur en Lineair worden ondersteund.)
| |
Error — Onbekende mipmap-modus: wanneer een sampler een onbekende mipmap-modus gebruikt. (Alleen de mipmap-modi Geen, Naaste buur en Lineair worden ondersteund.)
| |
Error — Onbekende wrap-modus: wanneer een sampler gebruikmaakt van een onbekende wrap-modus. (Alleen de wrap-modi Vastzetten en Herhalen worden ondersteund.)
| |
Error — Onbekende speciale markering: wanneer een sampler een onbekende speciale markering gebruikt.
| |
Error — Uitvoerkleur niet maskeerbaar: u kunt het kleurenuitvoerregister in een fragmentprogramma niet maskeren. Alle componenten van het kleurenregister moeten worden ingesteld.
| |
Error — Tweede operand moet een samplerregister zijn: de AGAL-tex-opcode moet een sampler als de tweede bronoperand hebben.
| |
Error — Indirect niet toegestaan: er is indirecte adressering gebruikt waar dat niet is toegestaan.
| |
Error — Swizzle moet scalair zijn: swizzle-fout.
| |
Error — Swizzle op tweede bron niet mogelijk: swizzle-fout.
| |
Error — Tweede gebruik van sampler moet dezelfde parameters hebben: alle samplers met toegang tot dezelfde structuur dienen dezelfde instellingen voor afmetingen, wrap, filter en mipmaps te hebben plus dezelfde speciale instellingen.
| |
Error — 3768: De Stage3D -API kan niet worden gebruikt tijdens uitvoering op de achtergrond.
|
Meer informatie
Verwante API-elementen
Wed Jun 13 2018, 11:42 AM Z