OUTRAN   

Equivalent PK functions: PK_TRANSF_ask

OUTRAN ( transf, matrix, ifail )
================================

  Output transformation.

Receives:
  KI_tag_transform         *transf         --- transformation to be output

Returns:
  double                    matrix[16]     --- transformation matrix array
  KI_cod_error             *ifail          --- failure code


Description:

  The current value of the transformation matrix is output in a linear
  array.

  The matrix operates as a post-multiplier on row vectors containing
  homogenous coordinates thus:

  (x',y',z',s') = (x,y,z,s) T

  where the conventional 3-d coordinates are

  (x/s,y/s,z/s).

  The matrix thus consists of

      (             , 0 )
      (      R      , 0 )
      (             , 0 )
      ( Tx, Ty, Tz,   S )

  R = a rotation/reflection matrix
  T = a translation vector
  S = a scaling factor

  The matrix is filled as follows:

           Positions in array         Contents
           ------------------        ----------
             0 through 2,           rotation/reflection elements r    r    r
                                                                  11   21   31

             4 through 6,                   "              "     r    r    r
                                                                  12   22   32

         and 8 through 10                   "              "     r    r    r
                                                                  13   23   33
             3,7, and 11            translation vector
            12 through 14           0.0
                 15                 scale