xyz2rgbwide
Description
specifies options using one or more name-value pair arguments.RGB
= xyz2rgbwide(XYZ
,BPS
,Name=Value
)
Examples
Convert CIE 1931 XYZ Values into Wide-Gamut RGB
Convert XYZ color values into 10-bit or 12-bit wide-gamut RGB values in the BT.2020/BT.2100 color space.
Convert XYZ Color into 10-bit BT.2020 RGB Value
Create an XYZ value.
xyzvalue = [0.25 0.40 0.10];
Convert the XYZ value to a 10-bit BT.2020 RGB value.
rgbvalue = xyz2rgbwide(xyzvalue,10)
rgbvalue = 1x3 uint16 row vector
504 670 289
Convert XYZ Color into 12-bit BT.2100 RGB Value
Create an XYZ value.
xyzvalue = [0.25 0.40 0.10];
Convert the XYZ value to a 12-bit BT.2100 RGB value.
rgbvalue = xyz2rgbwide(xyzvalue,12,'Colorspace','BT.2100')
rgbvalue = 1x3 uint16 row vector
2015 2681 1155
Convert XYZ Color into 10-bit BT.2100 RGB Value Using HLG
Create an XYZ value.
xyzvalue = [0.25 0.40 0.10];
Convert the XYZ value to a 10-bit BT.2100 RGB value using the Hybrid Log Gamma (HLG) transfer function.
rgbvalue = xyz2rgbwide(xyzvalue,12,'Colorspace','BT.2100','LinearizationFcn','HLG')
rgbvalue = 1x3 uint16 row vector
2875 3285 1989
Input Arguments
XYZ
— Color values in CIE 1931 XYZ color space
p-by-3 numeric matrix | m-by-n-by-3 numeric array | m-by-n-by-3-by-f numeric
array
Color values in the CIE 1931 XYZ color space, specified as one of the following:
p-by-3 numeric matrix of color values (one color per row)
m-by-n-by-3 numeric array representing an image
m-by-n-by-3-by-f numeric array representing a stack of images
Data Types: single
| double
BPS
— Bits per sample for each channel of output RGB image
10
| 12
Bits per sample for each channel of the output wide-gamut RGB image, specified as
10
or 12
.
Name-Value Arguments
Specify optional pairs of arguments as
Name1=Value1,...,NameN=ValueN
, where Name
is
the argument name and Value
is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Example: rgb = xyz2rgbwide([0.25 0.40 0.10],12,ColorSpace="BT.2100")
specifies the color space of the wide-gamut RGB values as
"BT.2100"
.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Example: rgb = xyz2rgbwide([0.25 0.40 0.10],12,"ColorSpace","BT.2100")
specifies the color space of the wide-gamut RGB values as
"BT.2100"
.
ColorSpace
— Color space of output RGB values
"BT.2020"
(default) | "BT.2100"
Color space of the output RGB values, specified as "BT.2020"
or
"BT.2100"
.
Data Types: char
| string
WhitePoint
— Reference white point
"d65"
(default) | "a"
| "c"
| "d50"
| "d55"
| "icc"
| "e"
| 1-by-3 vector
Reference white point, specified as one of the CIE standard illuminants, listed in the table.
Value | White Point |
---|---|
"a" | CIE standard illuminant A, |
"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. |
| CIE standard illuminant D55, |
"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
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| char
| string
LinearizationFcn
— Transfer function for transformation
"PQ"
(default) | "HLG"
Transfer function for transformation, specified as one of the following values:
Value | Description |
---|---|
"PQ" | Perceptual Quantization |
"HLG" | Hybrid Log Gamma |
Data Types: char
| string
Output Arguments
RGB
— Output RGB color values
numeric array
Output RGB color values, returned as a numeric array of the same size as the
XYZ
input value. The table shows the data range for the
wide-gamut color values for 10- and 12-bit data. The minimum value in each range maps to
black, and the maximum value in each range maps to white.
Data Type | Full Data Range | Data Range for Wide-Gamut RGB |
---|---|---|
10-bit | [0, 1023] | [64, 940] |
12-bit | [0, 4095] | [256, 3760] |
Data Types: uint16
References
[1] Rec. ITU-R BT.2020-2 (10/2015). "Parameter values for ultra-high definition television systems for production and international programme exchange." International Telecommunication Union; Broadcasting service (television). https://www.itu.int/rec/R-REC-BT.2020.
[2] Rec. ITU-R BT.2100-2 (07/2018). "Image parameter values for dynamic range television for use in production and international programme exchange." International Telecommunication Union; Broadcasting service (television). https://www.itu.int/rec/R-REC-BT.2100.
[3] Rec. ITU-R BT.2390-7 (07/2019). "High dynamic range television for production and international programme exchange." International Telecommunication Union; Broadcasting service (television). https://www.itu.int/pub/R-REP-BT.2390.
Version History
Introduced in R2020b
See Also
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)