IFlexDisplayObject  - AS3 Flex

Bu görüntüleme nesnesi için geçerli erişilebilirlik seçenekleri. accessibilityProperties özelliğini veya accessibilityProperties içindeki alanlardan herhangi birini değiştirirseniz, değişikliklerinizin etkili olması için Accessibility.updateProperties() yöntemini çağırmanız gerekir.

Not: Flash geliştirme ortamında oluşturulan bir nesne için, accessibilityProperties öğesi, Accessibility paneline o nesneyle ilgili girdiğiniz tüm bilgilerle önceden doldurulur.

Belirtilen nesnenin alfa saydamlık değerini gösterir. Geçerli değerler 0 (tam saydam) ile 1 (tam opak) şeklindedir. Varsayılan değer 1'dir. alpha özelliği 0 olarak ayarlanmış görüntüleme nesneleri görünmez olsa da etkindir.

Hangi karışım modunun kullanılacağını belirten bir BlendMode sınıfı değeri. Bir bitmap dahili olarak iki şekilde çizilebilir. Etkin bir karışım modu veya harici bir kırpma maskesi varsa, vektör oluşturucuya bitmap dolgulu bir kare şekli eklenerek bitmap çizilir. Bu özelliği geçersiz bir değere ayarlamaya çalışırsanız, Flash çalışma zamanları bu değeri BlendMode.NORMAL olarak ayarlar.

blendMode özelliği, görüntüleme nesnesinin her pikselini etkiler. Her piksel üç renkten (kırmızı, yeşil ve mavi) oluşur ve pikseli oluşturan her renk 0x00 ile 0xFF arasında bir değere sahiptir. Flash Player veya Adobe AIR, film klibindeki bir pikseli oluşturan her bir rengi arka plandaki pikselin karşılık gelen rengiyle karşılaştırır. Örneğin, blendMode öğesi BlendMode.LIGHTEN olarak ayarlanırsa, Flash Player veya Adobe AIR, görüntüleme nesnesinin kırmızı değerini arka planın kırmızı değeriyle karşılaştırır ve bunlardan daha açık renkli olanını görüntülenen rengin kırmızı bileşeninin değeri olarak kullanır.

Şu tablo blendMode ayarlarını açıklar. BlendMode sınıfı, kullanabileceğiniz dize değerlerini tanımlar. Tablodaki resimler, bir görüntüleme nesnesinin (1) üzerine eklenmiş dairesel bir görüntüleme nesnesine (2) uygulanan blendMode değerlerini gösterir.

