This function lets you convert between different representations of colours.
The API is reminiscent of grDevices::convertColor()
, but the performance is
much better. It is not assured that grDevices::convertColor()
and
convert_colour()
provide numerically equivalent conversion at 16bit level as
the formula used are potentially slightly different. For all intend and
purpose, the resulting colours will be equivalent though.
convert_colour(colour, from, to, white_from = "D65",
white_to = white_from)
A numeric matrix (or an object coercible to one) with colours
encoded in the rows and the different colour space values in the columns. For
all colourspaces except 'cmyk'
this will mean a matrix with three columns -
for 'cmyk'
it means four columns.
The input and output colour space. Allowed values are: "cmy", "cmyk", "hsl", "hsb", "hsv", "lab", "hunterlab", "lch", "luv", "rgb", "xyz", "yxy"
The white reference of the from and to colour
space. Will only have an effect for relative colour spaces such as Lab and
luv. Any value accepted by as_white_ref()
allowed.
A numeric matrix with the same number of rows as colour
and either
3 or 4 columns depending on the value of to
. If colour
is given as a
data.frame
the output will be a data.frame as well
# NOT RUN {
spectrum <- t(col2rgb(rainbow(10)))
convert_colour(spectrum, 'rgb', 'lab')
# }
Run the code above in your browser using DataLab