graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPTEX2 - Test Extent 2

GPTEX2 (point1, point2, index)

Purpose

Use GPTEX2 to insert a Test Extent 2 structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Test Extent 2 structure element depending on the current edit mode.

The Test Extent 2 structure element is a short hand form of the Test Extent 3 structure element. During traversal the two endpoints of this element are expanded to 3D by supplying zero z values and then are treated the same as Test Extent 3. (See the Test Extent 3 [ GPTEX3] subroutine [page GPTEX3 - Test Extent 3) for further details.)

GPTEX2 is identified as GSE 1007.

Note:

Not all GSEs are supported on all workstations. Use the Inquire List of Generalized Structure Elements (GPQGSE) inquiry subroutine to determine the GSEs supported by an open workstation. See also the workstation descriptors in The graPHIGS Programming Interface: Technical Reference

Parameters

point1 -- specified by user, 2 short floating-point numbers (MC)

x, y coordinates of one end point of the extent box's diagonal.

point2 -- specified by user, 2 short floating-point numbers (MC)

x, y coordinates of another end point of the extent box's diagonal.

index -- specified by user, fullword integer

Cull size index specifying an entry in the workstation's cull size table (>=1)

Error Codes

5: FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
278: CULL SIZE INDEX < ONE

Related Subroutines

GPCEXS: Conditional Execute Structure
GPCOND: Set Condition
GPCRET: Conditional Return
GPCSR: Set Cull Size Representation
GPQCSR: Inquire Cull Size Representation
GPTEX3: Test Extent 3

RCP code

201331719 (X'0C001407')