Home > ISET > vcamera > scene > Illumination > readIllumination.m

readIllumination

PURPOSE ^

Return spectral radiance of a standard illuminants

SYNOPSIS ^

function spectralRadiance = readIllumination(lightParameters,lightName)

DESCRIPTION ^

Return spectral radiance of a standard illuminants

    spectralRadiance = readIllumination(lightParameters,lightName)
 
 The illuminant parameters can be controlled by using the structure
 lightParameters. See the example below for how to set the values of this
 structure.  
 
 If you don't wish to control the parameters, but only to get an
 illuminant by name, the spectral radiance is returned at 400:10:700  
 nm samples and the mean luminance is 100 cd/m2.

 The standard illuminant names are:

     {'tungsten'}
     {'illuminantc'}
     {'d50'}
     {'fluorescent'}
     {'d65','D65'}
     {'equalenergy'}
     {'blackbody'}   -- You must specify a color temperature in
                        lightParameters.temperature
     {'555nm'}

 The lightParameters structure is idiosyncratic and used only here.  

 See also: illuminantCreate

 Examples:
   readIllumination([],'d65')
   readIllumination([],'tungsten')

   lightParameters.name = 'd65';
   lightParameters.spectrum.wave = 400:10:700;
   lightParameters.luminance = 100;
   readIllumination(lightParameters);

   lightParameters.name = 'blackbody';
   lightParameters.temperature = 3000;
   lightParameters.spectrum.wave = 400:10:700;
   lightParameters.luminance = 100;
   sr = readIllumination(lightParameters);

 Copyright ImagEval Consultants, LLC, 2005.

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Sun 14-Jan-2007 10:24:23 by m2html © 2003