flash.display.Bitmap (Flex™ 2 リファレンスガイド)

パッケージ	flash.display
	public class Bitmap
継承	Bitmap DisplayObject EventDispatcher Object
Subclasses	FlexBitmap

Bitmap クラスはビットマップイメージを表す表示オブジェクトを表します。これらは flash.display.Loader クラスによってロードするイメージか、Bitmap() コンストラクタによって作成するイメージです。

Bitmap() コンストラクタを使用すると、BitmapData オブジェクトへの参照を含んだビットマップオブジェクトを作成できます。ビットマップオブジェクトの作成後、親 DisplayObjectContainer インスタンスの addChild() メソッドまたは addChildAt() メソッドを使用して表示リスト上にビットマップを配置できます。

ビットマップオブジェクトの BitmapData への参照は、translation プロパティまたは rotation プロパティと関係なく、複数のビットマップオブジェクトで共有できます。作成した複数のビットマップオブジェクトで同じ BitmapData オブジェクトを参照することができるため、各表示オブジェクトインスタンスに関する BitmapData オブジェクトのメモリのオーバーヘッドを避けつつ、複数の表示オブジェクトで同一の複雑な BitmapData オブジェクトを使用することができます。

ビットマップオブジェクトを使用して BitmapData オブジェクトを画面に描画するには、ベクターレンダラをビットマップ塗りつぶしのシェイプとして使用するか、高速なピクセルコピールーチンを使用します。ピクセルコピールーチンはベクターレンダラよりも高速ですが、使用する際には、ビットマップオブジェクトに以下の特定の条件が適用されます。

ビットマップオブジェクトには、伸縮、回転、傾斜は適用されません。
ビットマップオブジェクトにはカラー変換は適用されません。
ビットマップオブジェクトにはブレンドモードは適用されません。
マスクレイヤーまたは setMask() メソッドでクリッピングは行われません。
イメージ自体はマスクできません。
宛先の座標は全体がピクセル境界内になければなりません。

ロードするビットマップオブジェクトの置かれているドメインが、イメージのロードに使用する Loader オブジェクトのドメインと異なる場合は、Loader オブジェクトのドメインへのアクセスを許可するドメイン間ポリシーファイルが用意されていないと、そのドメイン内のスクリプトはビットマップオブジェクトやそのプロパティとメソッドにアクセスできません。詳細については、次の参照先を参照してください。

『ActionScript 3.0 のプログラミング』のセキュリティの章と LiveDocs の最新コメント

Flash Player 9 セキュリティに関するホワイトペーパー

メモ : Bitmap クラスは InteractiveObject クラスのサブクラスではないため、マウスイベントを送出できません。しかし、ビットマップオブジェクトを格納した表示オブジェクトコンテナの addEventListener() メソッドを使用できます。

パブリックプロパティ

継承されるパブリックプロパティの非表示

継承されるパブリックプロパティの表示

	プロパティ		定義
		accessibilityProperties : AccessibilityProperties この表示オブジェクトの現在のアクセシビリティオプションです。	DisplayObject
		alpha : Number 指定されたオブジェクトのアルファ透明度値を示します。	DisplayObject
		bitmapData : BitmapData BitmapData オブジェクトが参照されます。	Bitmap
		blendMode : String 使用するブレンドモードを指定する BlendMode クラスの値です。	DisplayObject
		cacheAsBitmap : Boolean `true` に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。	DisplayObject
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		filters : Array 表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。	DisplayObject
		height : Number 表示オブジェクトの高さを示します (ピクセル単位)。	DisplayObject
		loaderInfo : LoaderInfo この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。	DisplayObject
		mask : DisplayObject 呼び出し元の表示オブジェクトは、指定された `mask` オブジェクトによってマスクされます。	DisplayObject
		mouseX : Number マウス位置の x 座標を示します (ピクセル単位)。	DisplayObject
		mouseY : Number マウス位置の y 座標を示します (ピクセル単位)。	DisplayObject
		name : String DisplayObject のインスタンス名を示します。	DisplayObject
		opaqueBackground : Object 表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。	DisplayObject
		parent : DisplayObjectContainer この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。	DisplayObject
		pixelSnapping : String ビットマップオブジェクトが最も近いピクセルに吸着されるかどうかを指定します。	Bitmap
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object
		root : DisplayObject ロードされた SWF ファイル内の表示オブジェクトの場合、`root` プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。	DisplayObject
		rotation : Number DisplayObject インスタンスの元の位置からの回転角を度単位で示します。	DisplayObject
		scale9Grid : Rectangle 現在有効な拡大 / 縮小グリッドです。	DisplayObject
		scaleX : Number 基準点から適用されるオブジェクトの水平スケール (`percentage`) を示します。	DisplayObject
		scaleY : Number オブジェクトの基準点から適用されるオブジェクトの垂直スケール (`percentage`) を示します。	DisplayObject
		scrollRect : Rectangle 表示オブジェクトのスクロール矩形の境界。	DisplayObject
		smoothing : Boolean ビットマップを拡大 / 縮小するときにスムージングするかどうかを指定します。	Bitmap
		stage : Stage 表示オブジェクトのステージ。	DisplayObject
		transform : Transform 表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクト。	DisplayObject
		visible : Boolean 表示オブジェクトが可視かどうかを示します。	DisplayObject
		width : Number 表示オブジェクトの幅を示します (ピクセル単位)。	DisplayObject
		x : Number 親 DisplayObjectContainer のローカル座標を基準にした DisplayObject インスタンスの x 座標を示します。	DisplayObject
		y : Number 親 DisplayObjectContainer のローカル座標を基準にした DisplayObject インスタンスの y 座標を示します。	DisplayObject

