imageantialias

Should antialias functions be used or not

Description

bool imageantialias ( resource $image , bool $enabled )

Activate the fast drawing antialiased methods for lines and wired polygons. It does not support alpha components. It works using a direct blend operation. It works only with truecolor images.

Thickness and styled are not supported.

Using antialiased primitives with transparent background color can end with some unexpected results. The blend method uses the background color as any other colors. The lack of alpha component support does not allow an alpha based antialiasing method.

Parameters

image

An image resource, returned by one of the image creation functions, such as imagecreatetruecolor.

enabled

Whether to enable antialiasing or not.

Return Values

Returns TRUE on success or FALSE on failure.

Changelog

Version Description
7.2.0 imageantialias is now generally available. Formerly it was only available if PHP was compiled with the bundled version of the GD library.

Examples

Example #1 A comparison of two lines, one with anti-aliasing switched on

<?php
// Setup an anti-aliased image and a normal image
$aa imagecreatetruecolor(400100);
$normal imagecreatetruecolor(200100);

// Switch antialiasing on for one image
imageantialias($aatrue);

// Allocate colors
$red imagecolorallocate($normal25500);
$red_aa imagecolorallocate($aa25500);

// Draw two lines, one with AA enabled
imageline($normal00200100$red);
imageline($aa00200100$red_aa);

// Merge the two images side by side for output (AA: left, Normal: Right)
imagecopymerge($aa$normal200000200100100);

// Output image
header('Content-type: image/png');

imagepng($aa);
imagedestroy($aa);
imagedestroy($normal);
?>

The above example will output something similar to:

Output of example : A comparison of two lines, one with anti-aliasing switched on

See Also

  • imagecreatetruecolor