com.icesoft.pdf.pobjects
Class Catalog

java.lang.Object
  com.icesoft.pdf.pobjects.Dictionary
      com.icesoft.pdf.pobjects.Catalog

public class Catalog

extends Dictionary

The Catalog object represents the root of a PDF document's object heirarchy. The Catalog is located by means of the Root entry in the trailer of the PDF file. The catalog contains references to other objects defining the document's contents, outline, names, destinations, and other attributes.

The Catalog class can be accessed from the Document class for convenience, but can also be accessed via the PTrailer class. Useful information about the document can be extracted from the Catalog Dictionary, such as PDF version information and Viewer Preferences. All Catalog dictionary properties can be accesed via the getEntries method. See section 3.6.1 of the PDF Reference version 1.6 for more information on the properties available in the Catalog Object.

Since:

1.0

Field Summary

static String

VERSION The version number of ICEpdf rendering core.

Fields inherited from class com.icesoft.pdf.pobjects.Dictionary

entries, inited, library

Constructor Summary

Catalog(Library l, Hashtable h)
Creates a new instance of a Catalog.

Method Summary

void	dispose(boolean cache) Dispose the Catalog.
Dictionary	getDestinations() Gets a dictionary of names and corresponding destinations.
NameTree	getNameTree() Gets the document's Names dictionary.
Outlines	getOutlines() Gets the Outlines Dictionary that is the root of the document's outline hierarchy.
PageTree	getPageTree() Gets PageTree node that is the root of the document's page tree.
void	init() Initiate the PageTree.
String	toString() Returns a summary of the Catalog dictionary values.

Methods inherited from class com.icesoft.pdf.pobjects.Dictionary

getEntries, getFloat, getInt, getLibrary, getNumber, getObject, getPObjectReference, setPObjectReference

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

VERSION

public static final String VERSION

The version number of ICEpdf rendering core. This is not the version number of the PDF format used to encode this document.

See Also:

Constant Field Values

Constructor Detail

Catalog

public Catalog(Library l,
               Hashtable h)

Creates a new instance of a Catalog.

Parameters:

l - document library.

h - Catalog dictionary entries.

Method Detail

init

public void init()

Initiate the PageTree.

Overrides:

init in class Dictionary

dispose

public void dispose(boolean cache)

Dispose the Catalog.

Parameters:

cache - if true, cached files are removed, otherwise objects are freed but object caches are left intact.

getPageTree

public PageTree getPageTree()

Gets PageTree node that is the root of the document's page tree. The PageTree can be traversed to access child PageTree and Page objects.

Returns:

Catalogs PageTree.

See Also:

Page

getOutlines

public Outlines getOutlines()

Gets the Outlines Dictionary that is the root of the document's outline hierarchy. The Outline can be traversed to access child OutlineItems.

Returns:

Outlines object if one exists; null, otherwise.

See Also:

OutlineItem

getNameTree

public NameTree getNameTree()

Gets the document's Names dictionary. The Names dictionary contains a category of objects in a PDF file which can be referred to by name rather than by object reference.

Returns:

name dictionary for document. If no name dictionary exists null is returned.

getDestinations

public Dictionary getDestinations()

Gets a dictionary of names and corresponding destinations.

Returns:

A Dictionary of Destinations; if none, null is returned.

toString

public String toString()

Returns a summary of the Catalog dictionary values.

Overrides:

toString in class Dictionary

Returns:

dictionary values.