패키지flash.filters
클래스public final class BevelFilter
상속BevelFilter Inheritance BitmapFilter Inheritance Object

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

BevelFilter 클래스를 사용하여 표시 객체에 경사 효과를 추가할 수 있습니다. 경사 효과는 버튼 같은 객체를 입체적으로 보이게 만듭니다. 다양한 강조 표시와 그림자 색상, 경사를 흐리게 처리하는 정도, 경사의 각도, 경사의 위치 및 녹아웃 효과 등을 사용하여 경사의 모양을 사용자 정의할 수 있습니다. BitmapData 객체는 물론 MovieClip, SimpleButton, TextField 및 Video 객체와 같은 임의의 표시 객체(DisplayObject 클래스로부터 상속되는 객체)에도 필터를 적용할 수 있습니다.

새 필터를 만들려면 new BevelFilter() 생성자를 사용합니다. 필터 사용은 필터를 적용할 객체에 따라 달라집니다.

표시 객체에 필터를 적용하면 해당 객체의 cacheAsBitmap 속성이 true로 설정됩니다. 모든 필터를 제거하면 cacheAsBitmap의 원래 값이 복원됩니다.

이 필터에서는 스테이지의 크기를 조절할 수 있습니다. 그러나 전체 크기 조절, 회전 및 기울임은 지원하지 않습니다. 객체 자체의 크기가 조절된 경우(scaleXscaleY 속성이 100%로 설정되지 않은 경우) 필터 효과의 크기는 조절되지 않습니다. 스테이지에서 확대할 때만 크기가 조절됩니다.

결과 이미지의 폭 또는 높이가 2,880픽셀을 초과하는 경우 필터는 적용되지 않습니다. 예를 들어, 필터가 적용된 큰 무비 클립을 확대하는 경우 결과 이미지가 2,880픽셀 제한을 초과하면 필터가 해제됩니다.

예제를 통해 확인하십시오.

참고 사항

flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()


Public 속성
 속성다음에 의해 정의됨
  angle : Number
경사의 각도입니다.
BevelFilter
  blurX : Number
수평 흐림 효과의 정도(픽셀 단위)입니다.
BevelFilter
  blurY : Number
수직 흐림 효과의 정도(픽셀 단위)입니다.
BevelFilter
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  distance : Number
경사의 오프셋 거리입니다.
BevelFilter
  highlightAlpha : Number
강조 표시 색상의 알파 투명도 값입니다.
BevelFilter
  highlightColor : uint
경사에 대한 강조 표시 색상입니다.
BevelFilter
  knockout : Boolean
효과적으로 객체를 투명하게 채우고 문서의 배경색을 나타낼 수 있는 녹아웃 효과를 적용(true)합니다.
BevelFilter
 Inheritedprototype : Object
[static] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  quality : int
필터 적용 횟수입니다.
BevelFilter
  shadowAlpha : Number
그림자 색상의 알파 투명도 값입니다.
BevelFilter
  shadowColor : uint
경사에 대한 그림자 색상입니다.
BevelFilter
  strength : Number
인쇄나 분사 강도를 나타냅니다.
BevelFilter
  type : String
객체에서 경사 효과의 배치를 나타냅니다.
BevelFilter
Public 메서드
 메서드다음에 의해 정의됨
  
BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
새로운 BevelFilter 인스턴스를 지정된 매개 변수로 초기화합니다.
BevelFilter
  
이 필터 객체의 복사본을 반환합니다.
BevelFilter
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
속성 정보
angle속성
angle:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

경사의 각도입니다. 유효 값은 0 ~ 360°입니다. 기본값은 45°입니다.

각도 값은 객체에 해당하는 가상 광원의 각도를 나타내며 이 값으로 해당 객체를 기준으로 효과의 배치를 결정합니다. distance 속성을 0으로 설정하면 효과가 객체로부터 오프셋되지 않으므로 angle 속성은 아무런 영향을 주지 않습니다.


구현
    public function get angle():Number
    public function set angle(value:Number):void
blurX속성 
blurX:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

수평 흐림 효과의 정도(픽셀 단위)입니다. 유효 값은 0부터 255(부동 소수점)까지입니다. 기본값은 4입니다. 2의 거듭제곱 값(예: 2, 4, 8, 16, 32 등)은 다른 값보다 빠르게 렌더링하도록 최적화되었습니다.


구현
    public function get blurX():Number
    public function set blurX(value:Number):void
blurY속성 
blurY:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

수직 흐림 효과의 정도(픽셀 단위)입니다. 유효 값은 0부터 255(부동 소수점)까지입니다. 기본값은 4입니다. 2의 거듭제곱 값(예: 2, 4, 8, 16, 32 등)은 다른 값보다 빠르게 렌더링하도록 최적화되었습니다.


