hb_raster_image_create_or_fail ()

hb_raster_image_t *
hb_raster_image_create_or_fail (void);

Creates a new raster image object.

Since: 13.0.0

hb_raster_image_reference ()

hb_raster_image_t *
hb_raster_image_reference (hb_raster_image_t *image);

Increases the reference count on image by one.

This prevents image from being destroyed until a matching call to hb_raster_image_destroy() is made.

[skip]

Since: 13.0.0

hb_raster_image_destroy ()

void
hb_raster_image_destroy (hb_raster_image_t *image);

Decreases the reference count on image by one. When the reference count reaches zero, the image and its pixel buffer are freed.

[skip]

Since: 13.0.0

hb_raster_image_set_user_data ()

hb_bool_t
hb_raster_image_set_user_data (hb_raster_image_t *image,
                               hb_user_data_key_t *key,
                               void *data,
                               hb_destroy_func_t destroy,
                               hb_bool_t replace);

Attaches a user-data key/data pair to the specified raster image.

[skip]

Since: 13.0.0

hb_raster_image_get_user_data ()

void *
hb_raster_image_get_user_data (hb_raster_image_t *image,
                               hb_user_data_key_t *key);

Fetches the user-data associated with the specified key, attached to the specified raster image.

[skip]

Since: 13.0.0

hb_raster_image_configure ()

hb_bool_t
hb_raster_image_configure (hb_raster_image_t *image,
                           hb_raster_format_t format,
                           const hb_raster_extents_t *extents);

Configures image format and extents together, resizing backing storage at most once. This function does not clear pixel contents.

Passing NULL for extents clears extents and releases the backing allocation.

Since: 13.0.0

hb_raster_image_clear ()

void
hb_raster_image_clear (hb_raster_image_t *image);

Clears image pixels to zero while keeping current extents and format.

Since: 13.0.0

hb_raster_image_get_buffer ()

const uint8_t *
hb_raster_image_get_buffer (hb_raster_image_t *image);

Fetches the raw pixel buffer of image . The buffer layout is described by the extents obtained from hb_raster_image_get_extents() and the format from hb_raster_image_get_format().

Since: 13.0.0

hb_raster_image_get_extents ()

void
hb_raster_image_get_extents (hb_raster_image_t *image,
                             hb_raster_extents_t *extents);

Fetches the pixel-buffer extents of image .

Since: 13.0.0

hb_raster_image_get_format ()

hb_raster_format_t
hb_raster_image_get_format (hb_raster_image_t *image);

Fetches the pixel format of image .

Since: 13.0.0

hb_raster_draw_create_or_fail ()

hb_raster_draw_t *
hb_raster_draw_create_or_fail (void);

Creates a new rasterizer object.

Since: 13.0.0

hb_raster_draw_reference ()

hb_raster_draw_t *
hb_raster_draw_reference (hb_raster_draw_t *draw);

Increases the reference count on draw by one.

This prevents draw from being destroyed until a matching call to hb_raster_draw_destroy() is made.

[skip]

Since: 13.0.0

hb_raster_draw_destroy ()

void
hb_raster_draw_destroy (hb_raster_draw_t *draw);

Decreases the reference count on draw by one. When the reference count reaches zero, the rasterizer is freed.

[skip]

Since: 13.0.0

hb_raster_draw_set_user_data ()

hb_bool_t
hb_raster_draw_set_user_data (hb_raster_draw_t *draw,
                              hb_user_data_key_t *key,
                              void *data,
                              hb_destroy_func_t destroy,
                              hb_bool_t replace);

Attaches a user-data key/data pair to the specified rasterizer.

[skip]

Since: 13.0.0

hb_raster_draw_get_user_data ()

void *
hb_raster_draw_get_user_data (hb_raster_draw_t *draw,
                              hb_user_data_key_t *key);

Fetches the user-data associated with the specified key, attached to the specified rasterizer.

[skip]

Since: 13.0.0

hb_raster_draw_set_transform ()

