plotPatchesH {munsellinterpol} | R 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]",
value=NULL, chroma=NULL, ... )
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.
|
space |
the name of an installed RGB space.
Spaces |
adapt |
method used to adapt xyY for Illuminant C to xyY for Illuminant D65.
It is passed to |
background |
background color for the plot.
It is passed to |
main |
a string used to set the main title of the plot.
The optional placeholder |
value |
a vector of Munsell Values to use for the plot.
Values must be in the interval [0,10], and in strictly increasing order.
Non-integers, such as 2.5 and 8.5, are valid.
If |
chroma |
a vector of Munsell Chromas to use for the plot.
Chromas must be non-negative and in strictly increasing order.
Odd integers and non-integers are valid.
If |
... |
other arguments passed to the function |
Details
If chroma=NULL
,
for the closest discrete Hue in real.dat
,
the patches in real.dat
are transformed to xyY using simple lookup with no interpolation.
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 chroma
.
Patches inside the MacAdam Limits can still be outside the RGB cube;
those patches 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()