+// © 2016 and later: Unicode, Inc. and others.
+// License & terms of use: http://www.unicode.org/copyright.html
/*
**********************************************************************
- * Copyright (C) 2002-2004, International Business Machines
+ * Copyright (C) 2002-2014, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
*/
#define __PARAGRAPHLAYOUT_H
+/**
+ * \file
+ * \brief C++ API: Paragraph Layout
+ */
+
/*
* ParagraphLayout doesn't make much sense without
* BreakIterator...
*
* Clients can use this to break a paragraph into lines, and to display the glyphs in each line.
*
+ * Note that {@link icu::LayoutEngine} is deprecated, but this class is not.
+ * You may use this class with the HarfBuzz icu-le-hb wrapper,
+ * see http://www.freedesktop.org/wiki/Software/HarfBuzz/
+ *
+ * See http://userguide.icu-project.org/layoutengine for special build instructions.
+ *
+ * @see icu::LayoutEngine
*/
class U_LAYOUTEX_API ParagraphLayout : public UObject
{
* @see ParagraphLayout
* @see ParagraphLayout::VisualRun
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
class U_LAYOUTEX_API Line : public UObject
{
* clients responsibility to destroy the objects, so the destructor
* is public.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
~Line();
*
* @return the number of visual runs.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- le_int32 countRuns() const;
+ inline le_int32 countRuns() const;
/**
* Get the ascent of the line. This is the maximum ascent
*
* @return the ascent of the line.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
le_int32 getAscent() const;
*
* @return the descent of the line.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
le_int32 getDescent() const;
*
* @return the leading of the line.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
le_int32 getLeading() const;
*
* @return the width of the line.
*
- * @draft ICU 2.8
+ * @stable ICU 2.8
*/
le_int32 getWidth() const;
*
* @see ParagraphLayout::VisualRun
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
const VisualRun *getVisualRun(le_int32 runIndex) const;
/**
- * ICU "poor man's RTTI", returns a UClassID for the actual class.
+ * ICU "poor man's RTTI", returns a UClassID for this class.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- virtual inline UClassID getDynamicClassID() const { return getStaticClassID(); }
+ static inline UClassID getStaticClassID() { return (UClassID)&fgClassID; }
/**
- * ICU "poor man's RTTI", returns a UClassID for this class.
+ * ICU "poor man's RTTI", returns a UClassID for the actual class.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- static inline UClassID getStaticClassID() { return (UClassID)&fgClassID; }
+ virtual inline UClassID getDynamicClassID() const { return getStaticClassID(); }
private:
VisualRun **fRuns;
- Line();
- Line(const Line &other);
- Line &operator=(const Line & /*other*/) { return *this; };
+ inline Line();
+ inline Line(const Line &other);
+ inline Line &operator=(const Line & /*other*/) { return *this; };
void computeMetrics();
*
* @see ParagraphLayout::Line
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
class U_LAYOUTEX_API VisualRun : public UObject
{
*
* @see LEFontInstance
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- const LEFontInstance *getFont() const;
+ inline const LEFontInstance *getFont() const;
/**
* Get the direction of the visual run.
* @return the direction of the run. This will be UBIDI_LTR if the
* run is left-to-right and UBIDI_RTL if the line is right-to-left.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- UBiDiDirection getDirection() const;
+ inline UBiDiDirection getDirection() const;
/**
* Get the number of glyphs in the visual run.
*
* @return the number of glyphs.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- le_int32 getGlyphCount() const;
+ inline le_int32 getGlyphCount() const;
/**
* Get the glyphs in the visual run. Glyphs with the values <code>0xFFFE</code> and
* is owned by the <code>VisualRun</code> object and must not be deleted.
* It will remain valid as long as the <code>VisualRun</code> object is valid.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- const LEGlyphID *getGlyphs() const;
+ inline const LEGlyphID *getGlyphs() const;
/**
* Get the (x, y) positions of the glyphs in the visual run. To simplify storage
* is owned by the <code>VisualRun</code> object and must not be deleted.
* It will remain valid as long as the <code>VisualRun</code> object is valid.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- const float *getPositions() const;
+ inline const float *getPositions() const;
/**
* Get the glyph-to-character map for this visual run. This maps the indices into
* is owned by the <code>VisualRun</code> object and must not be deleted.
* It will remain valid as long as the <code>VisualRun</code> object is valid.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- const le_int32 *getGlyphToCharMap() const;
+ inline const le_int32 *getGlyphToCharMap() const;
/**
* A convenience method which returns the ascent value for the font
*
* @return the ascent value of this run's font.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- le_int32 getAscent() const;
+ inline le_int32 getAscent() const;
/**
* A convenience method which returns the descent value for the font
*
* @return the descent value of this run's font.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- le_int32 getDescent() const;
+ inline le_int32 getDescent() const;
/**
* A convenience method which returns the leading value for the font
*
* @return the leading value of this run's font.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- le_int32 getLeading() const;
+ inline le_int32 getLeading() const;
/**
- * ICU "poor man's RTTI", returns a UClassID for the actual class.
+ * ICU "poor man's RTTI", returns a UClassID for this class.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- virtual inline UClassID getDynamicClassID() const { return getStaticClassID(); }
+ static inline UClassID getStaticClassID() { return (UClassID)&fgClassID; }
/**
- * ICU "poor man's RTTI", returns a UClassID for this class.
+ * ICU "poor man's RTTI", returns a UClassID for the actual class.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- static inline UClassID getStaticClassID() { return (UClassID)&fgClassID; }
+ virtual inline UClassID getDynamicClassID() const { return getStaticClassID(); }
private:
friend class Line;
- VisualRun();
- VisualRun(const VisualRun &other);
- VisualRun &operator=(const VisualRun &other) { return *this; };
+ inline VisualRun();
+ inline VisualRun(const VisualRun &other);
+ inline VisualRun &operator=(const VisualRun &/*other*/) { return *this; };
- VisualRun(const LEFontInstance *font, UBiDiDirection direction, le_int32 glyphCount,
+ inline VisualRun(const LEFontInstance *font, UBiDiDirection direction, le_int32 glyphCount,
const LEGlyphID glyphs[], const float positions[], const le_int32 glyphToCharMap[]);
~VisualRun();
* @see LayoutEngine.h
* @see RunArrays.h
*
- * @draft ICU 2.8
+ * @stable ICU 2.8
*/
ParagraphLayout(const LEUnicode chars[], le_int32 count,
const FontRuns *fontRuns,
* The destructor. Virtual so that it works correctly with
* sublcasses.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
~ParagraphLayout();
*
* @return <code>TRUE</code> if the paragraph contains complex text.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
static le_bool isComplex(const LEUnicode chars[], le_int32 count, const FontRuns *fontRuns);
#else
*
* @return <code>TRUE</code> if any of the text requires complex processing.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
static le_bool isComplex(const LEUnicode chars[], le_int32 count);
*
* @return the resolved paragraph level.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- UBiDiLevel getParagraphLevel();
+ inline UBiDiLevel getParagraphLevel();
/**
* Return the directionality of the text in the paragraph.
* <code>UBIDI_RTL</code> if the text is all right to left,
* or <code>UBIDI_MIXED</code> if the text has mixed direction.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- UBiDiDirection getTextDirection();
+ inline UBiDiDirection getTextDirection();
/**
* Return the max ascent value for all the fonts
*
* @return the ascent value.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
virtual le_int32 getAscent() const;
*
* @return the decent value.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
virtual le_int32 getDescent() const;
*
* @return the leading value.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
virtual le_int32 getLeading() const;
* Reset line breaking to start from the beginning of the paragraph.
*
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- void reflow();
+ inline void reflow();
+
+#ifndef U_HIDE_INTERNAL_API
+ /**
+ *
+ * Convenience method for determining if paragraph layout processing is complete ( i.e. there
+ * are no more lines left to process. )
+ *
+ * @return true if there are no more lines to be processed
+ *
+ * @internal
+ */
+ inline le_bool isDone() const;
+#endif /* U_HIDE_INTERNAL_API */
/**
* Return a <code>ParagraphLayout::Line</code> object which represents next line
*
* @see ParagraphLayout::Line
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
Line *nextLine(float width);
/**
- * ICU "poor man's RTTI", returns a UClassID for the actual class.
+ * ICU "poor man's RTTI", returns a UClassID for this class.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- virtual inline UClassID getDynamicClassID() const { return getStaticClassID(); }
+ static inline UClassID getStaticClassID() { return (UClassID)&fgClassID; }
/**
- * ICU "poor man's RTTI", returns a UClassID for this class.
+ * ICU "poor man's RTTI", returns a UClassID for the actual class.
*
- * @draft ICU 2.6
+ * @stable ICU 3.2
*/
- static inline UClassID getStaticClassID() { return (UClassID)&fgClassID; }
+ virtual inline UClassID getDynamicClassID() const { return getStaticClassID(); }
private:
ParagraphLayout() {};
ParagraphLayout(const ParagraphLayout & /*other*/) : UObject( ){};
- ParagraphLayout &operator=(const ParagraphLayout & /*other*/) { return *this; };
+ inline ParagraphLayout &operator=(const ParagraphLayout & /*other*/) { return *this; };
void computeLevels(UBiDiLevel paragraphLevel);
// nothing
}
-inline ParagraphLayout::VisualRun::VisualRun(const VisualRun &other)
+inline ParagraphLayout::VisualRun::VisualRun(const VisualRun &/*other*/)
: UObject(), fFont(NULL), fDirection(UBIDI_LTR), fGlyphCount(0), fGlyphs(NULL), fPositions(NULL), fGlyphToCharMap(NULL)
{
// nothing
projects / apple / icu.git / blobdiff