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

INQUIRE PREDEFINED PATTERN REPRESENTATION (PHOP,*,*,*)

Purpose

Use Inquire Predefined Pattern Representation to inquire a predefined pattern table entry.

For a given workstation type, the graPHIGS API returns the values corresponding to the specified index of the predefined pattern table. The graPHIGS API returns the pattern color index array.

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
112
Pattern Index Value < ONE
102
Representation Has Not Been Predefined On This Workstation

Language Bindings

C

pinq_pred_pat_rep (ws_type, index, store, err_ind, pat_rep)

Input Parameters

Pint ws_type
Workstation type.

Pint index
Predefined pattern index (>=1).

Pstore store
Handle to the store object. The graPHIGS API uses an object of type Store to facilitate the use of subroutines which return complex data. See Create Store ( CREATE STORE (PHOP,*,*,*)) subroutine for details on how the graPHIGS API uses this parameter on inquiries.

Output Parameters

Pint *err_ind
Error indicator.

Ppat_rep **pat_rep
Predefined pattern representation. The memory referenced by *pat_rep is managed by the parameter store.

FORTRAN

PQPPAR (wtype, ppai, dimx, dimy, errind, dx, dy, colia)

Input Parameters

integer wtype
Workstation type.

integer ppai
Predefined pattern index (>=1).

integer dimx
Maximum x-axis dimension of colia (>=0).

integer dimy
Maximum y-axis dimension of colia (>=0).

Output Parameters

integer errind
Error indicator.

integer dx
x-axis dimension of the pattern color index array.

integer dy
y-axis dimension of the pattern color index array.

integer colia (dimx,dimy)
Pattern color index array.

Errors

None

Related Subroutines

  • Inquire Workstation Connection And Type

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