imageantialias

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

imageantialiasActivar o desactivar las funciones de antialias

Descripción

imageantialias(GdImage $image, bool $enable): bool

Activa los métodos de dibujo rápido antialias para líneas y polígonos. Los componentes alpha no son soportados. Funciona utilizando una operación directa de mezcla, únicamente con imágenes truecolor.

El grosor y los estilos no son soportados.

El uso de primitivas antialias con fondos transparentes puede llevar a resultados inesperados. El método de mezcla utiliza el color de fondo como cualquier otra color. La falta de soporte del componente alpha impide el uso de antialias basado en alpha.

Parámetros

image

Un recurso image, es devuelto por una de las funciones de creación de imágenes, como imagecreatetruecolor().

enable

Si se debe activar el antialias o no.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Historial de cambios

Versión Descripción
8.0.0 image expects a GdImage instance now; previously, a valid gd resource was expected.
7.2.0 imageantialias() ahora está generalmente disponible. Anteriormente, solo estaba disponible si PHP fue compilado con la versión agrupada de la biblioteca GD.

Ejemplos

Ejemplo #1 Comparación de 2 líneas, una con antialias y otra sin

<?php
// Define una imagen antialias y una normal
$aa = imagecreatetruecolor(400, 100);
$normal = imagecreatetruecolor(200, 100);

// Activa el antialiasing para una imagen
imageantialias($aa, true);

// Asigna los colores
$red = imagecolorallocate($normal, 255, 0, 0);
$red_aa = imagecolorallocate($aa, 255, 0, 0);

// Dibuja 2 líneas, una con antialiasing
imageline($normal, 0, 0, 200, 100, $red);
imageline($aa, 0, 0, 200, 100, $red_aa);

// Fusiona las 2 imágenes, lado a lado para la visualización
// (AA: izquierda, Normal: derecha)
imagecopymerge($aa, $normal, 200, 0, 0, 0, 200, 100, 100);

// Muestra la imagen
header('Content-type: image/png');

imagepng($aa);
?>

El resultado del ejemplo sería algo similar a:

Visualización del ejemplo: Comparación de 2 líneas, una con antialias

Ver también