Class ICtCp

ICtCp (Intensity, Chroma Tritan, Chroma Protan). Standard: ITU-R BT.2100. A perceptual color space for High Dynamic Range (HDR) and Wide Color Gamut (WCG).

I (Intensity): 0.0 - 1.0 (Non-linear PQ). 1.0 represents 10,000 nits. ~0.51 represents 100 nits (SDR White). ~0.58 represents 203 nits (Diffuse White).
Ct (Blue-Yellow): -0.5 to +0.5 approx.
Cp (Red-Green): -0.5 to +0.5 approx.

Pipeline: XYZ -> Rec.2020 Linear -> LMS Linear -> PQ Encoded -> ICtCp.

Hierarchy (View Summary)

Color
- ICtCp

Properties

`Protected` `Readonly`_alpha

_alpha: number

The alpha channel. Common to all color spaces.

`Protected` `Readonly`_meta

_meta: ColorMeta<Color>

Pointer to concrete color spaces meta-information.

`Static` `Readonly`META

META: ColorMeta<ICtCp> = ...

The meta instance.

Accessors

alpha

get alpha(): number
Get the alpha channel.

Returns number
The value.
Inherited from Color.alpha
- Defined in base/Color.ts:94

chromaIndex

get chromaIndex(): number | null
Get the color chroma index. Return null if the color has no chroma component.

Returns number | null
The component index.
Inherited from Color.chromaIndex
- Defined in base/Color.ts:104

colorSpace

get colorSpace(): (keyof PolarColorSpaces) | (keyof CartesianColorSpaces)
Get the color space name.

Returns (keyof PolarColorSpaces) | (keyof CartesianColorSpaces)
The color space name.
Inherited from Color.colorSpace
- Defined in base/Color.ts:113

components

get components(): number[]
Get the color components as an array of values. The last element is always the alpha channel. The other components follow the color space name, e.g. RGB: [R, G, B, alpha].

Returns number[]
The component values.
Overrides Color.components
- Defined in colorSpaces/ICtCp.ts:307

cp

get cp(): number
Get the cp component.

Returns number
The component.
- Defined in colorSpaces/ICtCp.ts:316

ct

get ct(): number
Get the ct component.

Returns number
The component.
- Defined in colorSpaces/ICtCp.ts:325

hueIndex

get hueIndex(): number | null
Get the color hue index. Return null if the color has no hue component (i.e. it is not cylindrical).

Returns number | null
The component index.
Inherited from Color.hueIndex
- Defined in base/Color.ts:124

i

get i(): number
Get the i component.

Returns number
The component.
- Defined in colorSpaces/ICtCp.ts:334

lightnessIndex

get lightnessIndex(): number | null
Get the color lightness index. Return null if the color has no lightness component.

Returns number | null
The component index.
Inherited from Color.lightnessIndex
- Defined in base/Color.ts:134

`Protected` `Static`_acromaticEpsilon

get _acromaticEpsilon(): number
Get the tollerance value for achromatic check.

Returns number
Inherited from Color._acromaticEpsilon
- Defined in base/Color.ts:471

`Static`black

get black(): ICtCp
The base black color in this color space.

Returns ICtCp
The black color.
- Defined in colorSpaces/ICtCp.ts:130

`Static`gray

get gray(): ICtCp
The base gray color in this color space. Corresponds to sRGB Gray (128, 128, 128). Approx 21.4 nits -> PQ ~0.35.

Returns ICtCp
The gray color.
- Defined in colorSpaces/ICtCp.ts:141

`Static`middleGray

get middleGray(): ICtCp
The base perceptual gray color in this color space. Perceptual Middle Gray (18% reflectance of 100 nits). Approx 18 nits -> PQ ~0.34.

Returns ICtCp
The gray color.
- Defined in colorSpaces/ICtCp.ts:152

`Static`peakWhite

get peakWhite(): ICtCp
The Peak HDR white color (10,000 nits). Represents the maximum signal capacity of the PQ curve (1.0). Use this if you specifically want to target HDR highlights.

