MicroStation CONNECT Edition Help

DWG/DXF Save-Specific Configuration Variables

MicroStation includes configuration variables to save 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 save-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_2D_UNFILLED_3OR4SIDED_SHAPE Converts 2D unfilled triangles and quadrangles to polyline, face, polyface mesh, or region entities. Valid values are:

“Face” Entity

“Region” Entity

Polyface Mesh

Polyline

MS_DWG_2D_UNFILLED_5ORMORESIDED_SHAPE Converts 2D unfilled polygons to polyline, polyface mesh, or region entities. Valid values are:

“Region” Entity

Polyface Mesh

Polyline

MS_DWG_2D_UNFILLED_COMPLEX_SHAPE Converts 2D unfilled complex shapes to polyline, polyface mesh, or region entities. Valid values are:

“Region” Entity

Polyface Mesh

Polyline

MS_DWG_2D_UNFILLED_GROUPHOLE Converts 2D unfilled group hole elements to polyface mesh or region entities. Valid values are:

“Region” Entity

Polyface Mesh

MS_DWG_3D_UNFILLED_3OR4SIDED_SHAPE Converts 3D unfilled triangles and quadrangles to polyline, face, polyface mesh, or region entities. Valid values are:

“Face” Entity

“Region” Entity

Polyface Mesh

Polyline

MS_DWG_3D_UNFILLED_5ORMORESIDED_SHAPE Converts 3D unfilled polygons to polyline, polyface mesh, or region entities. Valid values are:

“Region” Entity

Polyface Mesh

Polyline

MS_DWG_3D_UNFILLED_COMPLEX_SHAPE Converts 3D unfilled complex shapes to polyline, polyface mesh, or region entities. Valid values are:

“Region” Entity

Polyface Mesh

Polyline

MS_DWG_3D_UNFILLED_GROUPHOLE Converts 3D unfilled group hole elements to polyface mesh or region entities. Valid values are:

“Region” Entity

Polyface Mesh

MS_DWG_ACS_TO_UCS Converts ACS to UCS. Valid values are ON (or no value) or OFF.
MS_DWG_BLOCKDEF_ON_LAYER0 Saves the block definitions on layer “0.” Valid values are ON (or no value) or OFF.
MS_DWG_BLOCKNAMES_FROM_TRIFORMA_PARTS Sets the block names from Building parts. Valid values are ON (or no value) or OFF.
MS_DWG_BLOCKUNITS_FROMFILE If on, new blocks created from MicroStation will have their INSUNITS set based source file or model units, which may be controlled by the Units drop-down list in Save As DWG/DXF Options dialog, Basic section. Valid values are ON and OFF.
MS_DWG_BYBLOCK_COLOR Sets the block definitions to use the color BYBLOCK. Valid values are ON (or no value) or OFF.
MS_DWG_BYBLOCK_LINETYPE Sets the block definitions to use line type BYBLOCK. Valid values are ON (or no value) or OFF.
MS_DWG_BYBLOCK_WEIGHT Sets the block definitions to use line weight BYBLOCK. Valid values are ON (or no value) or OFF.
MS_DWG_CONSTRUCTION_CLASS Sets the elements of the construction class to “Construction” layer, “Defpoints” layer, element’s own layer, invisible, or omits them. Valid values are:

Save To “Construction” Layer

Save To “Defpoints” Layer

Save

Save As Invisible

Omit

MS_DWG_CONVERT_RSC_FONTS Converts and creates SHX files from RSC fonts. Valid values are ON (or no value) or OFF.
MS_DWG_CREATE_SEPARATE_SHEETS When a DGN file containing sheet models is saved to DWG, the sheets are usually saved to separate layouts within the DWG file. If this variable is set, the sheets are saved to separate DWG files with the file name created by appending the model name to the original file name. Valid values are ON (or no value) or OFF.
MS_DWG_CURVED_SOLIDSURFACE Converts curved solids and surfaces to wireframe, polyface mesh or ACIS entities. Valid values are:

Wireframe

Polyface Mesh

ACIS Entity

MS_DWG_CURVES Converts curves to spline curves or polyline curves. Valid values are:

Spline Entity

Polyline

