21.1.2.3 Run Formatting
Run level formatting is the most granular property level and allows for the specifying of all low level text properties. The text run is what all paragraphs are derived from and thus specifying various properties per run allows for a diversely formatted text paragraph.
[Example: Consider the case where have multiple runs within a paragraph and you wish to apply bold to only one of them without having to split up the text into higher level XML groups. To do this we would simply apply the bold run property to the text run that we wish to format as shown below.
<a:r>
…
</a:r>
<a:r>
<a:rPr lang="en-US" b="1" dirty="0" smtClean="0"/>
<a:t>This text will be bold</a:t>
</a:r>
<a:r>
…
</a:r>end example]
For each Unicode character in DrawingML text, the font face can be any of four font “slots”: latin (21.1.2.3.7), cs (21.1.2.3.1), ea (21.1.2.3.3), or sym (21.1.2.3.10), as specified in the following table. For all ranges not explicitly called out below, the ea font shall be used.
Unicode Code Point Range
Classification
U+0000–U+007F
Use latin font
U+0080–U+00A6
Use latin font
U+00A9–U+00AF
Use latin font
U+00B2–U+00B3
Use latin font
U+00B5–U+00D6
Use latin font
U+00D8–U+00F6
Use latin font
U+00F8–U+058F
Use latin font
U+0590–U+074F
Use cs font
U+0780–U+07BF
Use cs font
U+0900–U+109F
Use cs font
U+10A0–U+10FF
Use latin font
Unicode Code Point Range
Classification
U+1200–U+137F
Use latin font
U+13A0–U+177F
Use latin font
U+1D00–U+1D7F
Use latin font
U+1E00–U+1FFF
Use latin font
U+1780–U+18AF
Use cs font
U+2000–U+200B
Use latin font
U+200C–U+200F
Use cs font
U+2010–U+2029
U+202A–U+202F
U+2030–U+2046
U+204A–U+245F
U+2670–U+2671
U+27C0–U+2BFF
U+3099–U+309A
U+D835
U+F000–U+F0FF
U+FB00–U+FB17
U+FB1D–U+FB4F
U+FE50–U+FE6F
Otherwise
Use latin font Except, for the quote characters in the range 2018 – 201F, use ea font if the text has one of the following language identifiers: ii-CN, ja-JP, ko-KR, zh-CN, zh-HK, zh-MO, zh-SG, zh-TW.
Use cs font
Use latin font
Use latin font
Use cs font
Use latin font
Use ea font
Use latin font [Note: This is the leading character for UTF-16 expression of Mathematical Alphanumeric characters (U+1D400 – U+1D7FF) and should be formatted using a latin font. end note]
Symbol, use sym font
Use latin font
Use cs font
Use latin font
Use ea font
This element specifies that a complex script font be used for a specific run of text. This font is specified with a typeface attribute much like the others but is specifically classified as a complex script font.
[Example: Consider the DrawingML shown below.
<a:r>
<a:rPr …>
<a:cs typeface="Times New Roman"/>
</a:rPr>
<a:t>ةيبرعلا </a:t>
</a:r>The above run of text is rendered using the complex script font “Times New Roman”. end example]
If the specified font is not available on a system being used for rendering, then the attributes of this element can be utilized to select an alternative font.
Attributes
charset (Similar Character Set)
Specifies the character set which is supported by the parent font. This information can be used 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 attribute shall be interpreted as follows:
Value
Description
Specifies the ANSI character set. (IANA name iso-8859-1)
Specifies the default character set.
Specifies the Symbol character set. This value specifies that the characters in the Unicode private use area (U+FF00 to U+FFFF) of the font should be used to display characters in the range U+0000 to U+00FF.
Specifies a Macintosh (Standard Roman) character set. (IANA name macintosh)
Specifies the JIS character set. (IANA name shift_jis)
Specifies the Hangul character set. (IANA name ks_c_5601-1987)
Specifies a Johab character set. (IANA name KS C-5601-1992)
Specifies the GB-2312 character set. (IANA name GBK)
Specifies the Chinese Big Five character set. (IANA name Big5)
Specifies a Greek character set. (IANA name windows-1253)
Specifies a Turkish character set. (IANA name iso-8859-9)
Specifies a Vietnamese character set. (IANA name windows-1258)
Specifies a Hebrew character set. (IANA name windows-1255)
Specifies an Arabic character set. (IANA name windows-1256)
Specifies a Baltic character set. (IANA name windows-1257)
Specifies a Russian character set. (IANA name windows-1251)
Attributes
typeface (Text Typeface)
Specifies a Thai character set. (IANA name windows-874)
Specifies an Eastern European character set. (IANA name windows-
1250)Specifies an OEM character set not defined by ISO/IEC 29500.
Application-defined, can be ignored.
The possible values for this attribute are defined by the W3C XML Schema byte datatype.
Specifies the typeface, or name of the font that is to be used. The typeface is a string name of the specific font that should be used in rendering the presentation. If this font is not available within the font list of the generating application than font substitution logic should be utilized in order to select an alternate font.
The possible values for this attribute are defined by the ST_TextTypeface simple type (20.1.10.81).
pitchFamily (Similar Font Family)
Specifies the font pitch as well as the font family for the corresponding font.
This information is determined by querying the font when present and shall not be modified when the font is not available. This information can be used in font substitution logic to locate an appropriate substitute font when this font is not available.
The possible values for this attribute are defined by the ST_PitchFamily simple type (20.1.10.41)datatype.
panose (Panose Setting)
Specifies the Panose-1 classification number for the current font using the mechanism defined in 5.2.7.17 of ISO/IEC 14496-22.
The possible values for this attribute are defined by the ST_Panose simple type (22.9.2.8).
[Note: The W3C XML Schema definition of this element’s content model (CT_TextFont) is located in A.4.1. end note]