Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: Sunucudan Veri Alınıyor...
Sunucudan Veri Alınıyor...
 

Motion XML Öğeleri 

fl.motion paketindeki XML ve ActionScript sınıflarını kullanarak bir ara hareketi tanımlayabilirsiniz. Adobe Flash Professional, diğer sembollerde veya diğer projelerde kullanılacak Zaman Çizelgesindeki bir ara hareketi esas alarak XML ve ActionScript oluşturan bir "Hareketi ActionScript 3.0 olarak Kopyala" komutunu içerir. Kendi ara hareketinizin de komut dosyasını yazabilirsiniz. Derleme zamanında sınıf yolunuzda fl.motion sınıflarınız olduğu sürece, belirtilen görüntüleme nesnenize ara hareket uygulanır. Hareket sınıflarıyla ilgili daha fazla bilgi için bkz. fl.motion paketi. Destekleyen XML öğeleri, ActionScript 3.0 Dil Başvurusu'ndaki sınıf ve özelliklere karşılık gelir.

XML öğe hiyerarşisi aşağıdaki gibidir:

<Motion> 
 <Source> 
      <dimensions/> 
        <geom:Rectangle /> 
      </dimensions> 
      <transformationPoint> 
        <geom:Point /> 
      </transformationPoint> 
  </Source> 
  <Keyframe> 
    <color>  
      <Color /> 
    </color>      
    <tweens> 
      <SimpleEase /> 
      <CustomEase> 
      <BezierControl /> 
        <BezierNode /> 
      </CustomEase> 
    </tweens> 
    <filters>  
      <filters /> 
    </filters>    
  </Keyframe> 
</Motion>

Şu tabloda bir hareket nesnesine atanabilen XML öğeleri ve nitelikleri kısaca özetlenmektedir. Her bir girişle ilgili daha fazla ayrıntı için, öğeye karşılık gelen sınıflarda listelenen özelliklere bakın:

ÖğeNitelikTürAçıklama
Motion  Flash uygulamasının ara hareketi niteleyen özellikler atayabilmesi için Motion örneğini tanımlar. fl.motion.Motion sınıfına bakın.
 durationNumberSeçilen ara hareketin kare sayısı. fl.motion.MotionBase.duration özelliğine bakın.
source  Hareketle ilişkilendirilmiş orijinal görsel nesnenin özelliklerini içerir. fl.motion.Source sınıfına bakın.
SourceframeRateNumberFlash Professional'dan kopyalanan orijinal animasyonu içeren SWF dosyası için saniyede kare (fps) ayarı. Bu değerin, farklı bir SWF dosyasındaki ActionScript uygulaması üzerinde herhangi bir etkisi yoktur. fl.motion.Source.frameRate özelliğine bakın.
 xNumberFlash Professional'dan kopyalanan orijinal ara hareketin başındaki sembol örneğinin dönüştürme noktasının x koordinatı.
 yNumberFlash Professional'dan kopyalanan orijinal ara hareketin başındaki sembol örneğinin dönüştürme noktasının y koordinatı.
 scaleXNumberYatay ölçeğin yüzdesinin ondalık değeri. Değer genellikle 0 ile 1 arasındadır ancak 1'den yüksek veya 0'dan düşük de olabilir. Örneğin, nesneyi çevirmek için scaleX öğesini -1 değerine veya nesneyi orijinal boyutunun 3 katına çıkarmak için 3 değerine ayarlayabilirsiniz.
 skewXNumberYatay eksen boyunca kesme açısı (derece olarak). skewX ve skewY değerleri eşit olursa, rotation niteliğiyle değiştirilirler.
 skewYNumberDikey eksen boyunca kesme açısı (derece olarak). skewX ve skewY değerleri eşit olursa, rotation niteliğiyle değiştirilirler.
 rotationNumberİlk karenin dönüş derecesi.
 elementTypeStringAra harekette kullanılan görsel nesne türü. Olası değerler movie clip", "button", "graphic", "rectangle object", "oval object", "drawing object", "group", "bitmap", "compiled clip", "video" veya "text" şeklindedir.
 symbolNameStringVarsa (orijinal görsel nesne bir sembol örneği olamayabileceğinden), Adobe Flash Professional belgesinin kütüphanesindeki sembolün adı.
