downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

imagefontheight> <imagefilltoborder
Last updated: Fri, 19 Feb 2010

view this page in

imagefilter

(PHP 5)

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

説明

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

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 の値を指定します。また arg4 を使用して alpha チャネルの値を指定します。 各値の範囲は 0 から 255 までです。
  • IMG_FILTER_EDGEDETECT: エッジを検出し、 画像のエッジを強調します。
  • IMG_FILTER_EMBOSS: 画像にエンボス処理を行います。
  • IMG_FILTER_GAUSSIAN_BLUR: ガウス分布を 使用して画像をぼかします。
  • IMG_FILTER_SELECTIVE_BLUR: 画像をぼかします。
  • IMG_FILTER_MEAN_REMOVAL: 平均を除去し、 「スケッチ風の」効果を得ます。
  • IMG_FILTER_SMOOTH: 画像を滑らかにします。 滑らかさのレベルを arg1 で指定します。
  • IMG_FILTER_PIXELATE: モザイク効果を画像に適用します。 arg1 でブロックの大きさを、 そして arg2 でモザイク効果のモードを指定します。

arg1

  • IMG_FILTER_BRIGHTNESS: 輝度レベル。
  • IMG_FILTER_CONTRAST: コントラストレベル。
  • IMG_FILTER_COLORIZE: 赤コンポーネントの値。
  • IMG_FILTER_SMOOTH: 平滑度レベル。
  • IMG_FILTER_PIXELATE: ピクセル単位のブロックサイズ。

arg2

  • IMG_FILTER_COLORIZE: 緑コンポーネントの値。
  • IMG_FILTER_PIXELATE: 高度なモザイク効果を使用するか否か (デフォルトは FALSE)。

arg3

  • IMG_FILTER_COLORIZE: 青コンポーネントの値。

arg4

  • IMG_FILTER_COLORIZE: アルファチャネル。 0 から 127 までの値で、0 は完全な不透明、127 は完全な透明を表す。

返り値

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

変更履歴

バージョン 説明
5.2.5 IMG_FILTER_COLORIZE でアルファチャネルをサポートするようになりました。

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

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

