Sahne Alanı özelliklerini ayarlama

Flash Player'da tam ekran modunu etkinleştirme

Bir HTML sayfasında gömülü SWF dosyası için tam ekran modunu etkinleştirmek üzere, Flash Player'ı gömmeye yönelik HTML kodunun aşağıdaki gibi, allowFullScreen adı ve true değeri ile bir param etiketini ve embed niteliğini içermesi gerekir:

<object> 
    ... 
    <param name="allowFullScreen" value="true" /> 
    <embed ... allowfullscreen="true" /> 
</object>

Flash geliştirme aracında, Dosya -> Yayınlama Ayarları seçeneklerini belirleyin ve Yayınlama Ayarları iletişim kutusunun HTML sekmesinde Yalnızca Flash - Tam Ekran Moduna İzin Ver şablonunu seçin.

Flex'te, HTML şablonunun tam ekranı destekleyen <object> ve <embed> etiketlerini içerdiğinden emin olun.

SWF gömme etiketleri oluşturmak için bir web sayfasında JavaScript kullanıyorsanız, allowFullScreen param etiketini ve niteliğini eklemek için JavaScript'i değiştirmeniz gerekir. Örneğin, HTML sayfanız AC_FL_RunContent() işlevini (Flash Professional ve Flash Builder tarafından oluşturulan HTML sayfaları tarafından kullanılan) kullanıyorsa, aşağıdaki gibi bu işleve allowFullScreen parametresini eklemeniz gerekir:

AC_FL_RunContent( 
    ... 
    'allowFullScreen','true', 
    ... 
    ); //end AC code

Bu, bağımsız Flash Player'da çalışan SWF dosyaları için geçerli değildir.

Tam ekran modunu tarayıcıda Flash Player ile kullanmaya yönelik güvenlikle ilgili kısıtlamalar da bulunmaktadır. Bu kısıtlamalar Güvenlik konusunda açıklanmıştır.

Tam ekran sahne boyutu ve ölçekleme

Stage.fullScreenHeight ve Stage.fullScreenWidth özellikleri, hemen duruma girilirse, tam ekran boyutuna girilirken kullanılan monitör yüksekliğini ve genişliğini döndürür. Siz bu değerleri aldıktan sonra ancak tam ekran moduna girmeden önce, kullanıcının tarayıcıyı bir monitörden diğerine taşıma olanağı varsa, bu değerler yanlış olabilir. Bu değerleri Stage.displayState özelliğini StageDisplayState.FULL_SCREEN olarak ayarladığınız olay işleyicisinde alırsanız, değerler doğrudur. Birden çok monitöre sahip kullanıcılar için, SWF içeriği yalnızca bir monitörü dolduracak şekilde genişler. Flash Player ve AIR uygulaması, SWF'nin en büyük bölümünü hangi monitörün içerdiğini belirlemek için bir metrik kullanır ve tam ekran modu için bu monitörü kullanır. fullScreenHeight ve fullScreenWidth özellikleri yalnızca tam ekran modu için kullanılan monitör boyutunu gösterir. Ayrıntılı bilgi için Adobe Flash Platformu için ActionScript 3.0 Başvurusu'nda bulunan Stage.fullScreenHeight ve vStage.fullScreenWidth bölümüne bakın.

Tam ekran modu için Sahne Alanı ölçekleme davranışı, normal moddakiyle aynıdır; ölçekleme, Stage sınıfının scaleMode özelliği tarafından denetlenir. scaleMode özelliği StageScaleMode.NO_SCALE olarak ayarlanırsa, Sahne Alanı'nın stageWidth ve stageHeight özellikleri, SWF tarafından kaplanan ekran alanının boyutunu (bu durumda, ekranın tamamı) yansıtacak şekilde değişir; tarayıcıda görüntülenirse, ayarı bu denetimlerin HTML parametreleri denetler.

