com.xmlmind.xmledit.styled

Class FontSpec

java.lang.Object

com.xmlmind.xmledit.styled.FontSpec

public final class FontSpec
extends Object

A font specification consisting in family, style and size.

Unlike Font, this object:

• Can map CSS logical fonts to Java fonts. For example, it may be used to map "MathML sans-serif",bold,italic to "DejaVu Sans Bold Oblique". See alias.
• Adjust the font size in the corresponding font because Java always uses 72DPI to interpret the font size expressed in points.
• Caches all the instances it creates. See get(java.lang.String, int, int).

This class is thread-safe.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_FONT_SIZE Default font size expressed in CSS points (pt).
String	family An alias (example: "sans-serif") or standard (example: "sans-serif") font family.
Font	font The font corresponding to this specification.
static int	MAX_FONT_SIZE Maximal font size expressed in CSS points (pt).
static int	MIN_FONT_SIZE Minimal font size expressed in CSS points (pt).
int	size Font size in CSS points (pt).
int	style Font style; a combination of Font.PLAIN, Font.BOLD and Font.ITALIC.

Method Summary

Modifier and Type	Method and Description
static void	alias(String aliasFamily, int aliasStyle, String standardFamily, int standardStyle) Maps specified fonts.
static void	alias(String aliasFamily, String standardFamily) Maps specified font families.
static FontSpec	create(String family, int style, int size, int cssResolution) Not part of the public, documented, API: creates and returns specified font specification.
static FontSpec	get(String family, int style, int size) Returns specified font specification.
static int	getCSSResolution() Number of CSS pixels per inch is normally a fixed value, 96dpi.
static FontSpec	getDefault() Returns default font specification, a plain "sans-serif" font having a DEFAULT_FONT_SIZE size.
static int	getPreferredFontSize(Preferences prefs) Returns user-preferred normal font size expressed in CSS points (pt).
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

MIN_FONT_SIZE

public static final int MIN_FONT_SIZE

Minimal font size expressed in CSS points (pt).

See Also:

Constant Field Values

MAX_FONT_SIZE

public static final int MAX_FONT_SIZE

Maximal font size expressed in CSS points (pt).

See Also:

Constant Field Values

DEFAULT_FONT_SIZE

public static final int DEFAULT_FONT_SIZE

Default font size expressed in CSS points (pt).

See Also:

Constant Field Values

family

public final String family

An alias (example: "sans-serif") or standard (example: "sans-serif") font family. Case-sensitive.

style

public final int style

Font style; a combination of Font.PLAIN, Font.BOLD and Font.ITALIC.

size

public final int size

Font size in CSS points (pt).

font

public final Font font

The font corresponding to this specification.

Method Detail

alias

public static void alias(String aliasFamily,
                         String standardFamily)

Maps specified font families.

Initially font families "serif", "sans-serif", "monospace", "cursive" and "fantasy" are mapped respectively to "Serif", "SansSerif", "Monospaced", "Serif" and "Serif".

Parameters:

aliasFamily - an alias for font family standardFamily. Example: "monospace". Case-sensitive.

standardFamily - a font family supported by the Java runtime. Examples: "Monospaced", "Courier New" (when this font has been installed on the platform running Java). Case-sensitive.

See Also:

alias(String, int, String, int)

alias

public static void alias(String aliasFamily,
                         int aliasStyle,
                         String standardFamily,
                         int standardStyle)

Maps specified fonts.

Parameters:

aliasFamily - an alias for font family standardFamily. Example: "monospace". Case-sensitive.

aliasStyle - the style of the alias font. A combination of Font.PLAIN, Font.BOLD and Font.ITALIC.

standardFamily - a font family supported by the Java runtime. Examples: "Monospaced", "Courier New" (when this font has been installed on the platform running Java). Case-sensitive.

standardStyle - the style of the standard font.

See Also:

alias(String, String)

getPreferredFontSize

public static int getPreferredFontSize(Preferences prefs)

Returns user-preferred normal font size expressed in CSS points (pt).

getCSSResolution

public static int getCSSResolution()

Number of CSS pixels per inch is normally a fixed value, 96dpi. See explanation below.

This fixed value, 96dpi, is automatically adjusted to take into account the display scaling returned by AWTUtil.getDisplayScaling(). For example, for a display scaling of 150%, the number of CSS pixels per inch is 144dpi. CSS units and dots-per-inch

The unit "in" doesn't represent a physical inch on screen, but represents 96px. That means that whatever is the real screen pixel density, it is assumed to be 96dpi. On devices with a greater pixel density, "1in" will be smaller than 1 physical inch. Similarly "mm", "cm", and "pt" are not absolute length.

getDefault

public static FontSpec getDefault()

Returns default font specification, a plain "sans-serif" font having a DEFAULT_FONT_SIZE size.

get

public static FontSpec get(String family,
                           int style,
                           int size)

Returns specified font specification.

If needed font specification is created and cached.

Parameters:

family - an alias (example: "sans-serif") or standard (example: "SansSerif") font family. Case-sensitive.

style - font style; a combination of Font.PLAIN, Font.BOLD and Font.ITALIC

size - font size in points (pt)

Returns:

specified font specification

create

public static FontSpec create(String family,
                              int style,
                              int size,
                              int cssResolution)

Not part of the public, documented, API: creates and returns specified font specification.

toString

public String toString()

Overrides:

toString in class Object