php-doc-en/reference/image/setup.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<chapter xml:id="image.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;

 <!-- {{{ Requirements -->
 <section xml:id="image.requirements">
  &reftitle.required;
  <para>
   If you have the <acronym>GD</acronym> library (available at <link
   xlink:href="&url.gd;">&url.gd;</link>) you will also be able to create
   and manipulate images.
  </para>
  <para>
   The format of images you are able to manipulate depend on the
   version of <acronym>GD</acronym> you install, and any other libraries
   <acronym>GD</acronym> might need to access those image formats.
   Versions of <acronym>GD</acronym> older than gd-1.6
   support <acronym>GIF</acronym> format images, and do not support
   <acronym>PNG</acronym>, where versions greater than gd-1.6 and less than
   gd-2.0.28 support PNG, not GIF. <acronym>GIF</acronym>
   support was re-enabled in gd-2.0.28.
   <note>
    <simpara>
     Since PHP 4.3 there is a bundled version of the <acronym>GD</acronym>
     lib. This bundled version has some additional features like alpha
     blending, and should be used in preference to the external library
     since its codebase is better maintained and more stable.
    </simpara>
   </note>
  </para>
  <para>
   You may wish to enhance <acronym>GD</acronym> to handle more image formats.
   <table>
   <title>Supported image formats</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Image format</entry>
       <entry>Library to download</entry>
       <entry>Notes</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>gif</literal></entry>
       <entry></entry>
       <entry>
        Only supported in <acronym>GD</acronym> versions older than gd-1.6 and newer than
        gd-2.0.28. <emphasis>Read-only
        </emphasis> <acronym>GIF</acronym> support is available with PHP 4.3.0 and the bundled
        GD-library. <emphasis>Write</emphasis> support is available since
        PHP 4.3.9 and PHP 5.0.1.
       </entry>
      </row>
      <row>
       <entry><literal>jpeg</literal></entry>
       <entry><link xlink:href="&url.jpeg;">&url.jpeg;</link></entry>
       <entry>
        When building the jpeg library (prior to building PHP) you
        must use the <option role="configure">--enable-shared</option>
        option in the configure step.  If you do not, you will receive
        an error saying <literal>libjpeg.(a|so) not found</literal>
        when you get to the configure step of building PHP.
       </entry>
      </row>
      <row>
       <entry><literal>png</literal></entry>
       <entry><link xlink:href="&url.libpng;">&url.libpng;</link></entry>
       <entry>
        Only supported in <acronym>GD</acronym> versions greater than gd-1.6.
       </entry>
      </row>
      <row>
       <entry><literal>xpm</literal></entry>
       <entry><link xlink:href="&url.libxpm;">&url.libxpm;</link></entry>
       <entry>
        It's likely you have this library already available, if your system
        has an installed X-Environment.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <para>
   You may wish to enhance <acronym>GD</acronym> to deal with different fonts. The following
   font libraries are supported:
   <table>
   <title>Supported font libraries</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Font library</entry>
       <entry>Download</entry>
       <entry>Notes</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>FreeType 1.x</literal></entry>
       <entry><link xlink:href="&url.freetype;">&url.freetype;</link></entry>
       <entry>&removed.php.future;</entry>
      </row>
      <row>
       <entry><literal>FreeType 2</literal></entry>
       <entry><link xlink:href="&url.freetype;">&url.freetype;</link></entry>
       <entry></entry>
      </row>
      <row>
       <entry><literal>T1lib</literal></entry>
       <entry><link xlink:href="&url.t1lib;">&url.t1lib;</link>)</entry>
       <entry>
        Support for Postscript Type 1 fonts.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </section>
 <!-- }}} -->

 <!-- {{{ Installation -->
 &reference.image.configure;
 <!-- }}} -->

 <!-- {{{ Configuration -->
 &reference.image.ini;
 <!-- }}} -->

 <!-- {{{ Resources -->
 <section xml:id="image.resources">
  &reftitle.resources;
  <para>
   This extension defines two resource types: an image identifier and a font
   identifier.
  </para>
 </section>
 <!-- }}} -->

</chapter>

<!-- 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
-->