IFlexDisplayObject  - AS3 Flex

이 표시 객체의 현재 액세스 가능성 옵션입니다. accessibilityProperties 속성 또는 accessibilityProperties의 필드 중 하나를 수정할 경우 Accessibility.updateProperties() 메서드를 호출하여 변경 사항을 적용해야 합니다.

참고: Flash 제작 환경에서 만든 객체의 경우 accessibilityProperties 값은 해당 객체의 액세스 가능성 패널에서 입력한 정보로 미리 채워집니다.

지정된 객체의 알파 투명도 값을 나타냅니다. 유효한 값은 0(완전 투명)에서 1(완전 불투명) 사이입니다. 기본값은 1입니다. alpha가 0으로 설정된 표시 객체는 눈에 보이지는 않지만 활성화되어 있습니다.

사용할 블렌드 모드를 지정하는 BlendMode 클래스 값입니다. 두 가지 방법을 사용하여 비트맵을 내부에 그릴 수 있습니다. 블렌드 모드를 사용하거나 외부 클리핑 마스크가 있는 경우에는 벡터 렌더링에 채워진 사각형 모양을 추가함으로써 비트맵을 그립니다. 이 속성을 잘못된 값으로 설정하려고 하면 Flash 런타임이 값을 BlendMode.NORMAL로 설정합니다.

blendMode 속성은 표시 객체의 각 픽셀에 영향을 미칩니다. 각 픽셀은 세 가지 색상 요소(빨강, 녹색 및 파랑)로 구성되고 각 색상 요소는 0x00에서 0xFF 사이의 값을 갖습니다. Flash Player 또는 Adobe AIR에서는 동영상 클립 픽셀의 각 색상 요소와 배경 픽셀의 대응하는 각 색상 요소를 비교합니다. 예를 들어 blendMode가 BlendMode.LIGHTEN으로 설정되어 있는 경우 Flash Player 또는 Adobe AIR는 표시 객체의 빨강 값과 배경의 빨강 값을 비교하고 둘 중 더 밝은 색상을 표시된 색상의 빨강 요소에 대한 값으로 사용합니다.

다음 표에서는 blendMode 설정에 대해 설명합니다. BlendMode 클래스는 사용할 수 있는 문자열 값을 정의합니다. 표의 그림은 다른 표시 객체 (1) 위에 놓인 원형 표시 객체 (2)에 적용된 blendMode 값을 보여 줍니다.

