Stage3D  - AS3

O objeto Context3D associado a esta instância Stage3D.

Esta propriedade é inicialmente null. Para criar a ocorrência Context3D deste objeto Stage3D, adicione um ouvinte de evento ao eventocontext3DCreate e, em seguida, chame o método requestContext3D. O ouvinte é chamado depois que o objeto Context3D é criado.

Elementos da API relacionados

Especifica se este objeto Stage3D está visível.

Utilize esta propriedade para ocultar temporariamente um objeto Stage3D na Etapa. Esta propriedade tem o padrão true.

A coordenada horizontal do Stage3D é exibida na etapa, em pixels.

Esta propriedade tem o padrão como zero.

A coordenada vertical do Stage3D é exibida na etapa, em pixels.

Esta propriedade tem o padrão como zero.

Solicite a criação de um objeto Context3D para essa instância Stage3D.

Antes da chamada desta função, adicione um ouvinte de evento para o evento context3DCreate. Caso contrário, o tempo de execução lançará uma exceção.

Observação importante nem caso de perda de dispositivo: a perda de dispositivo de GPU ocorre quando o hardware de GPU fica indisponível ao aplicativo. O objeto de Context3D é descartado quando o dispositivo de GPU é perdido. A perda de dispositivo de GPU poderá ocorrer por várias razões, como quando um dispositivo móvel fica sem energia de bateria ou um dispositivo de Windows vai até uma "tela de travamento." Quando a GPU torna-se disponível novamente, o tempo de execução cria uma nova ocorrência Context3D e despacha outro evento context3DCreate. O aplicativo deverá recarregar todos os ativos e redefinir o estado de contexto de renderização sempre que ocorrer uma perda de dispositivo.

Planeje a lógica de seu aplicativo para tratar a possibilidade de perda de dispositivo e regeneração de contexto. Não remova o ouvinte de evento context3DCreate. Não execute ações em resposta ao evento que não deverá ser repetido no aplicativo. Por exemplo, não adicione funções anônimas para tratar eventos de cronômetro porque elas seriam duplicadas após a perda de dispositivo. Para testar a manipulação de seu aplicativo de perda de dispositivo, você poderá simular a perda de dispositivo pela chamada do método dispose() do objeto Context3D.

O seguinte exemplo ilustra como solicitar um contexto de renderização 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

Elementos da API relacionados

Solicite a criação de um objeto Context3D para essa instância Stage3D.

Antes da chamada desta função, adicione um ouvinte de evento para o evento context3DCreate. Caso contrário, o tempo de execução lançará uma exceção.

Observação importante nem caso de perda de dispositivo: a perda de dispositivo de GPU ocorre quando o hardware de GPU fica indisponível ao aplicativo. O objeto de Context3D é descartado quando o dispositivo de GPU é perdido. A perda de dispositivo de GPU poderá ocorrer por várias razões, como quando um dispositivo móvel fica sem energia de bateria ou um dispositivo de Windows vai até uma "tela de travamento." Quando a GPU torna-se disponível novamente, o tempo de execução cria uma nova ocorrência Context3D e despacha outro evento context3DCreate. O aplicativo deverá recarregar todos os ativos e redefinir o estado de contexto de renderização sempre que ocorrer uma perda de dispositivo.

Planeje a lógica de seu aplicativo para tratar a possibilidade de perda de dispositivo e regeneração de contexto. Não remova o ouvinte de evento context3DCreate. Não execute ações em resposta ao evento que não deverá ser repetido no aplicativo. Por exemplo, não adicione funções anônimas para tratar eventos de cronômetro porque elas seriam duplicadas após a perda de dispositivo. Para testar a manipulação de seu aplicativo de perda de dispositivo, você poderá simular a perda de dispositivo pela chamada do método dispose() do objeto Context3D.

O seguinte exemplo ilustra como solicitar um contexto de renderização 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

Elementos da API relacionados

Despachado quando um contexto de renderização for criado.

Elementos da API relacionados

Despachado quando houver falha em uma solicitação de contexto de renderização.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados