Index

  1. \setasign\SetaPDF2
    1. Core
      1. Document
      2. Document
        1. Catalog
        2. Catalog
          1. AcroForm
          2. AdditionalActions
          3. Dests
          4. Extensions
          5. MarkInfo
          6. Names
          7. Names
          8. OptionalContent
          9. Outlines
          10. OutputIntents
          11. PageLabels
          12. Pages
          13. Permissions
          14. StructTreeRoot
          15. ViewerPreferences

setasign\SetaPDF2\Core\Document

Catalog A class representing the document catalog

File: /SetaPDF v2/Core/Document/Catalog.php
Old class name (alias): \SetaPDF_Core_Document_Catalog

Class hierarchy

Summary

Static Methods

Methods

Properties

Properties

$_acroForm

protected \SetaPDF_Core_Document_Catalog_AcroForm Catalog::$_acroForm

The documents AcroForm object

$_additionalActions

protected \SetaPDF_Core_Document_Catalog_AdditionalActions Catalog::$_additionalActions

The additional actions object

$_dests

protected \SetaPDF_Core_Document_Catalog_Dests Catalog::$_dests

The destinations object of the catalog

$_document

protected \SetaPDF_Core_Document Catalog::$_document

The document instance

$_extensions

protected \SetaPDF_Core_Document_Catalog_Extensions Catalog::$_extensions

The extensions object

$_markInfo

protected \SetaPDF_Core_Document_Catalog_MarkInfo Catalog::$_markInfo

The mark information object

$_names

protected \SetaPDF_Core_Document_Catalog_Names Catalog::$_names

Names instance

$_optionalContent

protected \SetaPDF_Core_Document_Catalog_OptionalContent Catalog::$_optionalContent

The optional content object

$_outlines

protected \SetaPDF_Core_Document_Catalog_Outlines Catalog::$_outlines

The documents outlines object

$_outputIntents

protected \SetaPDF_Core_Document_Catalog_OutputIntents Catalog::$_outputIntents

The output intent object

$_pageLabels

protected \SetaPDF_Core_Document_Catalog_PageLabels Catalog::$_pageLabels

The documents page labels object

$_pages

protected \SetaPDF_Core_Document_Catalog_Pages Catalog::$_pages

Pages instance

$_permissions

protected \SetaPDF_Core_Document_Catalog_Permissions Catalog::$_permissions

The permissions object

$_structTreeRoot

protected \SetaPDF_Core_Document_Catalog_StructTreeRoot Catalog::$_structTreeRoot

The root structure tree object

$_viewerPreferences

protected \SetaPDF_Core_Document_Catalog_ViewerPreferences Catalog::$_viewerPreferences

The viewer preferences object


Static Methods

getDocumentMagicMethods()

public static Catalog::getDocumentMagicMethods (
void
): array

Returns method names which should be available in a documents instance too.


Methods

__construct()

public Catalog::__construct ()

The constructor.

Parameters
$document : \SetaPDF_Core_Document
 

cleanUp()

public Catalog::cleanUp (
void
): void

Release cycled references / memory.

getAcroForm()

public Catalog::getAcroForm (
void
): \SetaPDF_Core_Document_Catalog_AcroForm

Get the documents AcroForm object.

This method resolves or creates the AcroForm dictionary and returns it.

getAdditionalActions()

public Catalog::getAdditionalActions (
void
): \SetaPDF_Core_Document_Catalog_AdditionalActions

Get the additional actions object.

getBaseUri()

public Catalog::getBaseUri (
void
): ?string

Get the base URI that shall be used in resolving relative URI references.

URI actions within the document may specify URIs in partial form, to be interpreted relative to this base address. If no base URI is specified, such partial URIs shall be interpreted relative to the location of the document itself.

Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

getDests()

public Catalog::getDests (
void
): \SetaPDF_Core_Document_Catalog_Dests

Get the documents destination dictionary helper object.

getDictionary()

public Catalog::getDictionary (
bool $create = false
): ?\SetaPDF_Core_Type_Dictionary

Get the catalog dictionary.

Parameters
$create : bool
 
Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

getDocument()

public Catalog::getDocument (
void
): \SetaPDF_Core_Document

Get the document instance.

getExtensions()

public Catalog::getExtensions (
void
): \SetaPDF_Core_Document_Catalog_Extensions

Get the extensions helper instance.

getLang()

public Catalog::getLang (
string $encoding = 'UTF-8'
): ?string

Get the language identifier.

Parameters
$encoding : string
 
Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

getMarkInfo()

public Catalog::getMarkInfo (
void
): \SetaPDF_Core_Document_Catalog_MarkInfo

Get the mark information object.

getMetadata()

public Catalog::getMetadata (
void
): ?string

Get the metadata stream.

This is a method for low level access to the XMP stream data. The Info class offers a same named method, that allows you to access the XMP package via a \DOMDocument instance.

The class also allows you to automatically sync Info dictionary data with the XMP metadata.

Return Values

Null if no document metadata are available.
A string if the desired structure is available.

Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

getNames()

public Catalog::getNames (
void
): \SetaPDF_Core_Document_Catalog_Names

Get a names object from the document.

getOpenAction()

public Catalog::getOpenAction (
void
): null|\SetaPDF_Core_Document_Action|\SetaPDF_Core_Document_Destination

Get the open action.

The open action entry specifies a destination that shall be displayed or an action that shall be executed when the document is opened.

Additional document related actions could be get or set in the Catalog\AdditionalActions class that could be get with the getAdditionalActions() method.

Return Values

An action or destination instance or null if no open action is defined.

Exceptions

Throws \setasign\SetaPDF2\Core\Exception

getOptionalContent()

public Catalog::getOptionalContent (
void
): \SetaPDF_Core_Document_Catalog_OptionalContent

Get the documents optional content object.

getOutlines()

public Catalog::getOutlines (
void
): \SetaPDF_Core_Document_Catalog_Outlines

Get the documents outline object.

getOutputIntents()

public Catalog::getOutputIntents (
void
): \SetaPDF_Core_Document_Catalog_OutputIntents

Get the output intents object.

getPageLabels()

public Catalog::getPageLabels (
void
): \SetaPDF_Core_Document_Catalog_PageLabels

Get the documents page labels object.

getPageLayout()

public Catalog::getPageLayout (
void
): string

Get the page layout.

Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

See
  • PDF 32000-1:2008 - 7.7.2 Document Catalog

getPageMode()

public Catalog::getPageMode (
void
): string

Get the page mode.

Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

See
  • PDF 32000-1:2008 - 7.7.2 Document Catalog

getPages()

public Catalog::getPages (
void
): \SetaPDF_Core_Document_Catalog_Pages

Get a pages object from the document.

getPermissions()

public Catalog::getPermissions (
void
): \SetaPDF_Core_Document_Catalog_Permissions

Get the permission object.

getStructTreeRoot()

public Catalog::getStructTreeRoot (
void
): \SetaPDF_Core_Document_Catalog_StructTreeRoot

Get the documents structure tree root object.

getVersion()

public Catalog::getVersion (
void
): ?string

Get the value of the Version entry of the catalog dictionary.

This value defines the version of the PDF specification to which the document conforms if later than the version specified in the file's header.

Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

getViewerPreferences()

public Catalog::getViewerPreferences (
void
): \SetaPDF_Core_Document_Catalog_ViewerPreferences

Get a viewer preferences object.

setBaseUri()

public Catalog::setBaseUri (
?string $uri
): void

Set the base URI.

Parameters
$uri : ?string
 
Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

See

setLang()

public Catalog::setLang (
string $lang,
string $encoding = 'UTF-8'
): void

Set the language identifier.

Parameters
$lang : string
 
$encoding : string
 
Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

setMetadata()

public Catalog::setMetadata (
string $metadata
): void

Set the metadata stream.

To remove the metadata just pass null to this method.

Parameters
$metadata : string
 
Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

setOpenAction()

public Catalog::setOpenAction (): void

Set the open action.

The open action entry specifies a destination that shall be displayed or an action that shall be executed when the document is opened.

Additional document related actions could be get or set in the Catalog\AdditionalActions class that could be get with the getAdditionalActions() method.

Parameters
$openAction : \SetaPDF_Core_Document_Destination|\SetaPDF_Core_Document_Action|null
 
Exceptions

Throws \InvalidArgumentException

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

setPageLayout()

public Catalog::setPageLayout (
?string $pageLayout
): void

Set the page layout.

Possible values are declared as class constants in the PageLayout class.

Parameters
$pageLayout : ?string

The name of the page layout

Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

See

setPageMode()

public Catalog::setPageMode (
?string $pageMode
): void

Set the page mode.

Possible values are declared as class constants in the PageMode class.

Parameters
$pageMode : ?string

The name of the page mode

Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception

See

setVersion()

public Catalog::setVersion (
?string $version
): void

Set the version of the PDF specification to which the document conforms.

Parameters
$version : ?string
 
Exceptions

Throws \setasign\SetaPDF2\Core\SecHandler\Exception

Throws \setasign\SetaPDF2\Core\Type\Exception


© 2025 Setasign GmbH & Co. KG · Contact / Imprint · Data Privacy Statement (German)