PEXtBuildTran(3PEXt)

NAME
PEXtBuildTran, PEXtBuildTran3 — create a transformation matrix a local transform structure element

SYNOPSIS
#include <PEXt/PEXt.h>
#include <PEXt/Structure.h>

void PEXtBuildTran (fixed_x, fixed_y, shift_x, shift_y, angle, scale_x, scale_y, comp)
	Pfloat	fixed_x, fixed_y,
		shift_x, shift_y,
		angle,
		scale_x, scale_y;
	Pcompose_type	comp;

void PEXtBuildTran3 (fixed_x, fixed_y, fixed_z, shift_x, shift_y, shift_z, x_angle, y_angle, z_angle, scale_x, scale_y, scale_z, comp)
	Pfloat	fixed_x, fixed_y, fixed_z,
		shift_x, shift_y, shift_z,
		x_angle, y_angle, z_angle,
		scale_x, scale_y, scale_z;
	Pcompose_type	comp;

  Required PHIGS Operating States
(PHOP, *, STOP, *)

DESCRIPTION
These convenience procedures create a transformation matrix based on the given fixed point, shift vector, rotation angles and scale vector using the PHIGS functions pbuild_tran_matrix and pbuild_tran_matrix3. The resulting matrix appears as a SET LOCAL TRANSFORMATION (or SET LOCAL TRANSFORMATION 3) structure element with the given composition in the currently open structure. If the edit mode is set to PINSERT, the transformation element is inserted into the currently open structure. If the edit mode is set to PREPLACE, the transformation element replaces the element currently pointed to by the element pointer.

RETURN VALUE
None

SEE ALSO
PEXtRotate(3)
PEXtTranslate(3)
PEXtNonUniformScale(3)
pbuild_tran_matrix(3)
pbuild_tran_matrix3(3)

AUTHOR
Rich Thomson <rthomson@dsd.es.com>
Design Systems Division
Evans & Sutherland Computer Corporation