<!-- 

     This document is part of the panda distribution, and is covered
     by the GNU GPL, a copy of which is in the file named COPYING inside the
     distribution.

     This program and it's documentation are distributed in the hope that 
     they will be useful,but WITHOUT ANY WARRANTY; without even the implied 
     warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.
-->

<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">

<refentry id="panda_imageboxrot">
<refmeta>
<refentrytitle>panda_imageboxrot</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>

<refnamediv>
<refname>panda_imageboxrot</refname>
<refpurpose>insert an image into the PDF document at the specified location</refpurpose>
</refnamediv>

<refsynopsisdiv>
<synopsis>
 #include&amp;lt;panda/constants.h&amp;gt;
 #include&amp;lt;panda/functions.h&amp;gt;
 void panda_panda_imageboxrot (panda_pdf * output, panda_page * target, int top, int left, int bottom, int right, double angle, char *filename, int type);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>DESCRIPTION</title>
<para>This function call inserts an image into the PDF document at the specified location, including the ability to rotate the image on the page. It should be noted that xpdf will sometimes make the rotated image look quite sickly. This is in fact a bug in xpdf (which has beenr eported), and not a bug in &lt;command&gt;Panda&lt;/command&gt;. The image types accepted by this call are: panda_image_tiff, panda_image_jpeg and panda_image_png.</para>
</refsect1>

<refsect1>
<title>RETURNS</title>
<para>Nothing</para>
</refsect1>

<refsect1>
<title>EXAMPLE</title>
<programlisting>
 #include&amp;lt;panda/constants.h&amp;gt;
 #include&amp;lt;panda/functions.h&amp;gt;
 panda_pdf *demo;
 panda_page *currPage;
 panda_init ();
 if ((demo = panda_open ("output.pdf", "w")) == NULL)
 panda_error (panda_true, "demo: could not open output.pdf to write to.");
 currPage = panda_newpage (demo, panda_pagesize_a4);
  
 panda_imagebox (demo, currPage, 0, 0, currPage-&gt;height / 2,
 currPage-&gt;width, 45.0, "input.tif", panda_image_tiff);
</programlisting>
</refsect1>

<refsect1>
<title>SEE ALSO</title>
<para>panda_imagebox</para>
</refsect1>


<refsect1>
    <title>VERSION</title>
    <para>
This documentation was generated for <command>Panda</command> 0.5.2 by <command>autodocbook</command> (http://www.stillhq.com).
    </para>
</refsect1>

<refsect1>
    <title>AUTHOR</title>
    <para>
<command>Panda</command> is under development by Michael Still (mikal@stillhq.com). All code is Copyright Michael Still 2000 - 2003,  and is released under the GNU GPL. Code submissions are welcomed. Contact Michael at the address above if you have something you would like to contribute.
</para>
</refsect1>

<refsect1>
    <title>BUGS</title>
    <para>
There  are no known bugs in <command>Panda</command>. If you find one, please contact mikal@stillhq.com and let me know.
</para>
</refsect1>
</refentry>
