didou Tue Jan 23 01:48:23 2007 UTC
Modified files:
/phpdoc/en/reference/image constants.xml
/phpdoc/en/reference/image/functions imagepng.xml
Log:
Fix #38794: Document the new filters parameter for imagepng()
Also add a note about filename usage
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/constants.xml?r1=1.6&r2=1.7&diff_format=u
Index: phpdoc/en/reference/image/constants.xml
diff -u phpdoc/en/reference/image/constants.xml:1.6
phpdoc/en/reference/image/constants.xml:1.7
--- phpdoc/en/reference/image/constants.xml:1.6 Tue Jul 22 19:29:09 2003
+++ phpdoc/en/reference/image/constants.xml Tue Jan 23 01:48:23 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
<section id="image.constants">
&reftitle.constants;
&extension.constants;
@@ -356,6 +356,83 @@
</simpara>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>
+ <constant>PNG_NO_FILTER</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>PNG_FILTER_NONE</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>PNG_FILTER_SUB</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>PNG_FILTER_UP</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>PNG_FILTER_AVG</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>PNG_FILTER_PAETH</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>PNG_ALL_FILTERS</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
</variablelist>
</section>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/image/functions/imagepng.xml?r1=1.10&r2=1.11&diff_format=u
Index: phpdoc/en/reference/image/functions/imagepng.xml
diff -u phpdoc/en/reference/image/functions/imagepng.xml:1.10
phpdoc/en/reference/image/functions/imagepng.xml:1.11
--- phpdoc/en/reference/image/functions/imagepng.xml:1.10 Thu Jan 18
19:52:51 2007
+++ phpdoc/en/reference/image/functions/imagepng.xml Tue Jan 23 01:48:23 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
<refentry id="function.imagepng">
<refnamediv>
<refname>imagepng</refname>
@@ -12,6 +12,7 @@
<methodparam><type>resource</type><parameter>image</parameter></methodparam>
<methodparam
choice="opt"><type>string</type><parameter>filename</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>quality</parameter></methodparam>
+ <methodparam
choice="opt"><type>int</type><parameter>filters</parameter></methodparam>
</methodsynopsis>
<para>
Outputs or saves a <acronym>PNG</acronym> image from the given
@@ -30,6 +31,12 @@
The path to the saved file. If not set or &null;, the raw image stream
will be outputed directly.
</para>
+ <note>
+ <para>
+ &null; is invalid if the <parameter>quality</parameter> and
+ <parameter>filters</parameter> arguments are not used.
+ </para>
+ </note>
</listitem>
</varlistentry>
<varlistentry>
@@ -40,6 +47,18 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><parameter>filters</parameter></term>
+ <listitem>
+ <para>
+ Allows reducing the PNG file size. It is a bitmask field which may be
+ set to any combination of the <literal>PNG_FILTER_XXX</literal>
+ constants. <constant>PNG_NO_FILTER</constant> or
+ <constant>PNG_ALL_FILTERS</constant> may also be used to respectively
+ disable or activate all filters.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</refsect1>
@@ -63,6 +82,12 @@
</thead>
<tbody>
<row>
+ <entry>5.1.3</entry>
+ <entry>
+ Added the <parameter>filters</parameter> parameter.
+ </entry>
+ </row>
+ <row>
<entry>5.1.2</entry>
<entry>
Added the <parameter>quality</parameter> parameter.
