color Parameter

Sets and queries RGB color values for the Editor.

Scope: Global

Syntax

set color.n [R nn ] [G nn ] [B nn ] 
query color.n 

Options

n 
An Editor color number, from 1 to 16.
nn 
A color intensity value. Permitted values are 0 to 255 inclusive, where 0 is lowest intensity of color, and 255 is highest intensity of color.

Description

The Editor supports a set of sixteen colors. You can use the color parameter to change these colors. Changes to colors are saved between editing sessions.

Colors are defined by a mix of Red, Green, and Blue (RGB) color components. The color parameter lets you set the RGB mix of a given Editor color number to create your own colors.

Not all RGB color components need be defined when changing RGB color values. If an RGB color component is not specified when setting the color parameter, the current value for that color component is not changed. If, however, no color components at all are specified, the specified Editor color returns to its default value.

The default values of colors provided with the Editor are shown below:

   Color #     Default Value      R     G     B 
  -----------------------------------------------
      1        black              0     0     0 
      2        blue               0     0    170
      3        green              0    128    0
      4        cyan               0    128   128 
      5        red               128    0     0 
      6        pink              170    0    170
      7        brown             128   128    0
      8        light gray        192   192   192 
      9        gray              128   128   128 
     10        bright blue        0     0    255
     11        bright green       0    255    0
     12        bright cyan        0    255   255 
     13        bright red        255    0     0 
     14        bright pink       255    0    255
     15        yellow            255   255    0
     16        white             255   255   255 

Examples

  1. To change color 1 to khaki green, type:
    set color.1 R 150 G 160 B 110 
  2. To darken the gray used in color 9, and give it a slight reddish hue, type:
    set color.9 G 75 B 75 
  3. To change color 16 back to its default color values, type:
    set color.16
  4. To query the RGB color values for color 4, type:
    query color.4

API Return Codes

-2 
Parameter options specified are out of valid range.

font Parameter