colors 배열내의 각 색에 대응하는 알파 투명도의 값의 배열입니다. 배열내의 각 엘리먼트로 지정할 수 있는 값은 0 ~ 1 입니다. 예를 들어 . 25 로 지정하면, 알파 투명도는 25% 가 됩니다.

alphas property의 값을 직접 변경할 수 없습니다. 이 property를 변경하려면 ,alphas 에의 참조를 취득해, 그 참조를 변경한 후,alphas 를 그 참조로 설정할 필요가 있습니다.

colors,alphas,ratios 의 3 개의 property는 관련하고 있습니다. colors 배열의 선두의 엘리먼트가 alphas 배열과 ratios 배열의 선두의 엘리먼트에 대응하는 등, 3 개의 배열의 같은 인덱스의 엘리먼트가 서로 대응하고 있습니다.

See also

각도 (도수)입니다. 지정할 수 있는 값은 0 ~ 360 으로, 디폴트는 45 입니다.

각도의 값은, object에 대한 가공의 광원의 각도를 나타내, object에 대한 효과의 상대 위치를 결정합니다. distance 가 0 으로 설정되어 있는 경우, 효과가 object로부터 오프셋(offset) 되지 않기 때문에,angle property는 object에 영향을 주지 않습니다.

수평 방향의 애매하게 해 양입니다. 지정할 수 있는 값은 0 ~ 255 입니다. 1 이하의 값을 지정하면, 원의 이미지가 그대로 복사됩니다. 디폴트치는 4 입니다. 2 말하고 나무승 (2, 4, 8, 16, 32 등)은, 다른 값과 비교해 빠르게 렌더링 할 수 있도록(듯이) 최적화됩니다.

수직 방향의 애매하게 해 양입니다. 지정할 수 있는 값은 0 ~ 255 입니다. 1 이하의 값을 지정하면, 원의 이미지가 그대로 복사됩니다. 디폴트치는 4 입니다. 2 말하고 나무승 (2, 4, 8, 16, 32 등)은, 다른 값과 비교해 빠르게 렌더링 할 수 있도록(듯이) 최적화됩니다.

그라데이션을 정의하는 색의 배열입니다. 예를 들어, 빨강은 0 xFF0000, 파랑은 0x0000FF 등입니다.

colors property의 값을 직접 변경할 수 없습니다. 이 property를 변경하려면 ,colors 에의 참조를 취득해, 그 참조를 변경한 후,colors 를 그 참조로 설정할 필요가 있습니다.

colors,alphas,ratios 의 3 개의 property는 관련하고 있습니다. colors 배열의 선두의 엘리먼트가 alphas 배열과 ratios 배열의 선두의 엘리먼트에 대응하는 등, 3 개의 배열의 같은 인덱스의 엘리먼트가 서로 대응하고 있습니다.

See also

그로의 오프셋(offset) 거리입니다. 디폴트치는 4 입니다.

object에 녹아웃 효과를 적용할지 어떨지를 지정합니다. 녹아웃 효과를 적용하면, object의 칠이 투명하게 되어, 문서의 배경색이 표시됩니다. true 를 지정하면, 녹아웃 효과가 적용됩니다. 디폴트치는 false 로, 녹아웃 효과는 적용되지 않습니다.

필터를 적용하는 회수입니다. 디폴트치는, 필터를 1 회 적용하는 것에 상당하는 BitmapFilterQuality.LOW 입니다. 값 BitmapFilterQuality.MEDIUM 는 필터를 2 회 적용합니다. 값 BitmapFilterQuality.HIGH 는 필터를 3 회 적용합니다. 필터로 설정된 값이 작을 정도(수록), 빠르게 렌더링 할 수 있습니다.

많은 어플리케이션에서는,quality 의 값은 저, 안, 또는 고로 충분합니다. 최대 15 까지의 값을 사용해 다양한 효과를 낼 수가 있습니다만, 값이 커지는 만큼 렌더링 속도가 저하합니다. quality 의 값을 늘리는 대신에,blurX 와 blurY 의 값을 줄이는 것만으로, 같은 효과를 얻을 수 있습니다. 이 방법을 실행하면, 보다 고속으로 렌더링 됩니다.

See also

colors 배열내의 대응하는 색의 색분포 비율의 배열입니다. 지정할 수 있는 값은 0 ~ 255 입니다.

ratios property의 값을 직접 변경할 수 없습니다. 이 property를 변경하려면 ,ratios 에의 참조를 취득해, 그 참조를 변경한 후,ratios 를 그 참조로 설정할 필요가 있습니다.

colors,alphas,ratios 의 3 개의 property는 관련하고 있습니다. colors 배열의 선두의 엘리먼트가 alphas 배열과 ratios 배열의 선두의 엘리먼트에 대응하는 등, 3 개의 배열의 같은 인덱스의 엘리먼트가 서로 대응하고 있습니다.

그라데이션그로피르타는, object의 중심 (distance 가 0 으로 설정되어 있는 경우)으로부터 발 다투어지는 빛남이며, 서로 서로 섞인 색의 스트라이프로부터 구성되는 그라데이션을 가지고 있다고 생각합니다. colors 배열의 선두의 색이 그로의 가장 외측의 색입니다. 마지막 색이 그로의 가장 안쪽의 색입니다.

