Name

pbuild_tran_matrix3 − Creates a 3D homogeneous transformation matrix and performs the specified transformation. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Syntax

void pbuild_tran_matrix3 (
  const Ppoint3  ∗pt,          /∗ (I) Fixed point ∗/
  const Pvec3    ∗shift,       /∗ (I) Shift vector ∗/
  Pfloat          x_angle,     /∗ (I) x rotation angle, in radians ∗/
  Pfloat          y_angle,     /∗ (I) y rotation angle, in radians ∗/
  Pfloat          z_angle,     /∗ (I) z rotation angle, in radians ∗/
  const Pvec3    ∗scale,       /∗ (I) Scale factor vector ∗/
  Pint           ∗error_ind,   /∗ (O) Error indicator ∗/
  Pmatrix3        matrix       /∗ (O) Transformation matrix ∗/
)

Data Structures

typedef struct {
    Pfloat     x;    /∗ x coordinate ∗/
    Pfloat     y;    /∗ y coordinate ∗/
    Pfloat     z;    /∗ z coordinate ∗/
} Ppoint3;
typedef struct {
    Pfloat     delta_x;    /∗ delta x value ∗/
    Pfloat     delta_y;    /∗ delta y value ∗/
    Pfloat     delta_z;    /∗ delta z value ∗/
} Pvec3;
typedef Pfloat Pmatrix3[4][4];

Description

pbuild_tran_matrix3 creates a three-dimensional (4 x 4) homogeneous transformation matrix, which performs the specified transformation.  The order of the transformation is as follows:

1Scale (relative to the specified fixed point)

2Rotate (relative to the specified fixed point)

3Shift (move)

See Also

pcompose_tran_matrix3
pset_global_tran3
pset_local_tran3