Package org.apache.fontbox.ttf

Class TrueTypeCollection

java.lang.Object

org.apache.fontbox.ttf.TrueTypeCollection

All Implemented Interfaces:

Closeable, AutoCloseable

public class TrueTypeCollection
extends Object
implements Closeable

A TrueType Collection, now more properly known as a "Font Collection" as it may contain either TrueType or OpenType fonts.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	TrueTypeCollection.TrueTypeFontHeadersProcessor	Implement the callback method to call processAllFontHeaders(File, TrueTypeFontHeadersProcessor).
static interface	TrueTypeCollection.TrueTypeFontProcessor	Implement the callback method to call processAllFonts(TrueTypeFontProcessor).

Field Summary

Fields

Modifier and Type	Field	Description
private final long[]	fontOffsets
private final int	numFonts
private final TTFDataStream	stream

Constructor Summary

Constructors

Modifier	Constructor	Description
	TrueTypeCollection(File file)	Creates a new TrueTypeCollection from a .ttc file.
	TrueTypeCollection(InputStream stream)	Creates a new TrueTypeCollection from a .ttc input stream.
private	TrueTypeCollection(TTFDataStream stream)	Creates a new TrueTypeCollection from a TTFDataStream.

Method Summary

Modifier and Type	Method	Description
void	close()
private static TTFDataStream	createBufferedDataStream(RandomAccessRead randomAccessRead, boolean closeAfterReading)
private TTFParser	createFontParserAtIndexAndSeek(int idx)
private TrueTypeFont	getFontAtIndex(int idx)
TrueTypeFont	getFontByName(String name)	Get a TT font from a collection.
static void	processAllFontHeaders(File ttcFile, TrueTypeCollection.TrueTypeFontHeadersProcessor trueTypeFontProcessor)	Run the callback for each TT font in the collection.
void	processAllFonts(TrueTypeCollection.TrueTypeFontProcessor trueTypeFontProcessor)	Run the callback for each TT font in the collection.

Methods inherited from class java.lang.Object

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

Field Details

stream

private final TTFDataStream stream

numFonts

private final int numFonts

fontOffsets

private final long[] fontOffsets

Constructor Details

TrueTypeCollection

public TrueTypeCollection(File file)
                   throws IOException

Creates a new TrueTypeCollection from a .ttc file.

Parameters:

file - The TTC file.

Throws:

IOException - If the font could not be parsed.

TrueTypeCollection

public TrueTypeCollection(InputStream stream)
                   throws IOException

Creates a new TrueTypeCollection from a .ttc input stream.

Parameters:

stream - A TTC input stream.

Throws:

IOException - If the font could not be parsed.

TrueTypeCollection

private TrueTypeCollection(TTFDataStream stream)
                    throws IOException

Creates a new TrueTypeCollection from a TTFDataStream.

Parameters:

stream - A data stream to read.

Throws:

IOException - If the font could not be parsed.

Method Details

createBufferedDataStream

private static TTFDataStream createBufferedDataStream(RandomAccessRead randomAccessRead,
 boolean closeAfterReading)
                                               throws IOException

Throws:

IOException

processAllFonts

public void processAllFonts(TrueTypeCollection.TrueTypeFontProcessor trueTypeFontProcessor)
                     throws IOException

Run the callback for each TT font in the collection.

Parameters:

trueTypeFontProcessor - the object with the callback method.

Throws:

IOException - if something went wrong when parsing any font or calling the TrueTypeFontProcessor

processAllFontHeaders

public static void processAllFontHeaders(File ttcFile,
 TrueTypeCollection.TrueTypeFontHeadersProcessor trueTypeFontProcessor)
                                  throws IOException

Run the callback for each TT font in the collection.

Parameters:

trueTypeFontProcessor - the object with the callback method.

Throws:

IOException - if something went wrong when parsing any font

getFontAtIndex

private TrueTypeFont getFontAtIndex(int idx)
                             throws IOException

Throws:

IOException

createFontParserAtIndexAndSeek

private TTFParser createFontParserAtIndexAndSeek(int idx)
                                          throws IOException

Throws:

IOException

getFontByName

public TrueTypeFont getFontByName(String name)
                           throws IOException

Get a TT font from a collection.

Parameters:

name - The postscript name of the font.

Returns:

The found font, nor null if none is found.

Throws:

IOException - if there is an error reading the font data

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException