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 をスローします。