gear::xsi::transform Namespace Reference

Functions
def	getTransformLookingAt
	Get a transform that is oriented looking at another position.
def	getChainTransform
def	getGlobalPositionFromObjects
	Get the global translation of each object in list or collection.
def	getTransformFromPosition
	Get a SITransformation with translation equal the given position.
def	getSymmetricalTransform
	Get the SITransformation.
def	getSymmetricalTransform2
def	matchGlobalTransform
	Math the global transformation of target object to source.
def	getFilteredTransform
	Retrieve a transformation filtered.
def	getNegatedTransform
def	setRefPose
	set the reference (neutral) pose of an object.
def	getRotationFromAxis

---

Detailed Description

    This file is part of GEAR.

    GEAR is free software: you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/lgpl.html>.

    Author:     Jeremie Passerin      geerem@hotmail.com
    Company:    Studio Nest (TM)
    Date:       2010 / 11 / 15

Author:

Jeremie Passerin

---

Function Documentation

def gear::xsi::transform::getTransformLookingAt	(		position,
			lookat,
			normal,
			axis = "xy",
			negate = False
	)

Get a transform that is oriented looking at another position.

Parameters:

	position	SIVector3 - The position of the object.
	lookAtPos	SIVector3 - The position that the object is looking at.
	upv	SIVector3 - Up vector direction.
	negate	Boolean - True to create negative side transform.
	axis	String - First the axis point at the look at position then the axe pointing to the up vector ("xy", "xz", "yx", "yz", "zx", "zy")

Returns:

SITransformation - The newly created transform.

def gear::xsi::transform::getGlobalPositionFromObjects

(

collection

)

Get the global translation of each object in list or collection.

Parameters:

collection

List of X3DObject or XSICollection.

Returns:

List of SIVector3 - The global translation.

def gear::xsi::transform::getTransformFromPosition

(

position

)

Get a SITransformation with translation equal the given position.

Parameters:

position

SIVector3 - The position

Returns:

SITransformatin - The newy created transform

def gear::xsi::transform::getSymmetricalTransform	(		t,
			axis = "yz"
	)

Get the SITransformation.

Parameters:

	t	SITransformation - The transform to symmetrize.
	axis	SIVector3 - Mirroring axis.

Returns:

SITransformatin - The newy created transform

def gear::xsi::transform::matchGlobalTransform	(		target,
			source,
			translation = True,
			rotation = True,
			scaling = True
	)

Math the global transformation of target object to source.

Parameters:

	target	X3DObject - Target object. The one we apply the new transform to.
	source	X3DObject - Source object.
	translation	Boolean - True to match translation.
	rotation	Boolean - True to match rotation.
	scaling	Boolean - True to match scaling.

def gear::xsi::transform::getFilteredTransform	(		t,
			translation = True,
			rotation = True,
			scaling = True
	)

Retrieve a transformation filtered.

Parameters:

	t	SITransformation - Reference transformation.
	translation	Boolean - True to match translation.
	rotation	Boolean - True to match rotation.
	scaling	Boolean - True to match scaling.

Returns:

SITransformation - The filtered transformation

def gear::xsi::transform::setRefPose	(		obj,
			orientation = [0,
			negate = False
	)

set the reference (neutral) pose of an object.

Neutral translation and scaling and neutral orientation with offset.

Parameters:

	obj	X3DObject - The object.
	orientation	List of Double - The object neutral pose orientation angles in degrees.
	negate	Boolean - True to use with negative side.