鸿蒙5.0&next开发【@ohos.graphics.sendableColorSpaceManager (可共享的色彩管理)】图形-优快云博客

本文链接：https://blog.youkuaiyun.com/m0_70748845/article/details/146915361

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

说明

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

导入模块

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

ISendable

type ISendable = lang.ISendable

ISendable是所有Sendable类型（除null和undefined）的父类型。自身没有任何必须的方法和属性。

系统能力： SystemCapability.Utils.Lang

类型	说明
[lang.ISendable]	所有Sendable类型的父类型。

sendableColorSpaceManager.create

create(colorSpaceName: colorSpaceManager.ColorSpace): ColorSpaceManager

创建标准可共享的色彩管理。

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

参数：

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

返回值：

类型	说明
[ColorSpaceManager]	返回当前创建的可共享的色彩管理实例。该实例继承ISendable，可以在ArkTS并发实例间（包括主线程、TaskPool&Worker工作线程）传递，传递的行为是引用传递。

错误码ID	错误信息
401	Parameter error. Possible cause: 1.Incorrect parameter type. 2.Parameter verification failed.
18600001	The parameter value is abnormal.

示例：

import { colorSpaceManager } from '@kit.ArkGraphics2D';
let colorSpace: sendableColorSpaceManager.ColorSpaceManager;
colorSpace = sendableColorSpaceManager.create(colorSpaceManager.ColorSpace.SRGB);

sendableColorSpaceManager.create

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

创建用户自定义可共享的色彩管理实例。

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

参数：

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

返回值：

类型	说明
[ColorSpaceManager]	返回当前创建的可共享的色彩管理实例。色域类型定义为[colorSpaceManager.ColorSpace]枚举值CUSTOM。该实例继承ISendable，可以在ArkTS并发实例间（包括主线程、TaskPool&Worker工作线程）传递，传递的行为是引用传递。

错误码ID	错误信息
401	Parameter error. Possible cause: 1.Incorrect parameter type. 2.Parameter verification failed.
18600001	The parameter value is abnormal.

示例：

import { colorSpaceManager } from '@kit.ArkGraphics2D';
let colorSpace: sendableColorSpaceManager.ColorSpaceManager;
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: number = 2.2;
colorSpace = sendableColorSpaceManager.create(primaries, gamma);

ColorSpaceManager

当前可共享的色彩管理实例。

下列API示例中都需先使用[create()]获取到ColorSpaceManager实例，再通过此实例调用对应方法。

getColorSpaceName

getColorSpaceName(): colorSpaceManager.ColorSpace

获取色域类型。

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

返回值：

类型	说明
[colorSpaceManager.ColorSpace]	返回色域类型枚举值。

错误码ID	错误信息
18600001	The parameter value is abnormal.

示例：

let spaceName: colorSpaceManager.ColorSpace = colorSpace.getColorSpaceName();

getWhitePoint

getWhitePoint(): collections.Array

获取色域白点值。

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

返回值：

类型	说明
[collections.Array]	返回色域白点值[x, y]。

错误码ID	错误信息
18600001	The parameter value is abnormal.

示例：

import { collections } from '@kit.ArkTS';
let point: collections.Array<number> = colorSpace.getWhitePoint();

getGamma

getGamma(): number

获取色域gamma值。

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

返回值：

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

错误码ID	错误信息
18600001	The parameter value is abnormal.

示例：

let gamma: number = colorSpace.getGamma();

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述