plotPatchesH: Plot Colored Patches for a fixed Munsell Hue

View source: R/plots.R

plotPatchesHR Documentation

Plot Colored Patches for a fixed Munsell Hue

Description

This plot simulates a page from the Munsell Book of Color. The colors are best viewed on a display calibrated for the RGB space given as the second argument.

Usage

plotPatchesH( hue, space='sRGB', adapt='Bradford', background='gray50',
                        main="Hue %s  (H=%g)      [%s   adapt=%s]", ... ) 

Arguments

hue

a Munsell hue for which the plot is created. It is automatically wrapped to the interval (0,100]. It does not have to be a multiple of 2.5. hue can also be a numeric vector of such numbers, and then a separate plot is made for each element of the vector. hue can also be a character vector of Hue Names, which is then converted to a numeric vector using HueNumberFromString().

space

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

adapt

method used to adapt xyY for Illuminant C to xyY for Illuminant D65. It is passed to MunsellToRGB().

background

background color for the plot. It is passed to par() as argument bg.

main

a string used to set the main title of the plot. The optional placeholder '%s' is replaced by the Hue Name, '%g' is replaced by the Hue Number, the next '%s' is replaced by space, and the last '%s' is replaced by adapt.

...

other arguments passed to the function MunsellToRGB(). This includes hcinterp, vinterp, and xyC.

Details

The discrete Values are always the same: integers from 0 to 10. And so the plotting parameter ylim=c(0,11).
The discrete Chromas are contiguous even integers depending on the Hue, and determined as follows. For the closest discrete Hue in real.dat, the patches in real.dat are transformed to xyY using simple lookup. These are then tested against the MacAdam Limits for Illuminant C using IsWithinMacAdamLimits(). The patches outside the limits are discarded, and the maximum Chroma of the remaining patches, which is always an even integer, determines xlim.
Patches inside the MacAdam Limits can still be outside the RGB cube. Patches inside the cube are drawn in the usual way, and those outside are drawn in outline only, and with the clamped RGB coordinates printed inside.

Value

TRUE for success and FALSE for failure.

Author(s)

Glenn Davis

See Also

MunsellToRGB(), HueNumberFromString(), IsWithinMacAdamLimits(), spacesRGB::installRGB()


munsellinterpol documentation built on April 8, 2022, 9:07 a.m.