harmony 鸿蒙drawing_matrix.h

  • 2025-06-12
  • 浏览 (2)

drawing_matrix.h

概述

文件中定义了与矩阵相关的功能函数。

相关示例： NDKAPIDrawing (API14)

引用文件：

库： libnative_drawing.so

起始版本： 11

相关模块： Drawing

汇总

枚举

|名称|typedef关键字|描述| |–|–|–| |OH_Drawing_ScaleToFit|OH_Drawing_ScaleToFit|矩阵缩放方式枚举。|

函数

|名称|描述| |–|–| |OH_Drawing_Matrix* OH_Drawing_MatrixCreate(void)|用于创建一个矩阵对象。| |OH_Drawing_Matrix* OH_Drawing_MatrixCopy(const OH_Drawing_Matrix* matrix)|用于创建一个矩阵对象的拷贝。| |OH_Drawing_Matrix* OH_Drawing_MatrixCreateRotation(float deg, float x, float y)|创建一个带旋转属性的矩阵对象。
该矩阵对象为：单位矩阵在(x, y)旋转点以度为单位进行旋转后得到的矩阵。| |OH_Drawing_Matrix* OH_Drawing_MatrixCreateScale(float sx, float sy, float px, float py)|创建一个带缩放属性的矩阵对象。
该矩阵对象为：单位矩阵在(px, py)旋转点以sx和sy为缩放因子进行缩放后得到的矩阵。| |OH_Drawing_Matrix* OH_Drawing_MatrixCreateTranslation(float dx, float dy)|创建一个带平移属性的矩阵对象。
该矩阵对象为：单位矩阵平移(dx, dy)后得到的矩阵。| |void OH_Drawing_MatrixSetMatrix(OH_Drawing_Matrix* matrix, float scaleX, float skewX, float transX,float skewY, float scaleY, float transY, float persp0, float persp1, float persp2)|用于给矩阵对象设置参数。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
OH_Drawing_Matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |bool OH_Drawing_MatrixSetRectToRect(OH_Drawing_Matrix* matrix, const OH_Drawing_Rect* src,const OH_Drawing_Rect* dst, OH_Drawing_ScaleToFit stf)|将矩阵以缩放方式适配目标矩阵。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、src、dst任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |void OH_Drawing_MatrixPreRotate(OH_Drawing_Matrix* matrix, float degree, float px, float py)|将矩阵设置为矩阵左乘围绕轴心点旋转一定角度的单位矩阵后得到的矩阵。| |void OH_Drawing_MatrixPreScale(OH_Drawing_Matrix* matrix, float sx, float sy, float px, float py)|将矩阵设置为矩阵左乘围绕轴心点按一定缩放因子缩放后的单位矩阵后得到的矩阵。| |void OH_Drawing_MatrixPreTranslate(OH_Drawing_Matrix* matrix, float dx, float dy)|将矩阵设置为矩阵左乘平移一定距离后的单位矩阵后得到的矩阵。| |void OH_Drawing_MatrixPostRotate(OH_Drawing_Matrix* matrix, float degree, float px, float py)|将矩阵设置为矩阵右乘围绕轴心点旋转一定角度的单位矩阵后得到的矩阵。| |void OH_Drawing_MatrixPostScale(OH_Drawing_Matrix* matrix, float sx, float sy, float px, float py)|将矩阵设置为矩阵右乘围绕轴心点按一定缩放因子缩放后的单位矩阵后得到的矩阵。| |void OH_Drawing_MatrixPostTranslate(OH_Drawing_Matrix* matrix, float dx, float dy)|将矩阵设置为矩阵右乘平移一定距离后的单位矩阵后得到的矩阵。| |void OH_Drawing_MatrixReset(OH_Drawing_Matrix* matrix)|重置当前矩阵为单位矩阵。| |void OH_Drawing_MatrixConcat(OH_Drawing_Matrix* total, const OH_Drawing_Matrix* a,const OH_Drawing_Matrix* b)|将矩阵total设置为矩阵a乘以矩阵b。| |OH_Drawing_ErrorCode OH_Drawing_MatrixGetAll(OH_Drawing_Matrix* matrix, float value[9])|获取矩阵所有元素值。| |float OH_Drawing_MatrixGetValue(OH_Drawing_Matrix* matrix, int index)|获取矩阵给定索引位的值。索引范围0-8。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER；
index小于0或者大于8时返回OH_DRAWING_ERROR_PARAMETER_OUT_OF_RANGE。| |void OH_Drawing_MatrixRotate(OH_Drawing_Matrix* matrix, float degree, float px, float py)|设置矩阵为单位矩阵，并围绕位于(px, py)的旋转轴点进行旋转。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |void OH_Drawing_MatrixTranslate(OH_Drawing_Matrix* matrix, float dx, float dy)|设置矩阵为单位矩阵，并平移(dx, dy)。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |void OH_Drawing_MatrixScale(OH_Drawing_Matrix* matrix, float sx, float sy, float px, float py)|设置矩阵为单位矩阵，并围绕位于(px, py)的旋转轴点，以sx和sy进行缩放。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |bool OH_Drawing_MatrixInvert(OH_Drawing_Matrix* matrix, OH_Drawing_Matrix* inverse)|将矩阵inverse设置为矩阵的倒数，并返回结果。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、inverse任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |bool OH_Drawing_MatrixSetPolyToPoly(OH_Drawing_Matrix* matrix, const OH_Drawing_Point2D* src,const OH_Drawing_Point2D* dst, uint32_t count)|通过设置源点以及目标点，生成对应的变换矩阵。
源点以及目标点的个数要大于等于0，小于等于4。本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER；
count小于0或者大于4时返回OH_DRAWING_ERROR_PARAMETER_OUT_OF_RANGE。| |void OH_Drawing_MatrixMapPoints(const OH_Drawing_Matrix* matrix, const OH_Drawing_Point2D* src,OH_Drawing_Point2D* dst, int count)|通过矩阵变换将源点数组映射到目标点数组。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、src、dst任意一个为NULL或者count小于等于0时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |bool OH_Drawing_MatrixMapRect(const OH_Drawing_Matrix* matrix, const OH_Drawing_Rect* src, OH_Drawing_Rect* dst)|将目标矩形设置为一个新的矩形，该矩形是能够包围源矩形的四个顶点通过矩阵变换映射后形成的新顶点的最小矩形。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、src、dst任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |bool OH_Drawing_MatrixIsEqual(OH_Drawing_Matrix* matrix, OH_Drawing_Matrix* other)|判断两个矩阵是否相等。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、other任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。| |bool OH_Drawing_MatrixIsIdentity(OH_Drawing_Matrix* matrix)|判断矩阵是否是单位矩阵。| |void OH_Drawing_MatrixDestroy(OH_Drawing_Matrix* matrix)|用于销毁矩阵对象并回收该对象占有的内存。|

