当前位置：首页 > news >正文

HarmonyOS 全局取色功能（Pen Image Feature Picker C）开发指南

news 2026/5/12 13:49:42

华为第四期开发者活动

HarmonyOS 全局取色功能（Pen Image Feature Picker C）开发指南

在许多绘图、设计、笔记、图像编辑等应用场景中，从屏幕上任意位置快速提取颜色信息 是一项常见需求。例如：

从图片或 UI 元素中精准提取颜色用于画笔或样式配色
在标注/批注工具中快速匹配颜色
教育、展示类应用中辅助色彩分析

为简化开发者实现这类功能，HarmonyOS 手写笔服务（Pen Kit）提供了全局取色能力（Image Feature Picker），可以在 C/C++ 项目中通过能力接口提取当前屏幕某个点的颜色值。(华为开发者)

一、全局取色是什么？

全局取色功能让用户可以使用 手指或手写笔 在正在显示的屏幕内容上操作取色器：

按住或移动至目标位置
抬起手写笔/手指
返回该位置对应的颜色值等图像特征信息

与传统通过调色板选择颜色不同，这种方式直接针对界面内容进行 真实像素级的颜色提取，适合更加精准的图像/界面设计场景。(华为开发者)

二、功能定位与适用场景

该 C/C++ 接口主要用于：

绘画/设计类应用：基于图片/画布内容快速获取色值
图像编辑：在图像处理工具中支持一键取色
教育/演示场景：从内容界面抽取颜色作为讲解依据
业务标注功能：辅助注释颜色一致风格创建

这种从屏幕任意内容取色的能力比静态调色板更直观、高效。(华为开发者)

三、接入全局取色（C/C++）步骤

下面介绍通过 C/C++ 方式在项目中接入全局取色能力的基本流程。

1. 环境准备

确保你的项目已经：

使用 HarmonyOS C/C++ 能力开发环境
配置 Pen Kit 或相关系统能力支持
DevEco Studio SDK 对应版本包含 Image Feature Picker C 接口
（文档/SDK 默认包含）(华为开发者)

2. 引用相关头文件

在需要取色功能的 C/C++ 文件中引入相关 Image Feature Picker 的头文件（根据 SDK 具体定义）：

#include <pen_image_feature_picker.h>

注：具体头文件名称以 SDK 文档中实际定义为准。(华为开发者)

3. 调用取色 API

核心在于调用 取色接口，传入位置坐标，并从返回结果中获取颜色信息。

一般接口可能如下（伪示意）：

// 调用取色接口
Result result = ImageFeaturePicker_PickForResult(x, y, &colorInfo);
if (result == SUCCESS) {// colorInfo 结构包含 RGB、HEX 等色彩信息printf("Picked Color: R=%d G=%d B=%d\n",colorInfo.r, colorInfo.g, colorInfo.b);
} else {// 错误处理
}

x / y: 是当前屏幕像素位置
colorInfo: 获取到的颜色结构体
返回结果要检查是否成功

这种方式让你能够以最接近原生的方式处理界面取色。(华为开发者)

4. 在用户交互中触发取色

通常会在用户触控事件结束（如抬笔 / 手指抬起）时调用取色接口：

void OnTouchUp(float x, float y) {PickedColorInfo info;if (ImageFeaturePicker_PickForResult(x, y, &info) == SUCCESS) {ApplyColorToBrush(info.r, info.g, info.b);}
}

这意味着用户确定取色点后，即可提取该位置的色值并做业务处理，例如作为画笔当前颜色。(华为开发者)