Bentley Systems

User Configuration Variables

The document lists and explains various MicroStation user configuration variables categorized by function, including file saving options like MS_DGNAUTOSAVE for auto-save timing, OLE object display settings such as MS_OLE_RETAIN_CONTROL_SIZE, point cloud color bit depth via MS_POINTCLOUD_LAS_NBIT_COLOR, QuickVision graphics settings like QV_DISABLE_D3D11 and QV_DISABLE_HARDWARE to control Direct3D versions and hardware acceleration, and mentions report output configuration with MS_REPORT_OUTPUT.

This page provides a categorized list of user configuration variables for MicroStation. Many categories refer to separate topics for complete lists of variables. Some variables are described directly below.

File Saving

  • MS_DGNAUTOSAVE: If set to 0 or a negative number, auto-save is disabled for all file types. If set to a positive number, auto-save is enabled for all file types. The specified positive number applies when editing V8 format design files and determines the number of seconds of user inactivity before MicroStation auto-saves.
  • MS_V7BACKUPV8: Automatically creates a backup of a V7 file in the V8 format. If set to true, a file is created in the same directory with the extension .v8.
  • MS_DWGAUTOSAVE: See DWG- and DXF-Related configuration variables.
  • MS_DWGAUTOSAVE_NODIALOG: See DWG- and DXF-Related configuration variables.

OLE

  • MS_OLE_RETAIN_CONTROL_SIZE: If set to 1, the display size of the OLE object is retained. If set to 0 or not set (the default), the OLE object is resized according to the size reported by the OLE server.
  • MS_OLESERVE_EMBED_REFFILES: If set, references are embedded along with the master DGN file.

Point Cloud

  • MS_POINTCLOUD_LAS_NBIT_COLOR: If defined and set to 8, treats color as 8 bits. If set to 16, treats color as 16 bits. If undefined or set to any other value, will try to auto-detect the number of bits per color channel.

QuickVision

  • QV_DISABLE_D3D11: Setting this to 1 forces the system to use Direct3D 9 (D3D9) rather than Direct3D 11 (D3D11). D3D9 is simpler and may work better with some hardware or drivers, but D3D11 is faster and preferable. Try upgrading to the latest driver for your hardware before setting this variable.
  • QV_DISABLE_HARDWARE: Setting this to 1 disables all hardware acceleration. This can be used to circumvent problems with graphics hardware or drivers, but it causes a large performance penalty.

Reports

  • MS_REPORT_OUTPUT: Default output directory where report results will be exported.
  • MS_REPORTTABLE_HIDETOTALSLABEL: If defined, the Totals Row is not displayed. By default, the Totals Row is displayed. If the Summary Row is defined in the Seed File, it is displayed in the Table once placed and the Totals row is not displayed. If the Summary Row is not defined in the Seed file, the Totals Row will be displayed. You can turn the Totals row off by using this variable.

Symbology

  • MS_FONTCONFIGFILE: Specifies the full path of the font configuration file. Default path is $(MS_SYSFONTDIR)/MstnFontConfig.xml.
  • MS_FONTPATH: Path or list of paths that contain RSC, SHX, or TrueType font files.
  • MS_SYMBRSRC: List of symbology resource files — last one in list has highest priority.

System Environment

  • MS_CONFIG: Main MicroStation configuration file — sets up all configuration variables.
  • RSC_COMP: Text string to be inserted at the beginning of the command line by the resource compiler (used to specify where to search for include files).
  • MDL_COMP: Text string to be inserted at the beginning of the command line by the MDL compiler (used to specify where to search for include files).
  • BMAKE_OPT: Command line options for BMAKE. Used to search for bmake include (.mki) files.
  • MS_DEBUGMDLHEAP: If set (to the base name of an MDL application or "ALL"), use extended malloc for debugging.

Tables

  • MS_TABLE_INPUT: Default directory where the Excel workbooks and .csv files that will be used as data sources for tables are stored.

Temp and Backup Files

  • MS_DWG_BACKUP: See DWG- and DXF-related Configuration Variables.
  • MS_NO_DWG_BACKUP: See DWG- and DXF-related Configuration Variables.
  • MS_BACKUP: Default directory for backup files.
  • MS_TMP: Directory for temporary files created and deleted by MicroStation.
  • MS_SCR: Directory for scratch files created by MicroStation.

For other categories such as Cells, Colors, Data Files, Database, Design History, DWG/DXF, Engineering Links, Extensions, Geographic Coordinates, Levels, Macro Recorder, Markup, Operation, Primary Search Paths, Printing, Protection, Raster, Reference, Rendering/Images, Security, Seed Files, Spelling, Standards Checker, Tags, Translation (CGM, IGES, Step), and Uncategorized, refer to their respective documentation topics for a complete list of configuration variables.