2002-01-23 06:03:04 +08:00
|
|
|
/* Font.java -- Font object
|
|
|
|
Copyright (C) 1999, 2002 Free Software Foundation, Inc.
|
1999-05-05 19:05:57 +08:00
|
|
|
|
2002-01-23 06:03:04 +08:00
|
|
|
This file is part of GNU Classpath.
|
|
|
|
|
|
|
|
GNU Classpath is free software; you can redistribute it and/or modify
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
the Free Software Foundation; either version 2, or (at your option)
|
|
|
|
any later version.
|
|
|
|
|
|
|
|
GNU Classpath is distributed in the hope that it will be useful, but
|
|
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with GNU Classpath; see the file COPYING. If not, write to the
|
|
|
|
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
|
|
02111-1307 USA.
|
|
|
|
|
2002-01-23 06:58:09 +08:00
|
|
|
Linking this library statically or dynamically with other modules is
|
|
|
|
making a combined work based on this library. Thus, the terms and
|
|
|
|
conditions of the GNU General Public License cover the whole
|
|
|
|
combination.
|
|
|
|
|
|
|
|
As a special exception, the copyright holders of this library give you
|
|
|
|
permission to link this library with independent modules to produce an
|
|
|
|
executable, regardless of the license terms of these independent
|
|
|
|
modules, and to copy and distribute the resulting executable under
|
|
|
|
terms of your choice, provided that you also meet, for each linked
|
|
|
|
independent module, the terms and conditions of the license of that
|
|
|
|
module. An independent module is a module which is not derived from
|
|
|
|
or based on this library. If you modify this library, you may extend
|
|
|
|
this exception to your version of the library, but you are not
|
|
|
|
obligated to do so. If you do not wish to do so, delete this
|
|
|
|
exception statement from your version. */
|
1999-05-05 19:05:57 +08:00
|
|
|
|
|
|
|
|
|
|
|
package java.awt;
|
|
|
|
|
2002-01-23 06:03:04 +08:00
|
|
|
import java.awt.peer.FontPeer;
|
|
|
|
import java.util.StringTokenizer;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This class represents a windowing system font.
|
|
|
|
*
|
|
|
|
* @author Aaron M. Renn (arenn@urbanophile.com)
|
|
|
|
* @author Warren Levy <warrenl@cygnus.com>
|
|
|
|
*/
|
|
|
|
public class Font implements java.io.Serializable
|
|
|
|
{
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Static Variables
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constant indicating a "plain" font.
|
|
|
|
*/
|
|
|
|
public static final int PLAIN = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constant indicating a "bold" font.
|
|
|
|
*/
|
|
|
|
public static final int BOLD = 1;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constant indicating an "italic" font.
|
|
|
|
*/
|
|
|
|
public static final int ITALIC = 2;
|
|
|
|
|
|
|
|
public static final int ROMAN_BASELINE = 0;
|
|
|
|
public static final int CENTER_BASELINE = 1;
|
|
|
|
public static final int HANGING_BASELINE = 2;
|
|
|
|
|
2002-08-09 12:26:17 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Indicates to <code>createFont</code> that the supplied font data
|
|
|
|
* is in TrueType format.
|
|
|
|
*
|
|
|
|
* <p><em>Specification Note:</em> The Sun JavaDoc for J2SE 1.4 does
|
|
|
|
* not indicate whether this value also subsumes OpenType. OpenType
|
|
|
|
* is essentially the same format as TrueType, but allows to define
|
|
|
|
* glyph shapes in the same way as PostScript, using cubic bezier
|
|
|
|
* curves.
|
|
|
|
*
|
|
|
|
* @since 1.3
|
|
|
|
*/
|
|
|
|
public static final int TRUETYPE_FONT = 0;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A flag for <code>layoutGlyphVector</code>, indicating that the
|
|
|
|
* orientation of a text run is from left to right.
|
|
|
|
*
|
|
|
|
* @since 1.4
|
|
|
|
*/
|
|
|
|
public static final int LAYOUT_LEFT_TO_RIGHT = 0;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A flag for <code>layoutGlyphVector</code>, indicating that the
|
|
|
|
* orientation of a text run is from right to left.
|
|
|
|
*
|
|
|
|
* @since 1.4
|
|
|
|
*/
|
|
|
|
public static final int LAYOUT_RIGHT_TO_LEFT = 1;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A flag for <code>layoutGlyphVector</code>, indicating that the
|
|
|
|
* text does not contain valid characters before the
|
|
|
|
* <code>start</code> position. If this flag is set,
|
|
|
|
* <code>layoutGlyphVector</code> does not examine the text before
|
|
|
|
* <code>start</code>, even if this would be necessary to select the
|
|
|
|
* correct glyphs (e.g., for Arabic text).
|
|
|
|
*
|
|
|
|
* @since 1.4
|
|
|
|
*/
|
|
|
|
public static final int LAYOUT_NO_START_CONTEXT = 2;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A flag for <code>layoutGlyphVector</code>, indicating that the
|
|
|
|
* text does not contain valid characters after the
|
|
|
|
* <code>limit</code> position. If this flag is set,
|
|
|
|
* <code>layoutGlyphVector</code> does not examine the text after
|
|
|
|
* <code>limit</code>, even if this would be necessary to select the
|
|
|
|
* correct glyphs (e.g., for Arabic text).
|
|
|
|
*
|
|
|
|
* @since 1.4
|
|
|
|
*/
|
|
|
|
public static final int LAYOUT_NO_LIMIT_CONTEXT = 4;
|
|
|
|
|
|
|
|
|
2002-01-23 06:03:04 +08:00
|
|
|
// Serialization constant
|
|
|
|
private static final long serialVersionUID = -4206021311591459213L;
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Instance Variables
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The name of this font
|
|
|
|
*/
|
|
|
|
protected String name;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The font style, which is a combination (by summing, not OR-ing) of
|
|
|
|
* the font style constants in this class.
|
|
|
|
*/
|
|
|
|
protected int style;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The font point size.
|
|
|
|
*/
|
|
|
|
protected int size;
|
|
|
|
|
|
|
|
protected float pointSize;
|
|
|
|
|
|
|
|
// The native peer for this font
|
|
|
|
private FontPeer peer;
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Static Methods
|
|
|
|
*/
|
2000-07-12 11:32:07 +08:00
|
|
|
|
2000-03-17 08:45:06 +08:00
|
|
|
/**
|
2002-01-23 06:03:04 +08:00
|
|
|
* Creates a <code>Font</code> object from the specified string, which
|
|
|
|
* is in one of the following formats:
|
|
|
|
* <p>
|
|
|
|
* <ul>
|
|
|
|
* <li>fontname-style-pointsize
|
|
|
|
* <li>fontname-style
|
|
|
|
* <li>fontname-pointsize
|
|
|
|
* <li>fontname
|
|
|
|
* </ul>
|
|
|
|
* <p>
|
|
|
|
* The style should be one of BOLD, ITALIC, or BOLDITALIC. The default
|
|
|
|
* style if none is specified is PLAIN. The default size if none
|
|
|
|
* is specified is 12.
|
|
|
|
*/
|
|
|
|
public static Font
|
|
|
|
decode(String fontspec)
|
|
|
|
{
|
|
|
|
String name = null;
|
|
|
|
int style = PLAIN;
|
|
|
|
int size = 12;
|
|
|
|
|
|
|
|
StringTokenizer st = new StringTokenizer(fontspec, "-");
|
|
|
|
while (st.hasMoreTokens())
|
|
|
|
{
|
|
|
|
String token = st.nextToken();
|
|
|
|
if (name == null)
|
|
|
|
{
|
|
|
|
name = token;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (token.toUpperCase().equals("BOLD"))
|
|
|
|
{
|
|
|
|
style = BOLD;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
if (token.toUpperCase().equals("ITALIC"))
|
|
|
|
{
|
|
|
|
style = ITALIC;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
if (token.toUpperCase().equals("BOLDITALIC"))
|
|
|
|
{
|
|
|
|
style = BOLD + ITALIC;
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
|
|
|
|
int tokenval = 0;
|
|
|
|
try
|
|
|
|
{
|
|
|
|
tokenval = Integer.parseInt(token);
|
|
|
|
}
|
2002-08-09 12:26:17 +08:00
|
|
|
catch(NumberFormatException e) { ; }
|
2002-01-23 06:03:04 +08:00
|
|
|
|
|
|
|
if (tokenval != 0)
|
|
|
|
size = tokenval;
|
|
|
|
}
|
|
|
|
|
|
|
|
return(new Font(name, style, size));
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a <code>Font</code> object from the passed property name.
|
|
|
|
*
|
|
|
|
* @param propname The name of the system property.
|
|
|
|
* @param default Value to use if the property is not found.
|
|
|
|
*
|
|
|
|
* @return The requested font, or <code>default</code> if the property
|
|
|
|
* not exist or is malformed.
|
|
|
|
*/
|
|
|
|
public static Font
|
|
|
|
getFont(String propname, Font defval)
|
|
|
|
{
|
|
|
|
String propval = System.getProperty(propname);
|
|
|
|
if (propval != null)
|
|
|
|
return(decode(propval));
|
|
|
|
|
|
|
|
return(defval);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a <code>Font</code> object from the passed property name.
|
|
|
|
*
|
|
|
|
* @param propname The name of the system property.
|
|
|
|
*
|
|
|
|
* @return The requested font, or <code>null</code> if the property
|
|
|
|
* not exist or is malformed.
|
|
|
|
*/
|
|
|
|
public static Font
|
|
|
|
getFont(String propname)
|
|
|
|
{
|
|
|
|
return(getFont(propname, null));
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Constructors
|
2000-03-17 08:45:06 +08:00
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
2002-01-23 06:03:04 +08:00
|
|
|
* Initializes a new instance of <code>Font</code> with the specified
|
|
|
|
* attributes.
|
|
|
|
*
|
|
|
|
* @param name The name of the font.
|
|
|
|
* @param style The font style.
|
|
|
|
* @param size The font point size.
|
|
|
|
*/
|
|
|
|
public
|
|
|
|
Font(String name, int style, int size)
|
|
|
|
{
|
|
|
|
this.name = name;
|
|
|
|
this.style = style;
|
|
|
|
this.size = size;
|
|
|
|
this.pointSize = size;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Instance Methods
|
2000-03-17 08:45:06 +08:00
|
|
|
*/
|
1999-05-05 19:05:57 +08:00
|
|
|
|
2002-01-23 06:03:04 +08:00
|
|
|
/**
|
|
|
|
* Returns the name of the font.
|
|
|
|
*
|
|
|
|
* @return The name of the font.
|
|
|
|
*/
|
|
|
|
public String
|
|
|
|
getName()
|
|
|
|
{
|
|
|
|
return(name);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the style of the font.
|
|
|
|
*
|
|
|
|
* @return The font style.
|
|
|
|
*/
|
|
|
|
public int
|
|
|
|
getSize()
|
|
|
|
{
|
|
|
|
return(size);
|
|
|
|
}
|
|
|
|
|
|
|
|
public float
|
|
|
|
getSize2D()
|
|
|
|
{
|
|
|
|
return pointSize;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Tests whether or not this is a plain font. This will be true if
|
|
|
|
* and only if neither the bold nor the italics style is set.
|
|
|
|
*
|
|
|
|
* @return <code>true</code> if this is a plain font, <code>false</code>
|
|
|
|
* otherwise.
|
|
|
|
*/
|
|
|
|
public boolean
|
|
|
|
isPlain()
|
|
|
|
{
|
|
|
|
if (style == PLAIN)
|
|
|
|
return(true);
|
|
|
|
else
|
|
|
|
return(false);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Tests whether or not this font is bold.
|
|
|
|
*
|
|
|
|
* @return <code>true</code> if this font is bold, <code>false</code>
|
|
|
|
* otherwise.
|
|
|
|
*/
|
|
|
|
public boolean
|
|
|
|
isBold()
|
|
|
|
{
|
|
|
|
if ((style == BOLD) || (style == (BOLD+ITALIC)))
|
|
|
|
return(true);
|
|
|
|
else
|
|
|
|
return(false);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Tests whether or not this font is italic.
|
|
|
|
*
|
|
|
|
* @return <code>true</code> if this font is italic, <code>false</code>
|
|
|
|
* otherwise.
|
|
|
|
*/
|
|
|
|
public boolean
|
|
|
|
isItalic()
|
|
|
|
{
|
|
|
|
if ((style == ITALIC) || (style == (BOLD+ITALIC)))
|
|
|
|
return(true);
|
|
|
|
else
|
|
|
|
return(false);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the system specific font family name.
|
|
|
|
*
|
|
|
|
* @return The system specific font family name.
|
|
|
|
*/
|
|
|
|
public String
|
|
|
|
getFamily()
|
|
|
|
{
|
|
|
|
// FIXME: How do I implement this?
|
|
|
|
return(name);
|
|
|
|
}
|
|
|
|
|
|
|
|
public int
|
|
|
|
getStyle()
|
|
|
|
{
|
|
|
|
return style;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a native peer object for this font.
|
|
|
|
*
|
|
|
|
* @return A native peer object for this font.
|
|
|
|
*/
|
|
|
|
public FontPeer
|
|
|
|
getPeer()
|
|
|
|
{
|
|
|
|
if (peer != null)
|
|
|
|
return(peer);
|
|
|
|
|
|
|
|
peer = Toolkit.getDefaultToolkit().getFontPeer(name, style);
|
|
|
|
return(peer);
|
1999-05-05 19:05:57 +08:00
|
|
|
}
|
2002-01-23 06:03:04 +08:00
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a hash value for this font.
|
|
|
|
*
|
|
|
|
* @return A hash for this font.
|
|
|
|
*/
|
|
|
|
public int
|
|
|
|
hashCode()
|
|
|
|
{
|
|
|
|
return((new String(name + size + style)).hashCode());
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Tests whether or not the specified object is equal to this font. This
|
|
|
|
* will be true if and only if:
|
|
|
|
* <P>
|
|
|
|
* <ul>
|
|
|
|
* <li>The object is not <code>null</code>.
|
|
|
|
* <li>The object is an instance of <code>Font</code>.
|
|
|
|
* <li>The object has the same name, style, and size as this object.
|
|
|
|
* </ul>
|
|
|
|
*
|
|
|
|
* @return <code>true</code> if the specified object is equal to this
|
|
|
|
* object, <code>false</code> otherwise.
|
|
|
|
*/
|
|
|
|
public boolean
|
|
|
|
equals(Object obj)
|
|
|
|
{
|
|
|
|
if (obj == null)
|
|
|
|
return(false);
|
|
|
|
|
|
|
|
if (!(obj instanceof Font))
|
|
|
|
return(false);
|
|
|
|
|
|
|
|
Font f = (Font)obj;
|
|
|
|
|
|
|
|
if (!f.name.equals(name))
|
|
|
|
return(false);
|
|
|
|
|
|
|
|
if (f.size != size)
|
|
|
|
return(false);
|
|
|
|
|
|
|
|
if (f.style != style)
|
|
|
|
return(false);
|
|
|
|
|
|
|
|
return(true);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*************************************************************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a string representation of this font.
|
|
|
|
*
|
|
|
|
* @return A string representation of this font.
|
|
|
|
*/
|
|
|
|
public String
|
|
|
|
toString()
|
|
|
|
{
|
|
|
|
return(getClass().getName() + "(name=" + name + ",style=" + style +
|
|
|
|
",size=" + size + ")");
|
|
|
|
}
|
|
|
|
|
|
|
|
} // class Font
|
|
|
|
|