dimensions  Arası doldurulan sınırlama kutusunun ve dönüştürme noktasının açıklanması için geom ad alanını kullanan etiketler içerir.
geom:Rectangle  flash.geom paketinden bir nesne.flash.geom.Rectangle nesnesinin özelliklerine karşılık gelen nitelikler ekleyebilirsiniz. Örneğin: <geom:Rectangle left="7" top="9" width="151.95" height="151.95" />Top ve left değerleri, üst nesnenin kayıt noktasına göredir (top ve left, üst nesnenin koordinat alanında tanımlanır).
geom:Point flash.geom paketinden bir nesne.Dönüştürme noktasının koordinatları, sınırlama kutusunun boyutlarının bir yüzdesi olarak tanımlanır (geom:Rectangle öğesinin değerleri). Dönüştürme noktası, sınırlama kutusunun sol üst köşesiyse, koordinatlar (0, 0) olur. Dönüştürme noktası, sınırlama kutusunun sağ alt köşesiyse, koordinatlar (1, 1) olur. Bu değerler, farklı oran ve kayıt noktalarına sahip nesnelere dönüştürme noktasının tutarlı şekilde uygulanmasını sağlar. Dönüştürme noktası, sınırlama kutusunun dışında olabilir; bu durumda koordinatlar 0'dan küçük veya 1'den büyük olabilir.
Keyframe  Zaman Çizelgesinde bir anahtar kareye karşılık gelen bilgileri içerir.
 blankBooleanAnahtar Karenin boş olduğunu belirtir.
 indexNumberAnahtar kare için benzersiz bir tam sayı değeri. Birinci anahtar kare dizini her zaman 0'dır. XML'deki anahtar karelerin, dizin değerinin artan sırasında belirtilmesi gerekir.
 labelStringAnahtar Kareyi açıklayan ve Zaman Çizelgesinde bir kare etiketine karşılık gelen isteğe bağlı bir dize.
 tweenSyncBooleanSenkronize ayarını etkinleştirir ("true") ve devre dışı bırakır ("false"). Senkronize, Zaman Çizelgesinde kendisine ayrılan kare sayısıyla eşleştirmek için bir aradaki kare sayısını yeniden hesaplar. ActionScript grafik sembollerini kontrol edemediğinden, bu niteliğin ActionScript animasyonu üzerinde herhangi bir etkisi yoktur. XML niteliği yalnızca Adobe Flash Professional'ın Hareketi Kopyala ve Hareketi Yapıştır komutları tarafından kullanılır. XML'den çıkarılması durumunda varsayılan olarak true değerini alır.
 tweenSnapBooleanYapış ayarını etkinleştirir ("true") ve devre dışı bırakır ("false"). Bitiştir seçeneği, bir sembolü kayıt noktasına göre hareket yoluna ekler. ActionScript grafik sembollerini kontrol edemediğinden, bu niteliğin ActionScript animasyonu üzerinde herhangi bir etkisi yoktur. XML niteliği yalnızca Adobe Flash Professional'ın Hareketi Kopyala ve Hareketi Yapıştır komutları tarafından kullanılır. XML'den çıkarılması durumunda varsayılan olarak true değerini alır.
 xNumberGeçerli anahtar karedeki sembol örneğinin orta noktasının x koordinatı.
 yNumberGeçerli anahtar karedeki sembol örneğinin orta noktasının y koordinatı.
 scaleXNumber0 ile 1 arasında bir ondalık sayı olarak yatay ölçek yüzdesi.Değer genellikle 0 ile 1 arasındadır ancak 1'den yüksek veya 0'dan düşük de olabilir. Örneğin, nesneyi çevirmek için scaleX öğesini -1 değerine veya nesneyi orijinal boyutunun 3 katına çıkarmak için 3 değerine ayarlayabilirsiniz.
 scaleYNumber0 ile 1 arasında bir ondalık sayı olarak dikey ölçek yüzdesi.Değer genellikle 0 ile 1 arasındadır ancak 1'den yüksek veya 0'dan düşük de olabilir. Örneğin, nesneyi çevirmek için scaleY öğesini -1 değerine veya nesneyi orijinal boyutunun 3 katına çıkarmak için 3 değerine ayarlayabilirsiniz.
 skewXNumberYatay eksen boyunca kesme açısı (derece olarak). skewX ve skewY değerleri eşit olursa, rotation niteliğiyle değiştirilirler.
 skewYNumberDikey eksen boyunca kesme açısı (derece olarak). skewX ve skewY değerleri eşit olursa, rotation niteliğiyle değiştirilirler.
 rotationNumberGeçerli karenin dönüş derecesi.
 rotateDirectionStringArası doldurulan öğenin nasıl döndüğünü belirtir. Olası değerler şunlardır: "auto", "none", "cw", "ccw". XML'den çıkarılması durumunda varsayılan olarak "auto" değerini alır.
 rotateTimesNumberArası doldurulan öğenin, normal dönüşün yanı sıra, başlangıç anahtar karesi ile sonraki anahtar kare arasında dönüş sayısını belirtir. Adobe Flash Professional için bu değerin en az 0 değerinde bir tam sayı olması gerekir ancak hareket sınıfları ondalık değerlere de izin verir.
 tweenScaleBooleanfalse olursa, ara doldurma sırasında ölçeğin değişmesini önler. XML'den çıkarılması durumunda varsayılan olarak true değerini alır.
 cacheAsBitmapBooleanXML'den çıkarılması durumunda varsayılan olarak true değerini alır.
 blendModeStringOlası değerler şunlardır: "normal", "layer", "multiply", "screen", "overlay", "hardlight", "lighten", "darken", "difference", "add", "subtract", "invert", "alpha" ve "erase". XML'den çıkarılması durumunda varsayılan olarak "normal" değerini alır.
 orientToPathBooleanXML'den çıkarılması durumunda varsayılan olarak true değerini alır.
