Files
doc-fr/reference/image/functions/imageantialias.xml
2021-09-24 04:13:47 +01:00

156 lines
4.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.imageantialias" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>imageantialias</refname>
<refpurpose>Utiliser ou non les fonctions d'antialias</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>imageantialias</methodname>
<methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
<methodparam><type>bool</type><parameter>enable</parameter></methodparam>
</methodsynopsis>
<para>
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.
</para>
<para>
L'épaisseur et les styles ne sont pas supportés.
</para>
<para>
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.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&gd.image.description;
<varlistentry>
<term><parameter>enable</parameter></term>
<listitem>
<para>
Si l'on doit activer l'antialias ou non.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&gd.changelog.image-param;
<row>
<entry>7.2.0</entry>
<entry>
<function>imageantialias</function> 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.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Comparaison de 2 lignes, dont l'une est anti-aliasée</title>
<programlisting role="php">
<![CDATA[
<?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);
?>
]]>
</programlisting>
&example.outputs.similar;
<mediaobject>
<alt>Affichage de l'exemple : Une comparaison de 2 lignes, dont une avec un anti-aliasing</alt>
<imageobject>
<imagedata fileref="en/reference/image/figures/imageantialias.png"/>
</imageobject>
</mediaobject>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>imagecreatetruecolor</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->