show.image {adimpro}R Documentation

I/O functions


Display an image on the screen.


show.image(img, max.x = 1000, max.y = 1000, gammatype = "ITU", 
           whitep = NULL, temp = NULL, cspace = "sRGB", black=0, exposure = 1, 
           channel=NULL, new = FALSE,  ...)



image data, an object of class "adimpro".


maximum value of pixels in x dimension to be displayed.


maximum value of pixels in y dimension to be displayed.


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*). gammatype="histogram" forces histogram equalization based on the corresponding greyvalue image.


defines the output color space, default "sRGB" (sRGB D65), alternatives are "Adobe" (Adobe 1998 D65), "wGamut" (Wide Gamut D65), "kodak" (Kodak ProPhoto D65) "xyz", "yuv", "yiq" and "hsi". NULL keeps the actual setting. If"hsi","yuv","yiq","xyz") the individual channels are rescaled to provide maximum contrast. Information from the three channels is coded as "red", "green" and "blue" providing a miscolored image in these cases. Individual channels can be displayed as greyvalue images by specifying the channel argument."greyvalue" provides a greyvalue image.


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. NULL keeps the actual setting.


Color temperature. Can be used to specify chromatic xy coordinates of the whitepoint. Only used if is.null(whitep).


Adjustment for black color. Color values with luminance <= black will be assigned to black in RGB. Adjustment ist done in xyY space.


Multiplicative factor for all color channels (in xyz or rgb spaces). Applied in linear color space, i.e. if the image is gamma corrected the gamma correction is reversed first.


allows to select a color channel (1: red, 2: green, 3: blue in case of "rgb") for display.


should new X11() be opened? default FALSE


additional arguments to image can be passed here.


This function displayes greyscale and color images on the screen. If the actual dimension of the image exceeds max.x or max.y the image is shrinked by displaying only part of the pixels (every second/third/... such that the resulting dimension is smaller than max.x or max.y)


Nothing is returned


Karsten Tabelow and Joerg Polzehl

See Also

read.image, write.image, adjust.image


## Not run: demo(io)

[Package adimpro version 0.9.3 Index]