Package: pango

Function pango:extents-to-pixels

Lambda List

pango:extents-to-pixels (inclusive nearest)

Arguments

inclusive -- a pango:rectangle instance to round to pixels inclusively, or NULL
nearest -- a pango:rectangle instance to round to nearest pixels, or NULL

Details

Converts extents from Pango units to device units, dividing by the pango:+scale+ factor and performing rounding.

The inclusive rectangle is converted by flooring the x/y coordinates and extending width/height, such that the final rectangle completely includes the original rectangle.

The nearest rectangle is converted by rounding the coordinates of the rectangle to the nearest device unit (pixel).

The rule to which argument to use is: if you want the resulting device-space rectangle to completely contain the original rectangle, pass it in as inclusive. If you want two touching-but-not-overlapping rectangles stay touching-but-not-overlapping after rounding to device units, pass them in as nearest.
 

See also

2023-12-25