This page was saved using jaction on 2006-09-04 8:33:43.
Address: http://flexdocs.kr/docs/flex2/langref/flash/filters/GradientBevelFilter.html
Title: flash.filters.GradientBevelFilter (Flex™ 2 레퍼런스 가이드)  •  Size: 56099
Packageflash.filters
Classpublic final class GradientBevelFilter
InheritanceGradientBevelFilter Inheritance BitmapFilter Inheritance Object

GradientBevelFilter 클래스를 사용하면, object에 그라데이션베벨 효과를 적용해, 표시할 수 있습니다. 그라데이션베벨은, object의 외측, 안쪽, 또는 위쪽이 비스듬하게 된 엣지이며, 그라데이션카라로 강조됩니다. 기울기의 엣지에 의해 object가 3 차원으로 보입니다. 이 필터는, MovieClip, SimpleButton, TextField, Video object등의 DisplayObject 클래스로부터 Inheritance한 표시 object, 및 BitmapData object에 적용할 수 있습니다.

필터의 사용 방법은, 필터의 적용처 object에 따라서 다릅니다.

표시 object에 필터를 적용하면, 표시 object의 cacheAsBitmap property는 true 로 설정됩니다. 모든 필터를 클리어 하면,cacheAsBitmap 는 원의 값에 돌아옵니다.

이 필터는 스테이지의 확대·축소에 대응하고 있습니다만, 통상의 확대·축소, 회전, 경사에는 대응하고 있습니다. object 자체를 확대·축소하는 경우 (scaleXscaleY 의 값이 1.0 이외에 설정되어 있는 경우), 필터 효과는 확대·축소되지 않습니다. 필터가 확대·축소하는 것은, 스테이지를 줌인 하는 경우만입니다.

결과적으로 얻을 수 있는 이미지의 폭 또는 높이가 2880 픽셀을 넘는 경우, 필터는 적용되지 않습니다. 예를 들어, 필터가 적용된 크기의 큰 무비 클립을 줌인 할 때, 결과적으로 얻을 수 있는 이미지가 2880 픽셀의 제한을 넘는 경우는, 필터가 오프가 됩니다.

View the examples

See also

GradientBevelFilter.ratios
flash.display.BitmapData.applyFilter()
BevelFilter
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
Flex 에서의 필터의 사용


Public property
 property정의
  alphas : Array
colors 배열내의 각 색에 대응하는 알파 투명도의 값의 배열입니다.
GradientBevelFilter
  angle : Number
각도 (도수)입니다.
GradientBevelFilter
  blurX : Number
수평 방향의 애매하게 해 양입니다.
GradientBevelFilter
  blurY : Number
수직 방향의 애매하게 해 양입니다.
GradientBevelFilter
  colors : Array
그라데이션으로 사용하는 RGB 16 진수 칼라치의 배열입니다.
GradientBevelFilter
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  distance : Number
오프셋(offset) 거리입니다.
GradientBevelFilter
  knockout : Boolean
object에 녹아웃 효과를 적용할지 어떨지를 지정합니다.
GradientBevelFilter
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  quality : int
필터를 적용하는 회수입니다.
GradientBevelFilter
  ratios : Array
colors 배열내의 대응하는 색의 색분포 비율의 배열입니다.
GradientBevelFilter
  strength : Number
흔적의 강함 또는 확대입니다.
GradientBevelFilter
  type : String
