<!-- 

     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_newobject">
<refmeta>
<refentrytitle>panda_newobject</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>

<refnamediv>
<refname>panda_newobject</refname>
<refpurpose>create a new object</refpurpose>
</refnamediv>

<refsynopsisdiv>
<synopsis>
 #include&amp;lt;panda/constants.h&amp;gt;
 #include&amp;lt;panda/functions.h&amp;gt;
 panda_object *panda_newobject (panda_pdf *output, int type);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>DESCRIPTION</title>
<para>&lt;command&gt;PANDA INTERNAL&lt;/command&gt;. Create a new object within the PDF document output. The types of object are panda_object_normal and panda_object_placeholder -- the difference is that a placeholder object wont be written out when the PDF is dumped to disc. This is an internal function call and would only be need by API users if they are creating support for object types not currently supported by &lt;command&gt;Panda&lt;/command&gt;. If this is the case, then these users are encouraged to submit their code changes back to mikal@stillhq.com for inclusion with the next release of &lt;command&gt;Panda&lt;/command&gt;, and are reminded of their obligations under the GNU GPL.</para>
</refsect1>

<refsect1>
<title>RETURNS</title>
<para>A pointer to the new object (a panda_object *)</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 *document;
 panda_object *obj;
 panda_init();
 document = panda_open("filename.pdf", "w");
 obj = panda_newobject(document, panda_object_normal);
</programlisting>
</refsect1>

<refsect1>
<title>SEE ALSO</title>
<para>panda_freeobject, panda_writeobject, panda_traverseobjects, panda_addchild</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>
