matlab cbfreeze,freezeColors.m

function freezeColors(varargin)

% freezeColors Lock colors of plot, enabling multiple colormaps per figure. (v2.3)

%

% Problem: There is only one colormap per figure. This function provides

% an easy solution when plots using different colomaps are desired

% in the same figure.

%

% freezeColors freezes the colors of graphics objects in the current axis so

% that subsequent changes to the colormap (or caxis) will not change the

% colors of these objects. freezeColors works on any graphics object

% with CData in indexed-color mode: surfaces, images, scattergroups,

% bargroups, patches, etc. It works by converting CData to true-color rgb

% based on the colormap active at the time freezeColors is called.

%

% The original indexed color data is saved, and can be restored using

% unfreezeColors, making the plot once again subject to the colormap and

% caxis.

%

%

% Usage:

% freezeColors applies to all objects in current axis (gca),

% freezeColors(axh) same, but works on axis axh.

%

% Example:

% subplot(2,1,1); imagesc(X); colormap hot; freezeColors

% subplot(2,1,2); imagesc(Y); colormap hsv; freezeColors etc...

%

% Note: colorbars must also be frozen. Due to Matlab 'improvements' this can

%no longer be done with freezeColors. Instead, please

%use the function CBFREEZE by Carlos Adrian Vargas Aguilera

%that can be downloaded from the MATLAB File Exchange

%(http://www.mathworks.com/matlabcentral/fileexchange/24371)

%

% h=colorbar; cbfreeze(h), or simply cbfreeze(colorbar)

%

% For additional examples, see test/test_main.m

%

% Side effect on render mode: freezeColors does not work with the painters

% renderer, because Matlab doesn't support rgb color data in

% painters mode. If the current renderer is painters, freezeColors

% changes it to zbuffer. This may have unexpected effects on other aspects

% of your plots.

%

% See also unfreezeColors, freezeColors_pub.html, cbfreeze.

%

%

% John Iversen (iversen@nsi.edu)