CREROT   

Equivalent PK functions: PK_TRANSF_create_rotation

CREROT ( posn, axis, angle, transf, ifail )
===========================================

  Create a rotation transformation.

Receives:
  KI_vec_position           posn           --- position on axis
  KI_vec_axis               axis           --- axis direction
  KI_dbl_angle             *angle          --- rotation angle (radians)

Returns:
  KI_tag_transform         *transf         --- rotation transformation
  KI_cod_error             *ifail          --- failure code

Specific errors:
  KI_rot_angle_eq_0         zero angle rotation asked for

Description:
  Calculates a transformation matrix that, when applied to an entity,
  rotates it about the axis which passes through the given position. The
  angle of rotation (in radians) must not be within the resolution angle
  of zero. A 'right-hand screw rule' is assumed when calculating
  rotational direction with respect to axis direction.