Renk  Renk değişimlerinin ayarlarını içerir. Flash sembolü örnekleri beş renk moduna sahiptir: none, alpha, tint, brightness ve advanced. Dönüştürme olmadığında (none) Color etiketi boş görünür ve normal görünüme işaret eder. Alfa dönüştürmeleri için alphaMultiplier ve alphaOffset niteliklerini ayarlayın. Renk tonu dönüştürmeleri için tintColor ve tintMultiplier niteliklerini ayarlayın.Parlaklık dönüşümleri için, brightness niteliğini kullanın.Gelişmiş dönüşümler için redMultiplier, greenMultiplier, blueMultiplier, alphaMultiplier, redOffset, greenOffset, blueOffset ve alphaOffset niteliklerini kullanın.
 parlaklıkNumber-1 ile 1 arasında parlaklık kanalının uygulanacağı yüzde, burada -1 tamamen siyah ve 1 tamamen beyazdır.
 tintColorOnaltılıkUygulanacak rengi temsil eden onaltılık bir renk değeri.
 alphaMultiplierNumber0 ile 1 arasında bir ondalık sayı olarak, alfa kanalını uygulama yüzdesi.
 redMultiplierNumber0 ile 1 arasındaki bir ondalık sayı olarak renk tonu uygulama yüzdesi.
 greenMultiplierNumber0 ile 1 arasındaki bir ondalık sayı olarak renk tonu uygulama yüzdesi.
 blueMultiplierNumber0 ile 1 arasındaki bir ondalık sayı olarak renk tonu uygulama yüzdesi.
 alphaMultiplierNumberAlfa saydamlık kanalının uygulanacağı yüzdeyi temsil eden 0 ile 1 arasında ondalık bir değer.
 tintMultiplierNumbertintColor değeriyle uygulanarak yüzdeyi temsil eden 0 ile 1 arasında ondalık bir değer.
 redOffsetNumberredMultiplier değeriyle çarpıldıktan sonra kırmızı kanal değerine eklenen -255 ile 255 arasındaki bir sayı.
 greenOffsetNumbergreenMultiplier değeriyle çarpıldıktan sonra yeşil kanal değerine eklenen -255 ile 255 arasındaki bir sayı.
 blueOffsetNumberblueMultiplier değeriyle çarpıldıktan sonra mavi kanal değerine eklenen -255 ile 255 arasındaki bir sayı.
 alphaOffsetNumberalphaMultiplier değeriyle çarpıldıktan sonra alfa kanal değerine eklenen -255 ile 255 arasındaki bir sayı.
tweens  Hareket hızı değişimlerinin ayarlarını içerir.
SimpleEase  Tüm hareket hızı özellikleri için ara hareket boyunca tek bir değer içeren bir hareket hızı ayarını tanımlar.
 easeNumberAra hareketin tüm özelliklerine uygulanacak bir hareket hızı değeri. Hareket hızı niteliği, -1 (%100 artan hareket hızı veya ivme) ile 1 (%100 azalan hareket hızı veya negatif ivme) arasında bir yüzde değeridir. Varsayılan değer 0 olup bu, ivme veya negatif ivme olmaksızın hareketin sabit bir şekilde hareket ettiğini belirtir.
 targetNumberFlash Professional tüm hareket hızı özelliklerine aynı değeri uyguladığından, Adobe Flash Professional'ın Hareketi Kopyala ve Hareketi Yapıştır komutları kullanılırken geliştirme aracı, SimpleEase öğesi için bir target niteliği içermeyen XML oluşturur. Ancak ActionScript 3.0 sınıfları, aynı anda ayrı özelliklere ayrı SimpleEase değerleri uygulamanıza olanak sağlar. target olası değerleri CustomEase olası değerleri ile aynıdır: "position", "scale", "rotation", "color", "filters", "x", "y", "scaleX", "scaleY", "skewX" ve "skewY".
