Introduction

This manual describes the syntax and operations of the subroutines available in the graPHIGS API ISO PHIGS interface.

Calling Conventions for ISO PHIGS Subroutines

The graPHIGS API supports C, FORTRAN 77, and FORTRAN 77 Subset bindings for ISO PHIGS defined subroutines. Each invocation consists of the subroutine name with the appropriate parameters required by the subroutine. Mnemonic conventions make the purpose of the subroutine calls evident in the names. In your application, you must use all the parameters specified in each subroutine and the parameters must be in the order shown in the subroutine description.

graPHIGS API Subroutines

For each ISO PHIGS subroutine, you will find the purpose of the subroutine with a description, the processing performed, a list and description of the parameters, a list of associated ISO-defined error codes and messages, and a list of related subroutines. Refer to the appendixes for enumerations and type definitions for the supported bindings. Binding errors and implementation errors are not listed with each subroutine. See Chapter 21. "Implementation Errors and graPHIGS API Messages for ISO PHIGS-Defined Errors" for a discussion of implementation errors and a list of binding errors. See Chapter 23. "graPHIGS API Deviations from the ISO PHIGS Standard" for a discussion of the handling of asynchronous errors. The ISO PHIGS subroutines have been grouped as follows:

• 1. Control
• 2. Output Primitives
• 3. Attribute Structure Elements
• 4. Miscellaneous Structure Elements
• 5. Structure Operations
• 6. Workstation Table Settings
• 7. Display
• 8. Transformation
• 9. Input
• 10. Utilities
• 11. Error Handling
• 12. Miscellaneous
• 13. Inquiries

• A. Transformations for the C and FORTRAN bindings
• B. Format and content of Structure Element Records for the FORTRAN binding
• C. C binding enumerations and type definitions
• D. FORTRAN binding enumerations
• E. ISO PHIGS subroutines mapped to GPxxxx subroutines
• F. GPxxxx subroutines mapped to ISO PHIGS subroutines
• G. ISO PHIGS subroutine errors
• H. graPHIGS API extensions and the combining of GPxxxx subroutine with ISO PHIGS subroutines
• I. graPHIGS API deviations from the ISO PHIGS standard

Subroutine Descriptions

The page preceding each group of subroutines presents a brief overview of the purpose and result caused by invoking the subroutines referenced within the given section. This introductory material highlights important information that applies to all the subroutines in that section.

Reference Manual Abbreviations

The following abbreviations are used frequently:

ARCL

Archive Closed

AROP

Archive Open

ASAP

As Soon As Possible

ASF

Attribute Source Flag

ASTI

At Some Time

BNIG

Before Next Interaction Globally

BNIL

Before Next Interaction Locally

CIELUV

CIELUV color model system

CMY

Cyan-Magenta-Yellow color model

CSID

Character Set Identifier

CSS

Centralized Structure Store

EDF

External Defaults File

GDP

Generalized Drawing Primitive

GSE

Generalized Structure Element

HLHSR

Hidden Line Hidden Surface Removal

HSV

Hue-Saturation-Value color model

NROP

Non-Retained Structure Open

PDT

graPHIGS API Description Table

PET

Prompt and Echo Type

PHCL

graPHIGS Closed

PHOP

graPHIGS Open

PSL

graPHIGS API State List

RGB

Red-Green-Blue color model

STCL

Structure Closed

STOP

Structure Open

USL

Utility State List

WAIT

When Application Requests It

WDT

Workstation Description Table

WSCL

Workstation Closed

WSID

Workstation Identifier

WSL

Workstation State List

WSOP

Workstation Open

WSTYPE

Workstation Type

The following abbreviations for coordinate spaces are used:

MC

Modeling Coordinates

WC

World Coordinates

VC

Viewing Coordinates

NPC

Normalized Projection Coordinates

DC

Device Coordinates

Note: For more information, see The graPHIGS Programming Interface: Understanding Concepts.