枚举类型说明

OH_Drawing_ScaleToFit

enum OH_Drawing_ScaleToFit

描述

矩阵缩放方式枚举。

起始版本： 12

|枚举项|描述| |–|–| |SCALE_TO_FIT_FILL|按水平轴和垂直轴缩放以填充目标矩形。| |SCALE_TO_FIT_START|缩放并对齐到左侧和顶部。| |SCALE_TO_FIT_CENTER|缩放并居中对齐。| |SCALE_TO_FIT_END|缩放并向右和向下对齐。|

函数说明

OH_Drawing_MatrixCreate()

OH_Drawing_Matrix* OH_Drawing_MatrixCreate(void)

描述

用于创建一个矩阵对象。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 11

返回：

|类型|说明| |–|–| |OH_Drawing_Matrix*|函数会返回一个指针，指针指向创建的矩阵对象。|

OH_Drawing_MatrixCopy()

OH_Drawing_Matrix* OH_Drawing_MatrixCopy(const OH_Drawing_Matrix* matrix)

描述

用于创建一个矩阵对象的拷贝。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 20

参数：

|参数项|描述| |–|–| |const OH_Drawing_Matrix* matrix|指向用于拷贝的矩阵对象OH_Drawing_Matrix的指针。|

返回：

|类型|说明| |–|–| |OH_Drawing_Matrix*|函数会返回一个指针，指针指向创建的新矩阵对象。|

