Name

PCA − Divides a designated rectangular area into cells, and displays each cell in a specified color. 

Operating States: PHOP, ∗, STOP, ∗
PHIGS standard function
Creates a structure element

Syntax

PCA (PX, PY, QX, QY, DIMX, DIMY, ISC, ISR, DX, DY, COLIA)

Argument        Data Type     Access   Description
---------------------------------------------------------------------------
PX, PY, QX, QY  Real          Read     Two points (P, Q), in modeling
                                       coordinates
DIMX, DIMY      Integer       Read     Dimensions of COLIA, which
                                       contains the cell array
ISC, ISR        Integer       Read     Indexes of the starting column and
                                       starting row
DX, DY          Integer       Read     Number of columns, number of rows
COLIA(DIMX,     Integer       Read     Color index array
DIMY)
---------------------------------------------------------------------------

Description

PCA divides a designated rectangular area into cells, and displays each cell in a specified color. 

  Depending on the current edit mode, this function either inserts the new structure element directly after the element indicated by the pointer or replaces the element indicated by the pointer.  The pointer then points to the new cell array element. 

You pass a two-dimensional array containing color index values as one argument to this function.  Digital PHIGS maps the color index values to corresponding cells within a rectangular area of the workstation surface. 

There is a one-to-one correspondence between the number of specified array columns and rows, and the number of columns and rows by which Digital PHIGS divides the cell array rectangle. Each of the columns within the rectangle is of equal width, and each of the rows within the rectangle is of equal height.  Digital PHIGS maps the color index values from each specified color index array element to the corresponding cell, moving from the starting point towards the diagonal point along the x-axis. 

For more information on the initial color index values for a given workstation, see the Device Specifics Reference Manual for DEC GKS and DEC PHIGS. 

To alter the color associated with a certain index value, you can use the function PSCR.  Refer to the figure in the hardcopy and Bookreader documentation. 

If Digital PHIGS is in immediate mode, it performs this function immediately, but the function does not create a structure element. 

Digital PHIGS Version 3.1 does not support this function.

See Also

PADS
PCA3
PCA3P
PSBRFM
PSBRFP
PSFCM
PSFDM
PSLSS
PSRFM
PSRFP