diff --git a/graphic/graphic_2d/native_drawing/drawing_font.h b/graphic/graphic_2d/native_drawing/drawing_font.h index e8582939c07e7975b18b1b9d6b3b1a490574a927..81cb70dc035b8d94b015cf22cf033d68f4dfbe3c 100644 --- a/graphic/graphic_2d/native_drawing/drawing_font.h +++ b/graphic/graphic_2d/native_drawing/drawing_font.h @@ -280,6 +280,83 @@ OH_Drawing_ErrorCode OH_Drawing_FontMeasureSingleCharacter(const OH_Drawing_Font OH_Drawing_ErrorCode OH_Drawing_FontMeasureText(const OH_Drawing_Font* font, const void* text, size_t byteLength, OH_Drawing_TextEncoding encoding, OH_Drawing_Rect* bounds, float* textWidth); +/** + * @brief Measures the width of text with brush or pen. + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param font Indicates the pointer to an OH_Drawing_Font object. + * @param text Indicates the character storage encoded with text encoding. + * @param byteLength Indicates the text length in bytes. + * @param encoding Indicates the text encoding. + * @param brush Indicates the pointer to an OH_Drawing_Brush object. + * @param pen Indicates the pointer to an OH_Drawing_Pen object. + * @param bounds Gets the bounding box relative to (0, 0) if not nullptr. + * @param textWidth Indicates the width of text. + * @return Returns the error code. + * Returns {@link OH_DRAWING_SUCCESS} if the operation is successful. + * Returns {@link OH_DRAWING_ERROR_INVALID_PARAMETER} if any of font, text + * and textWidth is nullptr or byteLength is 0 or brush and pen are both not empty. + * @since 20 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_FontMeasureTextWithBrushOrPen(const OH_Drawing_Font* font, const void* text, + size_t byteLength, OH_Drawing_TextEncoding encoding, const OH_Drawing_Brush* brush, const OH_Drawing_Brush* pen, + OH_Drawing_Rect* bounds, float* textWidth); + +/** + * @brief Retrieves the advance and bounding box for each glyph in glyphs + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param font Indicates the pointer to an OH_Drawing_Font object. + * @param glyphs Indicates the array of glyph indices to be measured. + * @param count Indicates the number of glyphs. + * @param brush Indicates the pointer to an OH_Drawing_Brush object. + * @param pen Indicates the pointer to an OH_Drawing_Pen object. + * @param widths Indicates the text advances for each glyph returned to the caller. + * @param bounds Indicates the text bounding box for each glyph returned to caller. + * @return Returns the error code. + * Returns {@link OH_DRAWING_SUCCESS} if the operation is successful. + * Returns {@link OH_DRAWING_ERROR_INVALID_PARAMETER} if any of font and glyphs is nullptr + * or count is no larger than 0 or brush and pen are both not empty. + * @since 20 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_FontGetWidthsBounds(const OH_Drawing_Font* font, const uint16_t* glyphs, int count, + const OH_Drawing_Brush* brush, const OH_Drawing_Brush* pen, float* widths, OH_Drawing_Array* bounds); + +/** + * @brief Retrieves the positions for each glyph, beginning at the specified origin. + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param font Indicates the pointer to an OH_Drawing_Font object. + * @param glyphs Indicates the array of glyph indices to be measured. + * @param count Indicates the number of glyphs. + * @param origin Indicates the location of the first glyph. + * @param points Indicates the relative position for each glyph returned to tha caller. + * @return Returns the error code. + * Returns {@link OH_DRAWING_SUCCESS} if the operation is successful. + * Returns {@link OH_DRAWING_ERROR_INVALID_PARAMETER} if any of font, glyphs and points is nullptr or + * count is not larger than 0. + * @since 20 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_FontGetPos(const OH_Drawing_Font* font, const uint16_t* glyphs, int count, + const OH_Drawing_Point* origin, OH_Drawing_Point2D* bounds); + +/** + * @brief Returns the recommended spacing between lines. + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param font Indicates the pointer to an OH_Drawing_Font object. + * @param spacing Indicates the recommended spacing between lines. + * @return Returns the error code. + * Returns {@link OH_DRAWING_SUCCESS} if the operation is successful. + * Returns {@link OH_DRAWING_ERROR_INVALID_PARAMETER} if any of font and spacing is nullptr. + * @since 20 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_FontGetSpacing(const OH_Drawing_Font* font, float* spacing); + /** * @brief Enables or disables linearly scalable font for an OH_Drawing_Font object. * diff --git a/graphic/graphic_2d/native_drawing/libnative_drawing.ndk.json b/graphic/graphic_2d/native_drawing/libnative_drawing.ndk.json index 9218ad279c10fb39c77bd175551d3a479c713686..21ee8d28caf53d5866590b565b268fc41e4758c9 100644 --- a/graphic/graphic_2d/native_drawing/libnative_drawing.ndk.json +++ b/graphic/graphic_2d/native_drawing/libnative_drawing.ndk.json @@ -282,6 +282,22 @@ "first_introduced": "12", "name": "OH_Drawing_FontMeasureText" }, + { + "first_introduced": "20", + "name": "OH_Drawing_FontMeasureTextWithBrushOrPen" + }, + { + "first_introduced": "20", + "name": "OH_Drawing_FontGetWidthsBounds" + }, + { + "first_introduced": "20", + "name": "OH_Drawing_FontGetPos" + }, + { + "first_introduced": "20", + "name": "OH_Drawing_FontGetSpacing" + }, { "first_introduced": "12", "name": "OH_Drawing_FontSetBaselineSnap"