GPHIGS C FUNCTIONS - SET CELL ARRAY ALIGNMENT

SET CELL ARRAY ALIGNMENT

PXSET_CELL_ARRAY_ALIGN

CALL SEQUENCE

void pxset_cell_array_align(

Pint	hor_align,	/* horizontal alignment	*/
Pint	ver_align	/* vertical alignment	*/

PHIGS STATE

(PHOP,*,STOP,*)

EFFECT

A GSE element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on the edit mode value. Element pointer is updated and points to the GSE structure element. The values specified in the function are associated with the element.

The horizontal alignment is defined as follows:

PCELL_ARRAY_HOR_NORM Normal horizontal alignment

PCELL_ARRAY_HOR_LEFT Left horizontal alignment

PCELL_ARRAY_HOR_CTR Centre horizontal alignment

PCELL_ARRAY_HOR_RIGHT Right horizontal alignment

The vertical alignment is defined as follows:

PCELL_ARRAY_VER_NORM Normal vertical alignment

PCELL_ARRAY_VER_BOTTOM Left vertical alignment

PCELL_ARRAY_VER_CTR Centre vertical alignment

PCELL_ARRAY_VER_TOP Right vertical alignment

The default values are PCELL_ARRAY_HOR_NORM and PCELL_ARRAY_VER_NORM.

When an element of this type is interpreted, the current cell array alignment entry in the traversal state list is set to the values associated with the element. This value is used when displaying subsequent CELL ARRAY primitives.

When cell array alignment values are not equal to PCELL_ARRAY_HOR_NORM and PCELL_ARRAY_VER_NORM, CELL ARRAY primitives are displayed using one pixel per cell. Position of CELL ARRAY is defined by the P point depending on cell array alignment values :

Listing of pxset_cell_array_align function is as follow :

	void pxset_cell_array_align(

Pint hor_align,

Pint ver_align

)

{

Pgse_data gse_data;

gse_data.gse_r7.cell_array_align = ( hor_align << 2 ) | ver_align;

pgse (PGSE_ID_CELL_ARRAY_ALIGN, &gse_data);

}

ERRORS