Vr Mapping

ON-LINE REFERENCE DOCUMENTATION

CARDINAL SYSTEMS, LLC

904-439-2525

www.cardinalsystems.net

MST OUT (MstOut)

Type: Translator

Overview

VrOne translates files to and from Microstation using a neutral file. This allows both programs to read and write map data using their internal libraries. This results in a more flexible and accurate translation.

When translating from VrOne to Microstation the MstOut application is used to translate VrOne vector data to an Mst neutral file. The MDL (Microstation Development Language) MstIn program is used in Microstation to read the Mst neutral file and create a design file.

When translating from Microstation to VrOne, the MDL (Microstation Development Language) MstOut program used to translate Microstation vector data to an Mst neutral file. The VrOne application MstIn is used to translate Mst neutral file into the current VrOne file.

The Microstation MstIn and MstOut software must be downloaded from the Cardinal Systems web page and installed in Microstation. Please see “MSTIN and MSTOUT Microstation MDL programs” for more information.

Detailed Description

The MST format was defined by Cardinal Systems to allow accurate translations between VrOne and Microstation. MST files may be read into Microstation using the VrIn MDL program supplied by Cardinal Systems. The MST file format is ASCII based, and supports all VrOne entity types and their equivalent Microstation entity types. The MST format is only used to transfer to and from Microstation, if you need to convert to other programs, please look at the DxfIn and DxfOut translators.

The MstOut translator was designed to give the user precise control over all translation options. There are two main features that give MstOut this capability:

1	Entity translation parameters may be defined on a layer-by-layer basis, allowing a great deal of control over the translation process.
2	Translation parameters may be specified with wildcards, allowing default translation parameters for a group of entities, but also more detailed parameters that override the defaults for certain entities. For example, you can specify that all lines on all layers be translated with a weight of 2, but any line on layer 100 be translated with a weight of 1.

While the MST format was designed to make translation to Microstation as accurate as possible, there are some basic differences between Microstation and VrOne entities that present some problems when translating. The following sections will give an overview of how each VrOne entity is translated to Microstation. Detailed descriptions of each entities translation parameters will be given after the overview.

Symbols

Symbols may be translated to Microstation Normal or Shared Cells. At a global level, you can specify if new Cell definitions will be created from VrOne symbol definitions, if Normal or Shared cells will be used, and an optional cell library to be attached when translating into Microstation. For any combination of Layer and Symbol Name, you can specify the Microstation Cell name, level, color, weight, and scale factor, whether the symbol should be exploded into separate entities or placed as a single entity, and if the symbol should be translated to a Microstation symbol text font character instead of a Cell. For example, all symbols named CIRCLE on Layer 105 can be translated to Microstation Cells named “CIRC” on Level 5.

Lines

Lines may be translated to Microstation Arcs, Lines, Line Strings, Curves, and Complex Chains. At a global level, you can specify an optional pattern library to be attached when translating into Microstation. For any combination of Layer, Line Mode, Line Font, and Line Width, you can specify the Microstation level, color, weight, style number, custom style name, pattern name, whether the line (if fonted) should be exploded into separate entities or placed as a single entity. For example, all VrOne splined lines on Layer 250, with a font of “TREEL”, and a width of 2 can be translated to Microstation lines on Level 45, with a custom linestyle of “{ Tree Line }”, and a weight of 1.

Text

Text entities are translated to Microstation text elements. All VrOne text justifications except “Decimal” are translated accurately to Microstation. Text with Decimal point justification are translated with a Microstation justification of Center/Bottom, and spaces are added to the beginning or end of the text string to allow the decimal point to align approximately with the insertion point. For any combination of Layer and Text Font, you can specify the Microstation font, level, color, weight, and height. For example, all VrOne text entities with font “CI” (Complex Italic) can be translated to Microstation text elements with font 2 (Fancy). Default font mappings are used if no specific translation exists for a font (see “Auto Cross Reference Tables” for details).

Because of the many options offered by Mst Out, you should communicate with your client to discuss the options and determine the best translation method to suit their needs. Time should be spent familiarizing yourself with the options offered and test translations should be done to Microstation to view the translation results. Mst Out can translate map data using very basic translation parameters, or advanced translation options may be used to produce a readable and usable map for your client.

This documentation will point out the advantages and disadvantages to many of the translation options.

Microstation is a registered trademark of Bentley Systems, Inc.

