18.08.2013 Views

(SYSLIB) Programming Reference Manual - Public Support Login ...

(SYSLIB) Programming Reference Manual - Public Support Login ...

(SYSLIB) Programming Reference Manual - Public Support Login ...

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

EDIT$–Fieldata Image Composition Editing Package<br />

8.2. EDIT$–General-Purpose Editing Routines<br />

PROC Call<br />

Before using the EDIT$ package, the caller must first establish edit mode by calling the<br />

EDIT$ routine. When edit mode is on, the index registers X1, X2, and X3 are used as<br />

pointers by EDIT$; do not disturb them. The original values of these registers are<br />

restored when edit mode is turned off. The only other registers used by EDIT$ are X11,<br />

A0, A1, A2, A3, and R1. These registers are not saved or restored. Table 8–1 describes<br />

the routines used to initialize and terminate EDIT$.<br />

All EDIT$ routines are called with an LMJ on X11 and expect the parameters in A0, A1,<br />

and A2. A column pointer is maintained by EDIT$; the pointer is advanced by the<br />

number of characters inserted whenever an editing function is performed. The first<br />

column is zero.<br />

Table 8–2 describes the EDIT$ routines.<br />

Each routine in the EDIT$ editing package has a corresponding procedure call. If there<br />

are no parameters, then load instructions are not generated and the input data is<br />

assumed to be in the designated registers. The parameters may be in the format<br />

"*u,*x,j".<br />

When two parameters are required (p1, p2), the first instruction is not generated if p2 is<br />

missing. If both p1 and p2 are missing, neither load instruction is generated. Some of<br />

the procedures do not require any parameters.<br />

Table 8–1. Initialization and Termination<br />

Generated<br />

Instructions<br />

E$DIT p1 LA,U A0,p1<br />

LMJ X11,EDIT$<br />

E$DITR p1 LA,U A0,p1<br />

LMJ X11,EDITR$<br />

Description<br />

Initializes and establishes edit mode.<br />

If p1 is not specified, the address of the packet must be in A0. S3<br />

of the first word of the packet is expected to contain the number<br />

of words in the image area, and H2 of the first word of the packet<br />

is expected to contain the location of the image area. The image is<br />

set to blanks and edit mode is established. The column pointer is<br />

set to the start of the image.<br />

Reenters edit mode.<br />

E$DITX LMJ X11,EDITX$ Terminates edit mode.<br />

E$PRINT p1 LA,U A0,p1<br />

LMJ X11,EPRINT$<br />

If p1 is not specified, the address packet must be in A0. Edit<br />

mode is reestablished and the column pointer (saved by EDITX$) is<br />

restored.<br />

The column pointer is saved in the packet. EDITX$ returns with<br />

the packet address in A0 and the number of words in the image in<br />

A1.<br />

Prints image line and EDITX$.<br />

See EPRINT$ description in Table 8–2.<br />

7833 1733–004 8–5

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!