BitmapImage

패키지	spark.primitives
클래스	public class BitmapImage
상속	BitmapImage GraphicElement EventDispatcher Object

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.0

런타임 버전:

Flash Player 10, AIR 2.0

A BitmapImage element defines a rectangular region in its parent element's coordinate space, filled with bitmap data drawn from a source file or source URL.

예제 보기

기타 예제

Using MXML graphics
Bitmap graphics
Select bitmap assets based on DPI

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		alpha : Number The level of transparency of the graphic element.	GraphicElement
		alwaysCreateDisplayObject : Boolean Specifies that this GraphicElement is to be associated with and be rendered to its own DisplayObject.	GraphicElement
		baseline : Object The vertical distance in pixels from the anchor target to the control's baseline position.	GraphicElement
		baselinePosition : Number [읽기 전용] The y-coordinate of the baseline of the first line of text of the component.	GraphicElement
		bitmapData : BitmapData [읽기 전용] Returns a copy of the BitmapData object representing the currently loaded image content (unscaled).	BitmapImage
		blendMode : String A value from the BlendMode class that specifies which blend mode to use.	GraphicElement
		bottom : Object The vertical distance in pixels from the bottom edge of the component to the anchor target's bottom edge.	GraphicElement
		bytesLoaded : Number [읽기 전용] The number of bytes of the image already loaded.	BitmapImage
		bytesTotal : Number [읽기 전용] The total image data in bytes loaded or pending load.	BitmapImage
		clearOnLoad : Boolean Denotes whether or not to clear previous image content prior to loading new content.	BitmapImage
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		contentLoader : IContentLoader Optional custom image loader (e.g.	BitmapImage
		contentLoaderGrouping : String Optional content grouping identifier to pass to the an associated IContentLoader instance's load() method.	BitmapImage
		depth : Number Determines the order in which items inside of containers are rendered.	GraphicElement
		designLayer : DesignLayer Specifies the optional DesignLayer instance associated with this visual element.	GraphicElement
		displayObject : DisplayObject [읽기 전용] The shared DisplayObject where this IGraphicElement is drawn.	GraphicElement
		displayObjectSharingMode : String Indicates the association between this IGraphicElement and its display objects.	GraphicElement
		explicitHeight : Number Number that specifies the explicit height of the component, in pixels, in the component's coordinates.	GraphicElement
		explicitMaxHeight : Number The maximum recommended height of the component to be considered by the parent during layout.	GraphicElement
		explicitMaxWidth : Number The maximum recommended width of the component to be considered by the parent during layout.	GraphicElement
		explicitMinHeight : Number The minimum recommended height of the component to be considered by the parent during layout.	GraphicElement
		explicitMinWidth : Number The minimum recommended width of the component to be considered by the parent during layout.	GraphicElement
		explicitWidth : Number Number that specifies the explicit width of the component, in pixels, in the component's coordinates.	GraphicElement
		fillMode : String Determines how the bitmap fills in the dimensions.	BitmapImage
		filters : Array An indexed array that contains each filter object currently associated with the graphic element.	GraphicElement
		hasLayoutMatrix3D : Boolean [읽기 전용] Contains true if the element has 3D Matrix.	GraphicElement
		height : Number The height of the graphic element.	GraphicElement
		horizontalAlign : String The horizontal alignment of the content when it does not have a one-to-one aspect ratio and scaleMode is set to mx.graphics.BitmapScaleMode.LETTERBOX.	BitmapImage
		horizontalCenter : Object The horizontal distance in pixels from the center of the component to the center of the anchor target's content area.	GraphicElement
		id : String The identity of the component.	GraphicElement
		includeInLayout : Boolean Specifies whether this element is included in the layout of the parent.	GraphicElement
		is3D : Boolean [읽기 전용] Contains true when the element is in 3D.	GraphicElement
		layoutDirection : String Specifies the desired layout direction for an element: one of LayoutDirection.LTR (left to right), LayoutDirection.RTL (right to left), or null (inherit).	GraphicElement
		left : Object The horizontal distance in pixels from the left edge of the component to the anchor target's left edge.	GraphicElement
		luminosityClip : Boolean A property that controls whether the luminosity mask clips the masked content.	GraphicElement
		luminosityInvert : Boolean A property that controls the calculation of the RGB color value of a graphic element being masked by a luminosity mask.	GraphicElement
		mask : DisplayObject The calling display object is masked by the specified mask object.	GraphicElement
		maskType : String Defines how the mask is applied to the GraphicElement. The possible values are MaskType.CLIP, MaskType.ALPHA, and MaskType.LUMINOSITY. Clip Masking When masking in clip mode, a clipping masks is reduced to 1-bit.	GraphicElement
		maxHeight : Number The maximum recommended height of the component to be considered by the parent during layout.	GraphicElement
		maxWidth : Number The maximum recommended width of the component to be considered by the parent during layout.	GraphicElement
		measuredHeight : Number The default height of the component, in pixels.	GraphicElement
		measuredWidth : Number The default width of the component, in pixels.	GraphicElement
		measuredX : Number The default measured bounds top-left corner relative to the origin of the element.	GraphicElement
		measuredY : Number The default measured bounds top-left corner relative to the origin of the element.	GraphicElement
		minHeight : Number The minimum recommended height of the component to be considered by the parent during layout.	GraphicElement
		minWidth : Number The minimum recommended width of the component to be considered by the parent during layout.	GraphicElement
		owner : DisplayObjectContainer The owner of this IVisualElement object.	GraphicElement
		parent : DisplayObjectContainer [읽기 전용] The parent container or component for this component.	GraphicElement
		percentHeight : Number Specifies the height of a component as a percentage of its parent's size.	GraphicElement
		percentWidth : Number Specifies the width of a component as a percentage of its parent's size.	GraphicElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets Defines a set of adjustments that can be applied to the object's transform in a way that is invisible to its parent's layout.	GraphicElement
		preliminaryHeight : Number Provides an estimate to use for height when the "measured" bounds of the image is requested by layout, but the image data has yet to complete loading.	BitmapImage
		preliminaryWidth : Number Provides an estimate to use for width when the "measured" bounds of the image is requested by layout, but the image data has yet to complete loading.	BitmapImage
		right : Object The horizontal distance in pixels from the right edge of the component to the anchor target's right edge.	GraphicElement
		rotation : Number Indicates the rotation of the element, in degrees, from the transform point.	GraphicElement
		rotationX : Number Indicates the x-axis rotation of the element instance, in degrees, from its original orientation relative to the 3D parent container.	GraphicElement
		rotationY : Number Indicates the y-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container.	GraphicElement
		rotationZ : Number Indicates the rotation of the element, in degrees, from the transform point.	GraphicElement
		scaleMode : String Determines how the image is scaled when fillMode is set to mx.graphics.BitmapFillMode.SCALE.	BitmapImage
		scaleX : Number The horizontal scale (percentage) of the element as applied from the transform point.	GraphicElement
		scaleY : Number The vertical scale (percentage) of the element as applied from the transform point.	GraphicElement
		scaleZ : Number The z scale (percentage) of the element as applied from the transform point.	GraphicElement
		smooth : Boolean 비트맵 이미지에 매끄럽게 다듬는 알고리즘을 적용할지 여부를 지정합니다.	BitmapImage
		smoothingQuality : String Determines how the image is down-scaled.	BitmapImage
		source : Object The source used for the bitmap fill.	BitmapImage
		sourceHeight : Number [읽기 전용] Provides the unscaled height of the original image data.	BitmapImage
		sourceWidth : Number [읽기 전용] Provides the unscaled width of the original image data.	BitmapImage
		top : Object The vertical distance in pixels from the top edge of the component to the anchor target's top edge.	GraphicElement
		transform : flash.geom:Transform 표시 객체의 행렬, 색상 변환 및 픽셀 경계와 관련된 속성을 가진 객체입니다.	GraphicElement
		transformX : Number The x position transform point of the element.	GraphicElement
		transformY : Number The y position transform point of the element.	GraphicElement
		transformZ : Number The z position transform point of the element.	GraphicElement
		trustedSource : Boolean [읽기 전용] A read-only flag denoting whether the currently loaded content is considered loaded form a source whose security policy allows for cross domain image access.	BitmapImage
		verticalAlign : String The vertical alignment of the content when it does not have a one-to-one aspect ratio and scaleMode is set to mx.graphics.BitmapScaleMode.LETTERBOX.	BitmapImage
		verticalCenter : Object The vertical distance in pixels from the center of the component to the center of the anchor target's content area.	GraphicElement
		visible : Boolean Controls the visibility of this visual element.	GraphicElement
		width : Number The width of the graphic element.	GraphicElement
		x : Number The x position of the graphic element.	GraphicElement
		y : Number The y position of the graphic element.	GraphicElement
		z : Number The z position of the graphic element.	GraphicElement

보호 속성

상속되는 보호 속성 숨기기

상속되는 보호 속성 표시

	속성		정의 주체
		drawnDisplayObject : DisplayObject [읽기 전용] The actual DisplayObject that is drawn into by the GraphicElement.	GraphicElement
		drawX : Number [읽기 전용] The x position where the element should be drawn.	GraphicElement
		drawY : Number [읽기 전용] The y position where the element should be drawn.	GraphicElement
		hasComplexLayoutMatrix : Boolean [읽기 전용] Returns true if the GraphicElement has any non-translation (x,y) transform properties	GraphicElement
		layoutFeatures : AdvancedLayoutFeatures Contain all of the implementation details of how the GraphicElement implements transform and layering support.	GraphicElement
		needsDisplayObject : Boolean [읽기 전용] True if the element requires an exclusive DisplayObject.	GraphicElement

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		BitmapImage() Constructor.	BitmapImage
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		canShareWithNext(element:IGraphicElement):Boolean Returns true if this IGraphicElement is compatible and can share display objects with the next IGraphicElement in the sequence.	GraphicElement
		canShareWithPrevious(element:IGraphicElement):Boolean Returns true if this IGraphicElement is compatible and can share display objects with the previous IGraphicElement in the sequence.	GraphicElement
		createDisplayObject():DisplayObject Creates a new DisplayObject where this IGraphicElement is drawn.	GraphicElement
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Returns the x coordinate of the element's bounds at the specified element size.	GraphicElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Returns the y coordinate of the element's bounds at the specified element size.	GraphicElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's layout height.	GraphicElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's layout width.	GraphicElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Returns the x coordinate that the element uses to draw on screen.	GraphicElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Returns the y coordinate that the element uses to draw on screen.	GraphicElement
		getLayoutMatrix():Matrix Returns the transform matrix that is used to calculate the component's layout relative to its siblings.	GraphicElement
		getLayoutMatrix3D():Matrix3D Returns the layout transform Matrix3D for this element.	GraphicElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's maximum height.	GraphicElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's maximum width.	GraphicElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's minimum height.	GraphicElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's minimum width.	GraphicElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's preferred height.	GraphicElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's preferred width.	GraphicElement
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		initialized(document:Object, id:String):void Called automatically by the MXML compiler when the GraphicElement is created using an MXML tag.	GraphicElement
		invalidateDisplayList():void Calling this method results in a call to the elements's validateDisplayList() method before the display list is rendered.	GraphicElement
		invalidateLayoutDirection():void An element must call this method when its layoutDirection changes or when its parent's layoutDirection changes.	GraphicElement
		invalidateProperties():void Calling this method results in a call to the elements's validateProperties() method before the display list is rendered.	GraphicElement
		invalidateSize():void Calling this method results in a call to the elements's validateSize() method before the display list is rendered.	GraphicElement
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		localToGlobal(point:Point):Point Converts the point object from the object's (local) coordinates to the Stage (global) coordinates.	GraphicElement
		parentChanged(value:IGraphicElementContainer):void Called by IGraphicElementContainer when an IGraphicElement is added to or removed from the host component.	GraphicElement
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setLayoutBoundsPosition(newBoundsX:Number, newBoundsY:Number, postLayoutTransform:Boolean = true):void Sets the coordinates that the element uses to draw on screen.	GraphicElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Sets the layout size of the element.	GraphicElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void Sets the transform Matrix that is used to calculate the component's layout size and position relative to its siblings.	GraphicElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void Sets the transform Matrix3D that is used to calculate the component's layout size and position relative to its siblings.	GraphicElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean Determines whether this element can draw itself to the sharedDisplayObject of the sequence.	GraphicElement
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void A utility method to update the rotation, scale, and translation of the transform while keeping a particular point, specified in the component's own coordinate space, fixed in the parent's coordinate space.	GraphicElement
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void A utility method to transform a point specified in the local coordinates of this object to its location in the object's parent's coordinates.	GraphicElement
		validateDisplayList():void Called by the IGraphicElementContainer to redraw this element in its displayObject property.	GraphicElement
		validateNow():void Validates and updates the properties and layout of this object by immediately calling validateProperties(), validateSize(), and validateDisplayList(), if necessary.	GraphicElement
		validateProperties():void Used by layout logic to validate the properties of a component by calling the commitProperties() method.	GraphicElement
		validateSize():void Called by the IGraphicElementContainer to validate the size of this element.	GraphicElement
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

보호 메서드

상속되는 보호 메서드 숨기기

상속되는 보호 메서드 표시

	메서드		정의 주체
		canSkipMeasurement():Boolean Determines if the call to the measure() method can be skipped.	GraphicElement
		commitProperties():void [재정의] Processes the properties set on the element.	BitmapImage
		getStrokeExtents(postLayoutTransform:Boolean = true):Rectangle Returns the amount of pixels occupied by the stroke on each side of the element's bounds.	GraphicElement
		invalidateDisplayObjectSharing():void Utility method that notifies the host that this element has changed and needs its layer to be updated.	GraphicElement
		invalidateParentSizeAndDisplayList():void Helper method to invalidate parent size and display list if this object affects its layout (includeInLayout is true).	GraphicElement
		measure():void [재정의] Calculates the default size of the element.	BitmapImage
		preferredHeightPreTransform():Number Used for the implementation of the ILayoutElement interface, returns the explicit measured height pre-transform.	GraphicElement
		preferredWidthPreTransform():Number Used for the implementation of the ILayoutElement interface, returns the explicit of measured width pre-transform.	GraphicElement
		transformHeightForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Transform the element's size.	GraphicElement
		transformWidthForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Transform the element's size.	GraphicElement
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void [재정의] Draws the element and/or sizes and positions its content.	BitmapImage

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	요약	정의 주체
activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
complete	Dispatched when content loading is complete.	BitmapImage
deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher
httpStatus	Dispatched when a network request is made over HTTP and Flash Player or AIR can detect the HTTP status code.	BitmapImage
ioError	Dispatched when an input/output error occurs.	BitmapImage
progress	Dispatched when content is loading.	BitmapImage
ready	Dispatched when content loading is complete.	BitmapImage
securityError	Dispatched when a security error occurs.	BitmapImage

속성 세부 정보

bitmapData

속성

bitmapData:BitmapData [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

Returns a copy of the BitmapData object representing the currently loaded image content (unscaled). This property is null for untrusted cross domain content.

기본값: null.

구현
public function get bitmapData():BitmapData

bytesLoaded

속성

bytesLoaded:Number [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

The number of bytes of the image already loaded. Only relevant for images loaded by request URL.

기본값: NaN.

구현
public function get bytesLoaded():Number

bytesTotal

속성

bytesTotal:Number [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

The total image data in bytes loaded or pending load. Only relevant for images loaded by request URL.

기본값: NaN.

구현
public function get bytesTotal():Number

clearOnLoad

속성

clearOnLoad:Boolean

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

Denotes whether or not to clear previous image content prior to loading new content.

기본값: true.

구현
public function get clearOnLoad():Boolean
public function set clearOnLoad(value:Boolean):void

contentLoader

속성

contentLoader:IContentLoader

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 1.5

Optional custom image loader (e.g. image cache or queue) to associate with content loader client.

기본값: null.

구현
public function get contentLoader():IContentLoader
public function set contentLoader(value:IContentLoader):void

contentLoaderGrouping

속성

contentLoaderGrouping:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 1.5

Optional content grouping identifier to pass to the an associated IContentLoader instance's load() method. This property is only considered when a valid contentLoader is assigned.

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

fillMode

속성

fillMode:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Determines how the bitmap fills in the dimensions. If you set the value of this property in a tag, use the string (such as "repeat"). If you set the value of this property in ActionScript, use the constant (such as mx.graphics.BitmapFillMode.CLIP).

When set to BitmapFillMode.CLIP ("clip"), the bitmap ends at the edge of the region.

When set to BitmapFillMode.REPEAT ("repeat"), the bitmap repeats to fill the region.

When set to BitmapFillMode.SCALE ("scale"), the bitmap stretches to fill the region.

기본값: BitmapFillMode.SCALE.

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

관련 API 요소

mx.graphics.BitmapFillMode

horizontalAlign

속성

horizontalAlign:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

The horizontal alignment of the content when it does not have a one-to-one aspect ratio and scaleMode is set to mx.graphics.BitmapScaleMode.LETTERBOX.

Can be one of HorizontalAlign.LEFT ("left"), HorizontalAlign.RIGHT ("right"), or HorizontalAlign.CENTER ("center").

This property is only applicable when fillMode is set to to mx.graphics.BitmapFillMode.SCALE ("scale").

기본값: HorizontalAlign.CENTER.

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

preliminaryHeight

속성

preliminaryHeight:Number

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 1.5

Provides an estimate to use for height when the "measured" bounds of the image is requested by layout, but the image data has yet to complete loading. When NaN the measured height is 0 until the image has finished loading.

기본값: NaN.

구현
public function get preliminaryHeight():Number
public function set preliminaryHeight(value:Number):void

preliminaryWidth

속성

preliminaryWidth:Number

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 1.5

Provides an estimate to use for width when the "measured" bounds of the image is requested by layout, but the image data has yet to complete loading. When NaN the measured width is 0 until the image has finished loading.

기본값: NaN.

구현
public function get preliminaryWidth():Number
public function set preliminaryWidth(value:Number):void

scaleMode

속성

scaleMode:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10.1, AIR 2.0

Determines how the image is scaled when fillMode is set to mx.graphics.BitmapFillMode.SCALE.

When set to mx.graphics.BitmapScaleMode.STRETCH ("stretch"), the image is stretched to fit.

When set to BitmapScaleMode.LETTERBOX ("letterbox"), the image is scaled with respect to the original unscaled image's aspect ratio.

When set to BitmapScaleMode.ZOOM ("zoom"), the image is scaled to fit with respect to the original unscaled image's aspect ratio. This results in cropping on one axis.

기본값: BitmapScaleMode.STRETCH.

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

smooth

속성

smooth:Boolean

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

비트맵 이미지에 매끄럽게 다듬는 알고리즘을 적용할지 여부를 지정합니다.

false이면 확대된 비트맵 이미지가 최단입점 알고리즘을 사용하여 렌더링되며 픽셀화되어 나타납니다. true이면 확대된 비트맵 이미지가 쌍선형 알고리즘을 사용하여 렌더링됩니다. 일반적으로 최단입점 알고리즘을 사용한 렌더링이 더 빠릅니다.

기본값: false.

구현
public function get smooth():Boolean
public function set smooth(value:Boolean):void

smoothingQuality

속성

smoothingQuality:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 1.5

Determines how the image is down-scaled. When set to BitmapSmoothingQuality.HIGH, the image is resampled (if data is from a trusted source) to achieve a higher quality result. If set to BitmapSmoothingQuality.DEFAULT, the default stage quality for scaled bitmap fills is used.

기본값: BitmapSmoothingQuality.DEFAULT.

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

source

속성

source:Object

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

The source used for the bitmap fill. The fill can render from various graphical sources, including the following:

A Bitmap or BitmapData instance.
A class representing a subclass of DisplayObject. The BitmapFill instantiates the class and creates a bitmap rendering of it.
An instance of a DisplayObject. The BitmapFill copies it into a Bitmap for filling.
The name of an external image file.

If you use an image file for the source, it can be of type PNG, GIF, or JPG.

To specify an embedded image source, you can use the @Embed directive, as the following example shows:

      source="@Embed('<i>image_location</i>')"

The image location can be specified via a URL, URLRequest, or file reference. If it is a file reference, its location is relative to the location of the file that is being compiled.

The BitmapImage class is designed to work with embedded images or images that are loaded at run time.

If the source is a Bitmap or BitmapData instance or is an external image file, it is the responsibility of the caller to dispose of the source once it is no longer needed. If ImageLoader created the BitmapData instance, then it will dispose of the BitmapData once the source has changed.

이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 sourceChanged 이벤트를 전달합니다.

구현
public function get source():Object
public function set source(value:Object):void

sourceHeight

속성

sourceHeight:Number [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 1.5

Provides the unscaled height of the original image data.

기본값: NaN.

구현
public function get sourceHeight():Number

sourceWidth

속성

sourceWidth:Number [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 1.5

Provides the unscaled width of the original image data.

기본값: NaN.

구현
public function get sourceWidth():Number

trustedSource

속성

trustedSource:Boolean [읽기 전용]

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 9, AIR 1.5

A read-only flag denoting whether the currently loaded content is considered loaded form a source whose security policy allows for cross domain image access. When false, advanced bitmap operations such as high quality scaling, and tiling are not permitted. This flag is set once an image has been fully loaded.

기본값: true.

구현
public function get trustedSource():Boolean

verticalAlign

속성

verticalAlign:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 1.5

The vertical alignment of the content when it does not have a one-to-one aspect ratio and scaleMode is set to mx.graphics.BitmapScaleMode.LETTERBOX.

Can be one of VerticalAlign.TOP ("top"), VerticalAlign.BOTTOM ("bottom"), or VerticalAlign.MIDDLE ("middle").

This property is only applicable when scaleMode is set to to BitmapFillMode.SCALE ("scale").

기본값: VerticalAlign.MIDDLE.

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

생성자 세부 정보

()

생성자

public function BitmapImage()

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Constructor.

메서드 세부 정보

commitProperties

()

메서드

override protected function commitProperties():void

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Processes the properties set on the element. This is an advanced method that you might override when creating a subclass.

You do not call this method directly. Flex calls the commitProperties() method when you use the addElement() method to add an element to an IGraphicElementContainer container such as Group, or when you call the invalidateProperties() method of the element. Calls to the commitProperties() method occur before calls to the measure() method. This lets you set property values that might be used by the measure() method.

Some elements have properties that interact with each other. It is often best at startup time to process all of these properties at one time to avoid duplicating work.

measure

()

메서드

override protected function measure():void

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Calculates the default size of the element. This is an advanced method that you might override when creating a subclass of GraphicElement.

You do not call this method directly. Flex calls the measure() method when the element is added to an IGraphicElementContainer container such as Group using the addElement() method, and when the element's invalidateSize() method is called.

By default you set both explicit height and explicit width of an element, Flex does not call the measure() method, even if you explicitly call the invalidateSize() method. To override this behavior, override skipMeasure() method.

In your override of this method, you must set the measuredWidth and measuredHeight properties to define the default size. You can optionally set the measuredX and measuredY properties to define the default measured bounds top-left corner relative to the origin of the element.

The conceptual point of measure() is for the element to provide its own natural or intrinsic bounds as a default. Therefore, the measuredWidth and measuredHeight properties should be determined by factors such as:

The amount of text the component needs to display.
The size of a JPEG image that the component displays.

In some cases, there is no intrinsic way to determine default values. For example, a simple GreenCircle element might simply set measuredWidth = 100 and measuredHeight = 100 in its measure() method to provide a reasonable default size. In other cases, such as a TextArea, an appropriate computation (such as finding the right width and height that would just display all the text and have the aspect ratio of a Golden Rectangle) might be too time-consuming to be worthwhile.

The default implementation of measure() sets the values of the measuredWidth, measuredHeight, measuredX, and measuredY properties to 0.

updateDisplayList

()

메서드

override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4

런타임 버전:

Flash Player 10, AIR 1.5

Draws the element and/or sizes and positions its content. This is an advanced method that you might override when creating a subclass of GraphicElement.

You do not call this method directly. Flex calls the updateDisplayList() method when the component is added to an IGraphicElementContainer container such as Group using the addElement() method, and when the element's invalidateDisplayList() method is called.

This method is where you would do programmatic drawing using methods on the elements's displayObject such as graphics.drawRect().

매개 변수

	`unscaledWidth:Number` — Specifies the width of the component, in pixels, in the component's coordinates, regardless of the value of the `scaleX` property of the component.

	`unscaledHeight:Number` — Specifies the height of the component, in pixels, in the component's coordinates, regardless of the value of the `scaleY` property of the component.

이벤트 세부 정보

complete

이벤트

이벤트 객체 유형: flash.events.Event
속성 Event.type = flash.events.Event.COMPLETE

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

Dispatched when content loading is complete. This event is only dispatched for url and ByteArray based sources (those sources requiring a Loader).

Note that for content loaded via Loader, both ready and complete events are dispatched.

For other source types such as embeds, only ready is dispatched.

Event.COMPLETE 상수는 complete 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	로드가 완료된 네트워크 객체입니다.

httpStatus

이벤트

이벤트 객체 유형: flash.events.HTTPStatusEvent
속성 HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

Dispatched when a network request is made over HTTP and Flash Player or AIR can detect the HTTP status code.

HTTPStatusEvent.HTTP_STATUS 상수는 httpStatus 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`status`	서버에 의해 반환된 HTTP 상태 코드입니다.
`target`	HTTP 상태 코드를 수신하는 네트워크 객체입니다.

ioError

이벤트

이벤트 객체 유형: flash.events.IOErrorEvent
속성 IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

Dispatched when an input/output error occurs.

ioError 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`errorID`	특정 오류와 연결된 참조 번호입니다(AIR만 해당).
`target`	입력/출력 오류가 발생한 네트워크 객체입니다.
`text`	오류 메시지로 표시될 텍스트입니다.

관련 API 요소

flash.events.IOErrorEvent

progress

이벤트

이벤트 객체 유형: flash.events.ProgressEvent
속성 ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

Dispatched when content is loading.

Note: The progress event is not guaranteed to be dispatched. The complete event may be received, without any progress events being dispatched. This can happen when the loaded content is a local file.

progress 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`bytesLoaded`	리스너가 이벤트를 처리할 때 로드된 항목 수 또는 바이트 수입니다.
`bytesTotal`	로드 프로세스가 완료되면 최종적으로 로드될 총 바이트 수 또는 항목 수입니다.
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	진행률을 보고하는 객체입니다.

ready

이벤트

이벤트 객체 유형: mx.events.FlexEvent
속성 FlexEvent.type = mx.events.FlexEvent.READY

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

Dispatched when content loading is complete. Unlike the complete event, this event is dispatched for all source types.

Note that for content loaded via Loader, both ready and complete events are dispatched.

For other source types such as embeds, only ready is dispatched.

The FlexEvent.READY constant defines the value of the type property of the event object for a ready event. This event is dispatched by the BitmapImage and spark Image classes to denote that the assigned image source has fully loaded.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`returnValue`	null
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myImage.addEventListener()` to register an event listener, myImage is the value of the `currentTarget`.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`Type`	FlexEvent.READY

securityError

이벤트

이벤트 객체 유형: flash.events.SecurityErrorEvent
속성 SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

언어 버전:

ActionScript 3.0

제품 버전:

Flex 4.5

런타임 버전:

Flash Player 10, AIR 2.0

Dispatched when a security error occurs.

SecurityErrorEvent.SECURITY_ERROR 상수는 securityError 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성	값
`bubbles`	`false`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	보안 오류를 보고하는 네트워크 객체입니다.
`text`	오류 메시지로 표시될 텍스트입니다.

관련 API 요소

flash.events.SecurityErrorEvent

예제 예제 사용 방법

BitmapImageExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- BitmapGraphicExample.mxml -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark">

    <s:Panel title="Bitmap Graphic Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <s:Group left="10" right="10" top="10" bottom="10">
            <!-- Single image, not resized, not repeated. -->
            <s:Graphic x="0" y="0">             
                <s:BitmapImage id="bg1" source="@Embed('assets/AirIcon12x12.gif')" fillMode="clip"/>
            </s:Graphic>

            <!-- Single image, scaled to fit specified dimensions. -->
            <s:Graphic x="150" y="0">
                <s:BitmapImage id="bg2" source="@Embed('assets/AirIcon12x12.gif')" width="60" height="60" fillMode="scale"/>
            </s:Graphic>

            <!-- Repeated image to fit specified dimensions. -->
            <s:Graphic x="300" y="0">
                <s:BitmapImage id="bg3" source="@Embed('assets/AirIcon12x12.gif')" width="120" height="120" fillMode="repeat"/>
            </s:Graphic>
        </s:Group>
    </s:Panel>

</s:Application>

법적 고지 사항 | 온라인 개인 정보 보호 정책

BitmapImage - AS3 Flex

패키지x

언어 요소

부록

패키지 spark.primitives

bitmapData

bytesLoaded

bytesTotal

clearOnLoad

contentLoader

contentLoaderGrouping

fillMode

horizontalAlign

preliminaryHeight

preliminaryWidth

scaleMode

smooth

smoothingQuality

source

sourceHeight

sourceWidth

trustedSource

verticalAlign

BitmapImage

commitProperties

measure

updateDisplayList

complete

httpStatus

ioError

progress

ready

securityError