openharmony 鸿蒙 arkts-apis-graphics-drawing-Brush

2026-08-25 浏览 (1)

Class (Brush)

画刷对象，描述所绘制图形的填充信息。

说明：

  • 本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

  • 本模块使用屏幕物理像素单位px。

  • 本模块为单线程模型策略，需要调用方自行管理线程安全和上下文状态的切换。

导入模块

import { drawing } from '@kit.ArkGraphics2D';

constructor12+

constructor()

构造一个新的画刷对象。

系统能力： SystemCapability.Graphics.Drawing

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();

constructor12+

constructor(brush: Brush)

复制构造一个新的画刷对象。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
brushBrush是待复制的画刷对象。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types.

示例：

import { common2D, drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
const brushColor: common2D.Color = { alpha: 255, red: 0, green: 255, blue: 0 };
brush.setColor(brushColor);
const newBrush = new drawing.Brush(brush);

setColor

setColor(color: common2D.Color) : void

设置画刷的颜色。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
colorcommon2D.Color是ARGB格式的颜色，每个颜色通道的值是0到255之间的整数。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types;3.Parameter verification failed.

示例：

import { common2D, drawing } from '@kit.ArkGraphics2D';

const color : common2D.Color = { alpha: 255, red: 255, green: 0, blue: 0 };
const brush = new drawing.Brush();
brush.setColor(color);

setColor12+

setColor(alpha: number, red: number, green: number, blue: number): void

设置画刷的颜色。性能优于setColor接口，推荐使用本接口。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
alphanumber是ARGB格式颜色的透明度通道值，该参数是0到255之间的整数，传入范围内的浮点数会向下取整。
rednumber是ARGB格式颜色的红色通道值，该参数是0到255之间的整数，传入范围内的浮点数会向下取整。
greennumber是ARGB格式颜色的绿色通道值，该参数是0到255之间的整数，传入范围内的浮点数会向下取整。
bluenumber是ARGB格式颜色的蓝色通道值，该参数是0到255之间的整数，传入范围内的浮点数会向下取整。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types;3.Parameter verification failed.

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
brush.setColor(255, 255, 0, 0);

setColor18+

setColor(color: number) : void

设置画刷的颜色。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
colornumber是16进制ARGB格式的颜色。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types;3.Parameter verification failed.

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
brush.setColor(0xffff0000);

setColor4f20+

setColor4f(color4f: common2D.Color4f, colorSpace: colorSpaceManager.ColorSpaceManager|null): void

设置画刷的颜色以及标准色域，与setColor区别在于可以单独设置色域，适用于需要单独设置色域的场景。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
color4fcommon2D.Color4f是ARGB格式的颜色，每个颜色通道的值是0.0-1.0之间的浮点数，大于1.0时，取1.0，小于0.0时，取0.0。
colorSpacecolorSpaceManager.ColorSpaceManager |null是标准色域对象，null表示使用SRGB色域。

示例：

import { common2D, drawing, colorSpaceManager } from "@kit.ArkGraphics2D";

const brush = new drawing.Brush();
let colorSpace = colorSpaceManager.create(colorSpaceManager.ColorSpace.BT2020_HLG);
let color4f:common2D.Color4f = {alpha:1, red:0.5, green:0.4, blue:0.7};
brush.setColor4f(color4f, colorSpace);

getColor12+

getColor(): common2D.Color

获取画刷的颜色。

系统能力： SystemCapability.Graphics.Drawing

返回值：

类型说明
common2D.Color返回画刷的颜色。

示例：

import { common2D, drawing } from '@kit.ArkGraphics2D';

const color : common2D.Color = { alpha: 255, red: 255, green: 0, blue: 0 };
const brush = new drawing.Brush();
brush.setColor(color);
let colorGet = brush.getColor();

getColor4f20+

getColor4f(): common2D.Color4f

获取画刷的颜色，与getColor的区别是返回值类型为浮点数，适用于需要浮点数类型的场景。

系统能力： SystemCapability.Graphics.Drawing

返回值：

类型说明
common2D.Color4f返回画刷的颜色。

示例：

import { common2D, drawing, colorSpaceManager } from "@kit.ArkGraphics2D";

const brush = new drawing.Brush();
let colorSpace = colorSpaceManager.create(colorSpaceManager.ColorSpace.BT2020_HLG);
let color4f:common2D.Color4f = {alpha:1, red:0.5, green:0.4, blue:0.7};
brush.setColor4f(color4f, colorSpace);
let color = brush.getColor4f();

getHexColor18+

getHexColor(): number

获取画刷的颜色。

系统能力： SystemCapability.Graphics.Drawing

返回值：

类型说明
number返回画刷的颜色，以16进制ARGB格式的32位无符号整数表示。

示例：

import { common2D, drawing } from '@kit.ArkGraphics2D';

let color : common2D.Color = { alpha: 255, red: 255, green: 0, blue: 0 };
let brush = new drawing.Brush();
brush.setColor(color);
let hex_color: number = brush.getHexColor();
console.info('getHexColor: ', hex_color.toString(16));

setAntiAlias

setAntiAlias(aa: boolean) : void

设置画刷是否开启抗锯齿。开启后，可以使得图形的边缘在显示时更平滑。未调用此接口设置时，系统默认关闭抗锯齿。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
aaboolean是表示是否开启抗锯齿，true表示开启，false表示关闭。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types.

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
brush.setAntiAlias(true);

isAntiAlias12+

isAntiAlias(): boolean

获取画刷是否开启抗锯齿属性。

系统能力： SystemCapability.Graphics.Drawing

返回值：

类型说明
boolean返回画刷是否开启抗锯齿属性，true表示开启，false表示关闭。

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
let isAntiAlias = brush.isAntiAlias();

setAlpha

setAlpha(alpha: number) : void

设置画刷的透明度。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
alphanumber是用于表示透明度的[0, 255]区间内的整数值，传入浮点类型时向下取整。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types;3.Parameter verification failed.

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
brush.setAlpha(128);

getAlpha12+

getAlpha(): number

获取画刷的透明度。

系统能力： SystemCapability.Graphics.Drawing

返回值：

类型说明
number返回画刷的透明度，该返回值为0到255之间的整数。

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
let alpha = brush.getAlpha();

setColorFilter

setColorFilter(filter: ColorFilter|null) : void

给画刷添加额外的颜色滤波器。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
filterColorFilter |null是颜色滤波器。null表示清空颜色滤波器。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types.

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
let colorFilter = drawing.ColorFilter.createLinearToSRGBGamma();
brush.setColorFilter(colorFilter);

setMaskFilter12+

setMaskFilter(filter: MaskFilter|null): void

给画刷添加额外的蒙版滤镜。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
filterMaskFilter |null是蒙版滤镜。null表示清空蒙版滤镜。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types.

示例：

import { RenderNode } from '@kit.ArkUI';
import { common2D, drawing } from '@kit.ArkGraphics2D';

class DrawingRenderNode extends RenderNode {
  draw(context : DrawContext) {
    const canvas = context.canvas;
    const brush = new drawing.Brush();
    let maskFilter = drawing.MaskFilter.createBlurMaskFilter(drawing.BlurType.OUTER, 10);
    brush.setMaskFilter(maskFilter);
  }
}

setShaderEffect12+

setShaderEffect(shaderEffect: ShaderEffect|null): void

设置画刷着色器效果。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
shaderEffectShaderEffect |null是着色器对象。null表示清空着色器效果。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types.

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
let shaderEffect = drawing.ShaderEffect.createLinearGradient({x: 100, y: 100}, {x: 300, y: 300}, [0xFF00FF00, 0xFFFF0000], drawing.TileMode.REPEAT);
brush.setShaderEffect(shaderEffect);

setShadowLayer12+

setShadowLayer(shadowLayer: ShadowLayer|null): void

设置画刷阴影层效果。当前仅在绘制文字时生效。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
shadowLayerShadowLayer |null是阴影层对象。null表示清空阴影层效果。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types.

示例：

import { RenderNode } from '@kit.ArkUI';
import { common2D, drawing } from '@kit.ArkGraphics2D';

class DrawingRenderNode extends RenderNode {
  draw(context : DrawContext) {
    const canvas = context.canvas;
    let font = new drawing.Font();
    font.setSize(60);

    let textBlob = drawing.TextBlob.makeFromString("hello", font, drawing.TextEncoding.TEXT_ENCODING_UTF8);
    let pen = new drawing.Pen();
    pen.setStrokeWidth(2.0);

    let pen_color : common2D.Color = {alpha: 0xFF, red: 0xFF, green: 0x00, blue: 0x00};
    pen.setColor(pen_color);
    canvas.attachPen(pen);
    canvas.drawTextBlob(textBlob, 100, 100);
    canvas.detachPen();

    let color : common2D.Color = {alpha: 0xFF, red: 0x00, green: 0xFF, blue: 0x00};
    let shadowLayer = drawing.ShadowLayer.create(3, -3, 3, color);
    pen.setShadowLayer(shadowLayer);
    canvas.attachPen(pen);
    canvas.drawTextBlob(textBlob, 100, 200);
    canvas.detachPen();

    let brush = new drawing.Brush();
    let brush_color : common2D.Color = {alpha: 0xFF, red: 0xFF, green: 0x00, blue: 0x00};
    brush.setColor(brush_color);
    canvas.attachBrush(brush);
    canvas.drawTextBlob(textBlob, 300, 100);
    canvas.detachBrush();

    brush.setShadowLayer(shadowLayer);
    canvas.attachBrush(brush);
    canvas.drawTextBlob(textBlob, 300, 200);
    canvas.detachBrush();
  }
}

setBlendMode

setBlendMode(mode: BlendMode) : void

设置画刷的混合模式。未调用此接口设置时，系统默认的混合模式为SRC_OVER。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
modeBlendMode是颜色的混合模式。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error.Possible causes:1.Mandatory parameters are left unspecified;2.Incorrect parameter types;3.Parameter verification failed.

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
brush.setBlendMode(drawing.BlendMode.SRC);

setImageFilter12+

setImageFilter(filter: ImageFilter|null): void

为画刷设置图像滤波器。

系统能力： SystemCapability.Graphics.Drawing

参数：

参数名类型必填说明
filterImageFilter |null是图像滤波器，null表示清空图像滤波器效果。

错误码：

以下错误码的详细介绍请参见通用错误码。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified;2. Incorrect parameter types.

示例：

import {drawing} from '@kit.ArkGraphics2D';

let brush = new drawing.Brush();
let imgFilter = drawing.ImageFilter.createBlurImageFilter(5, 10, drawing.TileMode.DECAL);
brush.setImageFilter(imgFilter);
brush.setImageFilter(null);

getColorFilter12+

getColorFilter(): ColorFilter

获取画刷的颜色滤波器。

系统能力： SystemCapability.Graphics.Drawing

返回值：

类型说明
ColorFilter返回颜色滤波器。

示例：

import {drawing} from '@kit.ArkGraphics2D';

let brush = new drawing.Brush();
let setColorFilter = drawing.ColorFilter.createSRGBGammaToLinear();
brush.setColorFilter(setColorFilter);
let filter = brush.getColorFilter();

reset12+

reset(): void

重置当前画刷为初始状态。

系统能力： SystemCapability.Graphics.Drawing

示例：

import { drawing } from '@kit.ArkGraphics2D';

const brush = new drawing.Brush();
brush.reset();

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 capi-drawing-gpu-context-h

openharmony 鸿蒙 capi-drawing-nativepixelmap-

openharmony 鸿蒙 capi-nativevsync-oh-nativevsync-expectedraterange

openharmony 鸿蒙 capi-drawing-oh-drawing-brush

openharmony 鸿蒙 capi-drawing-oh-drawing-image-info

openharmony 鸿蒙 capi-drawing-text-linetypography-h

openharmony 鸿蒙 capi-oh-nativeimage-oh-nativeimage

openharmony 鸿蒙 capi-drawing-typeface-h

openharmony 鸿蒙 capi-drawing-brush-h

openharmony 鸿蒙 capi-nativewindow

  • 所属分类： 后端技术
  • 本文标签： 鸿蒙 软件
  • 版权声明： 本文链接 https://seaxiang.com/blog/JXx2SDPI