scheme-editor(3)

NAME

scheme-editor - Color Scheme Editor

SYNOPSIS

scheme-editor

DESCRIPTION

scheme-editor is a color scheme editor that provides a dialog interface to configure the color schemes used by the editor. The color schemes may be created or modified within the scheme editor and then committed to the configuration files for general use.

The color schemes are typically stored in the macros directory and are executed as macro files at start up. The standard schemes are called schemeX.emf.

The scheme-editor is displayed within a single dialog box, tab selections at the top of the dialog box enable color and scheme creation and/or modification. Navigation is typically performed using the mouse, where the mouse is absent then the TAB key may be used to move between the fields. The information presented is defined as follows:-

File Name


The name of the color scheme to be modified. This is the name of the schemeX.emf file, omitting the file extension. The standard color schemes supplied with MicroEmacs '99 are:-

• schemed - Default white on black.
• schemej - Black on cream.
• schemevi - GVim default color scheme
• schemepd - Plain Black on Cream
• schemepl - Plain White on Black
• schemel - Black on grey.
• schememd - Microsoft Developer Studio Colors.

Description


An ASCII description of the color scheme, used to identify the color scheme.

Buffer Hilight


Defines whether buffer hilighting should be enabled, when Completely Disable all buffers are displayed character for character in the standard text scheme, this will ensure maximum update performance but some file formats such as the on-line help will become unreadable so this option is really selected. Similarly Reformat Only disables the majority of buffers, hilighting is only enabled when the file would be unreadable without it, such as the on-line help or man page files. The default Fully Enabled setting enables all buffer hilighting.

Colors

The colors tab allows the basic palette colors of the editor to be created and modified. The left-hand side of the dialog contains a scrolling window containing the existing color entries. The right-hand side of the dialog provides the controls to add and change the color assignment. The controls operate on the currently selected palette entry.

Add


Creates and adds a new color entry into the palette. The new palette entry is created with a default color that may be subsequently modified.

Change


Commits the current selection color to the palette.

Red/Green/Blue


The color entries allow the currently selected palette color entry to be modified. The color values may be changed by direct numeric entry (0..255) or via the ^/v controls; the color is committed to the pallette using the Add or Change button.

Schemes

The schemes tab allows the color schemes to be edited. The left-hand side of the dialog contains a scrolling window of the available color palette (created from the Colors tab). The right-hand side of the window shows the variants of the color scheme.

Selection


The selection item provides a pull-down menu containing gross color scheme categories used by the editor.

Scheme


A pull-down menu containing the color schemes of the selection, modifying this entry shows the variants of the scheme in the Normal, Current, Select and Sel-Cur dialogs.

There are 4 variants of a single color scheme; each variant is comprised of a foreground and background color, additionally a Termcap hilighting classification may be assigned to the variant, which is used in the absence of (or in addition to) color. The variant of color displayed by a particular scheme depends upon the selection/current status of the text.

Normal


The normal color, when the text object is not selected or current (i.e. out of focus).

Current


The scheme color when the text object is current (i.e. in focus)

Select


The scheme color when the text object is selected (i.e. by the mouse) and is not current.

Sel-Cur


The scheme color when the text object is selected and is current.

The Termcap hilighting assignments are indicated by the alphabetic mode selection BILRUV, which are interpreted as follows:-

B - Bold.
I - Italic (typically displayed as underline).
L - Light (typically not supported).
R - Reverse video (fore/back-ground swapped).
U - Underline.
V - Toggle reverse video when inverted.

None, one or more of the Termcap modes may be applied to a single scheme variant. The last mode V needs a little more explanation; commands such as screen-poke(2) are able to invert the color scheme, i.e. use the fore color for the background etc. Enabling this mode will toggle the reverse video mode (R) when this feature is used.

Setting of the selection and scheme shows the current scheme in the Normal, Current, Select and Sel-Cur dialogs. New colors are assigned by selecting a color in the pallette area and making it current. The current color is applied by selecting the Fore / Back boxes of the scheme dialog. The assigned color is displayed in the text box The big brown ....

Controls

The controls at the bottom of the dialog apply the edits to the configuration files.

Current


Makes the changes to the pallette and schemes current, they are applied to the current editing session but are not committed to file. This allows the pallette changes to be used prior to commitment. Note that all modifications are lost if they are not saved and the editing session is terminated.

Save


Saves the color modifications to file, effectively making the changes permanent. Note however that the scheme macro file will be saved in the first directory in the $search-path(5), regardless of the location of the original. For network systems this typically means that the changes will only effect the current user.

Install


Installs the current color scheme into the configuration files, making the color scheme accessible to the user-setup(3) dialog.

Exit


Quits the scheme editor without modifying the settings.

FILES

schemed.emf - Default white on black color scheme.
schemej.emf - Black on cream color scheme.
schemel.emf - Black on grey color scheme.
schememd.emf - Microsoft Developer Studio color scheme.
scheme.emf - Defines the standard color scheme variables and associated text. The print <=> scheme assignments are made in this file.

NOTES

scheme-editor is a macro that is implemented in file schemosd.emf. The scheme editor uses osd(2) to create and manage the dialogs.

SEE ALSO

user-setup(3), add-color(2), add-color-scheme(2), osd(2).

(c) Copyright JASSPA 1999
Last Modified: 1999/11/28
Generated On: 1999/12/01