GradientBevelFilter  - AS3

colors dizisindeki karşılık gelen renkler için alfa saydamlık değerleri dizisi. Dizideki her öğeye yönelik geçerli değerler 0 ila 1'dir. Örneğin ,25, %25'lik bir saydamlık değeri ayarlar.

alphas özelliği, değerleri doğrudan değiştirilerek değiştirilemez. Bunun yerine, alphas öğesine bir başvuru yapmalısınız, başvurularında değişiklik yapmalısınız ve alphas öğesini başvuruya ayarlamalısınız.

colors, alphas ve ratios özellikleri birbiriyle ilişkilidir. colors dizisindeki ilk öğe alphas dizisindeki ilk öğeye, ratios dizisindeki ilk öğeye ve diğer dizilerdeki ilk öğelere karşılık gelir.

İlgili API Öğeleri

Derece olarak açı. Geçerli değerler 0 ila 360'tır. Varsayılan değer 45'tir.

Açı değeri, nesnenin üstüne düşen teorik ışık kaynağının açısını temsil eder. Bu değer, degrade renklerinin nesneye uygulandığı açıyı belirler: vurgunun ve gölgenin göründüğü yer veya dizideki ilk rengin göründüğü yer. Ardından renkler, dizide göründükleri sırada uygulanır.

İlgili API Öğeleri

Yatay bulanıklaştırma miktarı. Geçerli değerler 0 ila 255'tir. 1 veya daha az bulanıklaştırma miktarı, orijinal dosyanın olduğu gibi kopyalandığı anlamına gelir. Varsayılan değer 4'tür. 2'nin katları olan değerler (2, 4, 8, 16 ve 32 gibi) diğer değerlerden daha hızlı oluşturmak için en iyileştirilir.

Dikey bulanıklaştırma miktarı. Geçerli değerler 0 ila 255'tir. 1 veya daha az bulanıklaştırma miktarı, orijinal dosyanın olduğu gibi kopyalandığı anlamına gelir. Varsayılan değer 4'tür. 2'nin katları olan değerler (2, 4, 8, 16 ve 32 gibi) diğer değerlerden daha hızlı oluşturmak için en iyileştirilir.

Degradede kullanılacak RGB onaltılık renk değerleri dizisi. Örneğin kırmızı: 0xFF0000, mavi: 0x0000FF şeklinde devam eder.

colors özelliği, değerleri doğrudan değiştirilerek değiştirilemez. Bunun yerine, colors öğesine bir başvuru yapmalısınız, başvurularında değişiklik yapmalısınız ve colors öğesini başvuruya ayarlamalısınız.

colors, alphas ve ratios özellikleri birbiriyle ilişkilidir. colors dizisindeki ilk öğe alphas dizisindeki ilk öğeye, ratios dizisindeki ilk öğeye ve diğer dizilerdeki ilk öğelere karşılık gelir.

İlgili API Öğeleri

Uzaklık mesafesi. Geçerli değerler 0 ila 8'dir. Varsayılan değer 4,0'dır.

Nesnenin boşaltma efekti olup olmadığını belirtir. Boşaltma efekti nesnenin dolgusunu saydam yapar ve belgenin arka plan rengini ortaya çıkarır. true değeri bir boşaltma efektini belirtir; varsayılan false değeridir. (Boşaltma efekti yoktur.)

Filtrenin kaç defa uygulanacağı. Varsayılan değer, filtrenin bir kez uygulanmasına karşılık gelen BitmapFilterQuality.LOW değeridir. BitmapFilterQuality.MEDIUM değeri filtreyi iki kez uygular; BitmapFilterQuality.HIGH filtreyi üç kez uygular. Daha düşük değerlere sahip filtreler daha hızlı oluşturulur.

Birçok uygulama için düşük, orta veya yüksek quality değeri yeterlidir. Farklı bir efekt elde etmek için fazladan 15'e kadar sayısal değer kullanabilseniz de, daha yüksek değerler daha yavaş oluşturulur. quality değerini artırmak yerine, hızlı oluşturmayla birlikte yalnızca blurX ve blurY özelliklerinin değerlerini artırarak benzer bir efekt elde edebilirsiniz.

İlgili API Öğeleri

colors dizisindeki karşılık gelen renkler için renk dağılım oranları. Dizideki her öğeye yönelik geçerli değerler 0 ila 255'tir.

ratios özelliği, değerleri doğrudan değiştirilerek değiştirilemez. Bunun yerine, ratios öğesine bir başvuru yapmalısınız, başvurularında değişiklik yapmalısınız ve ratios öğesini başvuruya ayarlamalısınız.

colors, alphas ve ratios özellikleri birbiriyle ilişkilidir. colors dizisindeki ilk öğe alphas dizisindeki ilk öğeye, ratios dizisindeki ilk öğeye ve diğer dizilerdeki ilk öğelere karşılık gelir.

Bir degrade eğimindeki renklerin nasıl dağıtıldığını anlamak için öncelikle degrade eğiminizde kullanmak istediğiniz renkleri seçin. Basit bir eğimde vurgu rengi ve gölge rengi olacağını, bir degrade eğrisinde de vurgu degradesi ve gölge degradesi olacağını unutmayın. Vurgunun sol üst köşede ve gölgenin de sağ alt köşede görüneceğini varsayın. Filtrenin olası bir kullanımının vurguda dört ve gölgede dört adet rengi olacağını varsayın. Filtre, vurgu ve gölgenin yanı sıra vurgunun ve gölgenin kenarlarının birleştiği noktada bir taban dolgusu kullanır. Böylece, toplam renk sayısı dokuz ve oranlar dizisindeki karşılık gelen öğe sayısı dokuz olur.

