(v13) bitimage in the PFIN API

This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP

sw_pfin_result bitimage(sw_pfin_outline_context * context, int width, int height, int xoffset, int yoffset, double xres, double yres, unsigned char * buffer, size_t length);

In response to an outline call whose sw_pfin_font prefer field is not PFIN_OUTLINE_REQUIRED, the module instance can deliver the glyph as a bitmap.

If the bitmap already exists, its address and length are given in this call, otherwise a NULL buffer causes PFIN to call the module’s raster entry point to fill in a cache form or fetch bitmap data.

The module may make use of the options call to cause the returned bitmap to be rotated, if not already.

In this way, modules can support predefined bitmap fonts and rasterization on demand.