(v13) The currentsystemparam operator

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

internaldict name currentsystemparam any

currentsystemparam obtains the value of one system parameter much as the standard PostScript-language operator currentsystemparams does for all system parameters.

Typically, currentsystemparams is used to extract the value of a single parameter, as in this fragment:

currentsystemparams /OverrideSpotFunctionName get

This is inefficient because it requires (a) locating every parameter and converting each to PostScript form, and (b) constructing a large dictionary. currentsystemparam is much more efficient for a single parameter. currentsystemparam takes the name of the required parameter as its only operand, and returns the value of the parameter on the operand stack, so:

/OverrideSpotFunctionName currentsystemparam

is functionally identical to the earlier example, using currentsystemparams .

Note: If you use currentsystemparams to query /OverrideSpotFunctionName a reference to the buffer is returned containing the name, which can subsequently change. For example, it you retrieve it at one point, then something changes it, the value you retrieved has become corrupted. To avoid this, create a new string of the correct size yourself and copy the returned value to it.