void
hb_raster_draw_set_transform (hb_raster_draw_t *draw,
                              float xx,
                              float yx,
                              float xy,
                              float yy,
                              float dx,
                              float dy);

Sets a 2×3 affine transform applied to all incoming draw coordinates before rasterization. The default is the identity.

Since: 13.0.0

hb_raster_draw_set_scale_factor ()

void
hb_raster_draw_set_scale_factor (hb_raster_draw_t *draw,
                                 float x_scale_factor,
                                 float y_scale_factor);

Sets post-transform minification factors applied during rasterization. Factors larger than 1 shrink the output in pixels. The default is 1.

Since: 13.0.0

hb_raster_draw_get_scale_factor ()

void
hb_raster_draw_get_scale_factor (hb_raster_draw_t *draw,
                                 float *x_scale_factor,
                                 float *y_scale_factor);

Fetches the current post-transform minification factors.

Since: 13.0.0

hb_raster_draw_get_transform ()

void
hb_raster_draw_get_transform (hb_raster_draw_t *draw,
                              float *xx,
                              float *yx,
                              float *xy,
                              float *yy,
                              float *dx,
                              float *dy);

Fetches the current affine transform of the rasterizer.

Since: 13.0.0

hb_raster_draw_set_extents ()

void
hb_raster_draw_set_extents (hb_raster_draw_t *draw,
                            const hb_raster_extents_t *extents);

Overrides the output image extents for the next render. When set, hb_raster_draw_render() uses the given extents instead of auto-computing them from the accumulated geometry.

Since: 13.0.0

hb_raster_draw_get_extents ()

hb_bool_t
hb_raster_draw_get_extents (hb_raster_draw_t *draw,
                            hb_raster_extents_t *extents);

Gets currently configured output extents.

Since: 13.0.0

hb_raster_draw_set_glyph_extents ()

hb_bool_t
hb_raster_draw_set_glyph_extents (hb_raster_draw_t *draw,
                                  const hb_glyph_extents_t *glyph_extents);

Transforms glyph_extents with the rasterizer's current transform and sets the resulting pixel extents for the next render.

This is equivalent to computing a transformed bounding box in pixel space and calling hb_raster_draw_set_extents().

Since: 13.0.0

hb_raster_draw_reset ()

void
hb_raster_draw_reset (hb_raster_draw_t *draw);

Resets the rasterizer to its initial state, clearing all accumulated geometry, the transform, and fixed extents. The object can then be reused for a new glyph.

Internal scratch buffers and recycled image cache are preserved for reuse across subsequent renders.

Since: 13.0.0

hb_raster_draw_get_funcs ()

hb_draw_funcs_t *
hb_raster_draw_get_funcs (void);

Fetches the singleton hb_draw_funcs_t that feeds outline data into an hb_raster_draw_t. Pass the hb_raster_draw_t as the draw_data argument when calling the draw functions.

Since: 13.0.0

hb_raster_draw_glyph ()

void
hb_raster_draw_glyph (hb_raster_draw_t *draw,
                      hb_font_t *font,
                      hb_codepoint_t glyph,
                      float pen_x,
                      float pen_y);

Convenience wrapper to draw one glyph at (pen_x , pen_y ) using the rasterizer's current transform. The pen coordinates are applied before minification and are transformed by the current affine transform.

Since: 13.0.0

hb_raster_draw_render ()

hb_raster_image_t *
hb_raster_draw_render (hb_raster_draw_t *draw);

Rasterizes the accumulated outline geometry into a new hb_raster_image_t. After rendering, the accumulated edges are cleared so the rasterizer can be reused. Output format is always HB_RASTER_FORMAT_A8 .

Since: 13.0.0

hb_raster_draw_recycle_image ()

void
hb_raster_draw_recycle_image (hb_raster_draw_t *draw,
                              hb_raster_image_t *image);

Recycles image for reuse by a subsequent hb_raster_draw_render() call, avoiding per-render memory allocation. The caller transfers ownership of image to draw and must not use it afterwards.

