text/bidi/BidiBase.java

85  * <h3>Basic concept: paragraph</h3>
126  * a default for the paragraph level for
181  * <h5>Rendering a paragraph with the ICU Bidi API</h5>
184  * could be used to render a paragraph of text. Rendering code depends highly on
501  * algorithm that are not needed on the specific paragraph
517  * and all levels are set to the paragraph level.
528  * consider if the paragraph direction should be considered in
531  * If there are no White Space types in the paragraph, then
587      * then set the paragraph level to 0 (left-to-right).<p>
613      * then set the paragraph level to 1 (right-to-left).<p>
672      *     that the source string is empty and the paragraph level is even.
686      *     that the source string is empty and the paragraph level is odd.
1043      * reference to parent paragraph object (reference to self if this object is
1044      * a paragraph object); set to null in a newly opened object; set to a
1092     /* the paragraph level */
1103     /* the overall paragraph or line directionality*/
1116     /* fields for paragraph handling, set in getDirProps() */
1191     /* paragraph and segment separators */
1463      * determine the paragraph level if necessary (in paras_level[i]).
1498        lastStack is reset to -1 on paragraph boundaries. */
1519         /* count paragraphs and determine the paragraph level (P2..P3) */
1614                    thus some updates are only done on paragraph boundaries */
1650         /* When streaming, ignore text after the last paragraph separator */
1659            a strong R or AL at either end of the paragraph */
1676     /* determine the paragraph level at position index */
1719     /* paragraph boundary */
1835            Example: RTL paragraph containing:  abc[(latin) HEBREW]
2058      * entire paragraph at once instead of having to parse it once more and
2065      * On one hand, the paragraph has to be scanned for same-level-runs, but
2106             /* set all levels to the paragraph level */
2121             /* no embeddings, set all levels to the paragraph level */
2574     /*     ON following an R sequence within an even-level paragraph.    */
2578     /*     to paragraph level in adjustWSLevels().                       */
2581     private static final byte impTabL_DEFAULT[][] = /* Even paragraph level */
2595     private static final byte impTabR_DEFAULT[][] = /* Odd  paragraph level */
2614     private static final byte impTabL_NUMBERS_SPECIAL[][] = { /* Even paragraph level */
2683     private static final byte impTabR_INVERSE_LIKE_DIRECT[][] = {  /* Odd  paragraph level */
3163      * from the paragraph in (X9).
3172                 /* reset a sequence of WS/BN before eop and B/S to the paragraph paraLevel */
3384      * separator in the text terminates a paragraph, and whatever comes next starts
3385      * a new paragraph. The exception to this rule is when a Carriage Return (CR)
3388      * preceding paragraph, and a new paragraph will be started by a character
3401      *        If the method shall determine the paragraph level from the text,
3405      *        paragraphs, the paragraph level shall be determined separately for
3406      *        each paragraph; if a paragraph does not include any strongly typed
3419      *        paragraph separator even if <code>paraLevel&gt;0</code> when multiple
3469      * separator in the text terminates a paragraph, and whatever comes next starts
3470      * a new paragraph. The exception to this rule is when a Carriage Return (CR)
3473      * preceding paragraph, and a new paragraph will be started by a character
3485      *        If the method shall determine the paragraph level from the text,
3489      *        paragraphs, the paragraph level shall be determined separately for
3490      *        each paragraph; if a paragraph does not include any strongly typed
3503      *        paragraph separator even if <code>paraLevel&gt;0</code> when multiple
3565              * For an empty paragraph, create a Bidi object with the paraLevel and
3585          * determine the paragraph level if necessary.
3614          * the paragraph text has mixed directionality!
3664              * then we can treat the entire paragraph as one run.
3699                         /* except if this is a new paragraph, then set sor = para level */
3757                     continue;           /* LTR paragraph */
3786      * Perform the Unicode Bidi algorithm on a given paragraph, as defined in the
3791      * This method takes a paragraph of text and computes the
3800      * in the paragraph.<p>
3810      * attribute, if present, must be applied to all the text in the paragraph.
3821      * @param paragraph a paragraph of text with optional character and
3822      *        paragraph attribute information
3825     public void setPara(AttributedCharacterIterator paragraph)
3828         char ch = paragraph.first();
3830           (Boolean) paragraph.getAttribute(TextAttributeConstants.RUN_DIRECTION);
3831         Object shaper = paragraph.getAttribute(TextAttributeConstants.NUMERIC_SHAPING);
3841         int len = paragraph.getEndIndex() - paragraph.getBeginIndex();
3848                 (Integer) paragraph.getAttribute(TextAttributeConstants.BIDI_EMBEDDING);
3861             ch = paragraph.next();
3876      * means that all paragraph separators (including one possibly appearing
3879      * When this feature is not enabled, a paragraph separator at the last
3881      * of the reordered text when the paragraph level is odd.
3883      * @param ordarParaLTR specifies whether paragraph separators (B) must
3934      * Get the paragraph level of the text.
3936      * @return The paragraph level. If there are multiple paragraphs, their
3938      *         LEVEL_DEFAULT_RTL.  In that case, the level of the first paragraph
3989      * It is not necessary if each paragraph is treated as a single line.<p>
4011      *         or if the specified line crosses a paragraph boundary
4170      * <code>Bidi</code> (paragraph or line) object.
4252      * @param text an array containing the paragraph of text to process.
4254      *        paragraph.
4256      *        in the paragraph. This can be null, in which case it is assumed
4259      *        paragraph.
4260      * @param paragraphLength the length of the paragraph in the text and