Package org.apache.fontbox.ttf

Class TTFSubsetter

java.lang.Object

org.apache.fontbox.ttf.TTFSubsetter

public final class TTFSubsetter
extends Object

Subsetter for TrueType (TTF) fonts.

Originally developed by Wolfgang Glas for Sketch.

Field Summary

Fields

Modifier and Type	Field	Description
private final SortedSet<Integer>	glyphIds
private boolean	hasAddedCompoundReferences
private final List<String>	keepTables
private static final org.apache.commons.logging.Log	LOG
private static final byte[]	PAD_BUF
private String	prefix
private final TrueTypeFont	ttf
private final CmapLookup	unicodeCmap
private final SortedMap<Integer,Integer>	uniToGID

Constructor Summary

Constructors

Constructor	Description
TTFSubsetter(TrueTypeFont ttf)	Creates a subsetter for the given font.
TTFSubsetter(TrueTypeFont ttf, List<String> tables)	Creates a subsetter for the given font.

Method Summary

Modifier and Type	Method	Description
void	add(int unicode)	Add the given character code to the subset.
void	addAll(Set<Integer> unicodeSet)	Add the given character codes to the subset.
private void	addCompoundReferences()	Resolve compound glyph references.
private byte[]	buildCmapTable()
private byte[]	buildGlyfTable(long[] newOffsets)
private byte[]	buildHeadTable()
private byte[]	buildHheaTable()
private byte[]	buildHmtxTable()
private byte[]	buildLocaTable(long[] newOffsets)
private byte[]	buildMaxpTable()
private byte[]	buildNameTable()
private byte[]	buildOS2Table()
private byte[]	buildPostTable()
private long	copyBytes(InputStream is, OutputStream os, long newOffset, long lastOffset, int count)
Map<Integer,Integer>	getGIDMap()	Returns the map of new -> old GIDs.
private int	getNewGlyphId(Integer oldGid)
private int	log2(int num)
void	setPrefix(String prefix)	Sets the prefix to add to the font's PostScript name.
private boolean	shouldCopyNameRecord(NameRecord nr)
private long	toUInt32(byte[] bytes)
private long	toUInt32(int high, int low)
private long	writeFileHeader(DataOutputStream out, int nTables)
private void	writeFixed(DataOutputStream out, double f)
private void	writeLongDateTime(DataOutputStream out, Calendar calendar)
private void	writeSInt16(DataOutputStream out, short i)
private void	writeTableBody(OutputStream os, byte[] bytes)
private long	writeTableHeader(DataOutputStream out, String tag, long offset, byte[] bytes)
void	writeToStream(OutputStream os)	Write the subfont to the given output stream.
private void	writeUint16(DataOutputStream out, int i)
private void	writeUint32(DataOutputStream out, long l)
private void	writeUint8(DataOutputStream out, int i)

Methods inherited from class java.lang.Object

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

Field Details

LOG

private static final org.apache.commons.logging.Log LOG

PAD_BUF

private static final byte[] PAD_BUF

ttf

private final TrueTypeFont ttf

unicodeCmap

private final CmapLookup unicodeCmap

uniToGID

private final SortedMap<Integer,Integer> uniToGID

keepTables

private final List<String> keepTables

glyphIds

private final SortedSet<Integer> glyphIds

prefix

private String prefix

hasAddedCompoundReferences

private boolean hasAddedCompoundReferences

Constructor Details

TTFSubsetter

public TTFSubsetter(TrueTypeFont ttf)
             throws IOException

Creates a subsetter for the given font.

Parameters:

ttf - the font to be subset

Throws:

IOException

TTFSubsetter

public TTFSubsetter(TrueTypeFont ttf,
 List<String> tables)
             throws IOException

Creates a subsetter for the given font.

Parameters:

ttf - the font to be subset

tables - optional tables to keep if present

Throws:

IOException

Method Details

setPrefix

public void setPrefix(String prefix)

Sets the prefix to add to the font's PostScript name.

add

public void add(int unicode)

Add the given character code to the subset.

Parameters:

unicode - character code

addAll

public void addAll(Set<Integer> unicodeSet)

Add the given character codes to the subset.

Parameters:

unicodeSet - character code set

getGIDMap

public Map<Integer,Integer> getGIDMap()
                               throws IOException

Returns the map of new -> old GIDs.

Throws:

IOException

writeFileHeader

private long writeFileHeader(DataOutputStream out,
 int nTables)
                      throws IOException

Parameters:

out - The data output stream.

nTables - The number of table.

Returns:

The file offset of the first TTF table to write.

Throws:

IOException - Upon errors.

writeTableHeader

private long writeTableHeader(DataOutputStream out,
 String tag,
 long offset,
 byte[] bytes)
                       throws IOException

Throws:

IOException

writeTableBody

private void writeTableBody(OutputStream os,
 byte[] bytes)
                     throws IOException

Throws:

IOException

buildHeadTable

private byte[] buildHeadTable()
                       throws IOException

Throws:

IOException

buildHheaTable

private byte[] buildHheaTable()
                       throws IOException

Throws:

IOException

shouldCopyNameRecord

private boolean shouldCopyNameRecord(NameRecord nr)

buildNameTable

private byte[] buildNameTable()
                       throws IOException

Throws:

IOException

buildMaxpTable

private byte[] buildMaxpTable()
                       throws IOException

Throws:

IOException

buildOS2Table

private byte[] buildOS2Table()
                      throws IOException

Throws:

IOException

buildLocaTable

private byte[] buildLocaTable(long[] newOffsets)
                       throws IOException

Throws:

IOException

addCompoundReferences

private void addCompoundReferences()
                            throws IOException

Resolve compound glyph references.

Throws:

IOException

buildGlyfTable

private byte[] buildGlyfTable(long[] newOffsets)
                       throws IOException

Throws:

IOException

getNewGlyphId

private int getNewGlyphId(Integer oldGid)

buildCmapTable

private byte[] buildCmapTable()
                       throws IOException

Throws:

IOException

buildPostTable

private byte[] buildPostTable()
                       throws IOException

Throws:

IOException

buildHmtxTable

private byte[] buildHmtxTable()
                       throws IOException

Throws:

IOException

copyBytes

private long copyBytes(InputStream is,
 OutputStream os,
 long newOffset,
 long lastOffset,
 int count)
                throws IOException

Throws:

IOException

writeToStream

public void writeToStream(OutputStream os)
                   throws IOException

Write the subfont to the given output stream.

Parameters:

os - the stream used for writing. It will be closed by this method.

Throws:

IOException - if something went wrong.

IllegalStateException - if the subset is empty.

writeFixed

private void writeFixed(DataOutputStream out,
 double f)
                 throws IOException

Throws:

IOException

writeUint32

private void writeUint32(DataOutputStream out,
 long l)
                  throws IOException

Throws:

IOException

writeUint16

private void writeUint16(DataOutputStream out,
 int i)
                  throws IOException

Throws:

IOException

writeSInt16

private void writeSInt16(DataOutputStream out,
 short i)
                  throws IOException

Throws:

IOException

writeUint8

private void writeUint8(DataOutputStream out,
 int i)
                 throws IOException

Throws:

IOException

writeLongDateTime

private void writeLongDateTime(DataOutputStream out,
 Calendar calendar)
                        throws IOException

Throws:

IOException

toUInt32

private long toUInt32(int high,
 int low)

toUInt32

private long toUInt32(byte[] bytes)

log2

private int log2(int num)