BlendMode Sabiti	Resim	Açıklama
BlendMode.NORMAL		Görüntüleme nesnesi arka planın önünde görüntülenir. Görüntüleme nesnesinin piksel değerleri, arka planın piksel değerlerini geçersiz kılar. Görüntüleme nesnesi saydam olduğunda arka plan görünebilir.
BlendMode.LAYER		Görüntüleme nesnesi için bir saydamlık grubu oluşturmaya zorlar. Başka bir deyişle, görüntüleme nesnesi, daha fazla işlenmeden önce geçici bir arabellekte önceden oluşturulur. Bitmap önbelleğe alma yoluyla görüntüleme nesnesi önceden önbelleğe alınırsa veya görüntüleme nesnesi, BlendMode.NORMAL dışında bir blendMode ayarına sahip en az bir alt nesne içeren bir görüntüleme nesnesi kabıysa, bu işlem otomatik olarak yapılır. GPU görüntü oluşturma altında desteklenmez.
BlendMode.MULTIPLY		Görüntüleme nesnesini oluşturan renkleri arka plan rengini oluşturan renkler ile çarpar ve 0xFF ile bölerek normalleştirir, sonuçta daha koyu renkler elde eder. Bu ayar, gölgeler ve derinlik efektleri için yaygın olarak kullanılır. Örneğin görüntüleme nesnesinde bir pikseli oluşturan renk (örn. kırmızı) ile arka plandaki pikselin karşılık gelen rengin ikisi de 0x88 değerine sahipse, çarpma sonucu 0x4840 olur. 0xFF ile bölünmesi, o oluşturan renk için 0x48 değerini verir ve bu da görüntüleme nesnesinin renginden veya arka plan renginden daha koyu bir gölge sağlar.
BlendMode.SCREEN		Görüntüleme nesnesi renginin tamlayanını (tersini) arka plan renginin tamlayanı ile çarpar, sonuçta bir renk açma efekti elde edilir. Bu ayar, vurgular için veya görüntüleme nesnesinin siyah alanlarını kaldırmak için yaygın olarak kullanılır.
BlendMode.LIGHTEN		Görüntüleme nesnesini oluşturan renklerden ve arka plan renginden daha açık olanını (daha büyük değerli renkler) seçer. Bu ayar, yaygın olarak üzerine ekleme türü için kullanılır. Örneğin görüntüleme nesnesinin 0xFFCC33 RGB değerine sahip bir pikseli ve 0xDDF800 RGB değerine sahip arka plan pikseli varsa, görüntülenen pikselin sonuç RGB değeri, 0xFFF833 olur (0xFF > 0xDD, 0xCC < 0xF8 ve 0x33 > 0x00 = 33 olması nedeniyle). GPU görüntü oluşturma altında desteklenmez.
BlendMode.DARKEN		Görüntüleme nesnesini oluşturan renklerden ve arka plan renklerinden daha koyu olanını (daha küçük değerli renkler) seçer. Bu ayar, yaygın olarak üzerine ekleme türü için kullanılır. Örneğin görüntüleme nesnesinin 0xFFCC33 RGB değerine sahip bir pikseli ve 0xDDF800 RGB değerine sahip arka plan pikseli varsa, görüntülenen pikselin sonuç RGB değeri, 0xDDCC00 olur (0xFF > 0xDD, 0xCC < 0xF8 ve 0x33 > 0x00 = 33 olması nedeniyle). GPU görüntü oluşturma altında desteklenmez.
BlendMode.DIFFERENCE		Görüntüleme nesnesini oluşturan renkleri arka planının renkleri ile karşılaştırır ve oluşturan iki renkten daha koyu olanın değerlerini daha açık olanın değerinden çıkarır. Bu ayar yaygın olarak daha canlı renkler için kullanılır. Örneğin görüntüleme nesnesinin 0xFFCC33 RGB değerine sahip bir pikseli ve 0xDDF800 RGB değerine sahip arka plan pikseli varsa, görüntülenen pikselin sonuç RGB değeri, 0x222C33 olur (0xFF - 0xDD = 0x22, 0xF8 - 0xCC = 0x2C ve 0x33 - 0x00 = 0x33 olması nedeniyle).
BlendMode.ADD		Görüntüleme nesnesini oluşturan renklerin değerlerini, 0xFF düzeyinde bir tavan uygulayarak arka planının renklerine ekler. Bu ayar, yaygın olarak iki nesne arasında bir açıklaştırma erimesi animasyonu için kullanılır. Örneğin görüntüleme nesnesinin 0xAAA633 RGB değerine sahip bir pikseli ve 0xDD2200 RGB değerine sahip arka plan pikseli varsa, görüntülenen pikselin sonuç RGB değeri, 0xFFC833 olur (0xAA + 0xDD > 0xFF, 0xA6 + 0x22 = 0xC8 ve 0x33 + 0x00 = 0x33 olması nedeniyle).
BlendMode.SUBTRACT		Görüntüleme nesnesini oluşturan renklerin değerlerini arka plan renginin değerinden çıkarır ve 0 tabanını uygular. Bu ayar, yaygın olarak iki nesne arasında bir koyulaştırma erimesi animasyonu için kullanılır. Örneğin görüntüleme nesnesinin 0xAA2233 RGB değerine sahip bir pikseli ve 0xDDA600 RGB değerine sahip arka plan pikseli varsa, görüntülenen pikselin sonuç RGB değeri, 0x338400 olur (0xDD - 0xAA = 0x33, 0xA6 - 0x22 = 0x84 ve 0x00 - 0x33 < 0x00 olması nedeniyle).
BlendMode.INVERT		Arka planı ters çevirir.
BlendMode.ALPHA		Ekran nesnesinin her pikselinin alfa değerini arka plana uygular. Bunun için, üst görüntüleme nesnesinin blendMode ayarının BlendMode.LAYER olarak ayarlanması gerekir. Örneğin, resimde, beyaz arka plan olan üst görüntüleme nesnesi blendMode = BlendMode.LAYER öğesine sahiptir. GPU görüntü oluşturma altında desteklenmez.
BlendMode.ERASE		Arka planı, ekran nesnesinin alfa değerini esas alarak siler. Bunun için, üst görüntüleme nesnesinin blendMode öğesinin BlendMode.LAYER olarak ayarlanması gerekir. Örneğin, resimde, beyaz arka plan olan üst görüntüleme nesnesi blendMode = BlendMode.LAYER öğesine sahiptir. GPU görüntü oluşturma altında desteklenmez.
BlendMode.OVERLAY		Arka planın koyuluğunu esas alarak her pikselin rengini ayarlar. Arka plan, %50 griden daha açıksa, görüntüleme nesnesi ve arka plan renkleri taranır ve sonucunda daha açık renk elde edilir. Arka plan %50 griden daha koyuysa, renkler çarpılır ve sonucunda daha koyu renk elde edilir. Bu ayar, yaygın olarak gölgelendirme efektleri için kullanılır. GPU görüntü oluşturma altında desteklenmez.
BlendMode.HARDLIGHT		Görüntüleme nesnesinin koyuluğunu esas alarak her pikselin rengini ayarlar. Görüntüleme nesnesi %50 griden daha açıksa, görüntüleme nesnesi ve arka plan renkleri taranır ve sonucunda daha açık renk elde edilir. Görüntüleme nesnesi %50 griden daha koyuysa, renkler çarpılır ve sonucunda daha koyu renk elde edilir. Bu ayar, yaygın olarak gölgelendirme efektleri için kullanılır. GPU görüntü oluşturma altında desteklenmez.
BlendMode.SHADER	Yok	Özel bir gölgelendirici yordamı kullanarak rengi ayarlar. Kullanılan gölgelendirici, blendShader özelliğine atanan Shader örneği olarak belirtilir. Görüntüleme nesnesinin blendShader özelliğinin bir Shader örneğine ayarlanması, görüntüleme nesnesinin blendMode özelliğini otomatik olarak BlendMode.SHADER değerine ayarlar. İlk önce blendShader özelliği ayarlanmadan blendMode özelliği BlendMode.SHADER olarak ayarlanırsa, bunun yerine blendMode özelliği BlendMode.NORMAL olarak ayarlanır. GPU görüntü oluşturma altında desteklenmez.

