Function ul_next_sys::ulConfigSetBitmapAlignment

source ·

pub unsafe extern "C" fn ulConfigSetBitmapAlignment(
    config: ULConfig,
    bitmap_alignment: f64
)

Expand description

The alignment (in bytes) of the BitmapSurface when using the CPU renderer.

The underlying bitmap associated with each BitmapSurface will have row_bytes padded to reach this alignment.

Aligning the bitmap helps improve performance when using the CPU renderer. Determining the proper value to use depends on the CPU architecture and max SIMD instruction set used.

We generally target the 128-bit SSE2 instruction set across most PC platforms so ‘16’ is a safe value to use.

You can set this to ‘0’ to perform no padding (row_bytes will always be width * 4) at a slight cost to performance.

(Default = 16)