Returns ICtCp
The HDR white.
- Defined in colorSpaces/ICtCp.ts:163

`Static`transparent

get transparent(): ICtCp
The base transparent color in this color space.

Returns ICtCp
The transparent color.
- Defined in colorSpaces/ICtCp.ts:172

`Static`white

get white(): ICtCp
The base white color in this color space. Represents Diffuse White (100 nits). Maps to PQ value approx 0.51. This ensures compatibility with algorithms like 'lighten' or 'balance'.

Returns ICtCp
The white color.
- Defined in colorSpaces/ICtCp.ts:184

`Static`whitePoint

get whitePoint(): Xyz
Get the white point.

Returns Xyz
The white point.
- Defined in colorSpaces/ICtCp.ts:193

Methods

clipHdr

clipHdr(): this
Clip the color to match its HDR range.

Returns this
The clipped color.
Inherited from Color.clipHdr
- Defined in base/Color.ts:152

clipSdr

clipSdr(): this
Clip the color to match its SDR range.

Returns this
The clipped color.
Inherited from Color.clipSdr
- Defined in base/Color.ts:169

getComponentByIndex

getComponentByIndex(index: number): number
Get the component value by index.
Parameters
- index: number
  The index.
Returns number
The component.

Throws
If the index is invalid.
Inherited from Color.getComponentByIndex
- Defined in base/Color.ts:188

getComponentByName

getComponentByName(name: string): number
Get the component value by name.
Parameters
- name: string
  The name.
Returns number
The component.

Throws
If the name is invalid.
Inherited from Color.getComponentByName
- Defined in base/Color.ts:204

isAchromatic

isAchromatic(): boolean
Check whether the color is achromatic. I.e. almost white/black/gray.

Returns boolean
Trus if the color is achromatic.
Overrides Color.isAchromatic
- Defined in colorSpaces/ICtCp.ts:339

isColorSpace

isColorSpace<C extends Color>(space: ColorConstructor<C>): this is C
Check whether the color is in a specific color space.
Type Parameters
- C extends Color
Parameters
- space: ColorConstructor<C>
  The color space.
Returns this is C
True if this is in the color space.
Inherited from Color.isColorSpace
- Defined in base/Color.ts:220

isColorSpaceName

isColorSpaceName<
    N extends (keyof PolarColorSpaces)
    | (keyof CartesianColorSpaces),
>(
    name: N,
): this is ColorSpaceNames[N]
Check whether the color is in a specific color space.
Type Parameters
- N extends (keyof PolarColorSpaces) | (keyof CartesianColorSpaces)
Parameters
- name: N
  The color space name.
Returns this is ColorSpaceNames[N]
True if this is in the color space.
Inherited from Color.isColorSpaceName
- Defined in base/Color.ts:232

isInHdr

isInHdr(): boolean
Check whether the color respects its color space boundaries for HDR.

Returns boolean
The check result.
Inherited from Color.isInHdr
- Defined in base/Color.ts:243

isInSdr

isInSdr(): boolean
Check whether the color respects its color space boundaries for SDR.

Returns boolean
The check result.
Inherited from Color.isInSdr
- Defined in base/Color.ts:261

setAlpha

setAlpha(v: number): this
Set the alpha component.
Parameters
- v: number
  The new value.
Returns this
The new instance with the alpha changed.
Inherited from Color.setAlpha
- Defined in base/Color.ts:280

setComponentByIndex

setComponentByIndex(index: number, value: number): this
Set the component by index.
Parameters
- index: number
  The component index.
- value: number
  The new value.
Returns this
The new instance with the component changed.

Throws
If the index is invalid.
Inherited from Color.setComponentByIndex
- Defined in base/Color.ts:294

setComponentByName

setComponentByName(name: string, value: number): this
Set the component by name.
Parameters
- name: string
  The component name.
- value: number
  The new value.
Returns this
The new instance with the component changed.

Throws
If the name is invlaid.
Inherited from Color.setComponentByName
- Defined in base/Color.ts:312