BlendMode 상수	그림	설명
BlendMode.NORMAL		표시 객체는 배경의 전면에 표시됩니다. 표시 객체의 픽셀 값이 배경의 픽셀 값보다 우선합니다. 표시 객체가 투명한 경우에는 배경이 보입니다.
BlendMode.LAYER		표시 객체에 대한 투명도 그룹이 만들어지도록 합니다. 이는 표시 객체가 더 처리되기 전에 임시 버퍼에서 미리 구성됨을 의미합니다. 이 작업은 표시 객체가 비트맵 캐시를 사용하여 미리 캐시된 경우 또는 표시 객체가 BlendMode.NORMAL 이외의 blendMode 설정을 갖는 자식 객체를 하나 이상 포함하는 표시 객체 컨테이너인 경우 자동으로 수행됩니다. GPU 렌더링에서는 지원되지 않습니다.
BlendMode.MULTIPLY		표시 객체의 색상 요소 값에 배경색의 색상 요소를 곱하고 0xFF로 나누어 정규화하면 보다 어두운 색상이 됩니다. 이 설정은 그림자 및 깊이 효과에 주로 사용됩니다. 예를 들어 특정한 표시 객체 픽셀의 색상 요소(예: 빨강)와 해당하는 배경 픽셀의 색상 값이 모두 0x88이라면 곱한 결과는 0x4840이 됩니다. 0xFF로 나누면 해당 색상 요소의 값 0x48이 나옵니다. 이것은 표시 객체의 색상 또는 배경색보다 어두운 그림자입니다.
BlendMode.SCREEN		표시 객체 색상의 보수(역수)에 배경색 보수를 곱하여 표백 효과를 냅니다. 이 설정은 강조 표시할 때 또는 표시 객체의 검은색 부분을 제거할 때 주로 사용됩니다.
BlendMode.LIGHTEN		표시 객체의 색상 요소와 배경색 중 보다 밝은 색(값이 큰 쪽)을 선택합니다. 이 설정은 superimposing 유형에 주로 사용됩니다. 예를 들어 표시 객체에 RGB 값이 0xFFCC33인 픽셀이 하나 있고 배경 픽셀의 RGB 값은 0xDDF800인 경우, 표시되는 픽셀의 최종 RGB 값은 0xFFF833입니다(0xFF > 0xDD, 0xCC < 0xF8, 0x33 > 0x00 = 33). GPU 렌더링에서는 지원되지 않습니다.
BlendMode.DARKEN		표시 객체의 색상 요소와 배경색 중 보다 어두운 색상(값이 작은 색상)을 선택합니다. 이 설정은 superimposing 유형에 주로 사용됩니다. 예를 들어 표시 객체에 RGB 값이 0xFFCC33인 픽셀이 하나 있고 배경 픽셀의 RGB 값은 0xDDF800인 경우, 표시되는 픽셀의 최종 RGB 값은 0xDDCC00입니다(0xFF > 0xDD, 0xCC < 0xF8, 0x33 > 0x00 = 33). GPU 렌더링에서는 지원되지 않습니다.
BlendMode.DIFFERENCE		표시 객체의 색상 요소를 배경색과 비교하여 둘 중 밝은 색상 값에서 어두운 색상 값을 뺍니다. 이 설정은 보다 강렬한 색상을 내기 위해 주로 사용됩니다. 예를 들어 표시 객체에 RGB 값이 0xFFCC33인 픽셀이 하나 있고 배경 픽셀의 RGB 값은 0xDDF800인 경우, 표시되는 픽셀의 최종 RGB 값은 0x222C33입니다(0xFF - 0xDD = 0x22, 0xF8 - 0xCC = 0x2C, 0x33 - 0x00 = 0x33).
BlendMode.ADD		표시 객체의 색상 요소 값을 배경색에 더하고 올림값 0xFF를 적용합니다. 이 설정은 두 객체 사이에서 색상을 밝게 하는 디졸브를 애니메이션 처리하는 데 주로 사용됩니다. 예를 들어 표시 객체에 RGB 값이 0xAAA633인 픽셀이 하나 있고 배경 픽셀의 RGB 값은 0xDD2200인 경우, 표시되는 픽셀의 최종 RGB 값은 0xFFC833입니다(0xAA + 0xDD > 0xFF, 0xA6 + 0x22 = 0xC8, 0x33 + 0x00 = 0x33).
BlendMode.SUBTRACT		배경색 값에서 표시 객체의 색상 요소 값을 빼고 내림값 0을 적용합니다. 이 설정은 두 객체 사이에서 색상을 어둡게 하는 디졸브를 애니메이션 처리하는 데 주로 사용됩니다. 예를 들어 표시 객체에 RGB 값이 0xAA2233인 픽셀이 하나 있고 배경 픽셀의 RGB 값은 0xDDA600인 경우, 표시되는 픽셀의 최종 RGB 값은 0x338400입니다(0xDD - 0xAA = 0x33, 0xA6 - 0x22 = 0x84, 0x00 - 0x33 < 0x00).
BlendMode.INVERT		배경을 반전시킵니다.
BlendMode.ALPHA		표시 객체에 있는 각 픽셀의 알파 값을 배경에 적용합니다. 부모 표시 객체의 blendMode를 BlendMode.LAYER로 설정해야 합니다. 예를 들어 그림에서 부모 표시 객체(흰색 배경)는 blendMode = BlendMode.LAYER를 가집니다. GPU 렌더링에서는 지원되지 않습니다.
BlendMode.ERASE		표시 객체의 알파 값을 기준으로 배경을 지웁니다. 부모 표시 객체의 blendMode를 BlendMode.LAYER로 설정해야 합니다. 예를 들어 그림에서 부모 표시 객체(흰색 배경)는 blendMode = BlendMode.LAYER를 가집니다. GPU 렌더링에서는 지원되지 않습니다.
BlendMode.OVERLAY		배경의 어두운 정도를 기준으로 각 픽셀의 색상을 조정합니다. 배경이 50% 회색보다 밝으면 표시 객체와 배경색이 차단되어 결과적으로 더 밝아집니다. 배경이 50% 회색보다 어두우면 색상이 곱해져서 결과적으로 더 어두워집니다. 이 설정은 음영 효과에 주로 사용됩니다. GPU 렌더링에서는 지원되지 않습니다.
BlendMode.HARDLIGHT		표시 객체의 어두운 정도를 기준으로 각 픽셀의 색상을 조정합니다. 표시 객체가 50% 회색보다 밝으면 표시 객체와 배경의 색상이 차단되어 결과적으로 더 밝아집니다. 표시 객체가 50% 회색보다 어두우면 색상이 곱해져서 결과적으로 더 어두워집니다. 이 설정은 음영 효과에 주로 사용됩니다. GPU 렌더링에서는 지원되지 않습니다.
BlendMode.SHADER	해당 사항 없음	사용자 정의 셰이더 루틴을 사용하여 색상을 조정합니다. 사용되는 셰이더는 blendShader 속성에 할당된 Shader 인스턴스로 지정됩니다. 표시 객체의 blendShader 속성을 Shader 인스턴스로 설정하면 이 표시 객체의 blendMode 속성이 BlendMode.SHADER로 자동 설정됩니다. 먼저 blendShader 속성을 설정하지 않은 상태에서 blendMode 속성을 BlendMode.SHADER로 설정하면 blendMode 속성이 BlendMode.NORMAL로 설정됩니다. GPU 렌더링에서는 지원되지 않습니다.

