ImageGear for C and C++ on Windows v19.1 - Updated
IG_vect_ent_get_matrix
API Reference Guide > Vector Component API Reference > Vector Component Functions Reference > Entity Functions > IG_vect_ent_get_matrix

This function retrieves the entity's 4x4 transformation matrix.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_vect_ent_get_matrix(
   HIG_VECT_ENTITY hEntity,
   VECT_REAL* lpMat
);

Arguments:

Name Type Description
hEntity HIG_VECT_ENTITY Handle of the entity whose matrix is retrieved.
lpMat VECT_REAL* Pointer to a memory buffer to which to copy the matrix. See Remarks.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

None

Remarks:

lpMat must point to an array of 16 VECT_REAL values, for example:

VECT_REAL lpMat[16].

The matrix uses column-major order, as accepted in OpenGL and Direct3D.