Bir degradenin, birbiriyle karışan farklı renklerde çizgilerden oluştuğunu düşünürseniz, her oran değeri, degradenin yarıçapı üzerindeki rengin konumunu ayarlar. Burada 0 degradenin en dış noktasını temsil ederken 255 de degradenin en iç noktasını temsil eder. Genel bir kullanımda orta değer 128'dir ve bu da taban doldurma değeridir. Aşağıdaki görüntüde gösterilen eğim efektini elde etmek için oran değerlerini, dokuz renk örneğini kullanarak aşağıdaki gibi ayarlayın.

• İlk dört renk 0-127 arasında değişir. Değerler, her değer bir öncekinden daha yüksek veya bir öncekiyle eşit olacak şekilde artış gösterir. Bu, vurgu eğimi kenarıdır.
• Beşinci renk (orta renk) taban dolgusudur ve 128'e ayarlanmıştır. 128'in piksel değeri, taban dolgusunu ayarlar. Bu, türün dış olarak ayarlanması durumunda şeklin dışında (ve eğim kenarlarının etrafında) görünür; türün iç olarak ayarlanması durumunda nesnenin kendi dolgusunu etkin biçimde kaplayarak şeklin içinde görünür.
• Son dört renk 129-255 arasında değişir. Değerler, her değer bir öncekinden daha yüksek veya bir öncekiyle eşit olacak şekilde artış gösterir. Bu, gölge eğimi kenarıdır.

Her kenar için eşit bir renk dağılımı istiyorsanız orta rengin taban dolgusu olduğu tek sayıda renk kullanın. 0-127 ve 129-255 değerlerini renkleriniz arasında eşit paylaştırın ve ardından değeri, degradedeki her renk çizgisinin genişliğini değiştirmek için ayarlayın. Dokuz renkli degrade eğimi için olası bir dizi [16, 32, 64, 96, 128, 160, 192, 224, 235] şeklindedir. Aşağıdaki görüntüler, degrade eğimini açıklandığı şekilde gösterir:

Degradedeki renklerin dağılmasının blurX, blurY, strength ve quality özelliklerin yanı sıra ratios değerlerine göre değişeceğini unutmayın.

İlgili API Öğeleri

Baskı ve dağılma kuvveti. Değer ne kadar yüksek olursa daha fazla renk baskısı yapılır ve eğim ve arka plan arasındaki kontrast o kadar güçlü olur. Geçerli değerler 0 ila 255'tir. 0 değeri, filtrenin uygulanmadığı anlamına gelir. Varsayılan değer 1'dir.

İlgili API Öğeleri

Eğim efektinin yerleşimi. Olası değerler BitmapFilterType sabitleridir:

• BitmapFilterType.OUTER — Nesnenin dış kenarı üzerinde eğim
• BitmapFilterType.INNER — Nesnenin iç kenarı üzerinde eğim
• BitmapFilterType.FULL — Nesnenin üst kısmı üzerinde eğim

Belirtilen parametrelere sahip filtreyi başlatır.

İlgili API Öğeleri

Bu filtre nesnesinin kopyasını döndürür.

1. Gerekli sınıfları içe aktarın.
2. Kareyi ve filtreyi tanımlamak için global değişkenler bildirin.
3. Yapıcı işlevlerini oluşturun. Bu işlevler aşağıdakileri gerçekleştirir:
   • Gri bir kare çizmek için Sprite öğesinin graphics özelliği üzerinden erişilen Graphics sınıfının yöntemlerini kullanan draw() yöntemini çağırır.
   • filter adlı bir BitmapFilter nesnesi oluşturur ve bunu o getBitmapFilter() öğesine yapılan çağrının dönüş değerine atar ve böylece filtre oluşturulur.
   • myFilters adlı yeni bir dizi oluşturur ve filter öğesini bu diziye ekler.
   • myFilters öğesini GradientBevelFilterExample nesnesinin filters özelliğine atar. Böylece, myFilters öğesinde bulunan tüm filtreler uygulanır. Bu durumda bu yalnızca filter öğesidir.

package {
    import flash.display.Sprite;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BitmapFilterType;
    import flash.filters.GradientBevelFilter;

    public class GradientBevelFilterExample extends Sprite {
        private var bgColor:uint     = 0xCCCCCC;
        private var size:uint        = 80;
        private var offset:uint      = 50;
        private var distance:Number  = 5;
        private var angleInDegrees:Number = 225; // opposite 45 degrees
        private var colors:Array     = [0xFFFFFF, 0xCCCCCC, 0x000000];
        private var alphas:Array     = [1, 0, 1];
        private var ratios:Array     = [0, 128, 255];
        private var blurX:Number     = 8;
        private var blurY:Number     = 8;
        private var strength:Number  = 2;
        private var quality:Number   = BitmapFilterQuality.HIGH
        private var type:String      = BitmapFilterType.INNER;
        private var knockout:Boolean = true;

        public function GradientBevelFilterExample() {
            draw();
            var filter:BitmapFilter = getBitmapFilter();
            var myFilters:Array = new Array();
            myFilters.push(filter);
            filters = myFilters;
        }

        private function getBitmapFilter():BitmapFilter {
            return new GradientBevelFilter(distance,
                                           angleInDegrees,
                                           colors,
                                           alphas,
                                           ratios,
                                           blurX,
                                           blurY,
                                           strength,
                                           quality,
                                           type,
                                           knockout);
        }

        private function draw():void {
            graphics.beginFill(bgColor);
            graphics.drawRect(offset, offset, size, size);
            graphics.endFill();
        }
    }
}