Kakadu Hyper-Doc (jp2

Manages colour descriptions for the colour intensity channels described by the jp2_channels interface. These descriptions are stored in the JP2 "Colour Specification" box.

Note carefully that from Kakadu v4.1 onwards, this object no longer provides any colour conversion capabilities of its own. Instead, those capabilities are offered by the separate jp2_colour_converter object, which may be initialized using a jp2_colour object. This allows for multiple conversion strategies and thread-safe management of the conversion state information.

The basic JP2 file format supports three enumerated colour spaces ( JP2_sRGB_SPACE, JP2_sLUM_SPACE and JP2_sYCC_SPACE), together with restricted ICC-profiles for specifying more general monochrome and 3-colour "RGB-like" spaces.

In addition to the JP2 colour spaces, the object is able to manage the much richer set of colour descriptions offered by the JPX file format. These include a much larger set of enumerated colour spaces, arbitrary ICC profiles, and vendor-specific colour spaces.

Objects of this class are merely interfaces to an internal object, which cannot be directly created by an application. Creation and destruction of the internal object, as well as saving and reading of the associated JP2 boxes are capabilities reserved for the internal machinery associated with the file format manager which provides the interface.

Objects which can provide a non-empty jp2_resolution interface include jp2_source, jp2_target, jpx_layer_source, jpx_layer_target, mj2_video_source and mj2_video_target.

jp2_colour (2 forms)

exists {Java: Exists}

operator!

copy {Java: Copy}

init (6 forms) {Java: Init}

get_num_colours {Java: Get_num_colours}

get_space {Java: Get_space}

is_opponent_space {Java: Is_opponent_space}

get_precedence {Java: Get_precedence}

get_approximation_level {Java: Get_approximation_level}

get_icc_profile