readImage {EBImage} | R Documentation |
Functions to choose, read and write images from/to files and URL's. Supported image formats are determined by the ImageMagick installation.
chooseImage(colormode = Grayscale) readImage(files, colormode = Grayscale, ...) ## S4 method for signature 'Image': writeImage(x, files, ...)
x |
An object of Image . |
files |
A character vector of files/URL's to read from or to write to. |
colormode |
An integer value for the color mode of images after they are read. By default all images will be converted to Grayscale on read. |
... |
Reserved. |
If files
is missing when writing images, fileName(x)
method will be used to select a single file to write to. Otherwise,
the length of this vector must be equal either 1 or the number of 2D images
in the stack.
When writing images in formats supporting non-lossless compression (like JPEG),
the quality can be spcified used a numeric quality
argument with the
range [1,100]
. Higher values correspond to better quality. Defaults to 95.
The file format is deduced from the file name extension(s), there is neither a need nor a way to specify the format explicitly.
ImageMagick
is used to perform all image I/O operations. Therefore,
the package supports all the file types supported by ImageMagick
.
When reading images, files of different formats can be mixed in any consequence, including mixing single 2D images with TIFF image stacks. The result will contain a stack of all images and stacks cropped (filled with background if images are smaller) at the size of the first image read.
choose.image
is an interactive function that does not return to R
until either Ok or Cancel button is pressed in the GUI dialog. It uses
GTK+2
File Open Dialog to select images. Multiple images can be
selected and loaded at once. By default this functions reads images as
TrueColor
. This function will produce an error message if
the package was compiled without GTK+
support.
For readImage
and chooseImage
a new instance of
Image
.
For writeImage
an invisible NULL
.
Oleg Sklyar, osklyar@ebi.ac.uk, 2005-2006
ImageMagick: http://www.imagemagick.org.
f <- paste( system.file(package="EBImage"), "images/Gene1_G.tif", sep="/" ) ii = readImage(f) if ( interactive() ) { url <- c("http://www.google.com/intl/en/images/logo.gif") im <- readImage (url, TrueColor) ## Not run: writeImage (im, "googlelogo.tif") ## Not run: im1 <- channel ( chooseImage(), "gray") }