DocumentID: ECMA-376/Part4/2.8.2 Title: ECMA-376, Part4: 2.8.2 Elements Extracted-From: ECMA-376 Office Open XML File Formats, 1st Edition / December 2006 Warning: Coverted to HTML format by a script known to have bugs
The following elements comprise the content of the font table:
This element specifies a set of alternative names which may be used to locate the font specified by the parent element. This set of alternative names is stored in a comma-delimited list, with all adjacent commas ignored (i.e. a value of Name A, Name B is equivalent to Name A,,,,,,,,, Name B).
When an application cannot locate a font using the primary name stored on the font attribute of the font element (§2.8.2.10), it should use each alternate name in term to attempt to locate the font, and use the first font for which is locates a match.
If this element is omitted, then no alternate names are present for the parent font.
[Example: Consider the following information stored for a single font:
<w:font w:name="SimSun">
<w:altName w:val="Arial Unicode MS" />
...
</w:font>
The altName element specifies that when no font with a name of SimSun (the primary font name) can be located, that applications should attempt to locate a font with the name Arial Unicode MS before doing substitution based on the font metrics. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
val (String Value) |
Specifies that its contents will contain a string. The contents of this string are interpreted based on the context of the parent XML element. [Example: Consider the following WordprocessingML fragment:
The value of the However, consider the following fragment:
In this case, the decimal number in the The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_String">
<attribute name="val" type="ST_String" use="required"/>
</complexType>
This element specifies the character set which is supported by the parent font. This information may be used as defined in font substitution logic to locate an appropriate substitute font when this font is not available. This information is determined by querying the font when present and shall not be modified when the font is not available.
The value of this element shall be interpreted as follows:
|
Value |
Description |
|---|---|
|
|
Specifies the ANSI character set. |
|
|
Specifies the default character set. |
|
|
Specifies the Symbol character set. |
|
|
Specifies a Macintosh (Standard Roman) character set. |
|
|
Specifies the JIS character set. |
|
|
Specifies the Hangul character set. |
|
|
Specifies a Johab character set. |
|
|
Specifies the GB-2312 character set. |
|
|
Specifies the Chinese Big Five character set. |
|
|
Specifies a Greek character set. |
|
|
Specifies a Turkish character set. |
|
|
Specifies a Vietnamese character set. |
|
|
Specifies a Hebrew character set. |
|
|
Specifies an Arabic character set. |
|
|
Specifies a Baltic character set. |
|
|
Specifies a Russian character set. |
|
|
Specifies a Thai character set. |
|
|
Specifies an Eastern European character set. |
|
|
Specifies an OEM character set not defined by this Office Open XML Standard. |
|
Any other value |
Application-defined, may be ignored. |
If this element is not present, then the character set for this font shall be assumed to be the ANSI character set.
[Example: Consider the following information stored for a single font:
<w:font w:name="SimSun">
<w:charset w:val="86" />
...
</w:font>
The charset element specifies via its val attribute value of 86 that this font uses the GB-2312 character set. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
val (Value) |
Specifies a value specified as single octet (two digit) hexadecimal number whose contents are interpreted based on the context of the parent XML element. [Example: Consider the following value for an attribute of type ST_UCharHexNumber:
This value is valid, as it contains two hexadecimal digits, an encoding of an octet of the actual decimal number value. end example] The possible values for this attribute are defined by the ST_UcharHexNumber simple type (§2.18.106). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_UcharHexNumber">
<attribute name="val" type="ST_UcharHexNumber" use="required"/>
</complexType>
This element specifies information about the embedded font storage for the bold form of a font, when it is embedded. This form is used when bold is applied to a text run.
If this element is omitted, then no bold form of the font is stored in the document. The relationship targeted by the id attribute must be of the embedded font type, or the document shall be considered to be invalid.
[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:
<w:font w:name="Arial">
...
<w:embedBold r:id="rId10" />
</w:font>
The embedBold element specifies that the embedded font targeted with the relationship with ID rId10 may be used to retrieve the bold form of the embedded Arial font. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
fontKey (Embedded Font Obfuscation Key) |
Specifies the key which was used to obfuscate this embedded font. This key may be used to retrieve the embedded font for the purposes of viewing this WordprocessingML document only, using the algorithm described in §2.8.1. If this attribute is omitted, then no key is provided for this font. [Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_Guid simple type (§2.18.39). |
|
id (Relationship to Part) Namespace: .../officeDocument/2006/relationships |
Specifies the relationship ID to a specified part. The specified relationship shall match the type required by the parent element:
[Example: Consider an XML element which has the following
The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example] The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1). |
|
subsetted (Embedded Font Is Subsetted) |
Specifies that the embedded font targeted by the If this attribute is omitted, then the embedded font target by the [Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file after subsetting. This status would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FontRel">
<complexContent>
<extension base="CT_Rel">
<attribute name="fontKey" type="ST_Guid"/>
<attribute name="subsetted" type="ST_OnOff"/>
</extension>
</complexContent>
</complexType>
This element specifies information about the embedded font storage for the bold italic form of a font, when it is embedded. This form is used when bold and italics are applied to a text run.
If this element is omitted, then no bold italic form of the font is stored in the document.
[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:
<w:font w:name="Arial">
...
<w:embedBoldItalic r:id="rId11" />
</w:font>
The embedBoldItalic element specifies that the embedded font targeted with the relationship with ID rId11 may be used to retrieve the bold italic form of the embedded Arial font. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
fontKey (Embedded Font Obfuscation Key) |
Specifies the key which was used to obfuscate this embedded font. This key may be used to retrieve the embedded font for the purposes of viewing this WordprocessingML document only, using the algorithm described in §2.8.1. If this attribute is omitted, then no key is provided for this font. [Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_Guid simple type (§2.18.39). |
|
id (Relationship to Part) Namespace: .../officeDocument/2006/relationships |
Specifies the relationship ID to a specified part. The specified relationship shall match the type required by the parent element:
[Example: Consider an XML element which has the following
The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example] The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1). |
|
subsetted (Embedded Font Is Subsetted) |
Specifies that the embedded font targeted by the If this attribute is omitted, then the embedded font target by the [Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file after subsetting. This status would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FontRel">
<complexContent>
<extension base="CT_Rel">
<attribute name="fontKey" type="ST_Guid"/>
<attribute name="subsetted" type="ST_OnOff"/>
</extension>
</complexContent>
</complexType>
This element specifies information about the embedded font storage for the italic form of a font, when it is embedded. This form is used when italics are applied to a text run.
If this element is omitted, then no italic form of the font is stored in the document.
[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:
<w:font w:name="Arial">
...
<w:embedItalic r:id="rId12" />
</w:font>
The embedItalic element specifies that the embedded font targeted with the relationship with ID rId12 may be used to retrieve the italic form of the embedded Arial font. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
fontKey (Embedded Font Obfuscation Key) |
Specifies the key which was used to obfuscate this embedded font. This key may be used to retrieve the embedded font for the purposes of viewing this WordprocessingML document only, using the algorithm described in §2.8.1. If this attribute is omitted, then no key is provided for this font. [Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_Guid simple type (§2.18.39). |
|
id (Relationship to Part) Namespace: .../officeDocument/2006/relationships |
Specifies the relationship ID to a specified part. The specified relationship shall match the type required by the parent element:
[Example: Consider an XML element which has the following
The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example] The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1). |
|
subsetted (Embedded Font Is Subsetted) |
Specifies that the embedded font targeted by the If this attribute is omitted, then the embedded font target by the [Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file after subsetting. This status would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FontRel">
<complexContent>
<extension base="CT_Rel">
<attribute name="fontKey" type="ST_Guid"/>
<attribute name="subsetted" type="ST_OnOff"/>
</extension>
</complexContent>
</complexType>
This element specifies information about the embedded font storage for the regular form of a font, when it is embedded. This form is used when neither bold nor italics is applied to a text run.
If this element is omitted, then no regular form of the font is stored in the document.
[Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:
<w:font w:name="Arial">
...
<w:embedRegular r:id="rId13" />
</w:font>
The embedRegular element specifies that the embedded font targeted with the relationship with ID rId13 may be used to retrieve the regular form of the embedded Arial font. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
fontKey (Embedded Font Obfuscation Key) |
Specifies the key which was used to obfuscate this embedded font. This key may be used to retrieve the embedded font for the purposes of viewing this WordprocessingML document only, using the algorithm described in §2.8.1. If this attribute is omitted, then no key is provided for this font. [Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file. This status would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_Guid simple type (§2.18.39). |
|
id (Relationship to Part) Namespace: .../officeDocument/2006/relationships |
Specifies the relationship ID to a specified part. The specified relationship shall match the type required by the parent element:
[Example: Consider an XML element which has the following
The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example] The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1). |
|
subsetted (Embedded Font Is Subsetted) |
Specifies that the embedded font targeted by the If this attribute is omitted, then the embedded font target by the [Example: Consider a WordprocessingML document in which the Arial font has been embedded in the file after subsetting. This status would be specified using the following WordprocessingML:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FontRel">
<complexContent>
<extension base="CT_Rel">
<attribute name="fontKey" type="ST_Guid"/>
<attribute name="subsetted" type="ST_OnOff"/>
</extension>
</complexContent>
</complexType>
This element specifies that applications shall embed common system fonts when they are in use and font embedding is enabled for this document using the embedTrueTypeFonts element (§2.8.2.8). Common system fonts refer to a set of fonts which are typically always present on a machine, and are not defined by this Office Open XML Standard.
If this element is omitted, then the set of fonts defined as common system fonts should not be embedded in the current document when font embedded is turned on. If the embedTrueTypeFonts element is omitted or false, then this setting has no effect.
[Example: Consider a WordprocessingML document that specifies that it shall embed fonts, including common system fonts. This requirement would be specified using the following WordprocessingML in the document settings part:
<w:embedTrueTypeFonts w:val="true" />
<w:embedSystemFonts w:val="true"/>
The embedSystemFonts element's val attribute has a value of true specifying that common system fonts should be included in this document when they are used. end example]
|
Parent Elements |
|
settings (§2.15.1.78) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies that applications shall embed the fonts in use in this document when it is saved. These fonts shall be embedded subject to the algorithm specified in §2.8.1.
If this element is omitted, then fonts in use should not be embedded in the current document.
[Example: Consider a WordprocessingML document that specifies that it shall embed fonts, including common system fonts. This requirement would be specified using the following WordprocessingML in the document settings part:
<w:embedTrueTypeFonts w:val="true" />
<w:embedSystemFonts w:val="true"/>
The embedTrueType element's val attribute has a value of true specifying that fonts should be embedded in this document when they are used. end example]
|
Parent Elements |
|
settings (§2.15.1.78) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the font family of the current font. This information may be used as defined in font substitution logic to locate an appropriate substitute font when this font is not available. This information is determined by querying the font when present and shall not be modified when the font is not available.
If this element is omitted, then its value shall be assumed to be auto.
[Example: Consider the following information stored for a single font:
<w:font w:name="Calibri">
<w:family w:val="swiss" />
...
</w:font>
The family element specifies via its val attribute value of swiss that this font is part of the Swiss family. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
val (Font Family Value) |
Specifies the font family for the parent font. [Example: Consider the following information stored for a single font:
The The possible values for this attribute are defined by the ST_FontFamily simple type (§2.18.34). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FontFamily">
<attribute name="val" type="ST_FontFamily" use="required"/>
</complexType>
This element specifies the properties for one of the fonts used in this document. A font element shall be written out for each font face used in the document, and includes:
[Example: Consider the following information stored for a single font:
<w:font w:name="Times New Roman">
<w:panose1 w:val="02020603050405020304" />
<w:charset w:val="00" />
<w:family w:val="roman" />
<w:pitch w:val="variable" />
<w:sig w:usb0="20002A87" w:usb1="80000000" w:usb2="00000008" w:usb3="00000000" w:csb0="000001FF" w:csb1="00000000" />
</w:font>
The font element contains information about the Times New Roman font; specifically, information used to locate a substitute font if it is not available. end example]
|
Parent Elements |
|
fonts (§2.8.2.11) |
|
Child Elements |
Subclause |
|---|---|
|
altName (Alternate Names for Font) |
|
|
charset (Character Set Supported By Font) |
|
|
embedBold (Bold Style Font Style Embedding) |
|
|
embedBoldItalic (Bold Italic Font Style Embedding) |
|
|
embedItalic (Italic Font Style Embedding) |
|
|
embedRegular (Regular Font Style Embedding) |
|
|
family (Font Family) |
|
|
notTrueType (Raster or Vector Font) |
|
|
panose1 (Pansose-1 Typeface Classification Number) |
|
|
pitch (Font Pitch) |
|
|
sig (Supported Unicode Subranges and Code Pages) |
|
Attributes |
Description |
|---|---|
|
name (Primary Font Name) |
Specifies the primary name of the current font. This name shall be used to link the information stored in this element with uses of this value in the rFonts element (§2.3.2.24) in document content. [Example: Consider the following information stored for a single font:
The name attribute specifies that the information contained in this element shall be used to look up information about all uses of the Times New Roman font in the document contents. end example] The possible values for this attribute are defined by the ST_String simple type (§2.18.89). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Font">
<sequence>
<element name="altName" type="CT_String" minOccurs="0" maxOccurs="1"/>
<element name="panose1" type="CT_Panose" minOccurs="0" maxOccurs="1"/>
<element name="charset" type="CT_UcharHexNumber" minOccurs="0" maxOccurs="1"/>
<element name="family" type="CT_FontFamily" minOccurs="0" maxOccurs="1"/>
<element name="notTrueType" type="CT_OnOff" minOccurs="0" maxOccurs="1"/>
<element name="pitch" type="CT_Pitch" minOccurs="0" maxOccurs="1"/>
<element name="sig" type="CT_FontSig" minOccurs="0" maxOccurs="1"/>
<element name="embedRegular" type="CT_FontRel" minOccurs="0" maxOccurs="1"/>
<element name="embedBold" type="CT_FontRel" minOccurs="0" maxOccurs="1"/>
<element name="embedItalic" type="CT_FontRel" minOccurs="0" maxOccurs="1"/>
<element name="embedBoldItalic" type="CT_FontRel" minOccurs="0" maxOccurs="1"/>
</sequence>
<attribute name="name" type="ST_String" use="required"/>
</complexType>
This element specifies the root element for a font table part within a WordprocessingML document, and specifies information about the fonts used in this document, each contained within a child font element.
[Example: Consider the following information stored in a font table part:
<w:fonts>
<w:font w:name="Times New Roman">
...
</w:font>
<w:font w:name="Arial">
...
</w:font>
</w:fonts>
The fonts element contains information about all fonts used in the document - in this example, the Times New Roman and Arial fonts. end example]
|
Parent Elements |
|
Root element of WordprocessingML Font Table part |
|
Child Elements |
Subclause |
|---|---|
|
font (Properties for a Single Font) |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FontsList">
<sequence>
<element name="font" type="CT_Font" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
</complexType>
This element specifies that this font is not a TrueType or OpenType font, but is rather a raster or vector font. This information may be used as defined in font substitution logic to locate an appropriate substitute font when this font is not available. This information is determined by querying the font when present and shall not be modified when the font is not available.
If this element is omitted, then the font shall be assumed to be a TrueType or OpenType font.
[Example: Consider the following information stored for a single font:
<w:font w:name="JonsFont">
<w:notTrueType w:val="true" />
...
</w:font>
The notTrueType element specifies via its val attribute value of true that this font is a raster or vector font. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies the Panose-1 classification number for the current font using the PANOSE Classification Guide, Version 1.2. This information may be used as defined in font substitution logic to locate an appropriate substitute font when this font is not available. This information is determined by querying the font when present and shall not be modified when the font is not available.
If this element is omitted, then no Panose-1 information is available.
[Example: Consider the following information stored for a single font:
<w:font w:name="Times New Roman">
<w:panose1 w:val="02020603050405020304" />
...
</w:font>
The panose1 element specifies its Panose-1 number via its val attribute value of 02020603050405020304. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
val (Value) |
Specifies the Panose-1 classification number for the font, stored as a series of two digit hexadecimal encodings of each digits of the Panose number. [Example: Consider the following information stored for a single font:
The val attribute specifies that the digits in the Panose-1 number are: 2,15,6,3,5,2,3,4. end example] The possible values for this attribute are defined by the ST_Panose simple type (§2.18.72). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Panose">
<attribute name="val" type="ST_Panose" use="required"/>
</complexType>
This element specifies the font pitch of the current font. This information may be used as defined in font substitution logic to locate an appropriate substitute font when this font is not available. This information is determined by querying the font when present and shall not be modified when the font is not available.
If this element is omitted, then its value shall be assumed to be default.
[Example: Consider the following information stored for a single font:
<w:font w:name="Courier New">
<w:pitch w:val="fixed" />
...
</w:font>
The pitch element specifies via its val attribute value of fixed that this is a fixed width font. end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
|---|---|
|
val (Value) |
Specifies the font pitch for the font. [Example: Consider the following information stored for a single font:
The The possible values for this attribute are defined by the ST_Pitch simple type (§2.18.73). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_Pitch">
<attribute name="val" type="ST_Pitch" use="required"/>
</complexType>
This element specifies that applications shall subset fonts when font embedding is enabled for this document using the embedTrueTypeFonts element (§2.8.2.8). Subsetting is a mechanism by which only the glyphs used in the contents of this WordprocessingML document are stored in an embedded font, in order to prevent the file from becoming unnecessarily large from the use of a small number of glyphs from a large embedded font.
If this element is omitted, then the set of fonts should not be subsetted in the current document when font embedded is turned on. If the embedTrueTypeFonts element is omitted or false, then this setting has no effect.
[Example: Consider a WordprocessingML document that specifies that it shall subset embedded fonts. This requirement would be specified using the following WordprocessingML in the document settings part:
<w:embedTrueTypeFonts w:val="true" />
<w:saveSubsetFonts w:val="true"/>
The embedSystemFonts element's val attribute has a value of true specifying fonts should be subsetted in this document when they are embedded. end example]
|
Parent Elements |
|
settings (§2.15.1.78) |
|
Attributes |
Description |
|---|---|
|
val (On/Off Value) |
Specifies a binary value for the property defined by the parent XML element. A value of on, 1, or true specifies that the property shall be explicitly applied. This is the default value for this attribute, and is implied when the parent element is present, but this attribute is omitted. A value of off, 0, or false specifies that the property shall be explicitly turned off. [Example: For example, consider the following on/off property:
The The possible values for this attribute are defined by the ST_OnOff simple type (§2.18.67). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OnOff">
<attribute name="val" type="ST_OnOff"/>
</complexType>
This element specifies information identifying the code pages and Unicode subranges for which the parent font provides glyphs. This information may be used as defined in font substitution logic to locate an appropriate substitute font when this font is not available. This information is determined by querying the font when present and shall not be modified when the font is not available.
When storing Unicode subrange information, the appropriate bit in the bitfield shall only be set if the entire subrange is supported by that font.
If this element is omitted, then no supported code page/Unicode subrange information is available.
[Example: Consider the following information stored for a single font:
<w:font w:name="Times New Roman">
<w:sig w:usb0="20002A87" w:usb1="80000000" w:usb2="00000008" w:usb3="00000000" w:csb0="000001FF" w:csb1="00000000" />
...
</w:font>
The sig element specifies the supported code pages and Unicode sub ranges via its attributes. For example, the code pages supported are:
end example]
|
Parent Elements |
|
font (§2.8.2.10) |
|
Attributes |
Description |
||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
csb0 (Lower 32 Bits of Code Page Bit Field) |
Specifies a four digit hexadecimal encoding of the first 32 bits of the 64-bit code-page bit field that identifies which specific character sets or code pages are supported by the parent font. Each bit in this 32 bits represents the following code page:
[Example: Consider font information specified as follows:
The
end example] The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
||||||||||||||||||||||||||||||||||||
|
csb1 (Upper 32 Bits of Code Page Bit Field) |
Specifies a four digit hexadecimal encoding of the upper 32 bits of the 64-bit code-page bit field that identifies which specific character sets or code pages are supported by the parent font. Each bit in this 32 bits represents the following code page:
[Example: Consider font information specified as follows:
The The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
||||||||||||||||||||||||||||||||||||
|
usb0 (First 32 Bits of Unicode Subset Bitfield) |
Specifies the first 32 bits of the 128-bit Unicode subset bit field (USB). Subranges are ordered in accordance with the ISO 10646 standard. [Example: Consider font information specified as follows:
The
end example] The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
||||||||||||||||||||||||||||||||||||
|
usb1 (Second 32 Bits of Unicode Subset Bitfield) |
Specifies the second 32 bits of the 128-bit Unicode subset bit field (USB). Subranges are ordered in accordance with the ISO 10646 standard. [Example: Consider font information specified as follows:
The
end example] The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
||||||||||||||||||||||||||||||||||||
|
usb2 (Third 32 Bits of Unicode Subset Bitfield) |
Specifies the third 32 bits of the 128-bit Unicode subset bit field (USB). Subranges are ordered in accordance with the ISO 10646 standard. [Example: Consider font information specified as follows:
The
end example] The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
||||||||||||||||||||||||||||||||||||
|
usb3 (Fourth 32 Bits of Unicode Subset Bitfield) |
Specifies the fourth 32 bits of the 128-bit Unicode subset bit field (USB). Subranges are ordered in accordance with the ISO 10646 standard. [Example: Consider font information specified as follows:
The The possible values for this attribute are defined by the ST_LongHexNumber simple type (§2.18.57). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_FontSig">
<attribute name="usb0" use="required" type="ST_LongHexNumber"/>
<attribute name="usb1" use="required" type="ST_LongHexNumber"/>
<attribute name="usb2" use="required" type="ST_LongHexNumber"/>
<attribute name="usb3" use="required" type="ST_LongHexNumber"/>
<attribute name="csb0" use="required" type="ST_LongHexNumber"/>
<attribute name="csb1" use="required" type="ST_LongHexNumber"/>
</complexType>