gimp_color_balance (1997)

NAME

gimp_color_balance - Modify the color balance of the specified drawable.

SYNOPSIS

gimp_color_balance (drawable,transfer_mode,preserve_lum,cyan_red,magenta_green,yellow_blue)

DESCRIPTION

Modify the color balance of the specified drawable. There are three axis which can be modified: cyan-red, magenta-green, and yellow-blue. Negative values increase the amount of the former, positive values increase the amount of the latter. Color balance can be controlled with the 'transfer_mode' setting, which allows shadows, midtones, and highlights in an image to be affected differently. The 'preserve_lum' parameter, if non-zero, ensures that the luminosity of each pixel remains fixed.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The drawable
INT32	transfer_mode	Transfer mode: { SHADOWS (0), MIDTONES (1), HIGHLIGHTS (2) }
INT32	preserve_lum	Preserve luminosity values at each pixel
FLOAT	cyan_red	Cyan-Red color balance: (-100 <= cyan_red <= 100)
FLOAT	magenta_green	Magenta-Green color balance: (-100 <= magenta_green <= 100)
FLOAT	yellow_blue	Yellow-Blue color balance: (-100 <= yellow_blue <= 100)

SOME SYNTAX ALTERNATIVES

$drawable->color_balance (transfer_mode,preserve_lum,cyan_red,magenta_green,yellow_blue)

AUTHOR

Spencer Kimball & Peter Mattis
(c)1997 Spencer Kimball & Peter Mattis