1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 330340 $ -->
<book xml:id="book.image" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundled" ?>
<title>Image Processing and GD</title>
<titleabbrev>GD</titleabbrev>
<!-- {{{ preface -->
<preface xml:id="intro.image">
&reftitle.intro;
<para>
PHP is not limited to creating just HTML output. It can also be
used to create and manipulate image files in a variety of different
image formats, including <acronym>GIF</acronym>, <acronym>PNG</acronym>,
<acronym>JPEG</acronym>, <acronym>WBMP</acronym>, and <acronym>XPM</acronym>.
Even more convenient, PHP can output image streams directly to a browser. You
will need to compile PHP with the <acronym>GD</acronym> library of image
functions for this to work. <acronym>GD</acronym> and PHP may also require
other libraries, depending on which image formats you want to work with.
</para>
<para>
You can use the image functions in PHP to get the size of
<acronym>JPEG</acronym>, <acronym>GIF</acronym>,
<acronym>PNG</acronym>, <acronym>SWF</acronym>,
<acronym>TIFF</acronym> and <acronym>JPEG2000</acronym> images.
</para>
<para>
With the <link linkend="ref.exif">exif extension</link>, you are able
to work with information stored in headers of
<acronym>JPEG</acronym> and <acronym>TIFF</acronym> images. This way you can
read meta data generated by digital cameras. The exif
functions do not require the <acronym>GD</acronym> library.
</para>
<para>
<note>
<simpara>
Read the requirements section about how to expand image capabilities
to read, write and modify images. To read meta data of pictures
taken by digital cameras you need the above mentioned
<link linkend="ref.exif">exif extension</link>.
</simpara>
</note>
<note>
<simpara>
The <function>getimagesize</function> function does not require the GD extension.
</simpara>
</note>
</para>
<para>
GD supports a varity of formats, below is a list of formats supported by GD and notes
to their availability including read/write support.
</para>
<para>
<table>
<title>Formats supported by GD</title>
<tgroup cols="4">
<thead>
<row>
<entry>Format</entry>
<entry>Read support</entry>
<entry>Write support</entry>
<entry>Notes</entry>
</row>
</thead>
<tbody>
<row>
<entry>JPEG</entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>GD 1.8+</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>Not available between GD 1.6 and GD 2.0.28</entry>
</row>
<row>
<entry>XBM</entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>Read support as of PHP 4.0.1 and write support as of PHP 5.0.0</entry>
</row>
<row>
<entry>XPM</entry>
<entry>&true;</entry>
<entry>&false;</entry>
<entry>Read support as of PHP 4.0.1, not available on Windows. Requires bundled version of GD</entry>
</row>
<row>
<entry>WBMP</entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>GD 1.8+</entry>
</row>
<row>
<entry>WebP</entry>
<entry>&true;</entry>
<entry>&true;</entry>
<entry>GD 2.1+, PHP 5.5+</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
Despite most formats being available for both reading and writing in the above table, doesn't
mean that PHP was compiled with support for them. To find out which formats that was available
to GD during compilation, use the <function>gd_info</function> function, for more information
about compiling support for one or more formats, see the installation chapter.
</para>
</preface>
<!-- }}} -->
&reference.image.setup;
&reference.image.constants;
&reference.image.examples;
&reference.image.reference;
</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
-->
|
