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

INQUIRE DYNAMICS OF STRUCTURES (PHOP,*,*,*)

Purpose

Use Inquire Dynamics of Structures to inquire the dynamic modification supported by the specified workstation for the following categories of picture changes:

Possible dynamic modifications include: IMPLICIT REGENERATION (IRG), meaning that implicit regeneration is necessary; IMMEDIATELY (IMM), meaning that the action is performed immediately; and CAN BE SIMULATED (CBS), meaning that the change can be simulated. If a category has a dynamic modification of IRG or CBS, it is still possible that your application can immediately execute some changes correctly if the state of the picture allows it. (For example, if no structures are posted, most changes can be executed immediately.)

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the information is unavailable, then the values returned in the output parameters are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

2
Function Requires State (PHOP,*,*,*)
52
Workstation Type Not Recognized By Implementation
51
Information Not Available For Generic Workstation Type
59
Specified Workstation Does Not Have Output Capability
62
This Information Not Available For MO Workstation Type

Language Bindings

C

pinq_dyns_structs (ws_type, err_ind, dyns)

Input Parameters

Pint ws_type
Workstation type.

Output Parameters

Pint *err_ind
Error indicator.

Pdyns_structs *dyns
Structure dynamics.

FORTRAN

PQDSTR (wtype, errind, strcon, post, unpost, delete, refmod)

Input Parameters

integer wtype
Workstation type.

Output Parameters

integer errind
Error indicator.

integer strcon
Structure content modification (0=PIRG, 1=PIMM, 2=PCBS).

integer post
Post structure (0=PIRG, 1=PIMM, 2=PCBS).

integer unpost
Unpost structure (0=PIRG, 1=PIMM, 2=PCBS).

integer delete
Delete structure (0=PIRG, 1=PIMM, 2=PCBS).

integer refmod
Reference modification (0=PIRG, 1=PIMM, 2=PCBS).

Errors

None

Related Subroutines

  • Inquire Dynamics Of Workstation Attributes


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