MATLAB Function Reference Volume 1: A - E - Bad Request

caxis
2caxis
Purpose Color axis scaling
Syntax caxis([cmin cmax])
caxis auto
caxis manual
caxis(caxis)
v = caxis
caxis(axes_handle,...)
Description caxis controls the mapping of data values to the colormap. It affects any
surfaces, patches, and images with indexed CData and CDataMapping set to
scaled. It does not affect surfaces, patches, or images with true color CData or
with CDataMapping set to direct.
2-214
caxis([cmin cmax]) sets the color limits to specified minimum and maximum
values. Data values less than cmin or greater than cmax map to cmin and cmax,
respectively. Values between cmin and cmax linearly map to the current
colormap.
caxis auto lets MATLAB compute the color limits automatically using the
minimum and maximum data values. This is MATLAB’s default behavior.
Color values set to Inf map to the maximum color, and values set to −Inf map
to the minimum color. Faces or edges with color values set to NaN are not
drawn.
caxis manual and caxis(caxis) freeze the color axis scaling at the current
limits. This enables subsequent plots to use the same limits when hold is on.
v = caxis returns a two-element row vector containing the [cmin cmax]
currently in use.
caxis(axes_handle,...) uses the axes specified by axes_handle instead of
the current axes.
Remarks caxis changes the CLim and CLimMode properties of axes graphics objects.
How Color Axis Scaling Works
Surface, patch, and image graphics objects having indexed CData and
CDataMapping set to scaled, map CData values to colors in the figure colormap