GSFAI

GDDM-GKS V1R1 Programming Guide and Reference

GSFAI

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

Purpose


GSFAI	(index)

APL code	1335
GKS RCP code	X'38002300' (939533056)

Function: To set fill area index.

Output attribute. Sets the current fill area index.

Parameters

index (specified by user) (fullword integer)
The fill area index.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Set fill area representation (GSFAR), Fill area (GFA), Set aspect source flags (GSASF)

Description

This function sets the current fill area index in the GKS state list to the value given by index. The fill area index is used for subsequent fill area primitives.

The appearance of fill areas is determined by their color, interior style, and the style of hatch or pattern that fills the interior. Using Set fill area representation (GSFAR), you can define a number of bundles of values for these three attributes at any workstation. The bundles are stored in the fill area bundle table for the workstation. The fill area index is a pointer into the fill area bundle table at each workstation. When a fill area primitive is displayed, attributes from the bundle specified by the fill area index are used according to the corresponding aspect source flag (ASF). You use Set aspect source flags (GSASF) to define whether or not fill area attributes are to be taken from bundles on the output workstations. If the ASF for an attribute is bundled, the bundled attribute is used. An aspect source flag exists for each of these fill area attributes:

Fill area color index
Fill area interior style
Fill area style index.

If you do not call this function in your program before calling the Fill area (GFA) function, or if the index you request is not defined or is not available on the workstation, fill area index 1 is used.

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP
80: Fill area index is invalid

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