Advanced callout/multiple text element annotation parameters (Aviation)

The parameters listed here are used to create advanced annotation. The parameters listed include subparameters that are needed inside the XML tag to format the custom annotation. The subparameters are in the MultipleTextElement tag, which is a container for all of the properties for the advanced callout elements.

The subparameters can be divided into the following categories and are explained in greater detail below.

Display properties tags

The display properties manage the appearance of the callout container. This includes properties such as the text background color, the background color for the callout, display properties within the chart, the shadow on the callout, and the margins. The diagram below shows the tags and their specific settings. The tags are the green boxes, while the attributes are the yellow ones. Settings for the individual attributes are in blue boxes.

Display properties for advanced callouts

The sections below describe the individual tags and their attributes.

TextBackground

The TextBackground tag is used to set background properties for the text in the advanced callout element.

TextBackground tag and attribute

It has one attribute, Units, and is described in the table below.

Parameter

Description

Values

XML tag

TextBackground

Tag used to set properties of different parts of background element.

<TextBackground Units='Points'></TextBackground>

Units

Units for all the values provided.

Points, Inches, Centimeters, Millimeters

Advanced callout/multiple text element annotation parameters

Background

The Background tag is used to set the general background properties for the advanced callout element.

Background tag and attribute

It has one attribute, Roundness, and is described in the table below.

Parameter

Description

Values

XML tag

Background

Tag used to set the background properties of element.

<Background Roundness = '10'></Background>

Roundness

Controls the roundness of the annotation background.

0–50

Advanced callout/multiple text element annotation parameters

Callout

The Callout tag is used to set properties for the callout properties of the element, such as the way it appears inside the advanced callout element.

Callout tag and attributes

It has three attributes, Tolerance, Snap, and Truncated, and is described in the table below.

Parameter

Description

Values

XML tag

Callout

Tag used to set the callout properties of element.

<Callout Tolerance='10.0' Snap='True' Truncated='0'></Callout>

Tolerance

Minimum distance from the source feature to show a callout.

Double

Snap

If set to True, callout will draw from the nearest corner, or else it can draw from the nearest edge.

  • True
  • False

Truncated

The percentage of the callout that will be reduced to a simple leader line.

0–100

Advanced callout/multiple text element annotation parameters

Shadow

The Shadow tag is used to set properties for the shadow on the advanced callout element.

Shadow tag and attributes

It has two attributes, HorizontalOffset and VerticalOffset, and is described in the table below.

Parameter

Description

Values

XML tag

Shadow

Tag used to set the shadow properties of element.

<Shadow VerticalOffset = '0' HorizontalOffset = '0'></Shadow>

Horizontal Offset

Amount of offset in horizontal direction from the actual symbol.

Double

Vertical Offset

Amount of offset in vertical direction from the actual symbol.

Double

Advanced callout/multiple text element annotation parameters

Margins

The Margins tag is used to set the margins inside the advanced callout element.

Margins tag and attributes

It has four attributes—Top, Bottom, Left, and Right—and is described in the table below.

Parameter

Description

Values

XML tag

Margins

Tag used to set the margins of the element.

<Margins Top='2.0' Bottom='2.0' Left='2.0' Right='2.0'></Margins>

Top

Margin on the top side.

Double

Bottom

Margin on the bottom side.

Double

Left

Margin on the left side.

Double

Right

Margin on the right side.

Double

Advanced callout/multiple text element annotation parameters

Symbol

The Symbol element attributes manage the placement of the symbol element in the advanced callout element.

Symbol element attributes

This element has several attributes that control the outline, fill, and arrowhead. Each attribute is described in the table below.

Parameter

Description

Values

XML tag

Symbol

Tag used to set the properties of the symbol.

Outline

Outline of the symbol.

<Symbol><Outline Width='0.2'><CLR Red='0' Green='0' Blue='87'></CLR></Outline></Symbol>

TipTip:

You can achieve a null color if you use <CLR Red="-1" Green="-1" Blue="-1"></CLR>.

Width

Width and color to modify the appearance of the symbol.

Double

Fill

If symbol has a fill color, set it here.

<Symbol><Fill><CLR Red='0' Green='0' Blue='87'></CLR></Fill></Symbol>

TipTip:

You can achieve a null color if you use <CLR Red="-1" Green="-1" Blue="-1"></CLR>.

