imagecopy(3) [php man page]

IMAGECOPY(3)								 1							      IMAGECOPY(3)

imagecopy - Copy part of an image

SYNOPSIS

       bool imagecopy (resource  $dst_im, resource  $src_im, int  $dst_x, int  $dst_y, int  $src_x, int  $src_y, int  $src_w, int  $src_h)

DESCRIPTION

	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.

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.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Cropping the PHP.net logo

	      <?php
	      // Create image instances
	      $src = imagecreatefromgif('php.gif');
	      $dest = imagecreatetruecolor(80, 40);

	      // Copy
	      imagecopy($dest, $src, 0, 0, 20, 13, 80, 40);

	      // Output and free from memory
	      header('Content-Type: image/gif');
	      imagegif($dest);

	      imagedestroy($dest);
	      imagedestroy($src);
	      ?>

	      The above example will output something similar to:[NOT DISPLAYABLE MEDIA]Output of example : Cropping the PHP.net logo

PHP Documentation Group 													      IMAGECOPY(3)

IMAGECOPYRESIZED(3)							 1						       IMAGECOPYRESIZED(3)

imagecopyresized - Copy and resize part of an image

SYNOPSIS

       bool  imagecopyresized  (resource   $dst_image,	resource  $src_image, int  $dst_x, int	$dst_y, int  $src_x, int  $src_y, int  $dst_w, int
       $dst_h, int  $src_w, int  $src_h)

DESCRIPTION

       imagecopyresized(3) copies a rectangular portion of one image to another image. $dst_image is the  destination  image,  $src_image  is  the
       source image identifier.

	In  other  words,  imagecopyresized(3)	will  take  a  rectangular  area  from	$src_image  of	width $src_w and height $src_h at position
       ($src_x,$src_y) and place it in a rectangular area of $dst_image of width $dst_w and height $dst_h at position ($dst_x,$dst_y).

	If the source and destination coordinates and width and heights differ, appropriate stretching or shrinking of the image fragment will	be
       performed.  The	coordinates refer to the upper left corner. This function can be used to copy regions within the same image (if $dst_image
       is the same as $src_image) but if the regions overlap the results will be unpredictable.

PARAMETERS

	      o $dst_image
		-Destination image link resource.

	      o $src_image
		-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 $dst_w
		- Destination width.

	      o $dst_h
		- Destination height.

	      o $src_w
		-Source width.

	      o $src_h
		-Source height.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Resizing an image

	       This example will display the image at half size.

	      <?php
	      // File and new size
	      $filename = 'test.jpg';
	      $percent = 0.5;

	      // Content type
	      header('Content-Type: image/jpeg');

	      // Get new sizes
	      list($width, $height) = getimagesize($filename);
	      $newwidth = $width * $percent;
	      $newheight = $height * $percent;

	      // Load
	      $thumb = imagecreatetruecolor($newwidth, $newheight);
	      $source = imagecreatefromjpeg($filename);

	      // Resize
	      imagecopyresized($thumb, $source, 0, 0, 0, 0, $newwidth, $newheight, $width, $height);

	      // Output
	      imagejpeg($thumb);
	      ?>

	      The above example will output something similar to:[NOT DISPLAYABLE MEDIA]Output of example : Resizing an image

	       The image will be output at half size, though better quality could be obtained using imagecopyresampled(3).

NOTES

       Note

	       There is a problem due to palette image limitations (255+1 colors). Resampling or filtering an image  commonly  needs  more  colors
	      than  255,  a kind of approximation is used to calculate the new resampled pixel and its color. With a palette image we try to allo-
	      cate a new color, if that failed, we choose the closest (in theory) computed color. This is not always  the  closest  visual  color.
	      That may produce a weird result, like blank (or visually blank) images. To skip this problem, please use a truecolor image as a des-
	      tination image, such as one created by imagecreatetruecolor(3).

SEE ALSO

       imagecopyresampled(3)

PHP Documentation Group 												       IMAGECOPYRESIZED(3)