(v13) The getPDFobject operator

This page applies to Harlequin v13.1r0 and later; and to Harlequin Core but not Harlequin MultiRIP.

int pdfobjtype getPDFobject any

This operator is defined in internaldict.

Given an execution context ID and a pdfobjtype reference, returns a PostScript VM copy of the requested PDF object.

Dictionary objects in the PDF file that contain more than 64 KiB entries are not supported and that an error is triggered if an attempt is made to read such a dictionary.

The getPDFobject operator has an optional third parameter. The syntax is either:

int pdfobjtype getPDFobject

or

int pdfobjtype paramsdict getPDFobject

This latter form has parameters controlling the behavior of the operator in the optional parameters dictionary. Currently, there is only one such parameter supported: /StreamDictOnly. Its presence is optional in the parameters dictionary, and it is a Boolean. When true, it indicates that getPDFobject should return a dictionary object when the pdfobjtype refers to a stream object.

This allows callers which only need the stream dictionary (which previously would have called getPDFobject immediately followed by getPDFstreamdict), to get what they need much more efficiently since the RIP does not need to spend time constructing a stream object complete with filter chain and so on.