CARIS HPD : Portrayal : Drawing Instructions : Graphic Elements : Symbol
 

Symbol

Element

<Symbol>

Description

Symbol by name or reference from the symbol library. The Symbol element is applied to the geometry of the associated feature or dynamic graphic element.

Example

Draw a flare symbol based on the NPL1N feature code.

Rotation is based of the value of flareAngle.

DCLIGHTS.xsl

<xsl:element name="Symbol">

  <xsl:attribute name="name">NPL1N</xsl:attribute>

  <xsl:attribute name="rotation">

    <xsl:value-of select="$flareAngle"/>

  </xsl:attribute>

</xsl:element>

Instruction Set

<InstructionSet priority="290" featureReference="186">

  <Symbol name="NPL1N" rotation="135"/>

  <AnnotationOption label="Light Character" class="ltchar">

    <InitialValues>

      <SetAttribute attribute="txtsiz" value="7"/>

        <SetAttribute attribute="x_dist" value="0.0"/>

        <SetAttribute attribute="y_dist" value="1.0"/>

     </InitialValues>

  </AnnotationOption>

</InstructionSet>

Attributes

Name

Type

Description

name

String

Status: Mandatory

The name/reference to the symbol.

In S-52 style symbol libraries this equates to the symbol file name and name of the symbol in the symbol meta data. In the CARIS symbol file, this is the equivalent of the symbol/feature code.

rotation

Floating Point

Status: Optional

Clockwise rotation bearing in degrees starting with 0 degrees being north, display up or perpendicular to line depending on the rotationCRS.

xOffset

Floating Point

Status: Optional

Offset along the X axis of the xyCRS. The units are defined by xyCRS and xLineUnits. If not defined the feature point or centre is applied.

yOffset

Floating Point

Status: Optional

Offset along the Y axis of the xyCRS. The units are mm at display scale. If not defined the feature point or centre is applied.

xLineUnits

Enumerated

Status: Optional

Three values:

mmdisplay: xOffset is mm at display scale (default).

mGeographic: x is measured in metres on the ground.

percent: xOffset  is a percentage; 0 = beginning, 1= end.

size

Double

Status: Optional

Scale the design size of a symbol so its maximum dimension matches the size specified in mm. Default is design size.

scaleFactor

Double

Status: Optional

Scale the design size of a symbol.  If used in conjunction with the size attribute, the symbol is scaled after the size is applied. The default is 1.0.