The function allows to perform pixelwise operations, specified by a supplied function, on a pair of images.
combine(img1, img2, fun = "+", rescale = TRUE, compress = TRUE, gammatype = "None",
whitep = "D65", cspace = "Adobe", xmode = "RGB", ...)
object of class "adimpro" containing the image. The object has the following components:
array containing the color values in the color space specified by value$type
.
the color space.
color depth, here "16bit".
vector of length 2 containing the number of pixel in horizontal and vertival direction.
the argument file
identifying the image.
the type of rgb space used, as specified by cspace
.
interpolation applied by dcraw, as specified by interp
.
has a gamma correction been applied, here FALSE for read.raw
and TRUE for read.image
type of gamma correction read.image.
type of white balance, as specified by wb
.
image data are stored as raw-vector (TRUE) or array of integers (FALSE).
image, object of class adimpro
image, object of class adimpro, need to have the same dimension as img1
A function or primitive of two (or more) arguments
specifying the operation. The first argument corresponds to
grey/color-values in img1, the second to img2. Auxiliary parameters can passed throug "..."
logical: if TRUE the resulting image is rescaled to fit into the range of possible grey/color-values, if FALSE values outside the range are truncated.
logical, determines if image data are stored in raw-format.
character, determines the type of gamma correction within the image.
"ITU" stands for ITU-R BT.709-3 as e.g. used by dcraw
. Alternatives recognized
within the package are "None", "sRGB" and "CIE" (CIE L*). Please specify if you know
that your image is not gamma corrected using ITU-R BT.709-3.
White point in xyY
space. Can be given as one of (character)
c("A","B","C","E","D50","D55","D65","D75","F2","F7","F11")
or as a two element numeric
vector of chromatic xy
coordinates. "D65"
corresponds to the default white point of "sRGB"
and "Adobe"
RGB-spaces.
defines the output color space, default "sRGB" (sRGB D65), alternatives are "RAW" (Camera specific), "Adobe" (Adobe 1998 D65), "wGamut" (Wide Gamut D65), "kodak" (Kodak ProPhoto D65) and "XYZ", see manpages of dcraw.
xmode
determines how to interpret the values in x
if length(dim(x))==3
.
Implemented are xmode="RGB"
(default) and xmode="HSI"
additional parameters for function fun
Karsten Tabelow tabelow@wias-berlin.de and Joerg Polzehl polzehl@wias-berlin.de
There are two mayor applications for this function. First it allows to add noise to an image by first creating an image that contains the noise and then adding this image using fun="+"
. Second it offers a way to replace parts of an image, see examples.
make.image