구현
    public function get blurY():Number
    public function set blurY(value:Number):void
distance속성 
distance:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

경사의 오프셋 거리입니다. 유효한 값의 단위는 픽셀(부동 소수점)입니다. 기본값은 4입니다.


구현
    public function get distance():Number
    public function set distance(value:Number):void
highlightAlpha속성 
highlightAlpha:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

강조 표시 색상의 알파 투명도 값입니다. 값은 0부터 1까지의 정규화된 값이 지정됩니다. 예를 들어, .25는 투명도 값을 25%로 설정합니다. 기본값은 1입니다.


구현
    public function get highlightAlpha():Number
    public function set highlightAlpha(value:Number):void
highlightColor속성 
highlightColor:uint  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

경사에 대한 강조 표시 색상입니다. 유효 값은 16진수 형식인 0xRRGGBB로 표시됩니다. 기본값은 0xFFFFFF입니다.


구현
    public function get highlightColor():uint
    public function set highlightColor(value:uint):void
knockout속성 
knockout:Boolean  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

효과적으로 객체를 투명하게 채우고 문서의 배경색을 나타낼 수 있는 녹아웃 효과를 적용(true)합니다. 기본값은 false(녹아웃 효과 사용 안 함)입니다.


구현
    public function get knockout():Boolean
    public function set knockout(value:Boolean):void
quality속성 
quality:int  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

필터 적용 횟수입니다. 기본값은 BitmapFilterQuality.LOW로서 필터를 1회 적용하는 것과 동일합니다. 값 BitmapFilterQuality.MEDIUM은 필터를 2회 적용하고 값 BitmapFilterQuality.HIGH는 3회 적용합니다. 낮은 값을 가진 필터가 보다 빠르게 렌더링됩니다.

대부분의 응용 프로그램의 경우 quality 값을 낮음, 중간, 높음으로 설정하면 충분합니다. 15까지의 추가적인 숫자 값을 사용하여 다른 효과를 얻을 수 있으나 값이 높을수록 렌더링 속도가 느려집니다. quality 값을 올리는 대신 간단히 blurXblurY 속성의 값을 올려도 보다 빠른 렌더링으로 유사한 효과를 얻을 수 있습니다.

다음과 같은 BitmapFilterQuality 상수를 사용하여 quality 속성의 값을 지정할 수 있습니다.


구현
    public function get quality():int
    public function set quality(value:int):void
shadowAlpha속성 
shadowAlpha:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

그림자 색상의 알파 투명도 값입니다. 이 값은 0부터 1까지의 정규화된 값이 지정됩니다. 예를 들어, .25는 투명도 값을 25%로 설정합니다. 기본값은 1입니다.


구현
    public function get shadowAlpha():Number
    public function set shadowAlpha(value:Number):void
shadowColor속성 
shadowColor:uint  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

경사에 대한 그림자 색상입니다. 유효 값은 16진수 형식인 0xRRGGBB로 표시됩니다. 기본값은 0x000000입니다.


구현
    public function get shadowColor():uint
    public function set shadowColor(value:uint):void
strength속성 
strength:Number  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

인쇄나 분사 강도를 나타냅니다. 유효 값은 0부터 255까지입니다. 값이 클수록 보다 많은 색상이 인쇄되고 경사와 배경 사이의 대비가 보다 뚜렷해집니다. 기본값은 1입니다.


구현
    public function get strength():Number
    public function set strength(value:Number):void
type속성 
type:String  [read-write]

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

객체에서 경사 효과의 배치를 나타냅니다. 내부 및 외부 경사는 내부 또는 외부 가장자리에 경사 효과를 적용하고, 전체 경사는 객체 전체에 경사 효과를 적용합니다. 유효 값은 다음과 같은 BitmapFilterType 상수입니다.


구현
    public function get type():String
    public function set type(value:String):void

오류
TypeError — 설정 중인 문자열이 null입니다.
생성자 정보
BevelFilter()생성자
public function BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

새로운 BevelFilter 인스턴스를 지정된 매개 변수로 초기화합니다.

매개 변수
distance:Number (default = 4.0) — 경사의 오프셋 거리로, 단위는 픽셀(부동 소수점)입니다.
 
angle:Number (default = 45) — 경사의 각도로, 범위는 0 ~ 360도입니다.
 
highlightColor:uint (default = 0xFFFFFF) — 경사의 강조 표시 색상으로, 0xRRGGBB 형식으로 표시됩니다.
 
highlightAlpha:Number (default = 1.0) — 강조 표시 색상의 알파 투명도 값입니다. 유효 값은 0.0부터 1.0까지입니다. 예를 들어, .25는 투명도 값을 25%로 설정합니다.
 
shadowColor:uint (default = 0x000000) — 경사에 대한 그림자 색상으로, 0xRRGGBB의 형식으로 표시됩니다.
 