true로 설정된 경우 Flash 런타임은 표시 객체의 내부 비트맵 표현을 캐시합니다. 캐시를 통해 복잡한 벡터 내용이 포함된 표시 객체의 성능이 향상될 수 있습니다.

캐시된 비트맵이 있는 표시 객체의 모든 벡터 데이터는 기본 디스플레이가 아닌 비트맵에 그려집니다. cacheAsBitmapMatrix가 null이거나 지원되지 않으면 비트맵이 가장 가까운 픽셀 경계에 물리는 확장 및 회전되지 않은 픽셀로 기본 디스플레이에 복사됩니다. 픽셀은 부모 객체와 1대 1로 매핑됩니다. 비트맵의 경계가 변경되면 비트맵은 확장되지 않고 다시 만들어집니다.

cacheAsBitmapMatrix가 null이 아니며 지원되는 경우, 객체는 해당 행렬을 사용하여 화면에 표시되지 않는 비트맵에 그려지며 해당 렌더링이 확장 및/또는 회전된 결과가 객체를 기본 디스플레이에 그리는 데 사용됩니다.

cacheAsBitmap 속성을 true로 설정하지 않은 경우에는 내부 비트맵이 만들어지지 않습니다.

cacheAsBitmap 속성을 true로 설정하고 나면 렌더링이 변경되지는 않지만 표시 객체가 픽셀 물리기를 자동으로 수행합니다. 애니메이션 속도는 벡터 내용의 복잡도에 따라 현저하게 빨라질 수 있습니다.

cacheAsBitmap 속성은 표시 객체에 필터를 적용할 때마다(해당 filter 배열이 비어 있지 않은 경우) 자동으로 true로 설정되며, 표시 객체에 필터가 적용되어 있는 경우에는 cacheAsBitmap 속성을 false로 설정해도 해당 표시 객체에 대해 이 속성이 true로 보고됩니다. 표시 객체의 모든 필터를 지우면 cacheAsBitmap 설정이 최근 설정 내용으로 변경됩니다.

다음과 같은 경우에는 cacheAsBitmap 속성을 true로 설정해도 표시 객체가 비트맵을 사용하지 않고 벡터 데이터에서 렌더링됩니다.

• 비트맵이 너무 큰 경우. AIR 1.5 및 Flash Player 10에서는 비트맵 이미지의 최대 크기가 8,191픽셀(폭 또는 높이)이며 총 픽셀 수는 16,777,215픽셀을 초과할 수 없습니다. 따라서 비트맵 이미지의 폭이 8,191픽셀이면 높이가 2,048픽셀 이하여야 합니다. Flash Player 9 이전 버전에서는 이 제한이 높이 2,880픽셀 및 폭 2,880픽셀입니다.
• 메모리 초과 오류로 인해 비트맵이 할당되지 못한 경우

cacheAsBitmap 속성은 대부분의 내용이 정적이고 크기 조절 및 회전을 자주 사용하지 않는 동영상 클립에 사용하면 좋습니다. 이러한 동영상 클립에서 cacheAsBitmap 속성을 사용하면 동영상 클립이 변환될 때, 즉 x 및 y 위치가 변경될 때 성능이 향상될 수 있습니다.

현재 표시 객체와 연관된 각 필터 객체가 들어 있는 인덱싱된 배열입니다. flash.filters 패키지에는 사용 가능한 특정 필터를 정의하는 여러 클래스가 포함되어 있습니다.

필터는 Flash Professional에서 디자인 타임에 적용하거나, 런타임에 ActionScript 코드를 사용하여 적용할 수 있습니다. ActionScript를 사용하여 필터를 적용하려면 전체 filters 배열의 임시 복사본을 만들고, 임시 배열을 수정한 다음 filters 배열에 임시 배열의 값을 다시 지정합니다. 새 filter 객체를 filters 배열에 직접 추가할 수는 없습니다.

ActionScript를 사용하여 필터를 추가하려면 다음 단계를 수행합니다. 여기서 대상 표시 객체의 이름은 myDisplayObject로 가정합니다.

1. 사용자가 선택한 필터 클래스의 생성자 메서드를 사용하여 새 필터 객체를 만듭니다.
2. myDisplayObject.filters 배열의 값을 myFilters 등의 임시 배열에 지정합니다.
3. 새 필터 객체를 myFilters 임시 배열에 추가합니다.
4. 임시 배열의 값을 myDisplayObject.filters 배열에 지정합니다.

filters 배열이 정의되어 있지 않으면 임시 배열을 사용할 필요가 없습니다. 대신 사용자가 만든 하나 이상의 필터 객체가 포함된 배열 리터럴을 직접 지정할 수 있습니다. 예제 단원의 첫 번째 예제에서는 정의된 filters 배열과 정의되지 않은 배열을 모두 처리하는 코드를 사용하여 그림자 필터를 추가합니다.

