Add API to access ICU's East Asian Width

Currently there is no way for an application built against the API to
access East Asian Width data from ICU. This adds an API for applications
to use to access it for correct drawing of international characters.

Change-Id: Iab50698ee555ae2ca8ab4b242cc14aa6e0dc3b48

1 files changed, 39 insertions, 0 deletions

diff --git a/core/java/android/text/AndroidCharacter.java b/core/java/android/text/AndroidCharacter.java
index 6dfd64d..af93b5d 100644
--- a/core/java/android/text/AndroidCharacter.java
+++ b/core/java/android/text/AndroidCharacter.java
@@ -22,6 +22,13 @@ package android.text;
  */
 public class AndroidCharacter
 {
+    public static final int EAST_ASIAN_WIDTH_NEUTRAL = 0;
+    public static final int EAST_ASIAN_WIDTH_AMBIGUOUS = 1;
+    public static final int EAST_ASIAN_WIDTH_HALF_WIDTH = 2;
+    public static final int EAST_ASIAN_WIDTH_FULL_WIDTH = 3;
+    public static final int EAST_ASIAN_WIDTH_NARROW = 4;
+    public static final int EAST_ASIAN_WIDTH_WIDE = 5;
+
     /**
      * Fill in the first <code>count</code> bytes of <code>dest</code> with the
      * directionalities from the first <code>count</code> chars of <code>src</code>.
@@ -30,6 +37,38 @@ public class AndroidCharacter
      */
     public native static void getDirectionalities(char[] src, byte[] dest,
                                                   int count);
+
+    /**
+     * Calculate the East Asian Width of a character according to
+     * <a href="http://unicode.org/reports/tr11/">Unicode TR#11</a>. The return
+     * will be one of {@link #EAST_ASIAN_WIDTH_NEUTRAL},
+     * {@link #EAST_ASIAN_WIDTH_AMBIGUOUS}, {@link #EAST_ASIAN_WIDTH_HALF_WIDTH},
+     * {@link #EAST_ASIAN_WIDTH_FULL_WIDTH}, {@link #EAST_ASIAN_WIDTH_NARROW},
+     * or {@link #EAST_ASIAN_WIDTH_WIDE}.
+     * 
+     * @param input the character to measure
+     * @return the East Asian Width for input
+     */
+    public native static int getEastAsianWidth(char input);
+
+    /**
+     * Fill the first <code>count</code> bytes of <code>dest</code> with the
+     * East Asian Width from the first <code>count</code> chars of
+     * <code>src</code>. East Asian Width is calculated based on
+     * <a href="http://unicode.org/reports/tr11/">Unicode TR#11</a>. Each entry
+     * in <code>dest> will be one of {@link #EAST_ASIAN_WIDTH_NEUTRAL},
+     * {@link #EAST_ASIAN_WIDTH_AMBIGUOUS}, {@link #EAST_ASIAN_WIDTH_HALF_WIDTH},
+     * {@link #EAST_ASIAN_WIDTH_FULL_WIDTH}, {@link #EAST_ASIAN_WIDTH_NARROW},
+     * or {@link #EAST_ASIAN_WIDTH_WIDE}.
+     * 
+     * @param src character array of input to measure
+     * @param start first character in array to measure
+     * @param count maximum number of characters to measure
+     * @param dest byte array of results for each character in src
+     */
+    public native static void getEastAsianWidths(char[] src, int start,
+                                                 int count, byte[] dest);
+
     /**
      * Replace the specified slice of <code>text</code> with the chars'
      * right-to-left mirrors (if any), returning true if any