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.

xyz2rgb

Convert CIE 1931 XYZ to RGB

Syntax

rgb = xyz2rgb(xyz)
rgb = xyz2rgb(xyz,Name,Value)

Description

example

rgb = xyz2rgb(xyz) converts CIE 1931 XYZ values to RGB values.

example

rgb = xyz2rgb(xyz,Name,Value) specifies additional options with one or more Name,Value pair arguments.

Examples

collapse all

Convert a color value in the XYZ color space to the sRGB color space.

xyz2rgb([0.25 0.40 0.10])
ans = 

    0.4174    0.7434    0.2152

Convert the color value in XYZ color space to the Adobe RGB (1998) color space.

xyz2rgb([0.25 0.40 0.10],'ColorSpace','adobe-rgb-1998')
ans = 

    0.5323    0.7377    0.2730

Convert an XYZ color value to sRGB specifying the D50 whitepoint.

xyz2rgb([0.25 0.40 0.10],'WhitePoint','d50')
ans = 

    0.3276    0.7517    0.2869

Convert an XYZ color value to an 8-bit encoded RGB color value.

xyz2rgb([0.25 0.40 0.10],'OutputType','uint8')
ans = 1x3 uint8 row vector

   106   190    55

Input Arguments

collapse all

Color values to convert, specified as a p-by-3 matrix of color values (one color per row), an m-by-n-by-3 image array, or an m-by-n-by-3-by-f image stack.

Data Types: single | double

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: xyz2rgb([0.25 0.40 0.10],'ColorSpace','adobe-rgb-1998')

collapse all

Color space of the input RGB values, specified as 'srgb', 'adobe-rgb-1998', or 'linear-rgb'.

Data Types: char

Reference white point, specified as a 1-by-3 vector or one of the CIE standard illuminants, listed in the following table.

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: single | double | char

Data type of returned RGB values, specified as one of the following values: 'double', 'single', 'uint8', or 'uint16'. If you do not specify OutputType, the output type is the same type as the input.

Data Types: char

Output Arguments

collapse all

Converted color values, returned as an array the same shape as the input. The output type is the same as the input type unless you specify the'OuputType' parameter.

See Also

Introduced in R2014b

Was this topic helpful?