true olarak ayarlanırsa, Flash çalışma zamanları, görüntüleme nesnesinin dahili bir bitmap temsilini önbelleğe alır. Bu önbelleğe alma işlemi, karmaşık vektör içeriği barındıran görüntüleme nesnelerinin performansını artırabilir.

Önbelleğe alınan bitmap'i olan bir görüntüleme nesnesinin tüm vektör verisi, ana görüntü yerine bitmap'e çizilir. cacheAsBitmapMatrix null değerindeyse veya desteklenmiyorsa, bitmap en yakın piksel sınırlarıyla kırpılmış uzatılmamış ve döndürülmemiş pikseller olarak ana ekrana kopyalanır. Pikseller üst nesneyle bire bir eşleştirilir. Bitmap'in sınırları değişirse, bitmap uzatılmak yerine yeniden oluşturulur.

cacheAsBitmapMatrix null değilse ve destekleniyorsa, nesne bu matris kullanılarak ekran dışı bitmap'e çekilir ve bu oluşumun uzatılan ve/veya döndürülen sonuçları, nesnenin ana ekrana çekilmesi için kullanılır.

cacheAsBitmap özelliği true değerine ayarlanmazsa, herhangi bir dahili bitmap oluşturulmaz.

Siz cacheAsBitmap özelliğini true değerine ayarladıktan sonra, oluşturma değişmez ancak görüntüleme nesnesi otomatik olarak piksel bitiştirme işlemini gerçekleştirir. Vektör içeriğinin karmaşıklığına bağlı olarak, animasyon hızı çok daha yüksek olabilir.

Bir görüntüleme nesnesine her filtre uyguladığınızda (filter dizisi boş olmadığında) cacheAsBitmap özelliği otomatik olarak true değerine ayarlanır ve bu görüntüleme nesnesine bir filtre uygulanmışsa, özelliği false değerine ayarlasanız da o görüntüleme nesnesi için cacheAsBitmap true olarak bildirilir. Görüntüleme nesnesinin tüm filtrelerini temizlerseniz, cacheAsBitmap ayarı en son ayarlandığı değere geçer.

cacheAsBitmap özelliği true değerine ayarlansa da, görüntüleme nesnesi bir bitmap kullanmaz ve bunun yerine şu durumlarda vektör verilerinden bitmap oluşturur:

• Bitmap çok büyük. AIR 1.5 ve Flash Player 10'da, bir bitmap görüntüsü için maksimum boyut genişlik ve yükseklikte 8.191 pikseldir ve toplam piksel sayısı 16.777.215'i geçemez. (Bu nedenle, bir bitmap görüntüsü 8.191 piksel genişliğindeyse en fazla 2.048 piksel yüksekliğinde olabilir.) Flash Player 9 ve daha önceki sürümlerde, sınırlama yükseklikte ve genişlikte 2880 pikseldir.
• Bitmap bellek ayırmayı başaramazsa (yetersiz bellek hatası).

cacheAsBitmap özelliği, daha çok statik içeriğe sahip olan ve sık sık ölçeklenmeyen ve döndürülmeyen film klipleriyle en iyi şekilde kullanılır. Böyle film kliplerinde cacheAsBitmap, film klibi çevrildiğinde (x ve y konumu değiştiğinde) performans artışı sağlar.

Geçerli olarak görüntüleme nesnesiyle ilişkilendirilmiş her filtre nesnesini içeren dizinli bir dizi. flash.filters paketi, kullanabileceğiniz belirli filtreleri tanımlayan birçok sınıfı içerir.

Filtreler, ActionScript kodu kullanılarak tasarım süresinde veya çalışma zamanında Flash Professional'da uygulanabilir. ActionScript kullanarak bir filtre uygulamak için, tüm filters dizisinin geçici bir kopyasını yapmanız, geçici diziyi değiştirmeniz ve sonra geçici dizinin değerini geri filters dizisine atamanız gerekir. filters dizisine yeni bir filtre nesnesini doğrudan ekleyemezsiniz.

ActionScript kullanarak bir filtre eklemek için şu adımları uygulayın (hedef görüntüleme nesnesinin myDisplayObject adında olduğu varsayılarak):

1. Seçtiğiniz filter sınıfının yapıcı yöntemini kullanarak yeni bir filtre nesnesi oluşturun.
2. myFilters adındaki gibi geçici bir diziye myDisplayObject.filters dizisinin değerini atayın.
3. Yeni filtre nesnesini myFilters geçici dizisine ekleyin.
4. Geçici dizinin değerini myDisplayObject.filters dizisine atayın.

filters dizisi tanımsızsa, geçici bir dizi kullanmanız gerekmez. Bunun yerine, oluşturduğunuz bir veya birkaç filtre nesnesini içeren bir değişmez diziyi doğrudan atayabilirsiniz. Örnekler bölümündeki birinci örnek, hem tanımlı hem de tanımsız filters dizilerini işleyen kodu kullanarak bir gölge filtresi ekler.

Mevcut bir filtre nesnesini değiştirmek için, filters dizisinin bir kopyasını değiştirme tekniğini kullanmanız gerekir:

