Paquete | flash.display |
Clase | public class Stage3D |
Herencia | Stage3D EventDispatcher Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Stage3D ofrece una superficie de representación de alto rendimiento para contenido utilizado en la clase Context3D
. Esta superficie utiliza la unidad de procesamiento de gráficos (GPU) cuando es posible. El escenario del motor de ejecución proporciona un número fijo de objetos Stage3D
. El número de instancias varía según el tipo de dispositivo. Los equipos de escritorio normalmente ofrecen cuatro instancias de Stage3D.
El contenido extraído del visor Stage3D
está formado por otros objetos gráficos visibles en un orden predefinido. Las más alejadas son todas las superficies StageVideo
. Stage3D
viene después, con el contenido del objeto de visualización de Flash tradicional representado en último lugar, por encima de todos los demás. Las capas de StageVideo y Stage3D se procesan sin transparencia; por lo tanto un control Viewport3D oculta completamente cualquier otro visor de Stage3D o StageVideo situado por debajo de él. El contenido de la lista de visualización se procesa con transparencia.
Nota: se puede utilizar la propiedad visible
de un objeto Stage3D para quitarla de la visualización temporalmente, como cuando se reproduce un vídeo utilizando la clase StageVideo.
Un objeto Stage3D
se recupera desde el escenario del reproductor con su miembro stage3Ds
. Utilice la instancia de Stage3D para solicitar un contexto de procesamiento asociado y para colocar la visualización en el escenario del motor de ejecución.
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
context3D : Context3D [solo lectura]
El objeto Context3D asociado a esta instancia de Stage3D. | Stage3D | ||
visible : Boolean
Especifica si este objeto Stage3D está visible. | Stage3D | ||
x : Number
Coordenada horizontal de la visualización de Stage3D en el escenario, en píxeles. | Stage3D | ||
y : Number
Coordenada vertical de la visualización de Stage3D en el escenario, en píxeles. | Stage3D |
Método | Definido por | ||
---|---|---|---|
Stage3D() | Stage3D | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | ||
Distribuye un evento en el flujo del evento. | EventDispatcher | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
Solicita la creación de un objeto Context3D para esta instancia de Stage3D. | Stage3D | ||
Solicita la creación de un objeto Context3D para esta instancia de Stage3D. | Stage3D | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve la representación de cadena del objeto especificado. | Object | ||
Devuelve el valor simple del objeto especificado. | Object | ||
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher |
Evento | Resumen | Definido por | ||
---|---|---|---|---|
[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | |||
Se distribuye cuando se crea un contexto de procesamiento. | Stage3D | |||
[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | |||
Se distribuye cuando falla una petición de contexto de procesamiento. | Stage3D |
context3D | propiedad |
context3D:Context3D
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
El objeto Context3D asociado a esta instancia de Stage3D.
Esta propiedad es inicialmente null
. Para crear la instancia de Context3D para este objeto Stage3D, añada un detector de eventos para el evento context3DCreate
y, a continuación, llame al método requestContext3D
. Se llama al detector una vez creado el objeto Context3D.
Implementación
public function get context3D():Context3D
Elementos de API relacionados
visible | propiedad |
visible:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Especifica si este objeto Stage3D está visible.
Utilice esta propiedad para ocultar temporalmente un objeto Stage3D en el escenario. El valor predeterminado de esta propiedad es true
.
Implementación
public function get visible():Boolean
public function set visible(value:Boolean):void
x | propiedad |
x:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Coordenada horizontal de la visualización de Stage3D en el escenario, en píxeles.
Esta propiedad tiene cero como valor predeterminado.
Implementación
public function get x():Number
public function set x(value:Number):void
Emite
ArgumentError — si la posición no está en el intervalo [-8191..8191].
|
y | propiedad |
y:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Coordenada vertical de la visualización de Stage3D en el escenario, en píxeles.
Esta propiedad tiene cero como valor predeterminado.
Implementación
public function get y():Number
public function set y(value:Number):void
Emite
ArgumentError — si la posición no está en el intervalo [-8191..8191].
|
Stage3D | () | Información sobre |
public function Stage3D()
requestContext3D | () | método |
public function requestContext3D(context3DRenderMode:String = "auto", profile:String = "baseline"):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Solicita la creación de un objeto Context3D para esta instancia de Stage3D.
Antes de llamar a esta función, añada un detector de eventos para el evento context3DCreate
. Si no lo hace, el motor de ejecución emite una excepción.
Observación Importante sobre pérdidas en el: las pérdidas de dispositivo GPU se producen cuando el hardware de la GPU deja de estar disponible para la aplicación. El objeto Context3D se elimina cuando se pierde el dispositivo GPU. Se pueden producir pérdidas de dispositivo GPU por distintos motivos, como cuando un dispositivo móvil se queda sin batería o un dispositivo Windows activa la acción “bloquear pantalla”. Cuando la GPU vuelve a estar disponible, el motor de ejecución crea una nueva instancia de Context3D y distribuye otro evento context3DCreate
. La aplicación debe volver a cargar todos los activos y restablecer el estado del contexto de procesamiento siempre que se producen pérdidas de dispositivo.
Diseñe la lógica de la aplicación para gestionar la posibilidad de pérdidas de dispositivo y la regeneración de contextos. No elimine el detector de eventos context3DCreate
. No lleve a cabo acciones como respuesta al evento si no deben repetirse en la aplicación. Por ejemplo, no añada funciones anónimas para gestionar eventos timer porque se duplicarían después de la pérdida de dispositivo. Para probar cómo su aplicación maneja la pérdida de dispositivo, puede simular una pérdida de dispositivo llamando al método dispose()
del objeto Context3D.
El siguiente ejemplo ilustra cómo solicitar un contexto de procesamiento 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 ); }
Parámetros
context3DRenderMode:String (default = "auto ") — Tipo de contexto de procesamiento para solicitar. El valor predeterminado es Context3DRenderMode.AUTO para el que se creará contexto con aceleración de hardware si es posible y se redirige al software en caso contrario. Utilice Context3DRenderMode.SOFTWARE para solicitar un contexto la procesamiento por software. La representación por software no está disponible en dispositivos móviles. El procesamiento de software solo está disponible para Context3DProfile.BASELINE y Context3DProfile.BASELINE_CONSTRAINED .
| |
profile:String (default = "baseline ") — (AIR 3.4 y posterior) Especifica la medida en que Flash Player admite GPU de nivel inferior. El valor predeterminado es Context3DProfile.BASELINE que devuelve una instancia de Context3D similar a la utilizada en versiones anteriores. Para obtener los detalles de todos los perfiles disponibles, consulte flash.display3D.Context3DProfile .
|
Eventos
context3DCreate: — Se distribuye cuando el contexto de procesamiento solicitado se ha completado correctamente.
| |
error: — Se distribuye cuando no es posible crear el contexto de procesamiento solicitado.
|
Emite
Error — si no se han añadido detectores para el evento context3DCreate a este objeto Stage3D.
| |
ArgumentError — si se vuelve a llamar a este método con un context3DRenderMode diferente antes de que haya finalizado la llamada anterior.
|
Elementos de API relacionados
requestContext3DMatchingProfiles | () | método |
public function requestContext3DMatchingProfiles(profiles:Vector.<String>):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 12, AIR 4 |
Solicita la creación de un objeto Context3D para esta instancia de Stage3D.
Antes de llamar a esta función, añada un detector de eventos para el evento context3DCreate
. Si no lo hace, el motor de ejecución emite una excepción.
Observación Importante sobre pérdidas en el: las pérdidas de dispositivo GPU se producen cuando el hardware de la GPU deja de estar disponible para la aplicación. El objeto Context3D se elimina cuando se pierde el dispositivo GPU. Se pueden producir pérdidas de dispositivo GPU por distintos motivos, como cuando un dispositivo móvil se queda sin batería o un dispositivo Windows activa la acción “bloquear pantalla”. Cuando la GPU vuelve a estar disponible, el motor de ejecución crea una nueva instancia de Context3D y distribuye otro evento context3DCreate
. La aplicación debe volver a cargar todos los activos y restablecer el estado del contexto de procesamiento siempre que se producen pérdidas de dispositivo.
Diseñe la lógica de la aplicación para gestionar la posibilidad de pérdidas de dispositivo y la regeneración de contextos. No elimine el detector de eventos context3DCreate
. No lleve a cabo acciones como respuesta al evento si no deben repetirse en la aplicación. Por ejemplo, no añada funciones anónimas para gestionar eventos timer porque se duplicarían después de la pérdida de dispositivo. Para probar cómo su aplicación maneja la pérdida de dispositivo, puede simular una pérdida de dispositivo llamando al método dispose()
del objeto Context3D.
El siguiente ejemplo ilustra cómo solicitar un contexto de procesamiento 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 );
Parámetros
profiles:Vector.<String> — (AIR 3.4 y posterior) un conjunto de perfiles que el desarrollador desea utilizar en el programa Flash. Cuando el desarrollador transfiere el conjunto de perfiles a Stage3D.requestContext3DMatchingProfiles, obtiene un Context3D basado en el perfil de alto nivel del conjunto según la capacidad de hardware. El parámetro se omite porque renderMode se ha establecido como AUTO.
|
Eventos
context3DCreate: — Se distribuye cuando el contexto de procesamiento solicitado se ha completado correctamente.
| |
error: — Se distribuye cuando no es posible crear el contexto de representación solicitado. Si el hardware no está disponible, no creará un software Context3D.
|
Emite
Error — si no se han añadido detectores para el evento context3DCreate a este objeto Stage3D.
| |
ArgumentError — si se llama a este método antes de que se complete la llamada anterior.
| |
ArgumentError — si el elemento del conjunto no es flash.display3D.Context3DProfile.
|
Elementos de API relacionados
context3DCreate | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.CONTEXT3D_CREATE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Se distribuye cuando se crea un contexto de procesamiento.
La constanteEvent.CONTEXT3D_CREATE
define el valor de la propiedad type
de un objeto de evento context3Dcreate
. Este evento se activa sólo con objetos Stage3D en respuesta a una llamada a Stage3D.requestContext3D o en respuesta a un reinicio accionado por el sistema operativo en el límite de Context3D vinculado al objeto Stage3D. Inspeccione la propiedad Stage3D.context3D para obtener el objeto Context3D recién creado.
Elementos de API relacionados
error | Evento |
flash.events.ErrorEvent
propiedad ErrorEvent.type =
flash.events.ErrorEvent.ERROR
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Se distribuye cuando falla una petición de contexto de procesamiento.
Define el valor de la propiedadtype
de un objeto de evento error
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto en el que se produce un error de operación de red. |
text | Texto que se mostrará como mensaje de error. |
Elementos de API relacionados
Tue Jun 12 2018, 02:12 PM Z