베벨 효과의 배치입니다.
GradientBevelFilter
Public Methods
 Methods정의
  GradientBevelFilter (distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
지정된 Parameters로 필터를 초기화합니다.
GradientBevelFilter
  clone ():BitmapFilter
이 필터 object의 복사를 돌려줍니다.
GradientBevelFilter
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
property의 상세
alphasproperty
alphas:Array   [read-write]

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

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

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

Implements
    public function get alphas():Array
    public function set alphas(value:Array ):void

Throws
TypeError — 배열은, 설정시에 null 로 설정됩니다.

See also

angleproperty 
angle:Number   [read-write]

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

각도의 값은, object로 향해지는 가공의 광원의 각도를 나타냅니다. 이 값에 의해, 그라데이션카라가 object에 적용될 때의 각도를 설정합니다. 이것에 의해 하이라이트와 그림자가 나타나는 장소나, 배열의 선두의 색이 나타나는 장소가 정해집니다. 선두의 색을 적용하는 장소가 정해지면, 다른 색이 배열내에 포함되고 있는 순으로 적용됩니다.

Implements
    public function get angle():Number
    public function set angle(value:Number ):void

See also

blurXproperty 
blurX:Number   [read-write]

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

Implements
    public function get blurX():Number
    public function set blurX(value:Number ):void
blurYproperty 
blurY:Number   [read-write]

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

Implements
    public function get blurY():Number
    public function set blurY(value:Number ):void
colorsproperty 
colors:Array   [read-write]

그라데이션으로 사용하는 RGB 16 진수 칼라치의 배열입니다. 예를 들어, 빨강은 0 xFF0000, 파랑은 0x0000FF 등입니다.

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

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

Implements
    public function get colors():Array
    public function set colors(value:Array ):void

Throws
TypeError — 배열은, 설정시에 null 로 설정됩니다.

See also

distanceproperty 
distance:Number   [read-write]

오프셋(offset) 거리입니다. 유효한 값은 0 ~ 8 으로, 디폴트치는 4.0 입니다.

Implements
    public function get distance():Number
    public function set distance(value:Number ):void
knockoutproperty 
knockout:Boolean   [read-write]

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

Implements
    public function get knockout():Boolean
    public function set knockout(value:Boolean ):void
qualityproperty 
quality:int   [read-write]

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

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

Implements
    public function get quality():int
    public function set quality(value:int ):void

See also

ratiosproperty 
ratios:Array   [read-write]

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

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

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

그라데이션베벨의 색을어느 분포하는지를 이해하기 위해서, 우선, 그라데이션베벨로 사용하는 색을 생각합니다. 여기에서는, 하이라이트 1 색과 그림자 1 색으로부터 구성되는 단순한 베벨을 생각합니다. 그라데이션베벨에는 1 개의 하이라이트그라데이션과 1 개의 샤드우그라데이션이 있습니다. 하이라이트를 좌상구석에 표시해, 그림자를 우하구석에 표시한다고 합니다. 여기에서는, 일례로서 하이라이트에 4 색, 그림자에 4 색을 사용합니다. 하이라이트와 그림자에 가세해 하이라이트와 그림자의 엣지가 교차하는 부분에 베이스 칠의 색을 사용합니다. 이 경우, 합계 9 색을 사용하므로, 색분포 비율의 배열의 엘리먼트수는 9 입니다.

그라데이션은 서로 서로 섞인 다양한 색의 스트라이프로 구성되어 있다고 생각했을 경우, 색분포 비율의 값은, 그 색의 그라데이션의 범위내에 있어서의 위치를 나타냅니다. 이 정도치는, 0 이 그라데이션의 가장 외측의 점을 나타내, 255 가 그라데이션의 가장 안쪽의 점을 나타냅니다. 통상, 중간치는 128 으로, 이것이 베이스 칠의 값이 됩니다. 아래의 이미지의 베벨 효과를 얻으려면 , 9 색의 예를 사용해 색분포 비율의 값을 다음과 같이 설정합니다.

각 엣지의 색분포를 같게 하는 경우는, 중간색이 베이스 칠이 되도록(듯이), 사용하는 색 가지수를 홀수로 합니다. 0 ~ 127 으로 129 ~ 255 의 범위에서 색을 균등하게 분포한 후, 값을 조정해 그라데이션의 각 색의 스트라이프의 폭을 변경합니다. 9 색의 그라데이션베벨의 경우,[16, 32, 64, 96, 128, 160, 192, 224, 235] 와 같은 배열이 생각됩니다. 다음의 그림은, 여기까지 설명한 그라데이션베벨을 나타내고 있습니다.

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

Implements
    public function get ratios():Array
    public function set ratios(value:Array ):void

Throws
TypeError — 배열은, 설정시에 null 로 설정됩니다.

See also

strengthproperty 
strength:Number   [read-write]

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

Implements
    public function get strength():Number
    public function set strength(value:Number ):void

See also

typeproperty 
type:String   [read-write]

베벨 효과의 배치입니다. 지정할 수 있는 값은, BitmapFilterType 정수입니다.

Implements
    public function get type():String
    public function set type(value:String ):void
constructor    의 상세
GradientBevelFilter()constructor   
public 함수 GradientBevelFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)

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

Parameters
distance:Number (default = 4.0) — 오프셋(offset) 거리입니다. 지정할 수 있는 값은 0 ~ 8 입니다.
 
