HarmonyOS实战开发：@ohos.graphics.colorSpaceManager (色彩管理)

最新推荐文章于 2024-08-06 15:07:39 发布

蜀道衫QAQ

最新推荐文章于 2024-08-06 15:07:39 发布

阅读量774

点赞数 23

分类专栏：鸿蒙文章标签： harmonyos 华为鸿蒙鸿蒙系统 android

本文链接：https://blog.csdn.net/2401_84194030/article/details/139298511

版权

鸿蒙专栏收录该内容

449 篇文章 6 订阅

订阅专栏

本模块提供管理抽象化色域对象的一些基础能力，包括色域对象的创建与色域基础属性的获取等。

说明：

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

导入模块

import colorSpaceManager from '@ohos.graphics.colorSpaceManager';

ColorSpace

色域类型枚举。

系统能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

名称	值	说明
UNKNOWN	0	未知的色域类型。
ADOBE_RGB_1998	1	RGB色域为Adobe RGB(1998)类型。
DCI_P3	2	RGB色域为DCI-P3类型。
DISPLAY_P3	3	RGB色域为Display P3类型。
SRGB	4	RGB色域为SRGB类型。系统默认色域类型。
CUSTOM	5	用户自定义色域类型。

ColorSpacePrimaries

色域标准三原色（红、绿、蓝）和白色，使用(x, y)表示其在色彩空间中的位置。

系统能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

名称	类型	可读	可写	说明
redX	数	是	是	标准红色在色彩空间的x坐标值。
redY	数	是	是	标准红色在色彩空间的y坐标值。
greenX	数	是	是	标准绿色在色彩空间的x坐标值。
greenY	数	是	是	标准绿色在色彩空间的y坐标值。
blueX	数	是	是	标准蓝色在色彩空间的x坐标值。
blueY	数	是	是	标准蓝色在色彩空间的y坐标值。
whitePointX	数	是	是	标准白色在色彩空间的x坐标值。
whitePointY	数	是	是	标准白色在色彩空间的y坐标值。

colorSpaceManager.create

create(colorSpaceName: ColorSpace): ColorSpaceManager

创建标准色域对象。

系统能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

参数：

参数名	类型	必填	说明
colorSpaceName	ColorSpace	是	标准色域类型枚举值。 UNKNOWN与CUSTOM不可用于直接创建色域对象。

返回值：

类型	说明
ColorSpaceManager	返回当前创建的色域对象实例。

错误码：

以下错误码的详细介绍请参见色彩管理错误码。

错误码ID	错误信息
18600001	Parameter value is abnormal.

示例：

let colorSpace: colorSpaceManager.ColorSpaceManager;
try {
    colorSpace = colorSpaceManager.create(colorSpaceManager.ColorSpace.SRGB);
} catch (err) {
    console.log(`Failed to create SRGB colorSpace. Cause: ` + JSON.stringify(err));
}

colorSpaceManager.create

create(primaries: ColorSpacePrimaries, gamma: number): ColorSpaceManager

创建用户自定义色域对象。

系统能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

参数：

参数名	类型	必填	说明
primaries	ColorSpacePrimaries	是	色域标准三原色。
gamma	数	是	色域gamma值。

返回值：

类型	说明
ColorSpaceManager	返回当前创建的色域对象实例。色域类型定义为ColorSpace枚举值。`CUSTOM`

错误码：

以下错误码的详细介绍请参见色彩管理错误码。

错误码ID	错误信息
18600001	Parameter value is abnormal.

示例：

let colorSpace: colorSpaceManager.ColorSpaceManager;
try {
    let primaries: colorSpaceManager.ColorSpacePrimaries = {
        redX: 0.1,
        redY: 0.1,
        greenX: 0.2,
        greenY: 0.2,
        blueX: 0.3,
        blueY: 0.3,
        whitePointX: 0.4,
        whitePointY: 0.4
    };
    let gamma = 2.2;
    colorSpace = colorSpaceManager.create(primaries, gamma);
} catch (err) {
    console.log(`Failed to create colorSpace with customized primaries and gamma. Cause: ` + JSON.stringify(err));
}

ColorSpaceManager

当前色域对象实例。

下列API示例中都需先使用create()获取到ColorSpaceManager实例（i.e. ），再通过此实例调用对应方法。colorSpace

getColorSpaceName

getColorSpaceName(): ColorSpace

获取色域类型。

系统能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

返回值：

类型	说明
ColorSpace	返回色域类型枚举值。

错误码：

以下错误码的详细介绍请参见色彩管理错误码。

错误码ID	错误信息
18600001	Parameter value is abnormal.

示例：

try {
    colorSpace.getColorSpaceName();
} catch (err) {
    console.log(`Fail to get colorSpace's name. Cause: ` + JSON.stringify(err));
}

getWhitePoint

getWhitePoint(): Array<number>

获取色域白点值。

系统能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

返回值：

类型	说明
Array<number>	返回色域白点值[x, y]。

错误码：

以下错误码的详细介绍请参见色彩管理错误码。

错误码ID	错误信息
18600001	Parameter value is abnormal.

示例：

try {
    colorSpace.getWhitePoint();
} catch (err) {
    console.log(`Failed to get white point. Cause: ` + JSON.stringify(err));
}复制到剪贴板错误复制

getGamma

getGamma(): number

获取色域gamma值。

系统能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

返回值：

类型	说明
数	返回色域gamma值。

错误码：

以下错误码的详细介绍请参见色彩管理错误码。

错误码ID	错误信息
18600001	Parameter value is abnormal.

示例：

try {
    colorSpace.getGamma();
} catch (err) {
    console.log(`Failed to get gamma. Cause: ` + JSON.stringify(err));
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料