CARIS HPD : Portrayal : Paper Chart Marginalia : How Marginalia Works : Marginalia Text
 

Marginalia Text

Two marginalia text files are included with the installation:

• SampleMarginalia-Chart.xml

• SampleMarginalia-INTchart

Text marginalia files can include:

• Text that is set from the file

• Block text from an external file

• Chart attributes

• Cartographic symbols.

A section from SampleMarginalia-Chart is shown below.

<Object Acronym=”$marga”>

  <Filter>

    <AttributeValueIsEqualTo Acronym=”$lckey” Value=”BottomRight”/>

  </Filter>

  <CreateAnnotation Acronym=”$text” HJust=”Right” VJust=”Top” XRefOffset=”2.0” YRefOffset=”-1.5” Angle=”0”>

     <Style Font=”Arial” Colour=”Black” Size=”24” Bold=”False” Italic=”False” Underline=”False”>

      <Attribute MetaDataKey=”CHTNUM” />

    </Style>

  </CreateAnnotation>

 

  <CreateAnnotation Acronym=”$text” HJust=”Right” VJust=”Top” XRefOffset=”-55” YRefOffset=”-1.5” Angle=”0”>

    <Style Font=”Arial” Colour=”Nautical_Purple” Size=”24” Bold=”False” Italic=”False” Underline=”False”>

      <Text>DEPTHS </Text>

    </Style>

    <Style Font=”Arial” Colour=”Nautical_Purple” Size=”18” Bold=”False” Italic=”False” Underline=”False”>

      <Text>IN</Text>

    </Style>

    <Style Font=”Arial” Colour=”Nautical_Purple” Size=”24” Bold=”False” Italic=”False” Underline=”False”>

      <Text> METRES</Text>

    </Style>

  </CreateAnnotation>

</Object>

In this case, a chart number and depth measurement information is added to a single marginalia point. See the following table for a description of tags.

Tags

Description

<Object>

Assign any elements within these tags to the marginalia anchor point.

Acronym: For marginalia, the value is $marga.

<Filter>

Parent tag for filter.

<AttributeValueIsEqualTo/>

Filter for associating marginalia information with an anchor point.

Attributes:

Acronym: The location key ($lckey) attribute is the position of the marginalia anchor point.

Value: The value of $lckey. Eight default values are

• Top

• TopRight

• Right

• BottomRight

• Bottom

• BottomLeft

• Left

• TopLeft

<CreateAnnotation>

Positioning information for the marginalia text.

Attributes:

Acronym: The name assigned to the marginalia feature.

HJust: Horizontal justification (aligned to the offset position): Left, Centre, Right.

VJust: Vertical justification (aligned to the offset position): Top, Centre, Bottom.

XRefOffset: The X offset (in mm) of the text reference point from the anchor point.

YRefOffset: The Y offset (in mm) of the text reference point from the anchor point.

XOffset: The horizontal offset (in mm) of the text from its reference point.

YOffset: The vertical offset (in mm) of the text feature from its reference point.

Angle: The angle of rotation of the text (degrees).

<Style>

Style for marginalia text. This is a child tag of <CreateAnnotation>

Attributes:

Font: Name of the font.

Colour: Colour of font

Size: Font size in points

Bold: True or False

Italic: True or False

Underline: True or False

<Text>

The text for the marginalia annotation. This is a child tag of <Style>

<attribute/>

Chart, panel or sheet attribute values are inserted into a panel border.

Attribute:

Metadatakey: the chart, panel or sheet attribute from which the value is read.