INQUIRE SYSTEM STATE VALUE(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE SYSTEM STATE VALUE − inquire state value of PHIGS

SYNOPSIS

C Syntax

void
pinqsystemst ( sys_state )
Psystemstate∗sys_state;OUT the system state

FORTRAN Syntax

SUBROUTINE pqsys ( SYSSTA )
INTEGERSYSSTAOUT system state value (PPHCL, PPHOP)

Required PHIGS Operating States

(∗, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE SYSTEM STATE VALUE to determine the current state of the PHIGS system. The state value may be either “PHIGS open” (PHOP) or “PHIGS closed” (PHCL).

PHIGS must be opened with the OPEN PHIGS subroutine before any operations can be performed with the PHIGS subroutines. This function may be used to verify that OPEN PHIGS was successful before performing additional PHIGS operations.

C Output Parameters

sys_state
A pointer to a Psystemstate enumerated variable in which the current state of the PHIGS system is returned. Values for Psystemstate are defined in phigs.h as follows:

PPHCL(PHIGS closed)
PPHOP(PHIGS open)

FORTRAN Output Parameters

SYSSTA
The current state of the PHIGS system, defined in phigs77.h as follows: