./pdfpage

       pdfpage

SYNOPSIS

       #include <panda/constants.h> #include <panda/functions.h>

       page *pdfpage(pdf *document, char *pageSize);

DESCRIPTION

       The  function  pdfpage creates a new page in the PDF docu-
       ment that you pass to it and returns a pointer to the page
       to you. Many pages may simultaneously be open in this man-
       ner, and there is no proceedure for 'closing'  a  page  --
       this  is  done  automatically when the document is closed.
       Once you are finished with the page you  may  discard  the
       pointer you have been given, but do not call free() on the
       pointer or the library will break.

       The page size string is a description of the size  of  the
       page  that you would like inserted into the document. This
       may be any arbitary size that you desire, with the follow-
       ing forwat being used: "0 0 <width> <height>". Size of the
       pages is measured in points, of which there are 72  in  an
       inch.  For  your  convenience,  standard  page  sizes  are
       defined in the header file panda/constants.h -- there  are
       gPageSizeA4 and gPageSizeUsLetter.

EXAMPLE

       Simply use:
              #include <panda/constants.h>
              #include <panda/functions.h>

              pdf  *demo;
              page *first;

              demo = pdfopen("output.pdf", "w");
              first = pdfpage(demo, gPageSizeA4);

RETURNS

       pdfpage  returns  a pointer to the page created. If a page
       cannot be created, the error routine is called.

AUTHOR

       Panda   is   under   development    by    Michael    Still
       (mikal@stillhq.com).  All  code is Copyright Michael Still
       2000, and is released under the GPL. Code submissions  are
       welcomed. Contact Michael at the address above if you have
       something you would like to contribute.

BUGS

       There are no known bugs in Panda. If you find one,  please
       contact mikal@stillhq.com and let me know.
       This information relates to version 0.2 of Panda