画像の基本属性を手軽に取得する

# Imagick::pingImageFile

(PECL imagick 2.0.0)

Imagick::pingImageFile — 画像の基本属性を手軽に取得する

### 説明

Imagick::pingImageFile ( resource `$filehandle` [, string `$fileName` ] ) : bool

このメソッドを使用すると、画像全体を読み込まなくても 画像の幅や高さ、サイズそしてフォーマットを取得できます。 このメソッドは、ImageMagick バージョン 6.2.9 以降で Imagick をコンパイルした場合に使用可能です。

### パラメータ

`filehandle`

  開いている画像のファイルハンドル。

`fileName`

  オプションで指定する、この画像のファイル名。

### 返り値

成功した場合に `TRUE` を返します。

### 例

例1 Imagick::pingImageFile() の使用法

リモートファイルを開きます。

`<?php
/* リモートファイルを fopen します */
$fp = fopen("http://example.com/test.jpg");
/* 新しい imagick オブジェクトを作成します */
$im = new Imagick();
/* ハンドルを imagick に渡します */
$im->pingImageFile($fp);
?>`

### 参考

- Imagick::pingImage() - 画像の基本属性を取得する
- Imagick::pingImageBlob() - 手早く属性を取得する
- Imagick::readImage() - ファイルから画像を読み込む
- Imagick::readImageBlob() - バイナリ文字列から画像を読み込む
- Imagick::readImageFile() - オープンしているファイルハンドルから画像を読み込む