Available Key-ins

Key-in	Description	Range
PARFIL=	Load parameter file	MstOut parameter file name (.mso)
RUN	Run MstOut

Load Parameters	Record Parameters	Reset Parameters
Edit Parameters	Cross Reference Lines	Cross Reference Symbols
Cross Reference Text	Translate	Quick Translation
Translation Hints	Auto Cross-Reference Tables

MST Out

Load Parameters

Loads previously recorded MST Out (.mso) parameter file.

Record Parameters

Records current translation parameters to a MST Out (.mso) parameter file.

Reset Parameters

Initializes translation parameters to default values. NOTE: Current translation parameters will be lost.

Edit Parameters

Allows editing of general translation parameters.

Mst file name

File name to write Microstation translated data to. If this file exists, it will be overwritten. An .mst extension is added to the filename if no extension is specified.

Workspaces to consider

When translating VrOne data to Microstation this parameter defines the workspaces to use. Options are “Current only” or “All open”. When “All open” is used all open workspaces will be translated into a single MST file.

Translate each workspace to a separate file?

If set to “Yes”, then each workspace will be translated to a separate .mst file. Each .mst file will have the same name as the workspace.

Translate entities that are not cross referenced?

If set to “Yes”, then all entities will be translated, even if they do not match any entries in the cross reference tables. A note will be made in the mst.err file for any entities that are translated without having a match in the cross reference tables.

Omit Layers

Allows a set of layers to be omitted from the translation. All entities that reside on these layers will not be translated, even if the layers are turned on.

Auto Cross reference colors?

If set to “Yes”, then VrOne pen colors will automatically be mapped to the appropriate color in Microstation, unless a cross reference is defined that specifies a specific color. See “Auto Cross Reference Color Mode” for details.

Auto Cross Reference Color Mode

Determines how colors are determined if Auto Cross reference colors is set to “Yes”. The options are “Find closest color in Mst color table” or “Replace colors in Mst color table for exact match”.

If “Find closest color in Mst color table” is selected, then a search will be done on the current Microstation color table to determine which RGB color matches closest to the VrOne RGB screen color that was in affect when the MstOut translation was ran. RGB color comparisons are done by first converting all RGB values into HSV (Hue, Saturation, Value) values, and comparing those converted values. The hue component of the HSV is given the highest priority. Comparing HSV values results in more desirable colors in terms of what the human eye expects to see.

If “Replace colors in Mst color table for exact match” is selected, then the first 70 colors in the current Microstation color table will be assigned the exact VrOne RGB screen values that were in affect when the MstOut translation was ran. This option will guarantee that the design file display colors exactly match the VrOne display colors.

Auto Cross reference fonts?

If set to “Yes”, then some VrOne fonts will automatically be mapped to appropriate fonts in Microstation, unless a cross-reference is defined that specifies a specific font. See “Auto Cross-Reference Settings” for details.

Global cell scale factor

The scale factor for cells will be multiplied by this amount before being written to the .mst file. The scale factor in the cross reference will always be applied to the symbol radius first.

Create cells from VrOne Symbols?

If set to “Yes”, then new cell definitions will be created in Microstation from the VrOne Symbol definitions. If a cell definition already exists in Microstation, then it will NOT be overridden. How the cells are created is controlled by the “Cell mode” parameter.

Cell mode

May be one of the following options:

Normal	Normal cells will be placed in Microstation. If “Create cells from VrOne Symbols” is on, then cells are created in the currently attached cell library for each VrOne Symbol definition, and a cell library name should be specified in the “Cell Library” parameter.
Shared	Shared cells will be placed in Microstation. If “Create cells from VrOne Symbols” is on, then a shared cell definition is created in the current design file for each VrOne Symbol definition. Please see the Microstation documentation for more information about Shared cells.

Notes on using “Shared”:

Since Microstation Cells may be created with a scale it may be necessary to apply a scale factor to VrOne symbols.
The “Cross Reference Symbols” menu allows the cross-referencing of VrOne symbol names to Microstation Cell names and the application of scale factors.

Cell Library (Assumes .cel)

Specifies the cell library to attach in Microstation when creating or placing Cells. Only applies when “Cell mode” is set to “Normal”. This parameter is not always necessary if the Microstation design file already has a cell library attached and patterning is not being used. If patterning is being used and “Cell mode” is set to “Normal”, then this needs to be specified. This is necessary, because the VrIn translator must switch back and forth between the Pattern Library and the Cell Library, which will not work if

