net.sf.jasperreports.engine.fonts

Class FontUtil

java.lang.Object

net.sf.jasperreports.engine.fonts.FontUtil

public final class FontUtil
extends Object

Author:

Teodor Danciu ([email protected])

Method Summary

Methods

Modifier and Type	Method and Description
void	checkAwtFont(String name, boolean ignoreMissingFont)
static void	copyNonNullOwnProperties(JRFont srcFont, JRFont destFont)
Map<AttributedCharacterIterator.Attribute,Object>	getAttributesWithoutAwtFont(Map<AttributedCharacterIterator.Attribute,Object> attributes, JRFont font)
Font	getAwtFont(JRFont font, Locale locale) Returns a java.awt.Font instance by converting a JRFont instance.
Font	getAwtFontFromBundles(String name, int style, float size, Locale locale, boolean ignoreMissingFont)
Font	getAwtFontFromBundles(String name, int style, int size, Locale locale, boolean ignoreMissingFont) Deprecated. Replaced by getAwtFontFromBundles(String, int, float, Locale, boolean).
Collection<String>	getFontFamilyNames() Returns the font family names available through extensions, in alphabetical order.
FontInfo	getFontInfo(String name, Locale locale) Returns font information containing the font family, font face and font style.
static FontUtil	getInstance(JasperReportsContext jasperReportsContext)
void	resetThreadMissingFontsCache()

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static FontUtil getInstance(JasperReportsContext jasperReportsContext)

copyNonNullOwnProperties

public static void copyNonNullOwnProperties(JRFont srcFont,
                            JRFont destFont)

getAttributesWithoutAwtFont

public Map<AttributedCharacterIterator.Attribute,Object> getAttributesWithoutAwtFont(Map<AttributedCharacterIterator.Attribute,Object> attributes,
                                                                            JRFont font)

getFontInfo

public FontInfo getFontInfo(String name,
                   Locale locale)

Returns font information containing the font family, font face and font style.

Parameters:

name - the font family or font face name

locale - the locale

Returns:

a font info object

getFontFamilyNames

public Collection<String> getFontFamilyNames()

Returns the font family names available through extensions, in alphabetical order.

getAwtFontFromBundles

public Font getAwtFontFromBundles(String name,
                         int style,
                         int size,
                         Locale locale,
                         boolean ignoreMissingFont)

Deprecated. Replaced by getAwtFontFromBundles(String, int, float, Locale, boolean).

getAwtFontFromBundles

public Font getAwtFontFromBundles(String name,
                         int style,
                         float size,
                         Locale locale,
                         boolean ignoreMissingFont)

resetThreadMissingFontsCache

public void resetThreadMissingFontsCache()

checkAwtFont

public void checkAwtFont(String name,
                boolean ignoreMissingFont)

getAwtFont

public Font getAwtFont(JRFont font,
              Locale locale)

Returns a java.awt.Font instance by converting a JRFont instance. Mostly used in combination with third-party visualization packages such as JFreeChart (for chart themes). Unless the font parameter is null, this method always returns a non-null AWT font, regardless whether it was found in the font extensions or not. This is because we do need a font to draw with and there is no point in raising a font missing exception here, as it is not JasperReports who does the drawing.