ImageGear for C and C++ on Windows v19.4 - Updated
IG_PDE_element_get_matrix
API Reference Guide > PDF Component API Reference > PDF Component Objects Reference > Page Editing Objects and Elements > HIG_PDE_ELEMENT > IG_PDE_element_get_matrix

Gets the transformation matrix for an element.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_PDE_element_get_matrix(
        HIG_PDE_ELEMENT hElement,
        LPAT_PDF_FIXEDMATRIX lpMatrix
);

Arguments:

Name Type Description
hElement HIG_PDE_ELEMENT An element whose transformation matrix is obtained.
lpMatrix LPAT_PDF_FIXEDMATRIX Pointer to AT_PDF_FIXEDMATRIX that holds a transformation matrix for hElement. If hElement is a text object, returns the identity matrix.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

This matrix provides the transformation from user space to device space for the element. If there is no cm operator (concatmatrix) in the page stream, the matrix is the identity matrix.