HarfBuzz-0.0 ▶ HarfBuzz ▶ ft_face_create_cachedSince 0.9.2

Creates an HarfBuzz.face_t face object from the specified FT_Face.

Note that this is using the FT_Face object just to get at the underlying font data, and fonts created from the returned HarfBuzz.face_t will use the native HarfBuzz font implementation, unless you call hb_ft_font_set_funcs() on them.

This variant of the function caches the newly created HarfBuzz.face_t face object, using the generic pointer of ft_face. Subsequent function calls that are passed the same ft_face parameter will have the same HarfBuzz.face_t returned to them, and that HarfBuzz.face_t will be correctly reference counted.

However, client programs are still responsible for destroying ft_face after the last HarfBuzz.face_t face object has been destroyed.