画像の生のピクセルをエクスポートする

# Imagick::exportImagePixels

(No version information available, might only be in Git)

Imagick::exportImagePixels — 画像の生のピクセルをエクスポートする

### 説明

public Imagick::exportImagePixels ( int `$x` , int `$y` , int `$width` , int `$height` , string `$map` , int `$STORAGE` ) : array

画像のピクセルを配列にエクスポートします。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 をスローします。