Tam ekran modu etkinleştirildiğinde veya devre dışı bırakıldığında bunu algılayıp yanıt vermek için Stage sınıfının fullScreen olayını kullanabilirsiniz. Örneğin, bu örnekteki gibi, tam ekran moduna girerken veya tam ekran modundan çıkarken ekrandaki öğeleri yeniden konumlandırmak, ekrana öğe eklemek veya ekrandan öğe kaldırmak isteyebilirsiniz:

import flash.events.FullScreenEvent; 
 
function fullScreenRedraw(event:FullScreenEvent):void 
{ 
    if (event.fullScreen) 
    { 
        // Remove input text fields. 
        // Add a button that closes full-screen mode. 
    } 
    else 
    { 
        // Re-add input text fields. 
        // Remove the button that closes full-screen mode. 
    } 
} 
 
mySprite.stage.addEventListener(FullScreenEvent.FULL_SCREEN, fullScreenRedraw);

Bu kodun da gösterdiği gibi, fullScreen olayının olay nesnesi, tam ekran modunun etkinleştirilip (true) etkinleştirilmediğini (false) belirten fullScreen özelliğini içeren bir flash.events.FullScreenEvent sınıfı örneğidir.

Tam ekran modunda klavye desteği

Flash Player bir tarayıcıda çalışırken, klavye olayları ve TextField örneklerindeki metin girişi gibi klavyeyle ilgili tüm ActionScript, tam ekran modunda devre dışı bırakılır. İstisnalar (etkin tuşlar) şunlardır:

• Seçili basılamayan tuşlar, ok tuşları, boşluk tuşu ve sekme tuşu

• Tam ekran modunu sonlandıran klavye kısayolları: Esc (Windows ve Mac), Control-W (Windows), Command-W (Mac) ve Alt-F4

Bu kısıtlamalar, bağımsız Flash Player veya AIR uygulamasında çalışan SWF içeriği için mevcut değildir. AIR, klavye girdisine izin veren etkileşimli bir tam ekran modunu destekler.

Tam ekran modunda donanım ölçekleme

Flash Player veya AIR uygulamasını sahne alanının belirli bir bölgesini tam ekran moduna ölçekleyecek şekilde ayarlamak için Stage sınıfının fullScreenSourceRect özelliğini kullanabilirsiniz. Flash Player ve AIR, varsa kullanıcının bilgisayarındaki grafik ve video kartını kullanarak donanımda ölçekler ve genellikle içeriği yazılım ölçeklemeden daha hızlı bir şekilde görüntüler.

Donanım ölçeklemeden yararlanmak için, sahne alanının tamamını veya bir kısmını tam ekran moduna ayarlarsınız. Şu ActionScript 3.0 kodu, sahne alanının tamamını tam ekran moduna ayarlar:

import flash.geom.*;  
{ 
    stage.fullScreenSourceRect = new Rectangle(0,0,320,240); 
    stage.displayState = StageDisplayState.FULL_SCREEN; 
}

Bu özellik geçerli bir dikdörtgene ayarlandığında ve displayState özelliği tam ekran moduna ayarlandığında, Flash Player ve AIR belirtilen alanı ölçekler. ActionScript içinde piksel olarak gerçek Sahne Alanı boyutu değişmez. Flash Player ve AIR, “Tam ekran modundan çıkmak için Esc düğmesine basın” mesajını barındıracak şekilde dikdörtgenin boyutu için minimum bir sınırı zorlar. Bu sınır genellikle yaklaşık 260 x 30 pikseldir ancak platforma ve Flash Player sürümüne bağlı olarak değişiklik gösterebilir.

fullScreenSourceRect özelliği yalnızca Flash Player veya AIR tam ekran modunda olmadığında ayarlanabilir. Bu özelliği düzgün bir şekilde kullanmak için, öncelikle bu özelliği ayarlayın, ardından displayState özelliğini tam ekran moduna ayarlayın.

Ölçeklemeyi etkinleştirmek için, fullScreenSourceRect özelliğini bir dikdörtgen nesnesine ayarlayın.

stage.fullScreenSourceRect = new Rectangle(0,0,320,240);

Ölçeklemeyi devre dışı bırakmak için, fullScreenSourceRect özelliğini null olarak ayarlayın.

stage.fullScreenSourceRect = null;

