ビットマップイメージの高さ (ピクセル単位) です。

ビットマップイメージのサイズと位置を定義する矩形です。矩形の上端と左端は 0 になります。幅と高さは、BitmapData オブジェクトのピクセルの幅および高さと等しくなります。

ビットマップイメージがピクセル単位の透明度をサポートするかどうかを定義します。この値を設定できるのは、コンストラクタの transparent パラメータに true を渡すことによって BitmapData オブジェクトを作成する場合だけです。BitmapData オブジェクトを作成した後、transparent プロパティの値が true であるかどうかを確認することにより、このオブジェクトがピクセルごとの透明度をサポートするかどうかを検査できます。

ビットマップイメージの幅 (ピクセル単位) です。

指定された幅と高さで BitmapData オブジェクトを作成します。fillColor パラメータに値を指定した場合、ビットマップのすべてのピクセルにその色が設定されます。

transparent パラメータに false を渡さない限り、デフォルトではビットマップが透明として作成されます。不透明のビットマップを作成した後、それを透明のビットマップに変更することはできません。不透明のビットマップに含まれるすべてのピクセルは、24 ビットのカラーチャネル情報だけを使用します。ビットマップを透明に定義した場合、すべてのピクセルは、アルファ透明チャネルを含む 32 ビットのカラーチャネル情報を使用します。

BitmapData オブジェクトの最大の幅と高さは 2880 ピクセルです。幅または高さに 2880 より大きい値を指定すると、新しいインスタンスは作成されません。

ソースイメージとフィルタオブジェクトを受け取り、フィルタを適用して得られるイメージを生成します。

このメソッドはビルトインフィルタオブジェクトの動作に依存します (このオブジェクトは、入力ソース矩形によって影響を受けるターゲット矩形を決定します)。

フィルタを適用した後、結果として得られるイメージは入力イメージよりも大きくなることがあります。たとえば、BlurFilter クラスを使用してソース矩形 (50,50,100,100) とターゲットポイント (10,10) をぼかすと、ターゲットイメージで変更される領域は、ぼかしのために、(10,10,60,60) よりも大きくなります。これは、applyFilter() 呼び出し時に内部で発生します。

sourceBitmapData パラメータの sourceRect パラメータが内側領域 (200 x 200 のイメージ内の (50,50,100,100) など) である場合、フィルタは、sourceRect パラメータの外側にあるソースピクセルを使用して、ターゲット矩形を生成します。

sourceBitmapData パラメータとして指定されたオブジェクトと BitmapData オブジェクトが同じであれば、Flash Player はオブジェクトの一時コピーを使ってフィルタを実行します。最適なパフォーマンスを得るには、このような状況を避けてください。

関連項目

新しい BitmapData オブジェクトとして、元のインスタンスのクローンを返します。含まれるビットマップはまったく同じコピーになります。

ColorTransform オブジェクトを使用して、ビットマップイメージの特定領域のカラー値を調整します。矩形がビットマップイメージの境界と一致する場合、このメソッドはイメージ全体のカラー値を変換します。

関連項目

2 つの BitmapData オブジェクトを比較します。2 つの BitmapData オブジェクトのサイズ (幅と高さ) が同じであれば、メソッドは新しい BitmapData オブジェクトを返します。この新しいオブジェクトの各ピクセルは、2 つのソースオブジェクトのピクセル間の「差分」です。

• 2 つのピクセルが等しい場合、差分ピクセルは 0x00000000 です。
• 2 つのピクセルの RGB 値が異なる場合 (アルファ値は無視)、差分ピクセルは 0xFFRRGGBB です。ここで RR/GG/BB はそれぞれ赤、緑、青チャネル間の個々の差分値を表します。この場合、アルファチャネルの差分は無視されます。
• アルファチャネル値だけが異なる場合、ピクセル値は 0xZZFFFFFF です (ZZ はアルファ値の差分)。

たとえば、次のような 2 つの BitmapData オブジェクトがあるとします。

  var bmd1:BitmapData = new BitmapData(50, 50, true, 0xFFFF0000);
  var bmd2:BitmapData = new BitmapData(50, 50, true, 0xCCFFAA00);
  var diffBmpData:BitmapData = bmd1.compare(bmd2);
  

メモ : 2 つの BitmapData オブジェクトを塗りつぶすために使用されるそれぞれの色の RGB 値はわずかに異なります (0xFF0000 と 0xFFAA00)。compare() メソッドの結果として新しい BitmapData オブジェクトが生成され、その各ピクセルは 2 つのビットマップ間の RGB 値の差分を示します。

