Enhance the lightness and color preserving hue using perceptual methods.
Parameters
----------
rArray : `numpy.ndarray`
The array used as the red channel
gArray : `numpy.ndarray`
The array used as the green channel
bArray : `numpy.ndarray`
The array used as the blue channel
local_contrast : `LocalContrastFunction` or `None`
This is a callable that's passed the luminance values, and is expected
to do local contrast enhancement. Set to None to bypass.
scale_lum : `ScaleLumFunction` or `None`
This is a callable that's passed the luminance values and should
return a scaled luminance array the same shape as the input.
Set to None for no scaling.
scale_color : `ScaleColorFunction` or `None`
This is a callable that's passed the original luminance, the remapped
luminance values, the a values for each pixel, and the b values for
each pixel. This function is responsible for scaling chroma
values. This should return two arrays corresponding to the scaled a and
b values. Set to None for no modification.
remap_bounds : `RemapBoundsFunction` or `None`
This is a callable that remaps the input arrays such that each of
them fall within a zero to one range. This callable is given the
initial image. Set to None for no remapping. If this is None
input arrays should already be in 0-1 range.
bracketing_function : `BracketingFunction` or `None`
This is a callable that is passed the input luminance, and should
create various exposure levels and then fuse them together.
Set to None for no bracketing.
gamut_remapping_function : `GamutRemappingFunction` or `None`
This is a callable that is passed the final OkLab image. Its job
is to detect and correct any pixel values that would fall outside
an RGB P3 colorspace. Set to None for no fixes.
psf : `FloatImagePlane` or `None`
If this parameter is an image of a PSF kernel the luminance channel is
deconvolved with it. Set to None to skip deconvolution.
cieWhitePoint : `tuple` of `float`, `float`
This is the white point of the input of the input arrays in CIE XY
coordinates. Altering this affects the relative balance of colors
in the input image, and therefore also the output image.
Returns
-------
result : `RGBImage`
The brightness and color calibrated image.
Raises
------
ValueError
Raised if the shapes of the input array don't match
Definition at line 65 of file _colorMapper.py.
1.13.2