MS_DWG_DROP_LABELLINES When present, a label line dimension will be dropped to single line text when saved to DWG. By default, a label line will become an mtext. If a label line's text positions are important, dropping them to a single line may be desired. Set this variable to any value to turn it on. It is off by default.
MS_DWG_DROP_UNSUPPORTED_DIMENSIONS Drops dimensions that are not supported by DWG file format. Valid values are ON (or no value) or OFF.
MS_DWG_DROP_UNSUPPORTED_LS Drops line styles that are not supported by DWG file format. The most possible custom line styles DWG format allows are those with characters in them. Any other types are incompatible. Valid values are ON (or no value) or OFF.
MS_DWG_EMPTY_EDF_TO_SPACE Converts blank enter data fields to spaces. Valid values are ON (or no value) or OFF.
MS_DWG_FARREFDEPENDENCY If set to 0 (the default), DWG named groups work as they do in DWG, that is, elements from a reference file are not supported by group. This is a DWG limitation. If set to 1, you can work around that limitation, that is, elements in reference files can be selected and saved in named groups. However, these groups still will not work in AutoCAD. If these groups and elements are edited in AutoCAD, they may not function anymore when the DWG file is reopened in the product.
MS_DWG_FILE_CODEPAGE Sets the DWG file codepage. Valid values are 1252 (English) , 1251 (Cyrillic), 1253 (Greek), 1254 (Turkish), 1255 (Hebrew), 1256 (Arabic), 1257 (Baltic), 1258 (Vietnam), 874 (Thai), 932 (Japanese), 936 (Simplified Chinese), 949 (Korean), or 950 (Traditional Chinese).
MS_DWG_FILLED_3OR4SIDED_SHAPE Converts filled triangles and quadrangles to solid, polyface mesh, region or hatch entities. Valid values are:

“Solid” Entity

“Region” Entity

“Hatch” Entity

Polyface Mesh

MS_DWG_FILLED_5ORMORESIDED_SHAPE Converts filled polygons to polyface mesh, region or hatch entities. Valid values are:

“Region” Entity

“Hatch” Entity

Polyface Mesh

MS_DWG_FILLED_COMPLEX_SHAPE Converts filled complex shapes to polyline, region or hatch entities. Valid values are:

“Region” Entity

“Hatch” Entity

Polyline

MS_DWG_FLAT_SOLIDSURFACE Converts flat solids and surfaces to wireframe, polyface mesh or ACIS entities. Valid values are:

Wireframe

Polyface Mesh

ACIS Entity

MS_DWG_FORCE_POSITIVE_ARCS For arcs, changes clockwise orientation to counter clockwise. Valid values are ON (or no value) or OFF.
MS_DWG_FORCE_ZERO_ZCOORDINATE Sets the z-coordinate of an element to have a zero value. Valid values are ON (or no value) or OFF.
MS_DWG_INDEXCOLOR_TO_TRUECOLOR Converts index color to true color. Valid values are ON (or no value) or OFF.
MS_DWG_LEADER_HOOKLINE If set, an inline elbow displays on notes that did not have an elbow when first created.

The product allows a note to be placed without an inline elbow (a hook line in AutoCAD) when the inline toggle is unchecked, but AutoCAD does not. This type of note (for instance, a leader without a hook line) saved to DWG will retain correct graphical presentation, and will operate properly in AutoCAD. However, the audit tool will generate an error (annotation ID not null). The audit error can be resolved by setting this configuration variable to 1. However, the original graphical presentation will be lost (the hook line will appear).

MS_DWG_LEVEL_DISPLAY Sets the view number from which the level display will be used for the layer’s on/off status. Valid values is a number from 0 through 8.
MS_DWG_LEVELSYMBOLOGY_OVERRIDE Overrides the element symbology from the level symbology. Valid values are ON (or no value) or OFF.
MS_DWG_LINEARPATTERN_CLASS Sets the elements of the linear pattern class to “Linear Patterned” layer, “Defpoints” layer, element's own layer, invisible, or omits them. Valid values are:

Save To “Linear Patterned” Layer

Save To “Defpoints” Layer

Save

Save As Invisible

Omit

MS_DWG_LINECODE_SCALE Scales the line code. Valid value is a positive real number.
MS_DWG_LOGICALNAME_TO_XREFNAME Saves the reference attachment logical name as the block name of an Xref file. Valid values are ON (or no value) or OFF.
MS_DWG_NONDEF_DESIGNMODEL_ATTACHMENTS Merges the attachments of a non-default design model or merges them as block references. Valid values are:

Merge

Merge To Cell

Omit

MS_DWG_NONDEFAULT_DESIGNMODEL Saves non-default design models to separate files, layout models (paper space), or ignore them if their attachments are not merged. Valid values are:

Create Separate Files

Create Paper Space

Ignore If Not Merged

MS_DWG_NONPLANAR_POLYLINES Converts a nearly planar line string to a 2D or 3D polyline. A nearly planar linestring is a linestring whose vertices are mathematically nonplanar, but their deviation to the nearest plane is small. Such line strings are represented as light weighted polylines. If there is a large coordinate deviation, it indicates that the nonplanarity is by design and hence the mapping is ignored. Valid values are:

3D Polyline

Polyline

