Imagick::exportImagePixels
(バージョン情報なし。おそらく SVN 版にしか存在しないでしょう)
Imagick::exportImagePixels — 画像の生のピクセルをエクスポートする
説明
public array Imagick::exportImagePixels
( int
$x
, int $y
, int $width
, int $height
, string $map
, int $STORAGE
)画像のピクセルを配列にエクスポートします。map には、エクスポートするピクセルの順序を指定します。 返される配列の大きさは width * height * strlen(map) となります。 このメソッドは、ImageMagick バージョン 6.4.7 以降で Imagick をコンパイルした場合に使用可能です。
パラメータ
-
x -
エクスポートする範囲の X 座標。
-
y -
エクスポートする範囲の Y 座標。
-
width -
エクスポートする範囲の幅。
-
height -
エクスポートする範囲の高さ。
-
map -
エクスポートするピクセルの順序。"RGB" など。 map で使える文字は R, G, B, A, O, C, Y, M, K, I および P です。
-
STORAGE -
ピクセル型定数 を参照ください。
例
例1 Imagick::exportImagePixels() の使用法
画像のピクセルを配列にエクスポートします。
<?php
/* 新しいオブジェクトを作成します */
$im = new Imagick();
/* 新しい画像を作成します */
$im->newPseudoImage(0, 0, "magick:rose");
/* 画像のピクセルをエクスポートします。 */
$pixels = $im->exportImagePixels(10, 10, 2, 2, "RGB", Imagick::PIXEL_CHAR);
/* 出力します */
var_dump($pixels);
?>
上の例の出力は以下となります。
array(12) {
[0]=>
int(72)
[1]=>
int(64)
[2]=>
int(57)
[3]=>
int(69)
[4]=>
int(59)
[5]=>
int(43)
[6]=>
int(124)
[7]=>
int(120)
[8]=>
int(-96)
[9]=>
int(91)
[10]=>
int(84)
[11]=>
int(111)
}
返り値
ピクセルの値を含む配列を返します。
エラー / 例外
エラー時に ImagickException をスローします。