1. myFilters adındaki gibi geçici bir diziye filters dizisinin değerini atayın.
2. Geçici diziyi (myFilters) kullanarak özelliği değiştirin. Örneğin, dizideki birinci filtrenin quality özelliğini ayarlamak için şu kodu kullanabilirsiniz: myFilters[0].quality = 1;
3. Geçici dizinin değerini filters dizisine atayın.

Yükleme süresinde, bir görüntüleme nesnesinin ilişkilendirilmiş bir filtresi varsa, bu, saydam bir bitmap olarak önbelleğe alınması için işaretlenir. Bu noktadan sonra, görüntüleme nesnesinin geçerli bir filtre listesi olduğu sürece oynatıcı, görüntüleme nesnesini bir bitmap olarak önbelleğe alır. Bu kaynak bitmap'i, filtre efektleri için kaynak görüntü olarak kullanılır. Genellikle her görüntüleme nesnesinin iki bitmap'i vardır: biri orijinal filtrelenmemiş kaynak görüntüleme nesnesi ve diğeri filtrelemeden sonraki görüntü içindir. Oluşturma sırasında kullanılan son görüntü. Görüntüleme nesnesi değişmediği sürece, son görüntünün güncellenmesi gerekmez.

flash.filters paketi, filtreler için sınırları içerir. Örneğin, bir DropShadow filtresi oluşturmak için şu yazılır:

     import flash.filters.DropShadowFilter
     var myFilter:DropShadowFilter = new DropShadowFilter (distance, angle, color, alpha, blurX, blurY, quality, inner, knockout)
     

filter dizisindeki her dizin konumuna atanan filtre türünü belirlemek için is operatörünü kullanabilirsiniz. Örneğin, şu kod, bir DropShadowFilter olan filters dizisinde birinci filtrenin konumunun nasıl belirleneceğini gösterir:

     import flash.text.TextField;
     import flash.filters.*;
     var tf:TextField = new TextField();
     var filter1:DropShadowFilter = new DropShadowFilter();
     var filter2:GradientGlowFilter = new GradientGlowFilter();
     tf.filters = [filter1, filter2];
     
     tf.text = "DropShadow index: " + filterPosition(tf, DropShadowFilter).toString(); // 0
     addChild(tf)
     
     function filterPosition(displayObject:DisplayObject, filterClass:Class):int {
         for (var i:uint = 0; i < displayObject.filters.length; i++) {
             if (displayObject.filters[i] is filterClass) {
                 return i;
             }
         }
         return -1;
     }
     

Not: DisplayObject.filters dizisine doğrudan yeni bir filtre ekleyemeyeceğiniz için, şu kodun myDisplayObject adındaki hedef görüntüleme nesnesi üzerinde herhangi bir etkisi yoktur:

     myDisplayObject.filters.push(myDropShadow);
     

Görüntüleme nesnesinin yüksekliğini, piksel cinsinden belirtir. Yükseklik, görüntüleme nesnesi içeriğinin sınırları esas alınarak hesaplanır. height özelliğini ayarladığınızda, şu kodda gösterildiği gibi scaleY özelliği de uygun şekilde ayarlanır:

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleY) // 1;
    rect.height = 200;
    trace(rect.scaleY) // 2;

TextField ve Video nesneleri dışında, içeriği olmayan bir görüntüleme nesnesinin (örn. boş bir hareketli grafik) height öğesini farklı bir değere ayarlasanız da, bu nesnenin yüksekliği 0 olur.

Bu görüntüleme nesnesinin ait olduğu dosyayı yükleme hakkında bilgi içeren bir LoaderInfo nesnesi döndürür. loaderInfo özelliği yalnızca bir SWF dosyasının kök görüntüleme nesnesi için veya yüklü bir Bitmap için (ActionScript ile çizilen bir Bitmap için değil) tanımlanır. myDisplayObject adındaki bir görüntüleme nesnesini içeren SWF dosyasıyla ilişkilendirilmiş loaderInfo nesnesini bulmak için, myDisplayObject.root.loaderInfo öğesini kullanın.

Büyük bir SWF dosyası, this.root.loaderInfo.addEventListener(Event.COMPLETE, func) öğesini çağırarak indirme işlemini izleyebilir.

Çağıran görüntüleme nesnesi belirtilen mask nesnesiyle maskelenir. Sahne Alanı ölçeklendiğinde maskelemenin çalışmasını sağlamak için, mask görüntüleme nesnesi, görüntüleme listesinin etkin bir bölümünde olmalıdır. mask nesnesi çizilmez. Maskeyi kaldırmak için mask öğesini null değerine ayarlayın.

Bir mask nesnesinin ölçeklenebilmesi için görüntüleme listesinde olması gerekir. Bir mask Sprite nesnesinin sürüklenebilmesi için (startDrag() yöntemi çağrılarak) görüntüleme listesinde olması gerekir. Hareketli grafiğin göndermekte olduğu mouseDown olayı esas alınarak bir maske hareketli grafiği için startDrag() yöntemini çağırmak üzere hareketli grafiğin buttonMode özelliğini true değerine ayarlayın.