OH_Drawing_MatrixCreateRotation()

OH_Drawing_Matrix* OH_Drawing_MatrixCreateRotation(float deg, float x, float y)

描述

创建一个带旋转属性的矩阵对象。
该矩阵对象为：单位矩阵在(x, y)旋转点以度为单位进行旋转后得到的矩阵。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |float deg|旋转的角度，单位为度。正数表示按顺时针旋转，负数表示按逆时针旋转。| |float x|轴上坐标点。| |float y|轴上坐标点。|

返回：

|类型|说明| |–|–| |OH_Drawing_Matrix*|函数返回一个指针，指针指向创建的矩阵对象OH_Drawing_Matrix。|

OH_Drawing_MatrixCreateScale()

OH_Drawing_Matrix* OH_Drawing_MatrixCreateScale(float sx, float sy, float px, float py)

描述

创建一个带缩放属性的矩阵对象。
该矩阵对象为：单位矩阵在(px, py)旋转点以sx和sy为缩放因子进行缩放后得到的矩阵。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |float sx|水平缩放因子，为负数时可看作是先关于y = px作镜像翻转后再进行缩放，该参数为浮点数。| |float sy|垂直缩放因子，为负数时可看作是先关于x = py作镜像翻转后再进行缩放，该参数为浮点数。| |float px|轴上坐标点。| |float py|轴上坐标点。|

返回：

|类型|说明| |–|–| |OH_Drawing_Matrix*|函数返回一个指针，指针指向创建的矩阵对象OH_Drawing_Matrix。|

OH_Drawing_MatrixCreateTranslation()

OH_Drawing_Matrix* OH_Drawing_MatrixCreateTranslation(float dx, float dy)

描述

创建一个带平移属性的矩阵对象。
该矩阵对象为：单位矩阵平移(dx, dy)后得到的矩阵。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |float dx|水平方向平移距离，正数表示往x轴正方向平移，负数表示往x轴负方向平移，该参数为浮点数。| |float dy|垂直方向平移距离，正数表示往y轴正方向平移，负数表示往y轴负方向平移，该参数为浮点数。|

返回：

|类型|说明| |–|–| |OH_Drawing_Matrix*|函数返回一个指针，指针指向创建的矩阵对象OH_Drawing_Matrix。|

OH_Drawing_MatrixSetMatrix()

void OH_Drawing_MatrixSetMatrix(OH_Drawing_Matrix* matrix, float scaleX, float skewX, float transX,float skewY, float scaleY, float transY, float persp0, float persp1, float persp2)

描述

用于给矩阵对象设置参数。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
OH_Drawing_Matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 11

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象的指针。| |float scaleX|水平缩放系数。| |float skewX|水平倾斜系数。| |float transX|水平位移系数。| |float skewY|垂直倾斜系数。| |float scaleY|垂直缩放系数。| |float transY|垂直位移系数。| |float persp0|X轴透视系数。| |float persp1|Y轴透视系数。| |float persp2|透视缩放系数。|

OH_Drawing_MatrixSetRectToRect()

bool OH_Drawing_MatrixSetRectToRect(OH_Drawing_Matrix* matrix, const OH_Drawing_Rect* src,const OH_Drawing_Rect* dst, OH_Drawing_ScaleToFit stf)

描述

将矩阵以缩放方式适配目标矩阵。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、src、dst任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |const OH_Drawing_Rect* src|指向映射源的OH_Drawing_Rect对象Rect的指针。| |const OH_Drawing_Rect* dst|指向要映射到的OH_Drawing_Rect对象Rect的指针。| |OH_Drawing_ScaleToFit stf|缩放方式，支持方式OH_Drawing_ScaleToFit。|

返回：

|类型|说明| |–|–| |bool|如果设置失败，则返回false；如果设置成功，则返回true；如果矩阵为空，则返回true，并将矩阵设置为：
如果源矩形src的宽高任意一个小于等于0，则返回false，并将矩阵设置为单位矩阵；
如果目标矩形dst的宽高任意一个小于等于0，则返回true，并将矩阵设置为除透视缩放系数为1外其余值皆为0的矩阵;|

