GSPARF

GDDM-GKS V1R1 Programming Guide and Reference

GSPARF

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00

Purpose


GSPARF	(rfx, rfy)

APL code	1340
GKS RCP code	X'38002800' (939534336)

Function: To set pattern reference point.

Attribute function. Sets the pattern reference point for fill area output primitives. (See the section "GDDM-GKS restrictions" below.)

Parameters

rfx (specified by user) (short floating point)

rfy (specified by user) (short floating point)
The pattern reference point in world coordinates.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Fill area (GFA), Inquire pattern reference point (GQPARF), Set pattern size (GSPA)

Description

(See the section "GDDM-GKS restrictions" below.)

This function sets the location of the lower left corner of the pattern rectangle for subsequent fill area output primitives. The current pattern reference point in the GKS state list is set to the coordinates given by rfx and rfy.

When the fill area interior style is pattern, the pattern reference point is used with the pattern width and height vectors for displaying the patterned fill area output primitives. The pattern width and height vectors form two sides of a pattern box. The lower left corner of this box is positioned on the pattern reference point. The box is several color cells defined in the Set pattern representation (GSPAR) function. GKS replicates the pattern box to cover the entire interior of the fill area. The pattern reference point is subject to the same transformations as the fill area primitive that it is bound to.

GDDM-GKS Restrictions

The pattern reference point attribute is not used when fill areas are displayed at any of the GDDM-GKS supported graphics devices.

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP

Notices | Terms of use | Support | Contact z/OS