Skip to content

Configuration Variables

Asketyll edited this page Jul 2, 2026 · 7 revisions

Configuration Variables

Every ARES variable is a MicroStation configuration variable. Set them in MicroStation's configuration, or via the feature options dialogs and the System & Config commands.

Auto Lengths

Variable Default Purpose
ARES_Auto_Lengths True Master switch for automatic length insertion.
ARES_Update_Lengths True Recompute the length when the linked geometry changes.
ARES_Length_Triggers (Xx_m) Trigger pattern(s); several separated by |.
ARES_Length_Trigger_ID Xx_ Placeholder replaced by the value; must be in every trigger.
ARES_Length_Round 1 Decimal places for the inserted length.
ARES_Update_Color_With_Length True Sync the text color to the linked geometry.
ARES_Only_Color_Update True Color-only mode (no length change).
ARES_Update_ATLASCellLabel True Rebuild ATLAS label cell geometry after a text edit.
ARES_Cell_Is_Label_Name ETI076|ETI01E|… Cell names treated as ATLAS labels (| separated).

Zoning

Variable Default Purpose
ARES_Zoning_Level (empty) Source level(s) to buffer (| separated).
ARES_Zoning_Distance 2.0 Buffer distance (m) for RunZoning.
ARES_Zoning_Output_Level ARES_Zoning Output level for zones (also read by Zone Export).
ARES_Zoning_Output_Color 5 Output color index.
ARES_Zoning_Output_Style 0 Output line style.
ARES_Zoning_Output_Weight 4 Output line weight.

Outline

Tight per-element zoning variant (RunOutline / EditOutlineOptions) with its own option set.

Variable Default Purpose
ARES_Outline_Level (empty) Source level(s) for RunOutline (| separated).
ARES_Outline_Distance 0.2 Buffer distance (m) for RunOutline.
ARES_Outline_Output_Level ARES_Outline Output level for outlines.
ARES_Outline_Output_Color 5 Output color index.
ARES_Outline_Output_Style 0 Output line style.
ARES_Outline_Output_Weight 4 Output line weight.

Zone Export

Variable Default Purpose
ARES_Zone_Export_Level (empty) Restrict measured elements to these level(s) (| separated); empty = all levels; non-existent names ignored.
ARES_Zone_Export_Group_By Style Grouping key: Style, Level, or Color.
ARES_Zone_Export_Round 2 Decimal places for exported lengths.
ARES_Zone_Export_Use_Dialog True Save dialog (True) vs auto timestamped path (False).
ARES_Zone_Export_Sheet_Name Export Worksheet tab name.
ARES_Zone_Export_Excel_Visible False Leave the workbook open/visible (True) vs silent (False).

Region Split

Variable Default Purpose
ARES_RegionSplit_Keep_Original False Keep the original region (True) vs delete it (False).
ARES_RegionSplit_Collinear_Tol 0.000001 Geometric epsilon; drives the cut-knife half-width.
ARES_RegionSplit_Stroke_Tol 0.01 Max chordal deviation when stroking curved boundaries.

Custom properties

Variable Default Purpose
ARES_Custom_Property_List Commune|Coupe_Type |-separated list of ARES custom-property names (each name is both the ItemType and the property in the "ARES" DGNLib). Add your own after authoring the matching ItemType + value list in the DGNLib.
ARES_Auto_Properties True Master switch for auto-attaching custom properties to elements as they are created / modified.
ARES_Property_Rules (empty) Rules level[:type]=prop|prop ; … mapping elements (by level, optional element type) to the properties to auto-attach. Example: WALLS=Commune|Coupe_Type ; DOORS:Cell=Commune.

Update & Language

Variable Default Purpose
ARES_Update_Mute False Silence the automatic startup update check.
ARES_Update_Ignore_Version (empty) Release the automatic check skips.
ARES_Language (empty) Forced UI language; empty = MicroStation CONNECTUSER_LANGUAGE.

General / automatic (no key-in)

Variable Default Purpose
ARES_Round 2 Default decimal rounding used by length computations.
ARES_Bulk_Threshold 10 Change events within the interval that trigger auto-suspend of change tracking.
ARES_Bulk_Interval 1000 Bulk-detection time window (ms).
ARES_Unit_testing (sample) Sample variable exercised by the test suite.

Clone this wiki locally