Category : Dbase (Clipper, FoxBase, etc) Languages Source Code
Archive   : DBT123S.ZIP
Filename : PAINT.DOC

PAINT
Command

Jeff Prosise 1988/No. 2 (Utilities)


Purpose: Edits or creates custom help or reference screens that can be
popped up over an application program or at the DOS prompt with the HELP.COM
(PC Lab Notes, 1988/No. 1). Also provides full control of character and
video attribute bytes and permits insertion of single-line, double-line, or
pattern characters from the extended-ASCII PC text-graphics set.

Format: PAINT [filespec]

Remarks: The optional filespec is the filename (plus drive and path, if
needed) of a help/reference screen previously saved for HELP.COM by means of
the related CAPTURE program (PC Lab Notes, 1988/No. 1). If filespec is
omitted, PAINT permits creating and saving a new screen in the appropriate
format. HELP files are 4,000-byte screen buffer images, and as many as 14
may be chained together for successive display. The PgUp and PgDn keys in
PAINT move through multiple-screen files.

The Ins key toggles the PAINT editor between overstrike (the default)
and insert modes. The Del key deletes the character under the cursor and
closes up the text. In overstrike mode, the Backspace key moves the cursor
left without moving any text characters to its right. In insert mode, the
Backspace drags characters with it. The cursor can be moved anywhere within
the viewing area by means of the cursor keys. Home and End move the cursor
to the ends of the text line, and Enter performs the usual carriage
return/line feed.

Function key F1 lists the menus presented by each function key, and
Esc de-selects any active menu. F3 toggles between text-only and text-plus
-attribute modes, which are also reflected in the operation of the Backspace
and Del keys. Attributes are selected by number(s) after pressing F2, which
presents 16 foreground and 8 background color choices (color systems) or
normal, reverse, boldface, or underline (monochrome systems). By positioning
the cursor on any displayed character and pressing F2 twice, that video
attribute can be selected without using the menu numbers. Pressing Enter
defaults to the current selection. Selected attributes remain in effect
until changed.

Small or irregular screen areas can be "painted" with the current
attribute by holding down the Ctrl key and pressing the desired cursor Arrow
keys. Large screen areas may be defined by locating the cursor at one corner
and pressing F5, then moving to the diagonal corner and pressing F5 again. A
menu choice is then presented, either to clear the defined block of text
characters or to paint them all with the current video attribute. Pressing
F5 twice without moving the cursor defines the entire screen and presents the
same choice.

Function key F4 permits selection of single-line, double-line,
patterns, or asterisks that are then written to the screen by holding down the
Alt key and pressing the cursor arrows. Where lines cross, appropriate
junction symbols are substituted. F6 asks for a filename under which the file
is to be saved (it supplies the original filename as a default) and saves the
file. Compensation is automatically applied to adjust for differences in
display size. Pressing F7 returns to DOS.


Notes:

1. While PAINT is intended primarily for use with screens that use the
HELP program, it can be used to advantage in prototyping screens for
application programs and in the design layout of other pop-up windows.

2. PAINT is compatible both with traditional PCs and with the new PS/2 line.