Presentation Mapping

Presentation Mapping is used to adjust the output XGL and EIWM properties such as materials and colours, or to segment the input model to be included in the XGL rendition. Using Presentation mapping extension in the main Transform Configuration file is optional.

The following example shows all sections of presentation mapping configuration with description of available features. Presentation Mapping contains three sections: Materials, Colours and Segments.

Section with Materials Mapping

This section is used to map the material used in the model in AIM Dashboard. These values can then be used with the 3D Materials functionality in AIM Dashboard, for example, to highlight or hide all objects in the model that have the same material value. The syntax allows you to map any attribute to any toMaterial value.

Example:

<materials>
<material fromAttribute="ClassId" fromValue="Wall" toMaterial="Walls"/>
<material fromAttribute="ClassId" fromValue="OPENINGELEMENT" toMaterial="OPENINGS"/>
<material fromAttribute="ClassId" fromValue="DOOR" toMaterial="DOORS"/>
<material fromAttribute="ClassId" fromValue="WINDOW" toMaterial="WINDOWS"/>
</materials>

Section with Colours Mapping

The section is used to model colors in the AIM Dashboard. The syntax contains two abilities to map colours: fromAttribute and fromColour. It is possible to map colours from any attribute value or specific colour attribute value to a toColour attribute.

Example:

<colours>
<colour fromAttribute="Name" fromValue="P100" toColour="green"/>

<colour fromAttribute="ClassId" fromValue="PART" toColour="#008000"/>

<colour fromAttribute="autocad color index" fromValue="71" toColour="red"/>

<colour fromColour="magenta" toColour="130,100,130"/>

<colour fromColour="#455050" toColour="blue"/>

<colour fromColour="255,10,0" toColour="#F3F3F3"/>

</colours>

The fromColour method maps the input colour to a new colour. You can use three methods of colouring:

• RGB, for example, 128, 0, 128.

• Known colours (HTML colour standard), for example, Red.

• HTML hexadecimal: #E3D3D3.

• Wildcard "*" in fromColour attribute to map all colours not affected by previous colour mapping items.

• AutoCAD Color Index (ACI) mapping colours can be specified in fromColour attribute in format ACI<colourIndex>, for example,

  fromColour="ACI170".

Section with Segmentation of Data:

This section is used to segment the model to produce a subset or subsets of graphical objects into XGL files. You can segment a model in four ways:

• According to any attribute value:

  This segments the model according to any attribute value. For example, fromValue="*" fromAttribute="Pressure"' generates a model that contained only the objects with a Pressure attribute of any value.

• According to extents of the geometric model (min and max points and additional includeParts attributes):

  This segments the model by its extents represented by two points max and min. The includeParts="true" (or false) attribute determines whether objects that cross this border are included. By default, the attribute value is false.

• According to any association via three types of attributes:

  • fromAssociation: The value provides the associated object's name.

  • fromTargetAttribute: The value provides the associated object's attribute name.

  • fromTargetValue: The value provides the associated object's attribute value.

• When an object is not handled by any segment node:

  <segment toSuffix="<nameOfSuffixForModel>" /> handles all graphical objects not handled by any of the previously selected segments.

  Note: If this segment method is used first, then it exports the complete model. If it is used as the last segment method, then it exports the remainder of objects not handled by any other segment node.

• Segment the output file into pieces up to a given size in MB using following syntax:

  <segment
  maxOutputSize="100"
  outputType="xgl"
  separator="_"
  suffixNumberFormat="DDD"
  />

  • maxOutputSize is required and specifies the maximum output size in MB.

  • outputType is required and must be set as ‘xgl’.

  • separator is optional, it represents a text string to be inserted between the main name and the numbered suffix. Use characters that are valid for file names in your operating system.

  • suffixNumberFormat is optional. It formats the numbering representation at the end of the file name. Defines how many decimal places are always displayed. Only ‘D’ characters allowed.

Example:

<segments>

<segment toSuffix="" />

<segment fromAttribute="#MODEL_NAME#" fromValue="*" to="[#MODEL_NAME#]" />

<segment fromAttribute="ClassId" fromValue="*" toSuffix="" />

<segment fromAttribute="ClassId" fromValue="WALLSTANDARDCASE" toSuffix="_Only_WALLSTANDARDCASE" />

<segment min="2333.223,0.232,100000" max="50000,1000,200000" toSuffix="_SegmentA" />

<segment fromAssociation="IsPartof" fromTargetAttribute="Name" fromTargetValue="Level 1" toSuffix="SegmentB" />

<segment min="50000,1000,200000" max="150000,11000,250000" includeParts="true" toSuffix="_SegmentC" />

<segment maxOutputSize="100" outputType="xgl" separator="_" suffixNumberFormat="DDD"/>

</segments>

Limitations: The segmentation size is relative to XGL output, so if the XGL Loader configuration is set to ZGL, then each output file will be a compressed version of that XGL content and their sizes will be much less than maxOutputSize.

Example of segmented output with no separator and suffixNumberFormat:

Building1.xgl

Building2.xgl

Building3.xgl

Example of segmented output with separator=" " and suffixNumberFormat="DDD":

Building_001.xgl

Building_002.xgl

Building_003.xgl

You can name the segment by using attributes:

• to:

  For example, to="[#MODEL_NAME#]" - Sets the segment to value of attribute ‘#MODEL_NAME#’.

• toSuffix:

  For example, toSuffix="_seg1" - Adds suffix to current name. For example, if input model is ‘house’ then segment name will be ‘house_seg1’.