PHP Manual: Create a new image from a given part of GD2 file or URL

Description

GdImagefalse imagecreatefromgd2part(
    string $filename,
    int $x,
    int $y,
    int $width,
    int $height
)

Create a new image from a given part of GD2 file or URL.

Tip

A URL can be used as a filename with this function if the fopen wrappers have been enabled. See fopen for more details on how to specify the filename. See the Supported Protocols and Wrappers for links to information about what abilities the various wrappers have, notes on their usage, and information on any predefined variables they may provide.

Parameters

filename: Path to the GD2 image.
x: x-coordinate of source point.
y: y-coordinate of source point.
width: Source width.
height: Source height.

Return Values

Returns an image object on success, false on errors.

Changelog

Version	Description
8.0.0	On success, this function returns a GDImage instance now; previously, a resource was returned.

Examples

Example #1 imagecreatefromgd2part example

<?php
// For this example we need the image size before
$image = getimagesize('./test.gd2');

// Create the image instance now we got the image 
// sizes
$im = imagecreatefromgd2part('./test.gd2', 4, 4, ($image[0] / 2) - 6, ($image[1] / 2) - 6);

// Do an image operation, in this case we emboss the image
if(function_exists('imagefilter'))
{
    imagefilter($im, IMG_FILTER_EMBOSS);
}

// Save optimized image
imagegd2($im, './test_emboss.gd2');
imagedestroy($im);
?>

Notes

Warning

The GD and GD2 image formats are proprietary image formats of libgd. They have to be regarded obsolete, and should only be used for development and testing purposes.