OH_Drawing_MatrixPreRotate()

void OH_Drawing_MatrixPreRotate(OH_Drawing_Matrix* matrix, float degree, float px, float py)

描述

将矩阵设置为矩阵左乘围绕轴心点旋转一定角度的单位矩阵后得到的矩阵。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float degree|旋转角度，单位为度。正数表示顺时针旋转，负数表示逆时针旋转。| |float px|旋转中心点的横坐标。| |float py|旋转中心点的纵坐标。|

OH_Drawing_MatrixPreScale()

void OH_Drawing_MatrixPreScale(OH_Drawing_Matrix* matrix, float sx, float sy, float px, float py)

描述

将矩阵设置为矩阵左乘围绕轴心点按一定缩放因子缩放后的单位矩阵后得到的矩阵。

本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float sx|轴方向的缩放比例因子，为负数时可看作是先关于y = px作镜像翻转后再进行缩放，该参数为浮点数。| |float sy|轴方向的缩放比例因子，为负数时可看作是先关于x = py作镜像翻转后再进行缩放，该参数为浮点数。| |float px|缩放中心点的横坐标。| |float py|缩放中心点的纵坐标。|

OH_Drawing_MatrixPreTranslate()

void OH_Drawing_MatrixPreTranslate(OH_Drawing_Matrix* matrix, float dx, float dy)

描述

将矩阵设置为矩阵左乘平移一定距离后的单位矩阵后得到的矩阵。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float dx|表示在x轴方向上的平移距离，正数表示往x轴正方向平移，负数表示往x轴负方向平移，该参数为浮点数。| |float dy|表示在y轴方向上的平移距离，正数表示往y轴正方向平移，负数表示往y轴负方向平移，该参数为浮点数。|

OH_Drawing_MatrixPostRotate()

void OH_Drawing_MatrixPostRotate(OH_Drawing_Matrix* matrix, float degree, float px, float py)

描述

将矩阵设置为矩阵右乘围绕轴心点旋转一定角度的单位矩阵后得到的矩阵。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float degree|旋转角度，单位为度。正数表示顺时针旋转，负数表示逆时针旋转。| |float px|旋转中心点的横坐标。| |float py|旋转中心点的纵坐标。|

OH_Drawing_MatrixPostScale()

void OH_Drawing_MatrixPostScale(OH_Drawing_Matrix* matrix, float sx, float sy, float px, float py)

描述

将矩阵设置为矩阵右乘围绕轴心点按一定缩放因子缩放后的单位矩阵后得到的矩阵。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float sx|轴方向的缩放比例因子，为负数时可看作是先关于y = px作镜像翻转后再进行缩放，该参数为浮点数。| |float sy|轴方向的缩放比例因子，为负数时可看作是先关于x = py作镜像翻转后再进行缩放，该参数为浮点数。| |float px|缩放中心点的横坐标。| |float py|缩放中心点的纵坐标。|

OH_Drawing_MatrixPostTranslate()

void OH_Drawing_MatrixPostTranslate(OH_Drawing_Matrix* matrix, float dx, float dy)

描述

将矩阵设置为矩阵右乘平移一定距离后的单位矩阵后得到的矩阵。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float dx|表示在x轴方向上的平移距离，正数表示往x轴正方向平移，负数表示往x轴负方向平移，该参数为浮点数。| |float dy|表示在y轴方向上的平移距离，正数表示往y轴正方向平移，负数表示往y轴负方向平移，该参数为浮点数。|

OH_Drawing_MatrixReset()

void OH_Drawing_MatrixReset(OH_Drawing_Matrix* matrix)

描述

重置当前矩阵为单位矩阵。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。|

OH_Drawing_MatrixConcat()

void OH_Drawing_MatrixConcat(OH_Drawing_Matrix* total, const OH_Drawing_Matrix* a,const OH_Drawing_Matrix* b)

描述

