getPixel (BitmapData.getPixel メソッド)

public getPixel(x: Number , y: Number ) : Number

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

BitmapData オブジェクト内のピクセルはすべて、乗算済みカラー値として保存されます。乗算済みイメージピクセルは、アルファデータが既に乗算された赤、緑、青の各カラーチャンネル値を保持します。たとえば、アルファ値が 0 の場合、乗算されていない値に関わらず、RGB チャンネルの値も 0 になります。

このようにデータが失われると、処理の実行時に問題が生じることがあります。Flash Player のメソッドはすべて、乗算されていない値を受け取ったり返したりします。ピクセルの内部表現は、値として返される前、乗算されていません。設定処理の際は、ピクセル値が事前に乗算されてから、生のイメージピクセルが設定されます。

対応バージョン : ActionScript 1.0、Flash Player 8

パラメータ

x:Number - ピクセルの x 座標。

y:Number - ピクセルの y 座標。

戻り値

Number - RGB ピクセル値を表す数値。(x , y ) 座標がイメージの境界外である場合は、0 を返します。

例

次の例では、getPixel() メソッドを使用して、特定の x 座標と y 座標にあるピクセルの RGB 値を取得します。

import flash.display.BitmapData;

var myBitmapData:BitmapData = new BitmapData(100, 80, false, 0x00CCCCCC);

var mc:MovieClip = this.createEmptyMovieClip("mc", this.getNextHighestDepth());
mc.attachBitmap(myBitmapData, this.getNextHighestDepth());
trace("0x" + myBitmapData.getPixel(0, 0).toString(16)); // 0xcccccc

getPixel (BitmapData.getPixel メソッド)

パラメータ

戻り値

例

関連項目