a Cell Library is not specified. A .cel extension is added to the filename, do not include an extension.

Pattern Library (Assumes .cel)

Specifies the pattern library to attach in Microstation when placing patterned lines. This applies to lines that have been cross-referenced using the “Pattern Library” setting. This parameter may not be necessary if the Microstation design file already has a pattern library attached and “Cell mode” is not set to “Normal”. If “Cell mode” is set to “Normal”, and patterning is being used, then this parameter needs to be specified. This is necessary, because the VrIn translator must switch back and forth between the Pattern Library and the Cell Library, which will not work if a Pattern Library is not specified. A .cel extension is added to the filename, do not include an extension.

Use log file?

The log file will be written with the same name and location as the current parameter file with a postfix of .log.

Append to log file?

If a log file exists, set this on to append log information to the file. Set this off to replace the log file each time.

Cross Reference Lines

This dialog defines the settings for the cross-referencing of VrOne lines to Microstation lines. Lines with any combination of Layer, Mode, Font, and Width may be translated differently, or wildcards may be used to apply cross-reference settings to a group of lines. For example, you can have all lines with a width of 5 translate to Microstation lines with a weight of 2. Or you can have all lines on Layer 10 with a font name of “TREEL” translate to a Microstation lines on level 2 with a custom line style of “{ Tree Line}”.

For example, the cross-reference parameters displayed on the following dialog box will translate according to these criteria:

By default, all lines will be translated to Microstation lines with the color 2 assigned. However, if a line is on Layer 102, is splined, and has a font name of “TREEL”, then it will be translated to Microstation level 2, and will be assigned the custom linestyle name of “{ Tree Line }”.

VrOne Search Parameters

This section of the dialog box defines the search criteria for one cross-reference entry. The parameters in this section are defined as follows:

Name	Possible Values	Wildcard - Description	Description
VrOne Layer	-1,1-10001	-1 - Indicates that lines on all layers will match this cross-reference.
VrOne Line Mode	All, Normal, Spline	All - Indicates that normal and spline lines will match this cross-reference
VrOne Line Font	All, “Font Name”	All - Indicates that lines with any font name will match this cross-reference	.
VrOne Line Width	-1,0-256	-1 - Indicates that lines with any width will match this cross-reference.

Microstation Output Parameters

This section of the dialog box defines the output settings for one cross-reference entry. The parameters in this section are defined as follows:

Name	Possible Values	Wildcard - Description	Description
Explode Line Font	Yes, No	N/A	If “Yes”, then matching lines will be “exploded” when placed into Microstation. This means that individual elements will be placed to make the line in Microstation look exactly like the fonted line in VrOne. A copy of the non-exploded line will also be placed using the “Patterned” display class. The individual elements are placed using the “Pattern Component” display class. This allows the Microstation “patterns” view attribute to work correctly with these lines. NOTE: Using custom linestyles is preferred, as this option creates large files with elements that are hard to manipulate.
Shape Mode	None, Normal, Complex	N/A	If "None", then Microstation shapes will not be used. If “Normal”, then VrOne lines that are closed, will be placed as Shapes in Microstation. If a line has too many points to be placed as a standard Shape, then it will be placed as a Complex Shape. If "Complex", then all closed VrOne lines will be placed as Complex shapes, even if they have fewer than maximum allowed line points.
Level	-1, V7 = 1-63. V8 = 64 character name.	-1 - Indicates that the level should be the same as the original VrOne layer.	Indicates which Microstation level to assign to lines that match this cross-reference.
Line Color	-1, 0-254	-1 - Indicates that the color should be the same as the original VrOne color.	Indicates which Microstation color to assign to lines that match this cross-reference.
Line Weight	-1, 0-15	-1 - Indicates that the weight should be the same as the original VrOne width. If the VrOne width is greater than 15, then the weight will be 15.	Indicates which Microstation weight to assign to lines that match this cross-reference.
Line Style	0-7	N/A	Indicates which Microstation line style number to assign to lines that match this cross-reference. This is ignored if a line style name or pattern name is entered.
Line Style Name	64 character name	Same - Indicates that the style name should be the same as the original VrOne font name.	Indicates which Microstation custom line style name to assign to lines that match this cross-reference. If the custom line style does not exist in Microstation, then a solid line will be placed.
Pattern Name	V7 = 6 character name V8 = 64 character name	N/A	Indicates which Microstation pattern to assign to lines that match this cross-reference. If the pattern does not exist in Microstation, then a solid line will be placed. NOTE: A pattern library should be specified in the “Edit Parameters” dialog box if this option is used.
Line Scale	-1, Value > 0.0	-1 – Indicates that the line scale should be 1.0	Indicates what scale factor to use for lines that match this cross-reference. NOTE: This only applies if Line Style Name or Pattern Name is specified.

