GSFAR

GDDM-GKS V1R1 Programming Guide and Reference

GSFAR

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

Purpose


GSFAR	(wkid, fai, ints, styli, coli)

APL code	1347
GKS RCP code	X'38002E00' (939535872)

Function: To set fill area representation.

Output attribute. Associates a bundle of fill area characteristics with a fill area index at a workstation.

Parameters

wkid (specified by user) (fullword integer)
The workstation identifier

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

ints (specified by user) (fullword integer)
The fill area interior style. The possible values are:

0 (GHOLLO): Hollow
1 (GSOLID): Solid
2 (GPATTR): Pattern
3 (GHATCH): Hatch

styli (specified by user) (fullword integer)
The fill area style index. For interior styles hollow and solid this value is not used. For interior styles pattern and hatch the value indicates a particular pattern or hatch style at the workstation.

coli (specified by user) (fullword integer)
A color index from the color table of the workstation.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Inquire fill area representation (GQFAR), Inquire fill area facilities (GQFAF), Set fill area index (GSFAI), Set aspect source flags (GSASF)

Description

This function associates the fill area index fai at workstation wkid with the fill area characteristics given by the other parameters. The index and group of characteristics are stored in the fill area bundle table at the workstation. The changes in the fill area bundle table are made visible in the displayed primitives on the workstation.

When a fill area is displayed, the current fill area index refers to an entry in the fill area bundle table. If fill areas are displayed with a fill area index that is not present in the fill area bundle table, fill area index 1 is used. Which of the attributes in the bundle table entry are used depends on the setting of the following fill area attribute aspect source flags:

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

If the fill area interior style ASF is individual, the current fill area interior style is used. If the fill area interior style ASF is bundled, the fill area interior style from the bundle table entry indicated by the current fill area index is used.

If this function is used to define a representation for the current fill area index, the fill area interior style is set by this function. The fill area is then displayed as follows, depending on the fill area interior style determined:

Hollow

There is no filling but the boundary of the polygon is closed. If the fill area color index ASF is individual, the color indicated by the current fill area color index is used. If the fill area color index ASF is bundled, the color index set by this function is used. Line type is solid, and line width is the default size.

Solid

The interior of the polygon (excluding the boundary) is filled with a single color. If the fill area color index ASF is individual, the current fill area color index is used. If the fill area color index ASF is bundled, the color index set by this function is used.

Pattern

The polygon is filled with a pattern. If the fill area style index ASF is individual, the pattern indicated by the current fill area style index is used. If the fill area style index ASF is bundled, the pattern index (styli) set by this function is used. The index is a pointer into the pattern table of the workstation. You can set the referenced pattern table entry using Set pattern representation (GSPAR).

Hatch

Fills the polygon using a hatch style. If the fill area style index ASF is individual, the hatch style indicated by the current fill area style index is used. If the fill area style index ASF is bundled, the hatch style (styli) set by this function is used. If the fill area color index ASF is individual, the current fill area color index is used. If the fill area color index ASF is bundled, the color index set by this function is used.

Principal errors

7: GKS not in proper state: GKS shall be in one of the states WSOP, WSAC or SGOP
20: Specified workstation identifier is invalid
25: Specified workstation is not open
33: Specified workstation is of category MI
35: Specified workstation is of category INPUT
36: Specified workstation is Workstation Independent Segment Storage
80: Fill area index is invalid
83: Specified fill area interior style is not supported on this workstation
85: Specified pattern index is invalid
86: Specified hatch style is not supported on this workstation
93: Color index is invalid
2000: Enumeration type out of range

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