<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>Requirements</title> </head> <body><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="image.setup.html">Installing/Configuring</a></div> <div class="next" style="text-align: right; float: right;"><a href="image.installation.html">Installation</a></div> <div class="up"><a href="image.setup.html">Installing/Configuring</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div><hr /><div id="image.requirements" class="section"> <h2 class="title">Requirements</h2> <p class="para"> If you have the <acronym title="Graphics Draw">GD</acronym> library (available at <a href="http://www.libgd.org/" class="link external">» http://www.libgd.org/</a>) you will also be able to create and manipulate images. </p> <p class="para"> The format of images you are able to manipulate depend on the version of <acronym title="Graphics Draw">GD</acronym> you install, and any other libraries <acronym title="Graphics Draw">GD</acronym> might need to access those image formats. Versions of <acronym title="Graphics Draw">GD</acronym> older than gd-1.6 support <acronym title="Graphic Interchange Format">GIF</acronym> format images, and do not support <acronym title="Portable Network Graphics">PNG</acronym>, where versions greater than gd-1.6 and less than gd-2.0.28 support PNG, not GIF. <acronym title="Graphic Interchange Format">GIF</acronym> support was re-enabled in gd-2.0.28. <blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara"> Since PHP 4.3 there is a bundled version of the <acronym title="Graphics Draw">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. </span> </p></blockquote> </p> <p class="para"> You may wish to enhance <acronym title="Graphics Draw">GD</acronym> to handle more image formats. <table class="doctable table"> <caption><strong>Supported image formats</strong></caption> <thead> <tr> <th>Image format</th> <th>Library to download</th> <th>Notes</th> </tr> </thead> <tbody class="tbody"> <tr> <td><em>gif</em></td> <td class="empty"> </td> <td> Only supported in <acronym title="Graphics Draw">GD</acronym> versions older than gd-1.6 and newer than gd-2.0.28. <em class="emphasis">Read-only </em> <acronym title="Graphic Interchange Format">GIF</acronym> support is available with PHP 4.3.0 and the bundled GD-library. <em class="emphasis">Write</em> support is available since PHP 4.3.9 and PHP 5.0.1. </td> </tr> <tr> <td><em>jpeg</em></td> <td><a href="http://www.ijg.org/" class="link external">» http://www.ijg.org/</a></td> <td> When building the jpeg library (prior to building PHP) you must use the <strong class="option configure">--enable-shared</strong> option in the configure step. If you do not, you will receive an error saying <em>libjpeg.(a|so) not found</em> when you get to the configure step of building PHP. </td> </tr> <tr> <td><em>png</em></td> <td><a href="http://www.libpng.org/pub/png/libpng.html" class="link external">» http://www.libpng.org/pub/png/libpng.html</a></td> <td> Only supported in <acronym title="Graphics Draw">GD</acronym> versions greater than gd-1.6. </td> </tr> <tr> <td><em>xpm</em></td> <td><a href="ftp://metalab.unc.edu/pub/Linux/libs/X/!INDEX.html" class="link external">» ftp://metalab.unc.edu/pub/Linux/libs/X/!INDEX.html</a></td> <td> It's likely you have this library already available, if your system has an installed X-Environment. </td> </tr> </tbody> </table> </p> <p class="para"> You may wish to enhance <acronym title="Graphics Draw">GD</acronym> to deal with different fonts. The following font libraries are supported: <table class="doctable table"> <caption><strong>Supported font libraries</strong></caption> <thead> <tr> <th>Font library</th> <th>Download</th> <th>Notes</th> </tr> </thead> <tbody class="tbody"> <tr> <td><em>FreeType 1.x</em></td> <td><a href="http://www.freetype.org/" class="link external">» http://www.freetype.org/</a></td> <td>This deprecated feature <em class="emphasis">will</em> certainly be <em class="emphasis">removed</em> in the future.</td> </tr> <tr> <td><em>FreeType 2</em></td> <td><a href="http://www.freetype.org/" class="link external">» http://www.freetype.org/</a></td> <td class="empty"> </td> </tr> <tr> <td><em>T1lib</em></td> <td><a href="ftp://sunsite.unc.edu/pub/Linux/libs/graphics/" class="link external">» ftp://sunsite.unc.edu/pub/Linux/libs/graphics/</a>)</td> <td> Support for Postscript Type 1 fonts. </td> </tr> </tbody> </table> </p> </div><hr /><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="image.setup.html">Installing/Configuring</a></div> <div class="next" style="text-align: right; float: right;"><a href="image.installation.html">Installation</a></div> <div class="up"><a href="image.setup.html">Installing/Configuring</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div></body></html>