/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package java.awt;
import com.android.internal.awt.AndroidGraphics2D;
import java.awt.font.FontRenderContext;
import java.awt.font.GlyphVector;
import java.awt.font.LineMetrics;
import java.awt.font.TextAttribute;
import java.awt.font.TransformAttribute;
import java.awt.geom.AffineTransform;
import java.awt.geom.Rectangle2D;
import java.io.File;
import java.io.FileInputStream;
import java.io.BufferedInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.Serializable;
import java.text.CharacterIterator;
import java.text.AttributedCharacterIterator.Attribute;
import java.util.Hashtable;
import java.util.Locale;
import java.util.Map;
import java.util.StringTokenizer;
import org.apache.harmony.awt.gl.font.AndroidGlyphVector;
import org.apache.harmony.awt.gl.font.CommonGlyphVector;
import org.apache.harmony.awt.gl.font.FontPeerImpl;
import org.apache.harmony.awt.gl.font.FontMetricsImpl;
import org.apache.harmony.awt.gl.font.LineMetricsImpl;
import org.apache.harmony.awt.internal.nls.Messages;
import org.apache.harmony.luni.util.NotImplementedException;
import org.apache.harmony.misc.HashCode;
/**
* The Font class represents fonts for rendering text. This class allow to map
* characters to glyphs.
* <p>
* A glyph is a shape used to render a character or a sequence of characters.
* For example one character of Latin writing system represented by one glyph,
* but in complex writing system such as South and South-East Asian there is
* more complicated correspondence between characters and glyphs.
* <p>
* The Font object is identified by two types of names. The logical font name is
* the name that is used to construct the font. The font name is the name of a
* particular font face (for example, Arial Bold). The family name is the font's
* family name that specifies the typographic design across several faces (for
* example, Arial). In all the Font is identified by three attributes: the
* family name, the style (such as bold or italic), and the size.
*
* @since Android 1.0
*/
public class Font implements Serializable {
/**
* The Constant serialVersionUID.
*/
private static final long serialVersionUID = -4206021311591459213L;
// Identity Transform attribute
/**
* The Constant IDENTITY_TRANSFORM.
*/
private static final TransformAttribute IDENTITY_TRANSFORM = new TransformAttribute(
new AffineTransform());
/**
* The Constant PLAIN indicates font's plain style.
*/
public static final int PLAIN = 0;
/**
* The Constant BOLD indicates font's bold style.
*/
public static final int BOLD = 1;
/**
* The Constant ITALIC indicates font's italic style.
*/
public static final int ITALIC = 2;
/**
* The Constant ROMAN_BASELINE indicated roman baseline.
*/
public static final int ROMAN_BASELINE = 0;
/**
* The Constant CENTER_BASELINE indicates center baseline.
*/
public static final int CENTER_BASELINE = 1;
/**
* The Constant HANGING_BASELINE indicates hanging baseline.
*/
public static final int HANGING_BASELINE = 2;
/**
* The Constant TRUETYPE_FONT indicates a font resource of type TRUETYPE.
*/
public static final int TRUETYPE_FONT = 0;
/**
* The Constant TYPE1_FONT indicates a font resource of type TYPE1.
*/
public static final int TYPE1_FONT = 1;
/**
* The Constant LAYOUT_LEFT_TO_RIGHT indicates that text is left to right.
*/
public static final int LAYOUT_LEFT_TO_RIGHT = 0;
/**
* The Constant LAYOUT_RIGHT_TO_LEFT indicates that text is right to left.
*/
public static final int LAYOUT_RIGHT_TO_LEFT = 1;
/**
* The Constant LAYOUT_NO_START_CONTEXT indicates that the text in the char
* array before the indicated start should not be examined.
*/
public static final int LAYOUT_NO_START_CONTEXT = 2;
/**
* The Constant LAYOUT_NO_LIMIT_CONTEXT indicates that text in the char
* array after the indicated limit should not be examined.
*/
public static final int LAYOUT_NO_LIMIT_CONTEXT = 4;
/**
* The Constant DEFAULT_FONT.
*/
static final Font DEFAULT_FONT = new Font("Dialog", Font.PLAIN, 12); //$NON-NLS-1$
/**
* The name of the Font.
*/
protected String name;
/**
* The style of the Font.
*/
protected int style;
/**
* The size of the Font.
*/
protected int size;
/**
* The point size of the Font.
*/
protected float pointSize;
// Flag if the Font object transformed
/**
* The transformed.
*/
private boolean transformed;
// Set of font attributes
/**
* The requested attributes.
*/
private Hashtable<Attribute, Object> fRequestedAttributes;
// font peer object corresponding to this Font
/**
* The font peer.
*/
private transient FontPeerImpl fontPeer;
// number of glyphs in this Font
/**
* The num glyphs.
*/
private transient int numGlyphs = -1;
// code for missing glyph for this Font
/**
* The missing glyph code.
*/
private transient int missingGlyphCode = -1;
/**
* Writes object to ObjectOutputStream.
*
* @param out
* ObjectOutputStream.
* @throws IOException
* Signals that an I/O exception has occurred.
*/
private void writeObject(java.io.ObjectOutputStream out) throws IOException {
out.defaultWriteObject();
}
/**
* Reads object from ObjectInputStream object and set native platform
* dependent fields to default values.
*
* @param in
* ObjectInputStream object.
* @throws IOException
* Signals that an I/O exception has occurred.
* @throws ClassNotFoundException
* the class not found exception.
*/
private void readObject(java.io.ObjectInputStream in) throws IOException,
ClassNotFoundException {
in.defaultReadObject();
numGlyphs = -1;
missingGlyphCode = -1;
}
/**
* Instantiates a new Font with the specified attributes. The Font will be
* created with default attributes if the attribute's parameter is null.
*
* @param attributes
* the attributes to be assigned to the new Font, or null.
*/
public Font(Map<? extends Attribute, ?> attributes) {
Object currAttr;
// Default values are taken from the documentation of the Font class.
// See Font constructor, decode and getFont sections.
this.name = "default"; //$NON-NLS-1$
this.size = 12;
this.pointSize = 12;
this.style = Font.PLAIN;
if (attributes != null) {
fRequestedAttributes = new Hashtable<Attribute, Object>(attributes);
currAttr = attributes.get(TextAttribute.SIZE);
if (currAttr != null) {
this.pointSize = ((Float)currAttr).floatValue();
this.size = (int)Math.ceil(this.pointSize);
}
currAttr = attributes.get(TextAttribute.POSTURE);
if (currAttr != null && currAttr.equals(TextAttribute.POSTURE_OBLIQUE)) {
this.style |= Font.ITALIC;
}
currAttr = attributes.get(TextAttribute.WEIGHT);
if ((currAttr != null)
&& (((Float)currAttr).floatValue() >= (TextAttribute.WEIGHT_BOLD).floatValue())) {
this.style |= Font.BOLD;
}
currAttr = attributes.get(TextAttribute.FAMILY);
if (currAttr != null) {
this.name = (String)currAttr;
}
currAttr = attributes.get(TextAttribute.TRANSFORM);
if (currAttr != null) {
if (currAttr instanceof TransformAttribute) {
this.transformed = !((TransformAttribute)currAttr).getTransform().isIdentity();
} else if (currAttr instanceof AffineTransform) {
this.transformed = !((AffineTransform)currAttr).isIdentity();
}
}
} else {
fRequestedAttributes = new Hashtable<Attribute, Object>(5);
fRequestedAttributes.put(TextAttribute.TRANSFORM, IDENTITY_TRANSFORM);
this.transformed = false;
fRequestedAttributes.put(TextAttribute.FAMILY, name);
fRequestedAttributes.put(TextAttribute.SIZE, new Float(this.size));
if ((this.style & Font.BOLD) != 0) {
fRequestedAttributes.put(TextAttribute.WEIGHT, TextAttribute.WEIGHT_BOLD);
} else {
fRequestedAttributes.put(TextAttribute.WEIGHT, TextAttribute.WEIGHT_REGULAR);
}
if ((this.style & Font.ITALIC) != 0) {
fRequestedAttributes.put(TextAttribute.POSTURE, TextAttribute.POSTURE_OBLIQUE);
} else {
fRequestedAttributes.put(TextAttribute.POSTURE, TextAttribute.POSTURE_REGULAR);
}
}
}
/**
* Instantiates a new Font with the specified name, style and size.
*
* @param name
* the name of font.
* @param style
* the style of font.
* @param size
* the size of font.
*/
public Font(String name, int style, int size) {
this.name = (name != null) ? name : "Default"; //$NON-NLS-1$
this.size = (size >= 0) ? size : 0;
this.style = (style & ~0x03) == 0 ? style : Font.PLAIN;
this.pointSize = this.size;
fRequestedAttributes = new Hashtable<Attribute, Object>(5);
fRequestedAttributes.put(TextAttribute.TRANSFORM, IDENTITY_TRANSFORM);
this.transformed = false;
fRequestedAttributes.put(TextAttribute.FAMILY, this.name);
fRequestedAttributes.put(TextAttribute.SIZE, new Float(this.size));
if ((this.style & Font.BOLD) != 0) {
fRequestedAttributes.put(TextAttribute.WEIGHT, TextAttribute.WEIGHT_BOLD);
} else {
fRequestedAttributes.put(TextAttribute.WEIGHT, TextAttribute.WEIGHT_REGULAR);
}
if ((this.style & Font.ITALIC) != 0) {
fRequestedAttributes.put(TextAttribute.POSTURE, TextAttribute.POSTURE_OBLIQUE);
} else {
fRequestedAttributes.put(TextAttribute.POSTURE, TextAttribute.POSTURE_REGULAR);
}
}
/**
* Returns true if this Font has a glyph for the specified character.
*
* @param c
* the character.
* @return true if this Font has a glyph for the specified character, false
* otherwise.
*/
public boolean canDisplay(char c) {
FontPeerImpl peer = (FontPeerImpl)this.getPeer();
return peer.canDisplay(c);
}
/**
* Returns true if the Font can display the characters of the the specified
* text from the specified start position to the specified limit position.
*
* @param text
* the text.
* @param start
* the start offset (in the character array).
* @param limit
* the limit offset (in the character array).
* @return the a character's position in the text that this Font can not
* display, or -1 if this Font can display all characters in this
* text.
*/
public int canDisplayUpTo(char[] text, int start, int limit) {
int st = start;
int result;
while ((st < limit) && canDisplay(text[st])) {
st++;
}
if (st == limit) {
result = -1;
} else {
result = st;
}
return result;
}
/**
* Returns true if the Font can display the characters of the the specified
* CharacterIterator from the specified start position and the specified
* limit position.
*
* @param iter
* the CharacterIterator.
* @param start
* the start offset.
* @param limit
* the limit offset.
* @return the a character's position in the CharacterIterator that this
* Font can not display, or -1 if this Font can display all
* characters in this text.
*/
public int canDisplayUpTo(CharacterIterator iter, int start, int limit) {
int st = start;
char c = iter.setIndex(start);
int result;
while ((st < limit) && (canDisplay(c))) {
st++;
c = iter.next();
}
if (st == limit) {
result = -1;
} else {
result = st;
}
return result;
}
/**
* Returns true if this Font can display a specified String.
*
* @param str
* the String.
* @return the a character's position in the String that this Font can not
* display, or -1 if this Font can display all characters in this
* text.
*/
public int canDisplayUpTo(String str) {
char[] chars = str.toCharArray();
return canDisplayUpTo(chars, 0, chars.length);
}
/**
* Creates a GlyphVector of associating characters to glyphs based on the
* Unicode map of this Font.
*
* @param frc
* the FontRenderContext.
* @param chars
* the characters array.
* @return the GlyphVector of associating characters to glyphs based on the
* Unicode map of this Font.
*/
public GlyphVector createGlyphVector(FontRenderContext frc, char[] chars) {
return new AndroidGlyphVector(chars, frc, this, 0);
}
/**
* Creates a GlyphVector of associating characters contained in the
* specified CharacterIterator to glyphs based on the Unicode map of this
* Font.
*
* @param frc
* the FontRenderContext.
* @param iter
* the CharacterIterator.
* @return the GlyphVector of associating characters contained in the
* specified CharacterIterator to glyphs based on the Unicode map of
* this Font.
*/
public GlyphVector createGlyphVector(FontRenderContext frc, CharacterIterator iter) {
throw new RuntimeException("Not implemented!"); //$NON-NLS-1$
}
/**
* Creates a GlyphVector of associating characters to glyphs based on the
* Unicode map of this Font.
*
* @param frc
* the FontRenderContext.
* @param glyphCodes
* the specified integer array of glyph codes.
* @return the GlyphVector of associating characters to glyphs based on the
* Unicode map of this Font.
* @throws NotImplementedException
* if this method is not implemented by a subclass.
*/
public GlyphVector createGlyphVector(FontRenderContext frc, int[] glyphCodes)
throws org.apache.harmony.luni.util.NotImplementedException {
throw new RuntimeException("Not implemented!"); //$NON-NLS-1$
}
/**
* Creates a GlyphVector of associating characters to glyphs based on the
* Unicode map of this Font.
*
* @param frc
* the FontRenderContext.
* @param str
* the specified String.
* @return the GlyphVector of associating characters to glyphs based on the
* Unicode map of this Font.
*/
public GlyphVector createGlyphVector(FontRenderContext frc, String str) {
return new AndroidGlyphVector(str.toCharArray(), frc, this, 0);
}
/**
* Returns the font style constant value corresponding to one of the font
* style names ("BOLD", "ITALIC", "BOLDITALIC"). This method returns
* Font.PLAIN if the argument is not one of the predefined style names.
*
* @param fontStyleName
* font style name.
* @return font style constant value corresponding to the font style name
* specified.
*/
private static int getFontStyle(String fontStyleName) {
int result = Font.PLAIN;
if (fontStyleName.toUpperCase().equals("BOLDITALIC")) { //$NON-NLS-1$
result = Font.BOLD | Font.ITALIC;
} else if (fontStyleName.toUpperCase().equals("BOLD")) { //$NON-NLS-1$
result = Font.BOLD;
} else if (fontStyleName.toUpperCase().equals("ITALIC")) { //$NON-NLS-1$
result = Font.ITALIC;
}
return result;
}
/**
* Decodes the specified string which described the Font. The string should
* have the following format: fontname-style-pointsize. The style can be
* PLAIN, BOLD, BOLDITALIC, or ITALIC.
*
* @param str
* the string which describes the font.
* @return the Font from the specified string.
*/
public static Font decode(String str) {
// XXX: Documentation doesn't describe all cases, e.g. fonts face names
// with
// symbols that are suggested as delimiters in the documentation.
// In this decode implementation only ***-***-*** format is used with
// '-'
// as the delimiter to avoid unexpected parse results of font face names
// with spaces.
if (str == null) {
return DEFAULT_FONT;
}
StringTokenizer strTokens;
String delim = "-"; //$NON-NLS-1$
String substr;
int fontSize = DEFAULT_FONT.size;
int fontStyle = DEFAULT_FONT.style;
String fontName = DEFAULT_FONT.name;
strTokens = new StringTokenizer(str.trim(), delim);
// Font Name
if (strTokens.hasMoreTokens()) {
fontName = strTokens.nextToken(); // first token is the font name
}
// Font Style or Size (if the style is undefined)
if (strTokens.hasMoreTokens()) {
substr = strTokens.nextToken();
try {
// if second token is the font size
fontSize = Integer.parseInt(substr);
} catch (NumberFormatException e) {
// then second token is the font style
fontStyle = getFontStyle(substr);
}
}
// Font Size
if (strTokens.hasMoreTokens()) {
try {
fontSize = Integer.parseInt(strTokens.nextToken());
} catch (NumberFormatException e) {
}
}
return new Font(fontName, fontStyle, fontSize);
}
/**
* Performs the specified affine transform to the Font and returns a new
* Font.
*
* @param trans
* the AffineTransform.
* @return the Font object.
* @throws IllegalArgumentException
* if affine transform parameter is null.
*/
@SuppressWarnings("unchecked")
public Font deriveFont(AffineTransform trans) {
if (trans == null) {
// awt.94=transform can not be null
throw new IllegalArgumentException(Messages.getString("awt.94")); //$NON-NLS-1$
}
Hashtable<Attribute, Object> derivefRequestedAttributes = (Hashtable<Attribute, Object>)fRequestedAttributes
.clone();
derivefRequestedAttributes.put(TextAttribute.TRANSFORM, new TransformAttribute(trans));
return new Font(derivefRequestedAttributes);
}
/**
* Returns a new Font that is a copy of the current Font modified so that
* the size is the specified size.
*
* @param size
* the size of font.
* @return the Font object.
*/
@SuppressWarnings("unchecked")
public Font deriveFont(float size) {
Hashtable<Attribute, Object> derivefRequestedAttributes = (Hashtable<Attribute, Object>)fRequestedAttributes
.clone();
derivefRequestedAttributes.put(TextAttribute.SIZE, new Float(size));
return new Font(derivefRequestedAttributes);
}
/**
* Returns a new Font that is a copy of the current Font modified so that
* the style is the specified style.
*
* @param style
* the style of font.
* @return the Font object.
*/
@SuppressWarnings("unchecked")
public Font deriveFont(int style) {
Hashtable<Attribute, Object> derivefRequestedAttributes = (Hashtable<Attribute, Object>)fRequestedAttributes
.clone();
if ((style & Font.BOLD) != 0) {
derivefRequestedAttributes.put(TextAttribute.WEIGHT, TextAttribute.WEIGHT_BOLD);
} else if (derivefRequestedAttributes.get(TextAttribute.WEIGHT) != null) {
derivefRequestedAttributes.remove(TextAttribute.WEIGHT);
}
if ((style & Font.ITALIC) != 0) {
derivefRequestedAttributes.put(TextAttribute.POSTURE, TextAttribute.POSTURE_OBLIQUE);
} else if (derivefRequestedAttributes.get(TextAttribute.POSTURE) != null) {
derivefRequestedAttributes.remove(TextAttribute.POSTURE);
}
return new Font(derivefRequestedAttributes);
}
/**
* Returns a new Font that is a copy of the current Font modified to match
* the specified style and with the specified affine transform applied to
* its glyphs.
*
* @param style
* the style of font.
* @param trans
* the AffineTransform.
* @return the Font object.
*/
@SuppressWarnings("unchecked")
public Font deriveFont(int style, AffineTransform trans) {
if (trans == null) {
// awt.94=transform can not be null
throw new IllegalArgumentException(Messages.getString("awt.94")); //$NON-NLS-1$
}
Hashtable<Attribute, Object> derivefRequestedAttributes = (Hashtable<Attribute, Object>)fRequestedAttributes
.clone();
if ((style & BOLD) != 0) {
derivefRequestedAttributes.put(TextAttribute.WEIGHT, TextAttribute.WEIGHT_BOLD);
} else if (derivefRequestedAttributes.get(TextAttribute.WEIGHT) != null) {
derivefRequestedAttributes.remove(TextAttribute.WEIGHT);
}
if ((style & ITALIC) != 0) {
derivefRequestedAttributes.put(TextAttribute.POSTURE, TextAttribute.POSTURE_OBLIQUE);
} else if (derivefRequestedAttributes.get(TextAttribute.POSTURE) != null) {
derivefRequestedAttributes.remove(TextAttribute.POSTURE);
}
derivefRequestedAttributes.put(TextAttribute.TRANSFORM, new TransformAttribute(trans));
return new Font(derivefRequestedAttributes);
}
/**
* Returns a new Font that is a copy of the current Font modified so that
* the size and style are the specified size and style.
*
* @param style
* the style of font.
* @param size
* the size of font.
* @return the Font object.
*/
@SuppressWarnings("unchecked")
public Font deriveFont(int style, float size) {
Hashtable<Attribute, Object> derivefRequestedAttributes = (Hashtable<Attribute, Object>)fRequestedAttributes
.clone();
if ((style & BOLD) != 0) {
derivefRequestedAttributes.put(TextAttribute.WEIGHT, TextAttribute.WEIGHT_BOLD);
} else if (derivefRequestedAttributes.get(TextAttribute.WEIGHT) != null) {
derivefRequestedAttributes.remove(TextAttribute.WEIGHT);
}
if ((style & ITALIC) != 0) {
derivefRequestedAttributes.put(TextAttribute.POSTURE, TextAttribute.POSTURE_OBLIQUE);
} else if (derivefRequestedAttributes.get(TextAttribute.POSTURE) != null) {
derivefRequestedAttributes.remove(TextAttribute.POSTURE);
}
derivefRequestedAttributes.put(TextAttribute.SIZE, new Float(size));
return new Font(derivefRequestedAttributes);
}
/**
* Returns a new Font object with a new set of font attributes.
*
* @param attributes
* the map of attributes.
* @return the Font.
*/
@SuppressWarnings("unchecked")
public Font deriveFont(Map<? extends Attribute, ?> attributes) {
Attribute[] avalAttributes = this.getAvailableAttributes();
Hashtable<Attribute, Object> derivefRequestedAttributes = (Hashtable<Attribute, Object>)fRequestedAttributes
.clone();
Object currAttribute;
for (Attribute element : avalAttributes) {
currAttribute = attributes.get(element);
if (currAttribute != null) {
derivefRequestedAttributes.put(element, currAttribute);
}
}
return new Font(derivefRequestedAttributes);
}
/**
* Compares the specified Object with the current Font.
*
* @param obj
* the Object to be compared.
* @return true, if the specified Object is an instance of Font with the
* same family, size, and style as this Font, false otherwise.
*/
@Override
public boolean equals(Object obj) {
if (obj == this) {
return true;
}
if (obj != null) {
try {
Font font = (Font)obj;
return ((this.style == font.style) && (this.size == font.size)
&& this.name.equals(font.name) && (this.pointSize == font.pointSize) && (this
.getTransform()).equals(font.getTransform()));
} catch (ClassCastException e) {
}
}
return false;
}
/**
* Gets the map of font's attributes.
*
* @return the map of font's attributes.
*/
@SuppressWarnings("unchecked")
public Map<TextAttribute, ?> getAttributes() {
return (Map<TextAttribute, ?>)fRequestedAttributes.clone();
}
/**
* Gets the keys of all available attributes.
*
* @return the keys array of all available attributes.
*/
public Attribute[] getAvailableAttributes() {
Attribute[] attrs = {
TextAttribute.FAMILY, TextAttribute.POSTURE, TextAttribute.SIZE,
TextAttribute.TRANSFORM, TextAttribute.WEIGHT, TextAttribute.SUPERSCRIPT,
TextAttribute.WIDTH
};
return attrs;
}
/**
* Gets the baseline for this character.
*
* @param c
* the character.
* @return the baseline for this character.
*/
public byte getBaselineFor(char c) {
// TODO: implement using TT BASE table data
return 0;
}
/**
* Gets the family name of the Font.
*
* @return the family name of the Font.
*/
public String getFamily() {
if (fRequestedAttributes != null) {
fRequestedAttributes.get(TextAttribute.FAMILY);
}
return null;
}
/**
* Returns the family name of this Font associated with the specified
* locale.
*
* @param l
* the locale.
* @return the family name of this Font associated with the specified
* locale.
*/
public String getFamily(Locale l) {
if (l == null) {
// awt.01='{0}' parameter is null
throw new NullPointerException(Messages.getString("awt.01", "Locale")); //$NON-NLS-1$ //$NON-NLS-2$
}
return getFamily();
}
/**
* Gets a Font with the specified attribute set.
*
* @param attributes
* the attributes to be assigned to the new Font.
* @return the Font.
*/
public static Font getFont(Map<? extends Attribute, ?> attributes) {
Font fnt = (Font)attributes.get(TextAttribute.FONT);
if (fnt != null) {
return fnt;
}
return new Font(attributes);
}
/**
* Gets a Font object from the system properties list with the specified
* name or returns the specified Font if there is no such property.
*
* @param sp
* the specified property name.
* @param f
* the Font.
* @return the Font object from the system properties list with the
* specified name or the specified Font if there is no such
* property.
*/
public static Font getFont(String sp, Font f) {
String pr = System.getProperty(sp);
if (pr == null) {
return f;
}
return decode(pr);
}
/**
* Gets a Font object from the system properties list with the specified
* name.
*
* @param sp
* the system property name.
* @return the Font, or null if there is no such property with the specified
* name.
*/
public static Font getFont(String sp) {
return getFont(sp, null);
}
/**
* Gets the font name.
*
* @return the font name.
*/
public String getFontName() {
if (fRequestedAttributes != null) {
fRequestedAttributes.get(TextAttribute.FAMILY);
}
return null;
}
/**
* Returns the font name associated with the specified locale.
*
* @param l
* the locale.
* @return the font name associated with the specified locale.
*/
public String getFontName(Locale l) {
return getFamily();
}
/**
* Returns a LineMetrics object created with the specified parameters.
*
* @param chars
* the chars array.
* @param start
* the start offset.
* @param end
* the end offset.
* @param frc
* the FontRenderContext.
* @return the LineMetrics for the specified parameters.
*/
public LineMetrics getLineMetrics(char[] chars, int start, int end, FontRenderContext frc) {
if (frc == null) {
// awt.00=FontRenderContext is null
throw new NullPointerException(Messages.getString("awt.00")); //$NON-NLS-1$
}
// FontMetrics fm = AndroidGraphics2D.getInstance().getFontMetrics();
FontMetrics fm = new FontMetricsImpl(this);
float[] fmet = {
fm.getAscent(), fm.getDescent(), fm.getLeading()
};
return new LineMetricsImpl(chars.length, fmet, null);
}
/**
* Returns a LineMetrics object created with the specified parameters.
*
* @param iter
* the CharacterIterator.
* @param start
* the start offset.
* @param end
* the end offset.
* @param frc
* the FontRenderContext.
* @return the LineMetrics for the specified parameters.
*/
public LineMetrics getLineMetrics(CharacterIterator iter, int start, int end,
FontRenderContext frc) {
if (frc == null) {
// awt.00=FontRenderContext is null
throw new NullPointerException(Messages.getString("awt.00")); //$NON-NLS-1$
}
String resultString;
int iterCount;
iterCount = end - start;
if (iterCount < 0) {
resultString = ""; //$NON-NLS-1$
} else {
char[] chars = new char[iterCount];
int i = 0;
for (char c = iter.setIndex(start); c != CharacterIterator.DONE && (i < iterCount); c = iter
.next()) {
chars[i] = c;
i++;
}
resultString = new String(chars);
}
return this.getLineMetrics(resultString, frc);
}
/**
* Returns a LineMetrics object created with the specified parameters.
*
* @param str
* the String.
* @param frc
* the FontRenderContext.
* @return the LineMetrics for the specified parameters.
*/
public LineMetrics getLineMetrics(String str, FontRenderContext frc) {
// FontMetrics fm = AndroidGraphics2D.getInstance().getFontMetrics();
FontMetrics fm = new FontMetricsImpl(this);
float[] fmet = {
fm.getAscent(), fm.getDescent(), fm.getLeading()
};
// Log.i("FONT FMET", fmet.toString());
return new LineMetricsImpl(str.length(), fmet, null);
}
/**
* Returns a LineMetrics object created with the specified parameters.
*
* @param str
* the String.
* @param start
* the start offset.
* @param end
* the end offset.
* @param frc
* the FontRenderContext.
* @return the LineMetrics for the specified parameters.
*/
public LineMetrics getLineMetrics(String str, int start, int end, FontRenderContext frc) {
return this.getLineMetrics(str.substring(start, end), frc);
}
/**
* Gets the logical bounds of the specified String in the specified
* FontRenderContext. The logical bounds contains the origin, ascent,
* advance, and height.
*
* @param ci
* the specified CharacterIterator.
* @param start
* the start offset.
* @param end
* the end offset.
* @param frc
* the FontRenderContext.
* @return a Rectangle2D object.
*/
public Rectangle2D getStringBounds(CharacterIterator ci, int start, int end,
FontRenderContext frc) {
int first = ci.getBeginIndex();
int finish = ci.getEndIndex();
char[] chars;
if (start < first) {
// awt.95=Wrong start index: {0}
throw new IndexOutOfBoundsException(Messages.getString("awt.95", start)); //$NON-NLS-1$
}
if (end > finish) {
// awt.96=Wrong finish index: {0}
throw new IndexOutOfBoundsException(Messages.getString("awt.96", end)); //$NON-NLS-1$
}
if (start > end) {
// awt.97=Wrong range length: {0}
throw new IndexOutOfBoundsException(Messages.getString("awt.97", //$NON-NLS-1$
(end - start)));
}
if (frc == null) {
throw new NullPointerException(Messages.getString("awt.00")); //$NON-NLS-1$
}
chars = new char[end - start];
ci.setIndex(start);
for (int i = 0; i < chars.length; i++) {
chars[i] = ci.current();
ci.next();
}
return this.getStringBounds(chars, 0, chars.length, frc);
}
/**
* Gets the logical bounds of the specified String in the specified
* FontRenderContext. The logical bounds contains the origin, ascent,
* advance, and height.
*
* @param str
* the specified String.
* @param frc
* the FontRenderContext.
* @return a Rectangle2D object.
*/
public Rectangle2D getStringBounds(String str, FontRenderContext frc) {
char[] chars = str.toCharArray();
return this.getStringBounds(chars, 0, chars.length, frc);
}
/**
* Gets the logical bounds of the specified String in the specified
* FontRenderContext. The logical bounds contains the origin, ascent,
* advance, and height.
*
* @param str
* the specified String.
* @param start
* the start offset.
* @param end
* the end offset.
* @param frc
* the FontRenderContext.
* @return a Rectangle2D object.
*/
public Rectangle2D getStringBounds(String str, int start, int end, FontRenderContext frc) {
return this.getStringBounds((str.substring(start, end)), frc);
}
/**
* Gets the logical bounds of the specified String in the specified
* FontRenderContext. The logical bounds contains the origin, ascent,
* advance, and height.
*
* @param chars
* the specified character array.
* @param start
* the start offset.
* @param end
* the end offset.
* @param frc
* the FontRenderContext.
* @return a Rectangle2D object.
*/
public Rectangle2D getStringBounds(char[] chars, int start, int end, FontRenderContext frc) {
if (start < 0) {
// awt.95=Wrong start index: {0}
throw new IndexOutOfBoundsException(Messages.getString("awt.95", start)); //$NON-NLS-1$
}
if (end > chars.length) {
// awt.96=Wrong finish index: {0}
throw new IndexOutOfBoundsException(Messages.getString("awt.96", end)); //$NON-NLS-1$
}
if (start > end) {
// awt.97=Wrong range length: {0}
throw new IndexOutOfBoundsException(Messages.getString("awt.97", //$NON-NLS-1$
(end - start)));
}
if (frc == null) {
throw new NullPointerException(Messages.getString("awt.00")); //$NON-NLS-1$
}
FontPeerImpl peer = (FontPeerImpl)this.getPeer();
final int TRANSFORM_MASK = AffineTransform.TYPE_GENERAL_ROTATION
| AffineTransform.TYPE_GENERAL_TRANSFORM;
Rectangle2D bounds;
AffineTransform transform = getTransform();
// XXX: for transforms where an angle between basis vectors is not 90
// degrees Rectanlge2D class doesn't fit as Logical bounds.
if ((transform.getType() & TRANSFORM_MASK) == 0) {
int width = 0;
for (int i = start; i < end; i++) {
width += peer.charWidth(chars[i]);
}
// LineMetrics nlm = peer.getLineMetrics();
LineMetrics nlm = getLineMetrics(chars, start, end, frc);
bounds = transform.createTransformedShape(
new Rectangle2D.Float(0, -nlm.getAscent(), width, nlm.getHeight()))
.getBounds2D();
} else {
int len = end - start;
char[] subChars = new char[len];
System.arraycopy(chars, start, subChars, 0, len);
bounds = createGlyphVector(frc, subChars).getLogicalBounds();
}
return bounds;
}
/**
* Gets the character's maximum bounds as defined in the specified
* FontRenderContext.
*
* @param frc
* the FontRenderContext.
* @return the character's maximum bounds.
*/
public Rectangle2D getMaxCharBounds(FontRenderContext frc) {
if (frc == null) {
// awt.00=FontRenderContext is null
throw new NullPointerException(Messages.getString("awt.00")); //$NON-NLS-1$
}
FontPeerImpl peer = (FontPeerImpl)this.getPeer();
Rectangle2D bounds = peer.getMaxCharBounds(frc);
AffineTransform transform = getTransform();
// !! Documentation doesn't describe meaning of max char bounds
// for the fonts that have rotate transforms. For all transforms
// returned bounds are the bounds of transformed maxCharBounds
// Rectangle2D that corresponds to the font with identity transform.
// TODO: resolve this issue to return correct bounds
bounds = transform.createTransformedShape(bounds).getBounds2D();
return bounds;
}
/**
* Returns a new GlyphVector object performing full layout of the text.
*
* @param frc
* the FontRenderContext.
* @param chars
* the character array to be layout.
* @param start
* the start offset of the text to use for the GlyphVector.
* @param count
* the count of characters to use for the GlyphVector.
* @param flags
* the flag indicating text direction: LAYOUT_RIGHT_TO_LEFT,
* LAYOUT_LEFT_TO_RIGHT.
* @return the GlyphVector.
*/
public GlyphVector layoutGlyphVector(FontRenderContext frc, char[] chars, int start, int count,
int flags) {
// TODO: implement method for bidirectional text.
// At the moment only LTR and RTL texts supported.
if (start < 0) {
// awt.95=Wrong start index: {0}
throw new ArrayIndexOutOfBoundsException(Messages.getString("awt.95", //$NON-NLS-1$
start));
}
if (count < 0) {
// awt.98=Wrong count value, can not be negative: {0}
throw new ArrayIndexOutOfBoundsException(Messages.getString("awt.98", //$NON-NLS-1$
count));
}
if (start + count > chars.length) {
// awt.99=Wrong [start + count] is out of range: {0}
throw new ArrayIndexOutOfBoundsException(Messages.getString("awt.99", //$NON-NLS-1$
(start + count)));
}
char[] out = new char[count];
System.arraycopy(chars, start, out, 0, count);
return new CommonGlyphVector(out, frc, this, flags);
}
/**
* Returns the String representation of this Font.
*
* @return the String representation of this Font.
*/
@Override
public String toString() {
String stl = "plain"; //$NON-NLS-1$
String result;
if (this.isBold() && this.isItalic()) {
stl = "bolditalic"; //$NON-NLS-1$
}
if (this.isBold() && !this.isItalic()) {
stl = "bold"; //$NON-NLS-1$
}
if (!this.isBold() && this.isItalic()) {
stl = "italic"; //$NON-NLS-1$
}
result = this.getClass().getName() + "[family=" + this.getFamily() + //$NON-NLS-1$
",name=" + this.name + //$NON-NLS-1$
",style=" + stl + //$NON-NLS-1$
",size=" + this.size + "]"; //$NON-NLS-1$ //$NON-NLS-2$
return result;
}
/**
* Gets the postscript name of this Font.
*
* @return the postscript name of this Font.
*/
public String getPSName() {
FontPeerImpl peer = (FontPeerImpl)this.getPeer();
return peer.getPSName();
}
/**
* Gets the logical name of this Font.
*
* @return the logical name of this Font.
*/
public String getName() {
return (this.name);
}
/**
* Gets the peer of this Font.
*
* @return the peer of this Font.
* @deprecated Font rendering is platform independent now.
*/
@Deprecated
public java.awt.peer.FontPeer getPeer() {
if (fontPeer == null) {
fontPeer = (FontPeerImpl)Toolkit.getDefaultToolkit().getGraphicsFactory().getFontPeer(
this);
}
return fontPeer;
}
/**
* Gets the transform acting on this Font (from the Font's attributes).
*
* @return the transformation of this Font.
*/
public AffineTransform getTransform() {
Object transform = fRequestedAttributes.get(TextAttribute.TRANSFORM);
if (transform != null) {
if (transform instanceof TransformAttribute) {
return ((TransformAttribute)transform).getTransform();
}
if (transform instanceof AffineTransform) {
return new AffineTransform((AffineTransform)transform);
}
} else {
transform = new AffineTransform();
}
return (AffineTransform)transform;
}
/**
* Checks if this font is transformed or not.
*
* @return true, if this font is transformed, false otherwise.
*/
public boolean isTransformed() {
return this.transformed;
}
/**
* Checks if this font has plain style or not.
*
* @return true, if this font has plain style, false otherwise.
*/
public boolean isPlain() {
return (this.style == PLAIN);
}
/**
* Checks if this font has italic style or not.
*
* @return true, if this font has italic style, false otherwise.
*/
public boolean isItalic() {
return (this.style & ITALIC) != 0;
}
/**
* Checks if this font has bold style or not.
*
* @return true, if this font has bold style, false otherwise.
*/
public boolean isBold() {
return (this.style & BOLD) != 0;
}
/**
* Returns true if this Font has uniform line metrics.
*
* @return true if this Font has uniform line metrics, false otherwise.
*/
public boolean hasUniformLineMetrics() {
FontPeerImpl peer = (FontPeerImpl)this.getPeer();
return peer.hasUniformLineMetrics();
}
/**
* Returns hash code of this Font object.
*
* @return the hash code of this Font object.
*/
@Override
public int hashCode() {
HashCode hash = new HashCode();
hash.append(this.name);
hash.append(this.style);
hash.append(this.size);
return hash.hashCode();
}
/**
* Gets the style of this Font.
*
* @return the style of this Font.
*/
public int getStyle() {
return this.style;
}
/**
* Gets the size of this Font.
*
* @return the size of this Font.
*/
public int getSize() {
return this.size;
}
/**
* Gets the number of glyphs for this Font.
*
* @return the number of glyphs for this Font.
*/
public int getNumGlyphs() {
if (numGlyphs == -1) {
FontPeerImpl peer = (FontPeerImpl)this.getPeer();
this.numGlyphs = peer.getNumGlyphs();
}
return this.numGlyphs;
}
/**
* Gets the glyphCode which is used as default glyph when this Font does not
* have a glyph for a specified Unicode.
*
* @return the missing glyph code.
*/
public int getMissingGlyphCode() {
if (missingGlyphCode == -1) {
FontPeerImpl peer = (FontPeerImpl)this.getPeer();
this.missingGlyphCode = peer.getMissingGlyphCode();
}
return this.missingGlyphCode;
}
/**
* Gets the float value of font's size.
*
* @return the float value of font's size.
*/
public float getSize2D() {
return this.pointSize;
}
/**
* Gets the italic angle of this Font.
*
* @return the italic angle of this Font.
*/
public float getItalicAngle() {
FontPeerImpl peer = (FontPeerImpl)this.getPeer();
return peer.getItalicAngle();
}
/**
* Creates the font with the specified font format and font file.
*
* @param fontFormat
* the font format.
* @param fontFile
* the file object represented the input data for the font.
* @return the Font.
* @throws FontFormatException
* is thrown if fontFile does not contain the required font
* tables for the specified format.
* @throws IOException
* signals that an I/O exception has occurred.
*/
public static Font createFont(int fontFormat, File fontFile) throws FontFormatException,
IOException {
// ???AWT not supported
InputStream is = new FileInputStream(fontFile);
try {
return createFont(fontFormat, is);
} finally {
is.close();
}
}
/**
* Creates the font with the specified font format and input stream.
*
* @param fontFormat
* the font format.
* @param fontStream
* the input stream represented input data for the font.
* @return the Font.
* @throws FontFormatException
* is thrown if fontFile does not contain the required font
* tables for the specified format.
* @throws IOException
* signals that an I/O exception has occurred.
*/
public static Font createFont(int fontFormat, InputStream fontStream)
throws FontFormatException, IOException {
// ???AWT not supported
BufferedInputStream buffStream;
int bRead = 0;
int size = 8192;
// memory page size, for the faster reading
byte buf[] = new byte[size];
if (fontFormat != TRUETYPE_FONT) { // awt.9A=Unsupported font format
throw new IllegalArgumentException(Messages.getString("awt.9A")); //$NON-NLS-1$
}
/* Get font file in system-specific directory */
File fontFile = Toolkit.getDefaultToolkit().getGraphicsFactory().getFontManager()
.getTempFontFile();
// BEGIN android-modified
buffStream = new BufferedInputStream(fontStream, 8192);
// END android-modified
FileOutputStream fOutStream = new FileOutputStream(fontFile);
bRead = buffStream.read(buf, 0, size);
while (bRead != -1) {
fOutStream.write(buf, 0, bRead);
bRead = buffStream.read(buf, 0, size);
}
buffStream.close();
fOutStream.close();
Font font = null;
font = Toolkit.getDefaultToolkit().getGraphicsFactory().embedFont(
fontFile.getAbsolutePath());
if (font == null) { // awt.9B=Can't create font - bad font data
throw new FontFormatException(Messages.getString("awt.9B")); //$NON-NLS-1$
}
return font;
}
}