기존 필터 객체를 수정하려면 filters 배열의 복사본을 수정해야 합니다.

1. filters 배열의 값을 myFilters 등의 임시 배열에 지정합니다.
2. 임시 배열 myFilters를 사용하여 속성을 수정합니다. 예를 들어 배열에 있는 첫 번째 필터의 품질 속성을 설정하려면 myFilters[0].quality = 1; 코드를 사용할 수 있습니다.
3. 임시 배열의 값을 filters 배열에 지정합니다.

표시 객체에 연결된 필터가 있는 경우 이 표시 객체를 로드 시 투명 비트맵으로 캐시하라는 표시가 나타납니다. 이때부터 표시 객체에 유효한 필터 목록이 있으면 플레이어는 표시 객체를 비트맵으로 캐시합니다. 이 소스 비트맵은 필터 효과에 대한 소스 이미지로 사용됩니다. 일반적으로 각 표시 객체는 필터링되지 않은 원래의 소스 표시 객체와 필터링된 최종 이미지의 두 비트맵을 가집니다. 최종 이미지는 렌더링 시 사용됩니다. 표시 객체가 변경되지 않으면 최종 이미지는 업데이트할 필요가 없습니다.

flash.filters 패키지에는 필터에 대한 클래스가 포함됩니다. 예를 들어 DropShadow 필터를 만들려면 다음을 작성합니다.

     import flash.filters.DropShadowFilter
     var myFilter:DropShadowFilter = new DropShadowFilter (distance, angle, color, alpha, blurX, blurY, quality, inner, knockout)
     

is 연산자를 사용하여 filter 배열의 각 인덱스 위치에 지정된 필터 유형을 확인할 수 있습니다. 예를 들어 다음 코드는 filters 배열에서 첫 번째 필터(DropShadowFilter)의 위치를 확인합니다.

     import flash.text.TextField;
     import flash.filters.*;
     var tf:TextField = new TextField();
     var filter1:DropShadowFilter = new DropShadowFilter();
     var filter2:GradientGlowFilter = new GradientGlowFilter();
     tf.filters = [filter1, filter2];
     
     tf.text = "DropShadow index: " + filterPosition(tf, DropShadowFilter).toString(); // 0
     addChild(tf)
     
     function filterPosition(displayObject:DisplayObject, filterClass:Class):int {
         for (var i:uint = 0; i < displayObject.filters.length; i++) {
             if (displayObject.filters[i] is filterClass) {
                 return i;
             }
         }
         return -1;
     }
     

참고: 새 filter 객체를 직접 DisplayObject.filters 배열에 추가할 수 없으므로 다음 코드는 myDisplayObject라는 대상 표시 객체에 아무런 영향을 주지 않습니다.

     myDisplayObject.filters.push(myDropShadow);
     

표시 객체의 높이를 픽셀 단위로 나타냅니다. 높이는 표시 객체 내용의 경계에 따라 계산됩니다. 다음 코드와 같이 height 속성을 설정하면 그에 따라 scaleY 속성이 조절됩니다.

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleY) // 1;
    rect.height = 200;
    trace(rect.scaleY) // 2;

TextField 및 Video 객체를 제외하고 빈 스프라이트처럼 내용이 없는 표시 객체는 height를 다른 값으로 설정하려고 해도 높이가 0입니다.

이 표시 객체가 속한 파일의 로딩 정보가 포함된 LoaderInfo 객체를 반환합니다. loaderInfo 속성은 SWF 파일의 루트 표시 객체 또는 로드된 비트맵(ActionScript로 그려진 비트맵이 아님)에 대해서만 정의됩니다. myDisplayObject라는 표시 객체를 포함하는 SWF 파일과 연관된 loaderInfo 객체를 찾으려면 myDisplayObject.root.loaderInfo를 사용합니다.

대형 SWF 파일은 this.root.loaderInfo.addEventListener(Event.COMPLETE, func)를 호출하여 다운로드를 모니터링할 수 있습니다.

호출하는 표시 객체는 지정된 mask 객체에 의해 마스크 처리됩니다. Stage 크기를 조절할 때 마스크를 적용하려면 mask 표시 객체가 표시 목록에서 활성화된 부분에 있어야 합니다. mask 객체 자체는 그려지지 않습니다. 마스크를 제거하려면 mask를 null로 설정합니다.

마스크 객체의 크기를 조절하려면 마스크 객체가 표시 목록에 있어야 합니다. startDrag() 메서드를 호출하여 마스크 Sprite 객체를 드래그하려면 해당 객체가 표시 목록에 있어야 합니다. Sprite를 통해 전달되는 mouseDown 이벤트를 기준으로 마스크 Sprite에 대한 startDrag() 메서드를 호출하려면 Sprite의 buttonMode 속성을 true로 설정합니다.

