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

BevelFilter 클래스를 사용하면, 표시 object에 베벨 효과를 추가할 수 있습니다. 버튼등의 object에 베벨 효과를 적용하면 3 차원적으로 표현됩니다. 다른 하이라이트 칼라, 그림자 칼라, 베벨의 애매하게 해 양, 베벨의 각도, 베벨의 배치, 녹아웃 효과를 사용해, 베벨의 외관을 customizable 할 수 있습니다. 이 필터는, MovieClip, SimpleButton, TextField, Video object등의 DisplayObject 클래스로부터 Inheritance한 표시 object, 및 BitmapData object에 적용할 수 있습니다.

새로운 필터를 작성하려면 , constructor    new BevelFilter() 를 사용합니다. 필터의 사용 방법은, 필터의 적용처 object에 따라서 다릅니다.

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

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

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

View the examples

See also

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


Public property
 property정의
  angle : Number
베벨의 각도입니다.
BevelFilter
  blurX : Number
수평 방향의 애매하게 해 양 (픽셀 단위)입니다.
BevelFilter
  blurY : Number
수직 방향의 애매하게 해 양 (픽셀 단위)입니다.
BevelFilter
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  distance : Number
베벨의 오프셋(offset) 거리입니다.
BevelFilter
  highlightAlpha : Number
하이라이트 칼라의 알파 투명도의 값입니다.
BevelFilter
  highlightColor : uint
베벨의 하이라이트 칼라입니다.
BevelFilter
  knockout : Boolean
true 의 경우는, 녹아웃 효과를 적용합니다. 그 결과, object는 문서의 배경색으로 표시되어, 완전하게 투명하게 됩니다.
BevelFilter
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  quality : int
필터를 적용하는 회수입니다.
BevelFilter
  shadowAlpha : Number
그림자 칼라의 알파 투명도의 값입니다.
BevelFilter
  shadowColor : uint
베벨의 그림자 칼라입니다.
BevelFilter
  strength : Number
흔적의 강함 또는 확대입니다.
BevelFilter
  type : String
object에서의 베벨의 배치입니다.
BevelFilter
Public Methods
 Methods정의
  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)
지정된 Parameters로 새로운 BevelFilter 인스턴스를 초기화합니다.
BevelFilter
  clone ():BitmapFilter
이 필터 object의 복사를 돌려줍니다.
BevelFilter
 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의 상세
angleproperty
angle:Number   [read-write]

베벨의 각도입니다. 유효한 값의 범위는 0 ~ 360° 입니다. 디폴트치는 45° 입니다.

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

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

수평 방향의 애매하게 해 양 (픽셀 단위)입니다. 지정할 수 있는 값은 0 ~ 255 (부동 소수)입니다. 디폴트치는 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 (부동 소수)입니다. 디폴트치는 4 입니다. 2 말하고 나무승 (2, 4, 8, 16, 32 등)은, 다른 값과 비교해 빠르게 렌더링 할 수 있도록(듯이) 최적화됩니다.

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

베벨의 오프셋(offset) 거리입니다. 이 값은 픽셀 단위로 지정합니다 (부동 소수치). 디폴트는 4 입니다.

Implements
    public function get distance():Number
    public function set distance(value:Number ):void
highlightAlphaproperty 
highlightAlpha:Number   [read-write]

하이라이트 칼라의 알파 투명도의 값입니다. 값에는, 0 ~ 1 의 정규화한 값을 지정합니다. 예를 들어 . 25 를 지정하면, 투명치 25% 가 설정됩니다. 디폴트치는 1 입니다.

Implements
    public function get highlightAlpha():Number
    public function set highlightAlpha(value:Number ):void
highlightColorproperty 
highlightColor:uint   [read-write]

베벨의 하이라이트 칼라입니다. 지정할 수 있는 값은, 16 진수 형식 (0xRRGGBB)입니다. 디폴트치는 0xFFFFFF 입니다.

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

