151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/* 22c87ad3a45cecf9e344487cad1abfdebe79f2c7cNarayan Kamath * Copyright (C) 2014 The Android Open Source Project 36e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. 451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This code is free software; you can redistribute it and/or modify it 751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * under the terms of the GNU General Public License version 2 only, as 851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * published by the Free Software Foundation. Oracle designates this 951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * particular file as subject to the "Classpath" exception as provided 1051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * by Oracle in the LICENSE file that accompanied this code. 1151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 1251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This code is distributed in the hope that it will be useful, but WITHOUT 1351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 1451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 1551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * version 2 for more details (a copy is included in the LICENSE file that 1651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * accompanied this code). 1751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 1851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * You should have received a copy of the GNU General Public License version 1951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 2 along with this work; if not, write to the Free Software Foundation, 2051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 2251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or visit www.oracle.com if you need additional information or have any 2451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * questions. 2551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 2651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/* 2851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * (C) Copyright IBM Corp. 1999-2003 - All Rights Reserved 2951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 3051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The original version of this source code and documentation is 3151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * copyrighted and owned by IBM. These materials are provided 3251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * under terms of a License Agreement between IBM and Sun. 3351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This technology is protected by multiple US and International 3451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * patents. This notice and attribution to IBM may not be removed. 3551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 3651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 3751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskipackage java.text; 3851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 3951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/** 4051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This class implements the Unicode Bidirectional Algorithm. 4151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 4251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * A Bidi object provides information on the bidirectional reordering of the text 4351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * used to create it. This is required, for example, to properly display Arabic 4451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or Hebrew text. These languages are inherently mixed directional, as they order 4551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * numbers from left-to-right while ordering most other text from right-to-left. 4651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 4751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Once created, a Bidi object can be queried to see if the text it represents is 4851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * all left-to-right or all right-to-left. Such objects are very lightweight and 4951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * this text is relatively easy to process. 5051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 5151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * If there are multiple runs of text, information about the runs can be accessed 5251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * by indexing to get the start, limit, and level of a run. The level represents 5351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * both the direction and the 'nesting level' of a directional run. Odd levels 5451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * are right-to-left, while even levels are left-to-right. So for example level 5551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 0 represents left-to-right text, while level 1 represents right-to-left text, and 5651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * level 2 represents left-to-right text embedded in a right-to-left run. 5751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 5851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since 1.4 5951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 6051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskipublic final class Bidi { 6151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 6251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** Constant indicating base direction is left-to-right. */ 6351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int DIRECTION_LEFT_TO_RIGHT = 0; 6451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 6551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** Constant indicating base direction is right-to-left. */ 6651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int DIRECTION_RIGHT_TO_LEFT = 1; 6751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 6851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 6951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Constant indicating that the base direction depends on the first strong 7051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * directional character in the text according to the Unicode 7151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Bidirectional Algorithm. If no strong directional character is present, 7251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the base direction is left-to-right. 7351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 7451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int DIRECTION_DEFAULT_LEFT_TO_RIGHT = -2; 7551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 7651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 7751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Constant indicating that the base direction depends on the first strong 7851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * directional character in the text according to the Unicode 7951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Bidirectional Algorithm. If no strong directional character is present, 8051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the base direction is right-to-left. 8151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 8251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static final int DIRECTION_DEFAULT_RIGHT_TO_LEFT = -1; 8351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 8421c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-note: Upstream this class delegates to an internal implementation class BidiBase. 8521c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // For Android that is replaced with android.icu.text.Bidi. BidiBase and ICU Bidi work very 8621c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // similarly, but differ in some details like level of argument validation and how how exactly 8721c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // runs are counted. The majority of the changes in this file exist to allow for backwards 8821c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // compatibility with an earlier ICU4C based Bidi implementation. 8921c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer 9021c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // BEGIN Android-added: translateConstToIcu(int). 916ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera private static int translateConstToIcu(int javaInt) { 926ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera switch (javaInt) { 936ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera case DIRECTION_DEFAULT_LEFT_TO_RIGHT: 946ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return android.icu.text.Bidi.DIRECTION_DEFAULT_LEFT_TO_RIGHT; 956ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera case DIRECTION_DEFAULT_RIGHT_TO_LEFT: 966ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return android.icu.text.Bidi.DIRECTION_DEFAULT_RIGHT_TO_LEFT; 976ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera case DIRECTION_LEFT_TO_RIGHT: 986ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return android.icu.text.Bidi.DIRECTION_LEFT_TO_RIGHT; 996ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera case DIRECTION_RIGHT_TO_LEFT: 1006ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return android.icu.text.Bidi.DIRECTION_RIGHT_TO_LEFT; 1016ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera // If the parameter was unrecognized use LEFT_TO_RIGHT. 1026ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera default: 1036ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return android.icu.text.Bidi.DIRECTION_LEFT_TO_RIGHT; 1046ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 1056ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 10621c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // END Android-added: translateConstToIcu(int). 1076ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera 10821c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: use ICU Bidi class instead of BidiBase. 10921c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer private final android.icu.text.Bidi bidiBase; 11051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 11151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 11251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Create Bidi from the given paragraph of text and base direction. 11351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param paragraph a paragraph of text 11451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param flags a collection of flags that control the algorithm. The 11551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * algorithm understands the flags DIRECTION_LEFT_TO_RIGHT, DIRECTION_RIGHT_TO_LEFT, 11651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * DIRECTION_DEFAULT_LEFT_TO_RIGHT, and DIRECTION_DEFAULT_RIGHT_TO_LEFT. 11751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Other values are reserved. 11851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 11951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public Bidi(String paragraph, int flags) { 12021c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer if (paragraph == null) { 12121c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer throw new IllegalArgumentException("paragraph is null"); 12221c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer } 12321c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer 12421c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: use ICU Bidi class instead of BidiBase. 12521c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer bidiBase = new android.icu.text.Bidi(paragraph.toCharArray(), 0, null, 0, 12621c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer paragraph.length(), translateConstToIcu(flags)); 12751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 12851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 12951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 13051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Create Bidi from the given paragraph of text. 13151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 13251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The RUN_DIRECTION attribute in the text, if present, determines the base 13351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * direction (left-to-right or right-to-left). If not present, the base 13451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * direction is computes using the Unicode Bidirectional Algorithm, defaulting to left-to-right 13551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * if there are no strong directional characters in the text. This attribute, if 13651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * present, must be applied to all the text in the paragraph. 13751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 13851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The BIDI_EMBEDDING attribute in the text, if present, represents embedding level 13951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * information. Negative values from -1 to -62 indicate overrides at the absolute value 14051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * of the level. Positive values from 1 to 62 indicate embeddings. Where values are 14151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * zero or not defined, the base embedding level as determined by the base direction 14251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * is assumed. 14351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 14451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The NUMERIC_SHAPING attribute in the text, if present, converts European digits to 14551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * other decimal digits before running the bidi algorithm. This attribute, if present, 14651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * must be applied to all the text in the paragraph. 14751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 14851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param paragraph a paragraph of text with optional character and paragraph attribute information 14951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 15051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.awt.font.TextAttribute#BIDI_EMBEDDING 15151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.awt.font.TextAttribute#NUMERIC_SHAPING 15251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.awt.font.TextAttribute#RUN_DIRECTION 15351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 15451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public Bidi(AttributedCharacterIterator paragraph) { 15551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (paragraph == null) { 15651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalArgumentException("paragraph is null"); 15751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 15851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 15921c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: change from BidiBase to ICU Bidi class. 1606ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera this.bidiBase = new android.icu.text.Bidi(paragraph); 16151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 16251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 16351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 16451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Create Bidi from the given text, embedding, and direction information. 16551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The embeddings array may be null. If present, the values represent embedding level 16651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * information. Negative values from -1 to -61 indicate overrides at the absolute value 16751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * of the level. Positive values from 1 to 61 indicate embeddings. Where values are 16851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * zero, the base embedding level as determined by the base direction is assumed. 16951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param text an array containing the paragraph of text to process. 17051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param textStart the index into the text array of the start of the paragraph. 17151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param embeddings an array containing embedding values for each character in the paragraph. 17251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This can be null, in which case it is assumed that there is no external embedding information. 17351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param embStart the index into the embedding array of the start of the paragraph. 17451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param paragraphLength the length of the paragraph in the text and embeddings arrays. 17551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param flags a collection of flags that control the algorithm. The 17651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * algorithm understands the flags DIRECTION_LEFT_TO_RIGHT, DIRECTION_RIGHT_TO_LEFT, 17751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * DIRECTION_DEFAULT_LEFT_TO_RIGHT, and DIRECTION_DEFAULT_RIGHT_TO_LEFT. 17851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Other values are reserved. 17951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 18051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public Bidi(char[] text, int textStart, byte[] embeddings, int embStart, int paragraphLength, int flags) { 18151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (text == null) { 18251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalArgumentException("text is null"); 18351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 18451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (paragraphLength < 0) { 18551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalArgumentException("bad length: " + paragraphLength); 18651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 18751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (textStart < 0 || paragraphLength > text.length - textStart) { 18851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalArgumentException("bad range: " + textStart + 18951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski " length: " + paragraphLength + 19051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski " for text of length: " + text.length); 19151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 19251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (embeddings != null && (embStart < 0 || paragraphLength > embeddings.length - embStart)) { 19351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IllegalArgumentException("bad range: " + embStart + 19451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski " length: " + paragraphLength + 19551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski " for embeddings of length: " + text.length); 19651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 19751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 19821c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: use ICU Bidi class instead of BidiBase. 1996ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera bidiBase = new android.icu.text.Bidi(text, textStart, embeddings, embStart, 2006ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera paragraphLength, translateConstToIcu(flags)); 2016ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 2026ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera 20321c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-added: private constructor based on ICU Bidi object. 2046ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera private Bidi(android.icu.text.Bidi bidiBase) { 2056ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera this.bidiBase = bidiBase; 20651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 20751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 20851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 20951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Create a Bidi object representing the bidi information on a line of text within 21051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the paragraph represented by the current Bidi. This call is not required if the 21151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * entire paragraph fits on one line. 2126e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * 21351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param lineStart the offset from the start of the paragraph to the start of the line. 21451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param lineLimit the offset from the start of the paragraph to the limit of the line. 2156e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * @return a {@code Bidi} object 21651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 21751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public Bidi createLineBidi(int lineStart, int lineLimit) { 21821c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // BEGIN Android-changed: add explict argument checks and use ICU Bidi class. 2196ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (lineStart < 0 || lineLimit < 0 || lineStart > lineLimit || lineLimit > getLength()) { 2206ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera throw new IllegalArgumentException("Invalid ranges (start=" + lineStart + ", " + 2216ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera "limit=" + lineLimit + ", length=" + getLength() + ")"); 2226ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 22351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2246ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera // In the special case where the start and end positions are the same, we return a new bidi 2256ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera // instance which is empty. Note that the default constructor for an empty ICU4J bidi 2266ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera // instance is not the same as passing in empty values. This way allows one to call 2276ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera // .getLength() for example and return a correct value instead of an IllegalStateException 2286ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera // being thrown, which happens in the case of using the empty constructor. 2296ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (lineStart == lineLimit) { 2306ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return new Bidi(new android.icu.text.Bidi(new char[] {}, 0, new byte[] {}, 0, 0, 2316ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera translateConstToIcu(DIRECTION_LEFT_TO_RIGHT))); 2326ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 2336ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera 2346ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return new Bidi(bidiBase.createLineBidi(lineStart, lineLimit)); 23521c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // END Android-changed: add explict argument checks and use ICU Bidi class. 23651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 23751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 23851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 23951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return true if the line is not left-to-right or right-to-left. This means it either has mixed runs of left-to-right 24051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * and right-to-left text, or the base direction differs from the direction of the only run of text. 2416e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * 24251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return true if the line is not left-to-right or right-to-left. 24351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 24451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public boolean isMixed() { 24551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return bidiBase.isMixed(); 24651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 24751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 24851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 24951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return true if the line is all left-to-right text and the base direction is left-to-right. 2506e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * 25151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return true if the line is all left-to-right text and the base direction is left-to-right 25251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 25351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public boolean isLeftToRight() { 25451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return bidiBase.isLeftToRight(); 25551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 25651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 25751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 25851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return true if the line is all right-to-left text, and the base direction is right-to-left. 25951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return true if the line is all right-to-left text, and the base direction is right-to-left 26051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 26151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public boolean isRightToLeft() { 26251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return bidiBase.isRightToLeft(); 26351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 26451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 26551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 26651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return the length of text in the line. 26751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the length of text in the line 26851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 26951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getLength() { 27051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return bidiBase.getLength(); 27151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 27251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 27351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 27451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return true if the base direction is left-to-right. 27551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return true if the base direction is left-to-right 27651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 27751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public boolean baseIsLeftToRight() { 27851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return bidiBase.baseIsLeftToRight(); 27951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 28051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 28151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 28251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return the base level (0 if left-to-right, 1 if right-to-left). 28351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the base level 28451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 28551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getBaseLevel() { 28651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return bidiBase.getParaLevel(); 28751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 28851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 28951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 2906e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * Return the resolved level of the character at offset. If offset is 2916e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * {@literal <} 0 or ≥ the length of the line, return the base direction 2926e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * level. 2936e42190c7f7d7cf3d8b787c918de0d797c6ddbbaPaul Duffin * 29451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param offset the index of the character for which to return the level 29551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the resolved level of the character at offset 29651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 29751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getLevelAt(int offset) { 29821c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // BEGIN Android-changed: return base level on out of range offset argument. 2996ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera try { 3006ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return bidiBase.getLevelAt(offset); 3016ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } catch (IllegalArgumentException e) { 3026ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return getBaseLevel(); 3036ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 30421c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // END Android-changed: return base level on out of range offset argument. 30551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 30651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 30751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 30851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return the number of level runs. 30951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the number of level runs 31051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 31151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getRunCount() { 31221c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: ICU treats the empty string as having 0 runs, we see it as 1 empty run. 3136ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera int runCount = bidiBase.countRuns(); 3146ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return (runCount == 0 ? 1 : runCount); 31551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 31651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 31751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 31851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return the level of the nth logical run in this line. 31951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param run the index of the run, between 0 and <code>getRunCount()</code> 32051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the level of the run 32151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 32251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getRunLevel(int run) { 32321c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-added: Tolerate calls with run == getRunCount() for backwards compatibility. 3246ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (run == getRunCount()) { 3256ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return getBaseLevel(); 3266ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 32721c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: ICU treats the empty string as having 0 runs, we see it as 1 empty run. 3286ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return (bidiBase.countRuns() == 0 ? bidiBase.getBaseLevel() : bidiBase.getRunLevel(run)); 32951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 33051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 33151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 33251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return the index of the character at the start of the nth logical run in this line, as 33351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * an offset from the start of the line. 33451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param run the index of the run, between 0 and <code>getRunCount()</code> 33551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the start of the run 33651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 33751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getRunStart(int run) { 33821c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-added: Tolerate calls with run == getRunCount() for backwards compatibility. 3396ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (run == getRunCount()) { 3406ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return getBaseLevel(); 3416ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 34221c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: ICU treats the empty string as having 0 runs, we see it as 1 empty run. 3436ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return (bidiBase.countRuns() == 0 ? 0 : bidiBase.getRunStart(run)); 34451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 34551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 34651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 34751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return the index of the character past the end of the nth logical run in this line, as 34851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * an offset from the start of the line. For example, this will return the length 34951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * of the line for the last run on the line. 35051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param run the index of the run, between 0 and <code>getRunCount()</code> 35151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return limit the limit of the run 35251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 35351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public int getRunLimit(int run) { 35421c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-added: Tolerate calls with run == getRunCount() for backwards compatibility. 3556ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (run == getRunCount()) { 3566ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return getBaseLevel(); 3576ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 35821c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: ICU treats the empty string as having 0 runs, we see it as 1 empty run. 3596ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return (bidiBase.countRuns() == 0 ? bidiBase.getLength() : bidiBase.getRunLimit(run)); 36051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 36151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 36251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 36351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Return true if the specified text requires bidi analysis. If this returns false, 36451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the text will display left-to-right. Clients can then avoid constructing a Bidi object. 36551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Text in the Arabic Presentation Forms area of Unicode is presumed to already be shaped 36651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * and ordered for display, and so will not cause this function to return true. 36751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 36851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param text the text containing the characters to test 36951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param start the start of the range of characters to test 37051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param limit the limit of the range of characters to test 37151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return true if the range of characters requires bidi analysis 37251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 37351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static boolean requiresBidi(char[] text, int start, int limit) { 37421c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-added: Check arguments to throw correct exception. 3756ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (0 > start || start > limit || limit > text.length) { 3766ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera throw new IllegalArgumentException("Value start " + start + 3776ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera " is out of range 0 to " + limit); 3786ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 3796ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return android.icu.text.Bidi.requiresBidi(text, start, limit); 38051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 38151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 38251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 38351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Reorder the objects in the array into visual order based on their levels. 38451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This is a utility function to use when you have a collection of objects 38551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * representing runs of text in logical order, each run containing text 38651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * at a single level. The elements at <code>index</code> from 38751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>objectStart</code> up to <code>objectStart + count</code> 38851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * in the objects array will be reordered into visual order assuming 38951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * each run of text has the level indicated by the corresponding element 39051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * in the levels array (at <code>index - objectStart + levelStart</code>). 39151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 39251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param levels an array representing the bidi level of each object 39351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param levelStart the start position in the levels array 39451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param objects the array of objects to be reordered into visual order 39551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param objectStart the start position in the objects array 39651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param count the number of objects to reorder 39751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 39851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public static void reorderVisually(byte[] levels, int levelStart, Object[] objects, int objectStart, int count) { 39921c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // BEGIN Android-added: Check arguments to throw correct exception. 4006ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (0 > levelStart || levels.length <= levelStart) { 4016ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera throw new IllegalArgumentException("Value levelStart " + 4026ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera levelStart + " is out of range 0 to " + 4036ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera (levels.length-1)); 4046ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 4056ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (0 > objectStart || objects.length <= objectStart) { 4066ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera throw new IllegalArgumentException("Value objectStart " + 4076ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera levelStart + " is out of range 0 to " + 4086ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera (objects.length-1)); 4096ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 4106ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera if (0 > count || objects.length < (objectStart+count)) { 4116ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera throw new IllegalArgumentException("Value count " + 4126ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera levelStart + " is out of range 0 to " + 4136ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera (objects.length - objectStart)); 4146ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera } 41521c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // END Android-added: Check arguments to throw correct exception. 41621c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer 41721c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: use ICU Bidi class instead of BidiBase. 4186ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera android.icu.text.Bidi.reorderVisually(levels, levelStart, objects, objectStart, count); 41951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 42051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 42151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 42251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Display the bidi internal state, used in debugging. 42351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 42451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public String toString() { 42521c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer // Android-changed: construct String representation from ICU Bidi object values. 4266ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera return getClass().getName() 4276ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera + "[direction: " + bidiBase.getDirection() + " baseLevel: " + bidiBase.getBaseLevel() 4286ec7166ad3bf227db0752d80dd2a2b27ea262919Shubham Ajmera + " length: " + bidiBase.getLength() + " runs: " + bidiBase.getRunCount() + "]"; 42951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 43021c8c584aa3c7049a8b1be8e15f2f0ce83bf97c1Joachim Sauer 43151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski} 432