Skip to contents

Convert Image to New Bit Depth

Source: R/conversions.R
changeBitDepth.Rd

This function takes an Image object and modifies its bit depth (e.g. from 16 bits to 8 bits).

Usage

changeBitDepth(image, bitdepth, scale = 1, target = "new", in_place = NULL)

Arguments

image

An Image object.

bitdepth

A string corresponding to the bit depth the image should be converted to. Options are "8U", "8S", "16U", "16S", "32S", "32F", and "64F". Converting from a higher bit depth to a lower one (e.g., "16U" to "8U" may result in data loss).

scale

A scaling factor (default: 1).

target

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.

in_place

Deprecated. Use target instead.

Value

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

Image, changeColorSpace

Author

Simon Garnier, garnier@njit.edu

Examples

balloon <- image(system.file("sample_img/balloon1.png", package = "Rvision"))
balloon_16 <- changeBitDepth(balloon, "16U")