NAME
          DtShapeGetMatrix - Get the current matrix for the given
          shape in the database.


     SYNOPSIS
          #include <Dt.h>


          int  DtShapeGetMatrix( int shapeID, float **matrix )


     DESCRIPTION
          DtShapeGetMatrix() returns the current shape matrix for the
          shape indicated by the shapeID parameter.  A read-only
          pointer to the 4x4 matrix is placed in the variable pointed
          to by matrix. The matrix for the shape is that of the
          current frame.  Setting a new frame will update the shape
          matrix (see DtFrameSet(3W)).


     DIAGNOSTICS
          DtShapeGetMatrix() returns one on success and zero on
          failure.


     FILES
          Link with -lDtOMio