Nothing
#' Convert to and from the R native colour representation
#'
#' Colours in R are internally encoded as integers when they are passed around
#' to graphics devices. The encoding splits the 32 bit in the integer between
#' red, green, blue, and alpha, so that each get 8 bit, equivalent to 256
#' values. It is very seldom that an R user is subjected to this representation,
#' but it is present in the `nativeRaster` format which can be obtained from
#' e.g. capturing the content of a graphic device (using `dev.capture()`) or reading
#' in PNG files using `png::readPNG(native = TRUE)`. It is very rare that you
#' might need to convert back and forth between this format, but it is provided
#' here for completeness.
#'
#' @param colour For `encode_native` either a vector of hex-encoded
#' colours/colour names or a matrix encoding colours in any of the supported
#' colour spaces. If the latter, the colours will be encoded to a hex string
#' using [encode_colour()] first. For `decode_native` it is a vector of
#' integers.
#' @param ... Arguments passed on to [encode_colour()]
#'
#' @return `encode_native()` returns an integer vector and `decode_native()`
#' returns a character vector, both matching the length of the input.
#'
#' @export
#' @name native-encoding
#' @rdname native_encoding
#'
#' @examples
#'
#' # Get native representation of navyblue and #228B22
#' native_col <- encode_native(c('navyblue', '#228B22'))
#' native_col
#'
#' # Convert back
#' decode_native(native_col)
#'
encode_native <- function(colour, ...) {
if (!is.character(colour)) {
colour <- encode_colour(colour, ...)
}
encode_native_c(colour)
}
#' @rdname native_encoding
#' @export
decode_native <- function(colour) {
decode_native_c(colour)
}
encode_native_c <- function(colour) {
.Call(`farver_encode_native_c`, colour)
}
decode_native_c <- function(colour) {
.Call(`farver_decode_native_c`, as.integer(colour))
}
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.