Next: , Previous: cntrparam, Up: set-show


3.24.12 color box

The color scheme, i.e. the gradient of the smooth color with min_z and max_z values of pm3d's palette, is drawn in a color box unless `unset colorbox`.

           set colorbox
           set colorbox {
                      { vertical | horizontal }
                      { default | user }
                      { origin x, y }
                      { size x, y }
                      { front | back }
                      { noborder | bdefault | border [line style] }
                    }
           show colorbox
           unset colorbox
     

Color box position can be `default` or `user`. If the latter is specified the values as given with the origin and size subcommands are used. The box can be drawn after (`front`) or before (`back`) the graph or the surface.

The orientation of the color gradient can be switched by options `vertical` and `horizontal`.

`origin x, y` and `size x, y` are used only in combination with the `user` option. The x and y values are interpreted as screen coordinates by default, and this is the only legal option for 3D plots. 2D plots, including splot with `set view map`, allow any coordinate system to be specified. Try for example:

         set colorbox horiz user origin .1,.02 size .8,.04

which will draw a horizontal gradient somewhere at the bottom of the graph.

border turns the border on (this is the default). `noborder` turns the border off. If an positive integer argument is given after border, it is used as a line style tag which is used for drawing the border, e.g.:

         set style line 2604 linetype -1 linewidth .4
         set colorbox border 2604

will use line style `2604`, a thin line with the default border color (-1) for drawing the border. `bdefault` (which is the default) will use the default border line style for drawing the border of the color box.

The axis of the color box is called `cb` and it is controlled by means of the usual axes commands, i.e. `set/unset/show` with cbrange, `[m]cbtics`, `format cb`, `grid [m]cb`, cblabel, and perhaps even cbdata, `[no]cbdtics`, `[no]cbmtics`.

`set colorbox` without any parameter switches the position to default. `unset colorbox` resets the default parameters for the colorbox and switches the colorbox off.

See also help for pm3d, palette, pm3d, and `set style line`.