Arrowhead

This draws the arrowhead at the end of the callout with the given size and color.

NoteNote:

Only used with callout symbol.

<Symbol><Arrowhead Size = '4'><CLR Red='0' Green='0' Blue='255'></CLR></Arrowhead></Symbol>

TipTip:

You can achieve a null color if you use <CLR Red="-1" Green="-1" Blue="-1"></CLR>.

Size

Size of arrowhead.

Double

Text placement parameters for advanced callouts

Text placement tags

The text placement tags control the way the text is aligned within and around the callout. The top, bottom, middle, left, right, VMC, and floating elements can all be customized in terms of the position of the element relative to the top edge, split offset, horizontal and vertical alignment, and horizontal and vertical offset. The diagram below illustrates the text placement tags and their settings. The tags are in the green and yellow boxes, while the related settings are in blue boxes.

Text placement properties

The sections below further explain the different parts of the ElementPlacement tag, which is used to set the placement of all the text elements in the advanced callout element. It contains information about placement of the top, middle, bottom, left, and right elements; the VMC element; the floating element; and the symbol.

Text placement samples

Top

The Top element attributes manage the placement of the top text element in the advanced callout element.

Top element attributes

This element has several attributes that control the style, offset, horizontal and vertical alignment, and horizontal and vertical text offset. Each attribute is described in the table below.

Parameter

Description

Values

XML tag

Top

Placement properties of the Top element.

<ElementPlacement><Top Style='Outside' SplitOffset='0' HAlign='Center' VAlign='Baseline' TextHOffset='0' TextVOffset='0'></Top></ElementPlacement>

Style

Position of top element relative to the top edge.

  • Center
  • Edge
  • Outside
  • Box

SplitOffset

If there is a split, the amount of offset to increase/decrease the split.

Double

HAlign

The horizontal alignment of the text.

  • Left
  • Right
  • Center
  • Full

VAlign

The vertical alignment of the text.

  • Top
  • Center
  • Baseline
  • Bottom

TextHOffset

Position of the text relative to the top edge.

Double

TextVOffset

Position of the text relative to the top edge.

Double

Text placement parameters for advanced callouts

Bottom

The Bottom element attributes manage the placement of the bottom element in the advanced callout element.

Bottom element attributes

This element has several attributes that control the style, offset, horizontal and vertical alignment, and horizontal and vertical text offset. Each attribute is described in the table below.

Parameter

Description

Values

XML tag

Bottom

Placement properties of the Bottom element.

<ElementPlacement><Bottom Style='Edge' SplitOffset='0' HAlign='Center' VAlign='Baseline' TextHOffset='0' TextVOffset='0'></Bottom</ElementPlacement>

Style

Position of top element relative to the top edge.

  • Center
  • Edge
  • Outside
  • Box

SplitOffset

If there is a split amount of offset to increase/decrease the split.

Double

HAlign

The horizontal alignment of the text.

  • Left
  • Right
  • Center
  • Full

VAlign

The vertical alignment of the text.

  • Top
  • Center
  • Baseline
  • Bottom

TextHOffset

Position of the text relative to the bottom edge.

Double

TextVOffset

Position of the text relative to the bottom edge.

Double

Size

Size of arrowhead.

Double

Text placement parameters for advanced callouts

Middle

The Middle element attributes manage the placement of the middle element in the advanced callout element.

Middle element attributes

This element has several attributes that control the style, offset, horizontal and vertical alignment, and horizontal and vertical text offset. Each attribute is described in the table below.

Parameter

Description

Values

XML tag

Middle

Placement properties of the Middle element.

<ElementPlacement> <Middle Style='Edge' SplitOffset='0' HAlign='Center' VAlign='Baseline' TextHOffset='0' TextVOffset='0'></Middle></ElementPlacement>

Style

Position of top element relative to the top edge.

  • Center
  • Edge
  • Outside
  • Box

SplitOffset

If there is a split, the amount of offset to increase/decrease the split.

Double

HAlign

The horizontal alignment of the text.

  • Left
  • Right
  • Center
  • Full

VAlign

The vertical alignment of the text.

  • Top
  • Center
  • Baseline
  • Bottom

TextHOffset

Position of the text relative to the middle.

Double

TextVOffset

Position of the text relative to the middle.

Double

Text placement parameters for advanced callouts

Left

