## CLIM Adjust Color limits of plot

Section: Handle-Based Graphics

### Usage

There are several ways to use `clim` to adjust the color limits of a plot. The various syntaxes are

       clim
       clim([lo,hi])
       clim('auto')
       clim('manual')
       clim('mode')
       clim(handle,...)

The first form (without arguments), returns a 2-vector containing the current limits. The second form sets the limits on the plot to `[lo,hi]`. The third and fourth form set the mode for the limit to `auto` and `manual` respectively. In `auto` mode, FreeMat chooses the range for the axis automatically. The `clim('mode')` form returns the current mode for the axis (either `'auto'` or `'manual'`). Finally, you can specify the handle of an axis to manipulate instead of using the current one.

### Example

Here is an example of using `clim` to change the effective window and level onto an image. First, the image with default limits

    --> x = repmat(linspace(-1,1),[100,1]); y = x';
    --> z = exp(-x.^2-y.^2);
    --> image(z)
    ans =
      <uint32>  - size: [1 1]
     100002

which results in

Next, we change the colorscale of the image using the `clim` function

    --> clim([0,0.2])

which results in