imageantialias

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

imageantialias — Utiliser ou non les fonctions d'antialias

Description

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

Active les méthodes de dessin rapide antialias concernant les lignes et les polygones. Les composantes alpha ne sont pas supportées. Fonctionne en utilisant une opération directe de mélange, uniquement avec les images truecolor.

L'épaisseur et les styles ne sont pas supportés.

L'utilisation des primitives antialias avec des arrière-plans transparents peut mener à des résultats imprévus. La méthode de mélange utilise la couleur d'arrière-plan comme toute autre couleur. Le manque de support du composant alpha empêche l'utilisation de antialias basé sur l'alpha.

Liste de paramètres

image

Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

enable

Si l'on doit activer l'antialias ou non.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Historique

Version Description
8.0.0 image attend une instance de GdImage désormais; auparavant, une resource gd était attendue.
7.2.0 imageantialias() est maintenant généralement disponible. Auparavant, elle était seulement disponible si PHP a été compilé avec la version groupée de la bibliothèque GD.

Exemples

Exemple #1 Comparaison de 2 lignes, dont l'une est anti-aliasée

<?php
// Définit une image anti-aliasée et une normale
$aa = imagecreatetruecolor(400, 100);
$normal = imagecreatetruecolor(200, 100);

// Active l'antialiasing pour une image
imageantialias($aa, true);

// Alloue les couleurs
$red = imagecolorallocate($normal, 255, 0, 0);
$red_aa = imagecolorallocate($aa, 255, 0, 0);

// Dessine 2 lignes, dont l'une avec l'antialiasing
imageline($normal, 0, 0, 200, 100, $red);
imageline($aa, 0, 0, 200, 100, $red_aa);

// Fusionne les 2 images, côté par côté pour l'affichage
// (AA: gauche, Normal: Droit)
imagecopymerge($aa, $normal, 200, 0, 0, 0, 200, 100, 100);

// Affichage de l'image
header('Content-type: image/png');

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

Résultat de l'exemple ci-dessus est similaire à :

Affichage de l'exemple : Une comparaison de 2 lignes, dont une avec un anti-aliasing

Voir aussi