Package | flash.display |
Classe | public class Stage3D |
Héritage | Stage3D EventDispatcher Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Stage3D fournit une surface de rendu haute performance pour le contenu rendu à l’aide de la classe Context3D
. Cette surface utilise l’unité de traitement graphique (GPU) lorsque cela est possible. La scène du moteur d’exécution offre un nombre fixe d’objets Stage3D
. Le nombre d’occurrences varie en fonction du type de périphérique. Les ordinateurs de bureau fournissent généralement quatre occurrences de Stage3D.
Le contenu dessiné sur la fenêtre d’affichage Stage3D
est combiné avec d’autres objets graphiques visibles dans un ordre prédéfini. Les plus éloignés sont toutes des surfaces StageVideo
. Stage3D
vient ensuite, avec le contenu de l’objet d’affichage Flash traditionnel rendu en dernier, au-dessus de tous les autres. Les calques StageVideo et Stage3D sont rendus sans transparence ; de ce fait, une fenêtre d'affichage obscurcit totalement toute autre fenêtre d'affichage Stage3D ou StageVideo placée sous celle-ci. Le contenu de la liste d’affichage est rendu avec la transparence.
Remarque : vous pouvez utiliser la propriété visible
d’un objet Stage3D pour retirer temporairement ce dernier de l’affichage, notamment lors de la lecture d’une vidéo à l’aide de la classe StageVideo.
Un objet Stage3D
est extrait de la scène du lecteur à l’aide de son membre stage3Ds
. Utilisez l’occurrence de Stage3D pour demander un contexte de rendu associé et pour positionner l’affichage sur la scène du moteur d’exécution.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
context3D : Context3D [lecture seule]
Objet Context3D associé à cette occurrence de Stage3D. | Stage3D | ||
visible : Boolean
Indique si cet objet Stage3D est visible. | Stage3D | ||
x : Number
Coordonnées horizontales de l’affichage Stage3D sur la scène, en pixels. | Stage3D | ||
y : Number
Coordonnées verticales de l’affichage Stage3D sur la scène, en pixels. | Stage3D |
Méthode | Défini par | ||
---|---|---|---|
Stage3D() | Stage3D | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Demandez la création d’un objet Context3D pour cette occurrence de Stage3D. | Stage3D | ||
Demandez la création d’un objet Context3D pour cette occurrence de Stage3D. | Stage3D | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
Evénement | Synthèse | Défini par | ||
---|---|---|---|---|
[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | |||
Distribué lors de la création d’un contexte de rendu. | Stage3D | |||
[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | |||
Distribué lors de l’échec d’une demande de contexte de rendu. | Stage3D |
context3D | propriété |
context3D:Context3D
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Objet Context3D associé à cette occurrence de Stage3D.
Initialement, cette propriété est null
. Pour créer l’occurrence de Context3D pour cet objet Stage3D, ajoutez un écouteur d’événement pour l’événement context3DCreate
, puis appelez la méthode requestContext3D
. L’écouteur est appelé une fois l’objet Context3D créé.
Implémentation
public function get context3D():Context3D
Eléments de l’API associés
visible | propriété |
visible:Boolean
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Indique si cet objet Stage3D est visible.
Utilisez cette propriété pour masquer temporairement un objet Stage3D sur la scène. Cette propriété prend par défaut la valeur true
.
Implémentation
public function get visible():Boolean
public function set visible(value:Boolean):void
x | propriété |
x:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Coordonnées horizontales de l’affichage Stage3D sur la scène, en pixels.
Cette propriété prend par défaut la valeur zéro.
Implémentation
public function get x():Number
public function set x(value:Number):void
Valeur émise
ArgumentError — si la position n’est pas dans l’intervalle [-8191..8191].
|
y | propriété |
y:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Coordonnées verticales de l’affichage Stage3D sur la scène, en pixels.
Cette propriété prend par défaut la valeur zéro.
Implémentation
public function get y():Number
public function set y(value:Number):void
Valeur émise
ArgumentError — si la position n’est pas dans l’intervalle [-8191..8191].
|
Stage3D | () | Constructeur |
public function Stage3D()
requestContext3D | () | méthode |
public function requestContext3D(context3DRenderMode:String = "auto", profile:String = "baseline"):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Demandez la création d’un objet Context3D pour cette occurrence de Stage3D.
Avant d'appeler cette fonction, ajoutez un écouteur d'événement pour l'événement context3DCreate
. Dans le cas contraire, le moteur d’exécution renvoie une exception.
Remarque importante concernant la perte de périphérique : la perte de périphérique GPU se produit lorsque le matériel GPU devient indisponible à l’application. L’objet Context3D est éliminé lorsque le périphérique GPU est perdu. La perte de périphérique GPU peut se produire pour différentes raisons, notamment lorsqu’un périphérique mobile n’a plus de batterie ou lorsqu’un écran de verrouillage est activé sur un périphérique Windows. Lorsque le GPU devient à nouveau disponible, le moteur d’exécution crée une nouvelle occurrence de Context3D et distribue un autre événement context3DCreate
. Votre application doit recharger tous les actifs et rétablir l’état du contexte de rendu chaque fois qu’une perte de périphérique se produit.
Concevez votre logique d’application en tenant compte du risque de perte de périphérique et de la régénération du contexte. Ne supprimez pas l’écouteur d’événement context3DCreate
. N’exécutez aucune action en réponse à l’événement qui ne doit pas être répétée dans l’application. Par exemple, n’ajoutez pas de fonctions anonymes pour gérer les événements d’horloge au risque de les dupliquer après la perte de périphérique. Pour tester la gestion de perte de périphérique de votre application, vous pouvez simuler la perte de périphérique en appelant la méthode dispose()
de l’objet Context3D.
L’exemple suivant explique comment demander un contexte de rendu 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 ); }
Paramètres
context3DRenderMode:String (default = "auto ") — Type de contexte de rendu à demander. La valeur par défaut est Context3DRenderMode.AUTO , pour laquelle le moteur d’exécution crée un contexte par accélération matérielle, lorsque cela est possible, ou revient au logiciel dans le cas contraire. Utilisez Context3DRenderMode.SOFTWARE pour demander un contexte de rendu logiciel. Le rendu logiciel n’est pas disponible sur les périphériques mobiles. Le rendu logiciel est disponible uniquement pour Context3DProfile.BASELINE et Context3DProfile.BASELINE_CONSTRAINED .
| |
profile:String (default = "baseline ") — (AIR 3.4 et versions ultérieures) Indique dans quelle mesure Flash Player prend en charge les GPU de niveau inférieur. La valeur par défaut est Context3DProfile.BASELINE , qui renvoie une occurrence de Context3D similaire à celle utilisée dans les versions précédentes. Pour accéder aux détails de tous les profils disponibles, consultez flash.display3D.Context3DProfile .
|
Evénements
context3DCreate: — Distribué lorsque le contexte de rendu demandé est terminé.
| |
error: — Distribué lorsque le contexte de rendu demandé ne peut pas être créé.
|
Valeur émise
Error — si aucun écouteur pour l’événement context3DCreate n’a été ajouté à cet objet Stage3D.
| |
ArgumentError — si cette méthode est à nouveau appelée avec un context3DRenderMode différent avant la fin de l’appel précédent.
|
Eléments de l’API associés
requestContext3DMatchingProfiles | () | méthode |
public function requestContext3DMatchingProfiles(profiles:Vector.<String>):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 12, AIR 4 |
Demandez la création d’un objet Context3D pour cette occurrence de Stage3D.
Avant d'appeler cette fonction, ajoutez un écouteur d'événement pour l'événement context3DCreate
. Dans le cas contraire, le moteur d’exécution renvoie une exception.
Remarque importante concernant la perte de périphérique : la perte de périphérique GPU se produit lorsque le matériel GPU devient indisponible à l’application. L’objet Context3D est éliminé lorsque le périphérique GPU est perdu. La perte de périphérique GPU peut se produire pour différentes raisons, notamment lorsqu’un périphérique mobile n’a plus de batterie ou lorsqu’un écran de verrouillage est activé sur un périphérique Windows. Lorsque le GPU devient à nouveau disponible, le moteur d’exécution crée une nouvelle occurrence de Context3D et distribue un autre événement context3DCreate
. Votre application doit recharger tous les actifs et rétablir l’état du contexte de rendu chaque fois qu’une perte de périphérique se produit.
Concevez votre logique d’application en tenant compte du risque de perte de périphérique et de la régénération du contexte. Ne supprimez pas l’écouteur d’événement context3DCreate
. N’exécutez aucune action en réponse à l’événement qui ne doit pas être répétée dans l’application. Par exemple, n’ajoutez pas de fonctions anonymes pour gérer les événements d’horloge au risque de les dupliquer après la perte de périphérique. Pour tester la gestion de perte de périphérique de votre application, vous pouvez simuler la perte de périphérique en appelant la méthode dispose()
de l’objet Context3D.
L’exemple suivant explique comment demander un contexte de rendu 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 );
Paramètres
profiles:Vector.<String> — (AIR 3.4 et versions ultérieures) tableau de profil que le développeur veut utiliser dans son programme flash. Lorsque le développeur transmet le tableau de profil à Stage3D.requestContext3DMatchingProfiles, il obtient un objet Context3D en fonction du profil de haut niveau dans ce tableau et selon la capacité matérielle. Le mode de rendu rendermode est défini sur AUTO ; le paramètre est ainsi omis.
|
Evénements
context3DCreate: — Distribué lorsque le contexte de rendu demandé est terminé.
| |
error: — Distribué lorsque le contexte de rendu demandé ne peut pas être créé. Si le matériel n’est pas disponible, aucun objet Context3D logiciel n’est créé.
|
Valeur émise
Error — si aucun écouteur pour l’événement context3DCreate n’a été ajouté à cet objet Stage3D.
| |
ArgumentError — si cette méthode est appelée avant la fin de l’appel précédent.
| |
ArgumentError — si l’élément dans le tableau n’est pas flash.display3D.Context3DProfile.
|
Eléments de l’API associés
context3DCreate | Evénement |
flash.events.Event
propriété Event.type =
flash.events.Event.CONTEXT3D_CREATE
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Distribué lors de la création d’un contexte de rendu.
La constanteEvent.CONTEXT3D_CREATE
définit la valeur de la propriété type
d’un objet d’événement context3Dcreate
. Cet événement est distribué uniquement par les objets Stage3D en réponse à un appel à Stage3D.requestContext3D ou en réponse à une réinitialisation de l’objet Context3D lié à l’objet Stage3D déclenchée par un système d’exploitation. Inspectez la propriété Stage3D.context3D afin d’obtenir le nouvel objet Context3D.
Eléments de l’API associés
error | Evénement |
flash.events.ErrorEvent
propriété ErrorEvent.type =
flash.events.ErrorEvent.ERROR
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Distribué lors de l’échec d’une demande de contexte de rendu.
Définit la valeur de la propriététype
d’un objet d’événement error
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet qui subit l’échec de l’opération réseau. |
text | Texte à afficher en tant que message d’erreur. |
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z