[freetype2] master c948df5: * include/freetype/ftmodapi.h (FT_FACE_DRIVER_NAME): New public macro.

[Alexei Podtelezhnikov]

branch: master
commit c948df52e40bca30a510694cc6ca00b49abd334c
Author: Alexei Podtelezhnikov <apodtele@gmail.com>
Commit: Alexei Podtelezhnikov <apodtele@gmail.com>

    * include/freetype/ftmodapi.h (FT_FACE_DRIVER_NAME): New public macro.
    
    The driver name is needed for `FT_Property_Set' and `FT_Property_Get'.
---
 ChangeLog                   |  6 ++++++
 include/freetype/ftmodapi.h | 18 ++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 3c93564..4fe9b34 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2020-12-17  Alexei Podtelezhnikov  <apodtele@gmail.com>
+
+       * include/freetype/ftmodapi.h (FT_FACE_DRIVER_NAME): New public macro.
+
+       The driver name is needed for `FT_Property_Set' and `FT_Property_Get'.
+
 2020-12-16  Chris Liddell  <chris.liddell@artifex.com>
 
        [truetype] Fix incremental metrics (#59503).
diff --git a/include/freetype/ftmodapi.h b/include/freetype/ftmodapi.h
index f4246dc..8b0bbe3 100644
--- a/include/freetype/ftmodapi.h
+++ b/include/freetype/ftmodapi.h
@@ -88,6 +88,7 @@ FT_BEGIN_HEADER
    *   FT_Remove_Module
    *   FT_Add_Default_Modules
    *
+   *   FT_FACE_DRIVER_NAME
    *   FT_Property_Set
    *   FT_Property_Get
    *   FT_Set_Default_Properties
@@ -331,6 +332,23 @@ FT_BEGIN_HEADER
 
 
   /**************************************************************************
+   *
+   * @macro:
+   *   FT_FACE_DRIVER_NAME
+   *
+   * @description:
+   *   A macro that retrieves the name of a font driver from a face object.
+   *
+   * @note:
+   *   The font driver name is a valid `module_name` for @FT_Property_Set
+   *   and @FT_Property_Get.  This is not the same as @FT_Get_Font_Format.
+   *
+   */
+#define FT_FACE_DRIVER_NAME( face ) \
+          ( ( *(FT_Module_Class**)( ( face )->driver ) )->module_name )
+
+
+  /**************************************************************************
    *
    * @function:
    *    FT_Property_Set