aidan Mon Oct 4 05:45:47 2004 EDT
Modified files:
/phpdoc/en/reference/image/functions imagecopyresized.xml
Log:
Added examples
http://cvs.php.net/diff.php/phpdoc/en/reference/image/functions/imagecopyresized.xml?r1=1.3&r2=1.4&ty=u
Index: phpdoc/en/reference/image/functions/imagecopyresized.xml
diff -u phpdoc/en/reference/image/functions/imagecopyresized.xml:1.3
phpdoc/en/reference/image/functions/imagecopyresized.xml:1.4
--- phpdoc/en/reference/image/functions/imagecopyresized.xml:1.3 Sat Jan 18
22:09:48 2003
+++ phpdoc/en/reference/image/functions/imagecopyresized.xml Mon Oct 4 05:45:45
2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/image.xml, last change in rev 1.36 -->
<refentry id="function.imagecopyresized">
<refnamediv>
@@ -8,30 +8,30 @@
</refnamediv>
<refsect1>
<title>Description</title>
- <methodsynopsis>
- <type>int</type><methodname>imagecopyresized</methodname>
- <methodparam><type>resource</type><parameter>dst_im</parameter></methodparam>
- <methodparam><type>resource</type><parameter>src_im</parameter></methodparam>
- <methodparam><type>int</type><parameter>dstX</parameter></methodparam>
- <methodparam><type>int</type><parameter>dstY</parameter></methodparam>
- <methodparam><type>int</type><parameter>srcX</parameter></methodparam>
- <methodparam><type>int</type><parameter>srcY</parameter></methodparam>
- <methodparam><type>int</type><parameter>dstW</parameter></methodparam>
- <methodparam><type>int</type><parameter>dstH</parameter></methodparam>
- <methodparam><type>int</type><parameter>srcW</parameter></methodparam>
- <methodparam><type>int</type><parameter>srcH</parameter></methodparam>
- </methodsynopsis>
+ <methodsynopsis>
+ <type>int</type><methodname>imagecopyresized</methodname>
+ <methodparam><type>resource</type><parameter>dst_image</parameter></methodparam>
+ <methodparam><type>resource</type><parameter>src_image</parameter></methodparam>
+ <methodparam><type>int</type><parameter>dst_x</parameter></methodparam>
+ <methodparam><type>int</type><parameter>dst_y</parameter></methodparam>
+ <methodparam><type>int</type><parameter>src_x</parameter></methodparam>
+ <methodparam><type>int</type><parameter>src_y</parameter></methodparam>
+ <methodparam><type>int</type><parameter>dst_w</parameter></methodparam>
+ <methodparam><type>int</type><parameter>dst_h</parameter></methodparam>
+ <methodparam><type>int</type><parameter>src_w</parameter></methodparam>
+ <methodparam><type>int</type><parameter>src_h</parameter></methodparam>
+ </methodsynopsis>
<para>
<function>imagecopyresized</function> copies a rectangular
portion of one image to another image.
- <parameter>Dst_im</parameter> is the destination image,
- <parameter>src_im</parameter> is the source image identifier. If
- the source and destination coordinates and width and heights
+ <parameter>dst_image</parameter> is the destination image,
+ <parameter>src_image</parameter> is the source image identifier.
+ If the source and destination coordinates and width and heights
differ, appropriate stretching or shrinking of the image fragment
- will be performed. The coordinates refer to the upper left
- corner. This function can be used to copy regions within the
- same image (if <parameter>dst_im</parameter> is the same as
- <parameter>src_im</parameter>) but if the regions overlap the
+ will be performed. The coordinates refer to the upper left
+ corner. This function can be used to copy regions within the
+ same image (if <parameter>dst_image</parameter> is the same as
+ <parameter>src_image</parameter>) but if the regions overlap the
results will be unpredictable.
</para>
<note>
@@ -47,8 +47,55 @@
<function>imagecreatetruecolor</function>.
</para>
</note>
+ </refsect1>
+
+ <refsect1>
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>Resizing an image</title>
+ <para>
+ This example will display the image at half size.
+ </para>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// File and new size
+$filename = 'test.jpg';
+$percent = 0.5;
+
+// Content type
+header('Content-type: image/jpeg');
+
+// Get new sizes
+list($width, $height) = getimagesize($filename);
+$newwidth = $width * $percent;
+$newheight = $height * $percent;
+
+// Load
+$thumb = imagecreate($newwidth, $newheight);
+$source = imagecreatefromjpeg($filename);
+
+// Resize
+imagecopyresized($thumb, $source, 0, 0, 0, 0, $newwidth, $newheight, $width, $height);
+
+// Output
+imagejpeg($thumb);
+?>
+]]>
+ </programlisting>
+ <para>
+ The image will be output at half size, though better
+ quality could be obtained using <function>imagecopyresampled</function>.
+ </para>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1>
+ &reftitle.seealso;
<para>
- See also <function>imagecopyresampled</function>.
+ <function>imagecopyresampled</function>
</para>
</refsect1>
</refentry>
