Skip to contents

This function takes an Image object and converts it to another color space (e.g BGR to grayscale).


changeColorSpace(image, colorspace, target = "new", in_place = NULL)



An Image object.


A string corresponding to the color space the image should be converted to. Not all conversions between color spaces are possible. All available color space conversions can be found in cc_table.


The location where the results should be stored. It can take 3 values:

  • "new":a new Image object is created and the results are stored inside (the default).

  • "self":the results are stored back into image (faster but destructive).

  • An Image object:the results are stored in another existing Image object. This is fast and will not replace the content of image but will replace that of target. Note that target must have the same dimensions as image.


Deprecated. Use target instead.


If target="new", the function returns an Image

object. If target="self", the function returns nothing and modifies

image in place. If target is an Image object, the function returns nothing and modifies that Image object in place.

See also


Simon Garnier,


balloon <- image(system.file("sample_img/balloon1.png", package = "Rvision"))
grey_balloon <- changeColorSpace(balloon, "GRAY")