Package org.docx4j.fonts

Class RunFontSelector

java.lang.Object

org.docx4j.fonts.RunFontSelector

public class RunFontSelector
extends Object

Apply the appropriate font to the characters in the run, following the rules specified in http://webapp.docx4java.org/OnlineDemo/ecma376/WordML/rFonts.html and http://msdn.microsoft.com/en-us/library/ff533743.aspx ([MS-OI29500] 2.1.87) See also http://blogs.msdn.com/b/officeinteroperability/archive/2013/04/22/office-open-xml-themes-schemes-and-fonts.aspx The ASCII font formats all characters in the ASCII range (character values 0–127). This font is specified using the ascii attribute on the rFonts element. The East Asian font formats all characters that belong to Unicode sub ranges for East Asian languages. This font is specified using the eastAsia attribute on the rFonts element. The complex script font formats all characters that belong to Unicode sub ranges for complex script languages. This font is specified using the cs attribute on the rFonts element. The high ANSI font formats all characters that belong to Unicode sub ranges other than those explicitly included by one of the groups above. This font is specified using the hAnsi attribute on the rFonts element. Per Tristan Davis http://openxmldeveloper.org/discussions/formats/f/13/t/150.aspx First, the characters are classified into the high ansi / east asian / complex script buckets [per above] Next, we grab *one* theme font from the theme for each bucket - in the settings part, there's an element called themeFontLang The three attributes on that specify the language to use for the characters in each bucket Then you take the language specified for each attribute and look out for the right language in the theme - and you use that font See also http://blogs.msdn.com/b/officeinteroperability/archive/2013/04/22/office-open-xml-themes-schemes-and-fonts.aspx regarding what to do if the font is not available on the computer.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static enum	RunFontSelector.MicrosoftWordNumeralOption
(package private) static enum	RunFontSelector.NativeDigitsSetting
static enum	RunFontSelector.RunFontActionType
static interface	RunFontSelector.RunFontCharacterVisitor

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CSS_NAME
private String	defaultFont
private Style	defaultParagraphStyle
private static String	EMOJI_FONT
(package private) String	fallbackFont
static final String	FO_NAME
protected static org.slf4j.Logger	log
private static RunFontSelector.MicrosoftWordNumeralOption	microsoftWordNumeralOption
private static RunFontSelector.NativeDigitsSetting	nativeDigitsSetting
private static NumericShaper	numericShaperArabicIndic
private RunFontSelector.RunFontActionType	outputType
private boolean	spacePreserve
(package private) CTLanguage	themeFontLang
private RunFontSelector.RunFontCharacterVisitor	vis
private WordprocessingMLPackage	wordMLPackage

Constructor Summary

Constructors

Constructor	Description
RunFontSelector(WordprocessingMLPackage wordMLPackage, RunFontSelector.RunFontCharacterVisitor visitor, RunFontSelector.RunFontActionType outputType)

Method Summary

Modifier and Type	Method	Description
private String	arabicNumbering(String text, BooleanDefaultTrue rtl, BooleanDefaultTrue cs, CTLanguage themeFontLang)
private boolean	contains(String langEastAsia, String lang)
Element	createElement(Document document)
private void	debugCheckGlyph(String fontName, char c)
Object	fontSelector(PPr pPr, RPr rPr, String text)	Apply font selection algorithm to this Text, based on supplied PPr, RPr (and docDefaults, Theme part etc).
Object	fontSelector(PPr pPr, RPr rPr, Text wmlText)	Apply font selection algorithm to this Text, based on supplied PPr, RPr (and docDefaults, Theme part etc).
String	getCssName()
private String	getCssProperty(String fontName)
String	getDefaultFont()
private Style	getDefaultPStyle()
private static String	getEmojiFont()
private static RunFontSelector.MicrosoftWordNumeralOption	getMicrosoftWordNumeralOption()
private static RunFontSelector.NativeDigitsSetting	getNativeDigitsSetting()
private static NumericShaper	getNumericShaperArabicIndic()
private String	getPhysicalFont(String fontName)
private ThemePart	getThemePart()
private DocumentFragment	nullRPr(Document document, String text)
private DocumentFragment	result(Document document)
void	setAttribute(Element el, String fontName)
private String	shapeAsArabicIndic(String text)
void	symbolSetAttribute(Element el)
private int	translateUnicode2SingleByte(int cp)
private Object	unicodeRangeToFont(String text, STHint hint, String langEastAsia, String eastAsia, String ascii, String hAnsi)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

