adimpro               package:adimpro               R Documentation

_I/_O _F_u_n_c_t_i_o_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     Create image objects of class "adimpro" from arrays, RAW-format
     files and other image formats.

_U_s_a_g_e:

     read.raw(filename, type="PPM",
              wb="CAMERA",cspace="Adobe",interp="Bilinear",maxrange=TRUE,
              rm.ppm=TRUE, compress=TRUE)
     read.image(filename, compress=TRUE)
     make.image(x,compress=TRUE, gammatype="None", whitep = "D65", cspace="Adobe", scale="Original",xmode="RGB")

_A_r_g_u_m_e_n_t_s:

filename: file name 

       x: Array or matrix containing RGB or greyscale values in the
          range (0,1) or (0,65535). 

    type: option settings for dcraw. default "PPM". 'type="png"' allows
          to read greyvalue png images as RAW-data (used as internal
          solution to store RAW information) 

      wb: white balance. default "CAMERA"

  cspace: 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.

  interp: defines the interpolation method, default "Bilinear",
          Alternatives are "VNG", "AHD", "FourC" (Four color
          interpolation) and "Halfsize", see manpages of dcraw.  "VNG"
          seems to provide the smallest spatial correlations.

maxrange: If TRUE increase range of values to maximum.

  rm.ppm: remove intermediate tmp file? default 'TRUE'

gammatype: 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.

  whitep: 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. 

compress: logical, determines if image data are stored in raw-format. 

   scale: '"Original"' scales to '(0,max(img$img))' if 
          'min(img$img)<0', otherwise keeps the original scale.
          '"Maxcontrast"' scales each channel to maximum contrast

   xmode: 'xmode' determines how to interpret the values in 'x' if
          'length(dim(x))==3'. Implemented are 'xmode="RGB"' (default)
          and 'xmode="HSI"'

_D_e_t_a_i_l_s:

     If ImageMagick is available on the system, 'read.image' reads any
     of the following image file formats: c("tif", "tiff", "pgm",
     "ppm", "png", "pnm", "gif", "jpg", "jpeg") converts it into a
     temporary "pgm" or "ppm" file. This file is removed after reading
     the image.   If ImageMagick is not available  only "pgm", "ppm"
     and "pnm" formats can be processed.

     If dcraw is available on the system, 'read.raw' reads many RAW
     formats. 'type' sets options to dcraw: "PPM" sets "-4", "RAW" sets
     "-4 -d", "HALFSIZE" sets "-h", "INFO" sets "-i -v". 'wb'
     indicates, which white balance should be used: "NONE", "AUTO",
     "CAMERA".

     Functions 'read.raw(file,type="RAW")' and 'read.image(file)'
     provide identical results on png-mages. If the result is a color,
     greyvalued or RAW image depends on the contend of the comment
     associated with the png-image.

     'make.image' converts an appropriate 2 or 3 dimensional array to
     an image object of class "adimpro".

_V_a_l_u_e:

     object of class "adimpro" containing the image. The object has the
     following components: 

     img: array containing the color values in the color space
          specified by 'value$type'.

    type: the color space.

   depth: color depth, here "16bit".

     dim: vector of length 2 containing the number of pixel in
          horizontal and vertival direction.

    file: the argument 'file' identifying the image.

  cspace: the type of rgb space used, as specified by 'cspace'.

  interp: interpolation applied by dcraw, as specified by 'interp'.

   gamma: has a gamma correction been applied, here FALSE for
          'read.raw) and TRUE for \code{read.image}'

gammatype: type of gamma correction 'read.image.'

      wb: type of white balance, as specified by 'wb'.

compressed: image data are stored as raw-vector (TRUE) or array of
          integers (FALSE).

_N_o_t_e:

     The function 'read.raw' requires dcraw to be installed.

_A_u_t_h_o_r(_s):

     Karsten Tabelow tabelow@wias-berlin.de and Joerg Polzehl
     polzehl@wias-berlin.de

_S_e_e _A_l_s_o:

     'read.image'

_E_x_a_m_p_l_e_s:

     ## Not run: demo(io)

