(v13) The setgstatetag operator
This page applies to Harlequin v13.1r0 and later; and to Harlequin Core but not Harlequin MultiRIP
systemdict tagblockname tagname tagvalue
setgstatetag -
Writes arbitrary values to the PostScript-language graphics state for later recall by currentgstatetag
. An important but optional use of this feature when using run-length encoded (RLE) output is assigning these values to graphic objects when they are painted, and then transmitting the values to the runlength encoded data stream using the RUN_INFO
record type.
tagvalue represents a string or integer value supplied as the new value of tagname , held in the block
tagblockname
. The type and allowable size (implying a range of allowed values) of each tag are defined in a dictionary used as an operand to the setgstatetagdict
operator. This dictionary always names the tag, and may assign it a tag type, meaning that the tag values are passed into RLE output data.
Note: RLE is only available with the Harlequin HostRenderer. See the Run-Length Output Format manual for details.
See also: currentgstatetag
, currentgstatetagdict
, setgstatetagdict