将矩阵total设置为矩阵a乘以矩阵b。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
total、a、b任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* total|指向最终的矩阵对象OH_Drawing_Matrix的指针。| |const OH_Drawing_Matrix* a|指向矩阵对象aOH_Drawing_Matrix的指针。| |const OH_Drawing_Matrix* b|指向矩阵对象bOH_Drawing_Matrix的指针。|

OH_Drawing_MatrixGetAll()

OH_Drawing_ErrorCode OH_Drawing_MatrixGetAll(OH_Drawing_Matrix* matrix, float value[9])

描述

获取矩阵所有元素值。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |value| 用于存储得到的矩阵元素值的数组。|

返回：

|类型|说明| |–|–| |OH_Drawing_ErrorCode|返回错误码。
返回OH_DRAWING_SUCCESS，表示成功获取矩阵的所有元素值。
返回OH_DRAWING_ERROR_INVALID_PARAMETER，表示获取矩阵元素值失败，原因是矩阵对象或者存储矩阵元素值数组为空。|

OH_Drawing_MatrixGetValue()

float OH_Drawing_MatrixGetValue(OH_Drawing_Matrix* matrix, int index)

描述

获取矩阵给定索引位的值。索引范围0-8。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER；
index小于0或者大于8时返回OH_DRAWING_ERROR_PARAMETER_OUT_OF_RANGE。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |int index|索引位置，范围0-8。|

返回：

|类型|说明| |–|–| |float|函数返回矩阵给定索引位对应的值。|

OH_Drawing_MatrixRotate()

void OH_Drawing_MatrixRotate(OH_Drawing_Matrix* matrix, float degree, float px, float py)

描述

设置矩阵为单位矩阵，并围绕位于(px, py)的旋转轴点进行旋转。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float degree|角度，单位为度。正数表示顺时针旋转，负数表示逆时针旋转。| |float px|轴上坐标点。| |float py|轴上坐标点。|

OH_Drawing_MatrixTranslate()

void OH_Drawing_MatrixTranslate(OH_Drawing_Matrix* matrix, float dx, float dy)

描述

设置矩阵为单位矩阵，并平移(dx, dy)。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float dx|水平方向平移距离，正数表示往x轴正方向平移，负数表示往x轴负方向平移，该参数为浮点数。| |float dy|垂直方向平移距离，正数表示往y轴正方向平移，负数表示往y轴负方向平移，该参数为浮点数。|

OH_Drawing_MatrixScale()

void OH_Drawing_MatrixScale(OH_Drawing_Matrix* matrix, float sx, float sy, float px, float py)

描述

设置矩阵为单位矩阵，并围绕位于(px, py)的旋转轴点，以sx和sy进行缩放。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |float sx|水平缩放因子，为负数时可看作是先关于y = px作镜像翻转后再进行缩放，该参数为浮点数。| |float sy|垂直缩放因子，为负数时可看作是先关于x = py作镜像翻转后再进行缩放，该参数为浮点数。| |float px|轴上坐标点。| |float py|轴上坐标点。|

OH_Drawing_MatrixInvert()

bool OH_Drawing_MatrixInvert(OH_Drawing_Matrix* matrix, OH_Drawing_Matrix* inverse)

描述

将矩阵inverse设置为矩阵的倒数，并返回结果。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、inverse任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |OH_Drawing_Matrix* inverse|指向逆矩阵对象OH_Drawing_Matrix的指针，开发者可调用OH_Drawing_MatrixCreate接口创建。|

返回：

|类型|说明| |–|–| |bool|函数返回true表示矩阵可逆，inverse被填充为逆矩阵；函数返回false表示矩阵不可逆，inverse不被改变。|

OH_Drawing_MatrixSetPolyToPoly()

bool OH_Drawing_MatrixSetPolyToPoly(OH_Drawing_Matrix* matrix, const OH_Drawing_Point2D* src,const OH_Drawing_Point2D* dst, uint32_t count)

描述

