Color Space Conversion

Convert color information between color spaces

Library:
Computer Vision Toolbox / Conversions

Description

The Color Space Conversion block converts color information between color spaces. Use the Conversion parameter to specify the color spaces you are converting between.

R'G'B' to Y'CbCr
Y'CbCr to R'G'B'
R'G'B' to intensity
R'G'B' to HSV
HSV to R'G'B'
sR'G'B' to XYZ
XYZ to sR'G'B'
sR'G'B' to L*a*b*
L*a*b* to sR'G'B'

Ports

Input

expand all

`Input` — Input
M-by-N-by-P color matrix

Input color information, specified as an M-by-N-by-P color matrix of P color planes.

Data Types: single | double | int8 | uint8

`R'` — R plane
M-by-N matrix

R plane of the RGB color information, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`G'` — G plane
M-by-N matrix

G plane of the RGB color information, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`B'` — B plane
M-by-N matrix

B plane of the RGB color information, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`Y'` — Luma signal component
M-by-N matrix

Luma signal component, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`Cb` — Chrominance component
M-by-N matrix

Chrominance component, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`Cr` — Chrominance component
M-by-N matrix

Chrominance component, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`I'` — Intensity values
M-by-N-by-P color video

Intensity values specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`H` — Hue component
M-by-N matrix

Hue component, specified as an M-by-N matrix.

Data Types: single | double

`S` — Saturation component
M-by-N matrix

Saturation component, specified as an M-by-N matrix.

Data Types: single | double

`V` — Brightness component
M-by-N matrix

Brightness component, specified as an M-by-N matrix.

Data Types: single | double

`X` — X component
M-by-N matrix

X component, specified as an M-by-N matrix.

Data Types: single | double

`Y` — Y component
M-by-N matrix

Y component, specified as an M-by-N matrix.

Data Types: single | double

`Z` — Z component
M-by-N matrix

Z component, specified as an M-by-N matrix.

Data Types: single | double

`L*` — Luminance portion
M-by-N matrix

Luminance component, specified as an M-by-N matrix.

Data Types: single | double

`a` — a component
M-by-N matrix

a* component, specified as an M-by-N matrix.

Data Types: single | double

`b` — b component
M-by-N matrix

b* component, specified as an M-by-N matrix.

Data Types: single | double

Output

expand all

`Input` — Input
M-by-N-by-P color matrix

Input color information, specified as an M-by-N-by-P color matrix of P color planes.

If the input is uint8, then Y'CbCr is uint8, where Y is in the range [16 235], and Cb and Cr are in the range [16 240].
If the input is a double, then Y' is in the range [16/255 235/255] and Cb and Cr are in the range [16/255 240/255].

Data Types: single | double | int8 | uint8

`R'` — R plane
M-by-N matrix

R plane of the RGB color information, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`G'` — G plane
M-by-N matrix

G plane of the RGB color information, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`B'` — B plane
M-by-N matrix

B plane of the RGB color information, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`Y'` — Luma signal component
M-by-N matrix

Luma signal component, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`Cb` — Chrominance component
M-by-N matrix

Chrominance component, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`Cr` — Chrominance component
M-by-N matrix

Chrominance component, specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`I'` — Intensity values
M-by-N-by-P color video

Intensity values specified as an M-by-N matrix.

Data Types: single | double | int8 | uint8

`H` — Hue component
M-by-N matrix

Hue component, specified as an M-by-N matrix.

Data Types: single | double

`S` — Saturation component
M-by-N matrix

Saturation component, specified as an M-by-N matrix.

Data Types: single | double

`V` — Brightness component
M-by-N matrix

Brightness component, specified as an M-by-N matrix.

Data Types: single | double

`X` — X component
M-by-N matrix

X component, specified as an M-by-N matrix.

Data Types: single | double

`Y` — Y component
M-by-N matrix

Y component, specified as an M-by-N matrix.

Data Types: single | double

`Z` — Z component
M-by-N matrix

