xyz2uint16 (Image Processing Toolbox User's Guide)

Image Processing Toolbox User's Guide

Convert color data from representation to uint16

Syntax

```
xyz16 = xyz2uint16(xyz)
```

Description

xyz16 = xyz2uint16(xyz) converts an M-by-3 or M-by-N-by-3 array of XYZ color values to uint16. xyz16 has the same size as xyz.

The Image Processing Toolbox follows the convention that double-precision XYZ arrays contain 1931 CIE XYZ values. XYZ arrays that are uint16 follow the convention in the ICC profile specification (ICC.1:2001-4, www.color.org) for representing XYZ values as unsigned 16-bit integers. There is no standard representation of XYZ values as unsigned 8-bit integers. The ICC encoding convention is illustrated by this table.

Value (X, Y, or Z)
uint16 Value

0.0
0

1.0
32768

1.0 + (32767/32768)
65535

Value (X, Y, or Z)	uint16 Value
`0.0`	`0`
`1.0`	`32768`
`1.0 + (32767/32768)`	`65535`

Class Support

xyz is a uint16 or double array that must be real and nonsparse. xyz16 is uint8.

Example

Convert XYZ values to uint16 encoding.

xyz2uint16([0.1 0.5 1.0])
ans =

  3277 16384 32768

For a full list of the toolbox color space conversion functions, see Color Space Conversions.

xyz2double ycbcr2rgb