http://www.eteks.com

com.eteks.awt
Class PJAFontData

java.lang.Object
  extended bycom.eteks.awt.PJAFontData
All Implemented Interfaces:
java.io.Serializable

public class PJAFontData
extends java.lang.Object
implements java.io.Serializable

Pure Java AWT Font data. From version 1.1, this class keeps all the data of a font to avoid using PJAFontMetrics which extends java.awt.FontMetrics (java.awt.FontMetrics requires awt library to be loaded). This class implements Serializable ; it implements readObject (ObjectInputStream) and writeObject (ObjectOutputStream) methods in such a way that they call the methods read (InputStream) and write (OutputStream) respectively of this class. As The methods read () and write () don't use serialization process, they can be use to restore and save the state of an instance of PJAFontData in Java environments where serialization isn't available (Java 1.0 and J2ME).

Since:
PJA1.1
Version:
2.3
Author:
Emmanuel Puybaret
See Also:
PJAGraphicsManager, PJAFontPeer, PJAFontCapture, Serialized Form

Field Summary
static java.lang.String PJAF1_1_FILE_HEADER
           
static java.lang.String PJAF1_1_FONT_HEADER
           
 
Constructor Summary
PJAFontData(java.awt.Font font, int minChar, int maxChar)
          Creates a font data from font.
PJAFontData(java.io.InputStream in)
          Creates a font data from the in stream with read () method.
 
Method Summary
 boolean equals(java.lang.Object object)
          Returns true if this font peer and object have the same name, style and size.
 int getAscent()
          Returns the ascent of this font.
protected  int[] getCharBits()
          Provides direct access to bitset array for this font's pixels.
protected  int getCharBitsOffset(char ch)
          Retrieves the offset for the bit representing top-left pixel in the given char, within the bitset.
protected  int getCharBitsScanSize()
          Retrieves the scansize of the linear bit array, i.e., the number of bits in each very long scanline of pixels stored sequentially in the bitset
protected  int getCharOffsetAtBaseline(char ch)
          Returns the offset of the character ch to add at baseline.
protected  int[] getCharPixels(char ch)
          Returns the pixels array of the character ch.
protected  int getCharPixelsWidth(char ch)
          Returns the scansize of the pixels array of the character ch.
 int getCharsWidth(char[] data, int offset, int len)
          Returns the string width of a string in this font.
 int getCharWidth(int ch)
          Returns the char width of the character ch in this font.
 int getDescent()
          Returns the descent of this font.
 int getLeading()
          Returns the leading of this font.
 int getMaxAdvance()
          Returns the max advance of this font.
 int getMaxAscent()
          Returns the max ascent of this font.
 int getMaxDescent()
          Returns the max descent of this font.
 java.lang.String getName()
          Returns the name of this font.
 int getSize()
          Returns the size of this font.
 int getStyle()
          Returns the style of this font.
 int hashCode()
           
 void read(java.io.InputStream in)
          Reads the fields of this object from in.
static java.lang.String styleToString(int style)
           
 java.lang.String toString()
           
 void write(java.io.OutputStream out)
          Writes the fields of this object to out.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

PJAF1_1_FILE_HEADER

public static final java.lang.String PJAF1_1_FILE_HEADER
See Also:
Constant Field Values

PJAF1_1_FONT_HEADER

public static final java.lang.String PJAF1_1_FONT_HEADER
See Also:
Constant Field Values
Constructor Detail

PJAFontData

public PJAFontData(java.io.InputStream in)
            throws java.io.IOException
Creates a font data from the in stream with read () method.

Parameters:
in - An opened input stream.
Throws:
java.io.EOFException - End of in is reached.
java.io.IOException - The object fields couldn't be read correctly from in.
See Also:
read(java.io.InputStream)

PJAFontData

public PJAFontData(java.awt.Font font,
                   int minChar,
                   int maxChar)
Creates a font data from font. The pixels of all the characters between minChar and maxChar are grabbed and stored in internal fields.

Parameters:
font - A valid font object.
minChar - The first character to be grabbed.
maxChar - The last character to be grabbed.
Method Detail

getName

public java.lang.String getName()
Returns the name of this font.


getStyle

public int getStyle()
Returns the style of this font.


getSize

public int getSize()
Returns the size of this font.


getLeading

public int getLeading()
Returns the leading of this font.

See Also:
PJAGraphicsExtension.getFontLeading()

getAscent

public int getAscent()
Returns the ascent of this font.

See Also:
PJAGraphicsExtension.getFontAscent()

getDescent

public int getDescent()
Returns the descent of this font.

See Also:
PJAGraphicsExtension.getFontDescent()

getMaxAscent

public int getMaxAscent()
Returns the max ascent of this font.

See Also:
PJAGraphicsExtension.getFontMaxAscent()

getMaxDescent

public int getMaxDescent()
Returns the max descent of this font.

See Also:
PJAGraphicsExtension.getFontMaxDescent()

getMaxAdvance

public int getMaxAdvance()
Returns the max advance of this font.

See Also:
PJAGraphicsExtension.getFontMaxAdvance()

getCharWidth

public int getCharWidth(int ch)
Returns the char width of the character ch in this font.

Parameters:
ch - The character to measure.
See Also:
PJAGraphicsExtension.getCharWidth(char)

getCharsWidth

public int getCharsWidth(char[] data,
                         int offset,
                         int len)
Returns the string width of a string in this font.

See Also:
PJAGraphicsExtension.getStringWidth(java.lang.String)

getCharPixels

protected int[] getCharPixels(char ch)
Returns the pixels array of the character ch.

See Also:
PJAGraphics.drawString(java.lang.String, int, int), getCharPixelsWidth(char)

getCharBits

protected int[] getCharBits()
Provides direct access to bitset array for this font's pixels.

Returns:
array of ints containing a linear sequence of bits, which represent the pixels all the characters in this font displayed side by side and scanned horizontally left-to-right and then top-to-bottom
Since:
PJA2.3

getCharBitsOffset

protected int getCharBitsOffset(char ch)
Retrieves the offset for the bit representing top-left pixel in the given char, within the bitset.

Since:
PJA2.3

getCharBitsScanSize

protected int getCharBitsScanSize()
Retrieves the scansize of the linear bit array, i.e., the number of bits in each very long scanline of pixels stored sequentially in the bitset

Since:
PJA2.3

getCharPixelsWidth

protected int getCharPixelsWidth(char ch)
Returns the scansize of the pixels array of the character ch.

See Also:
PJAGraphics.drawString(java.lang.String, int, int), getCharPixels(char)

getCharOffsetAtBaseline

protected int getCharOffsetAtBaseline(char ch)
Returns the offset of the character ch to add at baseline. When font is italic, some characters have some pixels at the left of the x coordinate of their drawing point.

See Also:
PJAGraphics.drawString(java.lang.String, int, int), getCharPixels(char)

write

public void write(java.io.OutputStream out)
           throws java.io.IOException
Writes the fields of this object to out. It does the same as serialization.

Throws:
java.io.IOException

read

public void read(java.io.InputStream in)
          throws java.io.IOException
Reads the fields of this object from in. It does the same as serialization.

Throws:
java.io.IOException

equals

public boolean equals(java.lang.Object object)
Returns true if this font peer and object have the same name, style and size.


hashCode

public int hashCode()

styleToString

public static java.lang.String styleToString(int style)

toString

public java.lang.String toString()

© 1997-2003 eTeks - All rights reserved