Adds a bookmark for the current page. Bookmarks usually appear in
PDF-Viewers left of the page in a hierarchical tree. Clicking on a
bookmark will jump to the given page.
The bookmark has no meaning if the document is printed or viewed, but it
will be used if the document is converted to pdf by either
Acrobat Distiller™ or Ghostview.
Parameters
- psdoc
Resource identifier of the postscript file
as returned by ps_new().
- text
The text used for displaying the bookmark.
- parent
A bookmark previously created by this function which
is used as the parent of the new bookmark.
- open
If open is unequal to zero the bookmark will
be shown open by the pdf viewer.
Return Values
The returned value is a reference for the bookmark. It is only used if
the bookmark shall be used as a parent. The value is greater zero if
the function succeeds. In case of an error zero will
be returned.