IMAGECOPYMERGEGRAY(3) 1 IMAGECOPYMERGEGRAY(3)
imagecopymergegray - Copy and merge part of an image with gray scale
SYNOPSIS
bool imagecopymergegray (resource $dst_im, resource $src_im, int $dst_x, int $dst_y, int $src_x, int $src_y, int $src_w, int
$src_h, int $pct)
DESCRIPTION
imagecopymergegray(3) copy a part of $src_im onto $dst_im starting at the x,y coordinates $src_x, $src_y with a width of $src_w and a
height of $src_h. The portion defined will be copied onto the x,y coordinates, $dst_x and $dst_y.
This function is identical to imagecopymerge(3) except that when merging it preserves the hue of the source by converting the destination
pixels to gray scale before the copy operation.
PARAMETERS
o $dst_im
-Destination image link resource.
o $src_im
-Source image link resource.
o $dst_x
- x-coordinate of destination point.
o $dst_y
- y-coordinate of destination point.
o $src_x
- x-coordinate of source point.
o $src_y
- y-coordinate of source point.
o $src_w
-Source width.
o $src_h
-Source height.
o $pct
- The $src_im will be changed to grayscale according to $pct where 0 is fully grayscale and 100 is unchanged. When $pct = 100 this
function behaves identically to imagecopy(3) for pallete images, except for ignoring alpha components, while it implements alpha
transparency for true colour images.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
EXAMPLES
Example #1
imagecopymergegray(3) usage
<?php
// Create image instances
$dest = imagecreatefromgif('php.gif');
$src = imagecreatefromgif('php.gif');
// Copy and merge - Gray = 20%
imagecopymergegray($dest, $src, 10, 10, 0, 0, 100, 47, 20);
// Output and free from memory
header('Content-Type: image/gif');
imagegif($dest);
imagedestroy($dest);
imagedestroy($src);
?>
PHP Documentation Group IMAGECOPYMERGEGRAY(3)
