NAME

CELL ARRAY 3 PLUS − create a 3D extended cell array element

SYNOPSIS

C Syntax

void
pcell_array3_plus ( paral, dim, colour_model, colrs )
Pparal∗paral;cell parallelogram: [0]=P; [1]=Q; [2]=R
Pint_size∗dim;dimension of cell: DX and DY
Pintcolour_model;colour model
Pcoval∗colrs;colour array

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

CELL ARRAY 3 PLUS creates a 3D cell array made of cells filled with general colour in each cell. Its area is defined by three points P, Q, and R in Modelling Coordinates giving the corners of a parallelogram as P, Q, R and (Q+R-P). 

C Input Parameters

paralA pointer to an array of three Ppoint3 structures giving three corners of the parallelogram that defines the area of the CELL ARRAY 3 PLUS element.  Pparal is defined in phigs.h as follows:

typedef struct {
Ppoint3p;/∗ point p ∗/
Ppoint3q;/∗ point q ∗/
Ppoint3r;/∗ point r ∗/
} Pparal;

colour_model
The colour model for specified cell colours.

0       PINDIRECTColour Index Specified
1       PMODEL_RGBRed, Green, Blue Colour Model
2       PMODEL_CIELUVCommission Internationale de l’Eclairage Colour Model
3       PMODEL_HSVHue, Saturation, Value Colour Model
4       PMODEL_HLSHue, Lightness, Saturation Colour Model

C Output Parameters

dimA pointer to a Pdim structure specifying the dimensions of the colour cells array.  Pint_size is defined in phigs.h as follows:

typedef struct {
Pintsize_x;/∗ dimension (number of divisions) along X ∗/
Pintsize_y;/∗ dimension (number of divisions) along Y ∗/
} Pint_size;

colrsA pointer to an array of Pcoval of dimension defined by dim, containing the colour values specifying cell colours.  Pcoval is defined in phigs.h as follows:

typedef union {
Pintindex;/∗ index in workstation colour bundle table ∗/
Pcolr_repdirect;/∗ direct colour components ∗/
} Pcoval;

Pcolr_rep is defined as:

typedef union {
Prgbrgb;/∗ Red Green Blue colour specification ∗/
Pcieluvcieluv;/∗ CIE L∗U∗V∗ colour specification ∗/
Phlshls;/∗ Hue Lightness Saturation colour specification ∗/
Phsvhsv;/∗ Hue Saturation Value colour specification ∗/
Pdataunsupp;/∗ Colour in unsupported colour model ∗/
} Pcolr_rep

Prgb is defined in phigs.h as follows:

typedef struct {
Pfloatred;/∗ red, hue, etc ∗/
Pfloatgreen;/∗ green, saturation, lightness, etc ∗/
Pfloatblue;/∗ blue, value, saturation, etc ∗/
} Prgb;

Pcieluv is defined in phigs.h as follows:

typedef struct {
Pfloatcieluv_x;/∗ x coefficient ∗/
Pfloatcieluv_y;/∗ y coefficient ∗/
Pfloatcieluv_y_lum; /∗ y luminance ∗/
} Pcieluv;

Phsv is defined in phigs.h as follows:

typedef struct {
Pfloathue;/∗ hue ∗/
Pfloatsatur;/∗ saturation ∗/
Pfloatvalue;/∗ value ∗/
} Phsv;

Phls is defined in phigs.h as follows:

typedef struct {
Pfloathue;/∗ hue ∗/
Pfloatlightness;/∗ lightness ∗/
Pfloatsatur;/∗ saturation ∗/
} Phls;

Pdata is defined in phigs.h as follows:

typedef struct {
size_tsize;/∗ size of data ∗/
char∗data/∗ pointer to data ∗/
} Pdata;

Execution

When the structure is traversed, the CELL ARRAY 3 PLUS element draws the transformed boundaries of the cell parallelogram, using the polyline attributes currently in effect. This is the minimal simulation for CELL ARRAY 3 PLUS. 

Attributes Applied

The attributes listed below are used to display the CELL ARRAY 3 PLUS primitive when the structure is traversed.  The Aspect Source Flags (ASFs) tell where to access the output display attributes.  These attributes can come directly from the traversal state list, or they can be accessed indirectly, using the appropriate index in the traversal state list and the corresponding bundled representation in the workstation state list. 

polyline colourpolyline colour index ASF
linewidth scale factorlinewidth scale factor ASF
linetype linetype ASF
polyline shading methodpolyline shading method ASF
polyline index
depth cue index
name set

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

117Iqnoring function, one of the dimensions of the colour index array is less than zero

SEE ALSO

CELL ARRAY 3 (3P)

September 02, 1992