[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPSAC - Set Surface Approximation Criteria

GPSAC (criteria, ctrlval1, ctrlval2)

Purpose

Use GPSAC to insert a Set Surface Approximation Criteria structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Set Surface Approximation Criteria structure element depending on the current edit mode.

This structure element determines how the graPHIGS API tessellates subsequent surfaces during structure traversal. Tessellation divides the surfaces into a set of line and/or area geometries for subsequent processing.

Depending on the criteria selected, the graPHIGS API uses only the control values or uses the control values in conjunction with the tessellation vectors in the surface definition to determine how surfaces are tessellated.

The traversal default for surface approximation criteria is 1=WORKSTATION_DEPENDENT with the u control value (ctrlval1) and v control value (ctrlval2) parameter values both set to 1.0.

If the workstation does not support the specified criteria, then the criteria defaults to 1=WORKSTATION_DEPENDENT , with ctrlval1 and ctrlval2 values both set to 1.0.

For information on surface tessellation and on how surface approximation criteria is applied, see The graPHIGS Programming Interface: Understanding Concepts

Parameters

criteria -- specified by user, fullword integer

Surface approximation criteria (1=WORKSTATION_DEPENDENT, 3=CONSTANT_SUBDIVISION_BETWEEN_KNOTS, 8=VARIABLE_SUBDIVISION_BETWEEN_KNOTS )

ctrlval1 -- specified by user, short floating-point number

U-control value (>=0)

ctrlval2 -- specified by user, short floating-point number

V-control value (>=0)

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
66
CONTROL VALUE < ZERO
86
SURFACE APPROXIMATION CRITERIA IS INVALID

Related Subroutines

GPQSDF
Inquire Surface Display Facilities

RCP code

201343236 (X'0C004104')


[ Previous | Next | Contents | Glossary | Home | Search ]