SVG 2 – 11 February 2014 TopContentsPreviousNextElementsAttributesProperties

SVG Fonts and this chapter are to be removed. Any wording from this chapter that describes how WOFF support is mandated, or how CSS Fonts functionality like @font-face can be used to reference Web fonts is to be moved, probably into the Text chapter. An informative reference to the SVG-in-OpenType work will probably be added too.

Chapter 21: Fonts

Contents

SVG 2 Requirement: Include explicit support for Web Open Font Format (WOFF).
Resolution: We will mandate WOFF support in SVG 2.
Purpose: To allow access to full OpenType features for internationalisation and advanced typography.
Owner: Chris (no action)
SVG 2 Requirement: Mandate support for SVG Tiny fonts.
Resolution: SVG 2 will mandate support for SVG Tiny fonts support, and SVG Full fonts will be specified in a separate module.
Purpose: Backwards compatibility for deployed content.
Owner: Erik (ACTION-3126), Chris (✓ ACTION-3127)
Note: The "separate module" is now being worked on in the SVG Glyphs for OpenType community group.
SVG 2 Requirement: Reference CSS3 Fonts.
Resolution: SVG 2 will depend on CSS3 Fonts.
Purpose: Alignment with CSS 2.1 and CSS3 for Web font functionality, and to provide access to advanced typographic features of fonts.
Owner: Chris (ACTION-3123)

21.1. Introduction

Reliable delivery of fonts is a requirement for SVG. Designers need to create SVG content with arbitrary fonts and know that the same graphical result will appear when the content is viewed by all end users, even when end users do not have the necessary fonts installed on their computers. This parallels the print world, where the designer uses a given font when authoring a drawing for print, and the graphical content appears exactly the same in the printed version as it appeared on the designer's authoring system.

SVG utilizes the WebFonts facility defined in ([CSS3 Fonts]) as a key mechanism for reliable delivery of font data to end users. In a common scenario, SVG authoring applications generate compressed, subsetted WebFonts for all text elements used by a given SVG document fragment.

One disadvantage to the WebFont facility in the past was that specifications did not require support of particular font formats. The result was that different implementations supported different Web font formats, thereby making it difficult for Web site creators to post a single Web site using WebFonts that worked across all user agents.

SVG 2 mandates support for Web Open Font Format [WOFF], which is now supported in most user agents. Besides enabling compressed, subsetted WebFonts with accompanying metadata for clear licensing, WOFF also benefits from OpenType multilingual features and support for advanced typography. Thus, content authors can author CSS to request discretionary ligatures, swash forms, old-style figures etc. while also ensuring that a font is provided which supports those features.

In SVG 1.1, to provide a common font format for SVG that is guaranteed to be supported by all conforming SVG viewers, SVG provideed a facility to define fonts in SVG. This facility was called SVG fonts. For backwards compatibility, SVG 2 requires support for a subset of SVG Fonts, SVG Tiny Fonts, which has been widely deployed especially for mobile content.

21.2. Describing a font

21.2.1. Overview of font descriptions

A font description provides the bridge between an author's font specification and the font data, which is the data needed to format text and to render the abstract glyphs to which the characters map — the actual scalable outlines or bitmaps. Fonts are referenced by properties, such as the ‘font-family’ property.

Each specified font description is added to the font database and so that it can be used to select the relevant font data. The font description contains descriptors such as the location of the font data on the Web, and characterizations of that font data. The font descriptors are also needed to match the font properties to particular font data. The level of detail of a font description can vary from just the name of the font up to a list of glyph widths.

For more about font descriptions, refer to CSS Fonts Module Level 3. [CSS3FONTS]

21.2.2. Alternative ways for providing a font description

Font descriptions can be specified in either of the following ways:

21.2.3. The ‘font-face’ element

The font-face element corresponds directly to the @font-face facility in CSS3 Fonts ([CSS3FONTS], section 4.1). It can be used to describe the characteristics of any font, SVG font or otherwise.

When used to describe the characteristics of an SVG font contained within the same document, it is recommended that the font-face element be a child of the font element it is describing so that the font element can be self-contained and fully-described. In this case, any font-face-src elements within the font-face element are ignored as it is assumed that the font-face element is describing the characteristics of its parent font element.

font-face
Categories:
None
Content model:
Any number of descriptive elements, script and at most one font-face-src element, in any order.
Attributes:
DOM Interfaces:

Attribute definitions:

