Writer Directives

The suffixes shown are prefixed by the current <ReaderKeyword> in a mapping file. By default, the <ReaderKeyword> for the EPS writer is EPS.

DATASET

Required/Optional: Required

The EPS writer processes the DATASET directive as described in Writer Overview. In addition, the writer scans the mapping file for <WriterKeyword>_RESOLUTION _X and <WriterKeyword>_RESOLUTION _Y directives. Both of these are optional directives and they define the bounding box of the EPS output file. The bounding box extends from the lower left corner of the page (defined as 0,0) and extends out to the values entered. By default, the X value is set to 612 and the Y value is set to 792. These values map onto an 8.5- by 11-inch piece of paper.

Workbench Parameter: Destination Encapsulated PostScript (EPS) File

FORCE_CMYK

Required/Optional: Optional

This directive specifies whether or not to force all output colors to be in CMYK format and defined as such in the EPS file. By setting the value following this keyword to YES, then all color usage output to the EPS file is done in CMYK. By default, this value is NO, meaning that a mix of RGB and CMYK color schemes may be in the output EPS file. However, despite forcing CMYK color output, some EPS viewers may not support the setcmykcolor call in their library. In these cases, the actual output of colors is done using a function we define in PostScript which interfaces exactly like the setcmykcolor call but uses setrgbcolor underneath. This will depend on the EPS viewer you are using.

Value: YES | NO

Default Value: NO

Workbench Parameter: Force CMYK Colors

LINE_JOIN_TYPE

Required/Optional: Optional

This directive specifies the default corner types to be drawn onto paths. The values specify the default shape to be put at corners of paths painted: 0 specifies a sharp corner, 1 specifies a rounded corner, and 2 specifies a butt-end corner.

Value: 0, 1, 2

Default Value: 0

Workbench Parameter: Line Join Type

LINE_WIDTH

Required/Optional: Optional

This directive specifies the default line width used to draw lines. This is measured in EPS units.

Value: float >=0

Default Value: 0.0 (the thinnest line that can be rendered at device resolution, i.e. 1 pixel wide)

Workbench Parameter: Line Width

MAINTAIN_ASPECT

Required/Optional: Optional

This directive specifies whether or not the source map dimensions will be kept or stretched to fit to the output bounding box.. A YES indicates that the original map aspect will be maintained to fit within the destination-defined bounding box. This means that the entire destination bounding box defined may not used. Alternatively, the value NO causes the original map to be stretched onto the destination bounding box defined.

Value: YES | NO

Default Value: YES

Workbench Parameter: Maintain Map Aspect Ratio

MAP_BUFFER

Required/Optional: Optional

This directive specifies the percentage of buffer room between the border of the output EPS map within the specified bounding box. It should be followed by a percentage value in decimals (for example, 0.20 is 20%). This value is used to buffer the border of the outputted EPS map within the specified bounding box. This prevents the border of the output map from being precisely on the bounding box border. The default value is 0.05 (5%), which places a 2.5% buffer between each map border and the bounding box border. This creates a total 5% buffer in the x and y axes.

Value: 0...1

Default Value: 0.05

Workbench Parameter: Buffer Ratio

RESOLUTION_X

This directive specifies the maximum EPS units (1 unit = 1/72 inch) for the x dimension of the output map.

Value: Integer > 0

Default Value: 612

Workbench Parameter: Width (points)

RESOLUTION_Y

This directive specifies the maximum EPS units (1 unit = 1/72 inch) for the y dimension of the output map

Value: Integer > 0

Default Value: 792

Workbench Parameter: Height (points)