FontSymbol

Description

The FontSymbol element defines a style for a font symbol.

Context

Table 1 lists the elements that can contain, or be contained by, a FontSymbol element.

Table 1. Context
Contained by	Element	Contains
NamedStyle or PointStyle	FontSymbol	(empty)

Attributes

Table 2 lists the attributes of a FontSymbol element.

Table 2. Attributes
Attribute	Description
id	A unique identifier for the element.
name	A descriptive name for the element.
text	A one-character string value specifying the symbol character to use. If the `family` attribute is set to the name of a TrueType font, set this attribute to the character for the font symbol. If the `family` attribute is set to `MapInfo 3.0 Compatible` or `MapInfo Symbols`, refer to the set of symbols and symbol codes shown in MapInfo 3.0 Symbol Codes.
family	One of the following: A string value specifying the name of a TrueType symbol font (for example, "WingDings"). The string value `MapInfo 3.0 Compatible` or `MapInfo Symbols`, specifying the symbols shown in MapInfo 3.0 Symbol Codes. The `family` attribute is optional. The default value is `arial`.
size	A floating-point value specifying the size of the symbol. The `size` attribute is optional. The default value is `12`.
size-unit	A reference to a length in the mapinfo codespace, which specifies the unit of measurement used for the `size` attribute. The `size-unit` attribute is optional. The default value is `mapinfo:length pt`.
stroke	A string value specifying the color of the symbol. The value can be any valid CSS color. (See http://www.w3.org/TR/REC-CSS1#color-units.) The `stroke` attribute is optional. The default value is `black`.
stroke-opacity	A floating-point value from 0 to 1 specifying the opacity of the symbol. A value of 0 means that the symbol is totally transparent. A value of 1 means that the symbol is totally opaque. A value of 0.5 means that the symbol is 50% translucent. The `stroke-opacity` attribute is optional. The default value is 1.
font-style	An enumeration value specifying the font style. The possible values are: `normal` `italic` `oblique` The `font-style` attribute is optional. The default value is `normal`.
effect	A string value specifying the color of the text effect provided by the `effect-type` attribute. The value can be any valid CSS color. (See http://www.w3.org/TR/REC-CSS1#color-units.) The `effect` attribute is optional. The default value is `none`.
effect-opacity	A floating-point value from 0 to 1 specifying the opacity of the text effect. A value of 0 means that the effect is totally transparent. A value of 1 means that the effect is totally opaque. A value of 0.5 means that the effect is 50% translucent. The `effect-opacity` attribute is optional. The default value is 1.
effect-type	An enumeration value specifying the text effect type. The possible values are: `box` `halo` `glyph-outline` `none` The `effect-type` attribute is optional. The default value is `none`.
font-weight	An enumeration value specifying the font weight. The possible values are: `normal` `bold` `100` `200` `300` `400` `500` `600` `700` `800` `900` Note: `normal` is equivalent to `200`; `bold` is equivalent to `400`. The `font-weight` attribute is optional. The default value is `normal`.
text-decoration	A string value specifying the text decoration. The value must have the following pattern: a choice of one or more of (`underline` \| `line-through`) separated by a single space or the single value `none`. Examples: `line-through underline`, `underline`, `none`. The `text-decoration` attribute is optional. The default value is `none`.
text-case	An enumeration value specifying the text case. The possible values are: `upper` `lower` `default` Note: `default` means 'retain the current case'. The `text-case` attribute is optional. The default value is `default`.
shadow	A boolean value (`true` or `false`) specifying whether to have a drop-shadow drawn behind the symbol. A value of `false` (the default) specifies no drop-shadow. The `shadow` attribute is optional. The default value is `false`.
expand	A boolean value (`true` or `false`) specifying whether a space character should be inserted between each pair of visible characters in the text string. The `expand` attribute is optional. The default value is `false`.
angle	A floating-point value specifying the rotation angle of the symbol.
angle-unit	A string value specifying the unit of measurement used for the `angle` attribute.

Examples

This example specifies an 18-point red push-pin symbol from the MapInfo 3.0 Symbols set.

Note that the text attribute is set to C, which is decimal code 67 in the UTF-8 encoding, and the family attribute is set to MapInfo Symbols, which specifies the MapInfo 3.0 Symbols set. In the MapInfo 3.0 Symbols set, code 67 specifies a push-pin symbol.

<?xml version="1.0" encoding="UTF-8"?>
<NamedStyle
    version="MXP_WorkSpace_1_5"
    xmlns="http://www.mapinfo.com/mxp">
    <FontSymbol
        size="18"
        size-unit="mapinfo:length pt"
        stroke="red"
        stroke-opacity="1"
        text="C"
        family="MapInfo Symbols"/>
</NamedStyle>

This example specifies a 14-point blue star symbol from the MapInfo 3.0 Symbols set.

Note that the text attribute is set to #, which is decimal code 35 in the UTF-8 encoding, and the family attribute is set to MapInfo Symbols, which specifies the MapInfo 3.0 Symbols set. In the MapInfo 3.0 Symbols set, code 35 specifies a star symbol.

<?xml version="1.0" encoding="UTF-8"?>
<NamedStyle
    version="MXP_WorkSpace_1_5"
    xmlns="http://www.mapinfo.com/mxp">
    <FontSymbol
        size="14"
        size-unit="mapinfo:length pt"
        stroke="blue"
        stroke-opacity="1"
        text="#"
        family="MapInfo Symbols"/>
</NamedStyle>