imagefilter

(PHP 5)

imagefilter -- 画像にフィルタを適用する

説明

bool imagefilter ( resource image, int filtertype [, int arg1 [, int arg2 [, int arg3]]] )

imagefilter() は、指定したフィルタ filtertypeimage に適用します。

パラメータ

image

imagecreatetruecolor() のような画像作成関数が返す画像リソース。

filtertype

filtertype は、以下のいずれかです。

  • IMG_FILTER_NEGATE: 画像の色を反転させます。

  • IMG_FILTER_GRAYSCALE: 画像をグレースケールに変換します。

  • IMG_FILTER_BRIGHTNESS: 画像の輝度を変更します。 輝度レベルを arg1 で設定します。

  • IMG_FILTER_CONTRAST: 画像のコントラストを 変更します。コントラストのレベルを arg1 で設定します。

  • IMG_FILTER_COLORIZE: IMG_FILTER_GRAYSCALE と似ていますが、 色を指定することが可能です。 arg1arg2 および arg3 を使用して redbluegreen の値を指定します。 各値の範囲は 0 から 255 までです。

  • IMG_FILTER_EDGEDETECT: エッジを検出し、 画像のエッジを強調します。

  • IMG_FILTER_EMBOSS: 画像にエンボス処理を行います。

  • IMG_FILTER_GAUSSIAN_BLUR: ガウス分布を 使用して画像をぼかします。

  • IMG_FILTER_SELECTIVE_BLUR: 画像をぼかします。

  • IMG_FILTER_MEAN_REMOVAL: 平均を除去し、 「スケッチ風の」効果を得ます。

  • IMG_FILTER_SMOOTH: 画像を滑らかにします。 滑らかさのレベルを arg1 で指定します。

arg1

arg2

arg3

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

例 1. imagefilter() グレースケールの例

<?php
$im
= imagecreatefrompng('dave.png');
if (
$im && imagefilter($im, IMG_FILTER_GRAYSCALE)) {
    echo
'Image converted to grayscale.';
    
imagepng($im, 'dave.png');
} else {
    echo
'Conversion to grayscale failed.';
}

imagedestroy($im);
?>

例 2. imagefilter() 輝度の例

<?php
$im
= imagecreatefrompng('sean.png');
if (
$im && imagefilter($im, IMG_FILTER_BRIGHTNESS, 20)) {
    echo
'Image brightness changed.';
    
imagepng($im, 'sean.png');
} else {
    echo
'Image brightness change failed.';
}

imagedestroy($im);
?>

例 3. imagefilter() 単色化の例

<?php
$im
= imagecreatefrompng('philip.png');

/* R, G, B, so 0, 255, 0 is green */
if ($im && imagefilter($im, IMG_FILTER_COLORIZE, 0, 255, 0)) {
    echo
'Image successfully shaded green.';
    
imagepng($im, 'philip.png');
} else {
    echo
'Green shading failed.';
}

imagedestroy($im);
?>

注意

注意: この関数は、PHP がバンドル版の GD ライブラリで コンパイルされている場合のみ使用可能です。

参考

imageconvolution()