From 0cac5f6eb954af835af91362b85b52cadc76cbc4 Mon Sep 17 00:00:00 2001
From: Kalle Sommer Nielsen <kalle@php.net>
Date: Wed, 20 Aug 2008 00:08:24 +0000
Subject: [PATCH] Added examples for gd documentation: * imagecolortransparent
 * imagefilledrectangle * Alternative to deprecated function imagedashedline

Also changed dashedline.png to imagedashedline.png so all figures are named image*


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@265143 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../image/figures/imagecolortransparent.png   | Bin 0 -> 140 bytes
 .../{dashedline.png => imagedashedline.png}   | Bin
 .../image/figures/imagefilledrectangle.png    | Bin 0 -> 125 bytes
 .../image/functions/imagecolortransparent.xml |  36 ++++++++++++++++-
 reference/image/functions/imagedashedline.xml |  38 +++++++++++++++++-
 .../image/functions/imagefilledrectangle.xml  |  32 ++++++++++++++-
 6 files changed, 102 insertions(+), 4 deletions(-)
 create mode 100644 reference/image/figures/imagecolortransparent.png
 rename reference/image/figures/{dashedline.png => imagedashedline.png} (100%)
 create mode 100644 reference/image/figures/imagefilledrectangle.png

diff --git a/reference/image/figures/imagecolortransparent.png b/reference/image/figures/imagecolortransparent.png
new file mode 100644
index 0000000000000000000000000000000000000000..40c97af346d375b8144c3be5ae5dfc25f1af0a93
GIT binary patch
literal 140
zcmeAS@N?(olHy`uVBq!ia0vp^=0GgR!2~4Pr3BvtDYlXzzhEE@1bNHYCju!)PZ!6K
ziaBr38FDcw@Ekbs>i_?o>wJ1n3tWq$x4C$HUL&>q^`m9;-frs_k1N{qq~heqNsm>J
id-qM3(YFK&O!+shCzMfVSry|QkfENgelF{r5}E*Q-!F>*

literal 0
HcmV?d00001

diff --git a/reference/image/figures/dashedline.png b/reference/image/figures/imagedashedline.png
similarity index 100%
rename from reference/image/figures/dashedline.png
rename to reference/image/figures/imagedashedline.png
diff --git a/reference/image/figures/imagefilledrectangle.png b/reference/image/figures/imagefilledrectangle.png
new file mode 100644
index 0000000000000000000000000000000000000000..bf8699420640fd403898bc7077bd78436741610d
GIT binary patch
literal 125
zcmeAS@N?(olHy`uVBq!ia0vp^=0GgR!2~4Pr3BvtDHl%{$B>FSZ_gQWF(~jHIB@O%
z|DAnYdVGytPqyWBPPjL@IwbV^an0hry~p~i<BIk?sW|y@(qq-*-hI<$^euq`Q~sGT
YYFIMsI0avb0h-6)>FVdQ&MBb@0CGkweE<Le

literal 0
HcmV?d00001

diff --git a/reference/image/functions/imagecolortransparent.xml b/reference/image/functions/imagecolortransparent.xml
index a62a139b33..41823dec8c 100644
--- a/reference/image/functions/imagecolortransparent.xml
+++ b/reference/image/functions/imagecolortransparent.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <refentry xml:id="function.imagecolortransparent" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>imagecolortransparent</refname>
@@ -40,6 +40,40 @@
    transparent color is returned.
   </para>
  </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>imagecolortransparent</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Create a 55x30 image
+$im = imagecreatetruecolor(55, 30);
+$red = imagecolorallocate($im, 255, 0, 0);
+$black = imagecolorallocate($im, 0, 0, 0);
+
+// Make the background transparent
+imagecolortransparent($im, $black);
+
+// Draw a red rectangle
+imagefilledrectangle($im, 4, 4, 50, 25, $red);
+
+// Save the image
+imagepng($im, './imagecolortransparent.png');
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <mediaobject>
+     <imageobject>
+      <imagedata fileref="figures/image.imagecolortransparent.png"/>
+     </imageobject>
+    </mediaobject>
+   </example>
+  </para>
+ </refsect1>
  <refsect1 role="notes">
   &reftitle.notes;
   <note>
diff --git a/reference/image/functions/imagedashedline.xml b/reference/image/functions/imagedashedline.xml
index 5d73eef29c..fafa0eab4e 100644
--- a/reference/image/functions/imagedashedline.xml
+++ b/reference/image/functions/imagedashedline.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry xml:id="function.imagedashedline" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>imagedashedline</refname>
@@ -101,10 +101,44 @@ imagedestroy($im);
     &example.outputs.similar;
     <mediaobject>
      <imageobject>
-      <imagedata fileref="figures/image.dashedline.png"/>
+      <imagedata fileref="figures/image.imagedashedline.png"/>
      </imageobject>
     </mediaobject>
    </example>
+   <example>
+    <title>Alternative to <function>imagedashedline</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Create a 100x100 image
+$im = imagecreatetruecolor(100, 100);
+$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
+
+// Define our style: First 4 pixels is white and the 
+// next 4 is transparent. This creates the dashed line effect
+$style = Array(
+		$white, 
+		$white, 
+		$white, 
+		$white, 
+		IMG_COLOR_TRANSPARENT, 
+		IMG_COLOR_TRANSPARENT, 
+		IMG_COLOR_TRANSPARENT, 
+		IMG_COLOR_TRANSPARENT
+		)
+
+imagesetstyle($im, $style);
+
+// Draw the dashed line
+imageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);
+
+// Save the image
+imagepng($im, './imageline.png');
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+   </example>
   </para>
  </refsect1>
  <refsect1 role="seealso">
diff --git a/reference/image/functions/imagefilledrectangle.xml b/reference/image/functions/imagefilledrectangle.xml
index 784c9e2501..9ed41479b3 100644
--- a/reference/image/functions/imagefilledrectangle.xml
+++ b/reference/image/functions/imagefilledrectangle.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry xml:id="function.imagefilledrectangle" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>imagefilledrectangle</refname>
@@ -77,6 +77,36 @@
    &return.success;
   </para>
  </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>imagefilledrectangle</function> usage</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Create a 55x30 image
+$im = imagecreatetruecolor(55, 30);
+$white = imagecolorallocate($im, 255, 255, 255);
+
+// Draw a white rectangle
+imagefilledrectangle($im, 4, 4, 50, 25, $white);
+
+// Save the image
+imagepng($im, './imagefilledrectangle.png');
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <mediaobject>
+     <imageobject>
+      <imagedata fileref="figures/image.imagefilledrectangle.png"/>
+     </imageobject>
+    </mediaobject>
+   </example>
+  </para>
+ </refsect1>
 </refentry>
 
 <!-- Keep this comment at the end of the file