色彩管理

導(dǎo)入模塊

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

ColorSpace

色域類型枚舉。

系統(tǒng)能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

ColorSpacePrimaries

色域標(biāo)準(zhǔn)三原色（紅、綠、藍(lán)）和白色，使用(x, y)表示其在色彩空間中的位置。

系統(tǒng)能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

colorSpaceManager.create

create(colorSpaceName: ColorSpace): ColorSpaceManager

創(chuàng)建標(biāo)準(zhǔn)色域?qū)ο蟆?/p>

系統(tǒng)能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見色彩管理錯(cuò)誤碼。

示例：

let colorSpace = null;
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

創(chuàng)建用戶自定義色域?qū)ο蟆?/p>

系統(tǒng)能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見色彩管理錯(cuò)誤碼。

示例：

let colorSpace = null;
try {
    let primaries = {
        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

當(dāng)前色域?qū)ο髮?shí)例。

下列API示例中都需先使用create()獲取到ColorSpaceManager實(shí)例（i.e. colorSpace），再通過此實(shí)例調(diào)用對(duì)應(yīng)方法。

getColorSpaceName

getColorSpaceName(): ColorSpace

獲取色域類型。

系統(tǒng)能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見色彩管理錯(cuò)誤碼。

示例：

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

getWhitePoint

getWhitePoint(): Array<number>

獲取色域白點(diǎn)值。

系統(tǒng)能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見色彩管理錯(cuò)誤碼。

示例：

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

getGamma

getGamma(): number

獲取色域gamma值。

系統(tǒng)能力： SystemCapability.Graphic.Graphic2D.ColorManager.Core

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見色彩管理錯(cuò)誤碼。

示例：

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