beautypg.com

Execform – AMT Datasouth PAL User Manual

Page 100

background image

execform

94

execform

Description

Captures the results of a drawing sequence for faster reuse on the same or subsequent pages.

Usage

FormDict

execform

FormDict

Dictionary. Contains parameters for capturing the desired drawing sequence as
well as the procedure which performs the drawing sequence. This dictionary
contains the following entries.

/BBox [LeftNum BottomNum RightNum TopNum]

Array. Specifies the area on the page in which PAL will capture any
drawing operations. PAL will clip any drawing operations which
exceed these boundaries. The values are in the form coordinate system,
which is establish by applying the /Matrix entry in FormDict to the
current coordinate system.

LeftNum

Integer or fixed-point. Specifies the left edge of the capture
area.

BottomNum

Integer or fixed-point. Specifies the bottom edge of the capture
area.

RightNum

Integer or fixed-point. Specifies the right edge of the capture
area.

TopNum

Integer or fixed-point. Specifies the top edge of the capture
area.

/FormType

Integer. This entry exists primarily to provide for future expansion. This
entry must have the value one (1) at this time.

/Matrix

Array. Specifies a transformation matrix which PAL will apply
(concatenate to) the current transformation matrix before starting the
drawing operations to be captured. To use the current transformation
matrix setting, specify a matrix of "[1 0 0 1 0 0]".

/PaintProc

Procedure. Specifies the procedure containing the drawing operations
which PAL will capture.

Comments

The execform operator instructs PAL to capture a series of drawing operations. When PAL
captures the specified drawing sequence, PAL produces a "form". A form is equivalent to a
graphic image sent from a host computer. However, in the case of a form, the image is created
within the printer's memory. PAL automatically determines the size of the image from the /BBox
entry specified in FormDict.