org.docx4j.fonts

Class Mapper

java.lang.Object

org.docx4j.fonts.Mapper

Direct Known Subclasses:

BestMatchingMapper, IdentityPlusMapper

public abstract class Mapper
extends Object

Maps font names used in the document to fonts physically available on the system. So, a mapper per document. If fonts are added to the document (ie fonts introduced into use) then the mapper should be updated to include a mapping for the new font. There are 2 implementations: - IndentityPlusMapper, which is best where most of the fonts used in the document are physically present on the system - BestMatchingMapper, useful on Linux and OSX systems on which Microsoft fonts have not been installed. Whichever one you use, you can add/remove mappings programmatically to customise to your needs.

Author:

jharrop

Field Summary

Fields

Modifier and Type	Field and Description
protected ConcurrentHashMap<String,PhysicalFont>	boldForms
protected ConcurrentHashMap<String,PhysicalFont>	boldItalicForms
static String	FONT_FALLBACK
protected static Map<String,PhysicalFont>	fontMappings
protected ConcurrentHashMap<String,PhysicalFont>	italicForms
protected static org.slf4j.Logger	log
protected ConcurrentHashMap<String,PhysicalFont>	regularForms

Constructor Summary

Constructors

Constructor and Description
Mapper()

Method Summary

Modifier and Type	Method and Description
PhysicalFont	get(String key) Get a PhysicalFont from FontMappings, by case-insensitive name.
PhysicalFont	getBoldForm(String fontNameAsInFontTablePart, PhysicalFont pf)
PhysicalFont	getBoldItalicForm(String fontNameAsInFontTablePart, PhysicalFont pf)
Map<String,PhysicalFont>	getFontMappings() Deprecated.
PhysicalFont	getItalicForm(String fontNameAsInFontTablePart, PhysicalFont pf)
PhysicalFont	getRegularForm(String fontNameAsInFontTablePart)
static String	getSubstituteFontXsltExtension(Mapper s, String documentStyleId, String bolditalic, boolean fontFamilyStack)
String	getSubstituteFontXsltExtension(String documentStyleId, String bolditalic, boolean fontFamilyStack)
abstract void	populateFontMappings(Set<String> documentFontNames, Fonts wmlFonts) Populate the fontMappings object.
void	put(String key, PhysicalFont pf) Put a PhysicalFont into FontMappings, by case-insensitive name.
void	registerBoldForm(String fontNameAsInFontTablePart, PhysicalFont pfBold)
void	registerBoldItalicForm(String fontNameAsInFontTablePart, PhysicalFont pfBoldItalic)
void	registerItalicForm(String fontNameAsInFontTablePart, PhysicalFont pfItalic)
void	registerRegularForm(String fontNameAsInFontTablePart, PhysicalFont pfRegular)
int	size()

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static org.slf4j.Logger log

regularForms

protected ConcurrentHashMap<String,PhysicalFont> regularForms

boldForms

protected ConcurrentHashMap<String,PhysicalFont> boldForms

italicForms

protected ConcurrentHashMap<String,PhysicalFont> italicForms

boldItalicForms

protected ConcurrentHashMap<String,PhysicalFont> boldItalicForms

fontMappings

protected static final Map<String,PhysicalFont> fontMappings

FONT_FALLBACK

public static final String FONT_FALLBACK

See Also:

Constant Field Values

Constructor Detail

Mapper

public Mapper()

Method Detail

getFontMappings

@Deprecated
public Map<String,PhysicalFont> getFontMappings()

Deprecated.

get

public PhysicalFont get(String key)

Get a PhysicalFont from FontMappings, by case-insensitive name. (Although Word always uses Title Case for font names, it is actually case insensitive; the spec is silent on this.)

Parameters:

key -

Returns:

put

public void put(String key,
                PhysicalFont pf)

Put a PhysicalFont into FontMappings, by case-insensitive name. (Although Word always uses Title Case for font names, it is actually case insensitive; the spec is silent on this.)

Parameters:

key -

pf -

size

public int size()

populateFontMappings

public abstract void populateFontMappings(Set<String> documentFontNames,
                                          Fonts wmlFonts)
                                   throws Exception

Populate the fontMappings object. We make an entry for each of the documentFontNames.

Parameters:

documentFontNames - - the fonts used in the document

wmlFonts - - the content model for the fonts part

Throws:

Exception

getSubstituteFontXsltExtension

public static String getSubstituteFontXsltExtension(Mapper s,
                                                    String documentStyleId,
                                                    String bolditalic,
                                                    boolean fontFamilyStack)

getSubstituteFontXsltExtension

public String getSubstituteFontXsltExtension(String documentStyleId,
                                             String bolditalic,
                                             boolean fontFamilyStack)

registerRegularForm

public void registerRegularForm(String fontNameAsInFontTablePart,
                                PhysicalFont pfRegular)

registerBoldForm

public void registerBoldForm(String fontNameAsInFontTablePart,
                             PhysicalFont pfBold)

registerItalicForm

public void registerItalicForm(String fontNameAsInFontTablePart,
                               PhysicalFont pfItalic)

registerBoldItalicForm

public void registerBoldItalicForm(String fontNameAsInFontTablePart,
                                   PhysicalFont pfBoldItalic)

getRegularForm

public PhysicalFont getRegularForm(String fontNameAsInFontTablePart)

getBoldForm

public PhysicalFont getBoldForm(String fontNameAsInFontTablePart,
                                PhysicalFont pf)

getItalicForm

public PhysicalFont getItalicForm(String fontNameAsInFontTablePart,
                                  PhysicalFont pf)

getBoldItalicForm

public PhysicalFont getBoldItalicForm(String fontNameAsInFontTablePart,
                                      PhysicalFont pf)