鸿蒙OpenHarmony【@ohos.graphics.colorSpaceManager (色彩管理)】图形ArkTS API

id="article_content" class="article_content clearfix"> id="content_views" class="markdown_views prism-atom-one-dark">

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

说明

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

导入模块

import { colorSpaceManager } from '@kit.ArkGraphics2D';
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
  • 1

ColorSpace

色域类型枚举。

元服务API：  从API version 12开始，该接口支持在元服务中使用。

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

class="table-box">
名称值说明
UNKNOWN0未知的色域类型。
ADOBE_RGB_19981RGB色域为Adobe RGB(1998)类型。转换函数为Adobe RGB(1998)类型。编码范围为Full类型。
DCI_P32RGB色域为DCI-P3类型。转换函数为Gamma 2.6类型。编码范围为Full类型。
DISPLAY_P33RGB色域为Display P3类型。转换函数为SRGB类型。编码范围为Full类型。
SRGB4RGB色域为SRGB类型。转换函数为SRGB类型。编码范围为Full类型。系统默认色域类型。
CUSTOM5用户自定义色域类型。
BT70911+6RGB色域为BT709类型。转换函数为BT709类型。编码范围为Full类型。
BT601_EBU11+7RGB色域为BT601_P类型。转换函数为BT709类型。编码范围为Full类型。
BT601_SMPTE_C11+8RGB色域为BT601_N类型。转换函数为BT709类型。编码范围为Full类型。
BT2020_HLG11+9RGB色域为BT2020类型。转换函数为HLG类型。编码范围为Full类型。
BT2020_PQ11+10RGB色域为BT2020类型。转换函数为PQ类型。编码范围为Full类型。
P3_HLG11+11RGB色域为Display P3类型。转换函数为HLG类型。编码范围为Full类型。
P3_PQ11+12RGB色域为Display P3类型。转换函数为PQ类型。编码范围为Full类型。
ADOBE_RGB_1998_LIMIT11+13RGB色域为Adobe RGB(1998)类型。转换函数为Adobe RGB(1998)类型。编码范围为Limit类型。
DISPLAY_P3_LIMIT11+14RGB色域为Display P3类型。转换函数为SRGB类型。编码范围为Limit类型。
SRGB_LIMIT11+15RGB色域为SRGB类型。转换函数为SRGB类型。编码范围为Limit类型。
BT709_LIMIT11+16RGB色域为BT709类型。转换函数为BT709类型。编码范围为Limit类型。
BT601_EBU_LIMIT11+17RGB色域为BT601_P类型。转换函数为BT709类型。编码范围为Limit类型。
BT601_SMPTE_C_LIMIT11+18RGB色域为BT601_N类型。转换函数为BT709类型。编码范围为Limit类型。
BT2020_HLG_LIMIT11+19RGB色域为BT2020类型。转换函数为HLG类型。编码范围为Limit类型。
BT2020_PQ_LIMIT11+20RGB色域为BT2020类型。转换函数为PQ类型。编码范围为Limit类型。
P3_HLG_LIMIT11+21RGB色域为Display P3类型。转换函数为HLG类型。编码范围为Limit类型。
P3_PQ_LIMIT11+22RGB色域为Display P3类型。转换函数为PQ类型。编码范围为Limit类型。
LINEAR_P311+23RGB色域为Display P3类型。转换函数为Linear类型。
LINEAR_SRGB11+24RGB色域为SRGB类型。转换函数为Linear类型。
LINEAR_BT70911+24与LINEAR_SRGB相同。RGB色域为BT709类型。转换函数为Linear类型。
LINEAR_BT202011+25RGB色域为BT2020类型。转换函数为Linear类型。
DISPLAY_SRGB11+4与SRGB相同。RGB色域为SRGB类型。转换函数为SRGB类型。编码范围为Full类型。
DISPLAY_P3_SRGB11+3与DISPLAY_P3相同。RGB色域为Display P3类型。转换函数为SRGB类型。编码范围为Full类型。
DISPLAY_P3_HLG11+11与P3_HLG相同。RGB色域为Display P3类型。转换函数为HLG类型。编码范围为Full类型。
DISPLAY_P3_PQ11+12与P3_PQ相同。RGB色域为Display P3类型。转换函数为PQ类型。编码范围为Full类型。

