Name

PSPAP − Defines a pattern table index. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS PLUS function

Syntax

PSPAP (WKID, PAI, DIMX, DIMY, ISC, ISR, DX, DY, CTYPE, COLIA,
NCC, COLRA)

Argument        Data Type     Access     Description
---------------------------------------------------------------------------
WKID            Integer       Read       Workstation identifier
PAI             Integer       Read       Pattern index
DIMX, DIMY      Integer       Read       Dimensions of COLIA, which contains
                                         the array of pattern color indexes
ISC, ISR        Integer       Read       Starting column, starting row
DX, DY          Integer       Read       Number of columns, number of rows
                                         used
CTYPE           Integer       Read       Interior color type
COLIA(DIMX,     Integer       Read       Array of pattern color indexes
DIMY)
NCC             Integer       Read       Number of color value components
COLRA(NCC∗      Real          Read       Color value array
DIMX∗DIMY)
---------------------------------------------------------------------------

Description

PSPAP allows you to redefine an existing pattern table index or define a new pattern table index.  This is accomplished by specifying the number of cells high, the number of cells wide, and an array containing each cell’s color index fill area, associated with the specified bundle index. 

If the workstation supports the pattern interior style, the pattern table in the workstation state list predefines entries taken from the workstation description table. You can redefine any table entry using this function. 

When fill areas or fill area sets are displayed during structure traversal and the interior style is PATTERN, the current interior style index in the PHIGS traversal state list refers to an entry in the pattern table.  If the current interior style index is unavailable in the pattern table, PHIGS uses interior style index 1.  If interior style index 1 is unavailable (interior style pattern is unsupported), the result is workstation-dependent. 

If the pattern color index specified in the pattern color index array is unavailable on the workstation, PHIGS uses color index 1. 

Attribute values passed to this function must be valid for the specified workstation.  For information, see the appropriate device-specific chapter in the Device Specifics Reference Manual for DEC GKS and DEC PHIGS. 

Digital PHIGS Version 3.1 does not support this function.

See Also

PQEPAI
PQPAF
PQPAP
PQPPAP
PQWKSL
PSIASF
PSPAR