Dictionary keys in targets

/TargetID string

To allow identification of the source of the target. This string can be printed on the target itself.

/TargetName string

A string that describes the target. The string is used to name the job which prints the target as seen in the Output Controller and elsewhere.

/PatchColorSpace name or array

One of the names: /DeviceGray , /DeviceCMYK , or /DeviceRGB . Note that a three‐color target is expressed as RGB even if printed for CMY. This field determines the number of elements in the PatchColor arrays. At version 5.0 and 5.1, this form of target colorspace description is retained for backwards compatibility but support for this form may be dropped from future versions of the RIP. The alternative array form should now be used even for Gray, CMYK, and RGB targets.

array of numberofcolorants names

Where each name is the standard PostScript language name for a colorant supported by the output device or a name of the form /Spot XXXX where XXXX is a positive non‐zero integer. Names of this form are placeholders used to represent spot colors whose names are not known at the time the target is defined. These names will be mapped to alternative names during the measurement process when the actual colorant names are known.

Note: “numberofcolorants” is not an explicit value or key. It is used for convenience of reference in the description of /PatchColor .

/NumberOfPages integer

The number of pages making up the target.

/PageWidth number

The width of the page on which the target is to be printed, in points.

/PageHeight number

The height of the page on which the target is to be printed, in points.

/PageReferenceX array of 3 numbers

The x coordinates of three positions on the page (in points). These points can be used with automatic measuring equipment to locate the page on a stage. A small crosshair is drawn at these coordinates; if reference points are not required, place them off the page.

/PageReferenceY array of 3 numbers

The y coordinates of the reference positions.

/PageReferenceName array of 3 strings

A description of the reference points. These strings are used with automatic measuring equipment to provide a prompt to the user to do whatever is necessary to locate the point on the stage. The strings are not printed on the page.

/NumberOfPatches integer

The total number of patches on all pages of the target. Determines the number of elements in all the arrays describing patches below.

Note: If you wish to use these patches with the Genlin program, and subsequently import the data into the Edit Calibration dialog box, then the maximum number of patches is the number of data value fields in that dialog box. For versions 4.5 through 5.1, the maximum number of patches is 36 for each colorant.

/PatchName array of NumberOfPatches strings

Gives names for each of the patches. These names are used as labels for the measurement boxes in the Calibration Edit dialog and elsewhere. They are not printed on the page: labels for patches need to be printed explicitly if required.

/PatchStyle array of NumberOfPatches of names

Each name describes the shape of the corresponding patches. The “hot spot” for all of these shapes is at their center.

/PatchColor array of arrays of numberofcolorants numbers or array of numberofpatches numbers

array of arrays of numberofcolorants numbers

Each subarray contains the numbers required for a setcolor with color space set to the PatchColorSpace . In the case where the array form of the PatchColorSpace is specified, DeviceN colorspace is used. Patches are printed using these nominal colors, though for calibrated targets, the amount of colorant will, of course, be adjusted, as it will where there is a default calibration in force.

Note: “numberofcolorants” is deduced from the value of /PatchColorSpace . It is not an explicit key in the target file. For the named color spaces, “numberofcolorants” has the obvious values: 1 for /DeviceGray , 4 for /DeviceCMYK , and 3 for /DeviceRGB . For an array of colorant names, its value is the length of the array.

array of NumberOfPatches numbers

The PatchColor array may be specified as a single array of color values. When specified in this way the numbers should be in a form suitable for passing to a separation colorspace where the separation name is that given in the PatchColorant array.

/PatchPage array of NumberOfPatches integers

Each element indicates which page the corresponding patch should appear on. Pages are numbered starting from 1.

/PatchWidth array of NumberOfPatches number s

Each element indicates the width of the corresponding patch, in points. Often these are all identical. Where the patch is not rectangular, the width is that of the bounding box.

/PatchHeight array of NumberOfPatches numbers

The heights of each of the patches, in points.

/PatchOriginX array of NumberOfPatches numbers

