book.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 213fbd9440a224f9c1da4942c85124ce0c120c52 Maintainer: yuanyuqiang Status: ready -->
<!-- CREDITS: Luffy, mowangjuanzi -->
<book xml:id="book.image" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="bundled" ?>
 <title>图像处理和 GD</title>
 <titleabbrev>GD</titleabbrev>
 
 <!-- {{{ preface -->
 <preface xml:id="intro.image">
  &reftitle.intro;
  <para>
   PHP 并不仅限于创建 HTML 输出，
   它也可以创建和处理包括 <acronym>GIF</acronym>， <acronym>PNG</acronym>，
   <acronym>JPEG</acronym>， <acronym>WBMP</acronym> 以及 <acronym>XPM</acronym>
   在内的多种格式的图像。
   更加方便的是，PHP 可以直接将图像数据流输出到浏览器。
   要想在 PHP 中使用图像处理功能，你需要连带 <acronym>GD</acronym> 库一起来编译 PHP。
   <acronym>GD</acronym> 库和 PHP 可能需要其他的库，
   这取决于你要处理的图像格式。
  </para>
  <para>
   你可以使用 PHP 中的图像函数来获取下列格式图像的大小：
   <acronym>JPEG</acronym>， <acronym>GIF</acronym>，
   <acronym>PNG</acronym>， <acronym>SWF</acronym>，
   <acronym>TIFF</acronym> 和 <acronym>JPEG2000</acronym>。
  </para>
  <para>
   如果联合 <link linkend="ref.exif">exif 扩展</link> 一起使用，
   你可以操作存储在 <acronym>JPEG</acronym> 和 <acronym>TIFF</acronym> 
   图像文件头部的信息，
   这样就就可以获取数码相机所产生的元数据。
   exif 相关的函数不需要 <acronym>GD</acronym> 库亦可使用。
  </para>
  
  <para>
   <note>
    <simpara>
     关于如何扩展图像处理能力，例如读取、写入以及修改，
     请参考“需求”一节。
     要想读取数码相机拍摄的图片的元数据，
     你需要上面提到的 <link linkend="ref.exif">exif 扩展</link>。
    </simpara>
   </note>
   <note>
    <simpara>
      <function>getimagesize</function> 函数不需要 GD 扩展库。
    </simpara>
   </note>
   <caution>
    <simpara>
     由于绑定的 GD 库使用 Zend 内存管理机制来分配内存，
     所以所使用的内存大小不受  <link linkend="ini.memory-limit">memory_limit</link>
     配置参数限制。
    </simpara>
   </caution>
  </para>

  <para>
   GD 库支持多种图像格式，
   下标所列的是 GD 所支持的格式，请注意备图像格式对应的读取/写入支持的可用性。
  </para>
  <para>
   <table>
    <title>GD 所支持的格式</title>
    <tgroup cols="4">
     <thead>
      <row>
       <entry>格式</entry>
       <entry>支持读取</entry>
       <entry>支持写入</entry>
       <entry>备注</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>JPEG</entry>
       <entry>&true;</entry>
       <entry>&true;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>PNG</entry>
       <entry>&true;</entry>
       <entry>&true;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>GIF</entry>
       <entry>&true;</entry>
       <entry>&true;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>XBM</entry>
       <entry>&true;</entry>
       <entry>&true;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>XPM</entry>
       <entry>&true;</entry>
       <entry>&false;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>WBMP</entry>
       <entry>&true;</entry>
       <entry>&true;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>WebP</entry>
       <entry>&true;</entry>
       <entry>&true;</entry>
       <entry></entry>
      </row>
      <row>
       <entry>BMP</entry>
       <entry>&true;</entry>
       <entry>&true;</entry>
       <entry>从 PHP 7.2.0 开始支持</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para>
   很遗憾的是，虽然上表中显示大部分图像格式都是支持读取和写入的，
   但是不代表你的 PHP 环境在编译的时候是支持这些操作的。
   要想检测 GD 库所支持的格式，请使用 <function>gd_info</function> 函数，
   更多信息请参考 “安装” 一章。
  </para>
 </preface>

 <!-- }}} -->
 
 &reference.image.setup;
 &reference.image.constants;
 &reference.image.examples;
 &reference.image.reference;
 &reference.image.gdimage;
 &reference.image.gdfont;

</book>

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