[ft] Clarify docs around faces too
This commit is contained in:
parent
4dc955bb46
commit
c612d068e8
12
src/hb-ft.cc
12
src/hb-ft.cc
|
@ -1032,6 +1032,10 @@ _hb_ft_reference_table (hb_face_t *face HB_UNUSED, hb_tag_t tag, void *user_data
|
||||||
*
|
*
|
||||||
* Creates an #hb_face_t face object from the specified FT_Face.
|
* Creates an #hb_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 #hb_face_t will use the native
|
||||||
|
* HarfBuzz font implementation.
|
||||||
|
*
|
||||||
* This variant of the function does not provide any life-cycle management.
|
* This variant of the function does not provide any life-cycle management.
|
||||||
*
|
*
|
||||||
* Most client programs should use hb_ft_face_create_referenced()
|
* Most client programs should use hb_ft_face_create_referenced()
|
||||||
|
@ -1076,6 +1080,10 @@ hb_ft_face_create (FT_Face ft_face,
|
||||||
*
|
*
|
||||||
* Creates an #hb_face_t face object from the specified FT_Face.
|
* Creates an #hb_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 #hb_face_t will use the native
|
||||||
|
* HarfBuzz font implementation.
|
||||||
|
*
|
||||||
* This is the preferred variant of the hb_ft_face_create*
|
* This is the preferred variant of the hb_ft_face_create*
|
||||||
* function family, because it calls FT_Reference_Face() on @ft_face,
|
* function family, because it calls FT_Reference_Face() on @ft_face,
|
||||||
* ensuring that @ft_face remains alive as long as the resulting
|
* ensuring that @ft_face remains alive as long as the resulting
|
||||||
|
@ -1108,6 +1116,10 @@ hb_ft_face_finalize (void *arg)
|
||||||
*
|
*
|
||||||
* Creates an #hb_face_t face object from the specified FT_Face.
|
* Creates an #hb_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 #hb_face_t will use the native
|
||||||
|
* HarfBuzz font implementation.
|
||||||
|
*
|
||||||
* This variant of the function caches the newly created #hb_face_t
|
* This variant of the function caches the newly created #hb_face_t
|
||||||
* face object, using the @generic pointer of @ft_face. Subsequent function
|
* face object, using the @generic pointer of @ft_face. Subsequent function
|
||||||
* calls that are passed the same @ft_face parameter will have the same
|
* calls that are passed the same @ft_face parameter will have the same
|
||||||
|
|
Loading…
Reference in New Issue