---
name: "PS_add_bookmark"
section: "3"
platform: "linux"
package: "pslib-dev"
version: "0.4.8-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/PS_add_bookmark"
---

# PS\_add\_bookmark(3)

Add bookmark to current page

## NAME

PS\_add\_bookmark — Add bookmark to current page

## SYNOPSIS

\#include \<pslib.h\>

int PS\_add\_bookmark(PSDoc \*psdoc, const char \*text, int parent, int open)

## DESCRIPTION

Adds a bookmark for the current page. Bookmarks usually appear  in PDF-Viewers left of the page in a hierachical tree.  Clicking on a bookmark will jump to the given page.

The parameter **parent** is another bookmark  which is used as the parent of the new bookmark. If  **open** is unequal to zero the bookmark will  be shown open by the pdf viewer.

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.

The returned value is a reference for the bookmark. It is only  used if the bookmark shall be used as a parent.

## RETURN VALUE

Returns the identifier of the bookmark or zero in case of an error.  The identifier is a positiv number.

## SEE ALSO

[PS\_add\_launchlink(3)](/PS_add_launchlink/3.md), [PS\_add\_pdflink(3)](/PS_add_pdflink/3.md), [PS\_add\_weblink(3)](/PS_add_weblink/3.md)

## AUTHOR

This manual page was written by Uwe Steinmann uwe@steinmann.cx.