Görüntüleme nesneleri cacheAsBitmap özelliği true olarak ve cacheAsBitmapMatrix özelliği Matrix nesnesi olarak ayarlanarak önbelleğe alındıklarında, maskelenen maske ve görüntüleme nesnesi önbelleğe alınan aynı bitmap'in parçası olmalıdır. Bu nedenle, görüntüleme nesnesi önbelleğe alınırsa, maske görüntüleme nesnesinin alt öğesi olmalıdır. Görüntüleme nesnesinin üst öğesi görüntüleme listesinde önbelleğe alınırsa, maske bu üst öğenin veya bu öğenin alt öğelerinden birinin alt öğesi olmalıdır. Maskelenen nesnenin birden fazla üst öğesi önbelleğe alınırsa, maske, görüntüleme listesindeki maskelenmiş nesneye en yakın olan önbelleğe alınmış kabın alt öğesi olmalıdır.

Not: Birden çok çağıran görüntüleme nesnesini maskelemek için tek bir mask nesnesi kullanılamaz. mask ikinci bir görüntüleme nesnesine atandığında, birinci nesnenin maskesi olarak kaldırılır ve o nesnenin mask özelliği null olur.

The measured height of this object.

This is typically hard-coded for graphical skins because this number is simply the number of pixels in the graphic. For code skins, it can also be hard-coded if you expect to be drawn at a certain size. If your size can change based on properties, you may want to also be an ILayoutManagerClient so a measure() method will be called at an appropriate time, giving you an opportunity to compute a measuredHeight.

The measured width of this object.

This is typically hard-coded for graphical skins because this number is simply the number of pixels in the graphic. For code skins, it can also be hard-coded if you expect to be drawn at a certain size. If your size can change based on properties, you may want to also be an ILayoutManagerClient so a measure() method will be called at an appropriate time, giving you an opportunity to compute a measuredHeight.

Farenin veya kullanıcı girdi aygıtı konumunun x koordinatını piksel olarak belirtir.

Not: Döndürülmüş bir DisplayObject için, döndürülmüş x koordinatı, döndürülmemiş nesneyi yansıtır.

Farenin veya kullanıcı girdi aygıtı konumunun y koordinatını piksel olarak belirtir.

Not: Döndürülmüş bir DisplayObject için, döndürülmüş y koordinatı, döndürülmemiş nesneyi yansıtır.

DisplayObject öğesinin örnek adını belirtir. Görüntüleme nesnesi kabının getChildByName() yöntemi çağrılarak nesne, üst görüntüleme nesnesi kabının alt öğe listesinde tanımlanabilir.

