Writer Directives
By default, the <WriterKeyword>
for the IGDS writer is IGDS
, so a typical mapping file fragment configuring the IGDS writer would be:
IGDS_DATASET /usr/data/dgn/92b034.dgn
IGDS_SEED_FILE /usr/data/dgn/2dseed.dgn
IGDS_CELL_LIBRARY /usr/data/dgn/cartog.cel
DATASET
The file name of the output IGDS file.
Required/Optional
Required
Workbench Parameter
Destination Bentley MicroStation Design File
SEED_FILE
The file name of the Design file which will be used to seed the output file’s header information. The default seed file (V8) is:
$(FME_HOME)/design/seed3d_m_v8.dgn
To write to V7, you will have to select a valid V7 seed file.
It is important to note that the seed file determines which destination version to write.
Required/Optional
Required
Workbench Parameter
V7/V8 Seed File
ALLOW_FILL
Controls whether or not fill linkages will be written out for ellipses, shapes, and solids. This setting does not affect the use of igds_color.
Required/Optional
Optional
Values
YES (default) | NO
Workbench Parameter
Allow Area Color Fills
CELL_LIBRARY
The file name of an IGDS cell library that contains the definitions of cells which may later be output.
Required/Optional
Optional
Workbench Parameter
Cell Library File
DEFAULT_CELL_NAME
The default cell used in place of any cells requested but not found in the cell library.
Required/Optional
Optional
Workbench Parameter
Default Cell Name
UNITS
Specifies how FME feature coordinates will be interpreted and converted into UORs.
See the Reader Overview for details.
Version
This directive is not currently supported by the V8 writer.
Required/Optional
Optional
Workbench Parameter
Output Units
CREATE_LINE_ELEMENTS
Controls whether or not type 3 line elements will be created for two point linear features.
Values
YES | NO (default)
If set to NO, then type 4 elements will be created.
Required/Optional
Optional
Workbench Parameter
Type 3 Elements
COMPUTE_SEED_FILE_PARMS
Automatically adjusts the origin and scaling of the seed file to provide an optimum set of parameters for the input data.
Version
This directive applies to the V7 writer only.
Required/Optional
Optional
Workbench Parameter
Compute Optimal Seed File Parameters
UOR_GLOBAL_ORIGIN_X
The global origin of x, measured in UORs, from the lower left corner of the design plane/cube. Overrides that read from the seed file.
Value
An unsigned 32 bit integer value
Required/Optional
Optional
Workbench Parameter
UOR X Global Origin
UOR_GLOBAL_ORIGIN_Y
The global origin of y, measured in UORs, from the lower left corner of the design plane/cube. Overrides that read from the seed file.
Value
An unsigned 32 bit integer value
Required/Optional
Optional
Workbench Parameter
UOR Y Global Origin
UOR_GLOBAL_ORIGIN_Z
The global origin of z, measured in UORs, from the lower left corner of the design plane/cube. Overrides that read from the seed file.
Value
An unsigned 32 bit integer value
Required/Optional
Optional
Workbench Parameter
UOR Z Global Origin
MASTER_UNIT_NAME
The two-character master unit name to use. Overrides that read from the seed file.
Version
This directive applies to the V7 writer only.
Value
A string of up to two characters (for example, M for meters)
Required/Optional
Optional
Workbench Parameter
Master Unit Name
SUB_UNIT_NAME
The two-character sub unit name to use. Overrides that read from the seed file.
Version
This directive applies to the V7 writer only.
Required/Optional
Optional
Workbench Parameter
Sub Unit Name
SUBS_PER_MASTER
The number of sub units per master unit. Overrides that read from the seed file.
Version
This directive applies to the V7 writer only.
Values
An unsigned integer ratio
Required/Optional
Optional
Workbench Parameter
Subs per Master
UORS_PER_SUB
The number of UORs per sub unit. Overrides that read from the seed file.
Version
This directive applies to the V7 writer only.
Values
An unsigned integer ratio
Required/Optional
Optional
Workbench Parameter
UOR per Sub
MANGLE_DBCS_TEXT
Controls whether or not double-byte-character-set text is mangled when text strings are written.
MicroStation uses special header bytes to single DBCS text. Note that the IGDS reader automatically de-mangles DBCS text.
Values
YES | NO (default)
If this directive is set to Yes in the mapping file, then these special bytes will be output when a DBCS text string is encountered. The default value is No.
Version
This directive applies to the V7 writer only.
Required/Optional
Optional
Workbench Parameter
Mangle DBCS Text
SPLIT_BIG_DGN7_FILES
Allows user to split Version 7 DGN files bigger than 32 MB.
Note that this directive can be manually set to No in the mapping file.
Values
YES (default) | NO
Version
This directive applies to the V7 writer only.
Required/Optional
Optional
Workbench Parameter
Split Files (V7 Only)
SPLIT_SIZE_DGN7_FILES
This directive allows you to set the size of the output file, in MB. It is applicable only if SPLIT_BIG_DGN7_FILES is set to YES.
Values
Default value: 32 MB
Version
This directive applies to the V7 writer only.
Required/Optional
Optional
Workbench Parameter
Split Size in MB (V7 Only)
WRITE_TAGS
Controls whether or not tags should be written for the elements which have necessary tag information attached to them as attributes.
Values
YES | NO (default)
Version
This directive currently applies only to the V8 writer.
Required/Optional
Optional
Workbench Parameter
Write Tags
SCALE_CELL_MODELS
If set, indicates that the coordinates of named cells written to the destination should be scaled from the coordinate space of the cell model to the coordinate space of the seed model (which is used as the destination). This affects shared and unshared cells, which do not have a cell size (i.e. igds_cell_size, or igds_cell_size_x and igds_cell_size_y) set. This behaviour is similar to the setting for True Scale when placing cells in Microstation.
Values
YES (default) | NO
Version
This directive currently applies only to the V8 writer.
Required/Optional
Optional
Workbench Parameter
Scale Cells to Destination Model
RSC_FONT_FILE
If set, this directive indicates that text features may use the Resource (RSC) font file specified to assist in text element placement, size, and range calculation. This only applies to text features with RSC font IDs specified in the igds_font attribute, and which are found in the specified RSC file to be symbolic fonts. If this directive is not specified, text elements with symbolic RSC fonts will have their placement, size and range estimated.
Values
A valid system file path to a Resource font file
Required/Optional
Optional
Workbench Parameter
Resource Font File
WRITE_XFM_DGNSTORES_FROM_SEED
If set, this directive indicates that XML Feature Modeling (XFM) store features may be preserved in the destination dataset, from the seed file, and not written from features. Otherwise, if this directive is not specified, XFM store elements will be created from any features with an igds_type of igds_xfmstore, which the writer receives.
Values
YES (default) | NO
Version
This directive applies to the V8 writer only.
Required/Optional
Optional
Workbench Parameter
Write XFM store elements from seed file (V8 only)