Name

pcell_array3 − Divides a designated parallelogram into cells, and displays each cell in a specified color. 

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

Syntax

void pcell_array3 (
  const Pparal    ∗paral,      /∗ (I) Cell parallelogram ∗/
  const Ppat_rep  ∗colr_array  /∗ (I) Color array ∗/
)

Data Structures

typedef struct {
    Ppoint3    p;    /∗ point p ∗/
    Ppoint3    q;    /∗ point q ∗/
    Ppoint3    r;    /∗ point r ∗/
} Pparal;
    typedef struct {
        Pfloat   x;    /∗ x coordinate ∗/
        Pfloat   y;    /∗ y coordinate ∗/
        Pfloat   z;    /∗ z coordinate ∗/
    } Ppoint3;
typedef struct {
    Pint_size    dims;         /∗ pattern’s dimensions ∗/
    Pint        ∗colr_array;   /∗ color index array ∗/
} Ppat_rep;
    typedef struct {
        Pint     size_x;   /∗ x size ∗/
        Pint     size_y;   /∗ y size ∗/
    } Pint_size;

Description

pcell_array3 divides a designated parallelogram 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 3 element. 

You pass a three-dimensional array containing color index values as one argument to this function. Digital PHIGS maps the color index values to corresponding cells within a parallelogram-shaped 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 parallelogram. Each of the columns within the parallelogram is of equal width, and each of the rows within the parallelogram 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. The grid defined by the three parallelogram vertices and the number of columns and rows is subject to all transformations. 

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 pset_colr_rep. 

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

Digital PHIGS Version 4.1 does not support this function.

See Also

padd_names_set
pcell_array
pcell_array3_plus
pset_back_refl_model
pset_back_refl_props
pset_facet_cull_mode
pset_facet_disting_mode
pset_light_source_st
pset_refl_model
pset_refl_props