imageGet

Get image processor parameters and transforms.

       val = imageGet(vci,param,varargin)

 Virtual camera image structures describe parameters of the processing
 pipeline and of the target display. 

 The method parameters refer to a function call for performing, say, color
 balance or color conversion.  The transform parameters are the 3x3 linear
 transformations applied in many of these cases.

 In the future, we anticipate separating these two types of properties
 (processing and display).  The display will be a structure within the
 processing pipeline.  We are in the process of developing an extensive
 display simulation technology.

 Image Processor parameters
      {'name'}  - This image processing structure name
      {'type'}  - Always 'vcimage'
      {'row'}   - Display row number
      {'col'}   - Display col number
      {'size'}  - (row,col)

 Methods
      {'render'}       - Render structure
      {'colorbalance'} - Color balance structure
        {'colorbalancemethod'}     - Function name for color balance
        {'customcolorbalancelist'} - List of user supplied color balance functions
      {'demosaic'}     - Demosaic structure
        {'demosaicmethod'}          - Function name for spatial demosaic'ing
        {'customdemosaiclist'}      - List of user supplied color balance functions
      {'colorconversion'}  - Color conversion structure
        {'colorconversionmethod'}    - Function name for color conversion
        {'customcolorconversionlist'}- List of user supplied color conversion functions
      {'internalcolorspace'}         - Internal color space name (e.g.,'XYZ')
        {'internalcolormatchingfunction'}

  Wavelength functions for the internal color space
      {'spectrum'}     - Wavelength information structure
        {'wavelength'} - wavelength samples
        {'binwidth'}   - wavelength bin size
        {'nwave'}      - number of wavelength samples

 Display and data information
      {'display'}  - Target display structure
        {'displayxyz'} - CIE XYZ properties of the display
         % Red primary in first row, green in second, and blue in third.
      {'displayxy'}    - CIE chromaticity (xy) of the display primaries
      {'displaywhitepoint'}    - CIE chromaticity of the display white point
      {'maxdisplayluminance'}  -
      {'displayspd'}    - Display primary spectral power distributions
      {'displaymax'}    - Maximum RGB value for the display
         % This is always 1 up to now.  But if this variable is set, return it.
      {'data'}  - Data structure
        {'sensorinput'}  - Sensor data used to initiate rendering pipeline
        {'displaydata'}  - Digital values for the display after rendering
        {'dataxyz'}      - CIE XYZ values of the display data
        {'dataroi'}      - Slot to store region of interest RGB data
        {'roixyz'}       - Slot to store XYZ values of ROI data
        {'resultscaledtomax'} - Display data scaled to display max
        {'resultprimaryn'}    - Retrieve primary values for primary 'n'
        {'resultmax','rgbmax','displaymax'}
        {'maximumsensorvalue'}
        {'datawhitepoint'}
        {'scaledisplay'}
      {'dataordisplaywhite'}  - Data white point if present, otherwise
                                display white poin
      {'transforms'} - Rendering transforms in a cell array
        {'colorConversionTransform'}  - color conversion (transform{1})
        {'colorBalanceTransform'}     - color balance    (transform{2})
        {'ics2displayTransform'}      - Internal color space to display (transform{3})
        {'combinedTransform'}         - Product of the other 3 transforms,
                                        tCC{1}*tCB{2}*tICS2D{3}

 Copyright ImagEval Consultants, LLC, 2005.