Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31559 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

							SoDecomposeMatrix(3IV)

NAME
     SoDecomposeMatrix (SoDecmpsMx) - decomposes transformation matrices into
     values for translation, rotation, and scale

INHERITS FROM
     SoBase > SoFieldContainer > SoEngine > SoDecomposeMatrix

SYNOPSIS
     #include <Inventor_c/engines/SoCompose.h>

     typedef SoDecomposeMatrix	SoDecmpsMx

	  Inputs from class SoDecomposeMatrix:

     SoMFMatrix		 matrix
     SoMFVec3f		 center

	  Outputs from class SoDecomposeMatrix:

     (SoMFVec3f)	 translation
     (SoMFRotation)	 rotation
     (SoMFVec3f)	 scaleFactor
     (SoMFRotation)	 scaleOrientation

	  Functions from class SoDecomposeMatrix:

     SoDecomposeMatrix *  SoDecmpsMxCreate()

	  Functions from class SoEngine:

     SoType		 SoDecmpsMxGetTypeId()
     int		 SoDecmpsMxGetOuts(const SoDecmpsMx *this,
			      SoEngineOutputList *list)
     SoEngineOutput *	 SoDecmpsMxGetOut(const SoDecmpsMx *this, const char
			      *outputName)
     SbBool		 SoDecmpsMxGetOutName(const SoDecmpsMx *this, const
			      SoEngineOutput *output, SbName *outputName)
     SoEngine *		 SoDecmpsMxCopy(const SoDecmpsMx *this)
     SoEngine *		 SoDecmpsMxGetByName(const char *name)
     int		 SoDecmpsMxGetByNameList(const char *name,
			      SoEngineList *list)

	  Functions from class SoFieldContainer:

     SoType		 SoDecmpsMxGetClassTypeId()
     void		 SoDecmpsMxSetToDflts(SoDecmpsMx *this)
     SbBool		 SoDecmpsMxHasDfltVals(const SoDecmpsMx *this)
     SbBool		 SoDecmpsMxFldsAreEq(const SoDecmpsMx *this, const
			      SoFieldContainer *fc)
     void		 SoDecmpsMxCopyFieldVals(SoDecmpsMx *this, const
			      SoFieldContainer *fc, SbBool copyConnections =
			      FALSE)

Page 1

SoDecomposeMatrix(3IV)

     SbBool		 SoDecmpsMxSet(SoDecmpsMx *this, const char
			      *fieldDataString)
     void		 SoDecmpsMxGet(SoDecmpsMx *this, SbString
			      *fieldDataString)
     int		 SoDecmpsMxGetFields(const SoDecmpsMx *this,
			      SoFieldList *resultList)
     SoField *		 SoDecmpsMxGetField(const SoDecmpsMx *this, const char
			      *fieldName)
     SbBool		 SoDecmpsMxGetFieldName(const SoDecmpsMx *this, const
			      SoField *field, SbName *fieldName)
     SbBool		 SoDecmpsMxIsNotifyEnabled(const SoDecmpsMx *this)
     SbBool		 SoDecmpsMxEnableNotify(SoDecmpsMx *this, SbBool flag)

	  Functions from class SoBase:

     void		 SoDecmpsMxRef(SoDecmpsMx *this)
     void		 SoDecmpsMxUnref(const SoDecmpsMx *this)
     void		 SoDecmpsMxUnrefNoDelete(const SoDecmpsMx *this)
     void		 SoDecmpsMxTouch(SoDecmpsMx *this)
     SbBool		 SoDecmpsMxIsOfType(const SoDecmpsMx *this, SoType
			      type)
     void		 SoDecmpsMxSetName(SoDecmpsMx *this, const char *name)
     SbName		 SoDecmpsMxGetName(const SoDecmpsMx *this)

DESCRIPTION
     This engine takes as input a transformation matrix and a center of
     transformation. As output the engine produces the translation, rotation
     and scale values derived from the matrix.

     The input fields can have multiple values, allowing the engine to
     decompose several matrices in parallel. One of the inputs may have more
     values than the other. In that case, the last value of the shorter input
     will be repeated as necessary.

INPUTS
     SoMFMatrix		 matrix
	  The 4x4 transformation matrix.

     SoMFVec3f		 center
	  The center of transformations.

OUTPUTS
     (SoMFVec3f)	 translation
	  Derived translation in x, y, and z.

     (SoMFRotation)	 rotation
	  Derived rotation.

     (SoMFVec3f)	 scaleFactor
	  Derived scale values in x, y, and z.

Page 2

							SoDecomposeMatrix(3IV)

     (SoMFRotation)	 scaleOrientation
	  Derived rotational space for scaling.

FUNCTIONS
     SoDecomposeMatrix *  SoDecmpsMxCreate()
	  Constructor

FILE FORMAT/DEFAULTS
     DecomposeMatrix {
	  matrix  1 0 0 0
		  0 1 0 0
		  0 0 1 0
		  0 0 0 1
	  center  0 0 0
     }

SEE ALSO
     SoComposeMatrix, SoEngineOutput

Page 3

Vote for polarhome