Advanced Font Cache and Region Testing

This release adds a powerful font-face cache system and new APIs for testing whether a point lies within fill, stroke, or clip regions. It improves font management, enables dynamic font selection by family and style, and supports precise hit-testing for interactive graphics.

New APIs and Features

Font-Face Cache System

A complete API for managing and accessing font faces:

• Creation and Lifecycle

  • plutovg_font_face_cache_create()
  • plutovg_font_face_cache_reference()
  • plutovg_font_face_cache_destroy()
  • plutovg_font_face_cache_reference_count()
  • plutovg_font_face_cache_reset()

• Manual Addition and Retrieval

  • plutovg_font_face_cache_add() Adds a font face with a specified family and style.
  • plutovg_font_face_cache_add_file() Loads and adds a font face from a specific file.
  • plutovg_font_face_cache_get() Retrieves a font face matching a given style.

• Bulk Font Loading

  • plutovg_font_face_cache_load_file() Loads all faces from a single file.
  • plutovg_font_face_cache_load_dir() Recursively loads fonts from a directory.
  • plutovg_font_face_cache_load_sys() Loads system-installed fonts.

Canvas Font Integration

The canvas can now associate and select fonts dynamically using:

• plutovg_canvas_set_font_face_cache() Assigns a font cache to the canvas.

• plutovg_canvas_get_font_face_cache() Retrieves the current cache from the canvas.

• plutovg_canvas_add_font_face() Registers a font face under a family and style.

• plutovg_canvas_add_font_file() Loads and registers a font face from a file.

• plutovg_canvas_select_font_face() Selects a font face for use in drawing operations.

These APIs allow high-level font selection using family names and style flags (bold, italic), while internally managing font-face lifetimes through the cache.

Point Containment Queries

Three new functions provide hit-testing against rendering regions in user space:

• plutovg_canvas_fill_contains() Tests whether a point lies within the current fill region (ignores clip and surface).

• plutovg_canvas_stroke_contains() Tests whether a point lies within the stroked path outline.

• plutovg_canvas_clip_contains() Tests whether a point lies inside the canvas clipping region.

These APIs allow precise user interaction handling, including mouse hit-tests and visual region queries.