| Customize Help
| Save Settings

M3dgeoMatrixPut



Function Map
Synopsis
Put data from a user-supplied array into a transformation matrix object.
Syntax
void M3dgeoMatrixPut(
MIL_ID Matrix3dgeoId, //in
MIL_INT64 PutType, //in
const MIL_DOUBLE *UserArrayPtr //in
)
Description

This function copies an array of values into a specified transformation matrix object.

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 transformation matrix object. The transformation matrix object must have been previously allocated using M3dgeoAlloc() with M_TRANSFORMATION_MATRIX.

PutType

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 constant std::vector<MIL_DOUBLE> ] (and a maximum array rank for C# of 1)
    Required array size:(16)

Specifies the address of the user array from which to copy the data into the transformation matrix object. Ensure that user array is large enough to contain the data to be copied to the destination 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 M3dgeoMatrixPutDouble (MIL_ID Matrix3dgeoId, MIL_INT64 PutType, const MIL_DOUBLE *UserArrayPtr)
Parameters

Matrix3dgeoId

See Matrix3dgeoId of the main function for a description.

PutType

See PutType of the main function for a description.

UserArrayPtr

See UserArrayPtr of the main function for a description.

void M3dgeoMatrixPutFloat (MIL_ID Matrix3dgeoId, MIL_INT64 PutType, const MIL_FLOAT *UserArrayPtr)
Parameters

Matrix3dgeoId

See Matrix3dgeoId of the main function for a description.

PutType

See PutType 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.