次のような 2 つの BitmapData オブジェクトがあるとします。両者の RGB カラーは同じですが、アルファ値は異なります。

  var bmd1:BitmapData = new BitmapData(50, 50, true, 0xFFFFAA00);
  var bmd2:BitmapData = new BitmapData(50, 50, true, 0xCCFFAA00);
  var diffBmpData:BitmapData = bmd1.compare(bmd2);
  

compare() メソッドの結果として新しい BitmapData オブジェクトが生成され、その各ピクセルは 2 つのビットマップ間のアルファ値の差分を示します。

BitmapData オブジェクトが等しい (幅と高さ、およびピクセル値が同じ) 場合、このメソッドは数値 0 を返します。

BitmapData オブジェクトの幅が等しくない場合、高さが同じであれば、このメソッドは数値 -3 を返します。

BitmapData オブジェクトの高さが等しくない場合、幅が同じであれば、このメソッドは数値 -4 を返します。

次の例では、幅の異なる 2 つの Bitmap オブジェクトを比較します (それぞれの幅は 50 と 60)。

  var bmd1:BitmapData = new BitmapData(100, 50, false, 0xFFFF0000);
  var bmd2:BitmapData = new BitmapData(100, 60, false, 0xFFFFAA00);
  trace(bmd1.compare(bmd2)); // -4
  

別の BitmapData オブジェクトまたは現在の BitmapData オブジェクトの 1 つのチャネルのデータを、現在の BitmapData オブジェクトのチャネルに転送します。ターゲット BitmapData オブジェクト内のその他のチャンルのデータはすべて保たれます。

ソースチャネルの値とターゲットチャネルの値は、次のいずれかになります。

• BitmapDataChannel.RED
• BitmapDataChannel.GREEN
• BitmapDataChannel.BLUE
• BitmapDataChannel.ALPHA

関連項目

イメージ間のピクセル操作 (伸長、回転、カラー効果なし) を高速に実行するルーチンを提供します。このメソッドは、ソースイメージの矩形領域を、ターゲット BitmapData オブジェクトのターゲットポイントにある同じサイズの矩形領域にコピーします。

alphaBitmap パラメータと alphaPoint パラメータを含めれば、2 番目のイメージをソースイメージのアルファソースとして使用できます。ソースイメージにアルファデータがある場合、2 つのアルファデータセットを使用して、ソースイメージのピクセルがターゲットイメージ上に合成されます。alphaPoint パラメータは、ソース矩形の左上隅に対応する、アルファイメージ内のポイントです。ソースイメージとアルファイメージが交わらない部分のピクセルは、ターゲットイメージにコピーされません。

mergeAlpha プロパティは、透明なイメージが別の透明なイメージにコピーされるときにアルファチャネルが使用されるかどうかを制御します。アルファチャネルデータを使用してピクセルをコピーするには、mergeAlpha プロパティを true に設定します。デフォルトでは、mergeAlpha プロパティは false に設定されています。

BitmapData オブジェクトの格納に使用されるメモリを解放します。

dispose() メソッドをイメージに対して呼び出すと、イメージの幅と高さがゼロに設定されます。それ以降、この BitmapData インスタンスのメソッドやプロパティを呼び出すと失敗し、例外がスローされます。

Flash Player のベクターレンダラを使用して、source 表示オブジェクトをビットマップイメージ上に描画します。matrix、colorTransform、blendMode、およびターゲット clipRect パラメータを指定することにより、レンダリングの実行方法を制御できます。さらに、必要に応じて、拡大・縮小時にビットマップのスムージングを行うかどうかを指定することもできます (これはソースオブジェクトが BitmapData オブジェクトの場合にのみ可能です)。

このメソッドは、オーサリングツールインターフェイスにおいてオブジェクトに対して標準ベクターレンダラを使ってオブジェクトを描画する方法に直接対応します。

ソース表示オブジェクトは、この呼び出しで適用される変換を使用しません。ライブラリやファイルの中に存在するものとして扱われ、マトリックス変換、カラー変換、ブレンドモードはありません。変換プロパティを使って (ムービークリップなどの) 表示オブジェクトを描画するには、BitmapData オブジェクトを使用する Bitmap オブジェクトの transform プロパティに transform プロパティオブジェクトをコピーすることができます。

セキュリティ上の注意事項 :source オブジェクトおよび (Sprite または MovieClip オブジェクト) のすべての子オブジェクトは、呼び出し元と同じドメインに属するか、Security.allowDomain() メソッドを呼び出すことで呼び出し元からアクセスできる SWF ファイルに含まれている必要があります。これらの条件が満たされない場合、draw() メソッドは何も描画しません。

