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.

Version

This directive applies to the V7 writer only.

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.

Version

This directive applies to the V7 writer only.

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.

Version

This directive applies to the V7 writer only.

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 to Version 7 DGN files.

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 (V7 only)

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)