parent
b5d7cd3a4b
commit
b528826f69
90 changed files with 1850 additions and 2100 deletions
@ -0,0 +1,16 @@ |
||||
BasedOnStyle: Chromium |
||||
AlignAfterOpenBracket: Align |
||||
AlignConsecutiveAssignments: true |
||||
AlignConsecutiveDeclarations: true |
||||
AlignConsecutiveMacros: true |
||||
AlignEscapedNewlines: true |
||||
# AlignOperands: Align |
||||
AlignTrailingComments: true |
||||
AlwaysBreakAfterReturnType: AllDefinitions |
||||
BreakBeforeBraces: Allman |
||||
ColumnLimit: 80 |
||||
DerivePointerAlignment: false |
||||
IndentCaseLabels: false |
||||
PointerAlignment: Left |
||||
SpaceBeforeParens: ControlStatements |
||||
SpacesInParentheses: true |
@ -0,0 +1,62 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* ftconfig.h.in |
||||
* |
||||
* UNIX-specific configuration file (specification only). |
||||
* |
||||
* Copyright (C) 1996-2020 by |
||||
* David Turner, Robert Wilhelm, and Werner Lemberg. |
||||
* |
||||
* This file is part of the FreeType project, and may only be used, |
||||
* modified, and distributed under the terms of the FreeType project |
||||
* license, LICENSE.TXT. By continuing to use, modify, or distribute |
||||
* this file you indicate that you have read the license and |
||||
* understand and accept it fully. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* This header file contains a number of macro definitions that are used by |
||||
* the rest of the engine. Most of the macros here are automatically |
||||
* determined at compile time, and you should not need to change it to port |
||||
* FreeType, except to compile the library with a non-ANSI compiler. |
||||
* |
||||
* Note however that if some specific modifications are needed, we advise |
||||
* you to place a modified copy in your build directory. |
||||
* |
||||
* The build directory is usually `builds/<system>`, and contains |
||||
* system-specific files that are always included first when building the |
||||
* library. |
||||
* |
||||
*/ |
||||
|
||||
#ifndef FTCONFIG_H_ |
||||
#define FTCONFIG_H_ |
||||
|
||||
#include <ft2build.h> |
||||
#include FT_CONFIG_OPTIONS_H |
||||
#include FT_CONFIG_STANDARD_LIBRARY_H |
||||
|
||||
#undef HAVE_UNISTD_H |
||||
#undef HAVE_FCNTL_H |
||||
|
||||
#undef FT_USE_AUTOCONF_SIZEOF_TYPES |
||||
#ifdef FT_USE_AUTOCONF_SIZEOF_TYPES |
||||
|
||||
#undef SIZEOF_INT |
||||
#undef SIZEOF_LONG |
||||
#define FT_SIZEOF_INT SIZEOF_INT |
||||
#define FT_SIZEOF_LONG SIZEOF_LONG |
||||
|
||||
#endif /* FT_USE_AUTOCONF_SIZEOF_TYPES */ |
||||
|
||||
#include <freetype/config/integer-types.h> |
||||
#include <freetype/config/public-macros.h> |
||||
#include <freetype/config/mac-support.h> |
||||
|
||||
#endif /* FTCONFIG_H_ */ |
||||
|
||||
|
||||
/* END */ |
@ -1,602 +0,0 @@ |
||||
/**************************************************************************** |
||||
* |
||||
* ftconfig.in |
||||
* |
||||
* UNIX-specific configuration file (specification only). |
||||
* |
||||
* Copyright (C) 1996-2020 by |
||||
* David Turner, Robert Wilhelm, and Werner Lemberg. |
||||
* |
||||
* This file is part of the FreeType project, and may only be used, |
||||
* modified, and distributed under the terms of the FreeType project |
||||
* license, LICENSE.TXT. By continuing to use, modify, or distribute |
||||
* this file you indicate that you have read the license and |
||||
* understand and accept it fully. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* This header file contains a number of macro definitions that are used by |
||||
* the rest of the engine. Most of the macros here are automatically |
||||
* determined at compile time, and you should not need to change it to port |
||||
* FreeType, except to compile the library with a non-ANSI compiler. |
||||
* |
||||
* Note however that if some specific modifications are needed, we advise |
||||
* you to place a modified copy in your build directory. |
||||
* |
||||
* The build directory is usually `builds/<system>`, and contains |
||||
* system-specific files that are always included first when building the |
||||
* library. |
||||
* |
||||
*/ |
||||
|
||||
#ifndef FTCONFIG_H_ |
||||
#define FTCONFIG_H_ |
||||
|
||||
#include <ft2build.h> |
||||
#include FT_CONFIG_OPTIONS_H |
||||
#include FT_CONFIG_STANDARD_LIBRARY_H |
||||
|
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* PLATFORM-SPECIFIC CONFIGURATION MACROS |
||||
* |
||||
* These macros can be toggled to suit a specific system. The current ones |
||||
* are defaults used to compile FreeType in an ANSI C environment (16bit |
||||
* compilers are also supported). Copy this file to your own |
||||
* `builds/<system>` directory, and edit it to port the engine. |
||||
* |
||||
*/ |
||||
|
||||
#undef HAVE_UNISTD_H |
||||
#undef HAVE_FCNTL_H |
||||
|
||||
/* There are systems (like the Texas Instruments 'C54x) where a `char` */ |
||||
/* has 16~bits. ANSI~C says that `sizeof(char)` is always~1. Since an */ |
||||
/* `int` has 16~bits also for this system, `sizeof(int)` gives~1 which */ |
||||
/* is probably unexpected. */ |
||||
/* */ |
||||
/* `CHAR_BIT` (defined in `limits.h`) gives the number of bits in a */ |
||||
/* `char` type. */ |
||||
|
||||
#ifndef FT_CHAR_BIT |
||||
#define FT_CHAR_BIT CHAR_BIT |
||||
#endif |
||||
|
||||
|
||||
#undef FT_USE_AUTOCONF_SIZEOF_TYPES |
||||
#ifdef FT_USE_AUTOCONF_SIZEOF_TYPES |
||||
|
||||
#undef SIZEOF_INT |
||||
#undef SIZEOF_LONG |
||||
#define FT_SIZEOF_INT SIZEOF_INT |
||||
#define FT_SIZEOF_LONG SIZEOF_LONG |
||||
|
||||
#else /* !FT_USE_AUTOCONF_SIZEOF_TYPES */ |
||||
|
||||
/* Following cpp computation of the bit length of `int` and `long` */ |
||||
/* is copied from default `include/freetype/config/ftconfig.h`. */ |
||||
/* If any improvement is required for this file, it should be */ |
||||
/* applied to the original header file for the builders that do */ |
||||
/* not use configure script. */ |
||||
|
||||
/* The size of an `int` type. */ |
||||
#if FT_UINT_MAX == 0xFFFFUL |
||||
#define FT_SIZEOF_INT ( 16 / FT_CHAR_BIT ) |
||||
#elif FT_UINT_MAX == 0xFFFFFFFFUL |
||||
#define FT_SIZEOF_INT ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_UINT_MAX > 0xFFFFFFFFUL && FT_UINT_MAX == 0xFFFFFFFFFFFFFFFFUL |
||||
#define FT_SIZEOF_INT ( 64 / FT_CHAR_BIT ) |
||||
#else |
||||
#error "Unsupported size of `int' type!" |
||||
#endif |
||||
|
||||
/* The size of a `long` type. A five-byte `long` (as used e.g. on the */ |
||||
/* DM642) is recognized but avoided. */ |
||||
#if FT_ULONG_MAX == 0xFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_ULONG_MAX > 0xFFFFFFFFUL && FT_ULONG_MAX == 0xFFFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_ULONG_MAX > 0xFFFFFFFFUL && FT_ULONG_MAX == 0xFFFFFFFFFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 64 / FT_CHAR_BIT ) |
||||
#else |
||||
#error "Unsupported size of `long' type!" |
||||
#endif |
||||
|
||||
#endif /* !FT_USE_AUTOCONF_SIZEOF_TYPES */ |
||||
|
||||
/* `FT_UNUSED` indicates that a given parameter is not used -- */ |
||||
/* this is only used to get rid of unpleasant compiler warnings. */ |
||||
#ifndef FT_UNUSED |
||||
#define FT_UNUSED( arg ) ( (arg) = (arg) ) |
||||
#endif |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* AUTOMATIC CONFIGURATION MACROS |
||||
* |
||||
* These macros are computed from the ones defined above. Don't touch |
||||
* their definition, unless you know precisely what you are doing. No |
||||
* porter should need to mess with them. |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* Mac support |
||||
* |
||||
* This is the only necessary change, so it is defined here instead |
||||
* providing a new configuration file. |
||||
*/ |
||||
#if defined( __APPLE__ ) || ( defined( __MWERKS__ ) && defined( macintosh ) ) |
||||
/* No Carbon frameworks for 64bit 10.4.x. */ |
||||
/* `AvailabilityMacros.h` is available since Mac OS X 10.2, */ |
||||
/* so guess the system version by maximum errno before inclusion. */ |
||||
#include <errno.h> |
||||
#ifdef ECANCELED /* defined since 10.2 */ |
||||
#include "AvailabilityMacros.h" |
||||
#endif |
||||
#if defined( __LP64__ ) && \ |
||||
( MAC_OS_X_VERSION_MIN_REQUIRED <= MAC_OS_X_VERSION_10_4 ) |
||||
/undef FT_MACINTOSH |
||||
#endif |
||||
|
||||
#elif defined( __SC__ ) || defined( __MRC__ ) |
||||
/* Classic MacOS compilers */ |
||||
#include "ConditionalMacros.h" |
||||
#if TARGET_OS_MAC |
||||
#define FT_MACINTOSH 1 |
||||
#endif |
||||
|
||||
#endif |
||||
|
||||
|
||||
/* Fix compiler warning with sgi compiler. */ |
||||
#if defined( __sgi ) && !defined( __GNUC__ ) |
||||
#if defined( _COMPILER_VERSION ) && ( _COMPILER_VERSION >= 730 ) |
||||
#pragma set woff 3505 |
||||
#endif |
||||
#endif |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* @section: |
||||
* basic_types |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* @type: |
||||
* FT_Int16 |
||||
* |
||||
* @description: |
||||
* A typedef for a 16bit signed integer type. |
||||
*/ |
||||
typedef signed short FT_Int16; |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* @type: |
||||
* FT_UInt16 |
||||
* |
||||
* @description: |
||||
* A typedef for a 16bit unsigned integer type. |
||||
*/ |
||||
typedef unsigned short FT_UInt16; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
/* this #if 0 ... #endif clause is for documentation purposes */ |
||||
#if 0 |
||||
|
||||
/************************************************************************** |
||||
* |
||||
* @type: |
||||
* FT_Int32 |
||||
* |
||||
* @description: |
||||
* A typedef for a 32bit signed integer type. The size depends on the |
||||
* configuration. |
||||
*/ |
||||
typedef signed XXX FT_Int32; |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* @type: |
||||
* FT_UInt32 |
||||
* |
||||
* A typedef for a 32bit unsigned integer type. The size depends on the |
||||
* configuration. |
||||
*/ |
||||
typedef unsigned XXX FT_UInt32; |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* @type: |
||||
* FT_Int64 |
||||
* |
||||
* A typedef for a 64bit signed integer type. The size depends on the |
||||
* configuration. Only defined if there is real 64bit support; |
||||
* otherwise, it gets emulated with a structure (if necessary). |
||||
*/ |
||||
typedef signed XXX FT_Int64; |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* @type: |
||||
* FT_UInt64 |
||||
* |
||||
* A typedef for a 64bit unsigned integer type. The size depends on the |
||||
* configuration. Only defined if there is real 64bit support; |
||||
* otherwise, it gets emulated with a structure (if necessary). |
||||
*/ |
||||
typedef unsigned XXX FT_UInt64; |
||||
|
||||
/* */ |
||||
|
||||
#endif |
||||
|
||||
#if FT_SIZEOF_INT == 4 |
||||
|
||||
typedef signed int FT_Int32; |
||||
typedef unsigned int FT_UInt32; |
||||
|
||||
#elif FT_SIZEOF_LONG == 4 |
||||
|
||||
typedef signed long FT_Int32; |
||||
typedef unsigned long FT_UInt32; |
||||
|
||||
#else |
||||
#error "no 32bit type found -- please check your configuration files" |
||||
#endif |
||||
|
||||
|
||||
/* look up an integer type that is at least 32~bits */ |
||||
#if FT_SIZEOF_INT >= 4 |
||||
|
||||
typedef int FT_Fast; |
||||
typedef unsigned int FT_UFast; |
||||
|
||||
#elif FT_SIZEOF_LONG >= 4 |
||||
|
||||
typedef long FT_Fast; |
||||
typedef unsigned long FT_UFast; |
||||
|
||||
#endif |
||||
|
||||
|
||||
/* determine whether we have a 64-bit `int` type for platforms without */ |
||||
/* Autoconf */ |
||||
#if FT_SIZEOF_LONG == 8 |
||||
|
||||
/* `FT_LONG64` must be defined if a 64-bit type is available */ |
||||
#define FT_LONG64 |
||||
#define FT_INT64 long |
||||
#define FT_UINT64 unsigned long |
||||
|
||||
/* we handle the LLP64 scheme separately for GCC and clang, */ |
||||
/* suppressing the `long long` warning */ |
||||
#elif ( FT_SIZEOF_LONG == 4 ) && \ |
||||
defined( HAVE_LONG_LONG_INT ) && \ |
||||
defined( __GNUC__ ) |
||||
#pragma GCC diagnostic ignored "-Wlong-long" |
||||
#define FT_LONG64 |
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
/************************************************************************** |
||||
* |
||||
* A 64-bit data type may create compilation problems if you compile in |
||||
* strict ANSI mode. To avoid them, we disable other 64-bit data types if |
||||
* `__STDC__` is defined. You can however ignore this rule by defining the |
||||
* `FT_CONFIG_OPTION_FORCE_INT64` configuration macro. |
||||
*/ |
||||
#elif !defined( __STDC__ ) || defined( FT_CONFIG_OPTION_FORCE_INT64 ) |
||||
|
||||
#if defined( __STDC_VERSION__ ) && __STDC_VERSION__ >= 199901L |
||||
|
||||
#define FT_LONG64 |
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#elif defined( _MSC_VER ) && _MSC_VER >= 900 /* Visual C++ (and Intel C++) */ |
||||
|
||||
/* this compiler provides the `__int64` type */ |
||||
#define FT_LONG64 |
||||
#define FT_INT64 __int64 |
||||
#define FT_UINT64 unsigned __int64 |
||||
|
||||
#elif defined( __BORLANDC__ ) /* Borland C++ */ |
||||
|
||||
/* XXXX: We should probably check the value of `__BORLANDC__` in order */ |
||||
/* to test the compiler version. */ |
||||
|
||||
/* this compiler provides the `__int64` type */ |
||||
#define FT_LONG64 |
||||
#define FT_INT64 __int64 |
||||
#define FT_UINT64 unsigned __int64 |
||||
|
||||
#elif defined( __WATCOMC__ ) /* Watcom C++ */ |
||||
|
||||
/* Watcom doesn't provide 64-bit data types */ |
||||
|
||||
#elif defined( __MWERKS__ ) /* Metrowerks CodeWarrior */ |
||||
|
||||
#define FT_LONG64 |
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#elif defined( __GNUC__ ) |
||||
|
||||
/* GCC provides the `long long` type */ |
||||
#define FT_LONG64 |
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#endif /* __STDC_VERSION__ >= 199901L */ |
||||
|
||||
#endif /* FT_SIZEOF_LONG == 8 */ |
||||
|
||||
#ifdef FT_LONG64 |
||||
typedef FT_INT64 FT_Int64; |
||||
typedef FT_UINT64 FT_UInt64; |
||||
#endif |
||||
|
||||
|
||||
#ifdef _WIN64 |
||||
/* only 64bit Windows uses the LLP64 data model, i.e., */ |
||||
/* 32bit integers, 64bit pointers */ |
||||
#define FT_UINT_TO_POINTER( x ) (void*)(unsigned __int64)(x) |
||||
#else |
||||
#define FT_UINT_TO_POINTER( x ) (void*)(unsigned long)(x) |
||||
#endif |
||||
|
||||
|
||||
/************************************************************************** |
||||
* |
||||
* miscellaneous |
||||
* |
||||
*/ |
||||
|
||||
|
||||
#define FT_BEGIN_STMNT do { |
||||
#define FT_END_STMNT } while ( 0 ) |
||||
#define FT_DUMMY_STMNT FT_BEGIN_STMNT FT_END_STMNT |
||||
|
||||
|
||||
/* `typeof` condition taken from gnulib's `intprops.h` header file */ |
||||
#if ( ( defined( __GNUC__ ) && __GNUC__ >= 2 ) || \ |
||||
( defined( __IBMC__ ) && __IBMC__ >= 1210 && \ |
||||
defined( __IBM__TYPEOF__ ) ) || \ |
||||
( defined( __SUNPRO_C ) && __SUNPRO_C >= 0x5110 && !__STDC__ ) ) |
||||
#define FT_TYPEOF( type ) ( __typeof__ ( type ) ) |
||||
#else |
||||
#define FT_TYPEOF( type ) /* empty */ |
||||
#endif |
||||
|
||||
|
||||
/* Use `FT_LOCAL` and `FT_LOCAL_DEF` to declare and define, */ |
||||
/* respectively, a function that gets used only within the scope of a */ |
||||
/* module. Normally, both the header and source code files for such a */ |
||||
/* function are within a single module directory. */ |
||||
/* */ |
||||
/* Intra-module arrays should be tagged with `FT_LOCAL_ARRAY` and */ |
||||
/* `FT_LOCAL_ARRAY_DEF`. */ |
||||
/* */ |
||||
#ifdef FT_MAKE_OPTION_SINGLE_OBJECT |
||||
|
||||
#define FT_LOCAL( x ) static x |
||||
#define FT_LOCAL_DEF( x ) static x |
||||
|
||||
#else |
||||
|
||||
#ifdef __cplusplus |
||||
#define FT_LOCAL( x ) extern "C" x |
||||
#define FT_LOCAL_DEF( x ) extern "C" x |
||||
#else |
||||
#define FT_LOCAL( x ) extern x |
||||
#define FT_LOCAL_DEF( x ) x |
||||
#endif |
||||
|
||||
#endif /* FT_MAKE_OPTION_SINGLE_OBJECT */ |
||||
|
||||
#define FT_LOCAL_ARRAY( x ) extern const x |
||||
#define FT_LOCAL_ARRAY_DEF( x ) const x |
||||
|
||||
|
||||
/* Use `FT_BASE` and `FT_BASE_DEF` to declare and define, respectively, */ |
||||
/* functions that are used in more than a single module. In the */ |
||||
/* current setup this implies that the declaration is in a header file */ |
||||
/* in the `include/freetype/internal` directory, and the function body */ |
||||
/* is in a file in `src/base`. */ |
||||
/* */ |
||||
#ifndef FT_BASE |
||||
|
||||
#ifdef __cplusplus |
||||
#define FT_BASE( x ) extern "C" x |
||||
#else |
||||
#define FT_BASE( x ) extern x |
||||
#endif |
||||
|
||||
#endif /* !FT_BASE */ |
||||
|
||||
|
||||
#ifndef FT_BASE_DEF |
||||
|
||||
#ifdef __cplusplus |
||||
#define FT_BASE_DEF( x ) x |
||||
#else |
||||
#define FT_BASE_DEF( x ) x |
||||
#endif |
||||
|
||||
#endif /* !FT_BASE_DEF */ |
||||
|
||||
|
||||
/* When compiling FreeType as a DLL or DSO with hidden visibility */ |
||||
/* some systems/compilers need a special attribute in front OR after */ |
||||
/* the return type of function declarations. */ |
||||
/* */ |
||||
/* Two macros are used within the FreeType source code to define */ |
||||
/* exported library functions: `FT_EXPORT` and `FT_EXPORT_DEF`. */ |
||||
/* */ |
||||
/* - `FT_EXPORT( return_type )` */ |
||||
/* */ |
||||
/* is used in a function declaration, as in */ |
||||
/* */ |
||||
/* ``` */ |
||||
/* FT_EXPORT( FT_Error ) */ |
||||
/* FT_Init_FreeType( FT_Library* alibrary ); */ |
||||
/* ``` */ |
||||
/* */ |
||||
/* - `FT_EXPORT_DEF( return_type )` */ |
||||
/* */ |
||||
/* is used in a function definition, as in */ |
||||
/* */ |
||||
/* ``` */ |
||||
/* FT_EXPORT_DEF( FT_Error ) */ |
||||
/* FT_Init_FreeType( FT_Library* alibrary ) */ |
||||
/* { */ |
||||
/* ... some code ... */ |
||||
/* return FT_Err_Ok; */ |
||||
/* } */ |
||||
/* ``` */ |
||||
/* */ |
||||
/* You can provide your own implementation of `FT_EXPORT` and */ |
||||
/* `FT_EXPORT_DEF` here if you want. */ |
||||
/* */ |
||||
/* To export a variable, use `FT_EXPORT_VAR`. */ |
||||
/* */ |
||||
#ifndef FT_EXPORT |
||||
|
||||
#ifdef FT2_BUILD_LIBRARY |
||||
|
||||
#if defined( _WIN32 ) && defined( DLL_EXPORT ) |
||||
#define FT_EXPORT( x ) __declspec( dllexport ) x |
||||
#elif defined( __GNUC__ ) && __GNUC__ >= 4 |
||||
#define FT_EXPORT( x ) __attribute__(( visibility( "default" ) )) x |
||||
#elif defined( __SUNPRO_C ) && __SUNPRO_C >= 0x550 |
||||
#define FT_EXPORT( x ) __global x |
||||
#elif defined( __cplusplus ) |
||||
#define FT_EXPORT( x ) extern "C" x |
||||
#else |
||||
#define FT_EXPORT( x ) extern x |
||||
#endif |
||||
|
||||
#else |
||||
|
||||
#if defined( _WIN32 ) && defined( DLL_IMPORT ) |
||||
#define FT_EXPORT( x ) __declspec( dllimport ) x |
||||
#elif defined( __cplusplus ) |
||||
#define FT_EXPORT( x ) extern "C" x |
||||
#else |
||||
#define FT_EXPORT( x ) extern x |
||||
#endif |
||||
|
||||
#endif |
||||
|
||||
#endif /* !FT_EXPORT */ |
||||
|
||||
|
||||
#ifndef FT_EXPORT_DEF |
||||
|
||||
#ifdef __cplusplus |
||||
#define FT_EXPORT_DEF( x ) extern "C" x |
||||
#else |
||||
#define FT_EXPORT_DEF( x ) extern x |
||||
#endif |
||||
|
||||
#endif /* !FT_EXPORT_DEF */ |
||||
|
||||
|
||||
#ifndef FT_EXPORT_VAR |
||||
|
||||
#ifdef __cplusplus |
||||
#define FT_EXPORT_VAR( x ) extern "C" x |
||||
#else |
||||
#define FT_EXPORT_VAR( x ) extern x |
||||
#endif |
||||
|
||||
#endif /* !FT_EXPORT_VAR */ |
||||
|
||||
|
||||
/* The following macros are needed to compile the library with a */ |
||||
/* C++ compiler and with 16bit compilers. */ |
||||
/* */ |
||||
|
||||
/* This is special. Within C++, you must specify `extern "C"` for */ |
||||
/* functions which are used via function pointers, and you also */ |
||||
/* must do that for structures which contain function pointers to */ |
||||
/* assure C linkage -- it's not possible to have (local) anonymous */ |
||||
/* functions which are accessed by (global) function pointers. */ |
||||
/* */ |
||||
/* */ |
||||
/* FT_CALLBACK_DEF is used to _define_ a callback function, */ |
||||
/* located in the same source code file as the structure that uses */ |
||||
/* it. */ |
||||
/* */ |
||||
/* FT_BASE_CALLBACK and FT_BASE_CALLBACK_DEF are used to declare */ |
||||
/* and define a callback function, respectively, in a similar way */ |
||||
/* as FT_BASE and FT_BASE_DEF work. */ |
||||
/* */ |
||||
/* FT_CALLBACK_TABLE is used to _declare_ a constant variable that */ |
||||
/* contains pointers to callback functions. */ |
||||
/* */ |
||||
/* FT_CALLBACK_TABLE_DEF is used to _define_ a constant variable */ |
||||
/* that contains pointers to callback functions. */ |
||||
/* */ |
||||
/* */ |
||||
/* Some 16bit compilers have to redefine these macros to insert */ |
||||
/* the infamous `_cdecl` or `__fastcall` declarations. */ |
||||
/* */ |
||||
#ifndef FT_CALLBACK_DEF |
||||
#ifdef __cplusplus |
||||
#define FT_CALLBACK_DEF( x ) extern "C" x |
||||
#else |
||||
#define FT_CALLBACK_DEF( x ) static x |
||||
#endif |
||||
#endif /* FT_CALLBACK_DEF */ |
||||
|
||||
#ifndef FT_BASE_CALLBACK |
||||
#ifdef __cplusplus |
||||
#define FT_BASE_CALLBACK( x ) extern "C" x |
||||
#define FT_BASE_CALLBACK_DEF( x ) extern "C" x |
||||
#else |
||||
#define FT_BASE_CALLBACK( x ) extern x |
||||
#define FT_BASE_CALLBACK_DEF( x ) x |
||||
#endif |
||||
#endif /* FT_BASE_CALLBACK */ |
||||
|
||||
#ifndef FT_CALLBACK_TABLE |
||||
#ifdef __cplusplus |
||||
#define FT_CALLBACK_TABLE extern "C" |
||||
#define FT_CALLBACK_TABLE_DEF extern "C" |
||||
#else |
||||
#define FT_CALLBACK_TABLE extern |
||||
#define FT_CALLBACK_TABLE_DEF /* nothing */ |
||||
#endif |
||||
#endif /* FT_CALLBACK_TABLE */ |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
|
||||
#endif /* FTCONFIG_H_ */ |
||||
|
||||
|
||||
/* END */ |
@ -0,0 +1,245 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* config/integer-types.h |
||||
* |
||||
* FreeType integer types definitions. |
||||
* |
||||
* Copyright (C) 1996-2020 by |
||||
* David Turner, Robert Wilhelm, and Werner Lemberg. |
||||
* |
||||
* This file is part of the FreeType project, and may only be used, |
||||
* modified, and distributed under the terms of the FreeType project |
||||
* license, LICENSE.TXT. By continuing to use, modify, or distribute |
||||
* this file you indicate that you have read the license and |
||||
* understand and accept it fully. |
||||
* |
||||
*/ |
||||
#ifndef FREETYPE_CONFIG_INTEGER_TYPES_H_ |
||||
#define FREETYPE_CONFIG_INTEGER_TYPES_H_ |
||||
|
||||
/* There are systems (like the Texas Instruments 'C54x) where a `char` */ |
||||
/* has 16~bits. ANSI~C says that `sizeof(char)` is always~1. Since an */ |
||||
/* `int` has 16~bits also for this system, `sizeof(int)` gives~1 which */ |
||||
/* is probably unexpected. */ |
||||
/* */ |
||||
/* `CHAR_BIT` (defined in `limits.h`) gives the number of bits in a */ |
||||
/* `char` type. */ |
||||
|
||||
#ifndef FT_CHAR_BIT |
||||
#define FT_CHAR_BIT CHAR_BIT |
||||
#endif |
||||
|
||||
#ifndef FT_SIZEOF_INT |
||||
|
||||
/* The size of an `int` type. */ |
||||
#if FT_UINT_MAX == 0xFFFFUL |
||||
#define FT_SIZEOF_INT ( 16 / FT_CHAR_BIT ) |
||||
#elif FT_UINT_MAX == 0xFFFFFFFFUL |
||||
#define FT_SIZEOF_INT ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_UINT_MAX > 0xFFFFFFFFUL && FT_UINT_MAX == 0xFFFFFFFFFFFFFFFFUL |
||||
#define FT_SIZEOF_INT ( 64 / FT_CHAR_BIT ) |
||||
#else |
||||
#error "Unsupported size of `int' type!" |
||||
#endif |
||||
|
||||
#endif /* !defined(FT_SIZEOF_INT) */ |
||||
|
||||
#ifndef FT_SIZEOF_LONG |
||||
|
||||
/* The size of a `long` type. A five-byte `long` (as used e.g. on the */ |
||||
/* DM642) is recognized but avoided. */ |
||||
#if FT_ULONG_MAX == 0xFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_ULONG_MAX > 0xFFFFFFFFUL && FT_ULONG_MAX == 0xFFFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 32 / FT_CHAR_BIT ) |
||||
#elif FT_ULONG_MAX > 0xFFFFFFFFUL && FT_ULONG_MAX == 0xFFFFFFFFFFFFFFFFUL |
||||
#define FT_SIZEOF_LONG ( 64 / FT_CHAR_BIT ) |
||||
#else |
||||
#error "Unsupported size of `long' type!" |
||||
#endif |
||||
|
||||
#endif /* !defined(FT_SIZEOF_LONG) */ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @section: |
||||
* basic_types |
||||
* |
||||
*/ |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Int16 |
||||
* |
||||
* @description: |
||||
* A typedef for a 16bit signed integer type. |
||||
*/ |
||||
typedef signed short FT_Int16; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UInt16 |
||||
* |
||||
* @description: |
||||
* A typedef for a 16bit unsigned integer type. |
||||
*/ |
||||
typedef unsigned short FT_UInt16; |
||||
|
||||
/* */ |
||||
|
||||
|
||||
/* this #if 0 ... #endif clause is for documentation purposes */ |
||||
#if 0 |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Int32 |
||||
* |
||||
* @description: |
||||
* A typedef for a 32bit signed integer type. The size depends on the |
||||
* configuration. |
||||
*/ |
||||
typedef signed XXX FT_Int32; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UInt32 |
||||
* |
||||
* A typedef for a 32bit unsigned integer type. The size depends on the |
||||
* configuration. |
||||
*/ |
||||
typedef unsigned XXX FT_UInt32; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_Int64 |
||||
* |
||||
* A typedef for a 64bit signed integer type. The size depends on the |
||||
* configuration. Only defined if there is real 64bit support; |
||||
* otherwise, it gets emulated with a structure (if necessary). |
||||
*/ |
||||
typedef signed XXX FT_Int64; |
||||
|
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* @type: |
||||
* FT_UInt64 |
||||
* |
||||
* A typedef for a 64bit unsigned integer type. The size depends on the |
||||
* configuration. Only defined if there is real 64bit support; |
||||
* otherwise, it gets emulated with a structure (if necessary). |
||||
*/ |
||||
typedef unsigned XXX FT_UInt64; |
||||
|
||||
/* */ |
||||
|
||||
#endif |
||||
|
||||
#if FT_SIZEOF_INT == ( 32 / FT_CHAR_BIT ) |
||||
|
||||
typedef signed int FT_Int32; |
||||
typedef unsigned int FT_UInt32; |
||||
|
||||
#elif FT_SIZEOF_LONG == ( 32 / FT_CHAR_BIT ) |
||||
|
||||
typedef signed long FT_Int32; |
||||
typedef unsigned long FT_UInt32; |
||||
|
||||
#else |
||||
#error "no 32bit type found -- please check your configuration files" |
||||
#endif |
||||
|
||||
|
||||
/* look up an integer type that is at least 32~bits */ |
||||
#if FT_SIZEOF_INT >= ( 32 / FT_CHAR_BIT ) |
||||
|
||||
typedef int FT_Fast; |
||||
typedef unsigned int FT_UFast; |
||||
|
||||
#elif FT_SIZEOF_LONG >= ( 32 / FT_CHAR_BIT ) |
||||
|
||||
typedef long FT_Fast; |
||||
typedef unsigned long FT_UFast; |
||||
|
||||
#endif |
||||
|
||||
|
||||
/* determine whether we have a 64-bit `int` type for platforms without */ |
||||
/* Autoconf */ |
||||
#if FT_SIZEOF_LONG == ( 64 / FT_CHAR_BIT ) |
||||
|
||||
/* `FT_LONG64` must be defined if a 64-bit type is available */ |
||||
#define FT_LONG64 |
||||
#define FT_INT64 long |
||||
#define FT_UINT64 unsigned long |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* A 64-bit data type may create compilation problems if you compile in |
||||
* strict ANSI mode. To avoid them, we disable other 64-bit data types if |
||||
* `__STDC__` is defined. You can however ignore this rule by defining the |
||||
* `FT_CONFIG_OPTION_FORCE_INT64` configuration macro. |
||||
*/ |
||||
#elif !defined( __STDC__ ) || defined( FT_CONFIG_OPTION_FORCE_INT64 ) |
||||
|
||||
#if defined( __STDC_VERSION__ ) && __STDC_VERSION__ >= 199901L |
||||
|
||||
#define FT_LONG64 |
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#elif defined( _MSC_VER ) && _MSC_VER >= 900 /* Visual C++ (and Intel C++) */ |
||||
|
||||
/* this compiler provides the `__int64` type */ |
||||
#define FT_LONG64 |
||||
#define FT_INT64 __int64 |
||||
#define FT_UINT64 unsigned __int64 |
||||
|
||||
#elif defined( __BORLANDC__ ) /* Borland C++ */ |
||||
|
||||
/* XXXX: We should probably check the value of `__BORLANDC__` in order */ |
||||
/* to test the compiler version. */ |
||||
|
||||
/* this compiler provides the `__int64` type */ |
||||
#define FT_LONG64 |
||||
#define FT_INT64 __int64 |
||||
#define FT_UINT64 unsigned __int64 |
||||
|
||||
#elif defined( __WATCOMC__ ) /* Watcom C++ */ |
||||
|
||||
/* Watcom doesn't provide 64-bit data types */ |
||||
|
||||
#elif defined( __MWERKS__ ) /* Metrowerks CodeWarrior */ |
||||
|
||||
#define FT_LONG64 |
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#elif defined( __GNUC__ ) |
||||
|
||||
/* GCC provides the `long long` type */ |
||||
#define FT_LONG64 |
||||
#define FT_INT64 long long int |
||||
#define FT_UINT64 unsigned long long int |
||||
|
||||
#endif /* __STDC_VERSION__ >= 199901L */ |
||||
|
||||
#endif /* FT_SIZEOF_LONG == (64 / FT_CHAR_BIT) */ |
||||
|
||||
#ifdef FT_LONG64 |
||||
typedef FT_INT64 FT_Int64; |
||||
typedef FT_UINT64 FT_UInt64; |
||||
#endif |
||||
|
||||
|
||||
#endif /* FREETYPE_CONFIG_INTEGER_TYPES_H_ */ |
@ -0,0 +1,49 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* config/mac-support.h |
||||
* |
||||
* Mac/OS X support configuration header. |
||||
* |
||||
* Copyright (C) 1996-2020 by |
||||
* David Turner, Robert Wilhelm, and Werner Lemberg. |
||||
* |
||||
* This file is part of the FreeType project, and may only be used, |
||||
* modified, and distributed under the terms of the FreeType project |
||||
* license, LICENSE.TXT. By continuing to use, modify, or distribute |
||||
* this file you indicate that you have read the license and |
||||
* understand and accept it fully. |
||||
* |
||||
*/ |
||||
#ifndef FREETYPE_CONFIG_MAC_SUPPORT_H_ |
||||
#define FREETYPE_CONFIG_MAC_SUPPORT_H_ |
||||
|
||||
/**************************************************************************
|
||||
* |
||||
* Mac support |
||||
* |
||||
* This is the only necessary change, so it is defined here instead |
||||
* providing a new configuration file. |
||||
*/ |
||||
#if defined( __APPLE__ ) || ( defined( __MWERKS__ ) && defined( macintosh ) ) |
||||
/* No Carbon frameworks for 64bit 10.4.x. */ |
||||
/* `AvailabilityMacros.h` is available since Mac OS X 10.2, */ |
||||
/* so guess the system version by maximum errno before inclusion. */ |
||||
#include <errno.h> |
||||
#ifdef ECANCELED /* defined since 10.2 */ |
||||
#include "AvailabilityMacros.h" |
||||
#endif |
||||
#if defined( __LP64__ ) && \ |
||||
( MAC_OS_X_VERSION_MIN_REQUIRED <= MAC_OS_X_VERSION_10_4 ) |
||||
#undef FT_MACINTOSH |
||||
#endif |
||||
|
||||
#elif defined( __SC__ ) || defined( __MRC__ ) |
||||
/* Classic MacOS compilers */ |
||||
#include "ConditionalMacros.h" |
||||
#if TARGET_OS_MAC |
||||
#define FT_MACINTOSH 1 |
||||
#endif |
||||
|
||||
#endif /* Mac support */ |
||||
|
||||
#endif /* FREETYPE_CONFIG_MAC_SUPPORT_H_ */ |
@ -0,0 +1,100 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* config/public-macros.h |
||||
* |
||||
* Define a set of compiler macros used in public FreeType headers. |
||||
* |
||||
* Copyright (C) 2020 by |
||||
* David Turner, Robert Wilhelm, and Werner Lemberg. |
||||
* |
||||
* This file is part of the FreeType project, and may only be used, |
||||
* modified, and distributed under the terms of the FreeType project |
||||
* license, LICENSE.TXT. By continuing to use, modify, or distribute |
||||
* this file you indicate that you have read the license and |
||||
* understand and accept it fully. |
||||
* |
||||
*/ |
||||
|
||||
/* The definitions in this file are used by the public FreeType headers,
|
||||
* and thus should be considered part of the public API. |
||||
* |
||||
* Other compiler-specific macro definitions that are not exposed by the |
||||
* FreeType API should go into include/freetype/internal/compiler-macros.h |
||||
* instead. |
||||
*/ |
||||
#ifndef FREETYPE_CONFIG_PUBLIC_MACROS_H_ |
||||
#define FREETYPE_CONFIG_PUBLIC_MACROS_H_ |
||||
|
||||
/* FT_BEGIN_HEADER and FT_END_HEADER might have already been defined by
|
||||
* <freetype/config/ftheader.h>, but we don't want to include this header |
||||
* here, so redefine the macros here only when needed. Their definition is |
||||
* very stable, so keeping them in sync with the ones in the header should |
||||
* not be a maintenance issue. |
||||
*/ |
||||
#ifndef FT_BEGIN_HEADER |
||||
# ifdef __cplusplus |
||||
# define FT_BEGIN_HEADER extern "C" { |
||||
# else |
||||
# define FT_BEGIN_HEADER /* nothing */ |
||||
# endif |
||||
#endif /* FT_END_HEADER */ |
||||
|
||||
#ifndef FT_END_HEADER |
||||
# ifdef __cplusplus |
||||
# define FT_END_HEADER } |
||||
# else |
||||
# define FT_END_HEADER /* nothing */ |
||||
# endif |
||||
#endif /* FT_END_HEADER */ |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/* Mark a function declaration as public. This ensures it will be properly
|
||||
* exported to client code. Place this before a function declaration. |
||||
* |
||||
* NOTE: This macro should be considered an internal implementation detail, and |
||||
* not part of the FreeType API. It is only defined here because it is needed |
||||
* by FT_EXPORT() |
||||
*/ |
||||
#if defined(_WIN32) |
||||
# if defined(FT2_BUILD_LIBRARY) && defined( DLL_EXPORT ) |
||||
# define FT_PUBLIC_FUNCTION_ATTRIBUTE __declspec( dllexport ) |
||||
# elif defined( DLL_IMPORT ) |
||||
# define FT_PUBLIC_FUNCTION_ATTRIBUTE __declspec( dllimport ) |
||||
# endif |
||||
#elif (defined(__GNUC__) && __GNUC__ >= 4) || defined(__clang__) |
||||
# define FT_PUBLIC_FUNCTION_ATTRIBUTE __attribute__((visibility("default"))) |
||||
#elif defined(__SUNPRO_C) && __SUNPRO_C >= 0x550 |
||||
# define FT_PUBLIC_FUNCTION_ATTRIBUTE __global |
||||
#endif |
||||
|
||||
#ifndef FT_PUBLIC_FUNCTION_ATTRIBUTE |
||||
# define FT_PUBLIC_FUNCTION_ATTRIBUTE /* nothing */ |
||||
#endif |
||||
|
||||
/* Define a public FreeType API function. This ensures it is properly exported
|
||||
* or imported at build time. The macro parameter is the function's return type |
||||
* as in: |
||||
* |
||||
* FT_EXPORT( FT_Bool ) FT_Object_Method( FT_Object obj, ... ); |
||||
* |
||||
* NOTE: This requires that all FT_EXPORT() uses are inside FT_BEGIN_HEADER .. |
||||
* FT_END_HEADER blocks. This guarantees that the functions are exported with |
||||
* C linkage, even when the header is included by a C++ source file. |
||||
*/ |
||||
#define FT_EXPORT( x ) FT_PUBLIC_FUNCTION_ATTRIBUTE extern x |
||||
|
||||
/* `FT_UNUSED` indicates that a given parameter is not used -- */ |
||||
/* this is only used to get rid of unpleasant compiler warnings. */ |
||||
/* */ |
||||
/* Technically, this was not meant to be part of the public API, */ |
||||
/* but some third-party code depends on it. */ |
||||
/* */ |
||||
#ifndef FT_UNUSED |
||||
#define FT_UNUSED( arg ) ( (arg) = (arg) ) |
||||
#endif |
||||
|
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* FREETYPE_CONFIG_PUBLIC_MACROS_H_ */ |
@ -0,0 +1,267 @@ |
||||
/****************************************************************************
|
||||
* |
||||
* internal/compiler-macros.h |
||||
* |
||||
* Compiler-specific macro definitions used internally by FreeType. |
||||
* |
||||
* Copyright (C) 2020 by |
||||
* David Turner, Robert Wilhelm, and Werner Lemberg. |
||||
* |
||||
* This file is part of the FreeType project, and may only be used, |
||||
* modified, and distributed under the terms of the FreeType project |
||||
* license, LICENSE.TXT. By continuing to use, modify, or distribute |
||||
* this file you indicate that you have read the license and |
||||
* understand and accept it fully. |
||||
* |
||||
*/ |
||||
|
||||
#ifndef INTERNAL_COMPILER_MACROS_H_ |
||||
#define INTERNAL_COMPILER_MACROS_H_ |
||||
|
||||
#include <freetype/config/public-macros.h> |
||||
|
||||
FT_BEGIN_HEADER |
||||
|
||||
/* Fix compiler warning with sgi compiler. */ |
||||
#if defined( __sgi ) && !defined( __GNUC__ ) |
||||
# if defined( _COMPILER_VERSION ) && ( _COMPILER_VERSION >= 730 ) |
||||
# pragma set woff 3505 |
||||
# endif |
||||
#endif |
||||
|
||||
/* Fix compiler warning with sgi compiler. */ |
||||
#if defined( __sgi ) && !defined( __GNUC__ ) |
||||
# if defined( _COMPILER_VERSION ) && ( _COMPILER_VERSION >= 730 ) |
||||
# pragma set woff 3505 |
||||
# endif |
||||
#endif |
||||
|
||||
/* When defining a macro that expands to a non-trivial C statement, use
|
||||
* FT_BEGIN_STMNT and FT_END_STMNT to enclose the macro's body. This ensures |
||||
* there are no surprises when the macro is invoked in conditional branches. |
||||
* |
||||
* E.g.: |
||||
* #define LOG(...) \
|
||||
* FT_BEGIN_STMNT \
|
||||
* if (logging_enabled) \
|
||||
* log(__VA_ARGS__); \
|
||||
* FT_END_STMNT |
||||
*/ |
||||
#define FT_BEGIN_STMNT do { |
||||
#define FT_END_STMNT } while ( 0 ) |
||||
|
||||
/* FT_DUMMY_STMNT expands to an empty C statement. Useful for conditionally
|
||||
* define statement macros, as in: |
||||
* |
||||
* #ifdef BUILD_CONFIG_LOGGING |
||||
* # define LOG(...) \
|
||||
* FT_BEGIN_STMNT \
|
||||
* if (logging_enabled) \
|
||||
* log(__VA_ARGS__); \
|
||||
* FT_END_STMNT |
||||
* #else |
||||
* # define LOG(...) FT_DUMMY_STMNT |
||||
* #endif |
||||
*/ |
||||
#define FT_DUMMY_STMNT FT_BEGIN_STMNT FT_END_STMNT |
||||
|
||||
#ifdef _WIN64 |
||||
/* only 64bit Windows uses the LLP64 data model, i.e., */ |
||||
/* 32-bit integers, 64-bit pointers. */ |
||||
#define FT_UINT_TO_POINTER( x ) (void*)(unsigned __int64)(x) |
||||
#else |
||||
#define FT_UINT_TO_POINTER( x ) (void*)(unsigned long)(x) |
||||
#endif |
||||
|
||||
/* Use FT_TYPEOF(type) to cast a value to |type|. This is useful to suppress
|
||||
* signedness compilation warnings in macros as in: |
||||
* |
||||
* #define PAD_(x, n) ( (x) & ~FT_TYPEOF( x )( (n) - 1 ) ) |
||||
* |
||||
* `typeof` condition taken from gnulib's `intprops.h` header file |
||||
*/ |
||||
#if ( ( defined( __GNUC__ ) && __GNUC__ >= 2 ) || \ |
||||
( defined( __IBMC__ ) && __IBMC__ >= 1210 && \
|
||||
defined( __IBM__TYPEOF__ ) ) || \
|
||||
( defined( __SUNPRO_C ) && __SUNPRO_C >= 0x5110 && !__STDC__ ) ) |
||||
#define FT_TYPEOF( type ) ( __typeof__ ( type ) ) |
||||
#else |
||||
#define FT_TYPEOF( type ) /* empty */ |
||||
#endif |
||||
|
||||
/* Mark a function declaration as internal to the library. This ensures that
|
||||
* it will not be exposed by default to client code, and helps generate smaller |
||||
* and faster code on ELF-based platforms. Place this before a function |
||||
* declaration. |
||||
*/ |
||||
#if (defined(__GNUC__) && __GNUC__ >= 4) || defined(__clang__) |
||||
#define FT_INTERNAL_FUNCTION_ATTRIBUTE __attribute__((visibility("hidden"))) |
||||
#else |
||||
#define FT_INTERNAL_FUNCTION_ATTRIBUTE /* nothing */ |
||||
#endif |
||||
|
||||
/* FreeType supports compiling its C sources to be compiled as C++ instead,
|
||||
* this introduces a number of subtle issues. |
||||
* |
||||
* The main one is that a C++ function declaration and its definition must have |
||||
* the same 'linkage'. Because all FreeType headers declare their function with |
||||
* C linkage (i.e. within an extern "C" { .. } block, due to the magic of |
||||
* FT_BEGIN_HEADER and FT_END_HEADER), then their definition in FreeType |
||||
* sources should also be prefixed with 'extern "C"' when compiled in C++ mode. |
||||
* |
||||
* The FT_FUNCTION_DECLARATION() and FT_FUNCTION_DEFINITION() macros are |
||||
* provided to deal with this case, as well as FT_CALLBACK_DEF et al below. |
||||
*/ |
||||
|
||||
/* FT_FUNCTION_DECLARATION(type) can be used to write a C function declaration,
|
||||
* and ensure it will have C linkage when the library is built with a C++ |
||||
* compiler. The parameter is the function's return type, so a declaration |
||||
* would look like: |
||||
* |
||||
* FT_FUNCTION_DECLARATION(int) foo(int x); |
||||
* |
||||
* NOTE: This requires that all uses are inside FT_BEGIN_HEADER..FT_END_HEADER |
||||
* blocks. Which guarantees that the declarations have C linkage when the |
||||
* headers are included by C++ sources. |
||||
* |
||||
* NOTE: Do not use directly, use FT_LOCAL()/FT_BASE()/FT_EXPORT() instead. |
||||
*/ |
||||
#define FT_FUNCTION_DECLARATION( x ) extern x |
||||
|
||||
/* Same as FT_FUNCTION_DECLARATION(), but for function definitions instead.
|
||||
* NOTE: Do not use directly, use FT_LOCAL_DEF()/FT_BASE_DEF()/FT_EXPORT_DEF() |
||||
* instead. |
||||
*/ |
||||
#ifdef __cplusplus |
||||
#define FT_FUNCTION_DEFINITION( x ) extern "C" x |
||||
#else |
||||
#define FT_FUNCTION_DEFINITION( x ) x |
||||
#endif |
||||
|
||||
/* Use FT_LOCAL()/FT_LOCAL_DEF() to declare and define an internal FreeType
|
||||
* function that is only used by the sources of a single src/module/ directory. |
||||
* This ensures the functions are turned into static ones at build time, |
||||
* resulting in smaller and faster code. |
||||
*/ |
||||
#ifdef FT_MAKE_OPTION_SINGLE_OBJECT |
||||
|
||||
# define FT_LOCAL( x ) static x |
||||
# define FT_LOCAL_DEF( x ) static x |
||||
|
||||
#else |
||||
|
||||
#define FT_LOCAL( x ) FT_INTERNAL_FUNCTION_ATTRIBUTE FT_FUNCTION_DECLARATION( x ) |
||||
#define FT_LOCAL_DEF( x ) FT_FUNCTION_DEFINITION( x ) |
||||
|
||||
#endif /* FT_MAKE_OPTION_SINGLE_OBJECT */ |
||||
|
||||
/* Use FT_LOCAL_ARRAY()/FT_LOCAL_ARRAY_DEF() to declare and define a constant
|
||||
* array that must be accessed from several sources in the same src/module/ |
||||
* sub-directory, but are otherwise internal to the library. |
||||
*/ |
||||
#define FT_LOCAL_ARRAY( x ) FT_INTERNAL_FUNCTION_ATTRIBUTE extern const x |
||||
#define FT_LOCAL_ARRAY_DEF( x ) FT_FUNCTION_DEFINITION( const x ) |
||||
|
||||
/* Use FT_BASE()/FT_BASE_DEF() to declare or define an internal library
|
||||
* function that are used by more than one single module. |
||||
*/ |
||||
#define FT_BASE( x ) FT_INTERNAL_FUNCTION_ATTRIBUTE FT_FUNCTION_DECLARATION( x ) |
||||
#define FT_BASE_DEF( x ) FT_FUNCTION_DEFINITION( x ) |
||||
|
||||
|
||||
/* NOTE: Conditionally define FT_EXPORT_VAR() due to its definition in
|
||||
* src/smooth/ftgrays.h to make the header more portable. |
||||
*/ |
||||
#ifndef FT_EXPORT_VAR |
||||
#define FT_EXPORT_VAR( x ) FT_FUNCTION_DECLARATION( x ) |
||||
#endif |
||||
|
||||
/* When compiling FreeType as a DLL or DSO with hidden visibility */ |
||||
/* some systems/compilers need a special attribute in front OR after */ |
||||
/* the return type of function declarations. */ |
||||
/* */ |
||||
/* Two macros are used within the FreeType source code to define */ |
||||
/* exported library functions: `FT_EXPORT` and `FT_EXPORT_DEF`. */ |
||||
/* */ |
||||
/* - `FT_EXPORT( return_type )` */ |
||||
/* */ |
||||
/* is used in a function declaration, as in */ |
||||
/* */ |
||||
/* ``` */ |
||||
/* FT_EXPORT( FT_Error ) */ |
||||
/* FT_Init_FreeType( FT_Library* alibrary ); */ |
||||
/* ``` */ |
||||
/* */ |
||||
/* - `FT_EXPORT_DEF( return_type )` */ |
||||
/* */ |
||||
/* is used in a function definition, as in */ |
||||
/* */ |
||||
/* ``` */ |
||||
/* FT_EXPORT_DEF( FT_Error ) */ |
||||
/* FT_Init_FreeType( FT_Library* alibrary ) */ |
||||
/* { */ |
||||
/* ... some code ... */ |
||||
/* return FT_Err_Ok; */ |
||||
/* } */ |
||||
/* ``` */ |
||||
/* */ |
||||
/* You can provide your own implementation of `FT_EXPORT` and */ |
||||
/* `FT_EXPORT_DEF` here if you want. */ |
||||
/* */ |
||||
/* To export a variable, use `FT_EXPORT_VAR`. */ |
||||
/* */ |
||||
|
||||
/* See <freetype/config/compiler_macros.h> for the FT_EXPORT() definition */ |
||||
#define FT_EXPORT_DEF( x ) FT_FUNCTION_DEFINITION( x ) |
||||
|
||||
/* The following macros are needed to compile the library with a */ |
||||
/* C++ compiler and with 16bit compilers. */ |
||||
/* */ |
||||
|
||||
/* This is special. Within C++, you must specify `extern "C"` for */ |
||||
/* functions which are used via function pointers, and you also */ |
||||
/* must do that for structures which contain function pointers to */ |
||||
/* assure C linkage -- it's not possible to have (local) anonymous */ |
||||
/* functions which are accessed by (global) function pointers. */ |
||||
/* */ |
||||
/* */ |
||||
/* FT_CALLBACK_DEF is used to _define_ a callback function, */ |
||||
/* located in the same source code file as the structure that uses */ |
||||
/* it. */ |
||||
/* */ |
||||
/* FT_BASE_CALLBACK and FT_BASE_CALLBACK_DEF are used to declare */ |
||||
/* and define a callback function, respectively, in a similar way */ |
||||
/* as FT_BASE and FT_BASE_DEF work. */ |
||||
/* */ |
||||
/* FT_CALLBACK_TABLE is used to _declare_ a constant variable that */ |
||||
/* contains pointers to callback functions. */ |
||||
/* */ |
||||
/* FT_CALLBACK_TABLE_DEF is used to _define_ a constant variable */ |
||||
/* that contains pointers to callback functions. */ |
||||
/* */ |
||||
/* */ |
||||
/* Some 16bit compilers have to redefine these macros to insert */ |
||||
/* the infamous `_cdecl` or `__fastcall` declarations. */ |
||||
/* */ |
||||
#ifdef __cplusplus |
||||
#define FT_CALLBACK_DEF( x ) extern "C" x |
||||
#else |
||||
#define FT_CALLBACK_DEF( x ) static x |
||||
#endif |
||||
|
||||
#define FT_BASE_CALLBACK( x ) FT_FUNCTION_DECLARATION( x ) |
||||
#define FT_BASE_CALLBACK_DEF( x ) FT_FUNCTION_DEFINITION( x ) |
||||
|
||||
#ifndef FT_CALLBACK_TABLE |
||||
#ifdef __cplusplus |
||||
#define FT_CALLBACK_TABLE extern "C" |
||||
#define FT_CALLBACK_TABLE_DEF extern "C" |
||||
#else |
||||
#define FT_CALLBACK_TABLE extern |
||||
#define FT_CALLBACK_TABLE_DEF /* nothing */ |
||||
#endif |
||||
#endif /* FT_CALLBACK_TABLE */ |
||||
|
||||
FT_END_HEADER |
||||
|
||||
#endif /* INTERNAL_COMPILER_MACROS_H_ */ |
Loading…
Reference in new issue