font-family = "<string>"
Same syntax and semantics as the font-family descriptor within an @font-face rule.
Animatable: no.
font-style = "all | [ normal | italic | oblique] [, [normal | italic | oblique]]*"
Same syntax and semantics as the font-style descriptor within an @font-face rule. The style of a font. Takes on the same values as the ‘font-style’ property, except that a comma-separated list is permitted.
If the attribute is not specified, the effect is as if a value of 'all' were specified.
Animatable: no.
font-variant = "[normal | small-caps] [,[normal | small-caps]]*"
Same syntax and semantics as the font-variant descriptor within an @font-face rule. Indication of whether this face is the small-caps variant of a font. Takes on the same values as the ‘font-variant’ property, except that a comma-separated list is permitted.
If the attribute is not specified, the effect is as if a value of 'normal' were specified.
Animatable: no.
font-weight = "all | [normal | bold | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900] [, [normal | bold | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900]]*"
Same syntax and semantics as the font-weight descriptor within an @font-face rule.
The weight of a face relative to others in the same font family. Takes on the same values as the ‘font-weight’ property with three exceptions:
  • relative keywords (bolder, lighter) are not permitted
  • a comma-separated list of values is permitted, for fonts that contain multiple weights
  • an additional keyword, 'all', is permitted, which means that the font will match for all possible weights; either because it contains multiple weights, or because that face only has a single weight.
If the attribute is not specified, the effect is as if a value of 'all' were specified.
Animatable: no.
font-stretch = "all | [ normal | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded] [, [ normal | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded] ]*"
Same syntax and semantics as the font-stretch descriptor within an @font-face rule. Indication of the condensed or expanded nature of the face relative to others in the same font family. Takes on the same values as the ‘font-stretch’ property except that:
  • relative keywords (wider, narrower) are not permitted
  • a comma-separated list is permitted
  • the keyword 'all' is permitted
If the attribute is not specified, the effect is as if a value of 'normal' were specified.
Animatable: no.
font-size = "<string>"
Same syntax and semantics as the ‘font-size’ descriptor within an @font-face rule.
Animatable: no.

CSS3 Fonts does not have a font-size descriptor.

unicode-range = "<urange> [, <urange>]*"
Same syntax and semantics as the unicode-range descriptor within an @font-face rule. The range of ISO 10646 characters [UNICODE] possibly covered by the glyphs in the font. Except for any additional information provided in this specification, the normative definition of the attribute is in CSS 2.1 ([CSS21], section 4.5).
If the attribute is not specified, the effect is as if a value of 'U+0-10FFFF' were specified.
Animatable: no.
units-per-em = "<number>"
Same syntax and semantics as the ‘units-per-em’ descriptor within an @font-face rule. The number of coordinate units on the em square, the size of the design grid on which glyphs are laid out.
This value is almost always necessary as nearly every other attribute requires the definition of a design grid.
If the attribute is not specified, the effect is as if a value of '1000' were specified.
Animatable: no.

CSS3 Fonts does not have a units-per-em descriptor.

panose-1 = "[<integer>]{10}"
Same syntax and semantics as the ‘panose-1’ descriptor within an @font-face rule. The Panose-1 number, consisting of ten decimal integers, separated by whitespace. Except for any additional information provided in this specification, the normative definition of the attribute is in CSS2.
If the attribute is not specified, the effect is as if a value of '0 0 0 0 0 0 0 0 0 0' were specified.
Animatable: no.

CSS3 Fonts does not have a panose-1 descriptor.

stemv = "<number>"
Same syntax and semantics as the ‘stemv’ descriptor within an @font-face rule.
Animatable: no.

CSS3 Fonts does not have a stemv descriptor.

stemh = "<number>"
Same syntax and semantics as the ‘stemh’ descriptor within an @font-face rule.
Animatable: no.

CSS3 Fonts does not have a stemh descriptor.

slope = "<number>"
Same syntax and semantics as the ‘slope’ descriptor within an @font-face rule. The vertical stroke angle of the font. Except for any additional information provided in this specification, the normative definition of the attribute is in CSS2.
If the attribute is not specified, the effect is as if a value of '0' were specified.
Animatable: no.

CSS3 Fonts does not have a slope descriptor.

cap-height = "<number>"
Same syntax and semantics as the ‘cap-height’ descriptor within an @font-face rule. The height of uppercase glyphs in the font within the font coordinate system.
Animatable: no.

CSS3 Fonts does not have a cap-height descriptor.

x-height = "<number>"
Same syntax and semantics as the ‘x-height’ descriptor within an @font-face rule. The height of lowercase glyphs in the font within the font coordinate system.
Animatable: no.

CSS3 Fonts does not have an x-height descriptor.

accent-height = "<number>"
The distance from the origin to the top of accent characters, measured by a distance within the font coordinate system.
If the attribute is not specified, the effect is as if the attribute were set to the value of the ascent attribute.
Animatable: no.
ascent = "<number>"
Same syntax and semantics as the ‘ascent’ descriptor within an @font-face rule. The maximum unaccented height of the font within the font coordinate system.
If the attribute is not specified, the effect is as if the attribute were set to the difference between the units-per-em value and the vert-origin-y value for the corresponding font.
Animatable: no.