ratios 배열의 각 값는, 그 색의 그라데이션의 범위에 있어서의 위치를 나타냅니다. 0 은 그라데이션의 가장 외측의 점을 나타내, 255 는 그라데이션의 가장 안쪽의 점을 나타냅니다. 색분포 비율의 값은, 0 ~ 255 픽셀의 범위에서 지정할 수 있습니다. 예를 들어,[0, 64, 128, 200, 255] 와 같이 값을 늘려 갑니다. 0 ~ 128 의 값은, 그로의 외측의 엣지에 표시됩니다. 129 ~ 255 의 값은, 그로의 안쪽의 area에 표시됩니다. 색의 분포 비율의 값과 필터의 type 의 값에 따라서는, 필터의 적용처의 object에 의해 필터의 색이 안보이게 되는 일이 있습니다.

다음의 코드와 이미지에서는, 필터를 검은 엔의 무비 클립에 적용해,type 를 "full" 로 설정해 있습니다. 설명을 위해,colors 배열의 선두의 색인 핑크의 alpha 값를 1 으로 해, 문서의 흰 배경 중(안)에서 눈에 띄도록(듯이) 하고 있습니다만, 실제로 선두의 색을 이와 같이 표시하는 것은 아마 없습니다. 배열의 마지막 색인 황색에 의해, 필터의 적용처의 검은 엔이 안보이게 되고 있습니다.

var colors:Array = [0xFFCCFF, 0x0000FF, 0x9900FF, 0xFF0000, 0xFFFF00];
var alphas:Array = [1, 1, 1, 1, 1];
var ratios:Array = [0, 32, 64, 128, 225];
var myGGF:GradientGlowFilter = new GradientGlowFilter(0, 0, colors, alphas, ratios, 50, 50, 1, 2, "full", false);
 

type 를 "outer" 또는 "full" 로 설정했을 때에, 문서의 배경과 일체가 된 효과를 얻으려면 , 배열의 선두의 색을 문서의 배경과 같게 색으로 설정하는지, 선두의 색의 알파치를 0 으로 설정합니다. 어느 쪽의 방법을 사용해도, 필터가 배경으로 용해합니다.

코드에 작은 변경을 2 개 더하면, 같은 ratios 배열과 colors 배열에서도 그로의 효과가 크게 다릅니다. 배열의 선두의 색의 알파치를 0 으로 설정해 필터가 문서의 흰 배경으로 용해하도록(듯이) 해,type property를 "outer" 또는 "inner" 로 설정합니다. 다음의 이미지로 결과를 비교해 주세요.

그라데이션의 색의 확대는,blurX,blurY,strength,quality property의 값, 및 ratios 값에 근거해 변화합니다.

See also

흔적의 강함 또는 확대입니다. 값이 큰 만큼, 진한 색이 흔적 되므로, 그로와 배경과의 사이의 콘트라스트가 강해집니다. 지정할 수 있는 값은 0 ~ 255 입니다. 0 을 지정하면, 필터는 적용되지 않습니다. 디폴트치는 1 입니다.

필터 효과의 배치입니다. 지정할 수 있는 값은, flash.filters.BitmapFilterType 정수입니다.

• BitmapFilterType.OUTER — 그로가 object의 외측 엣지에 배치됩니다.
• BitmapFilterType.INNER — 그로가 object의 안쪽 엣지에 배치됩니다. 이것이 디폴트입니다.
• BitmapFilterType.FULL — 그로가 object 위에 배치됩니다.

지정된 Parameters로 필터를 초기화합니다.

이 필터 object의 복사를 돌려줍니다.

1. 필요한 클래스를 읽어들입니다.
2. 정방형과 필터의 정의에 사용하는 글로벌 변수를 선언합니다.
3. constructor　 　 함수를 작성합니다. 이 함수는, 이하의 처리를 실시합니다.
   • draw() Methods를 호출합니다. 이 Methods는 Sprite 의 graphics property를 개입시켜 액세스 하는 Graphics 클래스의 Methods를 사용해, 정방형을 묘화 합니다.
   • filter 라는 이름의 BitmapFilter object를 작성해, 그것을 getBitmapFilter() 의 호출에 의한 반환값에 할당합니다. 이 함수는 필터를 작성합니다.
   • myFilters 라는 이름의 새로운 배열을 작성해, 거기에 filter 를 추가합니다.
   • myFilters 를 GradientGlowFilterExample object의 filters property에 할당합니다. 이것에 의해,myFilters 로 발견된 모든 필터가 적용됩니다. 이 경우는 filter 뿐입니다.

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

    public class GradientGlowFilterExample extends Sprite {
        private var bgColor:uint = 0xCCCCCC;
        private var size:uint    = 80;
        private var offset:uint  = 50;

        private var distance:Number  = 0;
        private var angleInDegrees:Number = 45;
        private var colors:Array     = [0xFFFFFF, 0xFF0000, 0xFFFF00, 0x00CCFF];
        private var alphas:Array     = [0, 1, 1, 1];
        private var ratios:Array     = [0, 63, 126, 255];
        private var blurX:Number     = 50;
        private var blurY:Number     = 50;
        private var strength:Number  = 2.5;
        private var quality:Number   = BitmapFilterQuality.HIGH;
        private var type:String      = BitmapFilterType.OUTER;
        private var knockout:Boolean = false;

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

        private function getBitmapFilter() :BitmapFilter {
            return new GradientGlowFilter(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();
        }
    }
}