|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.awt.font.NumericShaper
The NumericShaper
class is used to convert Latin-1 (European)
digits to other Unicode decimal digits. Users of this class will
primarily be people who wish to present data using
national digit shapes, but find it more convenient to represent the
data internally using Latin-1 (European) digits. This does not
interpret the deprecated numeric shape selector character (U+206E).
Instances of NumericShaper
are typically applied
as attributes to text with the
NUMERIC_SHAPING
attribute
of the TextAttribute
class.
For example, this code snippet causes a TextLayout
to
shape European digits to Arabic in an Arabic context:
Map map = new HashMap(); map.put(TextAttribute.NUMERIC_SHAPING, NumericShaper.getContextualShaper(NumericShaper.ARABIC)); FontRenderContext frc = ...; TextLayout layout = new TextLayout(text, map, frc); layout.draw(g2d, x, y);
NumericShaper
, as this code snippet demonstrates:char[] text = ...; // shape all EUROPEAN digits (except zero) to ARABIC digits NumericShaper shaper = NumericShaper.getShaper(NumericShaper.ARABIC); shaper.shape(text, start, count); // shape European digits to ARABIC digits if preceeding text is Arabic, or // shape European digits to TAMIL digits if preceeding text is Tamil, or // leave European digits alone if there is no preceeding text, or // preceeding text is neither Arabic nor Tamil NumericShaper shaper = NumericShaper.getContextualShaper(NumericShaper.ARABIC | NumericShaper.TAMIL, NumericShaper.EUROPEAN); shaper.shape(text. start, count);
Field Summary | |
static int |
ALL_RANGES
Identifies all ranges, for full contextual shaping. |
static int |
ARABIC
Identifies the ARABIC range and decimal base. |
private static int |
ARABIC_KEY
|
private static char[] |
bases
|
static int |
BENGALI
Identifies the BENGALI range and decimal base. |
private static int |
BENGALI_KEY
|
private static char[] |
contexts
|
private static int |
CONTEXTUAL_MASK
|
private static int |
ctCache
|
private static int |
ctCacheLimit
|
static int |
DEVANAGARI
Identifies the DEVANAGARI range and decimal base. |
private static int |
DEVANAGARI_KEY
|
static int |
EASTERN_ARABIC
Identifies the ARABIC range and ARABIC_EXTENDED decimal base. |
private static int |
EASTERN_ARABIC_KEY
|
static int |
ETHIOPIC
Identifies the ETHIOPIC range and decimal base. |
private static int |
ETHIOPIC_KEY
|
static int |
EUROPEAN
Identifies the Latin-1 (European) and extended range, and Latin-1 (European) decimal base. |
private static int |
EUROPEAN_KEY
|
static int |
GUJARATI
Identifies the GUJARATI range and decimal base. |
private static int |
GUJARATI_KEY
|
static int |
GURMUKHI
Identifies the GURMUKHI range and decimal base. |
private static int |
GURMUKHI_KEY
|
static int |
KANNADA
Identifies the KANNADA range and decimal base. |
private static int |
KANNADA_KEY
|
private int |
key
index of context for contextual shaping - values range from 0 to 18 |
private static String[] |
keyNames
|
static int |
KHMER
Identifies the KHMER range and decimal base. |
private static int |
KHMER_KEY
|
static int |
LAO
Identifies the LAO range and decimal base. |
private static int |
LAO_KEY
|
static int |
MALAYALAM
Identifies the MALAYALAM range and decimal base. |
private static int |
MALAYALAM_KEY
|
private int |
mask
flag indicating whether to shape contextually (high bit) and which digit ranges to shape (bits 0-18) |
static int |
MONGOLIAN
Identifies the MONGOLIAN range and decimal base. |
private static int |
MONGOLIAN_KEY
|
static int |
MYANMAR
Identifies the MYANMAR range and decimal base. |
private static int |
MYANMAR_KEY
|
private static int |
NUM_KEYS
|
static int |
ORIYA
Identifies the ORIYA range and decimal base. |
private static int |
ORIYA_KEY
|
private static int |
stCache
|
private static char[] |
strongTable
|
static int |
TAMIL
Identifies the TAMIL range and decimal base. |
private static int |
TAMIL_KEY
|
static int |
TELUGU
Identifies the TELUGU range and decimal base. |
private static int |
TELUGU_KEY
|
static int |
THAI
Identifies the THAI range and decimal base. |
private static int |
THAI_KEY
|
static int |
TIBETAN
Identifies the TIBETAN range and decimal base. |
private static int |
TIBETAN_KEY
|
Constructor Summary | |
private |
NumericShaper(int key,
int mask)
Private constructor. |
Method Summary | |
boolean |
equals(Object o)
Returns true if the specified object is an instance of NumericShaper and shapes identically to this one. |
private static int |
getContextKey(char c)
|
static NumericShaper |
getContextualShaper(int ranges)
Returns a contextual shaper for the provided unicode range(s). |
static NumericShaper |
getContextualShaper(int ranges,
int defaultContext)
Returns a contextual shaper for the provided unicode range(s). |
private static int |
getHighBit(int value)
Returns the index of the high bit in value (assuming le, actually power of 2 >= value). value must be positive. |
private static int |
getKeyFromMask(int mask)
|
int |
getRanges()
Returns an int that ORs together the values for
all the ranges that will be shaped.
|
static NumericShaper |
getShaper(int singleRange)
Returns a shaper for the provided unicode range. |
int |
hashCode()
Returns a hash code for this shaper. |
boolean |
isContextual()
Returns a boolean indicating whether or not
this shaper shapes contextually. |
private static boolean |
isStrongDirectional(char c)
|
private static int |
search(char value,
char[] array,
int start,
int length)
fast binary search over subrange of array. |
void |
shape(char[] text,
int start,
int count)
Converts the digits in the text that occur between start and start + count. |
void |
shape(char[] text,
int start,
int count,
int context)
Converts the digits in the text that occur between start and start + count, using the provided context. |
private void |
shapeContextually(char[] text,
int start,
int count,
int ctxKey)
Perform contextual shaping. |
private void |
shapeNonContextually(char[] text,
int start,
int count)
Perform non-contextual shaping. |
String |
toString()
Returns a String that describes this shaper. |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
private int key
private int mask
public static final int EUROPEAN
public static final int ARABIC
public static final int EASTERN_ARABIC
public static final int DEVANAGARI
public static final int BENGALI
public static final int GURMUKHI
public static final int GUJARATI
public static final int ORIYA
public static final int TAMIL
public static final int TELUGU
public static final int KANNADA
public static final int MALAYALAM
public static final int THAI
public static final int LAO
public static final int TIBETAN
public static final int MYANMAR
public static final int ETHIOPIC
public static final int KHMER
public static final int MONGOLIAN
public static final int ALL_RANGES
private static final int EUROPEAN_KEY
private static final int ARABIC_KEY
private static final int EASTERN_ARABIC_KEY
private static final int DEVANAGARI_KEY
private static final int BENGALI_KEY
private static final int GURMUKHI_KEY
private static final int GUJARATI_KEY
private static final int ORIYA_KEY
private static final int TAMIL_KEY
private static final int TELUGU_KEY
private static final int KANNADA_KEY
private static final int MALAYALAM_KEY
private static final int THAI_KEY
private static final int LAO_KEY
private static final int TIBETAN_KEY
private static final int MYANMAR_KEY
private static final int ETHIOPIC_KEY
private static final int KHMER_KEY
private static final int MONGOLIAN_KEY
private static final int NUM_KEYS
private static final String[] keyNames
private static final int CONTEXTUAL_MASK
private static final char[] bases
private static final char[] contexts
private static int ctCache
private static int ctCacheLimit
private static char[] strongTable
private static int stCache
Constructor Detail |
private NumericShaper(int key, int mask)
Method Detail |
private static int getContextKey(char c)
private static boolean isStrongDirectional(char c)
private static int getKeyFromMask(int mask)
public static NumericShaper getShaper(int singleRange)
singleRange
- the specified Unicode range
IllegalArgumentException
- if the range is not a single rangepublic static NumericShaper getContextualShaper(int ranges)
NumericShaper.ARABIC | NumericShaper.THAI
. The
shaper assumes EUROPEAN as the starting context, that is, if
EUROPEAN digits are encountered before any strong directional
text in the string, the context is presumed to be EUROPEAN, and
so the digits will not shape.
ranges
- the specified Unicode ranges
public static NumericShaper getContextualShaper(int ranges, int defaultContext)
NumericShaper.ARABIC | NumericShaper.THAI
. The
shaper uses defaultContext as the starting context.
ranges
- the specified Unicode rangesdefaultContext
- the starting context, such as
NumericShaper.EUROPEAN
public void shape(char[] text, int start, int count)
text
- an array of characters to convertstart
- the index into text
to start
convertingcount
- the number of characters in text
to convertpublic void shape(char[] text, int start, int count, int context)
text
- an array of charactersstart
- the index into text
to start
convertingcount
- the number of characters in text
to convertcontext
- the context to which to convert the
characters, such as NumericShaper.EUROPEAN
public boolean isContextual()
boolean
indicating whether or not
this shaper shapes contextually.
true
if this shaper is contextual;
false
otherwise.public int getRanges()
int
that ORs together the values for
all the ranges that will be shaped.
For example, to check if a shaper shapes to Arabic, you would use the following:
if ((shaper.getRanges() & shaper.ARABIC) != 0) { ...
private void shapeNonContextually(char[] text, int start, int count)
private void shapeContextually(char[] text, int start, int count, int ctxKey)
public int hashCode()
hashCode
in class Object
Object.hashCode()
public boolean equals(Object o)
NumericShaper
and shapes identically to this one.
equals
in class Object
o
- the specified object to compare to this
NumericShaper
true
if o
is an instance
of NumericShaper
and shapes in the same way;
false
otherwise.Object.equals(java.lang.Object)
public String toString()
String
that describes this shaper. This method
is used for debugging purposes only.
toString
in class Object
String
describing this shaper.private static int getHighBit(int value)
private static int search(char value, char[] array, int start, int length)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |