Package: pango

Function pango:matrix-transform-rectangle

Lambda List

pango:matrix-transform-rectangle (matrix rect)

Arguments

matrix -- a pango:matrix instance
rect -- a pango:rectangle instance

Return Value

The transformed pango:rectangle instance with the bounding box.

Details

First transforms rect using matrix, then calculates the bounding box of the transformed rectangle. The rectangle should be in Pango units. This function is useful for example when you want to draw a rotated pango:layout object to an image buffer, and want to know how large the image should be and how much you should shift the layout when rendering. If you have a rectangle in device units (pixels), use the pango:matrix-transform-pixel-rectangle function.

If you have the rectangle in Pango units and want to convert to transformed pixel bounding box, it is more accurate to transform it first using this function and pass the result to the pango:extents-to-pixels functions first argument, for an inclusive rounded rectangle. However, there are valid reasons that you may want to convert to pixels first and then transform, for example when the transformed coordinates may overflow in Pango units, large matrix translation for example.
 

See also

2025-1-3