Skip to contents

Image objects are pointers toward C++ objects stored in memory. When copying an Image object using an assignment operator, this creates a copy of the pointer, but not a copy of the C++ object. Any operation on the copied Image object will therefore result in a modification of the orginal Image object. This function duplicates the original Image object instead, allowing safe operations on it while maintaining the integrity of the original Image object.

Usage

cloneImage(x, target = "new")

Arguments

x

An Image object.

target

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

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

  • 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 if target does not have the same dimensions, number of channels, and bit depth as image, an error may be thrown.

Value

An Image object.

See also

Author

Simon Garnier, garnier@njit.edu

Examples

balloon <- image(system.file("sample_img/balloon1.png", package = "Rvision"))
balloon_clone <- cloneImage(balloon)