Map Properties & Grid Configuration

Note: this is one of a series of topics outlining the syntax expected in a Studio Mapper System Configuration File.

Warning: updating the system configuration file will affect all Studio Mapper projects with which it is associated. Changes should only be made if you are familiar with the XML format, and changes should be tested in an appropriate environment before rolling out to a live system.

Syntax

In the table below, each XML "tag" refers to an enclosed XML node that may be subordinate to a "parent" node or have one or more child "elements".

Tag Req? Description Parent(s) Element(s)
<MapTypes> No A container for <MapType> elements <MapConfiguration> <MapType>
<WireframeMapTypes> No A container for <WireframeMapType> elements. <MapConfiguration> <WireframeMapType>
<MapType> No An element defining a map type. <MapTypes>

<Name>

<Sides>

<ReportTemplate>

<WireframeMapType>   An element defining a wireframe map type. <WireframeMapTypes>

<Name>

<MapGridFormat>
<Name> Yes The display name of a map type, as displayed in the Add Map dialog. <MapType> None
<Sides> Yes

Face map types only. A single value or comma delimited list containing references to a map side. All specified sides will be created for subsequent new maps of the same <Name>.

Valid values for Face maps:

  • FRONT

  • LEFT

  • RIGHT

  • BOTTOM

  • TOP

Valid values for 3D Image maps:

 <MapType> None
<ReportTemplate> No The full name of a Studio plot template (plus .dmtpl extension) used for mapping reports for the nominated <MapType> or <LevelMapType>.

<MapType>

<LevelMapType>

None
<UseAutomaticOverlayMode> No

TRUE or FALSE.

If set to TRUE, 3D projections are used for all reports generated involving the target MapType.

If set to FALSE, legacy 2D projections are used in output reports.

<MapType>

<LevelMapType>

None
<MapGridFormat> No A container for a <Template> definition of a 3D display grid for map faces.

<MapType>

<WireframeMapType>

<LevelMapType>

<Template>

<Origin>
<Template> No Defines the name of a grid template in a .dmtpl file accessible to the Mapper project. <MapGridFormat> None
<Origin> No

The position of the local origin point of the section or surface grid applied to face or level map sections, or a wireframe map hull. Valid values are:

  • top left

  • top centre

  • top right

  • left

  • centre

  • right

  • bottom left

  • bottom centre

  • bottom right

 <MapGridFormat> None
<Colour> No The colour (in RGB syntax) used for the map section grid. <MapGridFormat> None

Examples

This example defines two map types in the Add Map screen for a face mapping type, each using a separate plot template for reporting:

</MappingConfiguration>

<MapTypes>

<MapType>

<Name>Face</Name>

<Sides>FRONT</Sides>

<ReportTemplate>FrontTemplate.dmtpl</ReportTemplate>

</MapType>

 

<MapType>

<Name>Full Heading</Name>

<Sides>FRONT,LEFT,RIGHT,BOTTOM,TOP</Sides>

<ReportTemplate>AllSidesTemplate.dmtpl</ReportTemplate>

</MapType>

</MapTypes>

</MappingConfiguration>

The following example defines two map types for a level mapping type. As above, each has its own reporting template but uses the same grid template ("LevelGrid") but shown in different colours.

</MappingConfiguration>

<LevelMapTypes>

<LevelMapType>

<Name>LEVEL1-500</Name>

<ReportTemplate>Lvl.dmtpl</ReportTemplate>

<MapGridFormat>

<Origin>centre</Origin>

<Template>LevelGrid</Template>

<Colour>0,255,0</Colour>

</MapGridFormat>

</LevelMapType>

 

<LevelMapType>

<Name>LEVEL1-1000</Name>

<ReportTemplate>Lvl1000.dmtpl</ReportTemplate>

<MapGridFormat>

<Origin>centre</Origin>

<Template>LevelGrid</Template>

<Colour>255,0,0</Colour>

</MapGridFormat>

</LevelMapType>

</LevelMapTypes>

</MappingConfiguration>