ColorSpacePrimaries

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

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

class="table-box">
名称类型可读可写说明
redXnumber是是标准红色在色彩空间的x坐标值。
redYnumber是是标准红色在色彩空间的y坐标值。
greenXnumber是是标准绿色在色彩空间的x坐标值。
greenYnumber是是标准绿色在色彩空间的y坐标值。
blueXnumber是是标准蓝色在色彩空间的x坐标值。
blueYnumber是是标准蓝色在色彩空间的y坐标值。
whitePointXnumber是是标准白色在色彩空间的x坐标值。
whitePointYnumber是是标准白色在色彩空间的y坐标值。

colorSpaceManager.create

create(colorSpaceName: ColorSpace): ColorSpaceManager

创建标准色域对象。

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

参数：

class="table-box">
参数名类型必填说明
colorSpaceName[ColorSpace]是标准色域类型枚举值。UNKNOWN与CUSTOM不可用于直接创建色域对象。

返回值：

class="table-box">
类型说明
[ColorSpaceManager]返回当前创建的色域对象实例。
class="table-box">
错误码ID错误信息
401Parameter error. Possible cause: 1.Incorrect parameter type. 2.Parameter verification failed.
18600001The 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));
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

colorSpaceManager.create

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

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

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

参数：

class="table-box">
参数名类型必填说明
primaries[ColorSpacePrimaries]是色域标准三原色。
gammanumber是色域gamma值。

返回值：

class="table-box">
类型说明
[ColorSpaceManager]返回当前创建的色域对象实例。色域类型定义为[ColorSpace]枚举值CUSTOM。
class="table-box">
错误码ID错误信息
401Parameter error. Possible cause: 1.Incorrect parameter type. 2.Parameter verification failed.
18600001The 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));
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">

ColorSpaceManager

当前色域对象实例。

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

getColorSpaceName

getColorSpaceName(): ColorSpace

获取色域类型。

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

返回值：

class="table-box">
类型说明
[ColorSpace]返回色域类型枚举值。
class="table-box">
错误码ID错误信息
18600001The parameter value is abnormal.

示例：

try {
    let spaceName = colorSpace.getColorSpaceName();
} catch (err) {
    console.log(`Fail to get colorSpace's name. Cause: ` + JSON.stringify(err));
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

getWhitePoint

getWhitePoint(): Array

获取色域白点值。

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

返回值：

class="table-box">
类型说明
Array返回色域白点值[x, y]。
class="table-box">
错误码ID错误信息
18600001The parameter value is abnormal.

示例：

try {
    let point = colorSpace.getWhitePoint();
} catch (err) {
    console.log(`Failed to get white point. Cause: ` + JSON.stringify(err));
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

getGamma

getGamma(): number

获取色域gamma值。

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

返回值：

class="table-box">
类型说明
number返回色域gamma值。
class="table-box">
错误码ID错误信息
18600001The parameter value is abnormal.

示例：

try {
    let gamma = colorSpace.getGamma();
} catch (err) {
    console.log(`Failed to get gamma. Cause: ` + JSON.stringify(err));
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
data-report-view="{"mod":"1585297308_001","spm":"1001.2101.3001.6548","dest":"https://blog.csdn.net/zhenggaoxiao232/article/details/145098961","extend1":"pc","ab":"new"}">>
注：本文转载自blog.csdn.net的蒸糕笑QAQ的文章"https://blog.csdn.net/zhenggaoxiao232/article/details/145098961"。版权归原作者所有，此博客不拥有其著作权，亦不承担相应法律责任。如有侵权，请联系我们删除。
复制链接
复制链接
相关推荐
发表评论

评论记录：

未查询到任何数据！