IEPS Writer Directives

DATASET

Required/Optional: Required

The IEPS writer processes the DATASET keyword as described in Writer Overview. Additional keywords can be used to set default parameters that are applied to all applicable features in the file. However, the values set by the keywords can be overwritten if the feature itself has a value defined for that parameter. For example, although the LINE_WIDTH keyword may be used to specify a default width of 5 for all lines in the file, if an ieps_polyline feature has its ieps_line_width set to a value of 2, then the line width of 2 will be used over the default value of 5.

Workbench Parameter: Destination Adobe Illustrator EPS File

DEF

Required/Optional: Required

This is a required keyword that defines the layers within the file. DEF lines also list the attributes that will be saved as object tags on features of that layer, and may also include the attribute IEPS_LAYER_COLOR. This should be followed by an RGB combination ranging in intensities from 0 to 255, separated by commas. This defines the layer color seen in Adobe Illustrator.

Attribute

Contents

Required/Optional

IEPS_LAYER_COLOR

This is an attribute that can be used on a DEF line. It defines the layer color seen in Illustrator.

Range: 0..255, 0..255, 0..255

Default: No Default

Optional

RESOLUTION _X and RESOLUTION _Y

Required/Optional: Optional

These directives define the bounding box of the IEPS 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 x 11-inch piece of paper.

Range: Integer > 0

Default:

RESOLUTION_X: 612

RESOLUTION_Y: 792

Workbench Parameter: Width (points), Height (points)

MAINTAIN_ASPECT

Required/Optional: Optional

This directive is followed by a value of YES or NO. By default, the value is set to YES. 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 defined destination bounding box.

Range: YES | NO

Default: YES

Workbench Parameter: Maintain Map Aspect Ratio

LINE_WIDTH

Required/Optional: Optional

This directive is followed by the value in pixels of the line width you wish to use by default. The default value is set to 0, which is the thinnest printable line width.

Range: float >= 0

Default: 0.0 (1 pixel wide: the thinnest line that can be rendered at device resolution)

Workbench Parameter: Line Width (pixels)

TEXT_WIDTH

Required/Optional: Optional

This directive has an attribute just like LINE_WIDTH except that this width is applied to text features. The default value is set to 0, which is the thinnest printable line width.

Range: float >= 0

Default: 0.0 (1 pixel wide: the thinnest line that can be rendered at device resolution)

Workbench Parameter: Text Width (pixels)

TEXT_FONT

Required/Optional: Optional

This directive specifies the default font applied to all text features. The font must be a PostScript name. The fonts supported depend on the destination of the IEPS file. Some typical fonts are NewBaskerville, Times, Helvetica and Courier. The default is NewBaskerville since it is the most commonly installed with Adobe Illustrator.

Range: String

Default: NewBaskerVille

Workbench Parameter: Text Font

TEXT_STYLE

Required/Optional: Optional

This directive specifies the default style to be applied to the text font all text features. This attribute must be matched to the current font since it is the combination of text font and text style that is recognized by Adobe Illustrator. Some typical font and style combinations are NewBaskerville-(None, Bold), Times-(None, Roman, Italic, Bold, BoldItalic), Helvetica-(None, Oblique, Bold, BoldOblique), and Courier-(None, Oblique, Bold, BoldItalic). Note that the keyword NONE can be used to specify that no style should be applied to the font.

Range: String

Default: Bold

Workbench Parameter: Text Style

LINE_JOIN_TYPE

Required/Optional: Optional

This directive is followed by the values 0, 1, or 2. These 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.

Range: 0, 1, 2

Default: 0

Workbench Paramter: Line Join Type

LINE_CAP_TYPE

Required/Optional: Optional

This directive is followed by the values 0, 1, or 2. These values specify the default cap that will be used on line segments. 0 specifies butt-end caps, 1 specifies rounded-end caps and 2 specifies square-end caps.

Range: 0, 1, 2

Default: 0

Workbench Parameter: Line Cap Type

FORCE_CMYK

Required/Optional: Optional

By setting the value following this keyword to YES, then all color usage output to the IEPS file is in CMYK. By default, this value is NO, meaning that a mix of RGB and CMYK color schemes may be in the output IEPS file. However, despite forcing CMYK color output, some IEPS 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 IEPS viewer you are using.

Range: YES | NO

Default: NO

Workbench Parameter: Force CMYK

LOCK_FEATURES

Required/Optional: Optional

If set to YES, by default all features will be locked and cannot be selected or edited in Adobe Illustrator. Note: Even if LOCK_FEATURES is set to YES, individual features can be unlocked if its eps_lock_feature is set to 0 (meaning NOT locked). Hence, an individual eps_lock_feature value overrides this LOCK_FEATURES default value.

Range: YES | NO

Default: NO

Workbench Parameter: Lock Features

RENDER_TYPE

Required/Optional: Optional

This directive determines how the text is output. This value will be used as the default render type for all text in the file but it will be overridden if the text feature has its own user-defined render type value.

This directive is followed by the values 0, 1, or 2. These values specify the default rendering that will be applied to text features: 0 = fill, 1 = stroke, 2 = stroke and fill. The default value is 2.

Range: 0, 1, 2

Default: 2

Workbench Parameter: Render Type