MS_DWG_ONE_BLOCK_FOR_DUP_CELLS Creates one block definition for all type-2 cells that are found to be the same. Valid values are ON (or no value) or OFF.
MS_DWG_OVERLAY_FOR_REFERENCES Creates overlays for reference attachments (no live nesting). Valid values are ON (or no value) or OFF.
MS_DWG_PATTERN_CLASS Sets elements of pattern class to “Pattern” layer, “Defpoints” layer, element's own layer, invisible, or omits them. Valid values are:

Save To “Pattern” Layer

Save To “Defpoints” Layer

Save

Save As Invisible

Omit

MS_DWG_PFACE_MESH_ANGLE Sets an angular tolerance for polyface mesh conversion. Valid value is a real value in degrees between 0 and 90.
MS_DWG_PLANARPOLYLINES Converts a planar line string to a 2D or 3D polyline. A planar line string has all its vertices lined up to form a unique plane. They do not have to be on an orthogonal plane; they can be on any plane in space. Valid values are:

3D Polyline

Polyline

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

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_SAVE Saves rendering light sources. Valid values are ON (or no value) or OFF.
MS_DWG_RENDER_MATERIAL_SAVE Saves rendering materials. Valid values are ON (or no value) or OFF.
MS_DWG_SAVE_DIMENSION_SETTINGS Saves active dimension settings, such as the one listed as Style-none in dimension style dialog. Valid values are ON (or no value) or OFF.
MS_DWG_SAVE_FILE_SETTINGS Saves file settings such that non-DWG settings can round-trip back. Valid values are ON (or no value) or OFF.
MS_DWG_SAVE_FRONTBACK_CLIPS Saves front-back clippings. Valid values are ON (or no value) or OFF.
MS_DWG_SAVE_REFERENCE_PATH Indicates whether/how to save paths for reference attachments. Valid values are:

When saving to same directory

Relative to Master File

Never

MS_DWG_SAVE_UNITS Sets the file units to be saved. Valid values are:

Master Units

Sub Units

Arch./Engineering

a unit defined in file units.def

MS_DWG_SCALE_BLOCKS Scales the block definitions. Valid values are ON (or no value) or OFF.
MS_DWG_SHEETBACKGROUND_COLOR Sets the background color for sheet models. Valid values are Red, Green, Blue, where each of these color values is an integer between 0 and 255.
MS_DWG_SHX_OUTPUT_PATH Sets the path to place converted SHX files. Valid value is a path or folder name.
MS_DWG_SOURCEVIEWGROUP Used to specify a view group name, rather than using the active view group, to save the level display on/off status per view to DWG's global layer display. Because DWG does not support per-view level display, if multiple view groups (for example, the default design model and sheet models) use different per-view level display, only one can be saved as the global layer display for all models.

When this configuration variable is not set, the active view group determines the global layer display status. When it is set with a valid view group name, that view group determines the global layer display status. When it is set with an invalid view group name, the first view group that points to a sheet model in the file determines the global layer display status. This can be useful if you are saving files in a batch, and each file has only one sheet model which is not always the active model.

This configuration variable takes effect only if MS_DWG_LEVEL_DISPLAY is set.

MS_DWG_TEXTSTYLE_NAME_TEMPLATE Sets a text string template to convert text style name. Valid value is a text string that may contain a place holder %s for the font name.
MS_DWG_VERSION Sets DWG version to be saved. Valid values are 11, 12,13, 14, 2000, 2000i, 2002, 2004, 2005, 2006, 2007, 2008, 2009.
MS_DWG_VPORT_LAYER_FROM_CLIP Sets the layer of viewport entity from the clipping element.

Viewport entities are represented as reference attachments in the product – the viewport level is extracted from the reference attachment. If no level is set for the reference attachment then by default the viewport is assigned to layer 0 . However, if this variable is set and a clip element is present, then the viewport layer is extracted from the clip element.

MS_DWG_VPORT_MAP_LOCATE_OFF_TO_LOCKED If set, the Display locked status of a viewport entity is mapped to the Locate setting of the reference attachments that represent this viewport. In this case, a viewport with Display locked off will have Locate turned off – and changing the Locate status of the reference attachment will change the Display Locked status of the viewport.
MS_DWG_VPFREEZE Sets the Viewport Freeze per View Level Display option.
  • 0 - Viewports & Global layers
  • 1 - Viewports Only
  • 2 - Force Global Layer display
MS_DWGINSERTLAYER Specifies the layer to which normal (unshared) cells and reference attachments are assigned when saving the open DGN file in DWG format. If this configuration variable is not defined, layer 0 is used. Valid values are ON (or no value) and OFF.
MS_DWGSAVEAPPLICATIONDATA Linkage data and type 66 application elements can be saved from DGN to DWG. If set, the applications are stored as XRECORDS and the linkages as XDATA. Valid values are ON (or no value) and OFF. The default is off.
MS_DXF_PRECISION Sets the number of decimal places for real numbers when saving file to DXF. Valid value is an integer number between 1 and 16.