Release Date: 1/31/2026
Versions: 8.5 and Higher
This API creates straight lines or boxes of various kinds on a legacy Elliott screen.
Screen-Parameters
LD,FR,FC,TR,TC,99,CS
FR is from row
FC is from column
TR is to row
TC is to column
A horizontal line is drawn when FR = TR
A vertical line is drawn when FC = TC
Otherwise, a box is drawn instead of a line
99 is optional (55 is the default)
The first 9 specifies the area of the FROM row/col where the line begins:
123 1 is top left pixel
456 5 is middle, middle pixel
789 9 is bottom right pixel, etc.
The second 9 specifies the area of the TO row/col where the line ends.
CS is optional (LS is default)
C can be L (literal color) or F (field color)
S can be S (single line) or D (double line)
Examples:
This example draws a horizontal line:
... a double line (LD,06,02,06,78,46,LD)
... on row 6 (LD,06,02,06,78,46,LD)
... from the left edge (LD,06,02,06,78,46,LD)
... of column 2 (LD,06,02,06,78,46,LD)
... to the right edge (LD,06,02,06,78,46,LD)
... of column 78 (LD,06,02,06,78,46,LD)
... in the middle of the row (LD,06,02,06,78,46,LD)
... using the color of the literals (LD,06,02,06,78,46,LD) on the screen:
MOVE "LD,06,02,06,78,46,LS" TO SCREEN-PARAMETERS
- PERFORM SCREEN-ROUTINE.
This example draws a box:
... from row 6, column 2 (LD,06,02,08,78,19,FS)
... to row 8, column 78 (LD,06,02,08,78,19,FS)
... starting at the topmost, leftmost pixel (LD,06,02,08,78,19,FS)
... ending at tje bottom most, rightmost pixel (LD,06,02,08,78,19,FS)
... using a single line (LD,06,02,08,78,19,FS)
... in the color of fields (LD,06,02,08,78,19,FS) on the screen
Because the sides of the box are drawn on the outer edges of the lines and columns, one can use all the rows and columns in the area, including lines 6 through 8 and columns 2 through 78.
Notes:
- DL and DF calls with certain characteristics automatically will be converted into LD calls as follows:
- DL... with Screen-Literal of all "-" will convert to LD,FR,FC,TR,TC,46,LS
- DL... with Screen-Literal of all "=" will convert to LD,FR,FC,TR,TC,46,LD
- DF... with Screen-Literal of all "-" will convert to LD,FR,FC,TR,TC,46,FS
- DF... with Screen-Literal of all "=" will convert to LD,FR,FC,TR,TC,46,FD
- Drawn lines persist until:
- a CS call clears a region, or
- the window is deleted (e.g., RW, RL), or
- the line is cleared (CL), or
- the field is cleared (CF)
NWSMSCRN
JEG