Package org.gnome.gdk

Class ColorState

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.gdk.ColorState

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class ColorState
extends ProxyInstance

A GdkColorState object provides the information to interpret colors and pixels in a variety of ways.

They are also known as *color spaces*.

Crucially, GTK knows how to convert colors from one color state to another.

GdkColorState objects are immutable and therefore threadsafe.

Constructor Summary

Constructors

Constructor	Description
ColorState(MemorySegment address)	Create a ColorState proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
CicpParams	createCicpParams()	Create a CicpParams representing the colorstate.
boolean	equal(ColorState other)	Compares two GdkColorStates for equality.
static ColorState	getRec2100Linear()	Returns the color state object representing the linear rec2100 color space.
static ColorState	getRec2100Pq()	Returns the color state object representing the rec2100-pq color space.
static ColorState	getSrgb()	Returns the color state object representing the sRGB color space.
static ColorState	getSrgbLinear()	Returns the color state object representing the linearized sRGB color space.
static Type	getType()	Get the GType of the ColorState class
ColorState	ref()	Increase the reference count of this ColorState.
void	unref()	Decrease the reference count of this ColorState.

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ColorState

public ColorState(MemorySegment address)

Create a ColorState proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Method Details

getType

public static Type getType()

Get the GType of the ColorState class

Returns:

the GType

getRec2100Linear

public static ColorState getRec2100Linear()

Returns the color state object representing the linear rec2100 color space.

This color state uses the primaries defined by BT.2020-2 and BT.2100-0 and a linear transfer function.

It is equivalent to the Cicp tuple 9/8/0/1.

See e.g. the CSS HDR Module for details about this colorstate.

Returns:

the color state object for linearized rec2100

getRec2100Pq

public static ColorState getRec2100Pq()

Returns the color state object representing the rec2100-pq color space.

This color state uses the primaries defined by BT.2020-2 and BT.2100-0 and the transfer function defined by SMPTE ST 2084 and BT.2100-2.

It is equivalent to the Cicp tuple 9/16/0/1.

See e.g. the CSS HDR Module for details about this colorstate.

Returns:

the color state object for rec2100-pq

getSrgb

public static ColorState getSrgb()

Returns the color state object representing the sRGB color space.

This color state uses the primaries defined by BT.709-6 and the transfer function defined by IEC 61966-2-1.

It is equivalent to the Cicp tuple 1/13/0/1.

See e.g. the CSS Color Module for details about this colorstate.

Returns:

the color state object for sRGB

getSrgbLinear

public static ColorState getSrgbLinear()

Returns the color state object representing the linearized sRGB color space.

This color state uses the primaries defined by BT.709-6 and a linear transfer function.

It is equivalent to the Cicp tuple 1/8/0/1.

See e.g. the CSS Color Module for details about this colorstate.

Returns:

the color state object for linearized sRGB

createCicpParams

public CicpParams createCicpParams()

Create a CicpParams representing the colorstate.

It is not guaranteed that every GdkColorState can be represented with Cicp parameters. If that is the case, this function returns NULL.

Returns:

A new CicpParams

equal

public boolean equal(ColorState other)

Compares two GdkColorStates for equality.

Note that this function is not guaranteed to be perfect and two objects describing the same color state may compare not equal. However, different color states will never compare equal.

Parameters:

other - another GdkColorStatee

Returns:

true if the two color states compare equal

ref

public ColorState ref()

Increase the reference count of this ColorState.

Returns:

the object that was passed in

unref

public void unref()

Decrease the reference count of this ColorState.

Unless this ColorState is static, it will be freed when the reference count reaches zero.