cacheAsBitmap 속성을 true로, cacheAsBitmapMatrix 속성을 Matrix 객체로 설정하여 표시 객체를 캐시할 때 마스크되는 표시 객체와 마스크가 모두 캐시되는 동일한 비트맵의 일부여야 합니다. 따라서 표시 객체를 캐시할 때는 마스크가 표시 객체의 자식이어야 합니다. 표시 목록에 있는 표시 객체의 조상을 캐시하면 마스크는 해당 조상 또는 그 후손의 자식이어야 합니다. 마스크 처리된 객체의 조상을 둘 이상 캐시하면 마스크는 표시 목록에서 마스크 처리된 객체와 가장 가까운 캐시 컨테이너의 후손이어야 합니다.

참고: 단일 mask 객체를 사용하여 둘 이상의 호출하는 표시 객체를 마스크 처리할 수는 없습니다. mask가 두 번째 표시 객체에 지정되면 첫 번째 객체의 마스크가 제거되며 해당 객체의 mask 속성이 null이 됩니다.

The measured height of this object.

This is typically hard-coded for graphical skins because this number is simply the number of pixels in the graphic. For code skins, it can also be hard-coded if you expect to be drawn at a certain size. If your size can change based on properties, you may want to also be an ILayoutManagerClient so a measure() method will be called at an appropriate time, giving you an opportunity to compute a measuredHeight.

The measured width of this object.

This is typically hard-coded for graphical skins because this number is simply the number of pixels in the graphic. For code skins, it can also be hard-coded if you expect to be drawn at a certain size. If your size can change based on properties, you may want to also be an ILayoutManagerClient so a measure() method will be called at an appropriate time, giving you an opportunity to compute a measuredHeight.

마우스 또는 사용자 입력 장치 위치의 x 좌표를 픽셀로 나타냅니다.

참고: 회전된 DisplayObject인 경우 반환된 x 좌표는 회전되지 않은 객체를 반영합니다.

마우스 또는 사용자 입력 장치 위치의 y 좌표를 픽셀로 나타냅니다.

참고: 회전된 DisplayObject인 경우 반환된 y 좌표는 회전되지 않은 객체를 반영합니다.

DisplayObject의 인스턴스 이름을 나타냅니다. 표시 객체 컨테이너의 getChildByName() 메서드를 호출함으로써 부모 표시 객체 컨테이너의 자식 목록에서 객체를 확인할 수 있습니다.

표시 객체를 특정 배경색으로 불투명하게 처리할지 여부를 지정합니다. 투명 비트맵은 알파 채널 데이터를 포함하며 투명하게 그려집니다. 불투명 비트맵은 알파 채널을 포함하지 않으며 투명 비트맵보다 빠르게 렌더링됩니다. 비트맵이 불투명인 경우 사용할 고유 배경색을 지정합니다.

배경색을 숫자 값으로 설정하면 그 숫자에 의해 지정되는 RGB 배경색을 사용한 불투명(투명하지 않은) 표면이 생성됩니다. 배경색을 null(기본값)로 설정하면 표시 객체의 배경은 투명이 됩니다.

opaqueBackground 속성은 렌더링 최적화를 위해 주로 cacheAsBitmap 속성과 함께 사용합니다. cacheAsBitmap 속성이 true로 설정된 표시 객체의 경우 opaqueBackground를 설정하면 렌더링 성능이 향상될 수 있습니다.

불투명 배경 영역은 shapeFlag 매개 변수를 true로 설정하여 hitTestPoint() 메서드를 호출할 경우에는 일치하지 않습니다.

불투명 배경 영역은 마우스 이벤트에 응답하지 않습니다.

이 표시 객체가 포함된 DisplayObjectContainer 객체를 나타냅니다. parent 속성을 사용하여 표시 목록 계층 구조에서 현재 표시 객체의 상위 표시 객체에 대한 상대 경로를 지정합니다.

다음과 같이 parent를 사용하여 표시 목록에서 여러 레벨 위로 이동할 수 있습니다.

     this.parent.parent.alpha = 20;
     

로드된 SWF 파일에 있는 표시 객체의 경우, 해당 SWF 파일이 나타내는 표시 목록의 트리 구조 부분에서 맨 위에 위치하는 표시 객체가 root 속성이 됩니다. 로드된 이미지 파일을 나타내는 Bitmap 객체의 경우 Bitmap 객체 자체가 root 속성이 됩니다. 처음으로 로드된 SWF 파일의 기본 클래스 인스턴스의 경우 표시 객체 자체가 root 속성이 됩니다. Stage 객체의 root 속성은 Stage 객체 자체입니다. 표시 목록을 벗어나지만 로드된 SWF 파일 맨 위에 있는 표시 객체의 자식인 표시 객체 컨테이너에 표시 객체를 추가하지 않는 한 해당 표시 목록에 추가하지 않은 모든 표시 객체는 root 속성이 null로 설정됩니다.