true 의 경우는, 녹아웃 효과를 적용합니다. 그 결과, object는 문서의 배경색으로 표시되어, 완전하게 투명하게 됩니다. 디폴트치는 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 의 값을 줄이는 것만으로, 같은 효과를 얻을 수 있습니다. 이 방법을 실행하면, 보다 고속으로 렌더링 됩니다.

다음의 BitmapFilterQuality 정수를 사용해,quality property의 값을 지정할 수 있습니다.

Implements
    public function get quality():int
    public function set quality(value:int ):void
shadowAlphaproperty 
shadowAlpha:Number   [read-write]

그림자 칼라의 알파 투명도의 값입니다. 값에는, 0 ~ 1 의 정규화한 값을 지정합니다. 예를 들어 . 25 를 지정하면, 투명치 25% 가 설정됩니다. 디폴트는 1 입니다.

Implements
    public function get shadowAlpha():Number
    public function set shadowAlpha(value:Number ):void
shadowColorproperty 
shadowColor:uint   [read-write]

베벨의 그림자 칼라입니다. 지정할 수 있는 값은, 16 진수 형식 (0xRRGGBB)입니다. 디폴트치는 0x000000 입니다.

Implements
    public function get shadowColor():uint
    public function set shadowColor(value:uint ):void
strengthproperty 
strength:Number   [read-write]

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

Implements
    public function get strength():Number
    public function set strength(value:Number ):void
typeproperty 
type:String   [read-write]

object에서의 베벨의 배치입니다. 안쪽 및 외측의 베벨은, 안쪽 또는 외측의 엣지에 배치되어 풀 베벨은 object 전체에 배치됩니다. 지정할 수 있는 값은, 다음의 BitmapFilterType 정수입니다.

Implements
    public function get type():String
    public function set type(value:String ):void

Throws
TypeError — 캐릭터 라인은, 설정시에 null 로 설정됩니다.
constructor    의 상세
BevelFilter()constructor   
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)

지정된 Parameters로 새로운 BevelFilter 인스턴스를 초기화합니다.

Parameters
distance:Number (default = 4.0) — 베벨의 오프셋(offset) 거리 (픽셀 단위)입니다 (부동 소수).
 
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 의 경우는, 녹아웃 효과를 적용합니다. 그 결과, object는 문서의 배경색으로 표시되어, 완전하게 투명하게 됩니다.

See also

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

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

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

다음의 예에서는, 어두운 황색의 정방형을 작성해, 밝은 황색 (0xFFFF00)의 하이라이트와 파랑 (0x0000FF)의 그림자로 베벨을 적용합니다. 이 예에 대한 일반적인 워크플로우는, 다음과 같이 됩니다.
  1. 필요한 클래스를 읽어들입니다.
  2. draw() 함수로 사용하는 3 개의 property를 선언합니다. 이 함수는, 베벨 필터의 적용처의 object를 묘화 합니다.
  3. BevelFilterExample() constructor    함수를 작성합니다. 이 함수는, 이하의 처리를 실시합니다.
    • draw() 함수를 호출합니다. 이 함수는 다음에 선언됩니다.
    • BitmapFilter object로서 변수 filter 를 선언해, 이 변수를 getBitmapFilter() 의 반환값에 할당합니다.
    • 새로운 Array object myFilters 를 작성해,filter 를 배열에 추가해,myFilters 를 BevelFilterExample object의 filters property에 할당합니다. 이것에 의해,myFilters 로 발견된 모든 필터가 적용됩니다. 이 경우, filter 뿐입니다.
  4. getBitmapFilter 함수를 작성해, 필터의 property를 작성해 설정합니다.
  5. draw() 함수를 작성합니다. 이 함수는 Graphics 클래스의 Methods를 사용합니다. 이 클래스에는 Sprite 클래스의 graphics property를 개입시켜 액세스 해, 사각형을 묘화 합니다.
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://flexdocs.kr/docs/flex2/langref/flash/filters/BevelFilter.html