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—These tags manage the display of the advanced callout and include the text background color, background color, callout snapping and tolerance, shadow on the callout box, and margins.
- Text placement—These tags manage the placement of the text within the callout.
- Content—These tags contain the callout content for each element.
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.
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.
 |
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 |
Background
The Background tag is used to set the general background properties for the advanced callout element.
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 |
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.
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. |
|
|
|
Truncated |
The percentage of the callout that will be reduced to a simple leader line. |
0–100 |
Shadow
The Shadow tag is used to set properties for the shadow on the advanced callout element.
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 |
Margins
The Margins tag is used to set the margins inside the advanced callout element.
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 |
Symbol
The Symbol element attributes manage the placement of the symbol element in the advanced callout element.
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>  Tip: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> Tip: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.  Note:Only used with callout symbol. |
<Symbol><Arrowhead Size = '4'><CLR Red='0' Green='0' Blue='255'></CLR></Arrowhead></Symbol> Tip:You can achieve a null color if you use <CLR Red="-1" Green="-1" Blue="-1"></CLR>. |
|
|
Size |
Size of arrowhead. |
Double |
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.
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.
Top
The Top element attributes manage the placement of the top text element in the advanced callout element.
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. |
|
|
|
SplitOffset |
If there is a split, the amount of offset to increase/decrease the split. |
Double |
|
|
HAlign |
The horizontal alignment of the text. |
|
|
|
VAlign |
The vertical alignment of the text. |
|
|
TextHOffset | Position of the text relative to the top edge. | Double | |
TextVOffset | Position of the text relative to the top edge. | Double |
Bottom
The Bottom element attributes manage the placement of the bottom element in the advanced callout element.
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. |
|
|
|
SplitOffset |
If there is a split amount of offset to increase/decrease the split. |
Double |
|
|
HAlign |
The horizontal alignment of the text. |
|
|
|
VAlign |
The vertical alignment of the text. |
|
|
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 |
Middle
The Middle element attributes manage the placement of the middle element in the advanced callout element.
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. |
| |
|
SplitOffset |
If there is a split, the amount of offset to increase/decrease the split. |
Double | |
|
HAlign |
The horizontal alignment of the text. |
|
|
|
VAlign |
The vertical alignment of the text. |
|
|
TextHOffset | Position of the text relative to the middle. | Double | |
TextVOffset | Position of the text relative to the middle. | Double |
Left
The Left element attributes manage the placement of the left element in the advanced callout element.
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. |
|
|
|
SplitOffset |
If there is a split, amount of offset to increase/decrease the split. |
Double |
|
|
HAlign |
The horizontal alignment of the text. |
|
|
|
VAlign |
The vertical alignment of the text. |
|
|
TextHOffset | Position of the text relative to the left. | Double | |
TextVOffset | Position of the text relative to the left. | Double |
Right
The Right element attributes manage the placement of the right element in the advanced callout element.
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. |
|
|
|
SplitOffset |
If there is a split, amount of offset to increase/decrease the split. |
Double |
|
|
HAlign |
The horizontal alignment of the text. |
|
|
|
VAlign |
The vertical alignment of the text. |
|
|
TextHOffset | Position of the text relative to the right. | Double | |
TextVOffset | Position of the text relative to the right. | Double |
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.
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 |
Floating
The Floating element attributes manage the placement of the floating element in the advanced callout element.
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 |
Content tags
The content tags contain the text that appears in the elements.
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. Note: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> |