Matrix::TransformPoints(Point*,INT) method (gdiplusmatrix.h)

The Matrix::TransformPoints method multiplies each point in an array by this matrix. Each point is treated as a row matrix. The multiplication is performed with the row matrix on the left and this matrix on the right.


Status TransformPoints(
  [in, out] Point *pts,
  [in]      INT   count


[in, out] pts

Type: Point*

Pointer to an array of Point objects that, on input, contains the points to be transformed and, on output, receives the transformed points. Each point in the array is transformed (multiplied by this matrix) and updated with the result of the transformation.

[in] count

Type: INT

Optional. Integer that specifies the number of points to be transformed. The default value is 1.

Return value

Type: Status

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.


Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusmatrix.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See also

Global and Local Transformations


Matrix Representation of Transformations


TransformPoints Methods

TransformVectors Methods