diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_bitmap.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_bitmap.h index 273294b593c62247d23230f2248c55b21078b528..fd6423ca8774ab2f9607b590bb81223c55c13a15 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_bitmap.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_bitmap.h @@ -59,6 +59,25 @@ typedef struct OH_Drawing_BitmapFormat { OH_Drawing_AlphaFormat alphaFormat; } OH_Drawing_BitmapFormat; +/** + * @brief 位图颜色空间类型枚举。 + * + * @since 12 + * @version 1.0 + */ +typedef enum OH_Drawing_ColorSpaceType { + /** 无颜色空间类型。 */ + NO_TYPE, + /** SRGB颜色空间类型。 */ + SRGB, + /** 具有线性属性的SRGB颜色空间类型。 */ + SRGB_LINEAR, + /** 以图像为参考的颜色空间类型。 */ + REF_IMAGE, + /** RGB颜色空间类型。 */ + RGB, +} OH_Drawing_ColorSpaceType; + /** * @brief 用于创建一个位图对象。 * @@ -216,6 +235,89 @@ void OH_Drawing_BitmapGetImageInfo(OH_Drawing_Bitmap*, OH_Drawing_Image_Info*); bool OH_Drawing_BitmapReadPixels(OH_Drawing_Bitmap*, const OH_Drawing_Image_Info* dstInfo, void* dstPixels, size_t dstRowBytes, int32_t srcX, int32_t srcY); +/** + * @brief 用于初始化位图对象的宽度、高度、像素格式和透明度格式,并且为该位图设置颜色空间类型和像素数据每行的字节数。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Image_Info 指向图片信息对象{@link OH_Drawing_Image_Info}的指针。 + * @param OH_Drawing_ColorSpace 指向位图颜色空间信息对象{@link OH_Drawing_ColorSpace}的指针。 + * @param rowBytes 位图对象像素数据每行的字节数,应大于或等于图片信息对象中的最小每行字节数。 + * @return OH_Drawing_Bitmap 函数返回一个指针,指针指向初始化的位图对象{@link OH_Drawing_Bitmap}。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_Bitmap* OH_Drawing_BitmapCreateFromImageInfo(const OH_Drawing_Image_Info*, OH_Drawing_ColorSpace*, + int32_t rowBytes); + +/** + * @brief 用于获取位图对象像素数据每行的字节数。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Bitmap 指向位图对象{@link OH_Drawing_Bitmap}的指针。 + * @return 返回位图对象像素数据每行的字节数。 + * @since 12 + * @version 1.0 + */ +uint32_t OH_Drawing_BitmapGetRowBytes(const OH_Drawing_Bitmap*); + +/** + * @brief 用于获取位图对象的颜色空间类型。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Bitmap 指向位图对象{@link OH_Drawing_Bitmap}的指针。 + * @return OH_Drawing_ColorSpaceType 返回位图对象颜色空间枚举类型{@link OH_Drawing_ColorSpaceType}。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ColorSpaceType OH_Drawing_BitmapGetColorSpaceType(OH_Drawing_Bitmap*); + +/** + * @brief 用于获取位图对象的子集。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param bitmap 指向位图对象{@link OH_Drawing_Bitmap}的指针。 + * @param dstBitmap 指向目标位图对象{@link OH_Drawing_Bitmap}的指针。 + * @param OH_Drawing_Rect 此位图中目标位图对象将引用的像素矩形对象{@link OH_Drawing_Rect}的指针。 + * @return 返回位图对象子集的获取结果,true表示获取成功,false表示获取失败。 + * @since 12 + * @version 1.0 + */ +bool OH_Drawing_BitmapExtractSubset(const OH_Drawing_Bitmap* bitmap, const OH_Drawing_Bitmap* dstBitmap, + const OH_Drawing_Rect* subset); + +/** + * @brief 用于获取位图对象的内容是否不可改变。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Bitmap 指向位图对象{@link OH_Drawing_Bitmap}的指针。 + * @return 返回位图对象的内容是否不可改变,true表示不可改变,false表示可以改变。 + * @since 12 + * @version 1.0 + */ +bool OH_Drawing_BitmapIsImmutable(const OH_Drawing_Bitmap*); + +/** + * @brief 用于设置位图对象内容不可改变。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Bitmap 指向位图对象{@link OH_Drawing_Bitmap}的指针。 + * @since 12 + * @version 1.0 + */ +void OH_Drawing_BitmapSetImmutable(OH_Drawing_Bitmap*); + +/** + * @brief 用于初始化一个位图对象,并尝试将位图像素存储内存地址设置为开发者申请内存的地址。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Bitmap 指向位图对象{@link OH_Drawing_Bitmap}的指针。 + * @param OH_Drawing_Image_Info 指向图片信息对象{@link OH_Drawing_Image_Info}的指针。 + * @return 返回位图对象初始化的结果,true表示初始化成功,false表示初始化失败。 + * @since 12 + * @version 1.0 + */ +bool OH_Drawing_BitmapTryAllocPixels(OH_Drawing_Bitmap*, const OH_Drawing_Image_Info*); + #ifdef __cplusplus } #endif diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_brush.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_brush.h index b1b8ad3dcedbbe15cf06a5b92185617339ab33e8..b44857ddddd48132fea50b418d166d5d7b625228 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_brush.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_brush.h @@ -40,6 +40,7 @@ * @version 1.0 */ +#include "drawing_error_code.h" #include "drawing_types.h" #ifdef __cplusplus @@ -179,6 +180,20 @@ void OH_Drawing_BrushSetAlpha(OH_Drawing_Brush*, uint8_t alpha); */ void OH_Drawing_BrushSetShaderEffect(OH_Drawing_Brush*, OH_Drawing_ShaderEffect*); +/** + * @brief 为画刷获取着色器效果。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Brush 指向画刷对象的指针。 + * @param OH_Drawing_ShaderEffect 表示指向着色器对象的指针。 + * @return 函数返回执行错误码。 + * 返回{@link OH_DRAWING_SUCCESS},表示执行成功。 + * 返回{@link OH_DRAWING_ERROR_INVALID_PARAMETER},表示参数cBrush或者cShaderEffect为空。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_BrushGetShaderEffect(OH_Drawing_Brush* cBrush, OH_Drawing_ShaderEffect* cShaderEffect); + /** * @brief 为画刷设置阴影层,设置的阴影层效果当前仅在绘制文字时生效。 * diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_canvas.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_canvas.h index 3f8d3185da8897fcd2f5e9ef3b767e27a3406c5b..177aaef3cc045b352ba59306084d73738921dc67 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_canvas.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_canvas.h @@ -41,6 +41,7 @@ * @version 1.0 */ +#include "drawing_error_code.h" #include "drawing_types.h" #ifdef __cplusplus @@ -866,6 +867,19 @@ void OH_Drawing_CanvasDrawShadow(OH_Drawing_Canvas*, OH_Drawing_Path*, OH_Drawin OH_Drawing_Point3D devLightPos, float lightRadius, uint32_t ambientColor, uint32_t spotColor, OH_Drawing_CanvasShadowFlags flag); +/** + * @brief 用于判断裁剪后可绘制区域是否不为空且为矩形。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Canvas 指向画布对象{@link OH_Drawing_Canvas}的指针。 + * @param isClipRect 表示裁剪后可绘制区域是否不为空且为矩形。 + * @return 函数返回执行错误码。 + * 返回{@link OH_DRAWING_SUCCESS},表示执行成功。 + * 返回{@link OH_DRAWING_ERROR_INVALID_PARAMETER},表示参数cCanvas或者isClipRect为空。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_CanvasIsClipRect(OH_Drawing_Canvas* cCanvas, bool* isClipRect); #ifdef __cplusplus } #endif diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_color_filter.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_color_filter.h index e563e119b1b0969dd0f714ed80e69be659e9737f..1a3a79b1e9db00a11cceb50ccac5601c28894026 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_color_filter.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_color_filter.h @@ -46,6 +46,16 @@ extern "C" { #endif +/** + * @brief 创建一个颜色滤镜对象,没有滤镜类型。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @return 返回创建的颜色滤波器对象的指针。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ColorFilter* OH_Drawing_ColorFilterCreate(); + /** * @brief 创建具有混合模式的颜色滤波器。 * diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_image.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_image.h index 4158a0b373ab77792360de23578a13a63d65bbb4..2a22d564849334a87d4328961f1cb738d4af36a2 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_image.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_image.h @@ -40,6 +40,7 @@ * @version 1.0 */ +#include "drawing_error_code.h" #include "drawing_types.h" #ifdef __cplusplus @@ -125,6 +126,60 @@ int32_t OH_Drawing_ImageGetHeight(OH_Drawing_Image*); */ void OH_Drawing_ImageGetImageInfo(OH_Drawing_Image*, OH_Drawing_Image_Info*); +/** + * @brief 获取图片的颜色空间。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Image 指向图片对象{@link OH_Drawing_Image}的指针。 + * @return 返回图片的颜色空间。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ColorSpace* OH_Drawing_ImageGetColorSpace(const OH_Drawing_Image*); + +/** + * @brief 获取图片的唯一标识符。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param cImage 指向图片对象{@link OH_Drawing_Image}的指针。 + * @param cUnique 表示图片的唯一标识符。 + * @return 函数返回执行错误码。 + * 返回{@link OH_DRAWING_SUCCESS},表示执行成功。 + * 返回{@link OH_DRAWING_ERROR_INVALID_PARAMETER},表示参数cImage和cUnique中至少有一个为空。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_ImageGetUniqueID(const OH_Drawing_Image* cImage, uint32_t* cUnique); + +/** + * @brief 获取图片是否不透明。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Image 指向图片对象{@link OH_Drawing_Image}的指针。 + * @return 函数返回true表示图片是不透明的,函数返回false表示图片是透明的。 + * @since 12 + * @version 1.0 + */ +bool OH_Drawing_ImageIsOpaque(const OH_Drawing_Image*); + +/** + * @brief 获取图片是否缩放大小以适应位图。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Image 指向图片对象{@link OH_Drawing_Image}的指针。 + * @param OH_Drawing_Bitmap 指向位图对象{@link OH_Drawing_Bitmap}的指针。 + * @param OH_Drawing_SamplingOptions 指向采样选项对象{@link OH_Drawing_SamplingOptions}的指针。 + * @param isAllowCachingHint 指示是否将图片缓存在本地。 + * @param isScaled 指示图片是否被缩放大小以适应位图。 + * @return 函数返回执行错误码。 + * 返回{@link OH_DRAWING_SUCCESS},表示执行成功。 + * 返回{@link OH_DRAWING_ERROR_INVALID_PARAMETER},表示参数cImage,cBitmap,cSampling和isScaled中至少有一个为空。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_ImageScalePixels(const OH_Drawing_Image* cImage, const OH_Drawing_Bitmap* cBitmap, + const OH_Drawing_SamplingOptions* cSampling, bool isAllowCachingHint, bool* isScaled); + #ifdef __cplusplus } #endif diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_image_filter.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_image_filter.h index 2ba8e8f7870b251870187c531592776151990035..a12df559eba73f1911f98c92e2e65bf22f37034b 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_image_filter.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_image_filter.h @@ -79,6 +79,19 @@ OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateBlur(float sigmaX, float sig OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateFromColorFilter(OH_Drawing_ColorFilter* colorFilter, OH_Drawing_ImageFilter* input); +/** + * @brief 创建一个组合图像滤波器。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param ImageFilterOne 指向图像滤波器对象{@link OH_Drawing_ImageFilter}的指针。 + * @param ImageFilterTwo 指向图像滤波器对象{@link OH_Drawing_ImageFilter}的指针。 + * @return 返回一个图像滤波器指针。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ImageFilter* OH_Drawing_ImageFilterCreateComposeImageFilter( + OH_Drawing_ImageFilter* ImageFilterOne, OH_Drawing_ImageFilter* ImageFilterTwo); + /** * @brief 销毁图像滤波器对象并回收该对象占有内存。 * diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_path_effect.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_path_effect.h index a86d84bcd09f8d15b68f24c9b484dc8355a58531..a4cd72cf5247e53d274eaa4381ea55f96fea0fe3 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_path_effect.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_path_effect.h @@ -63,6 +63,70 @@ extern "C" { */ OH_Drawing_PathEffect* OH_Drawing_CreateDashPathEffect(float* intervals, int count, float phase); +/** + * @brief 创建一个虚线效果的路径效果对象。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param path 指定要使用的路径。 + * @param advance 指示每个路径图的间距或进度。 + * @param phase 虚线间隔数组中偏移量。 + * @return 函数返回一个指针,指针指向创建的路径效果对象{@link OH_Drawing_PathEffect}。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_PathEffect* OH_Drawing_CreatePathDashEffect(const OH_Drawing_Path* path, + float advance, float phase, OH_Drawing_PathDashStyle); + +/** + * @brief 创建一个拐角路径效果对象。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param radius 指定每个圆角的半径并且大于0。 + * @return 函数返回一个指针,指针指向创建的路径效果对象{@link OH_Drawing_PathEffect}。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_PathEffect* OH_Drawing_CreateCornerPathEffect(float radius); + +/** + * @brief 创建一个离散的路径效果对象。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param segLength 表示路径效应中每个离散段的长度。 + * @param dev 表示每个离散段的偏移量。 + * @param seedAssist 表示调用者提供的。如果没有提供,默认为0。 + * @return 函数返回一个指针,指针指向创建的路径效果对象{@link OH_Drawing_PathEffect}。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_PathEffect* OH_Drawing_CreateDiscretePathEffect(float segLength, float dev, uint32_t seedAssist); + +/** + * @brief 创建一个添加路径特效对象。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param cPathEffectOne 表示第一个路径效应。 + * @param cPathEffectTwo 表示第二个路径效应。 + * @return 函数返回一个指针,指针指向创建的路径效果对象{@link OH_Drawing_PathEffect}。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_PathEffect* OH_Drawing_CreateSumPathEffect(OH_Drawing_PathEffect* cPathEffectOne, + OH_Drawing_PathEffect* cPathEffectTwo); + +/** + * @brief 创建一个组合路径特效对象 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param cPathEffectOne 表示第一个路径效应。 + * @param cPathEffectTwo 表示第二个路径效应。 + * @return 函数返回一个指针,指针指向创建的路径效果对象{@link OH_Drawing_PathEffect}。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_PathEffect* OH_Drawing_CreateComposePathEffect(OH_Drawing_PathEffect* cPathEffectOne, + OH_Drawing_PathEffect* cPathEffectTwo); + /** * @brief 销毁路径效果对象并回收该对象占有内存。 * diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_pen.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_pen.h index dabe04aad617a300fe0a585f349ef6eb5c6aa3cf..ca982b0a1c7a14f9932ed9e47053eeceda7404ce 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_pen.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_pen.h @@ -40,6 +40,7 @@ * @version 1.0 */ +#include "drawing_error_code.h" #include "drawing_types.h" #ifdef __cplusplus @@ -322,6 +323,20 @@ void OH_Drawing_PenSetJoin(OH_Drawing_Pen*, OH_Drawing_PenLineJoinStyle); */ void OH_Drawing_PenSetShaderEffect(OH_Drawing_Pen*, OH_Drawing_ShaderEffect*); +/** + * @brief 获得画笔着色器效果。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_Pen 指向画笔对象{@link OH_Drawing_Pen}的指针。 + * @param OH_Drawing_ShaderEffect 指向着色器对象{@link OH_Drawing_ShaderEffect}的指针。 + * @return 函数返回执行错误码。 + * 返回{@link OH_DRAWING_SUCCESS},表示执行成功。 + * 返回{@link OH_DRAWING_ERROR_INVALID_PARAMETER},表示参数cPen或者cShaderEffect为空。 + * @since 11 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_PenGetShaderEffect(OH_Drawing_Pen* cPen, OH_Drawing_ShaderEffect* cShaderEffect); + /** * @brief 设置画笔阴影层效果,设置的阴影层效果当前仅在绘制文字时生效。 * diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_region.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_region.h index 747de09ac5b9e6c0b4a31287904f38e5153357fd..cb7ef146e5f65adfb8980a11a73749dbdcf387d4 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_region.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_region.h @@ -38,6 +38,7 @@ * @version 1.0 */ +#include "drawing_error_code.h" #include "drawing_types.h" #ifdef __cplusplus @@ -150,6 +151,22 @@ bool OH_Drawing_RegionSetRect(OH_Drawing_Region* region, const OH_Drawing_Rect* */ bool OH_Drawing_RegionSetPath(OH_Drawing_Region* region, const OH_Drawing_Path* path, const OH_Drawing_Region* clip); +/** + * @brief 用于判断其他区域是否在当前区域内。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param cRegion 指向当前区域对象的指针。 + * @param cOther 指向其他区域对象的指针。 + * @param cIsRegionContainded 表示其他区域是否完全位于区域对象内。 + * @return 函数返回执行错误码。 + * 返回{@link OH_DRAWING_SUCCESS},表示执行成功。 + * 返回{@link OH_DRAWING_ERROR_INVALID_PARAMETER},表示参数cRegion、cOther或者cIsRegionContainded为空。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ErrorCode OH_Drawing_RegionIsRegionContained(const OH_Drawing_Region* cRegion, + const OH_Drawing_Region* cOther, bool* cIsRegionContainded); + /** * @brief 用于销毁区域对象并回收该对象占有的内存。 * diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_shader_effect.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_shader_effect.h index 11630f93f8865c8fa0b6505b659819afa6688a2a..e63b0a3518a4bfce8aff39e3bf0019aa9e9876a0 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_shader_effect.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_shader_effect.h @@ -71,6 +71,16 @@ typedef enum OH_Drawing_TileMode { DECAL, } OH_Drawing_TileMode; +/** + * @brief 创建图像着色器。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @return 返回创建的着色器对象的指针。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ShaderEffect* OH_Drawing_ShaderEffectCreate(); + /** * @brief 创建具有单一颜色的着色器。 * @@ -235,6 +245,22 @@ OH_Drawing_ShaderEffect* OH_Drawing_ShaderEffectCreateTwoPointConicalGradient(co float startRadius, const OH_Drawing_Point2D* endPt, float endRadius, const uint32_t* colors, const float* pos, uint32_t size, OH_Drawing_TileMode, const OH_Drawing_Matrix*); +/** + * @brief 创建图像着色器。生成一个像素映射着色器。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_PixelMap 指向图片对象{@link OH_Drawing_PixelMap}的指针。 + * @param tileX 水平方向着色器效果平铺模式类型,支持可选的具体模式可见{@Link OH_Drawing_TileMoe}枚举。 + * @param tileY 垂直方向着色器效果平铺模式类型,支持可选的具体模式可见{@Link OH_Drawing_TileMoe}枚举。 + * @param OH_Drawing_SamplingOptions 指向采样选项对象{@link OH_Drawing_SamplingOptions}的指针。 + * @param OH_Drawing_Matrix 指向矩阵对象{@link OH_Drawing_Matrix}的指针。如果矩阵指针为空,默认传入单位矩阵。 + * @return 返回创建的着色器对象的指针。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_ShaderEffect* OH_Drawing_ShaderEffectCreatePixelMapShader(OH_Drawing_PixelMap*, OH_Drawing_TileMode tileX, + OH_Drawing_TileMode tileY, const OH_Drawing_SamplingOptions*, const OH_Drawing_Matrix*); + /** * @brief 销毁着色器对象,并收回该对象占用的内存。 *