Access or Modify the Whitepoint

This function can be used to control the single global whitepoint that affects all color conversions within the package (that require a whitepoint, i.e., go through XYZ).

whitepoint(white, ...)

Arguments

white, ...

Either missing (to query the whitepoint) or NULL or a specification of the XYZ coordinates of the whitepoint (to set the whitepoint, see examples). NULL corresponds to CIE D65 with XYZ coordinates 95.047, 100.000, 108.883.

Value

whitepoint returns an XYZ color object for the whitepoint (invisibly in case a new whitepoint was set).

See also

XYZ and color-class.

Examples

# query current whitepoint (D65 by default)
whitepoint()
#>           X   Y       Z
#> [1,] 95.047 100 108.883

# Illuminant E 
whitepoint(XYZ(100, 100, 100))

# equivalently
whitepoint(100, 100, 100)
whitepoint(c(100, 100, 100))
whitepoint(cbind(100, 100, 100))

whitepoint()
#>        X   Y   Z
#> [1,] 100 100 100

## reset
whitepoint(NULL)
whitepoint()
#>           X   Y       Z
#> [1,] 95.047 100 108.883