setComponents

setComponents(values: number[]): this
Set the component vlaues. The last one is always the alpha channel. The other components follow the color space name, e.g. RGB: [R, G, B, alpha].
Parameters
- values: number[]
  The values to set.
Returns this
A new instance of the target color space.
Overrides Color.setComponents
- Defined in colorSpaces/ICtCp.ts:345

setCp

setCp(v: number): ICtCp
Set the cp component.
Parameters
- v: number
  The new value.
Returns ICtCp
A new instance.
- Defined in colorSpaces/ICtCp.ts:355

setCt

setCt(v: number): ICtCp
Set the ct component.
Parameters
- v: number
  The new value.
Returns ICtCp
The new instance.
- Defined in colorSpaces/ICtCp.ts:365

setI

setI(v: number): ICtCp
Set the i component.
Parameters
- v: number
  The new value.
Returns ICtCp
The new instance.
- Defined in colorSpaces/ICtCp.ts:375

to

to<T extends Color>(targetSpace: ColorConstructor<T>): T
Converts this color to any other color space.
Type Parameters
- T extends Color
Parameters
- targetSpace: ColorConstructor<T>
  The class constructor of the target space (e.g., Rgb, Oklch).
Returns T
A new instance of the target color space.
Example
```
const oklch = myRgb.to(Oklch);
```
Inherited from Color.to
- Defined in base/Color.ts:331

toColorSpaceOf

toColorSpaceOf<T extends Color>(color: T): T
Converts this color to the color space of the other color.
Type Parameters
- T extends Color
Parameters
- color: T
  The color of which match the color space.
Returns T
A new instance of the target color space.
Inherited from Color.toColorSpaceOf
- Defined in base/Color.ts:342

toJSON

toJSON(): ICtCpJsonAlpha
Return a JSON describing the component values.

Returns ICtCpJsonAlpha
The JSON.
Overrides Color.toJSON
- Defined in colorSpaces/ICtCp.ts:380

toXyz

toXyz(): Xyz
Map this color to XYZ space color.

Returns Xyz
The mapped color.
Overrides Color.toXyz
- Defined in colorSpaces/ICtCp.ts:390

tryGetChroma

tryGetChroma(): number | null
Get the chroma component value. Return null if the color has no chroma component.

Returns number | null
The chroma value.
Inherited from Color.tryGetChroma
- Defined in base/Color.ts:355

tryGetHue

tryGetHue(): number | null
Get the hue component value. Return null if the color has no hue component.

Returns number | null
The hue value.
Inherited from Color.tryGetHue
- Defined in base/Color.ts:367

tryGetLightness

tryGetLightness(): number | null
Get the lightness component value. Return null if the color has no lightness component.

Returns number | null
The lightness value.
Inherited from Color.tryGetLightness
- Defined in base/Color.ts:379

trySetChroma

trySetChroma(c: number | null): this
Set the chroma component value. If null is passed, nothing is done.
Parameters
- c: number | null
  The new chroma value.
Returns this
A new instance of the target color space.
Inherited from Color.trySetChroma
- Defined in base/Color.ts:392

trySetHue

trySetHue(h: number | null): this
Set the hue component value. If null is passed, nothing is done.
Parameters
- h: number | null
  The new hue value.
Returns this
A new instance of the target color space.
Inherited from Color.trySetHue
- Defined in base/Color.ts:408

trySetLightness

trySetLightness(l: number | null): this
Set the lightness component value. If null is passed, nothing is done.
Parameters
- l: number | null
  The new lightness value.
Returns this
A new instance of the target color space.
Inherited from Color.trySetLightness
- Defined in base/Color.ts:424

`Static`equals

equals<C extends Color>(c1: C, c2: C, epsilon?: number): boolean
Check whether two colors are equals. If they are of different color spaces, they are considered different.
Type Parameters
- C extends Color
Parameters
- c1: C
  The first color.
- c2: C
  The second color.
- Optionalepsilon: number
Returns boolean
True of they are equals.
Inherited from Color.equals
- Defined in base/Color.ts:52

