NAME
====
  vg_color_index() - load a colormap


SYNOPSIS
========
  int vg_color_index(int clname, int prz)


DESCRIPTION
===========
  Returns the color-index, which matches best the given colorname
  according to the loaded colormap.
  If you e.g. want to get the color-index for YELLOW, the returned value
  refers to the color of the loaded colormap, which is most yellow.

  clname is a predefined colorname (CL_-definition, see "Colornames"
  in Understanding colormap).

  With prz you define the color brightness as a percent value
  from 0 to 100.

  E.g. "vg_color_index(CL_GREEN,50)" returns a color-index, which matches
  best a half-bright color "green".


RETURN VALUE
============
  It returns the best color-index, a value from 0 to 255.


SEE ALSO
========
  Index
  Understanding colormap
  vg_load_colormap()
  vg_brightness()