Cross Reference Symbols

This dialog defines the settings for the cross-referencing of VrOne symbol to Microstation cells or symbol fonts characters. Symbols with any combination of Layer and Symbol name may be translated differently, or wildcards may be used to apply cross-reference settings to a group of Symbols.

For example, the cross-reference parameters displayed on the following dialog box will translate according to these criteria:

All symbols named “TREE” on all Layers will be translated to Microstation Cells with the name “TR”, with level equal to the VrOne Layer, Color equal to the VrOne Pen Color, and Scale equal to the VrOne Symbol radius.

All symbols named “METER” on all Layers will be translated to Microstation Cells with the name “MTR”, with level equal to 10, Color equal to the VrOne Pen Color, and Scale equal to 10.0

All symbols named “X” on all Layer 501, will be translated to Microstation Text elements using font library 102, font character “K”, with level equal to the VrOne Layer, Color equal to the VrOne Pen Color, and scale (text height) equal to 20.0.

VrOne Search Parameters

This section of the dialog box defines the search criteria for one cross-reference entry. The parameters in this section are defined as follows:

Name	Possible Values	Wildcard - Description	Description
VrOne Layer	-1,1-10001	-1 - Indicates that symbols on all layers will match this cross-reference.
VrOne Symbol	Symbol Name	All - Indicates that all symbol names will match this cross-reference

Microstation Output Parameters

This section of the dialog box defines the output settings for one cross-reference entry. The parameters in this section are defined as follows:

Name	Possible Values	Wildcard - Description	Description
Place Point	Yes, No	N/A	If “Yes”, then a Microstation "point" (0 length line) will be placed at each symbol location. The other parameters will be ignored except for Level, Color, and Weight.
Explode Symbol	Yes, No	N/A	If “Yes”, then matching symbols will be “exploded” when placed into Microstation. This means that individual elements will be placed to make the symbol in Microstation look exactly like the symbol in VrOne. NOTE: This option is not recommended as it creates large files with elements that are hard to manipulate.
Cell	V7 = 6 character name V8 = 64 character name	Blank – If left blank, the VrOne symbol name will be used. If reading into V7, then only the first six characters will be recognized.	This can be any valid Microstation cell name. If “Create Cells from VrOne Symbols” option is set to “Yes”, then a cell will be created using this name if it does not already exist in Microstation.
Level	-1, V7 = 1-63. V8 = 64 character name.	-1 - Indicates that the level should be the same as the original VrOne layer. If the VrOne layers is over 63, then the Level will be 63.	Indicates which Microstation level to assign to cells that match this cross-reference.
Line Color	-1, 0-254	-1 - Indicates that the color should be the same as the original VrOne color.	Indicates which Microstation color to assign to cells that match this cross-reference.
Line Weight	0-15	N/A	Indicates which Microstation weight to assign to cells that match this cross-reference.
Scale	-1, Value > 0.0	-1 – Indicates that the cell scale should be the same as the VrOne symbol radius.	Indicates what scale factor to use for cells that match this cross-reference.
Scale Operator	=,*,+	N/A	Indicates how to apply the Scale value. If “=”, then the cell scale will be set to the Scale value. If “*”, then the cell scale will be set to the symbol radius multiplied by the Scale value. If “+”, then the cell scale will be set to the symbol radius added to the Scale value.
Font	1-999	0 – Do not use	Indicates which Microstation font to use for cells that match this cross-reference. This option is useful if you want to use Microstation symbol fonts instead of cells. If this parameter is anything other than 0, then a cell will not be placed for each symbol, instead, a single character text element will be placed.
Text Char	Single character	N/A	If a Font number is specified, then this is the character that will be used when placing the text element.

Cross Reference Text