If draw already holds a recycled image, the previously recycled image is destroyed.

Since: 13.0.0

hb_raster_paint_create_or_fail ()

hb_raster_paint_t *
hb_raster_paint_create_or_fail (void);

Creates a new color-glyph paint context.

Since: 13.0.0

hb_raster_paint_reference ()

hb_raster_paint_t *
hb_raster_paint_reference (hb_raster_paint_t *paint);

Increases the reference count on paint by one.

[skip]

Since: 13.0.0

hb_raster_paint_destroy ()

void
hb_raster_paint_destroy (hb_raster_paint_t *paint);

Decreases the reference count on paint by one. When the reference count reaches zero, the paint context is freed.

[skip]

Since: 13.0.0

hb_raster_paint_set_user_data ()

hb_bool_t
hb_raster_paint_set_user_data (hb_raster_paint_t *paint,
                               hb_user_data_key_t *key,
                               void *data,
                               hb_destroy_func_t destroy,
                               hb_bool_t replace);

Attaches a user-data key/data pair to the specified paint context.

[skip]

Since: 13.0.0

hb_raster_paint_get_user_data ()

void *
hb_raster_paint_get_user_data (hb_raster_paint_t *paint,
                               hb_user_data_key_t *key);

Fetches the user-data associated with the specified key, attached to the specified paint context.

[skip]

Since: 13.0.0

hb_raster_paint_set_transform ()

void
hb_raster_paint_set_transform (hb_raster_paint_t *paint,
                               float xx,
                               float yx,
                               float xy,
                               float yy,
                               float dx,
                               float dy);

Sets the base 2×3 affine transform that maps from glyph-space coordinates to pixel-space coordinates.

Since: 13.0.0

hb_raster_paint_get_transform ()

void
hb_raster_paint_get_transform (hb_raster_paint_t *paint,
                               float *xx,
                               float *yx,
                               float *xy,
                               float *yy,
                               float *dx,
                               float *dy);

Gets the current base 2x3 affine transform.

Since: 13.0.0

hb_raster_paint_set_scale_factor ()

void
hb_raster_paint_set_scale_factor (hb_raster_paint_t *paint,
                                  float x_scale_factor,
                                  float y_scale_factor);

Sets post-transform minification factors applied during painting. Factors larger than 1 shrink the output in pixels. The default is 1.

Since: 13.0.0

hb_raster_paint_get_scale_factor ()

void
hb_raster_paint_get_scale_factor (hb_raster_paint_t *paint,
                                  float *x_scale_factor,
                                  float *y_scale_factor);

Fetches the current post-transform minification factors.

Since: 13.0.0

hb_raster_paint_set_extents ()

void
hb_raster_paint_set_extents (hb_raster_paint_t *paint,
                             const hb_raster_extents_t *extents);

Sets the output image extents (pixel rectangle).

Call this before hb_font_paint_glyph() for each render. A common pattern is: hb_glyph_extents_t gext; if (hb_font_get_glyph_extents (font, gid, &gext)) hb_raster_paint_set_glyph_extents (paint, &gext);

Since: 13.0.0

hb_raster_paint_get_extents ()

hb_bool_t
hb_raster_paint_get_extents (hb_raster_paint_t *paint,
                             hb_raster_extents_t *extents);

Gets currently configured output extents.

Since: 13.0.0

hb_raster_paint_set_glyph_extents ()

hb_bool_t
hb_raster_paint_set_glyph_extents (hb_raster_paint_t *paint,
                                   const hb_glyph_extents_t *glyph_extents);

Transforms glyph_extents with the paint context's base transform and sets the resulting output image extents.

This is equivalent to computing a transformed bounding box in pixel space and calling hb_raster_paint_set_extents().

Since: 13.0.0

hb_raster_paint_set_foreground ()

void
hb_raster_paint_set_foreground (hb_raster_paint_t *paint,
                                hb_color_t foreground);

Sets the foreground color used when paint callbacks request it (e.g. is_foreground in color stops or solid fills).

