Paket | flash.display |
Sınıf | public class Stage3D |
Miras Alma | Stage3D EventDispatcher Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
Stage3D, Context3D
sınıfı kullanılarak oluşturulan içerik için yüksek performanslı bir oluşturma yüzeyi sağlar. Bu yüzey mümkün olduğunda grafik işleme birimini (GPU) kullanır. Çalışma zamanı sahne alanı, sabit sayıda Stage3D
nesnesi sağlar. Örnek sayısı aygıtın türüne göre değişiklik gösterir. Masaüstü bilgisayarlar genel olarak dört Stage3D örneği sağlar.
Stage3D
görünüm penceresine çizilen içerik, önceden tanımlanmış bir sırada diğer görünür grafik nesneleriyle birlikte oluşturulur. En uzak olanların tümü StageVideo
yüzeyleridir. Ardından, diğer tüm öğelerin üzerinde geleneksel Flash görüntüleme nesnesi en son oluşturulacak şekilde Stage3D
gelir. StageVideo ve Stage3D katmanları saydamlık olmadan oluşturulur. Bu nedenle görünüm penceresi, altında konumlanmış olan herhangi bir Stage3D veya StageVideo görünüm penceresini gizler. Görüntüleme listesi içeriği saydamlıkla oluşturulur.
Not: Örneğin, bir videoyu StageVideo sınıfını kullanarak oynatırken nesneyi ekrandan geçici olarak kaldırmak için Stage3D nesnesinin visible
özelliğini kullanabilirsiniz.
Player sahne alanından stage3Ds
üyesi kullanılarak bir Stage3D
nesnesi alınır. İlişkili bir oluşturma bağlamı istemek ve ekranı çalışma zamanı sahne alanına yerleştirmek için Stage3D örneğini kullanın.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
context3D : Context3D [salt okunur]
Bu Stage3D örneği ile ilişkili Context3D nesnesi | Stage3D | ||
visible : Boolean
Bu Stage3D nesnesinin görünür olup olmadığını belirtir. | Stage3D | ||
x : Number
Sahne alanındaki Stage3D görüntüsünün piksel olarak yatay koordinatı. | Stage3D | ||
y : Number
Sahne alanındaki Stage3D görüntüsünün piksel olarak dikey koordinatı. | Stage3D |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Stage3D() | Stage3D | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | EventDispatcher | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
Bu Stage3D örneği için bir Context3D nesnesi ister. | Stage3D | ||
Bu Stage3D örneği için bir Context3D nesnesi ister. | Stage3D | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object | ||
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher |
Olay | Özet | Tanımlayan: | ||
---|---|---|---|---|
[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | |||
Oluşturma bağlamı oluşturulduğunda gönderilir. | Stage3D | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
Oluşturma bağlamı isteği başarısız olduğunda gönderilir. | Stage3D |
context3D | özellik |
context3D:Context3D
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
Bu Stage3D örneği ile ilişkili Context3D nesnesi
Özellik başlangıçta null
değerine sahiptir. Bu Stage3D nesnesi için Context3D örneği oluşturmak üzere, context3DCreate
olayına bir olay dinleyicisi ekleyin ve ardından requestContext3D
yöntemini çağırın. Dinleyici, Context3D nesnesi oluşturulduktan sonra çağrılır.
Uygulama
public function get context3D():Context3D
İlgili API Öğeleri
visible | özellik |
visible:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
Bu Stage3D nesnesinin görünür olup olmadığını belirtir.
Stage3D nesnesini geçici olarak Sahne Alanı'nda saklamak için bu özelliği kullanın. Bu özellik varsayılan olaraktrue
değerini alır.
Uygulama
public function get visible():Boolean
public function set visible(value:Boolean):void
x | özellik |
x:Number
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
Sahne alanındaki Stage3D görüntüsünün piksel olarak yatay koordinatı.
Bu özellik varsayılan olarak sıfır değerini alır.
Uygulama
public function get x():Number
public function set x(value:Number):void
Atar
ArgumentError — Konum [-8191..8191] aralığı dahilinde değilse.
|
y | özellik |
y:Number
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
Sahne alanındaki Stage3D görüntüsünün piksel olarak dikey koordinatı.
Bu özellik varsayılan olarak sıfır değerini alır.
Uygulama
public function get y():Number
public function set y(value:Number):void
Atar
ArgumentError — Konum [-8191..8191] aralığı dahilinde değilse.
|
Stage3D | () | Yapıcı |
public function Stage3D()
requestContext3D | () | yöntem |
public function requestContext3D(context3DRenderMode:String = "auto", profile:String = "baseline"):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
Bu Stage3D örneği için bir Context3D nesnesi ister.
Bu işlevi çağırmadan önce context3DCreate
olayı için bir olay dinleyici ekleyin. Eklemezseniz çalışma zamanı bir istisna atar.
Aygıt kaybına ilişkin önemli not: GPU donanımı uygulamada kullanılabilir durumda olmadığında GPU aygıtı kaybı meydana gelir. GPU aygıtı kaybolduğunda Context3D nesnesi atılır. GPU aygıtı kaybı, mobil aygıtın pil gücünün bitmesi veya Windows aygıtının "kilit ekranına" geçmesi gibi nedenlerden kaynaklanır. GPU tekrar kullanılabilir duruma geldiğinde çalışma zamanı yeni bir Context3D örneği oluşturur ve başka bir context3DCreate
olayı gönderir. Her aygıt kaybı meydana gelişinde uygulamanız tüm varlıkları tekrar yüklemeli ve oluşturma bağlamı durumunu sıfırlamalıdır.
Uygulama mantığınızı aygıt kaybı olasılığını ve yeniden bağlam oluşturma işlemini işleyebilecek şekilde tasarlayın. context3DCreate
olay dinleyicisini kaldırmayın. Uygulamada tekrar edilmemesi gereken olaya karşılık olarak herhangi bir işlem uygulamayın. Örneğin, zamanlayıcı olaylarını işlemek üzere anonim işlevler eklemeyin. Bu, aygıt kaybından sonra olayların tekrar edilmesine neden olur. Uygulamanızın aygıt kaybı işlemesini test etmek için Context3D nesnesinin dispose()
yöntemini çağırarak aygıt kaybının benzetimini yapabilirsiniz.
Aşağıdaki örnek, Context3d oluşturma bağlamının nasıl istendiğini gösterir:
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 ); }
Parametreler
context3DRenderMode:String (default = "auto ") — İstenilecek oluşturma bağlamı türü. Varsayılan, mümkün olduğunda bir donanım hızlandırmalı bağlam oluşturan ve mümkün olmadığında yazılıma geri dönen Context3DRenderMode.AUTO öğesidir. Yazılımla oluşturma bağlamı istemek üzere Context3DRenderMode.SOFTWARE öğesini kullanın. Yazılımla oluşturma, mobil aygıtlarda kullanılamaz. Yazılımla oluşturma yalnızca Context3DProfile.BASELINE ve Context3DProfile.BASELINE_CONSTRAINED için kullanılabilir.
| |
profile:String (default = "baseline ") — (AIR 3.4 ve üzeri) Flash Player'ın daha alt düzey GPU'ları destekleme derecesini belirtir. Daha önceki sürümlerde kullanılan örneğe bir Context3D örneği döndüren Context3DProfile.BASELINE , varsayılan seçenektir. Tüm kullanılabilir profillerin ayrıntılarını almak için bkz. flash.display3D.Context3DProfile .
|
Olaylar
context3DCreate: — İstenen oluşturma bağlamı başarıyla tamamlandığında gönderilir.
| |
error: — İstenen oluşturma bağlamı oluşturulamadığında gönderilir.
|
Atar
Error — bu Stage3D nesnesine, context3DCreate olayı için hiçbir dinleyici eklenmediyse.
| |
ArgumentError — Bir önceki çağırma işlemi tamamlanmadan önce bu yöntem farklı bir context3DRenderMode öğesiyle tekrar çağırılırsa.
|
İlgili API Öğeleri
requestContext3DMatchingProfiles | () | yöntem |
public function requestContext3DMatchingProfiles(profiles:Vector.<String>):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 12, AIR 4 |
Bu Stage3D örneği için bir Context3D nesnesi ister.
Bu işlevi çağırmadan önce context3DCreate
olayı için bir olay dinleyici ekleyin. Eklemezseniz çalışma zamanı bir istisna atar.
Aygıt kaybına ilişkin önemli not: GPU donanımı uygulamada kullanılabilir durumda olmadığında GPU aygıtı kaybı meydana gelir. GPU aygıtı kaybolduğunda Context3D nesnesi atılır. GPU aygıtı kaybı, mobil aygıtın pil gücünün bitmesi veya Windows aygıtının "kilit ekranına" geçmesi gibi nedenlerden kaynaklanır. GPU tekrar kullanılabilir duruma geldiğinde çalışma zamanı yeni bir Context3D örneği oluşturur ve başka bir context3DCreate
olayı gönderir. Her aygıt kaybı meydana gelişinde uygulamanız tüm varlıkları tekrar yüklemeli ve oluşturma bağlamı durumunu sıfırlamalıdır.
Uygulama mantığınızı aygıt kaybı olasılığını ve yeniden bağlam oluşturma işlemini işleyebilecek şekilde tasarlayın. context3DCreate
olay dinleyicisini kaldırmayın. Uygulamada tekrar edilmemesi gereken olaya karşılık olarak herhangi bir işlem uygulamayın. Örneğin, zamanlayıcı olaylarını işlemek üzere anonim işlevler eklemeyin. Bu, aygıt kaybından sonra olayların tekrar edilmesine neden olur. Uygulamanızın aygıt kaybı işlemesini test etmek için Context3D nesnesinin dispose()
yöntemini çağırarak aygıt kaybının benzetimini yapabilirsiniz.
Aşağıdaki örnek, Context3d oluşturma bağlamının nasıl istendiğini gösterir:
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 );
Parametreler
profiles:Vector.<String> — (AIR 3.4 ve üstü) Geliştiricinin Flash programında kullanmak istediği profil dizisi. Geliştirici profil dizisini Stage3D.requestContext3DMatchingProfiles öğesine ilettiğinde, donanım özelliklerine göre dizinin içindeki yüksek seviye profiline bağlı olarak Context3D alır. Oluşturma modu AUTO olarak ayarlanmış, bu nedenle parametre atlanır.
|
Olaylar
context3DCreate: — İstenen oluşturma bağlamı başarıyla tamamlandığında gönderilir.
| |
error: — İstenen oluşturma bağlamı oluşturulamadığında gönderilir. Donanım kullanılabilir durumda değilse bir yazılım context3d öğesi oluşturmaz.
|
Atar
Error — bu Stage3D nesnesine, context3DCreate olayı için hiçbir dinleyici eklenmediyse.
| |
ArgumentError — önceki çağrı tamamlanmadan önce bu yöntem çağrılırsa.
| |
ArgumentError — dizideki öğe flash.display3D.Context3DProfile değilse.
|
İlgili API Öğeleri
context3DCreate | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.CONTEXT3D_CREATE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
Oluşturma bağlamı oluşturulduğunda gönderilir.
Event.CONTEXT3D_CREATE
sabiti bir context3Dcreate
olay nesnesinin type
özelliğinin değerini tanımlar. Bu olay yalnızca Stage3D nesneleri tarafından, Stage3D.requestContext3D öğesine yapılan bir çağrıya yanıt olarak veya Stage3D nesnesine bağlı Context3D öğesinin işletim sistemi tarafından tetiklenen yeniden başlatılmasına yanıt olarak ortaya çıkar. Yeni oluşturulmuş Context3D nesnesini almak için Stage3D.context3D özelliğini kontrol eder.
İlgili API Öğeleri
error | Olay |
flash.events.ErrorEvent
özellik ErrorEvent.type =
flash.events.ErrorEvent.ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
Oluşturma bağlamı isteği başarısız olduğunda gönderilir.
Birerror
olay nesnesinin type
özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Ağ işlemi arızası yaşayan nesne. |
text | Hata mesajı olarak gösterilecek metin. |
İlgili API Öğeleri
Tue Jun 12 2018, 01:09 PM Z