NAME
	  DtGroupGetMatrix - Get the current matrix for	the given
	  group	in a particular	shape.


     SYNOPSIS
	  #include <Dt.h>


	  int  DtGroupGetMatrix( int shapeID, int groupID, float **matrix )


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

	  This function	should be used when the	database is
	  hierarchical.


     DIAGNOSTICS
	  Returns zero on failure. Returns non-zero for	success. If
	  the return value is 2, the matrix returned is	an identity
	  matrix and will be an	identity matrix	throughout the entire
	  animation.  The return value of 2 informs the	translator
	  that it may safely discard the group transformation
	  entirely. If the return value	is 1, the group	transformation
	  should be used.


     OPENMODEL IMPLEMENTATION
	  Since	groups in the OpenModel	implementation of Dt are parts
	  of complete polysets (which themselves are converted to
	  shapes), there are no	transformation matrices	on groups.
	  DtGroupGetMatrix() will always return	2 in the OpenModel
	  implementation.


     FILES
	  Link with -lDtOMio