MicroStation CONNECT Edition Help

DWG/DXF Open-Specific Configuration Variables

MicroStation includes configuration variables to open AutoCAD DWG data. Valid values must be entered exactly as shown in the table. For example, “Region” Entity must be entered as a whole string.

Note: Many DWG/DXF open-specific configuration variables have an equivalent setting in the GUI. When set correctly they will override the values in the DWG settings GUI.
Configuration Variable Use
MS_DWG_ALERT_DEC_FRC_SCI_UNITS When a DWG file is opened, an alert dialog opens to warn that Decimal/Fractional/Scientific units are not set to Design Center units. Valid values are ON (or no value) or OFF.
MS_DWG_ALERT_DESIGNCENTER_UNITS When a DWG file is opened, an alert dialog opens to warn that Design Center units are not set to a specific unit. Valid values are ON (or no value) or OFF.
MS_DWG_ALERT_ENG_ARCH_UNITS When a DWG file is opened, an alert dialog opens to warn that Architectural/Engineering units are not set to Inches. Valid values are ON (or no value) or OFF.
MS_DWG_ARCH_ENG_UNITS Sets units to open DWG files that use Architectural or Engineering units. Valid values are:

Master Units

Sub Units

Design Center Units

a unit defined in file units.def

MS_DWG_ATTRIBUTE_AS_TAG If set, the Block Attributes as Tags check box in the DWG Open Options dialog is turned on and the attributes are converted as tags instead of item types.
MS_DWG_AXISLOCK_FROM_ORTHOMODE If DWG ORTHOMODE=1, sets the Axis Lock. Valid values are ON (or no value) or OFF.
MS_DWG_DEC_FRC_SCI_UNITS Sets units to open DWG files that use Decimal, Fraction or Scientific units. Valid values are:

Master Units

Sub Units

Design Center Units

a unit defined in file units.def

MS_DWG_DESIGNBACKGROUND_COLOR Sets the background color for the default design model. Valid values are Red, Green, or Blue, where each of the three color indices is an integer between 0 and 255.
MS_DWG_DESIGNCENTER_UNITS Sets units to open DWG files that use Design Center Units. Valid values are:

Master Units

Sub Units

a unit defined in file units.def

