[hb-paint] Add some details to the docs

This commit is contained in:
Matthias Clasen 2023-01-23 20:44:22 -05:00 committed by Behdad Esfahbod
parent e4fff64ce3
commit 7e01976bcc
1 changed files with 10 additions and 0 deletions

View File

@ -54,6 +54,10 @@ HB_BEGIN_DECLS
* The paint-image callback is only needed for glyphs * The paint-image callback is only needed for glyphs
* with image blobs in the CBDT, sbix or SVG tables. * with image blobs in the CBDT, sbix or SVG tables.
* *
* The custom-palette-color callback is only necessary if
* you want to override colors from the font palette with
* custom colors.
*
* Since: REPLACEME * Since: REPLACEME
**/ **/
typedef struct hb_paint_funcs_t hb_paint_funcs_t; typedef struct hb_paint_funcs_t hb_paint_funcs_t;
@ -667,6 +671,12 @@ typedef void (*hb_paint_pop_group_func_t) (hb_paint_funcs_t *funcs,
* A virtual method for the #hb_paint_funcs_t to fetch a color from the custom * A virtual method for the #hb_paint_funcs_t to fetch a color from the custom
* color palette. * color palette.
* *
* Custom palette colors override the colors from the fonts selected color
* palette. It is possible to override only some of the palette colors.
*
* This function might get called multiple times, but the custom palette is
* expected to remain unchanged for duration of a hb_font_paint_glyph() call.
*
* Return value: `true` if found, `false` otherwise * Return value: `true` if found, `false` otherwise
* *
* Since: REPLACEME * Since: REPLACEME