Main Content

cmap2gray

Convert RGB colormap to grayscale colormap

Since R2020b

collapse all in page

    Syntax

    newmap = cmap2gray(map)

    Description

    newmap = cmap2gray(map) converts the RGB colormap map into the equivalent grayscale colormap newmap.

    example

    Examples

    collapse all

    Open Live Script

    Load an indexed image with its colormap into the workspace. The load command returns a structure containing the image data and the colormap. View the image.

    indImage = load('clown.mat');
figure
imshow(indImage.X,indImage.map)

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

    Convert the RGB colormap that came with the image into a grayscale colormap.

    newmap = cmap2gray(indImage.map);

    Display the image with the grayscale colormap.

    figure;
imshow(indImage.X,newmap)

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

    Input Arguments

    collapse all

    RGB colormap, specified as a c-by-3 numeric 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.

    If you have Parallel Computing Toolbox™ installed, map can also be a gpuArray object.

    Data Types: double

    Output Arguments

    collapse all

    Grayscale colormap, returned as a c-by-3 numeric matrix with values in the range [0, 1]. The three columns of newmap are identical, so that each row specifies a single intensity value.

    If you have Parallel Computing Toolbox installed, then newmap can also be a gpuArray object.

    Data Types: double

    Algorithms

    The cmap2gray function converts RGB values to grayscale values by forming a weighted sum of the R, G, and B components:

    0.298936021293775 * R + 0.587043074451121 * G + 0.114020904255103 * B

    The coefficients used to calculate grayscale values in the cmap2gray function are identical to those used to calculate luminance (E'y) in Rec.ITU-R BT.601-7 after rounding to three decimal places. Rec.ITU-R BT.601-7 calculates E'y using this formula:

    0.299 * R + 0.587 * G + 0.114 * B

    Extended Capabilities

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

    Version History

    Introduced in R2020b

    See Also

    | | | (Image Processing Toolbox)

    Topics