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

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

Purpose

Use Set Pattern Representation to set a given pattern definition in the specified entry of the workstation's pattern table.

The pattern is a grid of color indexes. The color indexes point into the color table of the specified workstation.

If the workstation supports interior style PATTERN, then the pattern table in the workstation state list has predefined entries taken from the workstation description table. For every workstation of category OUTPUT or OUTIN supporting interior style PATTERN, the graPHIGS API predefines a number of pattern table entries. With this function, you can redefine the table entries.

During structure traversal, if a pattern color index specified in the pattern color index array is not available on the workstation, then the graPHIGS API uses a color index value of 1.

Some workstations require that the pattern fill is a fixed size. For these workstations, the graPHIGS API replicates the specified pattern to the fixed size. (See The graPHIGS Programming Interface: Technical Reference for interior pattern information).

Language Bindings

C

pset_pat_rep (ws_id, pat_ind, pat_bundle)

Input Parameters

Pint ws_id
Workstation identifier.

Pint pat_ind
Pattern index (>=1).

const Ppat_rep *pat_bundle
Pattern representation (The pattern color index array must be in row order).

FORTRAN

PSPAR (wkid, pai, dimx, dimy, isc, isr, dx, dy, colia)

Input Parameters

integer wkid
Workstation identifier.

integer pai
Pattern index (>=1).

integer dimx
X dimension of colia which contains the pattern color index array (>=1).

integer dimy
Y dimension of colia which contains the pattern color index array (>=1).

integer isc
Index to start column (>=1).

integer isr
Index to start row (>=1).

integer dx
Number of columns used (>=1).

integer dy
Number of rows used (>=1).

integer colia(dimx, dimy)
Pattern color index array (A grid of dimx by dimy color indexes. The array must be in row order. The pattern within this array begins at position (isc, isr), and is of dimension dx by dy).

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
103
Exceeded Maximum Number Of Workstation Bundle Table Entries
116
One Dimension Of Pattern Color Index Array < ONE
113
Color Index Value < ZERO

Related Subroutines

  • Inquire Pattern Representation

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