angle:Number (default = 45) — 각도 (도수)입니다. 지정할 수 있는 값은 0 ~ 360 입니다.
 
colors:Array (default = null) — 그라데이션으로 사용하는 RGB 16 진수 칼라치의 배열입니다. 예를 들어, 빨강은 0 xFF0000, 파랑은 0x0000FF 등입니다.
 
alphas:Array (default = null)colors 배열내의 각 색에 대응하는 알파 투명도의 값의 배열입니다. 배열내의 각 엘리먼트로 지정할 수 있는 값은 0 ~ 1 입니다. 예를 들어 . 25 로 지정하면, 투명도의 값은 25% 로 설정됩니다.
 
ratios:Array (default = null) — 색분포 비율의 배열입니다. 0 ~ 255 의 범위의 값을 지정할 수 있습니다.
 
blurX:Number (default = 4.0) — 수평 방향의 애매하게 해 양입니다. 지정할 수 있는 값은 0 ~ 255 입니다. 1 이하의 값을 지정하면, 원의 이미지가 그대로 복사됩니다. 디폴트치는 4 입니다. 2 말하고 나무승 (2, 4, 8, 16, 32 등)은, 다른 값과 비교해 빠르게 렌더링 할 수 있도록(듯이) 최적화됩니다.
 
blurY:Number (default = 4.0) — 수직 방향의 애매하게 해 양입니다. 지정할 수 있는 값은 0 ~ 255 입니다. 1 이하의 값을 지정하면, 원의 이미지가 그대로 복사됩니다. 2 말하고 나무승 (2, 4, 8, 16, 32 등)은, 다른 값과 비교해 빠르게 렌더링 할 수 있도록(듯이) 최적화됩니다.
 
strength:Number (default = 1) — 흔적의 강함 또는 확대입니다. 값이 큰 만큼, 진한 색이 흔적 되므로, 베벨과 배경과의 사이의 콘트라스트가 강해집니다. 지정할 수 있는 값은 0 ~ 255 입니다. 0 을 지정하면, 필터는 적용되지 않습니다.
 
quality:int (default = 1) — 필터의 품질입니다. 다음의 BitmapFilterQuality 정수를 사용합니다.
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

상세한 것에 대하여는,quality property의 설명을 참조해 주세요.

 
type:String (default = "inner") — 베벨 효과의 배치입니다. 지정할 수 있는 값은, BitmapFilterType 정수입니다.
  • BitmapFilterType.OUTER — 베벨이 object의 외측 엣지에 배치됩니다.
  • BitmapFilterType.INNER — 베벨이 object의 안쪽 엣지에 배치됩니다.
  • BitmapFilterType.FULL — 베벨이 object 위에 배치됩니다.
 
knockout:Boolean (default = false) — 녹아웃 효과를 적용할지 어떨지를 지정합니다. true 를 지정하면, object의 칠이 투명하게 되어, 문서의 배경색이 표시됩니다.

See also

Methods의 상세
clone()Methods
public override function clone():BitmapFilter

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

반환값
BitmapFilter — 원의 GradientBevelFilter 인스턴스와 property가 모두 같다 새로운 GradientBevelFilter 인스턴스입니다.
Examples

다음의 예에서는, 정방형을 묘화 해 그라데이션베벨을 적용합니다. 이 예에 대한 일반적인 워크플로우는, 다음과 같이 됩니다.
  1. 필요한 클래스를 읽어들입니다.
  2. 정방형과 필터를 정의하는 글로벌 변수를 선언합니다.
  3. constructor    함수를 작성합니다. 이 함수는, 이하의 처리를 실시합니다.
    • draw() Methods를 호출합니다. 이 Methods는 Sprite 의 graphics property를 개입시켜 액세스 하는 Graphics 클래스의 Methods를 사용해, 회색의 정방형을 묘화 합니다.
    • filter 라는 이름의 BitmapFilter object를 작성해, 그것을 getBitmapFilter() 의 호출에 의한 반환값에 할당합니다. 이 함수는 필터를 작성합니다.
    • myFilters 라는 이름의 새로운 배열을 작성해, 거기에 filter 를 추가합니다.
    • myFilters 를 GradientGlowFilterExample object의 filters property에 GradientBevelFilterExample object의 것입니다. 이것에 의해,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();
        }
    }
}






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/flash/filters/GradientBevelFilter.html