Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

whitepoint

XYZ color values of standard illuminants

Syntax

xyz = whitepoint
xyz = whitepoint(illuminant)

Description

example

xyz = whitepoint returns the XYZ value corresponding to the default ICC white reference illuminant, scaled so that Y = 1.

example

xyz = whitepoint(illuminant) returns the XYZ value corresponding to the white reference illuminant, illuminant, scaled so that Y = 1.

Examples

Get XYZ Value of ICC Illuminant

Return the XYZ color space representation of the default white reference illuminant, 'icc'.

wp_icc = whitepoint
wp_icc =

    0.9642    1.0000    0.8249

Note that the second element, corresponding to the Y value, is 1.

Get XYZ Value of d65 Illuminant

Return the XYZ color space representation of the 'd65' white reference illuminant.

wp_d65 = whitepoint('d65')
wp_d65 =

    0.9504    1.0000    1.0888

Input Arguments

collapse all

White reference illuminant, specified as one of these values:

ValueWhite Point
'a'

CIE standard illuminant A, [1.0985, 1.0000, 0.3558]. Simulates typical, domestic, tungsten-filament lighting with correlated color temperature of 2856 K. 

'c'CIE standard illuminant C, [0.9807, 1.0000, 1.1822]. Simulates average or north sky daylight with correlated color temperature of 6774 K. Deprecated by CIE.
'e'Equal-energy radiator, [1.000, 1.000, 1.000]. Useful as a theoretical reference.
'd50'CIE standard illuminant D50, [0.9642, 1.0000, 0.8251]. Simulates warm daylight at sunrise or sunset with correlated color temperature of 5003 K. Also known as horizon light.

'd55'

CIE standard illuminant D55, [0.9568, 1.0000, 0.9214]. Simulates mid-morning or mid-afternoon daylight with correlated color temperature of 5500 K.  

'd65'CIE standard illuminant D65, [0.9504, 1.0000, 1.0888]. Simulates noon daylight with correlated color temperature of 6504 K. 
'icc'Profile Connection Space (PCS) illuminant used in ICC profiles. Approximation of [0.9642, 1.000, 0.8249] using fixed-point, signed, 32-bit numbers with 16 fractional bits. Actual value: [31595,32768, 27030]/32768.

Data Types: char | string

Output Arguments

collapse all

XYZ values corresponding to the illuminant, returned as a 3-element numeric row vector. The values are scaled so that Y = 1.

Data Types: double

Introduced before R2006a

Was this topic helpful?