関連項目

指定された ARGB カラーで矩形領域のピクセルを塗りつぶします。

関連項目

(x, y) 座標を始点として所定の色で塗りつぶすことにより、イメージの塗りつぶし処理を実行します。floodFill() メソッドは、各種のペイントプログラムのバケツツールのようなものです。color は、アルファ情報とカラー情報を含む ARGB カラーです。

BitmapData オブジェクト、ソース矩形、フィルタオブジェクトを指定して、applyFilter() メソッド呼び出しによって影響を受けるターゲット矩形を決定します。

たとえば、ぼかしフィルタは通常、元のイメージのサイズよりも大きい領域に影響を与えます。デフォルトの BlurFilter インスタンス (blurX = blurY = 4) によってフィルタが適用される 100 x 200 ピクセルのイメージは (-2,-2,104,204) というターゲット矩形を生成します。generateFilterRect() メソッドを使用すると、このターゲット矩形のサイズを前もって知ることができるので、フィルタ処理の前にターゲットイメージを適切なサイズにすることができます。

いくつかのフィルタは、ソースイメージのサイズに基づいてターゲット矩形をクリッピングします。たとえば、内側の DropShadow は、ソースイメージよりも大きい結果を生成しません。この API では、ソース rect パラメータではなく、BitmapData オブジェクトをソースの境界として使用します。

(findColor パラメータが true に設定されている場合) ビットマップイメージ内の指定された色のすべてのピクセルを完全に囲む矩形領域を判別します。または、(findColor パラメータが false に設定されている場合) 指定された色ではないすべてのピクセルを完全に囲む矩形領域を判別します。

たとえば、あるソースイメージで、0 以外のアルファチャネルを含むイメージの矩形を判別するには、パラメータとして {mask: 0xFF000000, color: 0x00000000} を渡します。findColor パラメータが true に設定されている場合、(value & mask) == color であるピクセルの境界を見つけるためにイメージ全体が検索されます (value はピクセルのカラー値)。findColor パラメータが false に設定されている場合、(value & mask) != color であるピクセルの境界を見つけるためにイメージ全体が検索されます (value はピクセルのカラー値)。イメージの周囲の空白を判別するには、空白以外のピクセルの境界を見つけるために、{mask: 0xFFFFFFFF, color: 0xFFFFFFFF} を渡してください。

BitmapData オブジェクトの特定ポイント (x, y) の RGB ピクセル値を表す整数を返します。getPixel() メソッドは、乗算されていないピクセル値を返します。アルファ情報は返しません。

BitmapData オブジェクト内のすべてのピクセルは、乗算済みカラー値として保存されます。乗算済みイメージピクセルは、アルファデータが既に乗算された赤、緑、青の各カラーチャネル値を保持します。たとえば、アルファ値が 0 の場合、乗算されていない値とは無関係に、RGB チャネルの値も 0 になります。このようにデータが失われると、処理の実行時に問題が生じることがあります。BitmapData のすべてのメソッドは、乗算されていない値を受け取ったり返したりします。ピクセルの内部表現は、値として返される前に、乗算済みから非乗算に変換されます。設定処理の際は、ピクセル値が事前に乗算されてから、生のイメージピクセルが設定されます。

関連項目

アルファチャネルデータと RGB データを含む ARGB カラー値を返します。このメソッドは getPixel() メソッドと似ていますが、getPixel() メソッドはアルファチャネルデータがない RGB カラーを返します。

BitmapData オブジェクト内のすべてのピクセルは、乗算済みカラー値として保存されます。乗算済みイメージピクセルは、アルファデータが既に乗算された赤、緑、青の各カラーチャネル値を保持します。たとえば、アルファ値が 0 の場合、乗算されていない値とは無関係に、RGB チャネルの値も 0 になります。このようにデータが失われると、処理の実行時に問題が生じることがあります。BitmapData のすべてのメソッドは、乗算されていない値を受け取ったり返したりします。ピクセルの内部表現は、値として返される前に、乗算済みから非乗算に変換されます。設定処理の際は、ピクセル値が事前に乗算されてから、生のイメージピクセルが設定されます。

関連項目

ピクセルデータの矩形領域からバイト配列を生成します。各ピクセルごとに、符号なし整数 (32 ビットの乗算されないピクセル値) をバイト配列に書き込みます。

関連項目

1 つのビットマップイメージと、ポイント、矩形、または他のビットマップイメージとの間でピクセルレベルのヒットを検出します。ヒットテストの際、どちらのオブジェクトの変換 (伸縮、回転など) も考慮されません。

