3D Point Symbols: Difference between revisions

From Maria GDK Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 51: Line 51:
| '''Symbology'''
| '''Symbology'''
| Which symbol standard to use for the symbol. See [[Track_style_categories/Symbol#Symbology|here]] for full description
| Which symbol standard to use for the symbol. See [[Track_style_categories/Symbol#Symbology|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.
|}
|}



Revision as of 17:24, 16 April 2024

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.