Paket | flash.display |
Klass | public class Stage3D |
Arv | Stage3D EventDispatcher Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
Stage3D ger en återgivningsyta med hög kvalitet för innehåll som återges med klassen Context3D
. För denna yta används GPU-enheten när det är möjligt. Körningsscenen ger ett fast antal Stage3D
-objekt. Antalet instanser varierar beroende på vilken typ av enhet det är. Stationära datorer har vanligtvis fyra Stage3D-instanser.
Innehåll som dras till Stage3D
-visningsporten blandas med andra synliga grafikobjekt i en fördefinierad ordning. Den mest avlägsna StageVideo
-ytan av alla. Därefter kommer Stage3D
med traditionellt Flash-visningsobjektsinnehåll som återges sist, över alla andra. StageVideo- och Stage3D-lager återges utan genomskinlighet. Detta innebär att en visningsport helt skymmer andra Stage3D- eller StageVideo-visningsportar som är placerade under den. Innehållet i visningslistan återges genomskinligt.
Obs! Du kan använda egenskapen visible
för ett Stage3D-objekt för att ta bort det från visningen temporärt, till exempel när du spelar upp en video med StageVideo-klassen.
Ett Stage3D
-objekt återges från Player-scenen med hjälp av dess stage3Ds
-medlem. Använd Stage3D-instansen för att begära ett associerat återgivningssammanhang och för att placera visningen på körningsscenen.
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
context3D : Context3D [skrivskyddad]
Context3D-objekt associerade med denna Stage3D-instans. | Stage3D | ||
visible : Boolean
Anger om Stage3D-objektet visas. | Stage3D | ||
x : Number
Den vågräta koordinaten för Stage3D-visning på scenen, i pixlar. | Stage3D | ||
y : Number
Den lodräta koordinaten för Stage3D-visning på scenen, i pixlar. | Stage3D |
Metod | Definieras med | ||
---|---|---|---|
Stage3D() | Stage3D | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | EventDispatcher | ||
Skickar en händelse till händelseflödet. | EventDispatcher | ||
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | ||
Begär att ett Context3D-objekt för denna Stage3D-instans skapas. | Stage3D | ||
Begär att ett Context3D-objekt för denna Stage3D-instans skapas. | Stage3D | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
Returnerar det angivna objektets primitiva värde. | Object | ||
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher |
Händelse | Sammanfattning | Definieras med | ||
---|---|---|---|---|
[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | |||
Skickas när ett återgivningssammanhang skapas. | Stage3D | |||
[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | |||
Skickas när en begäran om ett återgivningssammanhang misslyckas. | Stage3D |
context3D | egenskap |
context3D:Context3D
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
Context3D-objekt associerade med denna Stage3D-instans.
Den här egenskapen är till att börja med null
. Om du vill skapa Context3D-instansen för det här Stage3D-objektet lägger du till en händelseavlyssnare för context3DCreate
-händelsen och anropar sedan metoden requestContext3D
. Avlyssnaren anropas när Context3D-objektet har skapats.
Implementering
public function get context3D():Context3D
Relaterade API-element
visible | egenskap |
visible:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
Anger om Stage3D-objektet visas.
Använd den här egenskapen för att tillfälligt dölja ett Stage3D-objekt på scenen. Denna egenskap är som standard true
.
Implementering
public function get visible():Boolean
public function set visible(value:Boolean):void
x | egenskap |
x:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
Den vågräta koordinaten för Stage3D-visning på scenen, i pixlar.
Denna egenskap är som standard noll.
Implementering
public function get x():Number
public function set x(value:Number):void
Utlöser
ArgumentError — om positionen inte ligger inom intervallet [-8191..8191].
|
y | egenskap |
y:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
Den lodräta koordinaten för Stage3D-visning på scenen, i pixlar.
Denna egenskap är som standard noll.
Implementering
public function get y():Number
public function set y(value:Number):void
Utlöser
ArgumentError — om positionen inte ligger inom intervallet [-8191..8191].
|
Stage3D | () | Konstruktor |
public function Stage3D()
requestContext3D | () | metod |
public function requestContext3D(context3DRenderMode:String = "auto", profile:String = "baseline"):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
Begär att ett Context3D-objekt för denna Stage3D-instans skapas.
Innan den här funktionen anropas lägger du till en händelseavlyssnare för händelsen context3DCreate
. Om inte detta görs kommer ett undantag att returneras under körningen.
Viktigt meddelande om enhetsförlust: Förlust av GPU-enheter inträffar när GPU-maskinvaran blir otillgänglig för programmet. Objektet Context3D blir obrukbart när GPU-enheten förloras. Förlust av GPU-enheter kan inträffa av olika anledningar, till exempel när batteriet tar slut i en mobil enhet eller när skärmen låses på en Windows-enhet. När grafikprocessorn blir tillgänglig igen skapas en ny Context3D-instans och ännu en context3DCreate
-händelse skickas. Programmet måste ladda om alla resurser och återställa återgivningssammanhanget när enhetsförluster inträffar.
Skapa en design i programlogiken som hanterar möjligheten till en enhetsförlust och omgenerering av sammanhanget. Ta inte bort händelseavlyssnaren context3DCreate
. Utför inga åtgärder som svar på händelsen som inte ska repeteras i programmet. Lägg till exempel inte till anonyma funktioner för att hantera timer-händelser, eftersom de dubbleras efter en enhetsförlust. Om du vill testa hur programmet hanterar enhetsförluster, kan du simulera en enhetsförlust genom att anropa metoden dispose()
för Context3D-objektet.
I följande exempel visas hur du begär ett återgivningssammanhang för Context3d:
if( stage.stage3Ds.length > 0 ) { var stage3D:Stage3D = stage.stage3Ds[0]; stage3D.addEventListener( Event.CONTEXT3D_CREATE, myContext3DHandler ); stage3D.requestContext3D( ); } function myContext3DHandler ( event : Event ) : void { var targetStage3D : Stage3D = event.target as Stage3D; InitAll3DResources( targetStage3D.context3D ); StartRendering( targetStage3D.context3D ); }
Parametrar
context3DRenderMode:String (default = "auto ") — Den typ av återgivningssammanhang som ska begäras. Standard är ContextDRenderMode.AUTO som om möjligt kommer att skapa ett maskinvaruaccelererat sammanhang under körningen och i annat fall återgå till programmet. Använd Context3DRenderMode.SOFTWARE för att begära ett programåtergivningssammanhang. Programvaruåtergivning är inte tillgängligt för mobila enheter. Programvaruåtergivning är bara tillgängligt för Context3DProfile.BASELINE och Context3DProfile.BASELINE_CONSTRAINED .
| |
profile:String (default = "baseline ") — (AIR 3.4 och senare) anger i vilken utsträckning Flash Player stöder GPU:er på lägre nivå. Standardvärdet är Context3DProfile.BASELINE , vilket returnerar en Context3D -instans som liknar den som används i tidigare versioner. Information om alla tillgängliga profiler finns i flash.display3D.Context3DProfile .
|
Händelser
context3DCreate: — Skickas när begärt återgivningssammanhang har slutförts.
| |
error: — Skickas när begärt återgivningssammanhang inte kan skapas.
|
Utlöser
Error — om inga avlyssnare för händelsen context3DCreate har lagts till i det här Stage3D-objektet.
| |
ArgumentError — om denna metod anropas en gång till med ett annat context3DRenderMode innan föregående anrop har slutförts.
|
Relaterade API-element
requestContext3DMatchingProfiles | () | metod |
public function requestContext3DMatchingProfiles(profiles:Vector.<String>):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 12, AIR 4 |
Begär att ett Context3D-objekt för denna Stage3D-instans skapas.
Innan den här funktionen anropas lägger du till en händelseavlyssnare för händelsen context3DCreate
. Om inte detta görs kommer ett undantag att returneras under körningen.
Viktigt meddelande om enhetsförlust: Förlust av GPU-enheter inträffar när GPU-maskinvaran blir otillgänglig för programmet. Objektet Context3D blir obrukbart när GPU-enheten förloras. Förlust av GPU-enheter kan inträffa av olika anledningar, till exempel när batteriet tar slut i en mobil enhet eller när skärmen låses på en Windows-enhet. När grafikprocessorn blir tillgänglig igen skapas en ny Context3D-instans och ännu en context3DCreate
-händelse skickas. Programmet måste ladda om alla resurser och återställa återgivningssammanhanget när enhetsförluster inträffar.
Skapa en design i programlogiken som hanterar möjligheten till en enhetsförlust och omgenerering av sammanhanget. Ta inte bort händelseavlyssnaren context3DCreate
. Utför inga åtgärder som svar på händelsen som inte ska repeteras i programmet. Lägg till exempel inte till anonyma funktioner för att hantera timer-händelser, eftersom de dubbleras efter en enhetsförlust. Om du vill testa hur programmet hanterar enhetsförluster, kan du simulera en enhetsförlust genom att anropa metoden dispose()
för Context3D-objektet.
I följande exempel visas hur du begär ett återgivningssammanhang för Context3d:
if( stage.stage3Ds.length > 0 ) { var stage3D:Stage3D = stage.stage3Ds[0]; stage3D.addEventListener( Event.CONTEXT3D_CREATE, myContext3DHandler ); stage3D.requestContext3DMatchingProfiles(Vector.<string>([Context3DProfile.BASELINE, Context3DProfile.BASELINE_EXTENDED])); } function myContext3DHandler ( event : Event ) : void { var targetStage3D : Stage3D = event.target as Stage3D; if(targetStage3D.context3D.profile.localeCompare(Context3DProfile.BASELINE) == 0) { InitAll3DResources( targetStage3D.context3D ); } StartRendering( targetStage3D.context3D );
Parametrar
profiles:Vector.<String> — (AIR 3.4 och senare) arrayer för en profil som utvecklare vill använda i sina flash-program. Context3D baserat på profilen på den höga nivån i arrayen används beroende på maskinvarans kapacitet när utvecklaren överför profilarrayen till Stage3D.requestContext3DMatchingProfiles. Återgivningsläget är inställt på AUTO så parametern utelämnas.
|
Händelser
context3DCreate: — Skickas när begärt återgivningssammanhang har slutförts.
| |
error: — Skickas när begärt återgivningssammanhang inte kan skapas. Om maskinvaran inte är tillgänglig, kommer den inte skapa en programvarubaserad context3d.
|
Utlöser
Error — om inga avlyssnare för händelsen context3DCreate har lagts till i det här Stage3D-objektet.
| |
ArgumentError — om denna metod anropas innan det föregående anropet har slutförts.
| |
ArgumentError — om objektet i en array inte är flash.display3D.Context3DProfile.
|
Relaterade API-element
context3DCreate | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.CONTEXT3D_CREATE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
Skickas när ett återgivningssammanhang skapas.
Med konstantenEvent.CONTEXT3D_CREATE
definieras värdet för ett context3Dcreate
-händelseobjekts type
-egenskap. Händelsen inträffar endast för Stage3D-objekt som svar på antingen ett anrop till Stage3D.requestContext3D eller en OS-aktiverad återställning av det Context3D som är bundet till Stage3D-objektet. Granska Stage3D.context3D-egenskapen för att erhålla det nyskapade Context3D-objektet.
Relaterade API-element
error | Händelse |
flash.events.ErrorEvent
egenskap ErrorEvent.type =
flash.events.ErrorEvent.ERROR
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 11, AIR 3 |
Skickas när en begäran om ett återgivningssammanhang misslyckas.
Definierar värdet för etterror
-händelseobjekts type
-egenskap.
Den här händelsen har följande egenskaper:
Egenskap | Värde |
---|---|
bubbles | false |
cancelable | false ; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Objektet är med om ett nätverksfel. |
text | Text som visas som felmeddelande. |
Relaterade API-element
Tue Jun 12 2018, 01:40 PM Z