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