Flash Player ile tüm donanım ivmesi özelliklerinden yararlanabilmek için, özelliği Flash Player Ayarları iletişim kutusundan etkinleştirin. İletişim kutusunu yüklemek için, tarayıcınızdaki Flash Player içeriğinin üzerinde sağ tıklatın (Windows) veya Control tuşuna basarak tıklatın (Mac). Birinci sekme olan Görünüm sekmesini seçin ve Donanım ivmesini etkinleştir onay kutusunu tıklatın.

Doğrudan ve GPU birleştirme penceresi modları

Flash Player 10, doğrudan ve GPU birleştirme olmak üzere iki pencere modu sunar, bu pencereleri Flash geliştirme aracındaki yayın ayarlarından etkinleştirebilirsiniz. Bu modlar AIR uygulamasında desteklenmez. Bu modlardan yararlanabilmek için, Flash Player için donanım ivmesini etkinleştirmeniz gerekmektedir.

Doğrudan modu, grafikleri ekrana itmek için en hızlı ve en doğrudan yolu kullanır ve bu da video oynatımı için avantaj sağlar.

GPU birleştirme modu, birleştirme işlemini hızlandırmak için video kartında grafik işleme birimini kullanır. Video birleştirme, tek bir video görüntüsü oluşturmak için birden çok görüntü katmanlama işlemidir. GPU ile birleştirme hızlandırıldığında, YUV dönüştürme, renk düzeltme, döndürme veya ölçekleme ve karışım performansı artırılabilir. YUV dönüştürme, video kameraların ve ekranların kullandığı RGB (kırmızı, yeşil, mavi) renk modeline iletim için kullanılan bileşik analog sinyallerin renk dönüştürmesini ifade eder. Birleştirmeyi hızlandırmak için GPU'nun kullanılması, CPU'ya yüklenecek olan bellek ve hesaplama gereksinimini azaltır. Bu da standart tanımlı videoların daha akıcı şekilde oynatılmasını sağlar.

Bu pencere modlarını uygularken dikkatli olun. GPU birleştirmenin kullanılması bellek ve CPU kaynakları için maliyetli olabilir. Bazı işlemler (örn. karışım modları, filtre uygulama, kırpma veya maskeleme) GPU'da gerçekleştirilemezse, bu işlemler yazılım tarafından yapılır. Adobe, bu modları kullanırken her HTML sayfası için kendinizi bir SWF dosyasıyla sınırlamanızı ve bant reklamlar için bu modları etkinleştirmemenizi önerir. Flash uygulamasının Filmi Test Et işlevi, donanım ivmesini kullanmaz ancak Yayınla Önizle seçeneği üzerinden bu işlevi kullanabilirsiniz.

SWF dosyanızda maksimum ekran yenileme hızı olan 60'tan yüksek bir kare hızının ayarlanması gereksizdir. Kare hızının 50 ile 55 arasında bir değere ayarlanması, zaman zaman çeşitli nedenlerle oluşabilen bırakılan karelere neden olur.

Doğrudan modunu kullanabilmek için Windows'ta 128 MB VRAM ile Microsoft DirectX 9 ve Apple Macintosh, Mac OS X v10.2 veya daha üstü için OpenGL gerekmektedir. GPU birleştirme için Windows'ta 128 MB VRAM ile Microsoft DirectX 9 ve Pixel Shader 2.0 desteği gerekir. Mac OS X ve Linux'ta GPU birleştirme için OpenGL 1.5 ve birçok OpenGL uzantısı (framebuffer nesnesi, çoklu doku, gölgelendirici nesneleri, gölgeleme dili, parça gölgelendirici) gerekir.

Flash sekmesindeki Donanım İvmesi menüsünü kullanarak, Flash uygulamasının Yayın Ayarları iletişim kutusu üzerinden her SWF dosyasında direct ve gpu ivme modlarını etkinleştirebilirsiniz. Yok seçeneğini belirlerseniz, HTML sekmesindeki Pencere Modu ayarının belirttiği gibi, pencere modu default, transparent veya opaque, ayarına geri döndürülür.