Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SoGetMatrixAction(3IV)()			      SoGetMatrixAction(3IV)()

NAME
       SoGetMatrixAction -- computes transformation matrix for subgraph

INHERITS FROM
       SoAction	> SoGetMatrixAction

SYNOPSIS
       #include	<Inventor/actions/SoGetMatrixAction.h>

	  Methods from class SoGetMatrixAction:

			       SoGetMatrixAction(const	      SbViewportRegion
				    &newRegion)
     void		       setViewportRegion(const	      SbViewportRegion
				    &newRegion)
     const SbViewportRegion &  getViewportRegion() const
     SbMatrix &		       getMatrix()
     SbMatrix &		       getInverse()
     SbMatrix &		       getTextureMatrix()
     SbMatrix &		       getTextureInverse()

	  Methods from class SoAction:

     virtual void	 apply(SoNode *node)
     virtual void	 apply(SoPath *path)
     virtual void	 apply(const SoPathList	&pathList, SbBool obeysRules =
			      FALSE)
     static SoType	 getClassTypeId()
     virtual SoType	 getTypeId()
     virtual SbBool	 isOfType(SoType type)
     virtual void	 invalidateState()

DESCRIPTION
       This action computes transformation matrices for	a given	 subgraph.  It
       computes	 the  cumulative  transformation matrix	and its	inverse, along
       with a cumulative texture transformation	matrix and its inverse.

       This action is unlike most others in that it does  not  traverse	 down-
       wards  from  groups. When applied to a node, it computes	the matrix for
       just that node. (This makes sense for transformation nodes, but not for
       others,	really.)  It  is much more useful when applied to a path. When
       applied to a path, it gathers the transformation	info for all nodes  in
       the  path and those that	affect nodes in	the path, but it stops when it
       hits the	last node in the path; it does not traverse downwards from  it
       as  other  actions (such	as rendering) do. This behavior	makes the most
       sense for this action.

METHODS
			       SoGetMatrixAction(const	      SbViewportRegion
				    &newRegion)
	  Constructor  takes  viewport	region to use for picking. Even	though
	  the matrix computation may not involve a window per se,  some	 nodes
	  need this information	to determine their placement.

     void		       setViewportRegion(const	      SbViewportRegion
				    &newRegion)
     const SbViewportRegion &  getViewportRegion() const
	  Sets/returns current viewport	region to use for action.

     SbMatrix &		       getMatrix()
     SbMatrix &		       getInverse()
	  Returns cumulative transformation matrix and its  inverse.  Warning:
	  the  matrices	 returned by these routines should not be changed (un-
	  less you are implementing your own transformation nodes).

     SbMatrix &		       getTextureMatrix()
     SbMatrix &		       getTextureInverse()
	  Returns cumulative texture transformation matrix  and	 its  inverse.
	  Warning:  the	 matrices  returned  by	 these	routines should	not be
	  changed (unless you are implementing your own	transformation nodes).

SEE ALSO
       SoGetBoundingBoxAction

						      SoGetMatrixAction(3IV)()

NAME | INHERITS FROM | SYNOPSIS | DESCRIPTION | METHODS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=SoGetMatrixAction&sektion=3iv&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help