MMOCLR:  Color Specifications

(Optional) A composite (unformatted) variable used to specify the color palette. It should be mapped as:

MAP1 MMOCLR

MAP2 BFCLR,B,1  ! border foreground

MAP2 BBCLR,B,1  ! border background

MAP2 TFCLR,B,1  ! text foreground

MAP2 TBCLR,B,1  ! text background

MAP2 AFCLR,B,1  ! arrows foreground

MAP2 ABCLR,B,1  ! arrows background

MAP2 PFCLR,B,1  ! prompt (title) fg

MAP2 PBCLR,B,1  ! prompt (title) bg

MAP2 WFCLR,B,1  ! warning mssg fg

MAP2 WBCLR,B,1  ! warning mssg bg

MAP2 SFCLR,B,1  ! status line fg

MAP2 SBCLR,B,1  ! status line bg

MAP2 RFCLR,B,1  ! ruler/reserved fg

MAP2 RBCLR,B,1  ! ruler/reserved bg

The effect of any of these color selections can be disabled by setting it to -1, which causes INMEMO to use the color setting which was in effect when INMEMO was called. The standard AM72 color selections range from 0-15, where 0 is usually black, so if your memo seems to disappear, you should check if you accidentally left any of the color palettes 0 on 0 (black on black).

The border colors (BFCLR and BBCLR) are used to display the border (box) around the memo. Although you can pick any combination you want, you will probably like to leave the border background the same as the screen background, which you can do easily by setting BBCLR to -1.

The text colors (TFCLR and TBCLR) are used for the text contents of the memo. We recommend using a text background color to stand out from the background of the rest of the screen.

The arrow colors (AFCLR and ABCLR) are used only when navigational arrows are displayed in the memo border to indicate text that is outside of the window. (You may want to make these the same color as the border, or at least the same background color.)

The prompt colors (PFCLR and PBCLR) are used to display the optional prompt (or title) of the memo which appears embedded in the top line of the border.

The warning/message colors (WFCLR and WBCLR) are used for displaying warnings and other messages (e.g. `MEMO LOCK', `LINK ERROR', etc.) If you are using INFLD, these colors should normally be the same as INFLD’s MFCLR and MBCLR. We only named them differently to avoid duplicate symbols when using the standard mapping.

The status line colors (SFCLR and SBCLR) are used for restoring the status line area after displaying any warnings or messages which appear on the status line (normally the bottom line of the terminal.) If you are using INFLD, these colors should normally be the same as INFLD's OFCLR and OBCLR. We only named them differently to avoid duplicate symbols when using the standard mapping. Note that as long as the current ambient color scheme when you call INMEMO is the same as you use for the status line, then you can safely set SFCLR and SBCLR to -1.

The ruler/reserved colors (RFCLR and RBCLR) are not used in release 2.0. We added them now because we intend to use them in the next release and figured you might as well map them now while you're at it. The first projected use will be for a ruler, but it may also be used for protected text, background text, etc.

Note that we did not provide different sets of colors to be used in display vs. editing situations like we did with INFLD, because most people prefer to omit redisplaying the text when switching from display to edit mode to save time. If you want to change the colors, since you use different xcalls to display and edit the memo, just use different colors for each xcall. (If you use different colors for editing but don't redisplay the text first, you will have the interesting effect of highlighting the text that has actually changed in the editing colors while the unchanged text remains in the display colors.)

INMEMO will automatically return to the pre-existing color scheme on exiting from a field, so you don't need to worry about it changing your ambient colors.

INMEMO does not check whether your terminal supports color, relying instead on your terminal driver to discard unsupported commands. You should program as if color was supported, since in most cases, color will have no effect on monochrome screens (unlike the PC software where color commands may be interpreted as other video effects on monochrome monitors). However, by passing all color commands to the terminal driver, we leave you the option of modifying the driver to substitute color commands for some other attribute. (Should you attempt this, note that the color commands should not occupy a space, and should operate as mode attributes.)

All of the Basic utility programs (ANAMMO, MAKMMO, FIXMMO, etc.) have been modified to use the color parameters, which are loaded by means of an include file (GETCLR.BSI) and a parameter file (COLOR.DEF).