Files
doc-fr/reference/image/functions/imagetruecolortopalette.xml
T
2021-05-31 18:42:02 +01:00

128 lines
3.5 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.imagetruecolortopalette" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>imagetruecolortopalette</refname>
<refpurpose>Convertit une image en couleurs vraies en image à palette</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>imagetruecolortopalette</methodname>
<methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
<methodparam><type>bool</type><parameter>dither</parameter></methodparam>
<methodparam><type>int</type><parameter>num_colors</parameter></methodparam>
</methodsynopsis>
<para>
<function>imagetruecolortopalette</function> convertit l'image
en vraies couleurs <parameter>image</parameter> en image à palette.
Le code de cette fonction est directement tiré de la bibliothèque du
<literal>Independent JPEG Group</literal>, qui est tout simplement génial.
Le code a été modifié pour préserver l'essentiel du canal alpha dans la nouvelle
palette, en plus de conserver les couleurs du mieux possible. Mais
cela ne fonctionne pas toujours comme voulu. Il est alors préférable
de générer un résultat en vraies couleurs, ce qui donne toujours le
meilleur rendu.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&gd.image.description;
<varlistentry>
<term><parameter>dither</parameter></term>
<listitem>
<para>
Indique si l'image doit être granuleuse - si défini à &true;,
alors l'image sera un peu plus granuleuse mais l'approximation
des couleurs sera meilleure.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>num_colors</parameter></term>
<listitem>
<para>
Le nombre maximal de couleurs dans la palette finale.
</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;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Convertion d'une image truecolor en une palette</title>
<programlisting role="php">
<![CDATA[
<?php
// Création d'une image truecolor
$im = imagecreatetruecolor(100, 100);
// Conversion en palette de 255 couleurs
imagetruecolortopalette($im, false, 255);
// Sauvegarde de l'image
imagepng($im, './paletteimage.png');
imagedestroy($im);
?>
]]>
</programlisting>
</example>
</para>
</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
-->