MS_DWG_DISCARD_INVALID If set, entities that are outside the DGN design plane are discarded and will not be written back to the DWG file on the next file save. If the variable is not set, the product ignores these entities. Typically these entities are not valid and will cause the AutoCAD Zoom Extents tool to perform poorly.
MS_DWG_FOREGROUNDCOLOR255RGB Sets the RGB value to display DWG color index 255 as the foreground color, with red, green, and blue values separated by commas. For example, setting MS_DWG_FOREGROUNDCOLOR255RGB=255,255,255 will display DWG index color 255 as white. If this configuration variable is not set, a grayish color is displayed. This is a workaround for DWG's ambiguous index color 255, which serves both as a background color for wipeout fill and as a foreground color for other entities. The foreground definition is remapped by this configuration variable and the RGB value is saved as a named color "DWG Color 255" in a color book called "DWG Special Colors."
MS_DWG_GRAPHIC_GROUP_ATTRIBUTES Sets blocks to Graphic Groups, that is, puts shared cell and attached tags into a graphic group. Valid values are ON (or no value) or OFF.
MS_DWG_LINEWEIGHT_MAPPING Maps DWG line weights to DGN line weights. Valid values are 0=DWG weight1; 1=DWG weight2; 2=DWG weight3; and so forth to 31=DWG weight31, where DWG weights are the DWG line weight values in millimeters, for examples, 0.0, 0.13, 2.11.
MS_DWG_LWDEFAULT Controls the width of the default line weight and is analogous to the AutoCAD registry variable LWDEFAULT. The default value is 0 for unweighted default lines. Valid LWDEFAULT values are From AutoCAD Registry, 0.00 mm, 0.05 mm, 0.09 mm, 0.13 mm, 0.15 mm, 0.18 mm, 0.20 mm, 0.25 mm, 0.30 mm, 0.35 mm, 0.40 mm, 0.50 mm, 0.53 mm, 0.60 mm, 0.70 mm, 0.80 mm, 0.90 mm, 1.00 mm, 1.06 mm, 1.20 mm, 1.40 mm, 1.58 mm, 2.00 mm, 2.11 mm. The Line weight index is also a valid alternative, that is, any integer from 0 through 211. A line weight index is an enumeration of line weight defined by DXF Group Code 370.
MS_DWG_MAX_DICTIONARYITEMS (Affects DWG files with many dictionary items.) A dictionary item is non-graphical data stored in the DWG file that often does not impact the visible elements. When opening a file, if the DWG file has a large number of these items, performance can be slow. To speed up the file opening process, you can ignore this items. If you need these dictionary items, you can opt to keep them in spite of poor performance. This variable sets the number of dictionary items you want to keep.
MS_DWG_MODELSPACE Sets the model space to 2D or 3D. Valid values are 2D or 3D.
MS_DWG_OPEN_CORRUPTED_FILE If set, MicroStation will try open a corrupt DWG file. By default, this configuration variable is not set, in which case, MicroStation checks for file corruption and does not open the file if it is corrupt. Note that this configuration variable does not impact reference attachments and all files are attached, regardless of this configuration variable's status. Also note that reference attachment of a corrupt DWG file cannot be activated for editing.
MS_DWG_PAPERSPACE Sets the paper space to 2D or 3D. Valid values are 2D or 3D.
MS_DWG_PROXYSHOW Controls the display of proxy objects within a DWG drawing. It is analogous to the AutoCAD registry setting PROXYSHOW. Valid values are:

From AutoCAD Registry

Do Not Show Proxy

Show Proxy Image

Show Proxy Box

An alternative is an integer value such as 0 – do not show graphics, 1 – show graphics, or 2 – show boundary box only. The default setting is 1.

MS_DWG_PROXY_VIEW Sets a view to be displayed for a multi-view proxy. Valid values are:

Top

Front

Left

Isometric

MS_DWG_REFERENCE_CONVERT Converts reference files to DWG files. Valid values are ON (or no value) or OFF.
MS_DWG_REFERENCE_COPYLEVEL Sets the conditions to copy reference levels during merge: only if they are not in the target file, if they are overridden, or always copy. Valid values are If Not Found, If Overrides Exist, or Always.
MS_DWG_REFERENCE_COPYNESTED Copies live nested reference attachments to the target file when merging. Valid values are ON (or no value) or OFF.
MS_DWG_REFERENCE_EXTERNAL Saves external reference file attachments to be an Xref attachment (retained), merged, merged as a block, or omitted. Valid values are:

Retain

Merge

Merge To Cell

Omit

MS_DWG_REFERENCE_MASKED Saves masked reference file attachments to be an Xref attachment (retained), merged, merged as a block, or omitted. Valid values are:

Retain

Merge

Merge To Cell

Omit

MS_DWG_REFERENCE_MERGE_DISPLAYEDLEVELSONLY Merges reference levels only if they are displayed. Valid values are ON (or no value) or OFF.
MS_DWG_REFERENCE_OPTIMIZEDCLIP Optimizes reference clipping when merged. Valid values are ON (or no value) or OFF.
MS_DWG_REFERENCE_SELF Saves self-referenced file attachments to be an Xref attachment (retained), merged, merged as a block, or omitted. Valid values are:

Retain

Merge

Merge To Cell

Omit

MS_DWG_RENDER_LIGHTSOURCE_OPEN Sets to use light source for rendering. Valid values are ON (or no value) or OFF.
MS_DWG_RENDER_MATERIAL_OPEN Sets to use materials for rendering. Valid values are ON (or no value) or OFF.