Imagick クラス
PHP Manual

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(00"magick:rose");

/* 画像のピクセルをエクスポートします。 */
$pixels $im->exportImagePixels(101022"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 をスローします。


Imagick クラス
PHP Manual