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
static String	FONT_FALLBACK
protected static Map<String,PhysicalFont>	fontMappings
protected static org.slf4j.Logger	log

Constructor Summary

Constructors

Constructor and Description
Mapper()

Method Summary

Methods

Modifier and Type	Method and Description
PhysicalFont	get(String key) Get a PhysicalFont from FontMappings, by case-insensitive name.
Map<String,PhysicalFont>	getFontMappings() Deprecated.
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.
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

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)