This dialog defines the settings for the cross-referencing of VrOne Text entities to Microstation text elements. Text with any combination of Layer and Font name may be translated differently, or wildcards may be used to apply cross-reference settings to a group of Text entities.

For example, the cross-reference parameters displayed on the following dialog box will translate according to these criteria:

All text on all Layers with a font of “CI” will be translated to Microstation text with a font of 7, with level equal to the VrOne Layer, Color equal to the VrOne Pen Color, and Height equal to the VrOne Text height.

All text on all Layer 10 with a font of “STANDARD” will be translated to Microstation text with a font of 2, with level equal to the VrOne Layer, Color equal to 20, and Height equal to the VrOne Text height.

All text on all Layer 12 will be translated as exploded entities, with level equal to 50, Color equal to 10, and Height equal to the VrOne Text height.

VrOne Search Parameters

This section of the dialog box defines the search criteria for one cross-reference entry. The parameters in this section are defined as follows:

Name	Possible Values	Wildcard - Description	Description
VrOne Layer	-1, 1-10001	-1 - Indicates that lines on all layers will match this cross-reference.
VrOne Text Font	All, “Font Name”	All - Indicates that all font names will match this cross-reference

Microstation Output Parameters

This section of the dialog box defines the output settings for one cross-reference entry. The parameters in this section are defined as follows:

Name	Possible Values	Wildcard - Description	Description
Explode Text	Yes, No		If set to “Yes”, then text entities will be explodes and translated to Microstation as line elements.
Font	-1, 0-999	-1 – Indicates that the font number should be 0 or should use the default font mapping setting if “Auto Cross-Reference Fonts” is set to “Yes”.	Indicates which Microstation font to assign to texts that match this cross-reference.
Level	-1, 1-63	Same - Indicates that the level should be the same as the original VrOne layer. If the VrOne layers is over 63, then the Level will be 63.	Indicates which Microstation level to assign to texts that match this cross-reference.
Color	-1, 0-254	-1 - Indicates that the color should be the same as the original VrOne color.	Indicates which Microstation color to assign to texts that match this cross-reference.
Weight	0-15	N/A	Indicates which Microstation weight to assign to texts that match this cross-reference.
Height	-1, Value > 0.0	-1 – Indicates that the height should be the same as the VrOne Text height.	Indicates what height to use for texts that match this cross-reference.

Add Vr Entities to Xref

Creates entries in the cross reference tables for all VrOne entities in the currently opened workspaces. A detailed listing of entities added is displayed.

Import MSTIN Cross References

Imports cross reference tables from an MSTIN parameter file. Because the MSTIN and MSTOUT are designed with different style cross-reference tables, this option should only be used as a starting point to creating full translation cross-references. You will be asked to select an existing MSTIN parameter file, then you will then be given the option to clear all existing cross reference table before importing the MSTIN cross references.

After answering this dialog, the MSTIN parameters will be imported. After an import, you should always check each cross-reference table to verify that the cross-reference items were imported as expected.

Translate

Translates the current VrOne file(s) using the current translation parameters into a MST file. The MST may then be read into Microstation using the VrIn MDL program.

Help

Starts the browser and displays the current help document.

Quit

Quits Mst Out and gives an option to save the current parameters.

Quick Translation

The following may be done to translate VrOne file(s) to an MST file in the fewest possible steps. The result will be a translation in which all lines will be translated with custom style names equal to the VrOne font names. Symbols will be translated as Normal Cells, with cell names equal to the VrOne symbol names.

Reset Parameters
Define the “Mst file name” in “Edit Parameters”
Translate

Translation Hints

Speak to your client about the available features to best translate data to their system.
Learn about the various options for translating symbols and line fonts.
First define cross-references using wildcards to cover the broadest range of cases, then add detailed cross-reference entries to handle the exceptions.
Test different options by translating files into Microstation.

Auto Cross-Reference Tables

This section shows how Text Fonts are translated when the “Auto Cross Reference Fonts” option is set to “Yes”.

VrOne Font	Microstation Font
CI	23 (Italics)
CR	2 (Fancy)
CS	0 (Standard)
DR	2 (Fancy)
GE	0 (Standard)
GG	0 (Standard)
GI	23 (Italics)
STANDARD	0 (Standard)
SR	0 (Standard)
SS	0 (Standard)
IT	23 (Italics)
TR	2 (Fancy)