`Static`fromComponents

fromComponents(comps: number[]): ICtCp
Create an instance from its components.
Parameters
- comps: number[]
  The components.
Returns ICtCp
The new instance.

Throws
If the components length is invalid.
- Defined in colorSpaces/ICtCp.ts:204

`Static`fromJSON

fromJSON(json: ICtCpJson | ICtCpJsonAlpha): ICtCp
Create an instance from its JSON representation.
Parameters
- json: ICtCpJson | ICtCpJsonAlpha
  The JSON.
Returns ICtCp
The new instance.
- Defined in colorSpaces/ICtCp.ts:215

`Static`fromXyz

fromXyz(color: Xyz): ICtCp
Convert a XYZ color to this space. It is just a mathematic conversion.
Parameters
- color: Xyz
  the input color.
Returns ICtCp
The color.
- Defined in colorSpaces/ICtCp.ts:231

`Static`fromXyzComponents

fromXyzComponents(xyzComps: number[]): number[]
Convert XYZ components to this color space components.
Parameters
- xyzComps: number[]
  The XYZ components as [x, y, z, alpha].
Returns number[]
The color space components as [i, ct, cp, alpha].
- Defined in colorSpaces/ICtCp.ts:242

`Static`toComponents

toComponents(
    srcComps: number[],
    srcClassDef: ColorConstructor<Color>,
    dstClassDef: ColorConstructor<Color>,
): number[]
Convert source components to destination components.
Parameters
- srcComps: number[]
  The source components.
- srcClassDef: ColorConstructor<Color>
  The source components class definition.
- dstClassDef: ColorConstructor<Color>
  The destination components class definition.
Returns number[]
The converted components.
Inherited from Color.toComponents
- Defined in base/Color.ts:80

`Static`toXyzComponents

toXyzComponents(comps: number[]): number[]
Convert this color space components to XYZ components.
Parameters
- comps: number[]
  The color space components as [i, ct, cp, alpha].
Returns number[]
The XYZ components as [x, y, z, alpha].
- Defined in colorSpaces/ICtCp.ts:277

Class ICtCp

Hierarchy (View Summary)

Index

Properties

Accessors

Methods

Properties

Protected Readonly_alpha

Protected Readonly_meta

Static ReadonlyMETA

Accessors

alpha

Returns number

chromaIndex

Returns number | null

colorSpace

Returns (keyof PolarColorSpaces) | (keyof CartesianColorSpaces)

components

Returns number[]

cp

Returns number

ct

Returns number

hueIndex

Returns number | null

i

Returns number

lightnessIndex

Returns number | null

meta

Returns ColorMeta<this>

Protected Static_acromaticEpsilon

Returns number

Staticblack

Returns ICtCp

Staticgray

Returns ICtCp

StaticmiddleGray

Returns ICtCp

StaticpeakWhite

Returns ICtCp

Statictransparent

Returns ICtCp

Staticwhite

Returns ICtCp

StaticwhitePoint

Returns Xyz

Methods

clipHdr

Returns this

clipSdr

Returns this

getComponentByIndex

Parameters

Returns number

Throws

getComponentByName

Parameters

Returns number

Throws

isAchromatic

Returns boolean

isColorSpace

Type Parameters

Parameters

Returns this is C

isColorSpaceName

Type Parameters

Parameters

Returns this is ColorSpaceNames[N]

isInHdr

Returns boolean

isInSdr

Returns boolean

setAlpha

Parameters

Returns this

setComponentByIndex

Parameters

Returns this

`Protected` `Readonly`_alpha

`Protected` `Readonly`_meta

`Static` `Readonly`META

`Protected` `Static`_acromaticEpsilon

`Static`black

`Static`gray

`Static`middleGray

`Static`peakWhite

`Static`transparent

`Static`white

`Static`whitePoint

`Static`equals

`Static`fromComponents

`Static`fromJSON

`Static`fromXyz

`Static`fromXyzComponents

`Static`toComponents

`Static`toXyzComponents