log

protected static org.slf4j.Logger log

wordMLPackage

private WordprocessingMLPackage wordMLPackage

vis

private RunFontSelector.RunFontCharacterVisitor vis

outputType

private RunFontSelector.RunFontActionType outputType

fallbackFont

String fallbackFont

themeFontLang

CTLanguage themeFontLang

CSS_NAME

public static final String CSS_NAME

See Also:

• Constant Field Values

FO_NAME

public static final String FO_NAME

See Also:

• Constant Field Values

defaultParagraphStyle

private Style defaultParagraphStyle

defaultFont

private String defaultFont

spacePreserve

private boolean spacePreserve

EMOJI_FONT

private static String EMOJI_FONT

numericShaperArabicIndic

private static NumericShaper numericShaperArabicIndic

nativeDigitsSetting

private static RunFontSelector.NativeDigitsSetting nativeDigitsSetting

microsoftWordNumeralOption

private static RunFontSelector.MicrosoftWordNumeralOption microsoftWordNumeralOption

Constructor Details

RunFontSelector

public RunFontSelector(WordprocessingMLPackage wordMLPackage,
 RunFontSelector.RunFontCharacterVisitor visitor,
 RunFontSelector.RunFontActionType outputType)

Method Details

getCssName

public String getCssName()

getThemePart

private ThemePart getThemePart()

getDefaultPStyle

private Style getDefaultPStyle()

getDefaultFont

public String getDefaultFont()

nullRPr

private DocumentFragment nullRPr(Document document,
 String text)

result

private DocumentFragment result(Document document)

createElement

public Element createElement(Document document)

setAttribute

public void setAttribute(Element el,
 String fontName)

symbolSetAttribute

public void symbolSetAttribute(Element el)

fontSelector

public Object fontSelector(PPr pPr,
 RPr rPr,
 Text wmlText)

Apply font selection algorithm to this Text, based on supplied PPr, RPr (and docDefaults, Theme part etc).

Parameters:

pPr -

rPr -

wmlText -

Returns:

fontSelector

public Object fontSelector(PPr pPr,
 RPr rPr,
 String text)

Apply font selection algorithm to this Text, based on supplied PPr, RPr (and docDefaults, Theme part etc).

Parameters:

pPr -

rPr -

wmlText -

Returns:

translateUnicode2SingleByte

private int translateUnicode2SingleByte(int cp)

contains

private boolean contains(String langEastAsia,
 String lang)

getEmojiFont

private static String getEmojiFont()

unicodeRangeToFont

private Object unicodeRangeToFont(String text,
 STHint hint,
 String langEastAsia,
 String eastAsia,
 String ascii,
 String hAnsi)

debugCheckGlyph

private void debugCheckGlyph(String fontName,
 char c)

getCssProperty

private String getCssProperty(String fontName)

getPhysicalFont

private String getPhysicalFont(String fontName)

getNumericShaperArabicIndic

private static NumericShaper getNumericShaperArabicIndic()

getNativeDigitsSetting

private static RunFontSelector.NativeDigitsSetting getNativeDigitsSetting()

getMicrosoftWordNumeralOption

private static RunFontSelector.MicrosoftWordNumeralOption getMicrosoftWordNumeralOption()

shapeAsArabicIndic

private String shapeAsArabicIndic(String text)

arabicNumbering

private String arabicNumbering(String text,
 BooleanDefaultTrue rtl,
 BooleanDefaultTrue cs,
 CTLanguage themeFontLang)