パブリック Methods

継承されるパブリックメソッドの非表示

継承されるパブリックメソッドの表示

	メソッド		定義
		Bitmap(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false) 指定された BitmapData オブジェクトを参照するようにビットマップオブジェクトを初期化します。	Bitmap
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void リスナーがイベントの通知を受け取るように、イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録します。	EventDispatcher
		dispatchEvent(event:Event):Boolean イベントをイベントフローに送出します。	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle `targetCoordinateSpace` オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。	DisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle シェイプ上の線を除き、`targetCoordinateSpace` パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。	DisplayObject
		globalToLocal(point:Point):Point `point` オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。	DisplayObject
		hasEventListener(type:String):Boolean EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指定されたプロパティがオブジェクトに定義されているかどうかを示します。	Object
		hitTestObject(obj:DisplayObject):Boolean 表示オブジェクトを評価して、`obj` 表示オブジェクトと重複または交差するかどうかを調べます。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 表示オブジェクトを評価して、`x` および `y` パラメータで指定されたポイントと重複または交差するかどうかを調べます。	DisplayObject
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		localToGlobal(point:Point):Point `point` オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。	DisplayObject
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher オブジェクトからリスナーを削除します。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		willTrigger(type:String):Boolean 指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。	EventDispatcher

イベント

継承されるイベントの非表示

継承されるイベントの表示

	一覧	定義
activate	Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。	EventDispatcher
added	表示オブジェクトが表示リストに追加されたときに送出されます。	DisplayObject
addedToStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。	DisplayObject
deactivate	Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。	EventDispatcher
enterFrame	再生ヘッドが新しいフレームに入るときに送出されます。	DisplayObject
removed	表示オブジェクトが表示リストから削除されようとしているときに送出されます。	DisplayObject
removedFromStage	表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。	DisplayObject
render	表示リストが更新およびレンダリングされようとしているときに送出されます。	DisplayObject

プロパティの詳細

bitmapData

プロパティ

bitmapData:BitmapData [read-write]

BitmapData オブジェクトが参照されます。

実装
public function get bitmapData():BitmapData
public function set bitmapData(value:BitmapData):void

pixelSnapping

プロパティ

pixelSnapping:String [read-write]

ビットマップオブジェクトが最も近いピクセルに吸着されるかどうかを指定します。PixelSnapping クラスには正の値が入ります。

PixelSnapping.NEVER—ピクセルは吸着されません。
PixelSnapping.ALWAYS—イメージは、変換とは関係なく常に最も近いピクセルに吸着されます。
PixelSnapping.AUTO—イメージが回転または傾斜なしで描画され、99.9% から 100.1% の倍率で描画される場合、イメージは最も近いピクセルに吸着されます。これらの条件が満たされる場合、ビットマップイメージは 100% の倍率で描画され、最も近いピクセルに吸着されます。内部的には、この値によって、ベクターレンダラを使ってイメージが可能な限り高速に描画されます。

実装
public function get pixelSnapping():String
public function set pixelSnapping(value:String):void

smoothing

プロパティ

smoothing:Boolean [read-write]

ビットマップを拡大 / 縮小するときにスムージングするかどうかを指定します。true である場合、ビットマップは拡大 / 縮小時にスムージングされます。false である場合、ビットマップは拡大 / 縮小時にスムージングされません。

実装
public function get smoothing():Boolean
public function set smoothing(value:Boolean):void

コンストラクタの詳細

Bitmap

()

コンストラクタ

public 関数 Bitmap(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false)

指定された BitmapData オブジェクトを参照するようにビットマップオブジェクトを初期化します。

パラメータ

bitmapData:BitmapData (default = null) — BitmapData オブジェクトが参照されます。

pixelSnapping:String (default = "auto") — ビットマップオブジェクトが最も近いピクセルに吸着されるかどうかを示します。

smoothing:Boolean (default = false) — ビットマップを拡大 / 縮小するときにスムージングするかどうかを示します。たとえば、次の例は同じビットマップを 3 倍に拡大した場合に、smoothing を false に設定したもの (左) と true に設定したもの (右) です。

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class Bitmap	プロパティ \| メソッド \| イベント