Z component, specified as an M-by-N matrix.

Data Types: single | double

`L*` — Luminance portion
M-by-N matrix

Luminance component, specified as an M-by-N matrix.

Data Types: single | double

`a` — a component
M-by-N matrix

a* component, specified as an M-by-N matrix.

Data Types: single | double

`b` — b component
M-by-N matrix

b* component, specified as an M-by-N matrix.

Data Types: single | double

Parameters

expand all

`Conversion` — Conversion
`R'G'B' to Y'CbCr` (default) | `Y'CbCr to R'G'B'` | `R'G'B' to intensity` | `R'G'B' to HSV` | `HSV to R'G'B'` | `sR'G'B' to XYZ` | `XYZ to sR'G'B'` | `sR'G'B' to Lab*`

Specify the conversion color spaces as one of the following:

R'G'B' to Y'CbCr
Y'CbCr to R'G'B'
R'G'B' to intensity
R'G'B' to HSV
HSV to R'G'B'
sR'G'B' to XYZ
XYZ to sR'G'B'
sR'G'B' to L*a*b*
L*a*b* to sR'G'B'

`Use conversion specified by` — Conversion standard
`Rec. 601 (SDTV)` (default) | `Rec. 709 (HDTV)`

Specify the standard to convert your values between the R'G'B' and Y'CbCr color spaces as either Rec. 601 (SDTV) or Rec. 709 (HDTV).

Dependencies

This parameter is visible when you set the Conversion to R'G'B' to Y'CbCr or Y'CbCr to R'G'B'.

`Scanning standard` — Scanning standard
`1125/60/2:1` (default) | `1250/50/2:1`

Specify the scanning standard to convert between the R'G'B' and Y'CbCr color spaces as either 1125/60/2:1 or 1250/50/2:1.

Dependencies

This parameter is visible when you set the Use conversion specified by parameter to Rec. 709 (HDTV).

`White point` — White point
`D50` (default) | `D55` | `D65`

Specify the reference white point.

Dependencies

This parameter is visible when you set the Conversion parameter to sR'G'B' to L*a*b* or L*a*b* to sR'G'B'.

`Image signal` — Image signal input
`One multidimensional signal` (default) | `Separate color signals`

Specify how to input and output a color signal. If you select One multidimensional signal, the block accepts an M-by-N-by-P color signal, where P is the number of color planes, at one port. If you select Separate color signals, additional ports appear on the block. Each port accepts one M-by-N plane of color signal stream.

Note

The prime notation indicates that the signals are gamma corrected.

Block Characteristics

Data Types	`Boolean` \| `double` \| `integer` \| `single`
Multidimensional Signals	`yes`
Variable-Size Signals	`yes`

Algorithms

expand all

Conversion Between R'G'B' and Y'CbCr Color Spaces

The following equations define R'G'B' to Y'CbCr conversion and Y'CbCr to R'G'B' conversion:

$[\begin{matrix} Y^{'} \\ C b \\ C r \end{matrix}] = [\begin{matrix} 16 \\ 128 \\ 128 \end{matrix}] + Α \times [\begin{matrix} R^{'} \\ G^{'} \\ B^{'} \end{matrix}]$

$[\begin{matrix} R^{'} \\ G^{'} \\ B^{'} \end{matrix}] = Β \times ([\begin{matrix} Y^{'} \\ C b \\ C r \end{matrix}] - [\begin{matrix} 16 \\ 128 \\ 128 \end{matrix}])$

The values in matrices A and B are based on your choices for the Use conversion specified by and Scanning standard parameters.