Since: 13.0.0

hb_raster_paint_clear_custom_palette_colors ()

void
hb_raster_paint_clear_custom_palette_colors
                               (hb_raster_paint_t *paint);

Clears all custom palette color overrides previously set on paint .

After this call, palette lookups use the selected font palette without custom override entries.

Since: 13.0.0

hb_raster_paint_set_custom_palette_color ()

hb_bool_t
hb_raster_paint_set_custom_palette_color
                               (hb_raster_paint_t *paint,
                                unsigned int color_index,
                                hb_color_t color);

Overrides one font palette color entry for subsequent paint operations. Overrides are keyed by color_index and persist on paint until cleared (or replaced for the same index).

These overrides are consulted by paint operations that resolve CPAL entries.

Since: 13.0.0

hb_raster_paint_get_funcs ()

hb_paint_funcs_t *
hb_raster_paint_get_funcs (void);

Fetches the singleton hb_paint_funcs_t that renders color glyphs into an hb_raster_paint_t. Pass the hb_raster_paint_t as the paint_data argument when calling hb_font_paint_glyph().

Since: 13.0.0

hb_raster_paint_glyph ()

hb_bool_t
hb_raster_paint_glyph (hb_raster_paint_t *paint,
                       hb_font_t *font,
                       hb_codepoint_t glyph,
                       float pen_x,
                       float pen_y,
                       unsigned  palette,
                       hb_color_t foreground);

Convenience wrapper to paint one color glyph at (pen_x , pen_y ) using the paint context's current transform. The pen coordinates are applied before minification and transformed by the current affine transform.

Since: 13.0.0

hb_raster_paint_render ()

hb_raster_image_t *
hb_raster_paint_render (hb_raster_paint_t *paint);

Extracts the rendered image after hb_font_paint_glyph() has completed. The paint context's surface stack is consumed and the result returned as a new hb_raster_image_t. Output format is always HB_RASTER_FORMAT_BGRA32 .

Call hb_font_paint_glyph() before calling this function. hb_raster_paint_set_extents() or hb_raster_paint_set_glyph_extents() must be called before painting; otherwise this function returns NULL. Internal drawing state is cleared here so the same object can be reused without client-side clearing.

Since: 13.0.0

hb_raster_paint_reset ()

void
hb_raster_paint_reset (hb_raster_paint_t *paint);

Resets the paint context to its initial state, clearing all configuration while preserving internal image caches.

Since: 13.0.0

hb_raster_paint_recycle_image ()

void
hb_raster_paint_recycle_image (hb_raster_paint_t *paint,
                               hb_raster_image_t *image);

Recycles image for reuse by subsequent render calls. The caller transfers ownership of image to paint .

Since: 13.0.0

enum hb_raster_format_t

Pixel format for raster images.

Since: 13.0.0

hb_raster_extents_t

typedef struct {
  int      x_origin, y_origin;
  unsigned int width, height;
  unsigned int stride;
} hb_raster_extents_t;

Pixel-buffer extents for raster operations.

Since: 13.0.0

hb_raster_image_t

typedef struct hb_raster_image_t hb_raster_image_t;

An opaque raster image object holding a pixel buffer produced by hb_raster_draw_render(). Use hb_raster_image_get_buffer() and hb_raster_image_get_extents() to access the pixels.

Since: 13.0.0

hb_raster_draw_t

typedef struct hb_raster_draw_t hb_raster_draw_t;

An opaque outline rasterizer object. Accumulates glyph outlines via hb_draw_funcs_t callbacks obtained from hb_raster_draw_get_funcs(), then produces an hb_raster_image_t with hb_raster_draw_render().

Since: 13.0.0

hb_raster_paint_t

typedef struct hb_raster_paint_t hb_raster_paint_t;

An opaque color-glyph paint context. Implements hb_paint_funcs_t callbacks that render COLRv0/v1 color glyphs into a BGRA32 hb_raster_image_t.

Since: 13.0.0