Image_Transform

一般的な使用法

Image_Transform を使う際に最初にすることは、 Image_Transform_Driver のインスタンスを 静的メソッド factory() で作ることです。 このメソッドにドライバ名を渡せば、インスタンスを取得することができます。

これで、あとは load() にファイル名を指定すれば画像を読み込めるようになります。 倍率変更用のメソッドのひとつを使用したら、最後は save() で保存します。

<?php
require_once 'Image/Transform.php';

// 変換ドライバオブジェクトを作成します
$it = Image_Transform::factory('GD');

// 元ファイルを読み込みます
$it->load('beach-large.jpg');

// 150px に縮小します
$it->scaleMaxLength(150);

// 別のファイルとして保存します
$it->save('beach-150px.jpg');
?>

上の例では一切エラーチェックをしていません。 すべてのメソッドは PEAR_Error オブジェクトを返します。 返り値をチェックするか、あるいは PHP 5 の場合はグローバル PEAR エラーハンドラを設定してエラー時に例外をスローさせるようにします。 これは、発生することがわかっているけれどもあえて無視している というエラーがある際などに問題となります。 (特に他のパッケージと併用する場合など) この方式を使用する際には注意しましょう。

<?php
require_once 'Image/Transform.php';

// 変換ドライバオブジェクトを作成します
$it = Image_Transform::factory('GD');
if (PEAR::isError($it)) {
    die($it->getMessage());
}

// 元ファイルを読み込みます
$ret = $it->load('beach-large.jpg');
if (PEAR::isError($ret)) {
    die($ret->getMessage());
}

// 150px に縮小します
$ret = $it->scaleByLength(150);
if (PEAR::isError($ret)) {
    die($ret->getMessage());
}

// 別のファイルとして保存します
$ret = $it->save('beach-150px.jpg');
if (PEAR::isError($ret)) {
    die($ret->getMessage());
}
?>

ドライバ

Image_Transform パッケージは、ドライバなしでは使えません。 ドライバは、グラフィックライブラリのメソッドをカプセル化したものです。 2008 年 4 月時点では、このパッケージのドライバには次のようなものがあります。 これらをインストールして使用することができます。

• Image_Transform_Driver_GD - GD 2 拡張モジュールのメソッドを使用

• Image_Transform_Driver_Imagick2 - imagick PECL 拡張モジュール バージョン < 2.0 用

• Image_Transform_Driver_Imagick3 - imagick PECL 拡張モジュール バージョン >= 2.0 用

• Image_Transform_Driver_Imlib - PHP の imlib 拡張モジュールを使用

• Image_Transform_Driver_IM - Imagick バイナリ実行ファイル (拡張モジュールがインストールされていない場合用)

• Image_Transform_Driver_NetPBM - NetPBM パッケージのバイナリ実行ファイル pnmscale を使用

画像の拡大・縮小

Image_Transform には、 画像の拡大や縮小をおこなうさまざまなメソッドがあります。 そのほとんどは、基本的なサイズ変更のメソッドを さまざまなパラメータでコールするだけのものです。 実行結果は同じですが、利便性を確保するために用意されています。 ここで、これらのメソッドについて簡単にまとめておきます。

• resize - 汎用のサイズ変更メソッド。サイズ、パーセンテージ (% つきの文字列) あるいは倍率を x と y の両方について指定します。0 にすると現在のサイズを維持します。 アスペクト比を維持する必要はありません。

• scaleByX - 画像の幅を指定したピクセルに変更します。アスペクト比を維持します。

• scaleByY - 画像の高さを指定したピクセルに変更します。アスペクト比を維持します。

• scale - 汎用の拡大・縮小関数。ピクセル値、パーセンテージ (% つきの文字列) あるいは倍率 (<1) を指定します。アスペクト比を維持します。

• scaleByPercentage - 指定したパーセンテージに拡大・縮小します。

• scaleByFactor - scaleByPercentage() と同じで、 単に与える数値が 100 分の 1 になったものです。

• scaleByLength - 長辺が指定したサイズになるように拡大・縮小します。

• fit - 画像を縮小し、(幅と高さを指定した) ボックスにフィットするようにします。 既にそのボックスにおさまる大きさである場合は何も行いません。

• fitX - 幅が指定したサイズになるように画像を縮小します。 既にそのサイズより幅が小さい場合は何も行いません。

• fitY - 高さが指定したサイズになるように画像を縮小します。 既にそのサイズより高さが小さい場合は何も行いません。

保存

save() メソッドの必須パラメータは、サイズ変更後の画像を保存する際のファイル名です。 これだけを指定した場合は、新しい画像は元の画像と同じファイル形式で保存されます。

2 番目のパラメータで、保存したい画像ファイル形式にあわせた拡張子を指定することができます。 たとえば png や jpg などです。

エラーが発生した場合 (使用しているドライバがそのファイル形式をサポートしていないなど) は PEAR_Error オブジェクトを返します。

画像を保存せず直接ブラウザに送出するには display() を使用します。

その他のメソッド