Görüntüleme nesnesinin belirli bir arka plan rengiyle opak olup olmadığını belirtir. Saydam bir bitmap, alfa kanalı verilerini içerir ve saydam şekilde çizilir. Opak bir bitmap, alfa kanalı içermez (ve saydam bir bitmap'ten daha hızlı oluşturur). Bitmap opaksa, kullanmak için kendi arka plan rengini belirtirsiniz.

Bir sayı değerine ayarlanırsa, yüzey sayının belirttiği RGB arka plan rengiyle opak olur (saydam değil). null değerine (varsayılan değer) ayarlanırsa, görüntüleme nesnesinin saydam arka planı olur.

opaqueBackground özelliği, oluşturma işlemini en iyileştirmek için daha çok cacheAsBitmap özelliğiyle kullanılmak üzere tasarlanmıştır. cacheAsBitmap özelliğinin true değerine ayarlandığı görüntüleme nesneleri için, opaqueBackground öğesinin ayarlanması, oluşturma performansını artırabilir.

shapeFlag parametresi true değerine ayarlanmış durumdayken hitTestPoint() yöntemi çağrıldığında, opak arka plan bölgesi eşleşmez.

Opak arka plan bölgesi, mouse olaylarına tepki vermez.

Bu görüntüleme nesnesini içeren DisplayObjectContainer nesnesini belirtir. Görüntüleme listesi hiyerarşisinde geçerli görüntüleme nesnesinin yukarısındaki görüntüleme nesnelerine göre bir yol belirtmek için parent özelliğini kullanın.

Aşağıda belirtildiği gibi görüntüleme listesinde birden çok düzey yukarı çıkmak için parent öğesini kullanabilirsiniz:

     this.parent.parent.alpha = 20;
     

Yüklü bir SWF dosyasındaki bir görüntüleme nesnesi için root özelliği, görüntüleme listesi ağaç yapısının o SWF dosyası tarafından temsil edilen kısmındaki en üst görüntüleme nesnesidir. Yüklü bir görüntüyü temsil eden bir Bitmap nesnesi için root özelliği, Bitmap nesnesinin kendisidir. Yüklü birinci SWF dosyasının ana sınıfı örneği için, root özelliği, görüntüleme nesnesinin kendisidir. Stage nesnesinin root özelliği, Stage nesnesinin kendisidir. Görüntüleme listesine eklenmemiş bir görüntüleme nesnesi, görüntüleme listesi dışında olan ancak yüklü bir SWF dosyasındaki en üst görüntüleme nesnesinin alt öğesi olan bir görüntüleme nesnesi kabına eklenmediyse, o görüntüleme nesnesi için root özelliği null değerine ayarlanır.

Örneğin, Sprite() yapıcı yöntemini çağırarak yeni bir Sprite nesnesi oluşturursanız, siz nesneyi görüntüleme listesine (veya görüntüleme listesi dışında olan ancak yüklü bir SWF dosyasındaki en üst görüntüleme nesnesinin alt öğesi olan bir görüntüleme nesnesi kabına) ekleyinceye kadar bu nesnenin root özelliği null olur.

Yüklü bir SWF dosyası söz konusu olduğunda, dosyayı yüklemek için kullanılan Loader nesnesi görüntüleme listesinde olmayabilse de, SWF dosyasındaki en üst görüntüleme nesnesinin root özelliği kendisine ayarlıdır. Loader nesnesi root özelliğinin ayarlandığı görüntüleme nesnesinin bir alt öğesi olarak ekleninceye kadar, Loader nesnesinin root özelliği ayarlanmaz.

DisplayObject örneğinin başlangıç yönlendirmesinden itibaren döndürülmesini derece olarak belirtir. 0 ile 180 arasındaki değerler saat yönünde dönüşü temsil eder; 0 ile -180 arasındaki değerler saatin ters yönünde dönüşü temsil eder. Aralık içinde bir değer elde etmek için, bu aralık dışındaki değerler, 360'a eklenir veya 360'tan çıkarılır. Örneğin, my_video.rotation = 450 deyimi my_video.rotation = 90 ile aynıdır.

Etkin durumdaki geçerli ölçekleme ızgarası. null değerine ayarlanırsa, herhangi bir ölçek dönüşümü uygulandığında görüntüleme nesnesinin tamamı normal şekilde ölçeklenir.

scale9Grid özelliğini tanımladığınızda, görüntüleme nesnesi, ızgaranın merkez bölgesini tanımlayan scale9Grid dikdörtgenini esas alarak dokuz bölgeli bir ızgaraya bölünür. Izgaranın diğer sekiz bölgesini şu alanlar oluşturur:

• Dikdörtgenin sol üst köşesinin dış kısmı
• Dikdörtgenin yukarısındaki alan
• Dikdörtgenin sağ üst köşesinin dış kısmı
• Dikdörtgenin solundaki alan
• Dikdörtgenin sağındaki alan
• Dikdörtgenin sol alt köşesinin dış kısmı
• Dikdörtgenin aşağısındaki alan
• Dikdörtgenin sağ alt köşesinin dış kısmı

Merkez bölgenin (dikdörtgenin tanımladığı) dışındaki sekiz bölgeyi, ölçeklendiğinde özel kurallar uygulanan bir resim gibi düşünebilirsiniz.

scale9Grid özelliği ayarlandığında ve bir görüntüleme nesnesi ölçeklendiğinde, tüm metin ve degradeler normal şekilde ölçeklenir; ancak başka nesne türleri için şu kurallar geçerlidir:

• Merkezdeki içerik normal şekilde ölçeklenir.
• Köşelerdeki içerik ölçeklenmez.
• Üst ve alt bölgelerdeki içerik yalnızca yatay olarak ölçeklenir. Sol ve sağ bölgelerdeki içerik yalnızca dikey olarak ölçeklenir.
• Tüm dolgular (bitmap'ler, video ve degradeler), şekillerine sığacak şekilde uzatılır.

Bir görüntüleme nesnesi döndürülürse, sonraki tüm ölçeklemeler normaldir (ve scale9Grid özelliği yok sayılır).

Örneğin, şu görüntüleme nesnesini ve görüntüleme nesnesinin scale9Grid öğesi olarak uygulanan bir dikdörtgeni göz önünde bulundurun:

Görüntüleme nesnesi.

Kırmızı dikdörtgen scale9Grid öğesini gösterir.

Görüntüleme nesnesi ölçeklendiğinde veya uzatıldığında, dikdörtgenin içindeki nesneler normal şekilde ölçeklenir ancak dikdörtgenin dışındaki nesneler scale9Grid kurallarına göre ölçeklenir:

%75 değerine ölçekli:
%50 değerine ölçekli:
%25 değerine ölçekli:
Yatay olarak %150 uzatılmış:

scale9Grid öğesinin ayarlanması yaygın olarak, ölçeklendiğinde kenar bölgeleri aynı genişlikte kalacak ve bileşen olarak kullanılacak bir görüntüleme nesnesini kurmakta kullanılır.

Nesnenin, kayıt noktasından itibaren uygulandığı haliyle yatay ölçeğini (percentage) belirtir. Varsayılan kayıt noktası (0,0) olur. 1,0, %100 ölçeğe eşittir.

Yerel koordinat sisteminin ölçeklemesi, bütün pikseller olarak tanımlanan x ve y özelliği değerlerini değiştirir.

Nesnenin kayıt noktasından itibaren uygulandığı haliyle nesnenin dikey ölçeğini (percentage) belirtir. Varsayılan kayıt noktası (0,0) olur. 1,0; %100 ölçektir.

Yerel koordinat sisteminin ölçeklemesi, bütün pikseller olarak tanımlanan x ve y özelliği değerlerini değiştirir.

Görüntüleme nesnesinin kaydırma dikdörtgeni sınırları. scrollRect nesnesinin x ve y özelliklerini değiştirdiğinizde, görüntüleme nesnesi, dikdörtgenin tanımladığı boyuta kırpılır ve dikdörtgen içinde gezinir.

scrollRect Rectangle nesnesinin özellikleri, görüntüleme nesnesinin koordinat alanını kullanır ve genel görüntüleme nesnesi gibi ölçeklenir. Kaydırma görüntüleme nesnesindeki kırpılan pencerenin köşe sınırları, görüntüleme nesnesinin başlangıç konumu (0,0) ve dikdörtgenin genişlik ve yüksekliğiyle tanımlanan noktadır. Bunlar başlangıç noktasında ortalanmaz ancak alanın sol üst köşesini tanımlamak için başlangıç noktasını kullanır. Kaydırılan bir görüntüleme nesnesi her zaman bütün piksellik artışlarda kaydırılır.

scrollRect Rectangle nesnesinin x özelliğini ayarlayarak bir nesneyi sola ve sağa kaydırabilirsiniz. scrollRect Rectangle nesnesinin y özelliğini ayarlayarak bir nesneyi yukarı ve aşağı kaydırabilirsiniz. Görüntüleme nesnesi 90° döndürülür ve bu nesneyi sola ve sağa kaydırırsanız, görüntüleme nesnesi gerçekten yukarı ve aşağı kaydırılır.

scrollRect özelliğinde yapılan değişikliklerin yalnızca nesne oluşturulduğunda işlendiğini unutmayın. Bu nedenle, localToGlobal gibi yöntemler, scrollRect değiştirildikten hemen sonra çağrıldığında beklenen sonucu vermeyebilir.

Not: Flash Player 11.4/AIR 3.4'ten itibaren, dikdörtgenin genişliğinin veya yüksekliğinin negatif değerleri 0 olarak değiştirildi.

Görüntüleme nesnesinin Sahne Alanı. Bir Flash çalışma zamanı uygulamasının yalnızca bir Stage nesnesi vardır. Örneğin, birden çok görüntüleme nesnesi oluşturup görüntüleme listesine ekleyebilirsiniz ve her görüntüleme nesnesinin stage özelliği aynı Stage nesnesini ifade eder (görüntüleme nesnesi yüklü bir SWF dosyasına ait olsa da).

Bir görüntüleme nesnesi görüntüleme listesine eklenmezse, o nesnenin stage özelliği null değerine ayarlanır.

Bir görüntüleme nesnesinin matrisi, renk dönüşümü ve piksel sınırları ile ilgili özellikleri olan bir nesne. Belirli özellikler — matrix, colorTransform ve üç salt okunur özellikler (concatenatedMatrix, concatenatedColorTransform ve pixelBounds) — Transform sınıfının girişinde açıklanır.

transform nesnesinin özelliklerinin her biri nesnedir. matrix veya colorTransform nesneleri için yeni değerler ayarlamanın tek yolu yeni bir nesne oluşturup o nesneyi transform.matrix ya da transform.colorTransform özelliğine kopyalamak olduğu için bu kavram önemlidir.

Örneğin, bir görüntüleme nesnesi matrisinin tx değerini artırmak için, matris nesnesinin tamamının bir kopyasını yapmanız ve sonra yeni nesneyi transform nesnesinin matrix özelliğine kopyalamanız gerekir:

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

tx özelliğini doğrudan ayarlayamazsınız. Şu kodun myDisplayObject üzerinde herhangi bir etkisi yoktur:

    myDisplayObject.transform.matrix.tx += 10;
    

Bir transform nesnesinin tamamını kopyalayıp başka bir görüntüleme nesnesinin transform özelliğine de atayabilirsiniz. Örneğin, şu kod myOldDisplayObj öğesindeki transform nesnesinin tamamını myNewDisplayObj öğesine kopyalar:

Sonuçta elde edilen görüntüleme nesnesi (myNewDisplayObj) şimdi eski görüntüleme nesnesiyle (myOldDisplayObj) aynı matris, renk dönüşümü ve piksel sınırları değerlerine sahip olur.

AIR for TV aygıtlarının, renk dönüştürmeleri için, mevcut olması halinde otomatik olarak donanım hızlandırma kullandığını unutmayın.

Görüntüleme nesnesinin görünür olup olmadığı. Görünür olmayan görüntüleme nesneleri devre dışı bırakılır. Örneğin, bir InteractiveObject örneği için visible=false olursa, bu nesne tıklatılamaz.

Görüntüleme nesnesinin genişliğini, piksel cinsinden belirtir. Genişlik, görüntüleme nesnesi içeriğinin sınırları esas alınarak hesaplanır. width özelliğini ayarladığınızda, şu kodda gösterildiği gibi scaleX özelliği de uygun şekilde ayarlanır:

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleX) // 1;
    rect.width = 200;
    trace(rect.scaleX) // 2;

TextField ve Video nesneleri dışında, içeriği olmayan bir görüntüleme nesnesinin (örn. boş bir hareketli grafik) width öğesini farklı bir değere ayarlasanız da, bu nesnenin genişliği 0 olur.

DisplayObject örneğinin DisplayObjectContainer üst öğesinin yerel koordinatlarına göre x koordinatını belirtir. Nesne, dönüşümler içeren bir DisplayObjectContainer içindeyse, çevreleyen DisplayObjectContainer öğesinin yerel koordinat sistemi içindedir. Böylece, 90° saatin ters yönünde döndürülmüş bir DisplayObjectContainer için, DisplayObjectContainer'ın alt öğeleri, 90° saatin ters yönünde döndürülmüş bir koordinat sistemini miras alır. Nesnenin koordinatları, kayıt noktası konumunu ifade eder.

DisplayObject örneğinin DisplayObjectContainer üst öğesinin yerel koordinatlarına göre y koordinatını belirtir. Nesne, dönüşümler içeren bir DisplayObjectContainer içindeyse, çevreleyen DisplayObjectContainer öğesinin yerel koordinat sistemi içindedir. Böylece, 90° saatin ters yönünde döndürülmüş bir DisplayObjectContainer için, DisplayObjectContainer'ın alt öğeleri, 90° saatin ters yönünde döndürülmüş bir koordinat sistemini miras alır. Nesnenin koordinatları, kayıt noktası konumunu ifade eder.

Görüntüleme nesnesinin alanını targetCoordinateSpace nesnesinin koordinat sistemine göre tanımlayan bir dikdörtgen döndürür. Döndürülen dikdörtgenin, yönteme ilettiğiniz targetCoordinateSpace parametresine bağlı olarak nasıl değişebileceğini gösteren şu kodu göz önünde bulundurun:

     var container:Sprite = new Sprite();
     container.x = 100;
     container.y = 100;
     this.addChild(container);
     var contents:Shape = new Shape();
     contents.graphics.drawCircle(0,0,100);
     container.addChild(contents);
     trace(contents.getBounds(container));
      // (x=-100, y=-100, w=200, h=200)
     trace(contents.getBounds(this));
      // (x=0, y=0, w=200, h=200)
     

Not: Görüntüleme nesnesinin yerel koordinatlarını görüntüleme koordinatlarına dönüştürmek için localToGlobal() yöntemini veya görüntüleme koordinatlarını yerel koordinatlara dönüştürmek için globalToLocal() yöntemini kullanın.

getBounds() yöntemi getRect() yöntemine benzer; ancak getBounds() yönteminin döndürdüğü Rectangle içindeki şekillerde konturlar bulunurken, getRect() yönteminin döndürdüğü Rectangle içindeki şekillerde konturlar bulunmaz. Bir örnek için, getRect() yönteminin açıklamasına bakın.

Parametreler

targetCoordinateSpace parametresince tanımlanan koordinat sistemini esas alarak ve her tür çizgi ve şekli dışarıda bırakarak görüntüleme nesnesinin sınırlarını tanımlayan bir dikdörtgen döndürür. getRect() yönteminin döndürdüğü değerler, getBounds() yönteminin döndürdüğü değerlerle aynı veya bu değerlerden daha düşüktür.

Not: Görüntüleme nesnesinin yerel koordinatlarını Sahne Alanı koordinatlarına dönüştürmek için localToGlobal() yöntemini veya Sahne Alanı koordinatlarını yerel koordinatlara dönüştürmek için globalToLocal() yöntemini kullanın.

Parametreler

point nesnesini, Sahne Alanı (global) koordinatlarından görüntüleme nesnesinin (yerel) koordinatlarına dönüştürür.

Bu yöntemi kullanmak için ilk olarak Point sınıfının bir örneğini oluşturun. Atadığınız x ve y değerleri, ana görüntüleme alanının başlangıç konumuna (0,0) göre olduğundan, global koordinatları temsil ederler. Daha sonra Point örneğini parametre olarak globalToLocal() yöntemine iletin. Yöntem, Stage öğesinin başlangıç konumu yerine görüntüleme nesnesinin başlangıç konumuna göre x ve y değerleriyle yeni bir Point nesnesi döndürür.

Parametreler

obj görüntüleme nesnesinin sınırlayıcı kutusuyla örtüşüp örtüşmediğini veya kesişip kesişmediğini görmek için görüntüleme nesnesinin sınırlayıcı kutusunu değerlendirir.

Parametreler

Görüntüleme nesnesinin x ve y ile belirtilen bir noktayla örtüştüğünü veya kesiştiğini görmek için görüntüleme nesnesini değerlendirir. x ve y parametreleri, görüntüleme nesnesini içeren görüntüleme nesnesi kabının değil, Sahne Alanı'nın koordinat alanında bir noktayı belirtir (o görüntüleme nesnesi kabı Sahne Alanı olmadığı sürece).

Parametreler

point nesnesini, görüntüleme nesnesinin (yerel) koordinatlarından Sahne Alanı (global) koordinatlarına dönüştürür.

Bu yöntem herhangi bir x ve y koordinatını, belirli bir görüntüleme nesnesinin başlangıç noktasına (0,0) (yerel koordinatlar) göre olan değerlerden, Sahne Alanı'nın başlangıç noktasına (global koordinatlar) göre olan değerlere dönüştürmenizi sağlar.

Bu yöntemi kullanmak için ilk olarak Point sınıfının bir örneğini oluşturun. Atadığınız x ve y değerleri, görüntüleme nesnesinin başlangıç konumuna göre olduğundan, yerel koordinatları temsil ederler.

Daha sonra, parametre olarak oluşturduğunuz Point örneğini localToGlobal() yöntemine verirsiniz. Yöntem, görüntüleme nesnesinin başlangıç konumu yerine Sahne Alanı'nın başlangıç konumuna göre x ve y değerleriyle yeni bir Point nesnesi döndürür.

Parametreler

Moves this object to the specified x and y coordinates.

Parametreler

Sets the actual size of this object.

This method is mainly for use in implementing the updateDisplayList() method, which is where you compute this object's actual size based on its explicit size, parent-relative (percent) size, and measured size. You then apply this actual size to the object by calling setActualSize().

In other situations, you should be setting properties such as width, height, percentWidth, or percentHeight rather than calling this method.

Parametreler