GimpColorTransform: GIMP Color Library Reference Manual

GimpColorTransform

GimpColorTransform — Definitions and Functions relating to LCMS.

Functions

GimpColorTransform *	gimp_color_transform_new ()
GimpColorTransform *	gimp_color_transform_new_proofing ()
void	gimp_color_transform_process_pixels ()
void	gimp_color_transform_process_buffer ()
gboolean	gimp_color_transform_can_gegl_copy ()

Types and Values

enum	GimpColorTransformFlags

Description

Definitions and Functions relating to LCMS.

Functions

gimp_color_transform_new ()

GimpColorTransform *
gimp_color_transform_new (GimpColorProfile *src_profile,
                          const Babl *src_format,
                          GimpColorProfile *dest_profile,
                          const Babl *dest_format,
                          GimpColorRenderingIntent rendering_intent,
                          GimpColorTransformFlags flags);

This function creates an color transform.

Parameters

src_profile	the source GimpColorProfile
src_format	the source Babl format
dest_profile	the destination GimpColorProfile
dest_format	the destination Babl format
rendering_intent	the rendering intent
flags	transform flags

Returns

the GimpColorTransform, or NULL if no transform is needed to convert between pixels of src_profile and dest_profile .

Since: 2.10

gimp_color_transform_new_proofing ()

GimpColorTransform *
gimp_color_transform_new_proofing (GimpColorProfile *src_profile,
                                   const Babl *src_format,
                                   GimpColorProfile *dest_profile,
                                   const Babl *dest_format,
                                   GimpColorProfile *proof_profile,
                                   GimpColorRenderingIntent proof_intent,
                                   GimpColorRenderingIntent display_intent,
                                   GimpColorTransformFlags flags);

This function creates a simulation / proofing color transform.

Parameters

src_profile	the source GimpColorProfile
src_format	the source Babl format
dest_profile	the destination GimpColorProfile
dest_format	the destination Babl format
proof_profile	the proof GimpColorProfile
proof_intent	the proof intent
display_intent	the display intent
flags	transform flags

Returns

the GimpColorTransform, or NULL.

Since: 2.10

gimp_color_transform_process_pixels ()

void
gimp_color_transform_process_pixels (GimpColorTransform *transform,
                                     const Babl *src_format,
                                     gconstpointer src_pixels,
                                     const Babl *dest_format,
                                     gpointer dest_pixels,
                                     gsize length);

This function transforms a contiguous line of pixels.

Parameters

transform	a GimpColorTransform
src_format	Babl format of `src_pixels`
src_pixels	pointer to the source pixels
dest_format	Babl format of `dest_pixels`
dest_pixels	pointer to the destination pixels
length	number of pixels to process

Since: 2.10

gimp_color_transform_process_buffer ()

void
gimp_color_transform_process_buffer (GimpColorTransform *transform,
                                     GeglBuffer *src_buffer,
                                     const GeglRectangle *src_rect,
                                     GeglBuffer *dest_buffer,
                                     const GeglRectangle *dest_rect);

This function transforms buffer into another buffer.

Parameters

transform	a GimpColorTransform
src_buffer	source GeglBuffer
src_rect	rectangle in `src_buffer`
dest_buffer	destination GeglBuffer
dest_rect	rectangle in `dest_buffer`

Since: 2.10

gimp_color_transform_can_gegl_copy ()

gboolean
gimp_color_transform_can_gegl_copy (GimpColorProfile *src_profile,
                                    GimpColorProfile *dest_profile);

This function checks if a GimpColorTransform is needed at all.

Parameters

src_profile	source GimpColorProfile
dest_profile	destination GimpColorProfile

Returns

TRUE if pixels can be correctly converted between src_profile and dest_profile by simply using gegl_buffer_copy(), babl_process() or similar.

Since: 2.10

Types and Values

enum GimpColorTransformFlags

Flags for modifying GimpColorTransform's behavior.

Members

GIMP_COLOR_TRANSFORM_FLAGS_NOOPTIMIZE	optimize for accuracy rather than for speed
GIMP_COLOR_TRANSFORM_FLAGS_GAMUT_CHECK	mark out of gamut colors in the transform result
GIMP_COLOR_TRANSFORM_FLAGS_BLACK_POINT_COMPENSATION	do black point compensation