net.sf.jasperreports.engine.util
Class JRFontUtil

java.lang.Object
  net.sf.jasperreports.engine.util.JRFontUtil

public final class JRFontUtil
extends Object

Version:

$Id: JRFontUtil.java 5180 2012-03-29 13:23:12Z teodord $

Author:

Teodor Danciu (teodord@users.sourceforge.net)

Method Summary

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

Methods inherited from class java.lang.Object

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

Method Detail

copyNonNullOwnProperties

public static void copyNonNullOwnProperties(JRFont srcFont,
                                            JRFont destFont)

getAttributes

public static Map<AttributedCharacterIterator.Attribute,Object> getAttributes(Map<AttributedCharacterIterator.Attribute,Object> attributes,
                                                                              JRFont font,
                                                                              Locale locale)

Deprecated. Replaced by getAttributesWithoutAwtFont(Map, JRFont).

Fills the supplied Map parameter with attributes copied from the JRFont parameter. The attributes include the TextAttribute.FONT, which has a java.awt.Font object as value.

getAttributesWithoutAwtFont

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

getFontInfo

public static 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 static Collection<String> getFontFamilyNames()

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

getAwtFontFromBundles

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

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

getAwtFontFromBundles

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

resetThreadMissingFontsCache

public static void resetThreadMissingFontsCache()

checkAwtFont

public static void checkAwtFont(String name,
                                boolean ignoreMissingFont)

getAwtFont

public static 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.