if(
$im && imagefilter($imIMG_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($imIMG_FILTER_BRIGHTNESS20))
{
    echo 
'Image brightness changed.';

    
imagepng($im'sean.png');
    
imagedestroy($im);
}
else
{
    echo 
'Image brightness change failed.';
}
?>

例3 imagefilter() 単色化の例

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

/* R, G, B, so 0, 255, 0 is green */
if($im && imagefilter($imIMG_FILTER_COLORIZE02550))
{
    echo 
'Image successfully shaded green.';

    
imagepng($im'philip.png');
    
imagedestroy($im);
}
else
{
    echo 
'Green shading failed.';
}
?>

例4 imagefilter() での打ち消しの例

<?php
// Define our negate function so its portable for 
// php versions without imagefilter()
function negate($im)
{
    if(
function_exists('imagefilter'))
    {
        return 
imagefilter($imIMG_FILTER_NEGATE);
    }

    for(
$x 0$x imagesx($im); ++$x)
    {
        for(
$y 0$y imagesy($im); ++$y)
        {
            
$index imagecolorat($im$x$y);
            
$rgb imagecolorsforindex($index);
            
$color imagecolorallocate($im255 $rgb['red'], 255 $rgb['green'], 255 $rgb['blue']);

            
imagesetpixel($im$x$y$color);
        }
    }

    return(
true);
}

$im imagecreatefromjpeg('kalle.jpg');

if(
$im && negate($im))
{
    echo 
'Image successfully converted to negative colors.';

    
imagejpeg($im'kalle.jpg'100);
    
imagedestroy($im);
}
else
{
    echo 
'Converting to negative colors failed.';
}
?>

例5 imagefilter() でのモザイク処理の例

<?php
// Load the PHP logo, we need to create two instances 
// to show the differences
$logo1 imagecreatefrompng('./php.png');
$logo2 imagecreatefrompng('./php.png');

// Create the image instance we want to show the 
// differences on
$output imagecreatetruecolor(imagesx($logo1) * 2imagesy($logo1));

// Apply pixelation to each instance, with a block 
// size of 3
imagefilter($logo1IMG_FILTER_PIXELATE3);
imagefilter($logo2IMG_FILTER_PIXELATE3true);

// Merge the differences onto the output image
imagecopy($output$logo10000imagesx($logo1) - 1imagesy($logo1) - 1);
imagecopy($output$logo2imagesx($logo2), 000imagesx($logo2) - 1imagesy($logo2) - 1);
imagedestroy($logo1);
imagedestroy($logo2);

// Output the differences
header('Content-Type: image/png');
imagepng($output);
imagedestroy($output);
?>

上の例の出力は、 たとえば以下のようになります。

注意

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

参考

  • imageconvolution() - div および offset の係数を使用し、3x3 の畳み込み配列を適用する



imagefontheight> <imagefilltoborder
Last updated: Fri, 19 Feb 2010
 
add a note add a note User Contributed Notes
imagefilter
mail at kavisiegel dot com
25-Jun-2009 06:11
Searching for a way to easily change the color of the image, I tried IMG_FILTER_COLORIZE. I was unable to get the quality results I wanted. It turns out PHP's Colorize is the equivalent of Photoshop's "Linear Dodge" layer filter.

Hue adjustments have always worked well for me, so I figured I could try with PHP.
This function is kind of slow on larger images, but on small images like what I'm using it for, the difference is trivial.

The script calculates the ratio or red, to green, to blue in the color provided, then scales the image appropriately... unfortunately, it does it pixel by pixel.

Here's a demo and comparison of this function, to photoshop's hue function, to PHP's colorize. http://img146.imageshack.us/img146/3167/imagefilterhuedemo.png

<?php
function imagefilterhue($im,$r,$g,$b){
   
$rgb = $r+$g+$b;
   
$col = array($r/$rgb,$b/$rgb,$g/$rgb);
   
$height = imagesy($im);
   
$width = imagesx($im);
    for(
$x=0; $x<$width; $x++){
        for(
$y=0; $y<$height; $y++){
           
$rgb = ImageColorAt($im, $x, $y);
           
$r = ($rgb >> 16) & 0xFF;
           
$g = ($rgb >> 8) & 0xFF;
           
$b = $rgb & 0xFF;
           
$newR = $r*$col[0] + $g*$col[1] + $b*$col[2];
           
$newG = $r*$col[2] + $g*$col[0] + $b*$col[1];
           
$newB = $r*$col[1] + $g*$col[2] + $b*$col[0];
           
imagesetpixel($im, $x, $y,imagecolorallocate($im, $newR, $newG, $newB));
        }
    }
}
header ("Content-type: image/jpeg");
$im = imagecreatefromjpeg("test.jpg");

// Usage: Just as imagefilter(), except with no filtertype.
// imagefilterhue(resource $image, int $red, int $green , int $blue)
imagefilterhue($im,2,70,188);

// The equivalent with colorize, as tested in demo image: imagefilter($im, IMG_FILTER_COLORIZE, 2, 70, 188);

imagejpeg($im);
?>
aiden dot mail at freemail dot hu
29-Mar-2008 08:16
Function to change the transparency of a png image on the fly. Works only with PNG, and with a browser supporting alpha channel.
The function stretches the opacity-range of the image, so that the most opaque pixel(s) will be set to the given opacity. (Other opacity values in pixels are modified accordingly.)
Returns success or failure.

<?php
function filter_opacity( &$img, $opacity ) //params: image resource id, opacity in percentage (eg. 80)
       
{
            if( !isset(
$opacity ) )
                { return
false; }
           
$opacity /= 100;
           
           
//get image width and height
           
$w = imagesx( $img );
           
$h = imagesy( $img );
           
           
//turn alpha blending off
           
imagealphablending( $img, false );
           
           
//find the most opaque pixel in the image (the one with the smallest alpha value)
           
$minalpha = 127;
            for(
$x = 0; $x < $w; $x++ )
                for(
$y = 0; $y < $h; $y++ )
                    {
                       
$alpha = ( imagecolorat( $img, $x, $y ) >> 24 ) & 0xFF;
                        if(
$alpha < $minalpha )
                            {
$minalpha = $alpha; }
                    }
           
           
//loop through image pixels and modify alpha for each
           
for( $x = 0; $x < $w; $x++ )
                {
                    for(
$y = 0; $y < $h; $y++ )
                        {
                           
//get current alpha value (represents the TANSPARENCY!)
                           
$colorxy = imagecolorat( $img, $x, $y );
                           
$alpha = ( $colorxy >> 24 ) & 0xFF;
                           
//calculate new alpha
                           
if( $minalpha !== 127 )
                                {
$alpha = 127 + 127 * $opacity * ( $alpha - 127 ) / ( 127 - $minalpha ); }
                            else
                                {
$alpha += 127 * $opacity; }
                           
//get the color index with new alpha
                           
$alphacolorxy = imagecolorallocatealpha( $img, ( $colorxy >> 16 ) & 0xFF, ( $colorxy >> 8 ) & 0xFF, $colorxy & 0xFF, $alpha );
                           
//set pixel with the new color + opacity
                           
if( !imagesetpixel( $img, $x, $y, $alphacolorxy ) )
                                { return
false; }
                        }
                }
            return
true;
        }
?>

Example for use:

 <?php
  $image
= imagecreatefrompng( "img.png" );
 
filter_opacity( $image, 75 );
 
header( "content-type: image/png" );
 
imagepng( $image );
 
imagedestroy( $image );
?>
Kae Cyphet
03-Dec-2007 12:23
To solve that annoying problem of having to install a pre-compiled version of GD just to get imagefilter($image,IMAGE_FILTER_NEGATE) working.

here is an open source solution.
uses the standard stuff included in php when you uncomment 'extension=php_gd2.dll' in the php.ini file and there ya go!

Useage:
<?php
$im
= imagecreatefromjpeg("my_fav_image.jpg");

header("Content-type: image/jpg");
imagejpeg(invertimage($im));

imagedestroy($im);
?>

'=================================

<?php
function int2rgb($myint)
{
  return array(
'red' => 0xFF & ($myint >> 0x10), 'green' => 0xFF & ($myint >> 0x8), 'blue' => 0xFF & $myint);
}

function
invertimage($im)
{
 
$wid = imagesx($im);
 
$hei = imagesy($im);
 
$im2 = imagecreatetruecolor($wid,$hei);
 
$i=0;
 
$j=0;
 
$rgb = array('red' => 0, 'green' => 0, 'blue' => 0);
 
$ref = 0;

 for(
$i = 0;$i < $wid; $i++)
 {
  for(
$j = 0;$j < $hei; $j++)
  {
  
$rgb = int2rgb(imagecolorat($im,$i,$j));
  
$ref = imagecolorallocate($im2,255 - intval($rgb['red']),255 - intval($rgb['green']),255 - intval($rgb['blue']));
  
imagesetpixel($im2,$i,$j,$ref);
  }
 }
 return
$im2;
}
?>
michaeln no at spam associationsplus ca
21-Nov-2007 04:11
Note: applying IMG_FILTER_EMBOSS to text and using in a customization to the CAPTCHA image script in phpBB or a project of your own is a very good way to stop OCR-ing bots from getting through. Embossed serif fonts are fairly easy for the human eye to understand but to an OCR script it is extremely difficult because it seems to give it the illusion of 3D.

If you only allocate 2 or 3 colours in the image, it uses the background colour alot in the embossed text, which greatly contributes to this.

I made my own custom CAPTCHA script to stop phpBB post spam for a client site I was developing and I have gone from getting 2-3 new spam users created every day to zero.

Anything with the source code freely available out there right now is possible to be defeated by spammers once one of them stars sharing code with the other spammers, but if you run something at least someone custom, their bots will pass you over.
ssttoo at gmail dot com
13-Nov-2007 08:31
Here's a page that shows the different filters in action
http://www.phpied.com/image-fun-with-php-part-2/
Also shows some quick ways to do sepia.
admin at phpgfx dot com
26-Aug-2007 04:52
this is a sepia function using microsoft's definition

<?php

function imagesepia( $img ) {
   
$total = imagecolorstotal( $img );
    for (
$i = 0; $i < $total; $i++ ) {
       
$index = imagecolorsforindex( $img, $i );
       
$red = ( $index["red"] * 0.393 + $index["green"] * 0.769 + $index["blue"] * 0.189 ) / 1.351;
       
$green = ( $index["red"] * 0.349 + $index["green"] * 0.686 + $index["blue"] * 0.168 ) / 1.203;
       
$blue = ( $index["red"] * 0.272 + $index["green"] * 0.534 + $index["blue"] * 0.131 ) / 2.140;
       
imagecolorset( $img, $i, $red, $green, $blue );
    }
}

?>
webmaster at designsbykosi dot info
08-May-2007 07:56
This will only work if you have php5. For php4, you'll have to use the sepia function set webmaster at qudi dot de suggested.
fananf at nerdshack dot com
16-Mar-2007 05:26
If you're looking for fast sepia effect that can be used for on-the-fly thumbnails generation you can't use sophisticated functions. The faster and much better way than described by webmaster at qudi dot de in the note from 31-Jan-2006 is applying colorize filter AFTER grayscale.

<?php

(...)

imagefilter($yourimage, IMG_FILTER_GRAYSCALE); imagefilter($yourimage, IMG_FILTER_COLORIZE, 90, 60, 40);

(...)

?>

I used (90,60,40) for my sepia after couple of tests, however, if you need darker or lighter just check what suits you best.
trucex email over at gmail
14-Feb-2007 08:31
It appears that imagefilter doesn't play nice with apha. If you run an imagefilter on a transparent image it'll return a black image...similar to a lot of Photoshop plugins do.
PanuWorld
14-Jan-2007 02:55
The documentation misses the exact meaning and valid ranges of the arguments for ImageFilter(). According to the 5.2.0 sources the arguments are:
IMG_FILTER_BRIGHTNESS
-255 = min brightness, 0 = no change, +255 = max brightness

IMG_FILTER_CONTRAST
-100 = max contrast, 0 = no change, +100 = min contrast (note the direction!)

IMG_FILTER_COLORIZE
Adds (subtracts) specified RGB values to each pixel. The valid range for each color is -255...+255, not 0...255. The correct order is red, green, blue.
-255 = min, 0 = no change, +255 = max
This has not much to do with IMG_FILTER_GRAYSCALE.

IMG_FILTER_SMOOTH
Applies a 9-cell convolution matrix where center pixel has the weight arg1 and others weight of 1.0. The result is normalized by dividing the sum with arg1 + 8.0 (sum of the matrix).
any float is accepted, large value (in practice: 2048 or more) = no change

ImageFilter seem to return false if the argument(s) are out of range for the chosen filter.
nancy at hypertextdigital dot com
03-Aug-2006 09:16
This routine was just what I was looking for, I wanted web admin users to be able to recolour their uploaded photos (to go with a news item) either a blue tint or sepia to match the appearance of other colours used on the website.

Using a form with a select box containing the RGB values, I can give them the option of either of the two tints or no colourization at all, plus resize their images to the viewing size and a thumbnail image on the fly without having to use any other image editing software.
santibari at fibertel dot com
27-Feb-2006 07:37
A colorize algorithm wich preserves color luminosity (i.e black
will output black, and white will output white).
This works in PHP4 and is great for customizing interfaces
dinamically.

<?php
function colorize($img_src,$img_dest, $r, $g, $b)
{
if(!
$im = imagecreatefromgif($img_src))
  return
"Could not use image $img_src";
   
//We will create a monochromatic palette based on
//the input color
//which will go from black to white
//Input color luminosity: this is equivalent to the
//position of the input color in the monochromatic
//palette
$lum_inp=round(255*($r+$g+$b)/765); //765=255*3

//We fill the palette entry with the input color at its
//corresponding position

$pal[$lum_inp]['r']=$r;
$pal[$lum_inp]['g']=$g;
$pal[$lum_inp]['b']=$b;

//Now we complete the palette, first we'll do it to
//the black,and then to the white.

//FROM input to black
//===================
//how many colors between black and input
$steps_to_black=$lum_inp;       

//The step size for each component
if($steps_to_black)
 {
 
$step_size_red=$r/$steps_to_black;   
 
$step_size_green=$g/$steps_to_black;   
 
$step_size_blue=$b/$steps_to_black;   
 }

for(
$i=$steps_to_black;$i>=0;$i--)
 {
 
$pal[$steps_to_black-$i]['r']=$r-round($step_size_red*$i);
 
$pal[$steps_to_black-$i]['g']=$g-round($step_size_green*$i);
 
$pal[$steps_to_black-$i]['b']=$b-round($step_size_blue*$i);
 }

//From input to white:
//===================
//how many colors between input and white
$steps_to_white=255-$lum_inp;

if(
$steps_to_white)
  {
 
$step_size_red=(255-$r)/$steps_to_white;   
 
$step_size_green=(255-$g)/$steps_to_white;   
 
$step_size_blue=(255-$b)/$steps_to_white;   
  }
 else
 
$step_size_red=$step_size_green=$step_size_blue=0;

 
//The step size for each component
 
for($i=($lum_inp+1);$i<=255;$i++)
  {
 
$pal[$i]['r']=$r + round($step_size_red*($i-$lum_inp));
 
$pal[$i]['g']=$g + round($step_size_green*($i-$lum_inp));
 
$pal[$i]['b']=$b + round($step_size_blue*($i-$lum_inp));
  }
//--- End of palette creation

//Now,let's change the original palette into the one we
//created
for($c = 0; $c < $palette_size; $c++)
 {
 
$col = imagecolorsforindex($im, $c);         
 
$lum_src=round(255*($col['red']+$col['green']
                +
$col['blue'])/765);
 
$col_out=$pal[$lum_src];
 
imagecolorset($im, $c, $col_out['r'],
                               
$col_out['g'],
                               
$col_out['b']);
 }

 
//save the image file
 
imagepng($im,$img_dest);
 
imagedestroy($im);
}
//end function colorize
?>
webmaster at qudi dot de
31-Jan-2006 02:53
for a quick, ok-looking, sepia-effect (also in php4) I just use this little fellow, since a real implementation of sepia was just way too slow.

function pseudosepia(&$im,$percent){
      $sx=imagesx($im);
      $sy=imagesy($im);
      $filter=imagecreatetruecolor($sx,$sy);
      $c=imagecolorallocate($filter,100,50,50);
      imagefilledrectangle($filter,0,0,$sx,$sy,$c);
      imagecopymerge($im,$filter,0,0,0,0,$sx,$sy,$percent);
}
a php user at nowhere dot com
20-Dec-2005 08:48
http://www.hudzilla.org/phpbook/read.php/11_2_15
for more detailed info, and some <i>arg</i> guidelines.
vdepizzol at hotmail dot com
04-Sep-2004 08:36
Examples using 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);
?>

/////////////////////////////

<?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);
?>

/////////////////////////////

<?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);
?>
kees at tweakers dot net
21-Jul-2004 01:26
From what i have been able to find from this function, it accepts the following arguments:
        IMG_FILTER_NEGATE
        IMG_FILTER_GRAYSCALE
        IMG_FILTER_EDGEDETECT
        IMG_FILTER_GAUSSIAN_BLUR
        IMG_FILTER_SELECTIVE_BLUR
        IMG_FILTER_EMBOSS
        IMG_FILTER_MEAN_REMOVAL

The following arguments need one or more arguments.
        IMG_FILTER_SMOOTH, -1924.124
        IMG_FILTER_COLORIZE, -127.12, -127.98, 127
        IMG_FILTER_CONTRAST, -90
        IMG_FILTER_BRIGHTNESS, 98
       
I haven't tested them all, the names speak for themselves.

imagefontheight> <imagefilltoborder
Last updated: Fri, 19 Feb 2010
 
 
show source | credits | stats | sitemap | contact | advertising | mirror sites