예를 들어 Sprite() 생성자 메서드를 호출하여 새 Sprite 객체를 만드는 경우 표시 목록(또는 해당 표시 목록을 벗어나지만 로드된 SWF 파일 맨 위에 있는 표시 객체의 자식인 표시 객체 컨테이너)에 이 객체를 추가하지 않는 한 객체의 root 속성은 null입니다.

로드된 SWF 파일의 경우 파일을 로드하는 데 사용된 Loader 객체가 표시 목록에 없을 수도 있지만, SWF 파일 맨 위에 있는 표시 객체는 그 값이 객체 자체로 설정된 root 속성을 갖습니다. root 속성이 설정되는 대상 표시 객체의 자식으로 추가되지 않으면 Loader 객체는 해당 root 속성을 설정하지 않습니다.

DisplayObject 인스턴스가 원점으로부터 회전한 각도입니다. 0~180 사이의 값은 시계 방향 회전을 나타내고 0~-180 사이의 값은 시계 반대 방향 회전을 나타냅니다. 이 범위를 벗어나는 값은 360을 더하거나 빼서 범위 내의 값을 구합니다. 예를 들어 my_video.rotation = 450 문은 my_video.rotation = 90 문과 같습니다.

현재 적용 중인 크기 조절 격자입니다. null로 설정된 경우 크기 조절 변형을 적용하면 전체 표시 객체의 크기가 정상적으로 조절됩니다.

scale9Grid 속성을 정의하면 표시 객체가 격자의 중심을 정의하는 scale9Grid 사각형을 기준으로 9개의 영역이 있는 격자로 분리됩니다. 격자의 나머지 8개 영역은 다음과 같습니다.

• 사각형 밖의 왼쪽 위 모서리
• 사각형 위쪽 영역
• 사각형 밖의 오른쪽 위 모서리
• 사각형의 왼쪽 영역
• 사각형의 오른쪽 영역
• 사각형 밖의 왼쪽 아래 모서리
• 사각형 아래쪽 영역
• 사각형 밖의 오른쪽 아래 모서리

중심 바깥쪽에 있는 8개 영역(사각형에 의해 정의됨)은 크기를 조절할 때 특별한 규칙이 적용된 그림 프레임으로 간주할 수 있습니다.

scale9Grid 속성이 설정된 상태에서 표시 객체의 크기를 조절하면 모든 텍스트와 그래디언트의 크기가 정상적으로 조절되지만 다른 유형의 객체에는 다음과 같은 규칙이 적용됩니다.

• 가운데 영역의 내용은 정상적으로 크기 조절됩니다.
• 모서리의 내용은 크기 조절되지 않습니다.
• 위쪽과 아래쪽 영역의 내용은 가로 방향으로만 크기가 조절됩니다. 왼쪽과 오른쪽 영역의 내용은 세로 방향으로만 크기가 조절됩니다.
• 모든 채우기(비트맵, 비디오, 그래디언트 포함)가 확장되어 해당 모양에 맞춰집니다.

표시 객체가 회전되면 이후의 모든 크기 조절은 정상적으로 수행되며 scale9Grid 속성은 무시됩니다.

예를 들어 다음과 같이 표시 객체와 이 표시 객체의 scale9Grid 속성으로 적용되는 사각형을 생각해 볼 수 있습니다.

표시 객체입니다.

빨간색 사각형이 scale9Grid를 나타냅니다.

표시 객체의 크기를 조절하거나 확장하는 경우 사각형 안의 객체는 정상적으로 크기가 조절되지만 사각형 밖의 객체는 scale9Grid 규칙에 따라 크기가 조절됩니다.

75%로 크기 조절
50%로 크기 조절
25%로 크기 조절
가로로 150% 확장

scale9Grid 설정은 구성 요소로 사용할 표시 객체를 설정하는 데 주로 사용되며, 구성 요소의 크기를 조절할 때 가장자리 영역은 같은 폭을 유지합니다.

등록 포인트에서 적용된 객체의 가로 크기(백분율)를 나타냅니다. 기본 등록 포인트는 (0,0)입니다. 1.0은 100% 크기와 같습니다.

로컬 좌표계의 크기를 조절하면 전체 픽셀에 정의된 x 및 y 속성 값이 변경됩니다.

객체의 등록 포인트에서 적용된 객체의 세로 크기(백분율)를 나타냅니다. 기본 등록 포인트는 (0,0)입니다. 1.0은 100% 크기와 같습니다.

로컬 좌표계의 크기를 조절하면 전체 픽셀에 정의된 x 및 y 속성 값이 변경됩니다.

표시 객체의 스크롤 사각형 경계입니다. 표시 객체는 사각형에 의해 정의된 크기로 잘리고, 사용자가 scrollRect 객체의 x 및 y 속성을 변경할 때 해당 사각형 내에서 스크롤합니다.

