GSCLIP

GDDM-GKS V1R1 Programming Guide and Reference

GSCLIP

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

Purpose


GSCLIP	(clsw)

APL code	1354
GKS RCP code	X'38003500' (939537664)

Function: To set clipping indicator.

Transformation function. Sets the clipping indicator for clipping to the normalization transformation viewport.

Parameters

clsw (specified by user) (fullword integer)
The clipping indicator. The possible values are:

0 (GNCLIP)

No clipping

1 (GCLIP)

Clipping

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Select normalization transformation (GSELNT), Set viewport (GSVP), Set window (GSWN)

Description

The "clipping indicator" entry in the GKS state list is set to the value given by clsw. The clipping indicator determines whether or not subsequent output primitives are clipped to the viewport of the current normalization transformation.

If clipping is on, output primitives are clipped to the intersection of the normalization transformation viewport and the workstation transformation window when they are displayed. If the primitives are in a segment, the segment transformation is applied before clipping.

If clipping is off, output primitives are not clipped at the viewport boundaries. Output primitives that exceed the limits of the workstation window are always clipped.

Output primitives sent to a metafile output (MO) workstation are not clipped. If clipping is on, the clipping rectangle defined by the viewport boundary is stored as a metafile item. If clipping is off, the clipping rectangle (0,1,0,1) NDC is stored.

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP
2000: Enumeration type out of range

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