ft_face_create_referenced


Description:


[ Version ( since = "0.9.38" ) ]
public Face ft_face_create_referenced (Face ft_face)

Creates an Face 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 Face will use the native HarfBuzz font implementation, unless you call ft_font_set_funcs on them.

This is the preferred variant of the hb_ft_face_create* function family, because it calls FT_Reference_Face on ft_face , ensuring that ft_face remains alive as long as the resulting Face face object remains alive. Also calls FT_Done_Face when the Face face object is destroyed.

Use this version unless you know you have good reasons not to.

Parameters:

ft_face

FT_Face to work upon

Returns:

the new Face face object


Namespace: HarfBuzz