Add separate draw_glyph_or_fail()/paint_glyph_or_fail()

So clients can op in or out for fallback mechanism.

Author: khaledhosny

src/uharfbuzz/_raster.pxi

@@ -139,7 +139,10 @@ cdef class RasterDraw:
         c_extents.height = extents.height
         return hb_raster_draw_set_glyph_extents(self._hb_raster_draw, &c_extents)
 
-    def draw_glyph(self, font: Font, glyph: int) -> bool:
+    def draw_glyph(self, font: Font, glyph: int):
+        hb_raster_draw_glyph(self._hb_raster_draw, font._hb_font, glyph)
+
+    def draw_glyph_or_fail(self, font: Font, glyph: int) -> bool:
         return hb_raster_draw_glyph_or_fail(self._hb_raster_draw, font._hb_font, glyph)
 
     def render(self) -> RasterImage | None:
@@ -250,7 +253,10 @@ cdef class RasterPaint:
     def clear_custom_palette_colors(self):
         hb_raster_paint_clear_custom_palette_colors(self._hb_raster_paint)
 
-    def paint_glyph(self, font: Font, glyph: int) -> bool:
+    def paint_glyph(self, font: Font, glyph: int):
+        hb_raster_paint_glyph(self._hb_raster_paint, font._hb_font, glyph)
+
+    def paint_glyph_or_fail(self, font: Font, glyph: int) -> bool:
         return hb_raster_paint_glyph_or_fail(self._hb_raster_paint, font._hb_font, glyph)
 
     def render(self) -> RasterImage | None:

tests/test_raster.py

@@ -115,3 +115,17 @@ def test_custom_palette_color(self):
         paint = hb.RasterPaint()
         assert paint.set_custom_palette_color(0, hb.Color(255, 0, 0, 255))
         paint.clear_custom_palette_colors()
+
+    def test_paint_glyph_or_fail(self, font):
+        # OpenSans glyphs are monochrome
+        gid = 1
+        paint = hb.RasterPaint()
+        paint.scale_factor = (1.0, 1.0)
+        paint.set_glyph_extents(font.get_glyph_extents(gid))
+        # _or_fail variant signals "no color paint data" via False
+        assert not paint.paint_glyph_or_fail(font, gid)
+        # plain variant falls back to outline drawing
+        paint.paint_glyph(font, gid)
+        image = paint.render()
+        assert image is not None
+        assert image.format is hb.RasterFormat.BGRA32