This is a utility function which returns the bounding box of the rectangle after being transformed using a 2x2 or 3x3 transformation matrix.
Parameter | Description |
---|---|
x |
This is both an input and output parameter. As input, it represents the X coordinate of the rectangle to which the transformation matrix will be applied. As output, it represents the X coordinate of the box which encloses the transformed rectangle. |
y |
This is both an input and output parameter. As input, it represents the Y coordinate of the rectangle to which the transformation matrix will be applied. As output, it represents the Y coordinate of the box which encloses the transformed rectangle. |
w |
This is both an input and output parameter. As input, it represents the width of the rectangle to which the transformation matrix will be applied. As output, it represents the width of the box which encloses the transformed rectangle. |
h |
This is both an input and output parameter. As input, it represents the height of the rectangle to which the transformation matrix will be applied. As output, it represents the height of the box which encloses the transformed rectangle. |
transform |
For pdTransformBoxPlus, this is a 3x3 transformation matrix. This matrix represents the 2D perspective (or projective) transform to apply to the rectangle specified by the x, y, w and h parameters. For more information, see the description of the DT_TM3X3 basic data type in this manual. For pdTransformBox, this is a 2x2 transformation matrix. This matrix represents the top two rows and columns of the 2D perspective transform to apply to the rectangle specified by the x, y, w and h parameters. For more information, see the description of the DT_TM2X2 basic data type in this manual. |
If the function was successful, the return value is 1. Otherwise, the function returns 0.