3D Point Symbols

From Maria GDK Wiki
Revision as of 17:25, 16 April 2024 by Ths (talk | contribs)
Jump to navigation Jump to search

3D Point symbols can be attached to both tracks and draw object points in 3D. They can be rendered as simple billboard Icons, as 3D models, optionally with text labels or a combination of these.

These options are controlled through the Styling engine in a styling category called `3DModel`. The following is an example of such as style:

<stylecategory name="TrackSymbol">
    <style>

      <compositeitem name="3D">
        <valueitem name="ClampToGround" value="true"/>
      </compositeitem>

      <compositeitem name="Icon">
        <valueitem name="SymbolKeyField" value="symbol.2525code"/>
        <valueitem name="Symbology" value="MilStd2525"/>
        <valueitem name="ElevationOffset" value="50.0"/>
        <valueitem name="Opacity" value="0.5"/>
      </compositeitem>

      <compositeitem name="3DModel">
        <valueitem name="ModelId" value="huge_duck" />
        <valueitem name="ModelScale" value="2.0" />
        <compositeitem name="GroundLine">
          <valueitem name="Color" value="255,255,255,255"/>
        </compositeitem>
        <compositeitem name="TextLabel">
          <valueitem name="FontName" value="Arial Black"/>
          <valueitem name="FontSize" value="18.0"/>
          <valueitem name="Color" value="255,255,255,255"/>
          <valueitem name="OutlineColor" value="0,0,0,255"/>
          <valueitem name="OutlineThickness" value="2"/>
          <valueitem name="Background" value="128,127,127,127"/>
          <compositeitem name="LabelText1">
            <valueitem name="Fields" value="name,ais.name"/>
          </compositeitem>
        </compositeitem>
      </compositeitem>
      ....
   </stylecategory>

Styling the Icon

The 3D Icon is styled similarly to the *CoreSymbol* item, but with some 3D specific value items:

Name Description
SymbolKeyField Controls which data field to use for setting the symbol ID.
Symbology Which symbol standard to use for the symbol. See here for full description
SymbologyField Use this field in the data to determine which symbology to use. Setting Symbology explicitly will always override.
ElevationOffset Place all 3D symbols this many meters above the terrain.
Opacity Transparency of the 3D Icon. Note that this does not affect either the text label or 3D model, if specified.