GradientBevelFilter  - AS3

在 colors 陣列中，其對應顏色之 Alpha 透明度值的陣列。 陣列中每一個元素的有效值為 0 到 1。 例如，.25 會設定 25% 的透明度值。

alphas 屬性無法藉由直接修改其值來變更。 相反地，您必須先取得 alphas 的參照，再對參照進行變更，然後將 alphas 設為該參照。

colors、alphas 和 ratios 屬性都彼此相關。 colors 陣列的第一個元素會對應到 alphas 陣列和 ratios 陣列的第一個元素，以下則依此類推。

相關 API 元素

角度，以度數為單位。 有效值為 0 到 360。 預設值為 45。

angle 值代表假設性光源照射物件的角度，可以決定相對於物件的特效呈現位置。 這個值會決定漸層顏色套用到物件的角度： 這個物件會出現反白標示和陰影，或顯示陣列內的第一個顏色， 然後依照顏色在陣列中出現的順序來套用顏色。

相關 API 元素

水平模糊化量。 有效值為 0 到 255。 值為 1 或更小的模糊化表示依照原始影像複製。 預設值為 4。 2 的冪次方數值 (如 2、4、8、16 和 32) 是經過最佳化的，以便在顯示時會比其他值更為快速。

垂直模糊化量。 有效值為 0 到 255。 值為 1 或更小的模糊化表示依照原始影像複製。 預設值為 4。 2 的冪次方數值 (如 2、4、8、16 和 32) 是經過最佳化的，以便在顯示時會比其他值更為快速。

用於漸層的 RGB 十六進位顏色值的陣列。例如，紅色是 0xFF0000、藍色是 0x0000FF，依此類推。

colors 屬性無法藉由直接修改其值來變更。 相反地，您必須先取得 colors 的參照，再對參照進行變更，然後將 colors 設為該參照。

colors、alphas 和 ratios 屬性都彼此相關。 colors 陣列的第一個元素會對應到 alphas 陣列和 ratios 陣列的第一個元素，以下則依此類推。

相關 API 元素

偏移距離。 有效值為 0 到 8。 預設值為 4.0。

指定物件是否具有去底色特效。 去底色特效可以讓物件的填色透明，並顯露出文件的背景顏色。 true 值會指定去底色特效，預設值為 false (無去底色特效)。

套用濾鏡的次數。 預設值為 BitmapFilterQuality.LOW (相當於套用一次濾鏡)。 BitmapFilterQuality.MEDIUM 值會套用兩次濾鏡，而 BitmapFilterQuality.HIGH 值會套用三次濾鏡。 設定值較低的濾鏡，其顯示速度較快。

對大部份應用程式而言，將 quality 值設為低、中或高就足夠了。 雖然您可以使用其他數值 (最高可至 15) 來達成不同的效果，但越高的值就代表越緩慢的顯示速度。 只要增加 blurX 和 blurY 屬性的值，通常就可以得到類似的效果和較快的顯示速度，而不需要增加 quality 的值。

相關 API 元素

在 colors 陣列中，其對應顏色的顏色分佈比例陣列。 陣列中每一個元素的有效值為 0 到 255。

ratios 屬性無法藉由直接修改其值來變更。 相反地，您必須先取得 ratios 的參照，再對參照進行變更，然後將 ratios 設為該參照。

colors、alphas 和 ratios 屬性都彼此相關。 colors 陣列的第一個元素會對應到 alphas 陣列和 ratios 陣列的第一個元素，以下則依此類推。

若要瞭解顏色在漸層斜角中的分佈情形，請先考慮您在漸層斜角中所要的顏色。 試想簡單斜角會有反白標示顏色和陰影顏色，而漸層斜角則有反白標示漸層和陰影漸層。 並假設反白標示是在左上角出現，而陰影則在右下角出現。 接著再假設一種使用濾鏡的可能方式，即是在反白標示上加入四種顏色，而在陰影中也使用四種顏色。 除了反白標示和陰影之外，濾鏡還會使用基準填色顏色，以便顯示在反白標示和陰影接合的邊緣上。 因此顏色總數是九個，而比例陣列中相應的元素也會是九個。

如果您將漸層想成是由各種顏色條紋相互摻合所構成，那麼每個比例值的作用就是設定顏色在漸層半徑上的位置，其中 0 代表漸層最外面的點，而 255 則代表漸層最裡面的點。 在一般的使用方式上，中間值是 128，也就是基準填色值。 若要獲得下面影像所展示的斜角特效，請使用上述九個顏色的範例，依下列方式指定比例值：

• 後面四個顏色的範圍是從 0 到 127，其數值應該依次遞增，讓每個值大於或等於前一個。 這樣會產生反白標示斜角邊緣。
• 第五個顏色 (中間的顏色) 是基準填色，設定為 128。 像素值為 128 就會設定成基準填色；如果將類型設為 outer (外部)，這個顏色便會在形狀外面 (且沿著斜角邊緣周圍) 出現；如果類型是設為 inner (內部)，則會在形狀內部，有效地覆蓋物件本身的填色。
• 後面四個顏色的範圍是從 129 到 255，其數值應該依次遞增，讓每個值大於或等於前一個。 這樣會產生陰影斜角邊緣。

如果要均等分佈每個邊緣的顏色，請使用奇數個顏色，而在中間的顏色就是基準填色。 請將 0 到 127 之間以及 129 到 255 之間的數值均等地分佈在您的顏色之中，然後調整數值以變更漸層中每一條顏色的寬度。 就含有九種顏色的漸層斜角而言，可能產生的陣列會是 [16, 32, 64, 96, 128, 160, 192, 224, 235]。 下列影像依照上述方式描繪出漸層斜角：

請記住，漸層中的顏色塗佈會根據 blurX、blurY、strength 和 quality 屬性的值，以及 ratios 值產生變化。

相關 API 元素

壓印強度或範圍。 數值越高，便壓印越多顏色，斜角與背景之間的對比越強烈。 有效值為 0 到 255。 值為 0 時表示未套用濾鏡。 預設值為 1。

相關 API 元素

斜角特效的位置。 可能的值為 BitmapFilterType 常數：

• BitmapFilterType.OUTER — 物件外緣上的斜角
• BitmapFilterType.INNER — 物件內緣上的斜角
• BitmapFilterType.FULL — 物件上方的斜角

以指定的參數初始化濾鏡。

相關 API 元素

傳回此濾鏡物件的副本。

1. 匯入所需的類別。
2. 宣告全域變數以定義方形和濾鏡。
3. 建立建構函數，以進行下列動作：
   • 呼叫 draw() 方法，使用 Graphics 類別的方法 (透過 Sprite 的 graphics 屬性存取) 來繪製灰色方形。
   • 建立名為 filter 的 BitmapFilter 物件，並為其指定 getBitmapFilter() 呼叫 (建立濾鏡) 的傳回值。
   • 建立名為 myFilters 的新陣列，並將 filter 加入此陣列。
   • 將 myFilters 指定給 GradientBevelFilterExample 物件的 filters 屬性。 這樣就會套用 myFilters 中找到的所有濾鏡，而在本範例中只有 filter。

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();
        }
    }
}