From bb9a51768d2d9dddbe2394b99a00544a3d144fac Mon Sep 17 00:00:00 2001
From: Kenny Root <kroot@google.com>
Date: Sat, 13 Feb 2010 00:07:38 -0800
Subject: 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
---
 core/java/android/text/AndroidCharacter.java | 39 ++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

(limited to 'core/java/android/text/AndroidCharacter.java')

diff --git a/core/java/android/text/AndroidCharacter.java b/core/java/android/text/AndroidCharacter.java
index 6dfd64d2bbe2..af93b5d3772b 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
-- 
cgit v1.2.3