Definition

Retrieves a copy of the current effective transformation of the given object. This is the accumulation of all transformations -

• from the <Transmittal Root> down to the object, including any transformation components directly aggregated by that object. If object_in, or any of the objects between it and its <Transmittal Root>, are referenced as a component from another transmittal and that transmittal is open, then the accumulation is from the other transmittal's <Transmittal Root>. Otherwise the accumulation is from the <Transmittal Root> within object_in's own transmittal.



• or from the <Model> down to the object, including any transformation components directly aggregated by that object depending on whether the object was or wasn't part of a <Model>.

If no matrices were 'accumulated' by the object, then the identity matrix will be returned.

Returns

SE_RET_CODE_SUCCESS	and the requested transformation is returned, if valid parameters were passed in and all operations succeeded.
SE_RET_CODE_FAILURE	and the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RET_CODE_SUCCESS is returned:

SE_STAT_CODE_SUCCESS

set if valid parameters were passed in.

SE_Status_Code(s) when SE_RET_CODE_FAILURE is returned:

SE_STAT_CODE_UNRESOLVED_INPUT_OBJECT	set if object_in is unresolved.
SE_STAT_CODE_INACTIONABLE_FAILURE	set if the call fails for any other reason.

Parameters Notes

object_in

 the object whose effective transformation is desired.

matrix_out_ptr

 a pointer to a 4x4 matrix in the user's memory space
    where the given object's effective transformation will be copied.

Prev: SE_GetComponent. Next: SE_GetDRMClass. Up:Index.

Last updated: July 16, 2004 Copyright © 2004 SEDRIS™