パッケージ	mx.core
クラス	public class BitmapAsset
継承	BitmapAsset FlexBitmap Bitmap DisplayObject EventDispatcher Object
実装	IFlexAsset, IFlexDisplayObject

BitmapAsset は、Flex アプリケーションに埋め込まれたビットマップイメージを表す flash.display.Bitmap クラスのサブクラスです。これにより IFlexDisplayObject インターフェイスが実装され、埋め込まれたビットマップイメージを Image コントロールで表示すること、またはコンテナの背景やコンポーネントスキンとして使用することが可能になります。

JPEG、GIF、PNG ファイルのビットマップイメージを埋め込むことができます。Flash によって作成された SWF ファイルのビットマップイメージを埋め込むこともできます。いずれの場合も、MXML コンパイラは、埋め込まれたビットマップイメージを表すように BitmapAsset を拡張するクラスを自動生成します。

通常は、Flex アプリケーションを作成するときに BitmapAsset クラスを直接使用する必要はありません。例えば、次のように記述すると、GIF ファイルを埋め込み、Image コントロールにイメージを表示することができます。

  <mx:Image id="logo" source="@Embed(source='Logo.gif')"/>

または、次のように記述することにより、CSS シンタックスの中でアプリケーションの背景イメージとして使用できます。

  <mx:Style>
      Application
      {
          backgroundImage: Embed(source="Logo.gif")
      }
  <mx:Style/>

MXML コンパイラによって BitmapAsset のサブクラスが作成されたことを認識しておく必要はありません。

ただし、ActionScript レベルで何が行われているのかを理解しておくことは有益です。ビットマップイメージを ActionScript に埋め込むには、Class 型の変数を宣言し、それに [Embed] メタデータを入れます。例えば、次のようにして GIF ファイルを埋め込みます。

  [Bindable]
  [Embed(source="Logo.gif")]
  private var logoClass:Class;

MXML コンパイラは、拡張子 .gif を確認し、GIF データを Player が使用するビットマップ形式にトランスコードして、BitmapAsset クラスのサブクラスを自動生成し、この自動生成されたクラスへの参照を変数に設定します。これにより、このクラス参照を使用して new 演算子で BitmapAsset のインスタンスを作成し、作成したインスタンスで BitmapAsset クラスの API を使用できるようになります。

  var logo:BitmapAsset = BitmapAsset(new logoClass());
  logo.bitmapData.noise(4);

ただし、BitmapAsset インスタンスを自分で作成する必要はほとんどありません。イメージ関連のプロパティおよびスタイルをイメージ生成クラスに設定すると、コンポーネントが必要に応じてイメージインスタンスを作成します。 例えば、このイメージを Image コントロールに表示するために、Image の source プロパティを logoClass に設定することができます。 MXML では、次のようにします。

  <mx:Image id="logo" source="{logoClass}"/>

---