CSS3 Fonts does not have an ascent descriptor.

descent = "<number>"
Same syntax and semantics as the ‘descent’ descriptor within an @font-face rule. The maximum unaccented depth of the font within the font coordinate system.
If the attribute is not specified, the effect is as if the attribute were set to the vert-origin-y value for the corresponding font.
Animatable: no.

CSS3 Fonts does not have a descent descriptor.

widths = "<string>"
Same syntax and semantics as the ‘widths’ descriptor within an @font-face rule.
Animatable: no.

CSS3 Fonts does not have a widths descriptor.

bbox = "<string>"
Same syntax and semantics as the ‘bbox’ descriptor within an @font-face rule.
Animatable: no.

CSS3 Fonts does not have a bbox descriptor.

ideographic = "<number>"
For horizontally oriented glyph layouts, indicates the alignment coordinate for glyphs to achieve ideographic baseline alignment. The value is an offset in the font coordinate system.
Animatable: no.
alphabetic = "<number>"
Same syntax and semantics as the ‘baseline’ descriptor within an @font-face rule. For horizontally oriented glyph layouts, indicates the alignment coordinate for glyphs to achieve alphabetic baseline alignment. The value is an offset in the font coordinate system.
Animatable: no.

CSS3 Fonts does not have a baseline descriptor.

mathematical = "<number>"
Same syntax and semantics as the ‘mathline’ descriptor within an @font-face rule. For horizontally oriented glyph layouts, indicates the alignment coordinate for glyphs to achieve mathematical baseline alignment. The value is an offset in the font coordinate system.
Animatable: no.

CSS3 Fonts does not have a mathline descriptor.

hanging = "<number>"
For horizontally oriented glyph layouts, indicates the alignment coordinate for glyphs to achieve hanging baseline alignment. The value is an offset in the font coordinate system.
Animatable: no.
v-ideographic = "<number>"
For vertically oriented glyph layouts, indicates the alignment coordinate for glyphs to achieve ideographic baseline alignment. The value is an offset in the font coordinate system relative to the glyph-specific vert-origin-x attribute.
Animatable: no.
v-alphabetic = "<number>"
For vertically oriented glyph layouts, indicates the alignment coordinate for glyphs to achieve alphabetic baseline alignment. The value is an offset in the font coordinate system relative to the glyph-specific vert-origin-x attribute.
Animatable: no.
v-mathematical = "<number>"
For vertically oriented glyph layouts, indicates the alignment coordinate for glyphs to achieve mathematical baseline alignment. The value is an offset in the font coordinate system relative to the glyph-specific vert-origin-x attribute.
Animatable: no.
v-hanging = "<number>"
For vertically oriented glyph layouts, indicates the alignment coordinate for glyphs to achieve hanging baseline alignment. The value is an offset in the font coordinate system relative to the glyph-specific vert-origin-x attribute.
Animatable: no.
underline-position = "<number>"
The ideal position of an underline within the font coordinate system.
Animatable: no.
underline-thickness = "<number>"
The ideal thickness of an underline, expressed as a length within the font coordinate system.
Animatable: no.
strikethrough-position = "<number>"
The ideal position of a strike-through within the font coordinate system.
Animatable: no.
strikethrough-thickness = "<number>"
The ideal thickness of a strike-through, expressed as a length within the font coordinate system.
Animatable: no.
overline-position = "<number>"
The ideal position of an overline within the font coordinate system.
Animatable: no.
overline-thickness = "<number>"
The ideal thickness of an overline, expressed as a length within the font coordinate system.
Animatable: no.

The following elements and attributes correspond to the ‘src’ descriptor within an @font-face rule. Refer to the descriptions of the @font-face rule and 'src' descriptor in the CSS 2.1 specification ([CSS21], sections 4.1 and 4.3.)

21.2.4. The ‘font-face-src’ element