通过设置源点以及目标点，生成对应的变换矩阵。
源点以及目标点的个数要大于等于0，小于等于4。本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER；
count小于0或者大于4时返回OH_DRAWING_ERROR_PARAMETER_OUT_OF_RANGE。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |const OH_Drawing_Point2D* src|源点数组，为NULL时count应当为0。| |const OH_Drawing_Point2D* dst|目标点数组，个数要与源点相等，为NULL时count应当为0。| |uint32_t count|源点数组以及目标点数组的个数，为0时将矩阵对象设为单位矩阵。|

返回：

|类型|说明| |–|–| |bool|函数返回是否可以生成对应矩阵以用来完成变换。true表示矩阵生成成功，false表示无法生成对应矩阵。|

OH_Drawing_MatrixMapPoints()

void OH_Drawing_MatrixMapPoints(const OH_Drawing_Matrix* matrix, const OH_Drawing_Point2D* src,OH_Drawing_Point2D* dst, int count)

描述

通过矩阵变换将源点数组映射到目标点数组。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、src、dst任意一个为NULL或者count小于等于0时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |const OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |const OH_Drawing_Point2D* src|源点数组。| |OH_Drawing_Point2D* dst|目标点数组，个数要与源点相等。| |int count|源点数组以及目标点数组的个数。|

OH_Drawing_MatrixMapRect()

bool OH_Drawing_MatrixMapRect(const OH_Drawing_Matrix* matrix, const OH_Drawing_Rect* src, OH_Drawing_Rect* dst)

描述

将目标矩形设置为一个新的矩形，该矩形是能够包围源矩形的四个顶点通过矩阵变换映射后形成的新顶点的最小矩形。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、src、dst任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |const OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。| |const OH_Drawing_Rect* src|源矩形。| |OH_Drawing_Rect* dst|目标矩形。|

返回：

|类型|说明| |–|–| |bool|函数返回源矩形与映射后的目标矩形是否相等。true表示相等，false表示不相等。|

OH_Drawing_MatrixIsEqual()

bool OH_Drawing_MatrixIsEqual(OH_Drawing_Matrix* matrix, OH_Drawing_Matrix* other)

描述

判断两个矩阵是否相等。
本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix、other任意一个为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向用于判断的其中一个矩阵对象OH_Drawing_Matrix的指针。| |OH_Drawing_Matrix* other|指向用于判断的另一个矩阵对象OH_Drawing_Matrix的指针。|

返回：

|类型|说明| |–|–| |bool|函数返回两个矩阵的比较结果，返回true表示两个矩阵相等，返回false表示两个矩阵不相等。|

OH_Drawing_MatrixIsIdentity()

bool OH_Drawing_MatrixIsIdentity(OH_Drawing_Matrix* matrix)

描述

判断矩阵是否是单位矩阵。
单位矩阵为 :|1 0 0||0 1 0||0 0 1|本接口会产生错误码，可以通过OH_Drawing_ErrorCodeGet查看错误码的取值。
matrix为NULL时返回OH_DRAWING_ERROR_INVALID_PARAMETER。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 12

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向矩阵对象OH_Drawing_Matrix的指针。|

返回：

|类型|说明| |–|–| |bool|函数返回true表示矩阵是单位矩阵，函数返回false表示矩阵不是单位矩阵。|

OH_Drawing_MatrixDestroy()

void OH_Drawing_MatrixDestroy(OH_Drawing_Matrix* matrix)

描述

用于销毁矩阵对象并回收该对象占有的内存。

系统能力： SystemCapability.Graphic.Graphic2D.NativeDrawing

起始版本： 11

参数：

|参数项|描述| |–|–| |OH_Drawing_Matrix* matrix|指向字体对象的指针。|

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkGraphics 2D（方舟2D图形服务）

harmony 鸿蒙buffer_common.h

harmony 鸿蒙buffer_handle.h

harmony 鸿蒙BufferHandle

harmony 鸿蒙ColorSpacePrimaries

harmony 鸿蒙DisplaySoloist_ExpectedRateRange

harmony 鸿蒙drawing_bitmap.h

harmony 鸿蒙drawing_brush.h

harmony 鸿蒙drawing_canvas.h

harmony 鸿蒙drawing_color_filter.h

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/t0kGL2
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录