FreeType » Docs » Core API » FreeType Version

FreeType Version¶

Synopsis¶

Note that those functions and macros are of limited use because even a new release of FreeType with only documentation changes increases the version number.

FT_Library_Version¶

Defined in FT_FREETYPE_H (freetype/freetype.h).

  FT_EXPORT( void )
  FT_Library_Version( FT_Library   library,
                      FT_Int      *amajor,
                      FT_Int      *aminor,
                      FT_Int      *apatch );

Return the version of the FreeType library being used. This is useful when dynamically linking to the library, since one cannot use the macros FREETYPE_MAJOR, FREETYPE_MINOR, and FREETYPE_PATCH.

input

library

A source library handle.

output

amajor	The major version number.
aminor	The minor version number.
apatch	The patch version number.

note

The reason why this function takes a library argument is because certain programs implement library initialization in a custom way that doesn't use FT_Init_FreeType.

In such cases, the library version might not be available before the library object has been created.

FT_Face_CheckTrueTypePatents¶

Defined in FT_FREETYPE_H (freetype/freetype.h).

  FT_EXPORT( FT_Bool )
  FT_Face_CheckTrueTypePatents( FT_Face  face );

Deprecated, does nothing.

input

face	A face handle.

return

Always returns false.

note

Since May 2010, TrueType hinting is no longer patented.

since

2.3.5

FT_Face_SetUnpatentedHinting¶

Defined in FT_FREETYPE_H (freetype/freetype.h).

  FT_EXPORT( FT_Bool )
  FT_Face_SetUnpatentedHinting( FT_Face  face,
                                FT_Bool  value );

Deprecated, does nothing.

input

face	A face handle.
value	New boolean setting.

return

Always returns false.

note

Since May 2010, TrueType hinting is no longer patented.

since

2.3.5

FREETYPE_XXX¶

Defined in FT_FREETYPE_H (freetype/freetype.h).

#define FREETYPE_MAJOR  2
#define FREETYPE_MINOR  12
#define FREETYPE_PATCH  1

These three macros identify the FreeType source code version. Use FT_Library_Version to access them at runtime.

values

FREETYPE_MAJOR	The major version number.
FREETYPE_MINOR	The minor version number.
FREETYPE_PATCH	The patch level.

note

The version number of FreeType if built as a dynamic link library with the ‘libtool’ package is not controlled by these three macros.