scrollRect Rectangle 객체의 속성은 표시 객체의 좌표 공간을 사용하며 전체 표시 객체처럼 크기가 조절됩니다. 스크롤하는 표시 객체에서 잘려진 창의 모서리 경계는 표시 객체의 원점(0,0) 및 사각형의 폭과 높이에 의해 정의된 점입니다. 이러한 점은 원점 근처인 가운데에 배치되지 않습니다. 영역의 왼쪽 위 모서리를 원점을 사용하여 정의합니다. 스크롤된 표시 객체는 항상 전체 픽셀 증분 내에서 스크롤됩니다.

scrollRect Rectangle 객체의 x 속성을 설정하여 객체를 좌우로 스크롤할 수 있습니다. scrollRect Rectangle 객체의 y 속성을 설정하여 객체를 상하로 스크롤할 수 있습니다. 표시 객체를 90° 회전하고 좌우로 스크롤하면 실제로는 해당 표시 객체가 상하로 스크롤된 것입니다.

scrollRect 속성에 대한 변경 사항은 객체가 렌더링될 경우에만 처리됩니다. 따라서 localToGlobal과 같은 메서드는 scrollRect를 수정한 직후에 호출할 경우 예상과 다른 결과를 가져올 수 있습니다.

참고: Flash Player 11.4/AIR 3.4부터는 사각형의 폭 또는 너비 값이 음수인 경우 0으로 변경됩니다.

표시 객체의 Stage입니다. Flash 런타임 응용 프로그램에는 Stage 객체가 한 개뿐입니다. 예를 들어 여러 표시 객체를 만들어 표시 목록에 로드하는 경우 각 표시 객체의 stage 속성은 동일한 Stage 객체를 나타내며, 로드된 SWF 파일에 속한 표시 목록의 경우에도 마찬가지입니다.

표시 객체가 표시 목록에 추가되지 않은 경우 해당 stage 속성은 null로 설정됩니다.

표시 객체의 행렬, 색상 변환 및 픽셀 경계와 관련된 속성을 가진 객체입니다. 특수 속성인 matrix, colorTransform 및 세 가지 읽기 전용 속성(concatenatedMatrix, concatenatedColorTransform 및 pixelBounds)은 Transform 클래스에 대한 항목에 설명되어 있습니다.

transform 객체의 각 속성들은 그 자체가 객체입니다. matrix 또는 colorTransform 객체에 새 값을 설정하는 방법은 새 객체를 만들고 해당 객체를 transform.matrix 또는 transform.colorTransform 속성에 복사하는 방법 한 가지뿐이므로 이 사항은 매우 중요합니다.

예를 들어 표시 객체 행렬의 tx 값을 늘리려면 전체 행렬 객체의 복사본을 만들고 새 객체를 변환 객체의 행렬 속성에 복사해야 합니다.

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

tx 속성은 직접 설정할 수 없습니다. 다음 코드는 myDisplayObject에 아무런 영향을 주지 않습니다.

    myDisplayObject.transform.matrix.tx += 10;
    

또한 전체 변환 객체를 복사하여 이 객체를 다른 표시 객체의 변환 속성에 지정할 수도 있습니다. 예를 들어 다음 코드에서는 전체 변환 객체를 myOldDisplayObj에서 myNewDisplayObj로 복사합니다.

이제 결과 표시 객체인 myNewDisplayObj의 행렬, 색상 변환 및 픽셀 경계에 대한 값은 이전 표시 객체인 myOldDisplayObj의 값과 같습니다.

AIR for TV 장치는 하드웨어 가속을 사용할 수 있는 경우 색상 변환에 하드웨어 가속을 자동으로 사용합니다.

표시 객체가 표시되는지 여부를 나타냅니다. 표시되지 않는 표시 객체는 비활성화됩니다. 예를 들어 InteractiveObject 인스턴스에 대해 visible=false이면 이를 클릭할 수 없습니다.

표시 객체의 폭을 픽셀 단위로 나타냅니다. 폭은 표시 객체 내용의 경계에 따라 계산됩니다. 다음 코드와 같이 width 속성을 설정하면 그에 따라 scaleX 속성이 조절됩니다.

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleX) // 1;
    rect.width = 200;
    trace(rect.scaleX) // 2;

TextField 및 Video 객체를 제외하고 빈 스프라이트처럼 내용이 없는 표시 객체는 width를 다른 값으로 설정하려고 해도 폭이 0입니다.

부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 x 좌표를 나타냅니다. 변형이 있는 DisplayObjectContainer 내부의 객체는 해당하는 DisplayObjectContainer의 로컬 좌표계에 속합니다. 그러므로 DisplayObjectContainer를 시계 반대 방향으로 90° 회전시킬 경우, DisplayObjectContainer의 자식은 시계 반대 방향으로 90° 회전된 좌표계를 상속받게 됩니다. 객체의 좌표계는 등록 포인트의 위치를 가리킵니다.