CustomEase  Kübik Bezier eğrilerinden oluşan özel bir hareket hızı eğrisini tanımlar. Aynı anda tüm özelliklere uygulanabilir, aksi takdirde farklı özellikler için farklı eğriler tanımlayabilirsiniz. Özel hareket hızı özelliklerini temsil eden eğriler hakkında daha fazla bilgi almak için bkz. CustomEase sınıfı.
 targetNumberÖzel bir değer atanan özellik. Adobe Flash Professional'ın Hareketi Kopyala ve Hareketi Yapıştır komutları kullanılırken, geliştirme aracı target için şu olası değerleri oluşturur: "position", "scale", "rotation", "color", "filters". ActionScript 3.0 hareket sınıfları daha da fazla esneklik sağlar, "x", "y", "scaleX", "scaleY", "skewX", ve "skewY" değerleri için ayrı eğriler tanımlayabilirsiniz. "target" niteliği XML'den çıkarılırsa, tüm hareket hızı özellikleri birlikte hedeflenir. Not: XML, özel hareket hızı eğrisindeki ilk ve son noktaları çıkarır. Her zaman ilk noktanın (0, 0) (arası doldurulan özelliğin başlangıç değeri) ve son noktanın (1, 1) (arası doldurulan özelliğin bitiş değeri) olması gerekir. Kodun verimliliğini korumak ve olası hataları önlemek için, bu değerler XML'den çıkarılır ve bu değerlerin örtük olduğu varsayılır.
BezierControl  Eğriyi tanımlamak için kullanılan bir eğriye göre nokta.
 xNumberBir eğrinin tanımlanması için noktanın x koordinatı.
 yNumberBir eğrinin tanımlanması için noktanın y koordinatı.
BezierNode  Eğriyi tanımlamak için kullanılan bir eğri üzerindeki nokta.
 xNumberBir eğrideki noktanın x koordinatı.
 yNumberBir eğrideki noktanın y koordinatı.
filters  Bir öğe olarak kullanılacak flash.filters paketindeki bir nesneyi tanımlar (örneğin; filters:GlowFilter). Belirtilen flash.filters nesnesinin özelliklerine karşılık gelen nitelikler ekleyebilirsiniz. Örneğin: <filters:DropShadowFilter quality="1" inner="false" knockout="false" hideObject="false" distance="0" angle="45" color="0x000000" alpha="1" blurX="0" blurY="0" strength="0" />. Bkz. flash.filters paketi.

Şu örnek, myShape sembolü döndükçe, hareket ettikçe, özel bir hareket hızı ayarını kullandıkça ve on kare üzerinde alfa değerlerini değiştirdikçe, bu sembolün moveShape film klibi örneğinin ara hareketini açıklayan satıriçi XML ile ActionScript'i gösterir:

import fl.motion.Animator; 
var moveShape_xml:XML = <Motion duration="10" xmlns="fl.motion.*" xmlns:geom="flash.geom.*" xmlns:filters="flash.filters.*"> 
    <source> 
        <Source frameRate="12" x="41.35" y="91.35" scaleX="1" scaleY="1" rotation="0" elementType="movie clip" instanceName="moveShape" symbolName="myShape"> 
            <dimensions> 
                <geom:Rectangle left="-46.65" top="-61.95" width="133.05" height="133.95"/> 
            </dimensions> 
            <transformationPoint> 
                <geom:Point x="0.49981210071401727" y="0.4998133631952222"/> 
            </transformationPoint> 
        </Source> 
    </source> 
   <Keyframe index="0" rotateTimes="2"> 
        <tweens> 
            <CustomEase> 
                <BezierControl x="0.08650266979261687" y="0.14705453864744866"/> 
                <BezierControl x="0.23675978562091857" y="0.28829454738109694"/> 
                <BezierNode x="0.2689728109485753" y="0.49688733564952436"/> 
                <BezierControl x="0.32093023255813957" y="0.8333333333333333"/> 
                <BezierControl x="0.5988021982960045" y="1.034249160488573"/> 
                <BezierNode x="0.7309082984924317" y="0.8685852488735627"/> 
                <BezierControl x="0.8116279069767443" y="0.767361111111111"/> 
                <BezierControl x="0.910302766164144" y="0.9730908298492431"/> 
            </CustomEase> 
        </tweens> 
    </Keyframe> 
    <Keyframe index="9" x="371.95" y="188"> 
        <color> 
            <Color alphaMultiplier="0.4" alphaOffset="0"/> 
        </color> 
    </Keyframe> 
</Motion>; 
var moveShape_animator:Animator = new Animator(moveShape_xml, moveShape); 
moveShape_animator.play();

[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.