GSSORG

GDDM V3R2 Base Application Programming Reference

GSSORG

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To set segment origin.


   GSSORG      (segment-id, x, y)

   APL code               587
   GDDM RCP code          X'0C0C0311' (202113809)

Parameters

segment-id (specified by user) (fullword integer)
The identifier of the segment.

x (specified by user) (short floating point)
The x coordinate of the segment origin, specified in current world coordinates.

y (specified by user) (short floating point)
The y coordinate of the segment origin, specified in current world coordinates.

Description

Defines the segment origin of the identified segment. The identified segment need not be transformable. Setting a segment origin provides a reference point about which subsequent segment transformations will be performed. Note that GDDM does not provide a visible indication of the position of the segment origin.

When a segment is created, all primitives are drawn relative to the window origin identified by (0,0) in world coordinates. By default, the segment origin coincides with the window origin at the time the segment is created.

The GSSPOS call uses the segment origin as the reference point when it repositions the segment.

The GSSCPY call uses the segment origin to determine the placement of the copied segment.

The GSSAGA call uses the segment origin as the center point for rotate, shear, and scale. The results returned in the GSQAGA call also assume this point as the center of rotate, shear, and scale.

The GSQORG call returns the position of the segment origin in current world coordinates.

When a segment is used as an echo for a locator-logical-input device, the segment's origin establishes its position.

Principal errors

ADM0140 E: SEGMENT IDENTIFIER n IS INVALID
ADM0145 E: SEGMENT n IS UNKNOWN

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