イメージが不透明である場合、このメソッドでは完全に不透明な矩形とみなされます。透過性を考慮するピクセルレベルのヒットテストを実施するには、両方のイメージとも透明でなければなりません。2 つの透明なイメージをテストするとき、アルファしきい値パラメータは、アルファチャネル値 (0 ～ 255) がいくつであれば不透明とみなすかを制御します。

この BitmapData オブジェクトが変更されたときに、BitmapData オブジェクトを参照するすべてのオブジェクト (たとえば Bitmap オブジェクト) が更新されないように、イメージをロックします。パフォーマンスを向上させるには、setPixel() メソッドまたは setPixel32() メソッドを何度も呼び出す前後に、このメソッドを unlock() メソッドとともに使用してください。

関連項目

ソースイメージとターゲットイメージをチャネルごとにブレンドします。チャネルごとに次の式を使用します。

new red dest = (red source * redMultiplier) + (red dest * (256 - redMultiplier) / 256;

redMultiplier 値、greenMultiplier 値、blueMultiplier 値、および alphaMultiplier 値は、それぞれのカラーチャネルの乗数です。有効な範囲は 0 ～ 256 です。

ランダムノイズを表すピクセルでイメージを塗りつぶします。

関連項目

最大で 4 つのカラーパレットデータ配列 (各チャネルごとに 1 つの配列) を使用して、イメージ内のカラーチャネル値をマッピングし直します。

Flash Player は以下の手順に従って、結果として得られるイメージを生成します。

1. 赤、緑、青、アルファの各値を算出した後、標準の 32 ビット整数算術演算を使ってこれらの値を足し合わせます。
2. 各ピクセルの赤、緑、青、アルファのチャネル値を抽出して、別個の 0 ～ 255 の値にします。これらの値は、該当する配列 (redArray、greenArray、blueArray、および alphaArray) で新しいカラー値を調べる場合に使用します。これら 4 つの配列にはそれぞれ 256 個の値が含まれている必要があります。
3. 新しいチャネル値を 4 つともすべて取得した後、それらの値を組み合わせて、ピクセルに適用される標準の ARGB 値にします。

このメソッドではクロスチャネル効果をサポートすることが可能です。それぞれの入力配列は完全な 32 ビット値を含むことができます。値を足し合わせるときに移動は発生しません。このルーチンは、チャネル単位のクランピングに対応していません。

チャネルに対して配列が指定されない場合は、ソースイメージからターゲットイメージにカラーチャネルがコピーされます。

このメソッドはさまざまな効果のために使用できます。たとえば、通常のパレットマッピング (1 つのチャネルを選択して疑似色イメージに変換する) が可能です。さらに、ガンマ、曲線、平準化、量子化といったさまざまなカラー操作アルゴリズムにもこのメソッドを使用できます。

Perlin ノイズイメージを生成します。

Perlin ノイズ生成アルゴリズムは、個々のランダムノイズ関数 (オクターブという) を補間および結合して、より自然なランダムノイズを生成する単一の関数にします。音楽のオクターブと同様、各オクターブ関数の周波数は、その前のオクターブ関数の周波数の 2 倍です。Perlin ノイズは、複数のノイズデータセットをさまざまな詳細レベルで組み合わせるので、「フラクタルノイズの和」と呼ばれてきました。

Perlin ノイズ関数を使用して、木目、雲、山脈などの自然現象や風景をシミュレートできます。ほとんどの場合、Perlin ノイズ関数の出力をそのまま表示するのではなく、他のイメージを強調したり、擬似ランダムバリエーションを与えるために使用します。

単純なデジタルランダムノイズ関数は、多くの場合、コントラストのきついポイントが含まれるイメージを生成します。このようにきついコントラストは自然界にはほとんど存在しません。Perlin ノイズアルゴリズムは、さまざまな詳細レベルで実行される複数のノイズ関数を混ぜ合わせます。このアルゴリズムの結果、互いに隣接するピクセル値の差異はより小さくなります。

メモ : Perlin ノイズアルゴリズムは、1982 年の映画「トロン」のコンピュータグラフィックを作成後にアルゴリズムを開発した Ken Perlin 氏にちなんで命名されました。Perlin 氏は 1997 年に、Perlin ノイズ関数に関する技術的功績によりアカデミー賞を受賞しました。

ソースイメージからターゲットイメージへのピクセルディゾルブ、または同じイメージを使用したピクセルディゾルブを実行します。Flash Player は randomSeed 値を使用して、ランダムなピクセルディゾルブを生成します。完了するまでピクセルディゾルブを続けるには、この関数の戻り値を後続の呼び出しに渡す必要があります。

ソースイメージとターゲットイメージが等しくない場合は、すべてのプロパティを使用して、ソースからターゲットにピクセルがコピーされます。この処理により、空白イメージから完全に設定されたイメージへのディゾルブが可能になります。

ソースイメージとターゲットイメージが等しい場合は、color パラメータを使ってピクセルが塗られます。この処理により、完全に設定されたイメージを消去するようにディゾルブできます。このモードでは、ターゲット point パラメータが無視されます。

所定の (x, y) ピクセル量だけイメージをスクロールします。スクロール領域外のエッジ領域は変わらずにそのままになります。

BitmapData オブジェクトの 1 つのピクセルを設定します。この処理中、イメージピクセルのアルファチャネルは現在の値が保持されます。RGB カラーパラメータの値は、乗算されていないカラー値として扱われます。

メモ : パフォーマンスを向上させるには、setPixel() または setPixel32() メソッドを繰り返し使用し、setPixel() またはsetPixel32() メソッドを呼び出す前に lock() メソッドを呼び出します。その後、ピクセルの変更がすべて完了したら unlock() メソッドを呼び出します。このように処理を行うと、ピクセル変更がすべて完了するまで、この BitmapData インスタンスを参照するオブジェクトは更新されません。

関連項目

BitmapData オブジェクトの 1 つのピクセルにカラー値とアルファ透明度値を設定します。このメソッドは setPixel() メソッドと似ています。主な違いは、setPixel32() メソッドはアルファチャネル情報を含む ARGB カラー値を受け入れることです。

BitmapData オブジェクト内のすべてのピクセルは、乗算済みカラー値として保存されます。乗算済みイメージピクセルは、アルファデータが既に乗算された赤、緑、青の各カラーチャネル値を保持します。たとえば、アルファ値が 0 の場合、乗算されていない値とは無関係に、RGB チャネルの値も 0 になります。このようにデータが失われると、処理の実行時に問題が生じることがあります。BitmapData のすべてのメソッドは、乗算されていない値を受け取ったり返したりします。ピクセルの内部表現は、値として返される前に、乗算済みから非乗算に変換されます。設定処理の際は、ピクセル値が事前に乗算されてから、生のイメージピクセルが設定されます。

メモ : パフォーマンスを向上させるには、setPixel() または setPixel32() メソッドを繰り返し使用し、setPixel() またはsetPixel32() メソッドを呼び出す前に lock() メソッドを呼び出します。その後、ピクセルの変更がすべて完了したら unlock() メソッドを呼び出します。このように処理を行うと、ピクセル変更がすべて完了するまで、この BitmapData インスタンスを参照するオブジェクトは更新されません。

関連項目

バイト配列をピクセルデータの矩形領域に変換します。各ピクセルごとに ByteArray.readUnsignedInt() メソッドが呼び出され、戻り値がピクセルに書き込まれます。矩形全体が書き込まれる前にバイト配列が終了した場合、関数は終了します。バイト配列内のデータは 32 ビット ARGB ピクセル値と想定されます。ピクセル読み取りの前後に、バイト配列に対するシークは実行されません。

関連項目

指定されたしきい値と比較してイメージ内のピクセル値をテストし、テストに適合したピクセルに新しいカラー値を設定します。threshold() メソッドを使用すれば、イメージ内のカラー範囲を分離および置換したり、その他の論理演算をイメージピクセルに対して実行することができます。

threshold() メソッドのテスト論理は次のとおりです。

1. ((pixelValue & mask) operation (threshold & mask)) の場合、ピクセルを color に設定
2. そうでない場合、copySource == true であれば、sourceBitmap の対応するピクセル値にピクセルを設定

operation パラメータには、しきい値テストで使用する比較演算子を指定します。たとえば、operation パラメータとして "==" を使用することにより、イメージ内の特定のカラー値を分離できます。または、{operation: "<", mask: 0xFF000000, threshold: 0x7F000000, color: 0x00000000} を使用することにより、ソースイメージピクセルのアルファが 0x7F 未満の場合に、すべてのターゲットピクセルが完全に透明になるように設定できます。アニメーション化されたトランジションやその他の効果に対して、この技法を使用できます。

この BitmapData オブジェクトが変更されたときに、BitmapData オブジェクトを参照するすべてのオブジェクト (たとえば Bitmap オブジェクト) が更新されるように、イメージをロック解除します。パフォーマンスを向上させるには、setPixel() メソッドまたは setPixel32() メソッドを何度も呼び出す前後に、このメソッドを lock() メソッドとともに使用してください。

関連項目