The x coordinates of the location of the patches on the page. The origin is not the lower left corner of the patch, but a “hotspot” determined by the patch style, typically the center. The coordinate is used both for drawing the patch and for determining where to measure when using automatic measuring equipment.

/PatchOriginY array of NumberOfPatches numbers

The y coordinate of the location of the patches on the page, as for PatchOriginX .

/PatchGroup array of NumberOfPatches strings

Each string names a group into which the corresponding patch is put.

Note: This key is supported for backwards compatibility, but PatchColorant should now be used instead.

/PatchColorant array of NumberOfPatches strings

This array should be specified for all calibration targets where calibration is performed for color channels independently. Each string indicates which color channel should be used to produce the patch. This name should be suitable for use with a Separation colorspace.

/TextColorSpace name

One of the names /DeviceGray , /DeviceCMYK , or /DeviceRGB . This field determines the number of elements in the TextColor arrays.

/TextString array of strings

A set of strings to be printed on the page according to the entries in the other text description arrays below. The number of entries of each of the arrays must be consistent. Each string is writ‐ ten literally, except that the dollar ( $ ) sign is used as an escape character. A printed dollar sign requires $$ , and other substitutions can be made into the string automatically by a key between the dollar signs.

For example, to print the number for the resolution of the output on the target, you might use a string (Resolution: $RESOLUTION$) , which might then appear on the page as “Resolution: 1270 x 1270”.

See Table: Text string escape codes for the available escape codes.

/TextPage array of integers

The pages on which each text string is to appear.

/TextRect array of arrays of 4 numbers

Defines a bounding box for the text, to which it will be clipped. This box is specified relative to the text origin (see below) in the normal orientation of the text (that is, unaffected by TextOrientation see below). Remember to consider descenders in the text.

/TextOriginX array of numbers

The x coordinates for the start of each of the text strings, in points.

/TextOriginY array of numbers

The y coordinates for the start of each of the text strings, in points.

/TextOrientation array of numbers

The angle in degrees counterclockwise at which each text string will be drawn. The bounding box for each text string is rotated along with the characters.

/TextColor array of arrays of numbers

The color of each text string, expressed as the numbers which would be used as operands to setcolor when the color space is set to TextColorSpace .

/TextFont array of names

The font in which each text string is to be rendered.

/TextFontSize array of numbers

The size of the font in which each text string is to be rendered, as in the operand to selectfont .

/EPSFileName array of strings

The names of a set of EPS files to be rendered as part of the page, according to the other EPS arrays described below. The names are PostScript language filenames (subject to file name map‐ ping) and will always be located in the directory SW/targeteps .

/EPSPage array of integers

The pages upon which the corresponding EPS files from /EPSFileName are to appear.

/EPSWidth array of numbers

The width in points of the boxes into which the corresponding EPS files from /EPSFileName are to be mapped. The bounding box specifier in the EPS file is used to scale and translate the file into the box given by EPSOriginX , EPSOriginY , EPSWidth and EPSHeight , and is clipped to that box.

/EPSHeight array of numbers

The height in points of the boxes into which the corresponding EPS files from /EPSFileName are to be mapped.

/EPSOriginX array of numbers

The x coordinates, in points, at which to locate the origins of the boxes into which the corresponding EPS files are printed. (/EPSOriginY records the y coordinates of the box origins.)

/EPSOriginY array of numbers

The y coordinates, in points, at which to locate the origins of the boxes into which the corresponding EPS files are printed. (/EPSOriginX records the x coordinates of the box origins.)

/EPSOrientation array of numbers

The angles, in degrees, by which each EPS box (as given by the width, height, and origin) is rotated counterclockwise about the corner of its bounding box.

/UsePSUEffects boolean

If true , page setup effects such as rotation, page scaling, and so on are applied to the whole tar‐ get. If false , these page setup items are ignored. Certain page setup properties are always ignored when calibration strips are printed. For example, the calibration set applied is deter‐ mined by the Print Calibration dialog, not the page setup selected.

/Comments string

Any text. This string is printed in the Monitor window when the target is printed.