PDFPAGE(3)

NAME
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 document that you pass to it and returns a pointer to the page to you. Many pages may simultaneously be open in this manner, 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 following 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.

VERSION
This information relates to version 0.2 of Panda