cmpermute (Image Processing Toolbox)

Rearrange the colors in a colormap

Syntax

[Y,newmap] = cmpermute(X,map)
[Y,newmap] = cmpermute(X,map,index)

Description

[Y,newmap] = cmpermute(X,map) randomly reorders the colors in map to produce a new colormap newmap. cmpermute also modifies the values in X to maintain correspondence between the indices and the colormap, and returns the result in Y. The image Y and associated colormap newmap produce the same image as X and map.

[Y,newmap] = cmpermute(X,map,index) uses an ordering matrix (such as the second output of sort) to define the order of colors in the new colormap.

Class Support

The input image X can be of class uint8 or double. Y is returned as an array of the same class as X.

Example

To order a colormap by luminance, use:

ntsc = rgb2ntsc(map);
[dum,index] = sort(ntsc(:,1));
[Y,newmap] = cmpermute(X,map,index);