Matrix	Use conversion specified by = Rec. 601 (SDTV)	Use conversion specified by = Rec. 709 (HDTV)
Matrix	Use conversion specified by = Rec. 601 (SDTV)	Scanning standard = 1125/60/2:1	Scanning standard = 1250/50/2:1
A	$[\begin{matrix} 0.25678824 & 0.50412941 & 0.09790588 \\ - 0.1482229 & - 0.29099279 & 0.43921569 \\ 0.43921569 & - 0.36778831 & - 0.07142737 \end{matrix}]$	$[\begin{array}{l} 0 .18258588 0 .61423059 0 .06200706 \\ -0 .10064373 -0 .33857195 0 .43921569 \\ 0 .43921569 -0 .39894216 -0 .04027352 \end{array}]$	$[\begin{matrix} 0.25678824 & 0.50412941 & 0.09790588 \\ - 0.1482229 & - 0.29099279 & 0.43921569 \\ 0.43921569 & - 0.36778831 & - 0.07142737 \end{matrix}]$
B	$[\begin{matrix} 1.1643836 & 0 & 1.5960268 \\ 1.1643836 & - 0.39176229 & - 0.81296765 \\ 1.1643836 & 2.0172321 & 0 \end{matrix}]$	$[\begin{matrix} 1 .16438356 & 0 & 1 .79274107 \\ 1 .16438356 & -0 .21324861 & -0 .53290933 \\ 1 .16438356 & 2 .11240179 & 0 \end{matrix}]$	$[\begin{matrix} 1.1643836 & 0 & 1.5960268 \\ 1.1643836 & - 0.39176229 & - 0.81296765 \\ 1.1643836 & 2.0172321 & 0 \end{matrix}]$

Conversion from R'G'B' to Intensity

The following equation defines conversion from the R'G'B' color space to intensity:

$intensity = [\begin{matrix} 0.299 & 0.587 & 0.114 \end{matrix}] [\begin{matrix} R^{'} \\ G^{'} \\ B^{'} \end{matrix}]$

Conversion Between R'G'B' and HSV Color Spaces

The R'G'B' to HSV conversion is defined by the following equations. In these equations, MAX and MIN represent the maximum and minimum values of each R'G'B' triplet, respectively. H, S, and V vary from 0 to 1, where 1 represents the greatest saturation and value.

$\begin{array}{l} H = {\begin{matrix} (\frac{G^{'} - B^{'}}{M A X - M I N}) / 6, \begin{matrix} \begin{matrix} \begin{matrix} if \end{matrix} & R^{'} = M A X \end{matrix} \end{matrix} \\ (2 + \frac{B^{'} - R^{'}}{M A X - M I N}) / 6, \begin{matrix} \begin{matrix} \begin{matrix} if \end{matrix} & G^{'} = M A X \end{matrix} \end{matrix} \\ (4 + \frac{R^{'} - G^{'}}{M A X - M I N}) / 6, \begin{matrix} \begin{matrix} \begin{matrix} if \end{matrix} & B^{'} = M A X \end{matrix} \end{matrix} \end{matrix} \\ S = \frac{M A X - M I N}{M A X} \\ V = M A X \end{array}$

The HSV to R'G'B' conversion is defined by the following equations:

$\begin{array}{l} H_{i} = ⌊ 6 H ⌋ \\ f = 6 H - H_{i} \\ p = 1 - S \\ q = 1 - f S \\ t = 1 - (1 - f) S \\ \begin{matrix} if & H_{i} = 0, \begin{matrix} R_{t m p} = 1, & G_{t m p} = t, & B_{t m p} = p \end{matrix} \end{matrix} \\ \begin{matrix} if & H_{i} = 1, \begin{matrix} R_{t m p} = q, & G_{t m p} = 1, & B_{t m p} = p \end{matrix} \end{matrix} \\ \begin{matrix} if & H_{i} = 2, \begin{matrix} R_{t m p} = p, & G_{t m p} = 1, & B_{t m p} = t \end{matrix} \end{matrix} \\ \begin{matrix} if & H_{i} = 3, \begin{matrix} R_{t m p} = p, & G_{t m p} = q, & B_{t m p} = 1 \end{matrix} \end{matrix} \\ \begin{matrix} if & H_{i} = 4, \begin{matrix} R_{t m p} = t, & G_{t m p} = p, & B_{t m p} = 1 \end{matrix} \end{matrix} \\ \begin{matrix} if & H_{i} = 5, \begin{matrix} R_{t m p} = 1, & G_{t m p} = p, & B_{t m p} = q \end{matrix} \end{matrix} \\ u = V / \max (R_{t m p}, G_{t m p}, B_{t m p}) \\ R^{'} = u R_{t m p} \\ G^{'} = u G_{t m p} \\ B^{'} = u B_{t m p} \end{array}$

Conversion Between sR'G'B' and XYZ Color Spaces

The sR'G'B' to XYZ conversion is a two-step process. First, the block converts the gamma-corrected sR'G'B' values to linear sRGB values using the following equations:

$\begin{array}{l} If \begin{matrix} {R^{'}}_{s R G B}, {G^{'}}_{s R G B}, {B^{'}}_{s R G B} \leq 0.03928 \end{matrix} \\ R_{s R G B} = {R^{'}}_{s R G B} / 12.92 \\ G_{s R G B} = {G^{'}}_{s R G B} / 12.92 \\ B_{s R G B} = {B^{'}}_{s R G B} / 12.92 \\ otherwise, \begin{matrix} \begin{matrix} if & {R^{'}}_{s R G B}, {G^{'}}_{s R G B}, {B^{'}}_{s R G B} > 0.03928 \end{matrix} \end{matrix} \\ R_{s R G B} = {[\frac{({R^{'}}_{s R G B} + 0.055)}{1.055}]}^{2.4} \\ G_{s R G B} = {[\frac{({G^{'}}_{s R G B} + 0.055)}{1.055}]}^{2.4} \\ B_{s R G B} = {[\frac{({B^{'}}_{s R G B} + 0.055)}{1.055}]}^{2.4} \end{array}$

Then the block converts the sRGB values to XYZ values using the following equation:

$[\begin{matrix} X \\ Y \\ Z \end{matrix}] = [\begin{matrix} 0.41239079926596 & 0.35758433938388 & 0.18048078840183 \\ 0.21263900587151 & 0.71516867876776 & 0.07219231536073 \\ 0.01933081871559 & 0.11919477979463 & 0.95053215224966 \end{matrix}] \times [\begin{matrix} R_{s R G B} \\ G_{s R G B} \\ B_{s R G B} \end{matrix}]$

The XYZ to sR'G'B' conversion is also a two-step process. First, the block converts the XYZ values to linear sRGB values using the following equation:

$[\begin{matrix} R_{s R G B} \\ G_{s R G B} \\ B_{s R G B} \end{matrix}] = {[\begin{matrix} 0.41239079926596 & 0.35758433938388 & 0.18048078840183 \\ 0.21263900587151 & 0.71516867876776 & 0.07219231536073 \\ 0.01933081871559 & 0.11919477979463 & 0.95053215224966 \end{matrix}]}^{- 1} \times [\begin{matrix} X \\ Y \\ Z \end{matrix}]$

Then the block applies gamma correction to obtain the sR'G'B' values. This process is described by the following equations:

$\begin{array}{l} If \begin{matrix} R_{s R G B}, G_{s R G B}, B_{s R G B} \leq 0.00304 \end{matrix} \\ {R^{'}}_{s R G B} = 12.92 R_{s R G B} \\ {G^{'}}_{s R G B} = 12.92 G_{s R G B} \\ {B^{'}}_{s R G B} = 12.92 B_{s R G B} \\ otherwise, \begin{matrix} \begin{matrix} if & R_{s R G B}, G_{s R G B}, B_{s R G B} > 0.00304 \end{matrix} \end{matrix} \\ {R^{'}}_{s R G B} = 1.055 R_{s R G B}^{(1.0 / 2.4)} - 0.055 \\ {G^{'}}_{s R G B} = 1.055 G_{s R G B}^{(1.0 / 2.4)} - 0.055 \\ {B^{'}}_{s R G B} = 1.055 B_{s R G B}^{(1.0 / 2.4)} - 0.055 \end{array}$

Note

Computer Vision Toolbox™ software uses a D65 white point, which is specified in Recommendation ITU-R BT.709, for this conversion. In contrast, the Image Processing Toolbox™ conversion is based on ICC profiles, and it uses a D65 to D50 Bradford adaptation transformation to the D50 white point. If you are using these two products and comparing results, you must account for this difference.

Conversion Between sR'G'B' and Lab* Color Spaces

The Color Space Conversion block converts sR'G'B' values to L*a*b* values in two steps. First it converts sR'G'B' to XYZ values using the equations described in Conversion Between sR'G'B' and XYZ Color Spaces. Then it uses the following equations to transform the XYZ values to L*a*b* values. Here, $X_{n}$ , $Y_{n}$ , and $Z_{n}$ are the tristimulus values of the reference white point you specify using the White point parameter:

$\begin{array}{l} L * = 116 (^{Y / Y_{n}) 1 / 3} - 16, \begin{matrix} f o r & Y / Y_{n} \end{matrix} > 0.008856 \\ L * = 903.3 Y / Y_{n}, \begin{matrix} otherwise \end{matrix} \\ a * = 500 (f (X / X_{n}) - f (Y / Y_{n})) \\ b * = 200 (f (Y / Y_{n}) - f (Z / Z_{n})), \\ \begin{matrix} where & f (t) = t^{1 / 3} \end{matrix}, \begin{matrix} f o r & t > 0.008856 \end{matrix} \\ f (t) = 7.787 t + 16 / 166, \begin{matrix} otherwise \end{matrix} \end{array}$

The block converts L*a*b* values to sR'G'B' values in two steps as well. The block transforms the L*a*b* values to XYZ values using these equations:

$\begin{array}{l} \begin{matrix} For & Y / Y_{n} \end{matrix} > 0.008856 \\ X = X_{n} (P + a * / 500)^{3} \\ Y = Y_{n} P^{3} \\ Z = Z_{n} (P - b * / 200)^{3}, \\ \begin{matrix} where & P = (L * + 16) / 116 \end{matrix} \end{array}$

References

[1] Poynton, Charles A. A Technical Introduction to Digital Video. New York: John Wiley & Sons, 1996.

[2] Recommendation ITU-R BT.601-5, Studio Encoding Parameters of Digital Television for Standard 4:3 and Wide Screen 16:9 Aspect Ratios.

[3] Recommendation ITU-R BT.709-5. Parameter values for the HDTV standards for production and international programme exchange.

[4] Stokes, Michael, Matthew Anderson, Srinivasan Chandrasekar, and Ricardo Motta, “A Standard Default Color Space for the Internet - sRGB.” November 5, 1996.

[5] Berns, Roy S. Principles of Color Technology, 3rd ed. New York: John Wiley & Sons, 2000.

Documentation

Color Space Conversion

Description

Ports

Input

Input — Input M-by-N-by-P color matrix

R' — R plane M-by-N matrix

G' — G plane M-by-N matrix

B' — B plane M-by-N matrix

Y' — Luma signal component M-by-N matrix

Cb — Chrominance component M-by-N matrix

Cr — Chrominance component M-by-N matrix

I' — Intensity values M-by-N-by-P color video

H — Hue component M-by-N matrix

S — Saturation component M-by-N matrix

V — Brightness component M-by-N matrix

X — X component M-by-N matrix

Y — Y component M-by-N matrix

Z — Z component M-by-N matrix

L* — Luminance portion M-by-N matrix

a* — a* component M-by-N matrix

b* — b* component M-by-N matrix

Output

Input — Input M-by-N-by-P color matrix

R' — R plane M-by-N matrix

G' — G plane M-by-N matrix

B' — B plane M-by-N matrix

Y' — Luma signal component M-by-N matrix

Cb — Chrominance component M-by-N matrix

Cr — Chrominance component M-by-N matrix

I' — Intensity values M-by-N-by-P color video

H — Hue component M-by-N matrix

S — Saturation component M-by-N matrix

V — Brightness component M-by-N matrix

X — X component M-by-N matrix

Y — Y component M-by-N matrix

Z — Z component M-by-N matrix

L* — Luminance portion M-by-N matrix

a* — a* component M-by-N matrix

b* — b* component M-by-N matrix

Parameters

Conversion — Conversion R'G'B' to Y'CbCr (default) | Y'CbCr to R'G'B' | R'G'B' to intensity | R'G'B' to HSV | HSV to R'G'B' | sR'G'B' to XYZ | XYZ to sR'G'B' | sR'G'B' to L*a*b*

Use conversion specified by — Conversion standard Rec. 601 (SDTV) (default) | Rec. 709 (HDTV)

Dependencies

Scanning standard — Scanning standard 1125/60/2:1 (default) | 1250/50/2:1

Dependencies

White point — White point D50 (default) | D55 | D65

Dependencies

Image signal — Image signal input One multidimensional signal (default) | Separate color signals

Block Characteristics

Algorithms

Conversion Between R'G'B' and Y'CbCr Color Spaces

Conversion from R'G'B' to Intensity

Conversion Between R'G'B' and HSV Color Spaces

Conversion Between sR'G'B' and XYZ Color Spaces

Conversion Between sR'G'B' and L*a*b* Color Spaces

References

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using Simulink® Coder™.

Fixed-Point Conversion Design and simulate fixed-point systems using Fixed-Point Designer™.

See Also

Computer Vision Toolbox Documentation

Support

`Input` — Input
M-by-N-by-P color matrix

`R'` — R plane
M-by-N matrix

`G'` — G plane
M-by-N matrix

`B'` — B plane
M-by-N matrix

`Y'` — Luma signal component
M-by-N matrix

`Cb` — Chrominance component
M-by-N matrix

`Cr` — Chrominance component
M-by-N matrix

`I'` — Intensity values
M-by-N-by-P color video

`H` — Hue component
M-by-N matrix

`S` — Saturation component
M-by-N matrix

`V` — Brightness component
M-by-N matrix

`X` — X component
M-by-N matrix

`Y` — Y component
M-by-N matrix

`Z` — Z component
M-by-N matrix

`L*` — Luminance portion
M-by-N matrix

`a` — a component
M-by-N matrix

`b` — b component
M-by-N matrix

`Input` — Input
M-by-N-by-P color matrix

`R'` — R plane
M-by-N matrix

`G'` — G plane
M-by-N matrix

`B'` — B plane
M-by-N matrix

`Y'` — Luma signal component
M-by-N matrix

`Cb` — Chrominance component
M-by-N matrix

`Cr` — Chrominance component
M-by-N matrix

`I'` — Intensity values
M-by-N-by-P color video

`H` — Hue component
M-by-N matrix

`S` — Saturation component
M-by-N matrix

`V` — Brightness component
M-by-N matrix

`X` — X component
M-by-N matrix

`Y` — Y component
M-by-N matrix

`Z` — Z component
M-by-N matrix

`L*` — Luminance portion
M-by-N matrix

`a` — a component
M-by-N matrix

`b` — b component
M-by-N matrix

`Conversion` — Conversion
`R'G'B' to Y'CbCr` (default) | `Y'CbCr to R'G'B'` | `R'G'B' to intensity` | `R'G'B' to HSV` | `HSV to R'G'B'` | `sR'G'B' to XYZ` | `XYZ to sR'G'B'` | `sR'G'B' to Lab*`

`Use conversion specified by` — Conversion standard
`Rec. 601 (SDTV)` (default) | `Rec. 709 (HDTV)`

`Scanning standard` — Scanning standard
`1125/60/2:1` (default) | `1250/50/2:1`

`White point` — White point
`D50` (default) | `D55` | `D65`

`Image signal` — Image signal input
`One multidimensional signal` (default) | `Separate color signals`

Conversion Between sR'G'B' and Lab* Color Spaces

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.