colormap set and/or get a figure colormap.

## Syntax

                cmap = colormap()
                cmap = colormap(h)

                cmap = colormap(m)
                cmap = colormap(h, m)

                colormap(m)
                colormap(h, m)

## Arguments

h

  A figure handle. If not given the current figure is used (See gcf).

m

  A string (function name), a function, a Nx3 double matrix or `"default"` (to reset colormap to the default one). The color map to be used.

## Description

`colormap` function is a helper to manage colormaps.

`cmap = colormap()` returns the current figure colormap.

`cmap = colormap(h)` returns the colormap of the figure handle `h`.

`[cmap =] colormap(m)` sets the colormap `m` to the current figure. `cmap` is only returned when the output of the function is assigned.

`[cmap =] colormap(h, m)` sets the colormap `m` to the figure handle `h`. `cmap` is only returned when the output of the function is assigned.

## Examples

    plot3d();
    // Change colormap to parula (32 values)
    colormap(parula(32));
    // Change colormap to jet (default size)
    colormap(jet); // Equivalent to colormap("jet")

## See also

- Using colormaps
- jet
- parula
- gcf

## History

2024.1.0 Function `colormap` introduced.