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

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

Purpose

Use Inquire Pattern Representation to inquire the current pattern representation in the specified entry in the pattern table of the specified workstation. Returned values of type SET or REALIZED may be specified.

If the specified pattern index is not present in the pattern table on the workstation and the specified type of returned values is REALIZED, then the graPHIGS API returns the representation for pattern index 1. Pattern index 1 is present if your workstation supports interior style PATTERN.

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:

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
59
Specified Workstation Does Not Have Output Capability
112
Pattern Index Value < ONE
101
Specified Representation Has Not Been Defined
109
Interior Style Pattern Not Supported On Workstation

Language Bindings

C

pinq_pat_rep (ws_id, index, type, store, err_ind, pat_rep)

Input Parameters

Pint ws_id
Workstation identifier.

Pint index
Pattern index (>=1).

Pinq_type type
Type of returned values (0=PINQ_SET, 1=PINQ_REALIZED).

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
Pattern representation. The memory referenced by *pat_rep is managed by the parameter store.

FORTRAN

PQPAR (wkid, pai, type, dimx, dimy, errind, dx, dy, colia)

Input Parameters

integer wkid
Workstation identifier.

integer pai
Pattern index (>=1).

integer type
Type of returned values (0=PSET, 1=PREALI).

integer dimx
Maximum column dimension in pattern array (>=0).

integer dimy
Maximum row dimension in pattern array (>=0).

Output Parameters

integer errind
Error indicator.

integer dx
Number of columns in pattern color index array.

integer dy
Number of rows in pattern color index array.

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

Errors

None

Related Subroutines

  • Set Pattern Representation

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