The font-face-src element, together with the font-face-uri and font-face-format elements described in the following sections, correspond to the ‘src’ descriptor within an @font-face rule. (Refer to the descriptions of the @font-face rule and 'src' descriptor in the CSS3 Fonts specification ([CSS3FONTS], sections 4.1 and 4.3.)

A font-face-src element contains font-face-uri and font-face-name elements, which are used for referencing external and local fonts, respectively.

font-face-src
Categories:
None
Content model:
One or more of the following elements, in any order:
    font-face-name, font-face-uri, script
    Attributes:
    DOM Interfaces:

    21.2.5. The ‘font-face-uri’ and ‘font-face-format’ elements

    The font-face-uri element is used within a font-face-src element to reference a font defined inside or outside of the current SVG document.

    When a font-face-uri is referencing an SVG font, then that reference must be to an SVG font element, therefore requiring the use of a fragment identifier [RFC3986]. The referenced font element can be local (i.e., within the same document as the font-face-uri element) or remote (i.e., within a different document).

    font-face-uri
    Categories:
    None
    Content model:
    Any number of the following elements, in any order:
      font-face-format, script
      Attributes:
      DOM Interfaces:

      Attribute definitions:

      xlink:href = "<IRI>"
      The xlink:href attribute specifies the location of the referenced font.
      Animatable: no.

      Child font-face-format elements of a font-face-uri element are used to specify the supported formats of the font referenced by that font-face-uri element. They correspond to entries in a format(…) clause of the ‘src’ descriptor in an @font-face rule.

      font-face-format
      Categories:
      None
      Content model:
      Any number of the following elements, in any order:
        script
        Attributes:
        DOM Interfaces:

        Attribute definitions:

        string = "<anything>"
        The string attribute is a hint to the user agent, and specifies a list of formats that the font referenced by the parent font-face-uri element supports. The syntax of the attribute value is a format string as defined in CSS2, such as 'truetype'. Refer to the description of the 'src' descriptor in CSS2 for details on how the format hint is interpreted.
        Animatable: no.

        CSS3 Fonts does not have format strings.

        21.2.6. The ‘font-face-name’ element

        The font-face-name element is used within a font-face-src element to reference a local font by name. It corresponds to a local(…) clause in an @font-face rule ‘src’ descriptor.

        font-face-name
        Categories:
        None
        Content model:
        Any number of the following elements, in any order:
          script
          Attributes:
          DOM Interfaces:

          Attribute definitions:

          name = "<anything>"
          The name attribute specifies the name of a local font. Unlike the syntax allowed between the parentheses of the local(…) clause in an @font-face rule ‘src’ descriptor, the font name specified in this attribute is not surrounded in single or double quotes. Refer to the description of the 'src' descriptor in CSS3 Fonts for details on how the font name is interpreted ([CSS3FONTS], section 4.3).
          Animatable: no.

          21.3. Overview of SVG fonts

          An SVG font is a font defined using SVG's font element.

          The purpose of SVG fonts is to allow for delivery of glyph outlines in display-only environments. SVG fonts that accompany Web pages must be supported only in browsing and viewing situations. Graphics editing applications or file translation tools must not attempt to convert SVG fonts into system fonts. The intent is that SVG files be interchangeable between two content creators, but not the SVG fonts that might accompany these SVG files. Instead, each content creator will need to license the given font before being able to successfully edit the SVG file. The font-face-name element indicates the name of licensed font to use for editing.

          SVG fonts contain unhinted font outlines. Because of this, on many implementations there will be limitations regarding the quality and legibility of text in small font sizes. For increased quality and legibility in small font sizes, content creators may want to use an alternate font technology, such as fonts that ship with operating systems or an alternate WebFont format.

          Because SVG fonts are expressed using SVG elements and attributes, in some cases the SVG font will take up more space than if the font were expressed in a different WebFont format which was especially designed for compact expression of font data. For the fastest delivery of Web pages, content creators may want to use an alternate font technology.

          A key value of SVG fonts is guaranteed availability in SVG user agents. In some situations, it might be appropriate for an SVG font to be the first choice for rendering some text. In other situations, the SVG font might be an alternate, back-up font in case the first choice font (perhaps a hinted system font) is not available to a given user.

          The characteristics and attributes of SVG fonts correspond closely to the font characteristics and parameters described in the CSS Fonts Modules Level 3 specification [CSS3FONTS]. In this model, various font metrics, such as advance values and baseline locations, and the glyph outlines themselves, are expressed in units that are relative to an abstract square whose height is the intended distance between lines of type in the same type size. This square is called the em square and it is the design grid on which the glyph outlines are defined. The value of the units-per-em attribute on the font-face element specifies how many units the em square is divided into. Common values for other font types are, for example, 250 (Intellifont), 1000 (Type 1) and 2048 (TrueType, TrueType GX and Open-Type). Unlike standard graphics in SVG, where the initial coordinate system has the y-axis pointing downward (see The initial coordinate system), the design grid for SVG fonts, along with the initial coordinate system for the glyphs, has the y-axis pointing upward for consistency with accepted industry practice for many popular font formats.

          SVG fonts and their associated glyphs do not specify bounding box information. Because the glyph outlines are expressed as SVG graphics elements, the implementation has the option to render the glyphs either using standard graphics calls or by using special-purpose font rendering technology, in which case any necessary maximum bounding box and overhang calculations can be performed from analysis of the graphics elements contained within the glyph outlines.

          An SVG font can be either embedded within the same document that uses the font or saved as part of an external resource.

          Here is an example of how you might embed an SVG font inside of an SVG document.

          <?xml version="1.0" standalone="yes"?>
          <svg width="400px" height="300px" version="1.1"
            xmlns = 'http://www.w3.org/2000/svg'>
            <defs>
              <font id="Font1" horiz-adv-x="1000">
                <font-face font-family="Super Sans" font-weight="bold" font-style="normal"
                    units-per-em="1000" cap-height="600" x-height="400"
                    ascent="700" descent="300"
                    alphabetic="0" mathematical="350" ideographic="400" hanging="500">
                  <font-face-src>
                    <font-face-name name="Super Sans Bold"/>
                  </font-face-src>
                </font-face>
                <missing-glyph><path d="M0,0h200v200h-200z"/></missing-glyph>
                <glyph unicode="!" horiz-adv-x="300"><!-- Outline of exclam. pt. glyph --></glyph>
                <glyph unicode="@"><!-- Outline of @ glyph --></glyph>
                <!-- more glyphs -->
              </font>
            </defs>
            <text x="100" y="100" 
                     style="font-family: 'Super Sans', Helvetica, sans-serif;
                            font-weight: bold; font-style: normal">Text 
              using embedded font</text>
          </svg>
          

          Here is an example of how you might use the CSS @font-face facility ([CSS3FONTS], section 4.1) to reference an SVG font which is saved in an external file. First referenced SVG font file:

          <?xml version="1.0" standalone="yes"?>
          <svg width="100%" height="100%" version="1.1"
           xmlns = 'http://www.w3.org/2000/svg'>
            <defs>
              <font id="Font2" horiz-adv-x="1000">
                <font-face font-family="Super Sans" font-weight="normal" font-style="italic"
                    units-per-em="1000" cap-height="600" x-height="400"
                    ascent="700" descent="300"
                    alphabetic="0" mathematical="350" ideographic="400" hanging="500">
                  <font-face-src>
                    <font-face-name name="Super Sans Italic"/>
                  </font-face-src>
                </font-face>
                <missing-glyph><path d="M0,0h200v200h-200z"/></missing-glyph>
                <glyph unicode="!" horiz-adv-x="300"><!-- Outline of exclam. pt. glyph --></glyph>
                <glyph unicode="@"><!-- Outline of @ glyph --></glyph>
                <!-- more glyphs -->
              </font>
            </defs>
          </svg>
          

          The SVG file which uses/references the above SVG font

          <?xml version="1.0" standalone="yes"?>
          <svg width="400px" height="300px" version="1.1"
           xmlns = 'http://www.w3.org/2000/svg'>  
            <defs>
              <style type="text/css">
                @font-face {
                  font-family: 'Super Sans'; 
                  font-weight: normal;
                  font-style: italic;
                  src: url("myfont.svg#Font2") format("svg")
                }
             </style>
            </defs>
            <text x="100" y="100"
                     style="font-family: 'Super Sans'; font-weight:normal;
                            font-style: italic">Text using referenced font</text>
          </svg>
          

          21.4. The ‘font’ element

          The font element defines an SVG font.

          font
          Categories:
          None
          Content model:
          Any number of the following elements, in any order:clipPath, font-face, glyph, hkern, marker, mask, missing-glyph, script, vkern
          Attributes:
          DOM Interfaces:

          Attribute definitions:

          horiz-origin-x = "<number>"
          The X-coordinate in the font coordinate system of the origin of a glyph to be used when drawing horizontally oriented text. (Note that the origin applies to all glyphs in the font.)
          If the attribute is not specified, the effect is as if a value of '0' were specified.
          Animatable: no.
          horiz-origin-y = "<number>"
          The Y-coordinate in the font coordinate system of the origin of a glyph to be used when drawing horizontally oriented text. (Note that the origin applies to all glyphs in the font.)
          If the attribute is not specified, the effect is as if a value of '0' were specified.
          Animatable: no.
          horiz-adv-x = "<number>"
          The default horizontal advance after rendering a glyph in horizontal orientation. Glyph widths are required to be non-negative, even if the glyph is typically rendered right-to-left, as in Hebrew and Arabic scripts.
          Animatable: no.
          vert-origin-x = "<number>"
          The default X-coordinate in the font coordinate system of the origin of a glyph to be used when drawing vertically oriented text.
          If the attribute is not specified, the effect is as if the attribute were set to half of the effective value of attribute horiz-adv-x.
          Animatable: no.
          vert-origin-y = "<number>"
          The default Y-coordinate in the font coordinate system of the origin of a glyph to be used when drawing vertically oriented text.
          If the attribute is not specified, the effect is as if the attribute were set to the position specified by the font's ascent attribute.
          Animatable: no.
          vert-adv-y = "<number>"
          The default vertical advance after rendering a glyph in vertical orientation.
          If the attribute is not specified, the effect is as if a value equivalent of one em were specified (see units-per-em).
          Animatable: no.

          Each font element must have a font-face child element which describes various characteristics of the font.

          21.5. The ‘glyph’ element

          The glyph element defines the graphics for a given glyph. The coordinate system for the glyph is defined by the various attributes in the font element.

          The graphics that make up the glyph can be a single path data specification within the d attribute, arbitrary SVG as content within the glyph, or both. These two alternatives are processed differently (see below).

          glyph
          Categories:
          Container element
          Content model:
          Any number of the following elements, in any order:a, altGlyphDef, clipPath, cursor, filter, font, font-face, foreignObject, image, marker, mask, script, style, switch, text, view
          Attributes:
          DOM Interfaces:

          Attribute definitions:

          unicode = "<string>"
          One or more Unicode characters indicating the sequence of Unicode characters which corresponds to this glyph. If a character is provided, then this glyph corresponds to the given Unicode character. If multiple characters are provided, then this glyph corresponds to the given sequence of Unicode characters. One use of a sequence of characters is ligatures. For example, if unicode="ffl", then the given glyph will be used to render the sequence of characters "f", "f", and "l".

          It is often useful to refer to characters using XML character references expressed in hexadecimal notation or decimal notation. For example, unicode="ffl" could be expressed as XML character references in hexadecimal notation as unicode="&#x66;&#x66;&#x6c;" or in decimal notation as unicode="&#102;&#102;&#108;".

          The unicode attribute contributes to the process for deciding which glyph(s) are used to represent which character(s). See glyph selection rules. If the unicode attribute is not provided for a given glyph, then the only way to use this glyph is via an altGlyph reference.
          Animatable: no.
          glyph-name = "<author-ident> [, <author-ident> ]* "
          A name for the glyph. It is recommended that glyph names be unique within a font. The glyph names can be used in situations where Unicode character numbers do not provide sufficient information to access the correct glyph, such as when there are multiple glyphs per Unicode character. The glyph names can be referenced in kerning definitions.
          Animatable: no.
          d = "path data"
          The definition of the outline of a glyph, using the same syntax as for the d attribute on a path element. See Path data.
          See below for a discussion of this attribute.
          Animatable: no.
          orientation = "h | v"
          Indicates that the given glyph is only to be used for a particular inline-progression-direction (i.e., horizontal or vertical). If the attribute is not specified, then the glyph can be used in all cases (i.e., both horizontal and vertical inline-progression-direction).
          Animatable: no.
          arabic-form = "initial | medial | terminal | isolated"
          For Arabic glyphs, indicates which of the four possible forms this glyph represents.
          Animatable: no.
          lang = "%LanguageCodes;"
          The attribute value is a comma-separated list of language names as defined in BCP 47 [BCP47]. The glyph can be used if the xml:lang attribute exactly matches one of the languages given in the value of this parameter, or if the xml:lang attribute exactly equals a prefix of one of the languages given in the value of this parameter such that the first tag character following the prefix is "-".
          Animatable: no.
          horiz-adv-x = "<number>"
          The horizontal advance after rendering the glyph in horizontal orientation. If the attribute is not specified, the effect is as if the attribute were set to the value of the font's horiz-adv-x attribute.
          Glyph widths are required to be non-negative, even if the glyph is typically rendered right-to-left, as in Hebrew and Arabic scripts.
          Animatable: no.
          vert-origin-x = "<number>"
          The X-coordinate in the font coordinate system of the origin of the glyph to be used when drawing vertically oriented text.
          If the attribute is not specified, the effect is as if the attribute were set to the value of the font's vert-origin-x attribute.
          Animatable: no.
          vert-origin-y = "<number>"
          The Y-coordinate in the font coordinate system of the origin of a glyph to be used when drawing vertically oriented text.
          If the attribute is not specified, the effect is as if the attribute were set to the value of the font's vert-origin-y attribute.
          Animatable: no.
          vert-adv-y = "<number>"
          The vertical advance after rendering a glyph in vertical orientation.
          If the attribute is not specified, the effect is as if the attribute were set to the value of the font's vert-adv-y attribute.
          Animatable: no.

          The graphics for the glyph can be specified using either the d attribute or arbitrary SVG as content within the glyph.

          If the d attribute is specified, then the path data within this attribute is processed as follows:

          If the glyph has child elements, then those child elements are rendered in a manner similar to how the use element renders a referenced symbol. The rendering effect is as if the contents of the referenced glyph element were deeply cloned into a separate non-exposed DOM tree. Because the cloned DOM tree is non-exposed, the SVG DOM does not show the cloned instance.

          For user agents that support Styling with CSS, the conceptual deep cloning of the referenced glyph element into a non-exposed DOM tree also copies any property values resulting from the CSS cascade ([CSS21], chapter 6) on the referenced glyph and its contents, and also applies any property values on the font element. CSS 2.1 selectors can be applied to the original (i.e., referenced) elements because they are part of the formal document structure. CSS 2.1 selectors cannot be applied to the (conceptually) cloned DOM tree because its contents are not part of the formal document structure.

          Property inheritance, however, works as if the referenced glyph had been textually included as a deeply cloned child within the document tree. The referenced glyph inherits properties from the element that contains the characters that correspond to the glyph. The glyph does not inherit properties from the font element's original parents.

          In the generated content, for each instance of a given glyph, a g is created which carries with it all property values resulting from the CSS cascade on the font element for the referenced glyph. Within this g is another g which carries with it all property values resulting from the CSS cascade on the glyph element. The original contents of the glyph element are deep-cloned within the inner g element.

          If the glyph has both a d attribute and child elements, the d attribute is rendered first, and then the child elements.

          In general, the d attribute renders in the same manner as system fonts. For example, a dashed pattern will usually look the same if applied to a system font or to an SVG font which defines its glyphs using the d attribute. Many implementations will be able to render glyphs defined with the d attribute quickly and will be able to use a font cache for further performance gains.

          Defining a glyph by including child elements within the glyph gives greater flexibility but more complexity. Different fill and stroke techniques can be used on different parts of the glyphs. For example, the base of an "i" could be red, and the dot could be blue. This approach has an inherent complexity with units. Any properties specified on a text elements which represents a length, such as the ‘stroke-width’ property, might produce surprising results since the length value will be processed in the coordinate system of the glyph.

          21.6. The ‘missing-glyph’ element

          The missing-glyph element defines the graphics to use if there is an attempt to draw a glyph from a given font and the given glyph has not been defined. The attributes on the missing-glyph element have the same meaning as the corresponding attributes on the glyph element.

          missing-glyph
          Categories:
          Container element
          Content model:
          Any number of the following elements, in any order:a, altGlyphDef, clipPath, cursor, filter, font, font-face, foreignObject, image, marker, mask, script, style, switch, text, view
          Attributes:
          DOM Interfaces:

          21.7. Glyph selection rules

          When determining the glyph(s) to draw a given character sequence, the font element is searched from its first glyph element to its last in logical order to see if the upcoming sequence of Unicode characters to be rendered matches the sequence of Unicode characters specified in the unicode attribute for the given glyph element. The first successful match is used. Thus, the "ffl" ligature needs to be defined in the font before the "f" glyph; otherwise, the "ffl" will never be selected.

          Note that any occurrences of altGlyph take precedence over the above glyph selection rules within an SVG font.

          21.8. The ‘hkern’ and ‘vkern’ elements

          The hkern and vkern elements define kerning pairs for horizontally-oriented and vertically-oriented pairs of glyphs, respectively.

          Kern pairs identify pairs of glyphs within a single font whose inter-glyph spacing is adjusted when the pair of glyphs are rendered next to each other. In addition to the requirement that the pair of glyphs are from the same font, SVG font kerning happens only when the two glyphs correspond to characters which have the same values for properties ‘font-family’, ‘font-size’, ‘font-style’, ‘font-weight’, ‘font-variant’, ‘font-stretch’, ‘font-size-adjust’ and ‘font’.

          An example of a kerning pair are the letters "Va", where the typographic result might look better if the letters "V" and the "a" were rendered slightly closer together.

          Right-to-left and bidirectional text in SVG is laid out in a two-step process, which is described in Relationship with bidirectionality. If SVG fonts are used, before kerning is applied, characters are re-ordered into left-to-right (or top-to-bottom, for vertical text) visual rendering order. Kerning from SVG fonts is then applied on pairs of glyphs which are rendered contiguously. The first glyph in the kerning pair is the left (or top) glyph in visual rendering order. The second glyph in the kerning pair is the right (or bottom) glyph in the pair.

          For convenience to font designers and to minimize file sizes, a single hkern and vkern can define a single kerning adjustment value between one set of glyphs (e.g., a range of Unicode characters) and another set of glyphs (e.g., another range of Unicode characters).

          The hkern element defines kerning pairs and adjustment values in the horizontal advance value when drawing pairs of glyphs which the two glyphs are contiguous and are both rendered horizontally (i.e., side-by-side). The spacing between characters is reduced by the kerning adjustment. (Negative kerning adjustments increase the spacing between characters.)

          The vkern element defines kerning pairs and adjustment values in the vertical advance value when drawing pairs of glyphs together when stacked vertically. The spacing between characters is reduced by the kerning adjustment.

          hkern
          Categories:
          None
          Content model:
          Any number of the following elements, in any order:
            script
            Attributes:
            DOM Interfaces:
            vkern
            Categories:
            None
            Content model:
            Any number of the following elements, in any order:
              script
              Attributes:
              DOM Interfaces:

              Attribute definitions:

              u1 = "[<character> | <urange> ] [, [<character> | <urange>] ]* "
              A sequence (comma-separated) of Unicode characters (refer to the description of the unicode attribute to the glyph element for a description of how to express individual Unicode characters) and/or ranges of Unicode characters (see description of ranges of Unicode characters in CSS2; [CSS3FONTS], section 4.5) which identify a set of possible first glyphs in the kerning pair. If a given Unicode character within the set has multiple corresponding glyph elements (i.e., there are multiple glyph elements with the same unicode attribute value, but different glyph-name values), then all such glyphs are included in the set. Comma is the separator character; thus, to kern a comma, specify the comma as part of a range of Unicode characters or as a glyph name using the g1 attribute. The total set of possible first glyphs in the kerning pair is the union of glyphs specified by the u1 and g1 attributes.
              Animatable: no.
              g1 = "<author-ident> [, <author-ident> ]* "
              A sequence (comma-separated) of glyph names (i.e., values that match glyph-name attributes on glyph elements) which identify a set of possible first glyphs in the kerning pair. All glyphs with the given glyph name are included in the set. The total set of possible first glyphs in the kerning pair is the union of glyphs specified by the u1 and g1 attributes.
              Animatable: no.
              u2 = "[<character> | <urange>] [, [<character> | <urange>] ]* "
              Same as the u1 attribute, except that u2 specifies possible second glyphs in the kerning pair.
              Animatable: no.
              g2 = "<author-ident> [, <author-ident> ]* "
              Same as the g1 attribute, except that g2 specifies possible second glyphs in the kerning pair.
              Animatable: no.
              k = "<number>"
              The amount to decrease the spacing between the two glyphs in the kerning pair. The value is in the font coordinate system. This attribute is required.
              Animatable: no.

              At least one each of u1 or g1 and at least one of u2 or g2 must be provided.

              21.9. DOM interfaces

              21.9.1. Interface SVGFontElement

              The SVGFontElement interface corresponds to the font element.

              Object-oriented access to the attributes of the font element via the SVG DOM is not available.

              interface SVGFontElement : SVGElement {
              };

              21.9.2. Interface SVGGlyphElement

              The SVGGlyphElement interface corresponds to the glyph element.

              Object-oriented access to the attributes of the glyph element via the SVG DOM is not available.

              interface SVGGlyphElement : SVGElement {
              };

              21.9.3. Interface SVGMissingGlyphElement

              The SVGMissingGlyphElement interface corresponds to the missing-glyph element.

              Object-oriented access to the attributes of the missing-glyph element via the SVG DOM is not available.

              interface SVGMissingGlyphElement : SVGElement {
              };

              21.9.4. Interface SVGHKernElement

              The SVGHKernElement interface corresponds to the hkern element.

              Object-oriented access to the attributes of the hkern element via the SVG DOM is not available.

              interface SVGHKernElement : SVGElement {
              };

              21.9.5. Interface SVGVKernElement

              The SVGVKernElement interface corresponds to the vkern element.

              Object-oriented access to the attributes of the vkern element via the SVG DOM is not available.

              interface SVGVKernElement : SVGElement {
              };

              21.9.6. Interface SVGFontFaceElement

              The SVGFontFaceElement interface corresponds to the font-face element.

              Object-oriented access to the attributes of the font-face element via the SVG DOM is not available.

              interface SVGFontFaceElement : SVGElement {
              };

              21.9.7. Interface SVGFontFaceSrcElement

              The SVGFontFaceSrcElement interface corresponds to the font-face-src element.

              Object-oriented access to the attributes of the font-face-src element via the SVG DOM is not available.

              interface SVGFontFaceSrcElement : SVGElement {
              };

              21.9.8. Interface SVGFontFaceUriElement

              The SVGFontFaceUriElement interface corresponds to the font-face-uri element.

              Object-oriented access to the attributes of the font-face-uri element via the SVG DOM is not available.

              interface SVGFontFaceUriElement : SVGElement {
              };

              21.9.9. Interface SVGFontFaceFormatElement

              The SVGFontFaceFormatElement interface corresponds to the font-face-format element.

              Object-oriented access to the attributes of the font-face-format element via the SVG DOM is not available.

              interface SVGFontFaceFormatElement : SVGElement {
              };

              21.9.10. Interface SVGFontFaceNameElement

              The SVGFontFaceNameElement interface corresponds to the font-face-name element.

              Object-oriented access to the attributes of the font-face-name element via the SVG DOM is not available.

              interface SVGFontFaceNameElement : SVGElement {
              };
              SVG 2 – 11 February 2014 TopContentsPreviousNextElementsAttributesProperties