Main Content

ind2rgb

Convert indexed image to RGB image

collapse all in page

Syntax

RGB = ind2rgb(X,map)

Description

RGB = ind2rgb(X,map) converts the indexed image X and corresponding colormap map to RGB (truecolor) format.

example

Examples

collapse all

Open Live Script

Read the first image in a sample indexed image file.

[A,map] = imread("corn.tif");
whos A map
  Name        Size              Bytes  Class     Attributes

  A         415x312            129480  uint8               
  map       256x3                6144  double

The indexed image A is a 415-by-312 matrix of type uint8, and the colormap map is a 256-by-3 matrix of type double. The dimensions of map indicate that the indexed image contains up to 256 colors.

Display the image.

imshow(A,map)

Figure contains an axes object. The hidden axes object contains an object of type image.

Convert the indexed image to an RGB image. The result is a 415-by-312-by-3 array of type double. 

RGB = ind2rgb(A,map);

Check that the values of the RGB image are in the range [0, 1].

[minVal,maxVal] = bounds(RGB(:))
minVal = 
0.0078

maxVal = 
0.9765

Input Arguments

collapse all

Indexed image, specified as an m-by-n matrix of integers.

  • If you specify X as an array of integer data type, then the value 0 corresponds to the first color in the colormap map. For a colormap containing c colors, values of image X are clipped to the range [0, c-1].

  • If you specify X as an array of data type single or double, then the value 1 corresponds to the first color in the colormap. For a colormap containing c colors, values of image X are clipped to the range [1, c].

Data Types: single | double | uint8 | uint16

Colormap associated with indexed image X, specified as a c-by-3 matrix with values in the range [0, 1]. Each row of map is a three-element RGB triplet that specifies the red, green, and blue components of a single color of the colormap.

Data Types: double

Output Arguments

collapse all

RGB image, returned as an m-by-n-by-3 numeric array with values in the range [0, 1].

Data Types: double

Extended Capabilities

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

Version History

Introduced before R2006a

See Also

| |

Topics