The Left element attributes manage the placement of the left element in the advanced callout element.

Left element attributes

This element has several attributes that control the style, offset, horizontal and vertical alignment, and horizontal and vertical text offset. Each attribute is described in the table below.

Parameter

Description

Values

XML tag

Left

Placement properties of the Left element.

<ElementPlacement><Left Style='Top' SplitOffset='2.0' HAlign='Center' VAlign='Baseline' TextHOffset='0' TextVOffset='0'></Left></ElementPlacement>

Style

Position of the top element relative to top edge.

  • Center
  • Top
  • Bottom

SplitOffset

If there is a split, amount of offset to increase/decrease the split.

Double

HAlign

The horizontal alignment of the text.

  • Left
  • Right
  • Center
  • Full

VAlign

The vertical alignment of the text.

  • Top
  • Center
  • Baseline
  • Bottom

TextHOffset

Position of the text relative to the left.

Double

TextVOffset

Position of the text relative to the left.

Double

Text placement parameters for advanced callouts

Right

The Right element attributes manage the placement of the right element in the advanced callout element.

Right element attributes

This element has several attributes that control the style, offset, horizontal and vertical alignment, and horizontal and vertical text offset. Each attribute is described in the table below.

Parameter

Description

Values

XML tag

Right

Placement properties of Right element.

<ElementPlacement><Right Style='Center' SplitOffset='0' HAlign='Center' VAlign='Baseline' TextHOffset='0' TextVOffset='0'></Right></ElementPlacement>

Style

Position of the top element relative to the top edge.

  • Center
  • Top
  • Bottom

SplitOffset

If there is a split, amount of offset to increase/decrease the split.

Double

HAlign

The horizontal alignment of the text.

  • Left
  • Right
  • Center
  • Full

VAlign

The vertical alignment of the text.

  • Top
  • Center
  • Baseline
  • Bottom

TextHOffset

Position of the text relative to the right.

Double

TextVOffset

Position of the text relative to the right.

Double

Text placement parameters for advanced callouts

VMC

The VMC element attributes manage the placement of the VMC element in the advanced callout element. This element can only be placed inside the Middle text element.

VMC element attributes

This element has attributes that control the horizontal and vertical text offset. Each attribute is described in the table below.

Parameter

Description

Values

XML tag

VMC

Placement properties of the VMC element.

<ElementPlacement><VMC TextHOffset='0' TextVOffset='0'></VMC></ElementPlacement>

TextHOffset

Position of the text relative to the top edge.

Double

TextVOffset

Position of the text relative to the top edge.

Double

Text placement parameters for advanced callouts

Floating

The Floating element attributes manage the placement of the floating element in the advanced callout element.

Floating element attributes

This element has attributes that control horizontal and vertical text offset. Each attribute is described in the table below.

Parameter

Description

Values

XML tag

Floating

Placement properties of the Floating element.

<ElementPlacement><Floating TextHoffset='0' TextVOffset='0'></Floating></ElementPlacement>

TextHOffset

Position of the text relative to the top edge.

Double

TextVOffset

Position of the text relative to the top edge.

Double

Text placement parameters for advanced callouts

Content tags

The content tags contain the text that appears in the elements.

Content tags

The table below contains detailed descriptions of each tag.

Parameter

Description

XML tag

TopTextElement

Contains the text to be displayed in TopTextElement.

<TopTextElement>Top</TopTextElement>

MiddleTextElement

Contains the text to be displayed in MiddleTextElement.

<MiddleTextElement>Middle</MiddleTextElement>

BottomTextElement

Contains the text to be displayed in BottomTextElement.

<BottomTextElement>Bottom</BottomTextElement>

LeftTextElement

Contains the text to be displayed in LeftTextElement.

<LeftTextElement>Left</LeftTextElement>

RightTextElement

Contains the text to be displayed in RightTextElement.

<RightTextElement>Right</RightTextElement>

VMC

Contains the text to be displayed in the VMC text element.

NoteNote:

The PLTS Aeronautical VMC font must be used if you want to create stacked Morse code characters.

<VMC><FNT Name='PLTS Aeronautical VMC'>VMC</FNT></VMC>

FloatingTextElement

Contains the text to be displayed below BottomTextElement.

<FloatingTextElement>Floating</FloatingTextElement>

Content parameters for advanced callouts
12/22/2014