부모 DisplayObjectContainer의 로컬 좌표를 기준으로 DisplayObject 인스턴스의 y 좌표를 나타냅니다. 변형이 있는 DisplayObjectContainer 내부의 객체는 해당하는 DisplayObjectContainer의 로컬 좌표계에 속합니다. 그러므로 DisplayObjectContainer를 시계 반대 방향으로 90° 회전시킬 경우, DisplayObjectContainer의 자식은 시계 반대 방향으로 90° 회전된 좌표계를 상속받게 됩니다. 객체의 좌표계는 등록 포인트의 위치를 가리킵니다.

targetCoordinateSpace 객체의 좌표계를 기준으로 표시 객체의 영역을 정의하는 사각형을 반환합니다. 다음 코드는 메서드에 전달한 targetCoordinateSpace 매개 변수에 따라 반환된 사각형이 달라지는 결과를 보여 줍니다.

     var container:Sprite = new Sprite();
     container.x = 100;
     container.y = 100;
     this.addChild(container);
     var contents:Shape = new Shape();
     contents.graphics.drawCircle(0,0,100);
     container.addChild(contents);
     trace(contents.getBounds(container));
      // (x=-100, y=-100, w=200, h=200)
     trace(contents.getBounds(this));
      // (x=0, y=0, w=200, h=200)
     

참고: localToGlobal() 및 globalToLocal() 메서드를 사용하면 표시 객체의 로컬 좌표를 표시 좌표로, 또는 표시 좌표를 로컬 좌표로 각각 변환할 수 있습니다.

getBounds() 메서드는 getRect() 메서드와 유사하지만, getBounds() 메서드가 반환한 사각형에는 모양에 획이 있고 getRect() 메서드가 반환한 사각형에는 획이 없다는 점이 다릅니다. 이에 대한 예제는 getRect() 메서드 설명 부분을 참조하십시오.

매개 변수

targetCoordinateSpace 매개 변수에 의해 정의되는 좌표계를 기준으로 모양의 획을 제외하고 표시 객체의 경계를 정의하는 사각형을 반환합니다. getRect() 메서드에서 반환된 값은 getBounds() 메서드에서 반환된 값보다 작거나 같습니다.

참고: localToGlobal() 및 globalToLocal() 메서드를 사용하면 표시 객체의 로컬 좌표를 Stage 좌표로, 또는 Stage 좌표를 로컬 좌표로 각각 변환할 수 있습니다.

매개 변수

point 객체를 Stage 전역 좌표에서 표시 객체의 로컬 좌표로 변환합니다.

이 메서드를 사용하려면 먼저 Point 클래스의 인스턴스를 만듭니다. 지정하는 x 및 y 값은 기본 표시 영역의 원점(0,0)을 기준으로 하기 때문에 전역 좌표를 나타냅니다. 그런 다음 Point 인스턴스를 globalToLocal() 메서드에 매개 변수로 전달합니다. 이 메서드는 표시 객체의 원점이 아니라 Stage의 원점을 기준으로 x 및 y 값을 갖는 새 Point 객체를 반환합니다.

매개 변수

표시 객체의 경계 상자를 평가하여 obj 표시 객체의 경계 상자와 겹치거나 교차하는지 확인합니다.

매개 변수

표시 객체를 평가하여 x 및 y 매개 변수에 의해 지정된 점과 겹치거나 교차하는지 확인합니다. x 및 y 매개 변수는 표시 객체 컨테이너가 Stage가 아닌 한 표시 객체를 포함하는 표시 객체 컨테이너가 아닌 Stage의 좌표 공간에 점을 지정합니다.

매개 변수

point 객체를 표시 객체의 로컬 좌표에서 Stage 전역 좌표로 변환합니다.

이 메서드를 사용하면 지정된 x 및 y 좌표를 특정 표시 객체의 원점(0,0)을 기준으로 하는 값(로컬 좌표)에서 Stage 원점을 기준으로 하는 값(전역 좌표)으로 변환할 수 있습니다.

이 메서드를 사용하려면 먼저 Point 클래스의 인스턴스를 만듭니다. 지정하는 x 및 y 값은 표시 객체의 원점을 기준으로 하기 때문에 로컬 좌표를 나타냅니다.

그런 다음, 만들어진 Point 인스턴스를 localToGlobal() 메서드에 매개 변수로 전달합니다. 이 메서드는 표시 객체의 원점이 아니라 Stage 원점을 기준으로 x 및 y 값을 갖는 새 Point 객체를 반환합니다.

매개 변수

Moves this object to the specified x and y coordinates.

매개 변수

Sets the actual size of this object.

This method is mainly for use in implementing the updateDisplayList() method, which is where you compute this object's actual size based on its explicit size, parent-relative (percent) size, and measured size. You then apply this actual size to the object by calling setActualSize().

In other situations, you should be setting properties such as width, height, percentWidth, or percentHeight rather than calling this method.

매개 변수