(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