NAME
          DtCameraGetMatrix - Get the current matrix for the given
          camera.


     SYNOPSIS
          #include <Dt.h>


          int  DtCameraGetMatrix( int cameraID, float **matrix )


     DESCRIPTION
          DtCameraGetMatrix() returns the current matrix for the
          camera indicated by the cameraID parameter.  A read-only
          pointer to the 4x4 matrix is placed in the variable pointed
          to by matrix. This matrix is an internal buffer.  Do not
          free or modify the matrix.  The matrix for the camera is
          that of the current frame.  Setting a new frame will update
          the shapes group matrix.



     DIAGNOSTICS
          returns one on success and zero on failure.






     SEE ALSO
          DtFrameSet(3W)






     FILES
          Link with -lDtOMio