| Customize Help
| Save Settings

M3dgeoMatrixGet



Function Map
Synopsis
Get data from a transformation matrix object and place it in a user-supplied array.
Syntax
void M3dgeoMatrixGet(
MIL_ID Matrix3dgeoId, //in
MIL_INT64 GetType, //in
MIL_DOUBLE *UserArrayPtr //out
)
Description

This function copies the values from a transformation matrix object and places them in an array.

Note that when using a C compiler (not a C++ or other compiler), it is suggested to use the type-specific versions of this particular function, rather than the standard function prototype at the top of this page. An exhaustive list of type-specific versions of this function can be found at the bottom of this page.
Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
Matrix3dgeoId

Specifies the identifier of the source transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX.

GetType

Reserved for future expansion and must be set to M_DEFAULT.

UserArrayPtr
Accepts the address of one of the following:
  • array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
    Required array size:(16)

Specifies the address of the user array in which to copy the data from the transformation matrix. Ensure that the user array is large enough to receive the data to be copied from the source object. Transformation matrices are 4x4 matrices, so the array must be of size 16.

Type-specific versions of the function when using a C compiler
void M3dgeoMatrixGetDouble (MIL_ID Matrix3dgeoId, MIL_INT64 GetType, MIL_DOUBLE *UserArrayPtr)
Parameters

Matrix3dgeoId

See Matrix3dgeoId of the main function for a description.

GetType

See GetType of the main function for a description.

UserArrayPtr

See UserArrayPtr of the main function for a description.

void M3dgeoMatrixGetFloat (MIL_ID Matrix3dgeoId, MIL_INT64 GetType, MIL_FLOAT *UserArrayPtr)
Parameters

Matrix3dgeoId

See Matrix3dgeoId of the main function for a description.

GetType

See GetType of the main function for a description.

UserArrayPtr

See UserArrayPtr of the main function for a description.

Compilation information
Header Include mil.h.
Library Use mil.lib; mil3d.lib.
DLL Requires mil.dll; mil3d.dll.