shadowAlpha:Number (default = 1.0) — 그림자 색상의 알파 투명도 값입니다. 유효 값은 0.0부터 1.0까지입니다. 예를 들어, .25는 투명도 값을 25%로 설정합니다.
 
blurX:Number (default = 4.0) — 수평 방향으로 흐리게 처리하는 정도를 나타내는 것으로, 단위는 픽셀입니다. 유효 값은 0부터 255.0(부동 소수점)까지입니다.
 
blurY:Number (default = 4.0) — 수직 방향으로 흐리게 처리하는 정도를 나타내는 것으로, 단위는 픽셀입니다. 유효 값은 0부터 255.0(부동 소수점)까지입니다.
 
strength:Number (default = 1) — 인쇄나 분사 강도를 나타냅니다. 값이 클수록 보다 많은 색상이 인쇄되고 경사와 배경 사이의 대비가 보다 뚜렷해집니다. 유효 값은 0부터 255.0까지입니다.
 
quality:int (default = 1) — 경사의 품질입니다. 유효 값은 0부터 15까지입니다. 그러나 대부분의 응용 프로그램에서 다음과 같은 BitmapFilterQuality 상수를 사용할 수 있습니다.
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

낮은 값을 가진 필터가 보다 빠르게 렌더링됩니다. 다른 가능한 숫자 값을 사용하여 다른 효과를 얻을 수 있습니다.

 
type:String (default = "inner") — 경사의 유형입니다. 유효 값은 BitmapFilterType 상수로, BitmapFilterType.INNER, BitmapFilterType.OUTER 또는 BitmapFilterType.FULL입니다.
 
knockout:Boolean (default = false) — 효과적으로 객체를 투명하게 채우고 문서의 배경색을 나타낼 수 있는 녹아웃 효과(true)를 적용합니다.

참고 사항

메서드 정보
clone()메서드
public override function clone():BitmapFilter

언어 버전 : ActionScript 3.0
Player 버전 : Flash Player 9

이 필터 객체의 복사본을 반환합니다.

반환값
BitmapFilter — 원본 BevelFilter 인스턴스와 속성이 모두 같은 새 BevelFilter 인스턴스입니다.
예제 예제 사용 방법
BevelFilterExample.as

다음 예제에서는 어두운 노랑 사각형을 만든 다음 밝은 노랑(0xFFFF00)을 강조 색상으로, 파랑(0x0000FF)을 그림자로 한 경사 효과를 적용합니다. 이 예제의 일반적인 작업 단계는 다음과 같습니다.
  1. 필요한 클래스를 가져옵니다.
  2. draw() 함수에서 사용할 세 가지 속성을 선언합니다. 이 함수는 경사 필터를 적용할 객체를 그립니다.
  3. 다음과 같은 기능을 하는 BevelFilterExample() 생성자 함수를 만듭니다.
    • 나중에 선언될 draw() 함수를 호출합니다.
    • filter 변수를 BitmapFilter 객체로 선언하고, 이 객체를 getBitmapFilter() 호출의 반환 값에 할당합니다.
    • 새 Array 객체 myFilters를 만들고 filter를 배열에 추가한 다음 myFilters를 BevelFilterExample 객체의 filters 속성에 할당합니다. 이것은 myFilters의 모든 필터에 적용되며, 이 경우에는 filter뿐입니다.
  4. 필터의 속성을 만들고 설정하는 getBitmapFilter 함수를 만듭니다.
  5. draw() 함수를 만듭니다. 이 함수는 Sprite 클래스의 graphics 속성을 통해 액세스되는 Graphics 클래스의 메서드를 사용하여 사각형을 그립니다.
package {
    import flash.display.Sprite;
    import flash.filters.BevelFilter;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BitmapFilterType;

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

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

        private function getBitmapFilter():BitmapFilter {
            var distance:Number       = 5;
            var angleInDegrees:Number = 45;
            var highlightColor:Number = 0xFFFF00;
            var highlightAlpha:Number = 0.8;
            var shadowColor:Number    = 0x0000FF;
            var shadowAlpha:Number    = 0.8;
            var blurX:Number          = 5;
            var blurY:Number          = 5;
            var strength:Number       = 5;
            var quality:Number        = BitmapFilterQuality.HIGH;
            var type:String           = BitmapFilterType.INNER;
            var knockout:Boolean      = false;

            return new BevelFilter(distance,
                                   angleInDegrees,
                                   highlightColor,
                                   highlightAlpha,
                                   shadowColor,
                                   shadowAlpha,
                                   blurX,
                                   blurY,
                                   strength,
                                   quality,
                                   type,
                                   knockout);
        }

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




 

이 페이지에 의견 추가되면 전자 메일 알림 받기 | 의견 보고서

현재 페이지: http://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/flash/filters/BevelFilter.html