CARIS HPD : Portrayal : Annotations : Annotation File
 

Annotation File

 
Text
Symbol
Fill Patterns

The annotation file (annotationfile.xml) controls what annotations are associated to features and how those annotations are formatted. You can add new annotations or override system annotations. If annotations in the system file are changed in a custom annotation file, the user-defined definition takes precedence over the system file definition.

Custom annotation files must be saved in UTF-8 (Unicode) format.

Annotation files are case-sensitive.

This is an example from the default annotations file for the LIGHTS feature:

<Object Acronym="LIGHTS">

  <Filter>

    <PrimitiveIsEqualTo Primitive="Point"/>

  </Filter>

  <CreateAnnotation Acronym="$ltinf" Description="Light Information" HJust="Left" VJust="Bottom" XOffset="3" YOffset="3">

    <Style Font="Times New Roman" Size="10" Bold="False" Italic="False" Underline="False">

      <Attribute Acronym="LITCHR" Postfix=" " UseAbbreviation="True"/>

      <Attribute Acronym="SIGGRP" Postfix=" "/>

      <Attribute Acronym="SIGPER" Postfix="s " Format="###.#"/>

      <Attribute Acronym="HEIGHT" Postfix="m " Format="###.#" Units="Metres"/>

      <Attribute Acronym="VALNMR" Postfix="M" Format="##.#" Units="Metres"/>

    </Style>

  </CreateAnnotation>

</Object>

This is an example from the default annotations file for ACHARE (anchorage area):

<Object Acronym="ACHARE">

  <Filter>

    <PrimitiveIsEqualTo Primitive="Area"/>

  </Filter>

  <CreateAnnotation Acronym="$achas" Description="ACHARE Symbol" AnnotationType="SYMBOL">

    <SetAttribute Acronym="$SCODE" Value="DLAN"/>

  </CreateAnnotation>

</Object>

The LIGHTS feature is represented by text and the ACHARE feature is represented by a symbol.

You can create an annotation with multiple entries. However, different annotation feature acronyms must be applied. This is an example of an annotation using two entries:

<Object Acronym="RDOCAL">

  <Filter>

    <PrimitiveIsEqualTo Primitive="Point"/>

  </Filter>

  <CreateAnnotation Acronym="$brnam" Description="Berth Name." HJust="Left"

   VJust="Bottom" XOffset="3" YOffset="0">

    <Style Font="Times New Roman" Size="10" Bold="False" Italic="False"

     Underline="False">

      <Attribute Acronym="OBJNAM" Prefix="Nr "/>

    </Style>

  </CreateAnnotation>

  <CreateAnnotation Acronym="$comch" Description="Communication Channel"

   HJust="Left" VJust="Bottom" XOffset="0" YOffset="0">

    <Style Font="Times New Roman" Size="10" Bold="False" Italic="False"

     Underline="False">

      <Attribute Acronym="COMCHA" Prefix="ch "/>

    </Style>

  </CreateAnnotation>

</Object>