munsellinterpol (version 3.0-0)

RGBtoMunsell: Convert RGB coordinates to Munsell HVC

Description

RGBtoMunsell Converts RGB coordinates to Munsell HVC, by interpolating over the extrapolated Munsell renotation data

Usage

RGBtoMunsell( RGB, space='sRGB', which='scene', maxSignal=255, adapt='Bradford', ... )

Arguments

RGB

a numeric Nx3 matrix with RGB coordinates in the rows, or a vector that can be converted to such a matrix, by row. These are non-linear display values, but they are not required to be integers.

space

the name of an installed RGB space. Spaces 'sRGB' and 'AdobeRGB' are pre-installed, and others can be installed using spacesRGB::installRGB().

which

either 'scene' or 'display'; passed to spacesRGB::XYZfromRGB()

maxSignal

maximum value of signal RGB. Other popular values are 1, 100, 1023, and 65535. Even when 1, they are still taken to be non-linear signal values.

adapt

method for chromatic adaptation, see spacesXYZ::CAT() for valid values. Also see Details.

...

other parameters passed to XYZtoMunsell()

Value

a numeric Nx3 matrix with HVC coordinates in the rows. The rownames are copied from input RGB to output HVC, unless the rownames are NULL when they are set to the Munsell notations for HVC. In case of error, it returns NULL.

Details

The conversion is done in these steps:

• RGB XYZ using spacesRGB::XYZfromRGB() with the given space, which, and maxSignal

• XYZ is adapted from the white-point (with which) of space to Illuminant C, using spacesXYZ::adaptXYZ(), with the given chromatic adaptation method adapt

• XYZ HVC using XYZtoMunsell() with ...

References

Wikipedia. sRGB. https://en.wikipedia.org/wiki/SRGB.

Paul Centore 2014 The Munsell and Kubelka-Munk Toolbox https://www.munsellcolourscienceforpainters.com/MunsellAndKubelkaMunkToolbox/MunsellAndKubelkaMunkToolbox.html

See Also

XYZtoMunsell(), spacesXYZ::CAT(), spacesXYZ::adaptXYZ(), spacesRGB::XYZfromRGB()

Examples

# NOT RUN {
RGBtoMunsell( c(255,45,67) )
##                     H        V        C
##  5.4R 5.5/18 5.401135 5.477315 18.01984

RGBtoMunsell( c(255,45,67), space='Adobe' )
##                     H        V        C
##  5.9R 6.2/22 5.924749 6.214155 21.83907
# }