8285686: Upgrade to FreeType 2.12.0
Reviewed-by: serb, jdv
This commit is contained in:
parent
64225e1999
commit
67dd8a8d6a
@ -1,4 +1,4 @@
|
||||
## The FreeType Project: Freetype v2.10.4
|
||||
## The FreeType Project: Freetype v2.12.0
|
||||
|
||||
|
||||
### FreeType Notice
|
||||
|
@ -30,6 +30,6 @@ src/java.desktop/share/legal/freetype.md
|
||||
|
||||
When updating specify --with-freetype=bundled to test builds to
|
||||
expose build issues.
|
||||
This is important because presently on Linux and Solaris the build
|
||||
This is important because presently on Linux the build
|
||||
defaults to linking against the system library and does not attempt
|
||||
to compile the sources.
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* ANSI-specific configuration file (specification only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Build macros of the FreeType 2 library.
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -777,6 +777,18 @@
|
||||
#define FT_COLOR_H <freetype/ftcolor.h>
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @macro:
|
||||
* FT_OTSVG_H
|
||||
*
|
||||
* @description:
|
||||
* A macro used in `#include` statements to name the file containing the
|
||||
* FreeType~2 API which handles the OpenType 'SVG~' glyphs.
|
||||
*/
|
||||
#define FT_OTSVG_H <freetype/otsvg.h>
|
||||
|
||||
|
||||
/* */
|
||||
|
||||
/* These header files don't need to be included by the user. */
|
||||
|
@ -19,12 +19,15 @@ FT_USE_MODULE( FT_Driver_ClassRec, t1cid_driver_class )
|
||||
// FT_USE_MODULE( FT_Driver_ClassRec, t42_driver_class )
|
||||
// FT_USE_MODULE( FT_Driver_ClassRec, winfnt_driver_class )
|
||||
// FT_USE_MODULE( FT_Driver_ClassRec, pcf_driver_class )
|
||||
// FT_USE_MODULE( FT_Driver_ClassRec, bdf_driver_class )
|
||||
FT_USE_MODULE( FT_Module_Class, psaux_module_class )
|
||||
FT_USE_MODULE( FT_Module_Class, psnames_module_class )
|
||||
FT_USE_MODULE( FT_Module_Class, pshinter_module_class )
|
||||
FT_USE_MODULE( FT_Renderer_Class, ft_raster1_renderer_class )
|
||||
FT_USE_MODULE( FT_Module_Class, sfnt_module_class )
|
||||
FT_USE_MODULE( FT_Renderer_Class, ft_smooth_renderer_class )
|
||||
// FT_USE_MODULE( FT_Driver_ClassRec, bdf_driver_class )
|
||||
FT_USE_MODULE( FT_Renderer_Class, ft_raster1_renderer_class )
|
||||
// FT_USE_MODULE( FT_Renderer_Class, ft_sdf_renderer_class )
|
||||
// FT_USE_MODULE( FT_Renderer_Class, ft_bitmap_sdf_renderer_class )
|
||||
// FT_USE_MODULE( FT_Renderer_Class, ft_svg_renderer_class )
|
||||
|
||||
/* EOF */
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* User-selectable configuration macros (specification only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -105,8 +105,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* ```
|
||||
* FREETYPE_PROPERTIES=truetype:interpreter-version=35 \
|
||||
* cff:no-stem-darkening=1 \
|
||||
* autofitter:warping=1
|
||||
* cff:no-stem-darkening=1
|
||||
* ```
|
||||
*
|
||||
*/
|
||||
@ -220,6 +219,10 @@ FT_BEGIN_HEADER
|
||||
* If you use a build system like cmake or the `configure` script,
|
||||
* options set by those programs have precedence, overwriting the value
|
||||
* here with the configured one.
|
||||
*
|
||||
* If you use the GNU make build system directly (that is, without the
|
||||
* `configure` script) and you define this macro, you also have to pass
|
||||
* `SYSTEM_ZLIB=yes` as an argument to make.
|
||||
*/
|
||||
/* #define FT_CONFIG_OPTION_SYSTEM_ZLIB */
|
||||
|
||||
@ -431,6 +434,23 @@ FT_BEGIN_HEADER
|
||||
/* #define FT_DEBUG_LEVEL_TRACE */
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* Logging
|
||||
*
|
||||
* Compiling FreeType in debug or trace mode makes FreeType write error
|
||||
* and trace log messages to `stderr`. Enabling this macro
|
||||
* automatically forces the `FT_DEBUG_LEVEL_ERROR` and
|
||||
* `FT_DEBUG_LEVEL_TRACE` macros and allows FreeType to write error and
|
||||
* trace log messages to a file instead of `stderr`. For writing logs
|
||||
* to a file, FreeType uses an the external `dlg` library (the source
|
||||
* code is in `src/dlg`).
|
||||
*
|
||||
* This option needs a C99 compiler.
|
||||
*/
|
||||
/* #define FT_DEBUG_LOGGING */
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* Autofitter debugging
|
||||
@ -507,6 +527,20 @@ FT_BEGIN_HEADER
|
||||
#undef FT_CONFIG_OPTION_USE_MODULE_ERRORS
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* OpenType SVG Glyph Support
|
||||
*
|
||||
* Setting this macro enables support for OpenType SVG glyphs. By
|
||||
* default, FreeType can only fetch SVG documents. However, it can also
|
||||
* render them if external rendering hook functions are plugged in at
|
||||
* runtime.
|
||||
*
|
||||
* More details on the hooks can be found in file `otsvg.h`.
|
||||
*/
|
||||
/* #define FT_CONFIG_OPTION_SVG */
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* Error Strings
|
||||
@ -892,24 +926,6 @@ FT_BEGIN_HEADER
|
||||
#endif
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* Compile 'autofit' module with warp hinting. The idea of the warping
|
||||
* code is to slightly scale and shift a glyph within a single dimension so
|
||||
* that as much of its segments are aligned (more or less) on the grid. To
|
||||
* find out the optimal scaling and shifting value, various parameter
|
||||
* combinations are tried and scored.
|
||||
*
|
||||
* You can switch warping on and off with the `warping` property of the
|
||||
* auto-hinter (see file `ftdriver.h` for more information; by default it
|
||||
* is switched off).
|
||||
*
|
||||
* This experimental option is not active if the rendering mode is
|
||||
* `FT_RENDER_MODE_LIGHT`.
|
||||
*/
|
||||
#define AF_CONFIG_OPTION_USE_WARPER
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* Use TrueType-like size metrics for 'light' auto-hinting.
|
||||
@ -961,6 +977,21 @@ FT_BEGIN_HEADER
|
||||
#endif
|
||||
|
||||
|
||||
/*
|
||||
* The TT_SUPPORT_COLRV1 macro is defined to indicate to clients that this
|
||||
* version of FreeType has support for 'COLR' v1 API. This definition is
|
||||
* useful to FreeType clients that want to build in support for 'COLR' v1
|
||||
* depending on a tip-of-tree checkout before it is officially released in
|
||||
* FreeType, and while the feature cannot yet be tested against using
|
||||
* version macros. Don't change this macro. This may be removed once the
|
||||
* feature is in a FreeType release version and version macros can be used
|
||||
* to test for availability.
|
||||
*/
|
||||
#ifdef TT_CONFIG_OPTION_COLOR_LAYERS
|
||||
#define TT_SUPPORT_COLRV1
|
||||
#endif
|
||||
|
||||
|
||||
/*
|
||||
* Check CFF darkening parameters. The checks are the same as in function
|
||||
* `cff_property_set` in file `cffdrivr.c`.
|
||||
@ -989,8 +1020,8 @@ FT_BEGIN_HEADER
|
||||
#error "Invalid CFF darkening parameters!"
|
||||
#endif
|
||||
|
||||
FT_END_HEADER
|
||||
|
||||
FT_END_HEADER
|
||||
|
||||
#endif /* FTOPTION_H_ */
|
||||
|
||||
|
@ -5,7 +5,7 @@
|
||||
* ANSI-specific library and header configuration file (specification
|
||||
* only).
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -43,7 +43,8 @@
|
||||
*
|
||||
* `UINT_MAX` and `ULONG_MAX` are used to automatically compute the size of
|
||||
* `int` and `long` in bytes at compile-time. So far, this works for all
|
||||
* platforms the library has been tested on.
|
||||
* platforms the library has been tested on. We also check `ULLONG_MAX`
|
||||
* to see whether we can use 64-bit `long long` later on.
|
||||
*
|
||||
* Note that on the extremely rare platforms that do not provide integer
|
||||
* types that are _exactly_ 16 and 32~bits wide (e.g., some old Crays where
|
||||
@ -66,6 +67,15 @@
|
||||
#define FT_LONG_MIN LONG_MIN
|
||||
#define FT_LONG_MAX LONG_MAX
|
||||
#define FT_ULONG_MAX ULONG_MAX
|
||||
#ifdef LLONG_MAX
|
||||
#define FT_LLONG_MAX LLONG_MAX
|
||||
#endif
|
||||
#ifdef LLONG_MIN
|
||||
#define FT_LLONG_MIN LLONG_MIN
|
||||
#endif
|
||||
#ifdef ULLONG_MAX
|
||||
#define FT_ULLONG_MAX ULLONG_MAX
|
||||
#endif
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType integer types definitions.
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -60,6 +60,18 @@
|
||||
|
||||
#endif /* !defined(FT_SIZEOF_LONG) */
|
||||
|
||||
#ifndef FT_SIZEOF_LONG_LONG
|
||||
|
||||
/* The size of a `long long` type if available */
|
||||
#if defined( FT_ULLONG_MAX ) && FT_ULLONG_MAX >= 0xFFFFFFFFFFFFFFFFULL
|
||||
#define FT_SIZEOF_LONG_LONG ( 64 / FT_CHAR_BIT )
|
||||
#else
|
||||
#define FT_SIZEOF_LONG_LONG 0
|
||||
#endif
|
||||
|
||||
#endif /* !defined(FT_SIZEOF_LONG_LONG) */
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
@ -174,15 +186,17 @@
|
||||
#endif
|
||||
|
||||
|
||||
/* determine whether we have a 64-bit `int` type for platforms without */
|
||||
/* Autoconf */
|
||||
/* determine whether we have a 64-bit integer type */
|
||||
#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
|
||||
|
||||
#elif FT_SIZEOF_LONG_LONG >= ( 64 / FT_CHAR_BIT )
|
||||
|
||||
#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
|
||||
@ -192,16 +206,9 @@
|
||||
*/
|
||||
#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++) */
|
||||
#if 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
|
||||
|
||||
@ -211,32 +218,30 @@
|
||||
/* 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++ */
|
||||
#elif defined( __WATCOMC__ ) && __WATCOMC__ >= 1100 /* Watcom C++ */
|
||||
|
||||
/* Watcom doesn't provide 64-bit data types */
|
||||
#define FT_INT64 long long int
|
||||
#define FT_UINT64 unsigned long long int
|
||||
|
||||
#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 /* !__STDC__ */
|
||||
|
||||
#endif /* FT_SIZEOF_LONG == (64 / FT_CHAR_BIT) */
|
||||
|
||||
#ifdef FT_LONG64
|
||||
#ifdef FT_INT64
|
||||
typedef FT_INT64 FT_Int64;
|
||||
typedef FT_UINT64 FT_UInt64;
|
||||
#endif
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Mac/OS X support configuration header.
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Define a set of compiler macros used in public FreeType headers.
|
||||
*
|
||||
* Copyright (C) 2020 by
|
||||
* Copyright (C) 2020-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -103,6 +103,7 @@ FT_BEGIN_HEADER
|
||||
*/
|
||||
#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.
|
||||
@ -115,6 +116,23 @@ FT_BEGIN_HEADER
|
||||
#endif
|
||||
|
||||
|
||||
/*
|
||||
* Support for casts in both C and C++.
|
||||
*/
|
||||
#ifdef __cplusplus
|
||||
#define FT_STATIC_CAST( type, var ) static_cast<type>(var)
|
||||
#define FT_REINTERPRET_CAST( type, var ) reinterpret_cast<type>(var)
|
||||
|
||||
#define FT_STATIC_BYTE_CAST( type, var ) \
|
||||
static_cast<type>( static_cast<unsigned char>( var ) )
|
||||
#else
|
||||
#define FT_STATIC_CAST( type, var ) (type)(var)
|
||||
#define FT_REINTERPRET_CAST( type, var ) (type)(var)
|
||||
|
||||
#define FT_STATIC_BYTE_CAST( type, var ) (type)(unsigned char)(var)
|
||||
#endif
|
||||
|
||||
|
||||
FT_END_HEADER
|
||||
|
||||
#endif /* FREETYPE_CONFIG_PUBLIC_MACROS_H_ */
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType high-level API and common types (specification only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -30,6 +30,34 @@ FT_BEGIN_HEADER
|
||||
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
* preamble
|
||||
*
|
||||
* @title:
|
||||
* Preamble
|
||||
*
|
||||
* @abstract:
|
||||
* What FreeType is and isn't
|
||||
*
|
||||
* @description:
|
||||
* FreeType is a library that provides access to glyphs in font files. It
|
||||
* scales the glyph images and their metrics to a requested size, and it
|
||||
* rasterizes the glyph images to produce pixel or subpixel alpha coverage
|
||||
* bitmaps.
|
||||
*
|
||||
* Note that FreeType is _not_ a text layout engine. You have to use
|
||||
* higher-level libraries like HarfBuzz, Pango, or ICU for that.
|
||||
*
|
||||
* Note also that FreeType does _not_ perform alpha blending or
|
||||
* compositing the resulting bitmaps or pixmaps by itself. Use your
|
||||
* favourite graphics library (for example, Cairo or Skia) to further
|
||||
* process FreeType's output.
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
@ -125,6 +153,9 @@ FT_BEGIN_HEADER
|
||||
* FT_FACE_FLAG_GLYPH_NAMES
|
||||
* FT_FACE_FLAG_EXTERNAL_STREAM
|
||||
* FT_FACE_FLAG_HINTER
|
||||
* FT_FACE_FLAG_SVG
|
||||
* FT_FACE_FLAG_SBIX
|
||||
* FT_FACE_FLAG_SBIX_OVERLAY
|
||||
*
|
||||
* FT_HAS_HORIZONTAL
|
||||
* FT_HAS_VERTICAL
|
||||
@ -133,6 +164,9 @@ FT_BEGIN_HEADER
|
||||
* FT_HAS_GLYPH_NAMES
|
||||
* FT_HAS_COLOR
|
||||
* FT_HAS_MULTIPLE_MASTERS
|
||||
* FT_HAS_SVG
|
||||
* FT_HAS_SBIX
|
||||
* FT_HAS_SBIX_OVERLAY
|
||||
*
|
||||
* FT_IS_SFNT
|
||||
* FT_IS_SCALABLE
|
||||
@ -176,6 +210,7 @@ FT_BEGIN_HEADER
|
||||
* FT_Size_RequestRec
|
||||
* FT_Size_Request
|
||||
* FT_Set_Transform
|
||||
* FT_Get_Transform
|
||||
* FT_Load_Glyph
|
||||
* FT_Get_Char_Index
|
||||
* FT_Get_First_Char
|
||||
@ -196,6 +231,7 @@ FT_BEGIN_HEADER
|
||||
* FT_LOAD_NO_SCALE
|
||||
* FT_LOAD_NO_HINTING
|
||||
* FT_LOAD_NO_BITMAP
|
||||
* FT_LOAD_SBITS_ONLY
|
||||
* FT_LOAD_NO_AUTOHINT
|
||||
* FT_LOAD_COLOR
|
||||
*
|
||||
@ -493,13 +529,15 @@ FT_BEGIN_HEADER
|
||||
* size.
|
||||
*
|
||||
* @note:
|
||||
* An @FT_Face has one _active_ @FT_Size object that is used by functions
|
||||
* like @FT_Load_Glyph to determine the scaling transformation that in
|
||||
* turn is used to load and hint glyphs and metrics.
|
||||
* An @FT_Face has one _active_ `FT_Size` object that is used by
|
||||
* functions like @FT_Load_Glyph to determine the scaling transformation
|
||||
* that in turn is used to load and hint glyphs and metrics.
|
||||
*
|
||||
* You can use @FT_Set_Char_Size, @FT_Set_Pixel_Sizes, @FT_Request_Size
|
||||
* A newly created `FT_Size` object contains only meaningless zero values.
|
||||
* You must use @FT_Set_Char_Size, @FT_Set_Pixel_Sizes, @FT_Request_Size
|
||||
* or even @FT_Select_Size to change the content (i.e., the scaling
|
||||
* values) of the active @FT_Size.
|
||||
* values) of the active `FT_Size`. Otherwise, the scaling and hinting
|
||||
* will not be performed.
|
||||
*
|
||||
* You can use @FT_New_Size to create additional size objects for a given
|
||||
* @FT_Face, but they won't be used by other functions until you activate
|
||||
@ -587,11 +625,12 @@ FT_BEGIN_HEADER
|
||||
*/
|
||||
|
||||
#ifndef FT_ENC_TAG
|
||||
#define FT_ENC_TAG( value, a, b, c, d ) \
|
||||
value = ( ( (FT_UInt32)(a) << 24 ) | \
|
||||
( (FT_UInt32)(b) << 16 ) | \
|
||||
( (FT_UInt32)(c) << 8 ) | \
|
||||
(FT_UInt32)(d) )
|
||||
|
||||
#define FT_ENC_TAG( value, a, b, c, d ) \
|
||||
value = ( ( FT_STATIC_BYTE_CAST( FT_UInt32, a ) << 24 ) | \
|
||||
( FT_STATIC_BYTE_CAST( FT_UInt32, b ) << 16 ) | \
|
||||
( FT_STATIC_BYTE_CAST( FT_UInt32, c ) << 8 ) | \
|
||||
FT_STATIC_BYTE_CAST( FT_UInt32, d ) )
|
||||
|
||||
#endif /* FT_ENC_TAG */
|
||||
|
||||
@ -701,11 +740,16 @@ FT_BEGIN_HEADER
|
||||
* Same as FT_ENCODING_JOHAB. Deprecated.
|
||||
*
|
||||
* @note:
|
||||
* By default, FreeType enables a Unicode charmap and tags it with
|
||||
* `FT_ENCODING_UNICODE` when it is either provided or can be generated
|
||||
* from PostScript glyph name dictionaries in the font file. All other
|
||||
* encodings are considered legacy and tagged only if explicitly defined
|
||||
* in the font file. Otherwise, `FT_ENCODING_NONE` is used.
|
||||
* When loading a font, FreeType makes a Unicode charmap active if
|
||||
* possible (either if the font provides such a charmap, or if FreeType
|
||||
* can synthesize one from PostScript glyph name dictionaries; in either
|
||||
* case, the charmap is tagged with `FT_ENCODING_UNICODE`). If such a
|
||||
* charmap is synthesized, it is placed at the first position of the
|
||||
* charmap array.
|
||||
*
|
||||
* All other encodings are considered legacy and tagged only if
|
||||
* explicitly defined in the font file. Otherwise, `FT_ENCODING_NONE` is
|
||||
* used.
|
||||
*
|
||||
* `FT_ENCODING_NONE` is set by the BDF and PCF drivers if the charmap is
|
||||
* neither Unicode nor ISO-8859-1 (otherwise it is set to
|
||||
@ -1193,6 +1237,19 @@ FT_BEGIN_HEADER
|
||||
* altered with @FT_Set_MM_Design_Coordinates,
|
||||
* @FT_Set_Var_Design_Coordinates, or @FT_Set_Var_Blend_Coordinates.
|
||||
* This flag is unset by a call to @FT_Set_Named_Instance.
|
||||
*
|
||||
* FT_FACE_FLAG_SVG ::
|
||||
* [Since 2.12] The face has an 'SVG~' OpenType table.
|
||||
*
|
||||
* FT_FACE_FLAG_SBIX ::
|
||||
* [Since 2.12] The face has an 'sbix' OpenType table *and* outlines.
|
||||
* For such fonts, @FT_FACE_FLAG_SCALABLE is not set by default to
|
||||
* retain backward compatibility.
|
||||
*
|
||||
* FT_FACE_FLAG_SBIX_OVERLAY ::
|
||||
* [Since 2.12] The face has an 'sbix' OpenType table where outlines
|
||||
* should be drawn on top of bitmap strikes.
|
||||
*
|
||||
*/
|
||||
#define FT_FACE_FLAG_SCALABLE ( 1L << 0 )
|
||||
#define FT_FACE_FLAG_FIXED_SIZES ( 1L << 1 )
|
||||
@ -1210,6 +1267,9 @@ FT_BEGIN_HEADER
|
||||
#define FT_FACE_FLAG_TRICKY ( 1L << 13 )
|
||||
#define FT_FACE_FLAG_COLOR ( 1L << 14 )
|
||||
#define FT_FACE_FLAG_VARIATION ( 1L << 15 )
|
||||
#define FT_FACE_FLAG_SVG ( 1L << 16 )
|
||||
#define FT_FACE_FLAG_SBIX ( 1L << 17 )
|
||||
#define FT_FACE_FLAG_SBIX_OVERLAY ( 1L << 18 )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
@ -1450,6 +1510,124 @@ FT_BEGIN_HEADER
|
||||
( !!( (face)->face_flags & FT_FACE_FLAG_COLOR ) )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @macro:
|
||||
* FT_HAS_SVG
|
||||
*
|
||||
* @description:
|
||||
* A macro that returns true whenever a face object contains an 'SVG~'
|
||||
* OpenType table.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
#define FT_HAS_SVG( face ) \
|
||||
( !!( (face)->face_flags & FT_FACE_FLAG_SVG ) )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @macro:
|
||||
* FT_HAS_SBIX
|
||||
*
|
||||
* @description:
|
||||
* A macro that returns true whenever a face object contains an 'sbix'
|
||||
* OpenType table *and* outline glyphs.
|
||||
*
|
||||
* Currently, FreeType only supports bitmap glyphs in PNG format for this
|
||||
* table (i.e., JPEG and TIFF formats are unsupported, as are
|
||||
* Apple-specific formats not part of the OpenType specification).
|
||||
*
|
||||
* @note:
|
||||
* For backward compatibility, a font with an 'sbix' table is treated as
|
||||
* a bitmap-only face. Using @FT_Open_Face with
|
||||
* @FT_PARAM_TAG_IGNORE_SBIX, an application can switch off 'sbix'
|
||||
* handling so that the face is treated as an ordinary outline font with
|
||||
* scalable outlines.
|
||||
*
|
||||
* Here is some pseudo code that roughly illustrates how to implement
|
||||
* 'sbix' handling according to the OpenType specification.
|
||||
*
|
||||
* ```
|
||||
* if ( FT_HAS_SBIX( face ) )
|
||||
* {
|
||||
* // open font as a scalable one without sbix handling
|
||||
* FT_Face face2;
|
||||
* FT_Parameter param = { FT_PARAM_TAG_IGNORE_SBIX, NULL };
|
||||
* FT_Open_Args args = { FT_OPEN_PARAMS | ...,
|
||||
* ...,
|
||||
* 1, ¶m };
|
||||
*
|
||||
*
|
||||
* FT_Open_Face( library, &args, 0, &face2 );
|
||||
*
|
||||
* <sort `face->available_size` as necessary into
|
||||
* `preferred_sizes`[*]>
|
||||
*
|
||||
* for ( i = 0; i < face->num_fixed_sizes; i++ )
|
||||
* {
|
||||
* size = preferred_sizes[i].size;
|
||||
*
|
||||
* error = FT_Set_Pixel_Sizes( face, size, size );
|
||||
* <error handling omitted>
|
||||
*
|
||||
* // check whether we have a glyph in a bitmap strike
|
||||
* error = FT_Load_Glyph( face,
|
||||
* glyph_index,
|
||||
* FT_LOAD_SBITS_ONLY |
|
||||
* FT_LOAD_BITMAP_METRICS_ONLY );
|
||||
* if ( error == FT_Err_Invalid_Argument )
|
||||
* continue;
|
||||
* else if ( error )
|
||||
* <other error handling omitted>
|
||||
* else
|
||||
* break;
|
||||
* }
|
||||
*
|
||||
* if ( i != face->num_fixed_sizes )
|
||||
* <load embedded bitmap with `FT_Load_Glyph`,
|
||||
* scale it, display it, etc.>
|
||||
*
|
||||
* if ( i == face->num_fixed_sizes ||
|
||||
* FT_HAS_SBIX_OVERLAY( face ) )
|
||||
* <use `face2` to load outline glyph with `FT_Load_Glyph`,
|
||||
* scale it, display it on top of the bitmap, etc.>
|
||||
* }
|
||||
* ```
|
||||
*
|
||||
* [*] Assuming a target value of 400dpi and available strike sizes 100,
|
||||
* 200, 300, and 400dpi, a possible order might be [400, 200, 300, 100]:
|
||||
* scaling 200dpi to 400dpi usually gives better results than scaling
|
||||
* 300dpi to 400dpi; it is also much faster. However, scaling 100dpi to
|
||||
* 400dpi can yield a too pixelated result, thus the preference might be
|
||||
* 300dpi over 100dpi.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
#define FT_HAS_SBIX( face ) \
|
||||
( !!( (face)->face_flags & FT_FACE_FLAG_SBIX ) )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @macro:
|
||||
* FT_HAS_SBIX_OVERLAY
|
||||
*
|
||||
* @description:
|
||||
* A macro that returns true whenever a face object contains an 'sbix'
|
||||
* OpenType table with bit~1 in its `flags` field set, instructing the
|
||||
* application to overlay the bitmap strike with the corresponding
|
||||
* outline glyph. See @FT_HAS_SBIX for pseudo code how to use it.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
#define FT_HAS_SBIX_OVERLAY( face ) \
|
||||
( !!( (face)->face_flags & FT_FACE_FLAG_SBIX_OVERLAY ) )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @enum:
|
||||
@ -2065,7 +2243,8 @@ FT_BEGIN_HEADER
|
||||
* The size in bytes of the file in memory.
|
||||
*
|
||||
* pathname ::
|
||||
* A pointer to an 8-bit file pathname. The pointer is not owned by
|
||||
* A pointer to an 8-bit file pathname, which must be a C~string (i.e.,
|
||||
* no null bytes except at the very end). The pointer is not owned by
|
||||
* FreeType.
|
||||
*
|
||||
* stream ::
|
||||
@ -2084,8 +2263,7 @@ FT_BEGIN_HEADER
|
||||
* Extra parameters passed to the font driver when opening a new face.
|
||||
*
|
||||
* @note:
|
||||
* The stream type is determined by the contents of `flags` that are
|
||||
* tested in the following order by @FT_Open_Face:
|
||||
* The stream type is determined by the contents of `flags`:
|
||||
*
|
||||
* If the @FT_OPEN_MEMORY bit is set, assume that this is a memory file
|
||||
* of `memory_size` bytes, located at `memory_address`. The data are not
|
||||
@ -2098,6 +2276,9 @@ FT_BEGIN_HEADER
|
||||
* Otherwise, if the @FT_OPEN_PATHNAME bit is set, assume that this is a
|
||||
* normal file and use `pathname` to open it.
|
||||
*
|
||||
* If none of the above bits are set or if multiple are set at the same
|
||||
* time, the flags are invalid and @FT_Open_Face fails.
|
||||
*
|
||||
* If the @FT_OPEN_DRIVER bit is set, @FT_Open_Face only tries to open
|
||||
* the file with the driver whose handler is in `driver`.
|
||||
*
|
||||
@ -2150,6 +2331,13 @@ FT_BEGIN_HEADER
|
||||
* FreeType error code. 0~means success.
|
||||
*
|
||||
* @note:
|
||||
* The `pathname` string should be recognizable as such by a standard
|
||||
* `fopen` call on your system; in particular, this means that `pathname`
|
||||
* must not contain null bytes. If that is not sufficient to address all
|
||||
* file name possibilities (for example, to handle wide character file
|
||||
* names on Windows in UTF-16 encoding) you might use @FT_Open_Face to
|
||||
* pass a memory array or a stream object instead.
|
||||
*
|
||||
* Use @FT_Done_Face to destroy the created @FT_Face object (along with
|
||||
* its slot and sizes).
|
||||
*/
|
||||
@ -2270,6 +2458,10 @@ FT_BEGIN_HEADER
|
||||
* See the discussion of reference counters in the description of
|
||||
* @FT_Reference_Face.
|
||||
*
|
||||
* If `FT_OPEN_STREAM` is set in `args->flags`, the stream in
|
||||
* `args->stream` is automatically closed before this function returns
|
||||
* any error (including `FT_Err_Invalid_Argument`).
|
||||
*
|
||||
* @example:
|
||||
* To loop over all faces, use code similar to the following snippet
|
||||
* (omitting the error handling).
|
||||
@ -2428,6 +2620,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.4.2
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_Error )
|
||||
FT_Reference_Face( FT_Face face );
|
||||
@ -2652,8 +2845,8 @@ FT_BEGIN_HEADER
|
||||
* 'https://www.freetype.org/freetype2/docs/glyphs/glyphs-2.html'.
|
||||
*
|
||||
* Contrary to @FT_Set_Char_Size, this function doesn't have special code
|
||||
* to normalize zero-valued widths, heights, or resolutions (which lead
|
||||
* to errors in most cases).
|
||||
* to normalize zero-valued widths, heights, or resolutions, which are
|
||||
* treated as @FT_LOAD_NO_SCALE.
|
||||
*
|
||||
* Don't use this function if you are using the FreeType cache API.
|
||||
*/
|
||||
@ -2769,7 +2962,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* load_flags ::
|
||||
* A flag indicating what to load for this glyph. The @FT_LOAD_XXX
|
||||
* constants can be used to control the glyph loading process (e.g.,
|
||||
* flags can be used to control the glyph loading process (e.g.,
|
||||
* whether the outline should be scaled, whether to load bitmaps or
|
||||
* not, whether to hint the outline, etc).
|
||||
*
|
||||
@ -2777,8 +2970,10 @@ FT_BEGIN_HEADER
|
||||
* FreeType error code. 0~means success.
|
||||
*
|
||||
* @note:
|
||||
* The loaded glyph may be transformed. See @FT_Set_Transform for the
|
||||
* details.
|
||||
* For proper scaling and hinting, the active @FT_Size object owned by
|
||||
* the face has to be meaningfully initialized by calling
|
||||
* @FT_Set_Char_Size before this function, for example. The loaded
|
||||
* glyph may be transformed. See @FT_Set_Transform for the details.
|
||||
*
|
||||
* For subsetted CID-keyed fonts, `FT_Err_Invalid_Argument` is returned
|
||||
* for invalid CID values (this is, for CID values that don't have a
|
||||
@ -2868,6 +3063,8 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* FT_LOAD_NO_SCALE ::
|
||||
* Don't scale the loaded outline glyph but keep it in font units.
|
||||
* This flag is also assumed if @FT_Size owned by the face was not
|
||||
* properly initialized.
|
||||
*
|
||||
* This flag implies @FT_LOAD_NO_HINTING and @FT_LOAD_NO_BITMAP, and
|
||||
* unsets @FT_LOAD_RENDER.
|
||||
@ -2898,6 +3095,15 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @FT_LOAD_NO_SCALE always sets this flag.
|
||||
*
|
||||
* FT_LOAD_SBITS_ONLY ::
|
||||
* [Since 2.12] This is the opposite of @FT_LOAD_NO_BITMAP, more or
|
||||
* less: @FT_Load_Glyph returns `FT_Err_Invalid_Argument` if the face
|
||||
* contains a bitmap strike for the given size (or the strike selected
|
||||
* by @FT_Select_Size) but there is no glyph in the strike.
|
||||
*
|
||||
* Note that this load flag was part of FreeType since version 2.0.6
|
||||
* but previously tagged as internal.
|
||||
*
|
||||
* FT_LOAD_VERTICAL_LAYOUT ::
|
||||
* Load the glyph for vertical text layout. In particular, the
|
||||
* `advance` value in the @FT_GlyphSlotRec structure is set to the
|
||||
@ -2954,21 +3160,31 @@ FT_BEGIN_HEADER
|
||||
* Disable the auto-hinter. See also the note below.
|
||||
*
|
||||
* FT_LOAD_COLOR ::
|
||||
* Load colored glyphs. There are slight differences depending on the
|
||||
* font format.
|
||||
* Load colored glyphs. FreeType searches in the following order;
|
||||
* there are slight differences depending on the font format.
|
||||
*
|
||||
* [Since 2.5] Load embedded color bitmap images. The resulting color
|
||||
* bitmaps, if available, will have the @FT_PIXEL_MODE_BGRA format,
|
||||
* with pre-multiplied color channels. If the flag is not set and
|
||||
* color bitmaps are found, they are converted to 256-level gray
|
||||
* bitmaps, using the @FT_PIXEL_MODE_GRAY format.
|
||||
* [Since 2.5] Load embedded color bitmap images (provided
|
||||
* @FT_LOAD_NO_BITMAP is not set). The resulting color bitmaps, if
|
||||
* available, have the @FT_PIXEL_MODE_BGRA format, with pre-multiplied
|
||||
* color channels. If the flag is not set and color bitmaps are found,
|
||||
* they are converted to 256-level gray bitmaps, using the
|
||||
* @FT_PIXEL_MODE_GRAY format.
|
||||
*
|
||||
* [Since 2.10, experimental] If the glyph index contains an entry in
|
||||
* [Since 2.12] If the glyph index maps to an entry in the face's
|
||||
* 'SVG~' table, load the associated SVG document from this table and
|
||||
* set the `format` field of @FT_GlyphSlotRec to @FT_GLYPH_FORMAT_SVG.
|
||||
* Note that FreeType itself can't render SVG documents; however, the
|
||||
* library provides hooks to seamlessly integrate an external renderer.
|
||||
* See sections @ot_svg_driver and @svg_fonts for more.
|
||||
*
|
||||
* [Since 2.10, experimental] If the glyph index maps to an entry in
|
||||
* the face's 'COLR' table with a 'CPAL' palette table (as defined in
|
||||
* the OpenType specification), make @FT_Render_Glyph provide a default
|
||||
* blending of the color glyph layers associated with the glyph index,
|
||||
* using the same bitmap format as embedded color bitmap images. This
|
||||
* is mainly for convenience; for full control of color layers use
|
||||
* is mainly for convenience and works only for glyphs in 'COLR' v0
|
||||
* tables (or glyphs in 'COLR' v1 tables that exclusively use v0
|
||||
* features). For full control of color layers use
|
||||
* @FT_Get_Color_Glyph_Layer and FreeType's color functions like
|
||||
* @FT_Palette_Select instead of setting @FT_LOAD_COLOR for rendering
|
||||
* so that the client application can handle blending by itself.
|
||||
@ -3019,19 +3235,20 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
*/
|
||||
#define FT_LOAD_DEFAULT 0x0
|
||||
#define FT_LOAD_NO_SCALE ( 1L << 0 )
|
||||
#define FT_LOAD_NO_HINTING ( 1L << 1 )
|
||||
#define FT_LOAD_RENDER ( 1L << 2 )
|
||||
#define FT_LOAD_NO_BITMAP ( 1L << 3 )
|
||||
#define FT_LOAD_VERTICAL_LAYOUT ( 1L << 4 )
|
||||
#define FT_LOAD_FORCE_AUTOHINT ( 1L << 5 )
|
||||
#define FT_LOAD_CROP_BITMAP ( 1L << 6 )
|
||||
#define FT_LOAD_PEDANTIC ( 1L << 7 )
|
||||
#define FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH ( 1L << 9 )
|
||||
#define FT_LOAD_NO_SCALE ( 1L << 0 )
|
||||
#define FT_LOAD_NO_HINTING ( 1L << 1 )
|
||||
#define FT_LOAD_RENDER ( 1L << 2 )
|
||||
#define FT_LOAD_NO_BITMAP ( 1L << 3 )
|
||||
#define FT_LOAD_VERTICAL_LAYOUT ( 1L << 4 )
|
||||
#define FT_LOAD_FORCE_AUTOHINT ( 1L << 5 )
|
||||
#define FT_LOAD_CROP_BITMAP ( 1L << 6 )
|
||||
#define FT_LOAD_PEDANTIC ( 1L << 7 )
|
||||
#define FT_LOAD_IGNORE_GLOBAL_ADVANCE_WIDTH ( 1L << 9 )
|
||||
#define FT_LOAD_NO_RECURSE ( 1L << 10 )
|
||||
#define FT_LOAD_IGNORE_TRANSFORM ( 1L << 11 )
|
||||
#define FT_LOAD_MONOCHROME ( 1L << 12 )
|
||||
#define FT_LOAD_LINEAR_DESIGN ( 1L << 13 )
|
||||
#define FT_LOAD_SBITS_ONLY ( 1L << 14 )
|
||||
#define FT_LOAD_NO_AUTOHINT ( 1L << 15 )
|
||||
/* Bits 16-19 are used by `FT_LOAD_TARGET_` */
|
||||
#define FT_LOAD_COLOR ( 1L << 20 )
|
||||
@ -3041,8 +3258,8 @@ FT_BEGIN_HEADER
|
||||
/* */
|
||||
|
||||
/* used internally only by certain font drivers */
|
||||
#define FT_LOAD_ADVANCE_ONLY ( 1L << 8 )
|
||||
#define FT_LOAD_SBITS_ONLY ( 1L << 14 )
|
||||
#define FT_LOAD_ADVANCE_ONLY ( 1L << 8 )
|
||||
#define FT_LOAD_SVG_ONLY ( 1L << 23 )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
@ -3132,7 +3349,7 @@ FT_BEGIN_HEADER
|
||||
* necessary to empty the cache after a mode switch to avoid false hits.
|
||||
*
|
||||
*/
|
||||
#define FT_LOAD_TARGET_( x ) ( (FT_Int32)( (x) & 15 ) << 16 )
|
||||
#define FT_LOAD_TARGET_( x ) ( FT_STATIC_CAST( FT_Int32, (x) & 15 ) << 16 )
|
||||
|
||||
#define FT_LOAD_TARGET_NORMAL FT_LOAD_TARGET_( FT_RENDER_MODE_NORMAL )
|
||||
#define FT_LOAD_TARGET_LIGHT FT_LOAD_TARGET_( FT_RENDER_MODE_LIGHT )
|
||||
@ -3151,7 +3368,8 @@ FT_BEGIN_HEADER
|
||||
* @FT_LOAD_TARGET_XXX value.
|
||||
*
|
||||
*/
|
||||
#define FT_LOAD_TARGET_MODE( x ) ( (FT_Render_Mode)( ( (x) >> 16 ) & 15 ) )
|
||||
#define FT_LOAD_TARGET_MODE( x ) \
|
||||
FT_STATIC_CAST( FT_Render_Mode, ( (x) >> 16 ) & 15 )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
@ -3172,11 +3390,12 @@ FT_BEGIN_HEADER
|
||||
* A pointer to the transformation's 2x2 matrix. Use `NULL` for the
|
||||
* identity matrix.
|
||||
* delta ::
|
||||
* A pointer to the translation vector. Use `NULL` for the null vector.
|
||||
* A pointer to the translation vector. Use `NULL` for the null
|
||||
* vector.
|
||||
*
|
||||
* @note:
|
||||
* This function is provided as a convenience, but keep in mind that
|
||||
* @FT_Matrix coefficients are only 16.16 fixed point values, which can
|
||||
* @FT_Matrix coefficients are only 16.16 fixed-point values, which can
|
||||
* limit the accuracy of the results. Using floating-point computations
|
||||
* to perform the transform directly in client code instead will always
|
||||
* yield better numbers.
|
||||
@ -3195,6 +3414,39 @@ FT_BEGIN_HEADER
|
||||
FT_Vector* delta );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Get_Transform
|
||||
*
|
||||
* @description:
|
||||
* Return the transformation that is applied to glyph images when they
|
||||
* are loaded into a glyph slot through @FT_Load_Glyph. See
|
||||
* @FT_Set_Transform for more details.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* A handle to the source face object.
|
||||
*
|
||||
* @output:
|
||||
* matrix ::
|
||||
* A pointer to a transformation's 2x2 matrix. Set this to NULL if you
|
||||
* are not interested in the value.
|
||||
*
|
||||
* delta ::
|
||||
* A pointer a translation vector. Set this to NULL if you are not
|
||||
* interested in the value.
|
||||
*
|
||||
* @since:
|
||||
* 2.11
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( void )
|
||||
FT_Get_Transform( FT_Face face,
|
||||
FT_Matrix* matrix,
|
||||
FT_Vector* delta );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @enum:
|
||||
@ -3213,6 +3465,10 @@ FT_BEGIN_HEADER
|
||||
* correction to correctly render non-monochrome glyph bitmaps onto a
|
||||
* surface; see @FT_Render_Glyph.
|
||||
*
|
||||
* The @FT_RENDER_MODE_SDF is a special render mode that uses up to 256
|
||||
* distance values, indicating the signed distance from the grid position
|
||||
* to the nearest outline.
|
||||
*
|
||||
* @values:
|
||||
* FT_RENDER_MODE_NORMAL ::
|
||||
* Default render mode; it corresponds to 8-bit anti-aliased bitmaps.
|
||||
@ -3238,11 +3494,87 @@ FT_BEGIN_HEADER
|
||||
* bitmaps that are 3~times the height of the original glyph outline in
|
||||
* pixels and use the @FT_PIXEL_MODE_LCD_V mode.
|
||||
*
|
||||
* FT_RENDER_MODE_SDF ::
|
||||
* This mode corresponds to 8-bit, single-channel signed distance field
|
||||
* (SDF) bitmaps. Each pixel in the SDF grid is the value from the
|
||||
* pixel's position to the nearest glyph's outline. The distances are
|
||||
* calculated from the center of the pixel and are positive if they are
|
||||
* filled by the outline (i.e., inside the outline) and negative
|
||||
* otherwise. Check the note below on how to convert the output values
|
||||
* to usable data.
|
||||
*
|
||||
* @note:
|
||||
* The selected render mode only affects vector glyphs of a font.
|
||||
* Embedded bitmaps often have a different pixel mode like
|
||||
* @FT_PIXEL_MODE_MONO. You can use @FT_Bitmap_Convert to transform them
|
||||
* into 8-bit pixmaps.
|
||||
*
|
||||
* For @FT_RENDER_MODE_SDF the output bitmap buffer contains normalized
|
||||
* distances that are packed into unsigned 8-bit values. To get pixel
|
||||
* values in floating point representation use the following pseudo-C
|
||||
* code for the conversion.
|
||||
*
|
||||
* ```
|
||||
* // Load glyph and render using FT_RENDER_MODE_SDF,
|
||||
* // then use the output buffer as follows.
|
||||
*
|
||||
* ...
|
||||
* FT_Byte buffer = glyph->bitmap->buffer;
|
||||
*
|
||||
*
|
||||
* for pixel in buffer
|
||||
* {
|
||||
* // `sd` is the signed distance and `spread` is the current spread;
|
||||
* // the default spread is 2 and can be changed.
|
||||
*
|
||||
* float sd = (float)pixel - 128.0f;
|
||||
*
|
||||
*
|
||||
* // Convert to pixel values.
|
||||
* sd = ( sd / 128.0f ) * spread;
|
||||
*
|
||||
* // Store `sd` in a buffer or use as required.
|
||||
* }
|
||||
*
|
||||
* ```
|
||||
*
|
||||
* FreeType has two rasterizers for generating SDF, namely:
|
||||
*
|
||||
* 1. `sdf` for generating SDF directly from glyph's outline, and
|
||||
*
|
||||
* 2. `bsdf` for generating SDF from rasterized bitmaps.
|
||||
*
|
||||
* Depending on the glyph type (i.e., outline or bitmap), one of the two
|
||||
* rasterizers is chosen at runtime and used for generating SDFs. To
|
||||
* force the use of `bsdf` you should render the glyph with any of the
|
||||
* FreeType's other rendering modes (e.g., `FT_RENDER_MODE_NORMAL`) and
|
||||
* then re-render with `FT_RENDER_MODE_SDF`.
|
||||
*
|
||||
* There are some issues with stability and possible failures of the SDF
|
||||
* renderers (specifically `sdf`).
|
||||
*
|
||||
* 1. The `sdf` rasterizer is sensitive to really small features (e.g.,
|
||||
* sharp turns that are less than 1~pixel) and imperfections in the
|
||||
* glyph's outline, causing artifacts in the final output.
|
||||
*
|
||||
* 2. The `sdf` rasterizer has limited support for handling intersecting
|
||||
* contours and *cannot* handle self-intersecting contours whatsoever.
|
||||
* Self-intersection happens when a single connected contour intersect
|
||||
* itself at some point; having these in your font definitely pose a
|
||||
* problem to the rasterizer and cause artifacts, too.
|
||||
*
|
||||
* 3. Generating SDF for really small glyphs may result in undesirable
|
||||
* output; the pixel grid (which stores distance information) becomes
|
||||
* too coarse.
|
||||
*
|
||||
* 4. Since the output buffer is normalized, precision at smaller spreads
|
||||
* is greater than precision at larger spread values because the
|
||||
* output range of [0..255] gets mapped to a smaller SDF range. A
|
||||
* spread of~2 should be sufficient in most cases.
|
||||
*
|
||||
* Points (1) and (2) can be avoided by using the `bsdf` rasterizer,
|
||||
* which is more stable than the `sdf` rasterizer in general.
|
||||
*
|
||||
*/
|
||||
typedef enum FT_Render_Mode_
|
||||
{
|
||||
@ -3251,6 +3583,7 @@ FT_BEGIN_HEADER
|
||||
FT_RENDER_MODE_MONO,
|
||||
FT_RENDER_MODE_LCD,
|
||||
FT_RENDER_MODE_LCD_V,
|
||||
FT_RENDER_MODE_SDF,
|
||||
|
||||
FT_RENDER_MODE_MAX
|
||||
|
||||
@ -3282,7 +3615,7 @@ FT_BEGIN_HEADER
|
||||
* @FT_Render_Mode for a list of possible values.
|
||||
*
|
||||
* If @FT_RENDER_MODE_NORMAL is used, a previous call of @FT_Load_Glyph
|
||||
* with flag @FT_LOAD_COLOR makes FT_Render_Glyph provide a default
|
||||
* with flag @FT_LOAD_COLOR makes `FT_Render_Glyph` provide a default
|
||||
* blending of colored glyph layers associated with the current glyph
|
||||
* slot (provided the font contains such layers) instead of rendering
|
||||
* the glyph slot's outline. This is an experimental feature; see
|
||||
@ -3292,9 +3625,6 @@ FT_BEGIN_HEADER
|
||||
* FreeType error code. 0~means success.
|
||||
*
|
||||
* @note:
|
||||
* To get meaningful results, font scaling values must be set with
|
||||
* functions like @FT_Set_Char_Size before calling `FT_Render_Glyph`.
|
||||
*
|
||||
* When FreeType outputs a bitmap of a glyph, it really outputs an alpha
|
||||
* coverage map. If a pixel is completely covered by a filled-in
|
||||
* outline, the bitmap contains 0xFF at that pixel, meaning that
|
||||
@ -3338,7 +3668,8 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* which is known as the OVER operator.
|
||||
*
|
||||
* To correctly composite an antialiased pixel of a glyph onto a surface,
|
||||
* To correctly composite an anti-aliased pixel of a glyph onto a
|
||||
* surface,
|
||||
*
|
||||
* 1. take the foreground and background colors (e.g., in sRGB space)
|
||||
* and apply gamma to get them in a linear space,
|
||||
@ -4015,168 +4346,6 @@ FT_BEGIN_HEADER
|
||||
FT_Matrix *p_transform );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
* layer_management
|
||||
*
|
||||
* @title:
|
||||
* Glyph Layer Management
|
||||
*
|
||||
* @abstract:
|
||||
* Retrieving and manipulating OpenType's 'COLR' table data.
|
||||
*
|
||||
* @description:
|
||||
* The functions described here allow access of colored glyph layer data
|
||||
* in OpenType's 'COLR' tables.
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @struct:
|
||||
* FT_LayerIterator
|
||||
*
|
||||
* @description:
|
||||
* This iterator object is needed for @FT_Get_Color_Glyph_Layer.
|
||||
*
|
||||
* @fields:
|
||||
* num_layers ::
|
||||
* The number of glyph layers for the requested glyph index. Will be
|
||||
* set by @FT_Get_Color_Glyph_Layer.
|
||||
*
|
||||
* layer ::
|
||||
* The current layer. Will be set by @FT_Get_Color_Glyph_Layer.
|
||||
*
|
||||
* p ::
|
||||
* An opaque pointer into 'COLR' table data. The caller must set this
|
||||
* to `NULL` before the first call of @FT_Get_Color_Glyph_Layer.
|
||||
*/
|
||||
typedef struct FT_LayerIterator_
|
||||
{
|
||||
FT_UInt num_layers;
|
||||
FT_UInt layer;
|
||||
FT_Byte* p;
|
||||
|
||||
} FT_LayerIterator;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Get_Color_Glyph_Layer
|
||||
*
|
||||
* @description:
|
||||
* This is an interface to the 'COLR' table in OpenType fonts to
|
||||
* iteratively retrieve the colored glyph layers associated with the
|
||||
* current glyph slot.
|
||||
*
|
||||
* https://docs.microsoft.com/en-us/typography/opentype/spec/colr
|
||||
*
|
||||
* The glyph layer data for a given glyph index, if present, provides an
|
||||
* alternative, multi-color glyph representation: Instead of rendering
|
||||
* the outline or bitmap with the given glyph index, glyphs with the
|
||||
* indices and colors returned by this function are rendered layer by
|
||||
* layer.
|
||||
*
|
||||
* The returned elements are ordered in the z~direction from bottom to
|
||||
* top; the 'n'th element should be rendered with the associated palette
|
||||
* color and blended on top of the already rendered layers (elements 0,
|
||||
* 1, ..., n-1).
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* A handle to the parent face object.
|
||||
*
|
||||
* base_glyph ::
|
||||
* The glyph index the colored glyph layers are associated with.
|
||||
*
|
||||
* @inout:
|
||||
* iterator ::
|
||||
* An @FT_LayerIterator object. For the first call you should set
|
||||
* `iterator->p` to `NULL`. For all following calls, simply use the
|
||||
* same object again.
|
||||
*
|
||||
* @output:
|
||||
* aglyph_index ::
|
||||
* The glyph index of the current layer.
|
||||
*
|
||||
* acolor_index ::
|
||||
* The color index into the font face's color palette of the current
|
||||
* layer. The value 0xFFFF is special; it doesn't reference a palette
|
||||
* entry but indicates that the text foreground color should be used
|
||||
* instead (to be set up by the application outside of FreeType).
|
||||
*
|
||||
* The color palette can be retrieved with @FT_Palette_Select.
|
||||
*
|
||||
* @return:
|
||||
* Value~1 if everything is OK. If there are no more layers (or if there
|
||||
* are no layers at all), value~0 gets returned. In case of an error,
|
||||
* value~0 is returned also.
|
||||
*
|
||||
* @note:
|
||||
* This function is necessary if you want to handle glyph layers by
|
||||
* yourself. In particular, functions that operate with @FT_GlyphRec
|
||||
* objects (like @FT_Get_Glyph or @FT_Glyph_To_Bitmap) don't have access
|
||||
* to this information.
|
||||
*
|
||||
* Note that @FT_Render_Glyph is able to handle colored glyph layers
|
||||
* automatically if the @FT_LOAD_COLOR flag is passed to a previous call
|
||||
* to @FT_Load_Glyph. [This is an experimental feature.]
|
||||
*
|
||||
* @example:
|
||||
* ```
|
||||
* FT_Color* palette;
|
||||
* FT_LayerIterator iterator;
|
||||
*
|
||||
* FT_Bool have_layers;
|
||||
* FT_UInt layer_glyph_index;
|
||||
* FT_UInt layer_color_index;
|
||||
*
|
||||
*
|
||||
* error = FT_Palette_Select( face, palette_index, &palette );
|
||||
* if ( error )
|
||||
* palette = NULL;
|
||||
*
|
||||
* iterator.p = NULL;
|
||||
* have_layers = FT_Get_Color_Glyph_Layer( face,
|
||||
* glyph_index,
|
||||
* &layer_glyph_index,
|
||||
* &layer_color_index,
|
||||
* &iterator );
|
||||
*
|
||||
* if ( palette && have_layers )
|
||||
* {
|
||||
* do
|
||||
* {
|
||||
* FT_Color layer_color;
|
||||
*
|
||||
*
|
||||
* if ( layer_color_index == 0xFFFF )
|
||||
* layer_color = text_foreground_color;
|
||||
* else
|
||||
* layer_color = palette[layer_color_index];
|
||||
*
|
||||
* // Load and render glyph `layer_glyph_index', then
|
||||
* // blend resulting pixmap (using color `layer_color')
|
||||
* // with previously created pixmaps.
|
||||
*
|
||||
* } while ( FT_Get_Color_Glyph_Layer( face,
|
||||
* glyph_index,
|
||||
* &layer_glyph_index,
|
||||
* &layer_color_index,
|
||||
* &iterator ) );
|
||||
* }
|
||||
* ```
|
||||
*/
|
||||
FT_EXPORT( FT_Bool )
|
||||
FT_Get_Color_Glyph_Layer( FT_Face face,
|
||||
FT_UInt base_glyph,
|
||||
FT_UInt *aglyph_index,
|
||||
FT_UInt *acolor_index,
|
||||
FT_LayerIterator* iterator );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
@ -4267,6 +4436,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.3.8
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_UShort )
|
||||
FT_Get_FSType_Flags( FT_Face face );
|
||||
@ -4360,6 +4530,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.3.6
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_UInt )
|
||||
FT_Face_GetCharVariantIndex( FT_Face face,
|
||||
@ -4396,6 +4567,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.3.6
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_Int )
|
||||
FT_Face_GetCharVariantIsDefault( FT_Face face,
|
||||
@ -4427,6 +4599,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.3.6
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_UInt32* )
|
||||
FT_Face_GetVariantSelectors( FT_Face face );
|
||||
@ -4460,6 +4633,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.3.6
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_UInt32* )
|
||||
FT_Face_GetVariantsOfChar( FT_Face face,
|
||||
@ -4494,6 +4668,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.3.6
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_UInt32* )
|
||||
FT_Face_GetCharsOfVariant( FT_Face face,
|
||||
@ -4766,8 +4941,8 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
*/
|
||||
#define FREETYPE_MAJOR 2
|
||||
#define FREETYPE_MINOR 10
|
||||
#define FREETYPE_PATCH 4
|
||||
#define FREETYPE_MINOR 12
|
||||
#define FREETYPE_PATCH 0
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
@ -4829,6 +5004,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.3.5
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_Bool )
|
||||
FT_Face_CheckTrueTypePatents( FT_Face face );
|
||||
@ -4857,6 +5033,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @since:
|
||||
* 2.3.5
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_Bool )
|
||||
FT_Face_SetUnpatentedHinting( FT_Face face,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Quick computation of advance widths (specification only).
|
||||
*
|
||||
* Copyright (C) 2008-2020 by
|
||||
* Copyright (C) 2008-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType exact bbox computation (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType API for accessing BDF-specific strings (specification).
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType utility functions for bitmaps (specification).
|
||||
*
|
||||
* Copyright (C) 2004-2020 by
|
||||
* Copyright (C) 2004-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -15,6 +15,7 @@
|
||||
* General Remarks
|
||||
*
|
||||
* @sections:
|
||||
* preamble
|
||||
* header_inclusion
|
||||
* user_allocation
|
||||
*
|
||||
@ -61,6 +62,7 @@
|
||||
* cid_fonts
|
||||
* pfr_fonts
|
||||
* winfnt_fonts
|
||||
* svg_fonts
|
||||
* font_formats
|
||||
* gasp_table
|
||||
*
|
||||
@ -81,6 +83,7 @@
|
||||
* t1_cid_driver
|
||||
* tt_driver
|
||||
* pcf_driver
|
||||
* ot_svg_driver
|
||||
* properties
|
||||
* parameter_tags
|
||||
* lcd_rendering
|
||||
@ -123,6 +126,7 @@
|
||||
* gzip
|
||||
* lzw
|
||||
* bzip2
|
||||
* debugging_apis
|
||||
*
|
||||
*/
|
||||
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType API for accessing CID font information (specification).
|
||||
*
|
||||
* Copyright (C) 2007-2020 by
|
||||
* Copyright (C) 2007-2022 by
|
||||
* Dereg Clegg and Michael Toftdal.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
File diff suppressed because it is too large
Load Diff
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType API for controlling driver modules (specification only).
|
||||
*
|
||||
* Copyright (C) 2017-2020 by
|
||||
* Copyright (C) 2017-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -53,10 +53,10 @@ FT_BEGIN_HEADER
|
||||
* reasons.
|
||||
*
|
||||
* Available properties are @increase-x-height, @no-stem-darkening
|
||||
* (experimental), @darkening-parameters (experimental), @warping
|
||||
* (experimental), @glyph-to-script-map (experimental), @fallback-script
|
||||
* (experimental), and @default-script (experimental), as documented in
|
||||
* the @properties section.
|
||||
* (experimental), @darkening-parameters (experimental),
|
||||
* @glyph-to-script-map (experimental), @fallback-script (experimental),
|
||||
* and @default-script (experimental), as documented in the @properties
|
||||
* section.
|
||||
*
|
||||
*/
|
||||
|
||||
@ -84,15 +84,15 @@ FT_BEGIN_HEADER
|
||||
* @properties section.
|
||||
*
|
||||
*
|
||||
* **Hinting and antialiasing principles of the new engine**
|
||||
* **Hinting and anti-aliasing principles of the new engine**
|
||||
*
|
||||
* The rasterizer is positioning horizontal features (e.g., ascender
|
||||
* height & x-height, or crossbars) on the pixel grid and minimizing the
|
||||
* amount of antialiasing applied to them, while placing vertical
|
||||
* amount of anti-aliasing applied to them, while placing vertical
|
||||
* features (vertical stems) on the pixel grid without hinting, thus
|
||||
* representing the stem position and weight accurately. Sometimes the
|
||||
* vertical stems may be only partially black. In this context,
|
||||
* 'antialiasing' means that stems are not positioned exactly on pixel
|
||||
* 'anti-aliasing' means that stems are not positioned exactly on pixel
|
||||
* borders, causing a fuzzy appearance.
|
||||
*
|
||||
* There are two principles behind this approach.
|
||||
@ -108,7 +108,7 @@ FT_BEGIN_HEADER
|
||||
* sizes are comparable to kerning values and thus would be noticeable
|
||||
* (and distracting) while reading if hinting were applied.
|
||||
*
|
||||
* One of the reasons to not hint horizontally is antialiasing for LCD
|
||||
* One of the reasons to not hint horizontally is anti-aliasing for LCD
|
||||
* screens: The pixel geometry of modern displays supplies three vertical
|
||||
* subpixels as the eye moves horizontally across each visible pixel. On
|
||||
* devices where we can be certain this characteristic is present a
|
||||
@ -116,7 +116,7 @@ FT_BEGIN_HEADER
|
||||
* weight. In Western writing systems this turns out to be the more
|
||||
* critical direction anyway; the weights and spacing of vertical stems
|
||||
* (see above) are central to Armenian, Cyrillic, Greek, and Latin type
|
||||
* designs. Even when the rasterizer uses greyscale antialiasing instead
|
||||
* designs. Even when the rasterizer uses greyscale anti-aliasing instead
|
||||
* of color (a necessary compromise when one doesn't know the screen
|
||||
* characteristics), the unhinted vertical features preserve the design's
|
||||
* weight and spacing much better than aliased type would.
|
||||
@ -212,16 +212,14 @@ FT_BEGIN_HEADER
|
||||
* @description:
|
||||
* While FreeType's TrueType driver doesn't expose API functions by
|
||||
* itself, it is possible to control its behaviour with @FT_Property_Set
|
||||
* and @FT_Property_Get. The following lists the available properties
|
||||
* together with the necessary macros and structures.
|
||||
* and @FT_Property_Get.
|
||||
*
|
||||
* The TrueType driver's module name is 'truetype'.
|
||||
* The TrueType driver's module name is 'truetype'; a single property
|
||||
* @interpreter-version is available, as documented in the @properties
|
||||
* section.
|
||||
*
|
||||
* A single property @interpreter-version is available, as documented in
|
||||
* the @properties section.
|
||||
*
|
||||
* We start with a list of definitions, kindly provided by Greg
|
||||
* Hitchcock.
|
||||
* To help understand the differences between interpreter versions, we
|
||||
* introduce a list of definitions, kindly provided by Greg Hitchcock.
|
||||
*
|
||||
* _Bi-Level Rendering_
|
||||
*
|
||||
@ -300,6 +298,31 @@ FT_BEGIN_HEADER
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
* ot_svg_driver
|
||||
*
|
||||
* @title:
|
||||
* The SVG driver
|
||||
*
|
||||
* @abstract:
|
||||
* Controlling the external rendering of OT-SVG glyphs.
|
||||
*
|
||||
* @description:
|
||||
* By default, FreeType can only load the 'SVG~' table of OpenType fonts
|
||||
* if configuration macro `FT_CONFIG_OPTION_SVG` is defined. To make it
|
||||
* render SVG glyphs, an external SVG rendering library is needed. All
|
||||
* details on the interface between FreeType and the external library
|
||||
* via function hooks can be found in section @svg_fonts.
|
||||
*
|
||||
* The OT-SVG driver's module name is 'ot-svg'; it supports a single
|
||||
* property called @svg-hooks, documented below in the @properties
|
||||
* section.
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
@ -362,12 +385,8 @@ FT_BEGIN_HEADER
|
||||
* The same holds for the Type~1 and CID modules if compiled with
|
||||
* `T1_CONFIG_OPTION_OLD_ENGINE`.
|
||||
*
|
||||
* For the 'cff' module, the default engine is 'freetype' if
|
||||
* `CFF_CONFIG_OPTION_OLD_ENGINE` is defined, and 'adobe' otherwise.
|
||||
*
|
||||
* For both the 'type1' and 't1cid' modules, the default engine is
|
||||
* 'freetype' if `T1_CONFIG_OPTION_OLD_ENGINE` is defined, and 'adobe'
|
||||
* otherwise.
|
||||
* For the 'cff' module, the default engine is 'adobe'. For both the
|
||||
* 'type1' and 't1cid' modules, the default engine is 'adobe', too.
|
||||
*
|
||||
* @note:
|
||||
* This property can be used with @FT_Property_Get also.
|
||||
@ -802,6 +821,40 @@ FT_BEGIN_HEADER
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @property:
|
||||
* svg-hooks
|
||||
*
|
||||
* @description:
|
||||
* Set up the interface between FreeType and an extern SVG rendering
|
||||
* library like 'librsvg'. All details on the function hooks can be
|
||||
* found in section @svg_fonts.
|
||||
*
|
||||
* @example:
|
||||
* The following example code expects that the four hook functions
|
||||
* `svg_*` are defined elsewhere. Error handling is omitted, too.
|
||||
*
|
||||
* ```
|
||||
* FT_Library library;
|
||||
* SVG_RendererHooks hooks = {
|
||||
* (SVG_Lib_Init_Func)svg_init,
|
||||
* (SVG_Lib_Free_Func)svg_free,
|
||||
* (SVG_Lib_Render_Func)svg_render,
|
||||
* (SVG_Lib_Preset_Slot_Func)svg_preset_slot };
|
||||
*
|
||||
*
|
||||
* FT_Init_FreeType( &library );
|
||||
*
|
||||
* FT_Property_Set( library, "ot-svg",
|
||||
* "svg-hooks", &hooks );
|
||||
* ```
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @property:
|
||||
@ -1166,48 +1219,18 @@ FT_BEGIN_HEADER
|
||||
* warping
|
||||
*
|
||||
* @description:
|
||||
* **Experimental only**
|
||||
* **Obsolete**
|
||||
*
|
||||
* If FreeType gets compiled with option `AF_CONFIG_OPTION_USE_WARPER` to
|
||||
* activate the warp hinting code in the auto-hinter, this property
|
||||
* switches warping on and off.
|
||||
* This property was always experimental and probably never worked
|
||||
* correctly. It was entirely removed from the FreeType~2 sources. This
|
||||
* entry is only here for historical reference.
|
||||
*
|
||||
* Warping only works in 'normal' auto-hinting mode replacing it. The
|
||||
* idea of the code is to slightly scale and shift a glyph along the
|
||||
* Warping only worked in 'normal' auto-hinting mode replacing it. The
|
||||
* idea of the code was to slightly scale and shift a glyph along the
|
||||
* non-hinted dimension (which is usually the horizontal axis) so that as
|
||||
* much of its segments are aligned (more or less) to the grid. To find
|
||||
* much of its segments were aligned (more or less) to the grid. To find
|
||||
* out a glyph's optimal scaling and shifting value, various parameter
|
||||
* combinations are tried and scored.
|
||||
*
|
||||
* By default, warping is off.
|
||||
*
|
||||
* @note:
|
||||
* This property can be used with @FT_Property_Get also.
|
||||
*
|
||||
* This property can be set via the `FREETYPE_PROPERTIES` environment
|
||||
* variable (using values 1 and 0 for 'on' and 'off', respectively).
|
||||
*
|
||||
* The warping code can also change advance widths. Have a look at the
|
||||
* `lsb_delta` and `rsb_delta` fields in the @FT_GlyphSlotRec structure
|
||||
* for details on improving inter-glyph distances while rendering.
|
||||
*
|
||||
* Since warping is a global property of the auto-hinter it is best to
|
||||
* change its value before rendering any face. Otherwise, you should
|
||||
* reload all faces that get auto-hinted in 'normal' hinting mode.
|
||||
*
|
||||
* @example:
|
||||
* This example shows how to switch on warping (omitting the error
|
||||
* handling).
|
||||
*
|
||||
* ```
|
||||
* FT_Library library;
|
||||
* FT_Bool warping = 1;
|
||||
*
|
||||
*
|
||||
* FT_Init_FreeType( &library );
|
||||
*
|
||||
* FT_Property_Set( library, "autofitter", "warping", &warping );
|
||||
* ```
|
||||
* combinations were tried and scored.
|
||||
*
|
||||
* @since:
|
||||
* 2.6
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType error codes (specification).
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -101,6 +101,8 @@
|
||||
"too many hints" )
|
||||
FT_ERRORDEF_( Invalid_Pixel_Size, 0x17,
|
||||
"invalid pixel size" )
|
||||
FT_ERRORDEF_( Invalid_SVG_Document, 0x18,
|
||||
"invalid SVG document" )
|
||||
|
||||
/* handle errors */
|
||||
|
||||
@ -234,6 +236,8 @@
|
||||
"found FDEF or IDEF opcode in glyf bytecode" )
|
||||
FT_ERRORDEF_( Missing_Bitmap, 0x9D,
|
||||
"missing bitmap in strike" )
|
||||
FT_ERRORDEF_( Missing_SVG_Hooks, 0x9E,
|
||||
"SVG hooks have not been set" )
|
||||
|
||||
/* CFF, CID, and Type 1 errors */
|
||||
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType error code handling (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -281,6 +281,8 @@ FT_BEGIN_HEADER
|
||||
FT_EXPORT( const char* )
|
||||
FT_Error_String( FT_Error error_code );
|
||||
|
||||
/* */
|
||||
|
||||
FT_END_HEADER
|
||||
|
||||
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Support functions for font formats.
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Access of TrueType's 'gasp' table (specification).
|
||||
*
|
||||
* Copyright (C) 2007-2020 by
|
||||
* Copyright (C) 2007-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType convenience functions to handle glyphs (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -126,7 +126,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @description:
|
||||
* A handle to an object used to model a bitmap glyph image. This is a
|
||||
* sub-class of @FT_Glyph, and a pointer to @FT_BitmapGlyphRec.
|
||||
* 'sub-class' of @FT_Glyph, and a pointer to @FT_BitmapGlyphRec.
|
||||
*/
|
||||
typedef struct FT_BitmapGlyphRec_* FT_BitmapGlyph;
|
||||
|
||||
@ -142,7 +142,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @fields:
|
||||
* root ::
|
||||
* The root @FT_Glyph fields.
|
||||
* The root fields of @FT_Glyph.
|
||||
*
|
||||
* left ::
|
||||
* The left-side bearing, i.e., the horizontal distance from the
|
||||
@ -181,7 +181,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @description:
|
||||
* A handle to an object used to model an outline glyph image. This is a
|
||||
* sub-class of @FT_Glyph, and a pointer to @FT_OutlineGlyphRec.
|
||||
* 'sub-class' of @FT_Glyph, and a pointer to @FT_OutlineGlyphRec.
|
||||
*/
|
||||
typedef struct FT_OutlineGlyphRec_* FT_OutlineGlyph;
|
||||
|
||||
@ -222,6 +222,92 @@ FT_BEGIN_HEADER
|
||||
} FT_OutlineGlyphRec;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @type:
|
||||
* FT_SvgGlyph
|
||||
*
|
||||
* @description:
|
||||
* A handle to an object used to model an SVG glyph. This is a
|
||||
* 'sub-class' of @FT_Glyph, and a pointer to @FT_SvgGlyphRec.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
typedef struct FT_SvgGlyphRec_* FT_SvgGlyph;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @struct:
|
||||
* FT_SvgGlyphRec
|
||||
*
|
||||
* @description:
|
||||
* A structure used for OT-SVG glyphs. This is a 'sub-class' of
|
||||
* @FT_GlyphRec.
|
||||
*
|
||||
* @fields:
|
||||
* root ::
|
||||
* The root @FT_GlyphRec fields.
|
||||
*
|
||||
* svg_document ::
|
||||
* A pointer to the SVG document.
|
||||
*
|
||||
* svg_document_length ::
|
||||
* The length of `svg_document`.
|
||||
*
|
||||
* glyph_index ::
|
||||
* The index of the glyph to be rendered.
|
||||
*
|
||||
* metrics ::
|
||||
* A metrics object storing the size information.
|
||||
*
|
||||
* units_per_EM ::
|
||||
* The size of the EM square.
|
||||
*
|
||||
* start_glyph_id ::
|
||||
* The first glyph ID in the glyph range covered by this document.
|
||||
*
|
||||
* end_glyph_id ::
|
||||
* The last glyph ID in the glyph range covered by this document.
|
||||
*
|
||||
* transform ::
|
||||
* A 2x2 transformation matrix to apply to the glyph while rendering
|
||||
* it.
|
||||
*
|
||||
* delta ::
|
||||
* Translation to apply to the glyph while rendering.
|
||||
*
|
||||
* @note:
|
||||
* The Glyph Management API requires @FT_Glyph or its 'sub-class' to have
|
||||
* all the information needed to completely define the glyph's rendering.
|
||||
* Outline-based glyphs can directly apply transformations to the outline
|
||||
* but this is not possible for an SVG document that hasn't been parsed.
|
||||
* Therefore, the transformation is stored along with the document. In
|
||||
* the absence of a 'ViewBox' or 'Width'/'Height' attribute, the size of
|
||||
* the ViewPort should be assumed to be 'units_per_EM'.
|
||||
*/
|
||||
typedef struct FT_SvgGlyphRec_
|
||||
{
|
||||
FT_GlyphRec root;
|
||||
|
||||
FT_Byte* svg_document;
|
||||
FT_ULong svg_document_length;
|
||||
|
||||
FT_UInt glyph_index;
|
||||
|
||||
FT_Size_Metrics metrics;
|
||||
FT_UShort units_per_EM;
|
||||
|
||||
FT_UShort start_glyph_id;
|
||||
FT_UShort end_glyph_id;
|
||||
|
||||
FT_Matrix transform;
|
||||
FT_Vector delta;
|
||||
|
||||
} FT_SvgGlyphRec;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
@ -337,9 +423,9 @@ FT_BEGIN_HEADER
|
||||
* vector.
|
||||
*/
|
||||
FT_EXPORT( FT_Error )
|
||||
FT_Glyph_Transform( FT_Glyph glyph,
|
||||
FT_Matrix* matrix,
|
||||
FT_Vector* delta );
|
||||
FT_Glyph_Transform( FT_Glyph glyph,
|
||||
const FT_Matrix* matrix,
|
||||
const FT_Vector* delta );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
@ -498,9 +584,9 @@ FT_BEGIN_HEADER
|
||||
* The glyph image is translated with the `origin` vector before
|
||||
* rendering.
|
||||
*
|
||||
* The first parameter is a pointer to an @FT_Glyph handle, that will be
|
||||
* The first parameter is a pointer to an @FT_Glyph handle that will be
|
||||
* _replaced_ by this function (with newly allocated data). Typically,
|
||||
* you would use (omitting error handling):
|
||||
* you would do something like the following (omitting error handling).
|
||||
*
|
||||
* ```
|
||||
* FT_Glyph glyph;
|
||||
@ -517,7 +603,7 @@ FT_BEGIN_HEADER
|
||||
* if ( glyph->format != FT_GLYPH_FORMAT_BITMAP )
|
||||
* {
|
||||
* error = FT_Glyph_To_Bitmap( &glyph, FT_RENDER_MODE_NORMAL,
|
||||
* 0, 1 );
|
||||
* 0, 1 );
|
||||
* if ( error ) // `glyph' unchanged
|
||||
* ...
|
||||
* }
|
||||
@ -532,7 +618,7 @@ FT_BEGIN_HEADER
|
||||
* FT_Done_Glyph( glyph );
|
||||
* ```
|
||||
*
|
||||
* Here is another example, again without error handling:
|
||||
* Here is another example, again without error handling.
|
||||
*
|
||||
* ```
|
||||
* FT_Glyph glyphs[MAX_GLYPHS]
|
||||
@ -569,10 +655,10 @@ FT_BEGIN_HEADER
|
||||
* ```
|
||||
*/
|
||||
FT_EXPORT( FT_Error )
|
||||
FT_Glyph_To_Bitmap( FT_Glyph* the_glyph,
|
||||
FT_Render_Mode render_mode,
|
||||
FT_Vector* origin,
|
||||
FT_Bool destroy );
|
||||
FT_Glyph_To_Bitmap( FT_Glyph* the_glyph,
|
||||
FT_Render_Mode render_mode,
|
||||
const FT_Vector* origin,
|
||||
FT_Bool destroy );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Gzip-compressed stream support.
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -5,7 +5,7 @@
|
||||
* FreeType glyph image formats and default raster interface
|
||||
* (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -28,11 +28,6 @@
|
||||
#define FTIMAGE_H_
|
||||
|
||||
|
||||
/* STANDALONE_ is from ftgrays.c */
|
||||
#ifndef STANDALONE_
|
||||
#endif
|
||||
|
||||
|
||||
FT_BEGIN_HEADER
|
||||
|
||||
|
||||
@ -201,6 +196,11 @@ FT_BEGIN_HEADER
|
||||
#define ft_pixel_mode_pal2 FT_PIXEL_MODE_GRAY2
|
||||
#define ft_pixel_mode_pal4 FT_PIXEL_MODE_GRAY4
|
||||
|
||||
/* */
|
||||
|
||||
/* For debugging, the @FT_Pixel_Mode enumeration must stay in sync */
|
||||
/* with the `pixel_modes` array in file `ftobjs.c`. */
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
@ -401,11 +401,11 @@ FT_BEGIN_HEADER
|
||||
* information.
|
||||
*
|
||||
* FT_OUTLINE_OVERLAP ::
|
||||
* This flag indicates that this outline contains overlapping contrours
|
||||
* and the anti-aliased renderer should perform oversampling to
|
||||
* mitigate possible artifacts. This flag should _not_ be set for
|
||||
* well designed glyphs without overlaps because it quadruples the
|
||||
* rendering time.
|
||||
* [Since 2.10.3] This flag indicates that this outline contains
|
||||
* overlapping contours and the anti-aliased renderer should perform
|
||||
* oversampling to mitigate possible artifacts. This flag should _not_
|
||||
* be set for well designed glyphs without overlaps because it quadruples
|
||||
* the rendering time.
|
||||
*
|
||||
* FT_OUTLINE_HIGH_PRECISION ::
|
||||
* This flag indicates that the scan-line converter should try to
|
||||
@ -695,11 +695,13 @@ FT_BEGIN_HEADER
|
||||
* to get a simple enumeration without assigning special numbers.
|
||||
*/
|
||||
#ifndef FT_IMAGE_TAG
|
||||
#define FT_IMAGE_TAG( value, _x1, _x2, _x3, _x4 ) \
|
||||
value = ( ( (unsigned long)_x1 << 24 ) | \
|
||||
( (unsigned long)_x2 << 16 ) | \
|
||||
( (unsigned long)_x3 << 8 ) | \
|
||||
(unsigned long)_x4 )
|
||||
|
||||
#define FT_IMAGE_TAG( value, _x1, _x2, _x3, _x4 ) \
|
||||
value = ( ( FT_STATIC_BYTE_CAST( unsigned long, _x1 ) << 24 ) | \
|
||||
( FT_STATIC_BYTE_CAST( unsigned long, _x2 ) << 16 ) | \
|
||||
( FT_STATIC_BYTE_CAST( unsigned long, _x3 ) << 8 ) | \
|
||||
FT_STATIC_BYTE_CAST( unsigned long, _x4 ) )
|
||||
|
||||
#endif /* FT_IMAGE_TAG */
|
||||
|
||||
|
||||
@ -739,6 +741,10 @@ FT_BEGIN_HEADER
|
||||
* contours. Some Type~1 fonts, like those in the Hershey family,
|
||||
* contain glyphs in this format. These are described as @FT_Outline,
|
||||
* but FreeType isn't currently capable of rendering them correctly.
|
||||
*
|
||||
* FT_GLYPH_FORMAT_SVG ::
|
||||
* [Since 2.12] The glyph is represented by an SVG document in the
|
||||
* 'SVG~' table.
|
||||
*/
|
||||
typedef enum FT_Glyph_Format_
|
||||
{
|
||||
@ -747,7 +753,8 @@ FT_BEGIN_HEADER
|
||||
FT_IMAGE_TAG( FT_GLYPH_FORMAT_COMPOSITE, 'c', 'o', 'm', 'p' ),
|
||||
FT_IMAGE_TAG( FT_GLYPH_FORMAT_BITMAP, 'b', 'i', 't', 's' ),
|
||||
FT_IMAGE_TAG( FT_GLYPH_FORMAT_OUTLINE, 'o', 'u', 't', 'l' ),
|
||||
FT_IMAGE_TAG( FT_GLYPH_FORMAT_PLOTTER, 'p', 'l', 'o', 't' )
|
||||
FT_IMAGE_TAG( FT_GLYPH_FORMAT_PLOTTER, 'p', 'l', 'o', 't' ),
|
||||
FT_IMAGE_TAG( FT_GLYPH_FORMAT_SVG, 'S', 'V', 'G', ' ' )
|
||||
|
||||
} FT_Glyph_Format;
|
||||
|
||||
@ -772,17 +779,6 @@ FT_BEGIN_HEADER
|
||||
/*************************************************************************/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* A raster is a scan converter, in charge of rendering an outline into a
|
||||
* bitmap. This section contains the public API for rasters.
|
||||
*
|
||||
* Note that in FreeType 2, all rasters are now encapsulated within
|
||||
* specific modules called 'renderers'. See `ftrender.h` for more details
|
||||
* on renderers.
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
@ -796,16 +792,35 @@ FT_BEGIN_HEADER
|
||||
* How vectorial outlines are converted into bitmaps and pixmaps.
|
||||
*
|
||||
* @description:
|
||||
* This section contains technical definitions.
|
||||
* A raster or a rasterizer is a scan converter in charge of producing a
|
||||
* pixel coverage bitmap that can be used as an alpha channel when
|
||||
* compositing a glyph with a background. FreeType comes with two
|
||||
* rasterizers: bilevel `raster1` and anti-aliased `smooth` are two
|
||||
* separate modules. They are usually called from the high-level
|
||||
* @FT_Load_Glyph or @FT_Render_Glyph functions and produce the entire
|
||||
* coverage bitmap at once, while staying largely invisible to users.
|
||||
*
|
||||
* Instead of working with complete coverage bitmaps, it is also possible
|
||||
* to intercept consecutive pixel runs on the same scanline with the same
|
||||
* coverage, called _spans_, and process them individually. Only the
|
||||
* `smooth` rasterizer permits this when calling @FT_Outline_Render with
|
||||
* @FT_Raster_Params as described below.
|
||||
*
|
||||
* Working with either complete bitmaps or spans it is important to think
|
||||
* of them as colorless coverage objects suitable as alpha channels to
|
||||
* blend arbitrary colors with a background. For best results, it is
|
||||
* recommended to use gamma correction, too.
|
||||
*
|
||||
* This section also describes the public API needed to set up alternative
|
||||
* @FT_Renderer modules.
|
||||
*
|
||||
* @order:
|
||||
* FT_Raster
|
||||
* FT_Span
|
||||
* FT_SpanFunc
|
||||
*
|
||||
* FT_Raster_Params
|
||||
* FT_RASTER_FLAG_XXX
|
||||
*
|
||||
* FT_Raster
|
||||
* FT_Raster_NewFunc
|
||||
* FT_Raster_DoneFunc
|
||||
* FT_Raster_ResetFunc
|
||||
@ -816,26 +831,14 @@ FT_BEGIN_HEADER
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @type:
|
||||
* FT_Raster
|
||||
*
|
||||
* @description:
|
||||
* An opaque handle (pointer) to a raster object. Each object can be
|
||||
* used independently to convert an outline into a bitmap or pixmap.
|
||||
*/
|
||||
typedef struct FT_RasterRec_* FT_Raster;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @struct:
|
||||
* FT_Span
|
||||
*
|
||||
* @description:
|
||||
* A structure used to model a single span of gray pixels when rendering
|
||||
* an anti-aliased bitmap.
|
||||
* A structure to model a single span of consecutive pixels when
|
||||
* rendering an anti-aliased bitmap.
|
||||
*
|
||||
* @fields:
|
||||
* x ::
|
||||
@ -852,8 +855,8 @@ FT_BEGIN_HEADER
|
||||
* This structure is used by the span drawing callback type named
|
||||
* @FT_SpanFunc that takes the y~coordinate of the span as a parameter.
|
||||
*
|
||||
* The coverage value is always between 0 and 255. If you want less gray
|
||||
* values, the callback function has to reduce them.
|
||||
* The anti-aliased rasterizer produces coverage values from 0 to 255,
|
||||
* this is, from completely transparent to completely opaque.
|
||||
*/
|
||||
typedef struct FT_Span_
|
||||
{
|
||||
@ -871,8 +874,8 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @description:
|
||||
* A function used as a call-back by the anti-aliased renderer in order
|
||||
* to let client applications draw themselves the gray pixel spans on
|
||||
* each scan line.
|
||||
* to let client applications draw themselves the pixel spans on each
|
||||
* scan line.
|
||||
*
|
||||
* @input:
|
||||
* y ::
|
||||
@ -888,11 +891,12 @@ FT_BEGIN_HEADER
|
||||
* User-supplied data that is passed to the callback.
|
||||
*
|
||||
* @note:
|
||||
* This callback allows client applications to directly render the gray
|
||||
* spans of the anti-aliased bitmap to any kind of surfaces.
|
||||
* This callback allows client applications to directly render the spans
|
||||
* of the anti-aliased bitmap to any kind of surfaces.
|
||||
*
|
||||
* This can be used to write anti-aliased outlines directly to a given
|
||||
* background bitmap, and even perform translucency.
|
||||
* background bitmap using alpha compositing. It can also be used for
|
||||
* oversampling and averaging.
|
||||
*/
|
||||
typedef void
|
||||
(*FT_SpanFunc)( int y,
|
||||
@ -962,11 +966,17 @@ FT_BEGIN_HEADER
|
||||
* will be clipped to a box specified in the `clip_box` field of the
|
||||
* @FT_Raster_Params structure. Otherwise, the `clip_box` is
|
||||
* effectively set to the bounding box and all spans are generated.
|
||||
*
|
||||
* FT_RASTER_FLAG_SDF ::
|
||||
* This flag is set to indicate that a signed distance field glyph
|
||||
* image should be generated. This is only used while rendering with
|
||||
* the @FT_RENDER_MODE_SDF render mode.
|
||||
*/
|
||||
#define FT_RASTER_FLAG_DEFAULT 0x0
|
||||
#define FT_RASTER_FLAG_AA 0x1
|
||||
#define FT_RASTER_FLAG_DIRECT 0x2
|
||||
#define FT_RASTER_FLAG_CLIP 0x4
|
||||
#define FT_RASTER_FLAG_SDF 0x8
|
||||
|
||||
/* these constants are deprecated; use the corresponding */
|
||||
/* `FT_RASTER_FLAG_XXX` values instead */
|
||||
@ -1047,6 +1057,23 @@ FT_BEGIN_HEADER
|
||||
} FT_Raster_Params;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @type:
|
||||
* FT_Raster
|
||||
*
|
||||
* @description:
|
||||
* An opaque handle (pointer) to a raster object. Each object can be
|
||||
* used independently to convert an outline into a bitmap or pixmap.
|
||||
*
|
||||
* @note:
|
||||
* In FreeType 2, all rasters are now encapsulated within specific
|
||||
* @FT_Renderer modules and only used in their context.
|
||||
*
|
||||
*/
|
||||
typedef struct FT_RasterRec_* FT_Raster;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType incremental loading (specification).
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -213,9 +213,14 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @description:
|
||||
* A function used to retrieve the basic metrics of a given glyph index
|
||||
* before accessing its data. This is necessary because, in certain
|
||||
* formats like TrueType, the metrics are stored in a different place
|
||||
* from the glyph images proper.
|
||||
* before accessing its data. This allows for handling font types such
|
||||
* as PCL~XL Format~1, Class~2 downloaded TrueType fonts, where the glyph
|
||||
* metrics (`hmtx` and `vmtx` tables) are permitted to be omitted from
|
||||
* the font, and the relevant metrics included in the header of the glyph
|
||||
* outline data. Importantly, this is not intended to allow custom glyph
|
||||
* metrics (for example, Postscript Metrics dictionaries), because that
|
||||
* conflicts with the requirements of outline hinting. Such custom
|
||||
* metrics must be handled separately, by the calling application.
|
||||
*
|
||||
* @input:
|
||||
* incremental ::
|
||||
@ -235,7 +240,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @output:
|
||||
* ametrics ::
|
||||
* The replacement glyph metrics in font units.
|
||||
* The glyph metrics in font units.
|
||||
*
|
||||
*/
|
||||
typedef FT_Error
|
||||
@ -264,7 +269,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* get_glyph_metrics ::
|
||||
* The function to get glyph metrics. May be null if the font does not
|
||||
* provide overriding glyph metrics.
|
||||
* require it.
|
||||
*
|
||||
*/
|
||||
typedef struct FT_Incremental_FuncsRec_
|
||||
|
@ -5,7 +5,7 @@
|
||||
* FreeType API for color filtering of subpixel bitmap glyphs
|
||||
* (specification).
|
||||
*
|
||||
* Copyright (C) 2006-2020 by
|
||||
* Copyright (C) 2006-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -55,13 +55,12 @@ FT_BEGIN_HEADER
|
||||
* ClearType-style LCD rendering exploits the color-striped structure of
|
||||
* LCD pixels, increasing the available resolution in the direction of
|
||||
* the stripe (usually horizontal RGB) by a factor of~3. Using the
|
||||
* subpixels coverages unfiltered can create severe color fringes
|
||||
* subpixel coverages unfiltered can create severe color fringes
|
||||
* especially when rendering thin features. Indeed, to produce
|
||||
* black-on-white text, the nearby color subpixels must be dimmed
|
||||
* equally.
|
||||
*
|
||||
* A good 5-tap FIR filter should be applied to subpixel coverages
|
||||
* regardless of pixel boundaries and should have these properties:
|
||||
* evenly. Therefore, an equalizing 5-tap FIR filter should be applied
|
||||
* to subpixel coverages regardless of pixel boundaries and should have
|
||||
* these properties:
|
||||
*
|
||||
* 1. It should be symmetrical, like {~a, b, c, b, a~}, to avoid
|
||||
* any shifts in appearance.
|
||||
@ -84,7 +83,7 @@ FT_BEGIN_HEADER
|
||||
* Harmony LCD rendering is suitable to panels with any regular subpixel
|
||||
* structure, not just monitors with 3 color striped subpixels, as long
|
||||
* as the color subpixels have fixed positions relative to the pixel
|
||||
* center. In this case, each color channel is then rendered separately
|
||||
* center. In this case, each color channel can be rendered separately
|
||||
* after shifting the outline opposite to the subpixel shift so that the
|
||||
* coverage maps are aligned. This method is immune to color fringes
|
||||
* because the shifts do not change integral coverage.
|
||||
@ -101,9 +100,9 @@ FT_BEGIN_HEADER
|
||||
* clockwise. Harmony with default LCD geometry is equivalent to
|
||||
* ClearType with light filter.
|
||||
*
|
||||
* As a result of ClearType filtering or Harmony rendering, the
|
||||
* dimensions of LCD bitmaps can be either wider or taller than the
|
||||
* dimensions of the corresponding outline with regard to the pixel grid.
|
||||
* As a result of ClearType filtering or Harmony shifts, the resulting
|
||||
* dimensions of LCD bitmaps can be slightly wider or taller than the
|
||||
* dimensions the original outline with regard to the pixel grid.
|
||||
* For example, for @FT_RENDER_MODE_LCD, the filter adds 2~subpixels to
|
||||
* the left, and 2~subpixels to the right. The bitmap offset values are
|
||||
* adjusted accordingly, so clients shouldn't need to modify their layout
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Generic list support for FreeType (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -0,0 +1,184 @@
|
||||
/****************************************************************************
|
||||
*
|
||||
* ftlogging.h
|
||||
*
|
||||
* Additional debugging APIs.
|
||||
*
|
||||
* Copyright (C) 2020-2022 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 FTLOGGING_H_
|
||||
#define FTLOGGING_H_
|
||||
|
||||
|
||||
#include <ft2build.h>
|
||||
#include FT_CONFIG_CONFIG_H
|
||||
|
||||
|
||||
FT_BEGIN_HEADER
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
* debugging_apis
|
||||
*
|
||||
* @title:
|
||||
* External Debugging APIs
|
||||
*
|
||||
* @abstract:
|
||||
* Public APIs to control the `FT_DEBUG_LOGGING` macro.
|
||||
*
|
||||
* @description:
|
||||
* This section contains the declarations of public functions that
|
||||
* enables fine control of what the `FT_DEBUG_LOGGING` macro outputs.
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Trace_Set_Level
|
||||
*
|
||||
* @description:
|
||||
* Change the levels of tracing components of FreeType at run time.
|
||||
*
|
||||
* @input:
|
||||
* tracing_level ::
|
||||
* New tracing value.
|
||||
*
|
||||
* @example:
|
||||
* The following call makes FreeType trace everything but the 'memory'
|
||||
* component.
|
||||
*
|
||||
* ```
|
||||
* FT_Trace_Set_Level( "any:7 memory:0 );
|
||||
* ```
|
||||
*
|
||||
* @note:
|
||||
* This function does nothing if compilation option `FT_DEBUG_LOGGING`
|
||||
* isn't set.
|
||||
*
|
||||
* @since:
|
||||
* 2.11
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( void )
|
||||
FT_Trace_Set_Level( const char* tracing_level );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Trace_Set_Default_Level
|
||||
*
|
||||
* @description:
|
||||
* Reset tracing value of FreeType's components to the default value
|
||||
* (i.e., to the value of the `FT2_DEBUG` environment value or to NULL
|
||||
* if `FT2_DEBUG` is not set).
|
||||
*
|
||||
* @note:
|
||||
* This function does nothing if compilation option `FT_DEBUG_LOGGING`
|
||||
* isn't set.
|
||||
*
|
||||
* @since:
|
||||
* 2.11
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( void )
|
||||
FT_Trace_Set_Default_Level( void );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* FT_Custom_Log_Handler
|
||||
*
|
||||
* @description:
|
||||
* A function typedef that is used to handle the logging of tracing and
|
||||
* debug messages on a file system.
|
||||
*
|
||||
* @input:
|
||||
* ft_component ::
|
||||
* The name of `FT_COMPONENT` from which the current debug or error
|
||||
* message is produced.
|
||||
*
|
||||
* fmt ::
|
||||
* Actual debug or tracing message.
|
||||
*
|
||||
* args::
|
||||
* Arguments of debug or tracing messages.
|
||||
*
|
||||
* @since:
|
||||
* 2.11
|
||||
*
|
||||
*/
|
||||
typedef void
|
||||
(*FT_Custom_Log_Handler)( const char* ft_component,
|
||||
const char* fmt,
|
||||
va_list args );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Set_Log_Handler
|
||||
*
|
||||
* @description:
|
||||
* A function to set a custom log handler.
|
||||
*
|
||||
* @input:
|
||||
* handler ::
|
||||
* New logging function.
|
||||
*
|
||||
* @note:
|
||||
* This function does nothing if compilation option `FT_DEBUG_LOGGING`
|
||||
* isn't set.
|
||||
*
|
||||
* @since:
|
||||
* 2.11
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( void )
|
||||
FT_Set_Log_Handler( FT_Custom_Log_Handler handler );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Set_Default_Log_Handler
|
||||
*
|
||||
* @description:
|
||||
* A function to undo the effect of @FT_Set_Log_Handler, resetting the
|
||||
* log handler to FreeType's built-in version.
|
||||
*
|
||||
* @note:
|
||||
* This function does nothing if compilation option `FT_DEBUG_LOGGING`
|
||||
* isn't set.
|
||||
*
|
||||
* @since:
|
||||
* 2.11
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( void )
|
||||
FT_Set_Default_Log_Handler( void );
|
||||
|
||||
/* */
|
||||
|
||||
|
||||
FT_END_HEADER
|
||||
|
||||
#endif /* FTLOGGING_H_ */
|
||||
|
||||
|
||||
/* END */
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Additional Mac-specific API.
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* Just van Rossum, David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType Multiple Master font interface (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -47,6 +47,9 @@ FT_BEGIN_HEADER
|
||||
* MM fonts, others will work with all three types. They are similar
|
||||
* enough that a consistent interface makes sense.
|
||||
*
|
||||
* For Adobe MM fonts, macro @FT_IS_SFNT returns false. For GX and
|
||||
* OpenType variation fonts, it returns true.
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType modules public interface (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -45,10 +45,12 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @description:
|
||||
* The definitions below are used to manage modules within FreeType.
|
||||
* Modules can be added, upgraded, and removed at runtime. Additionally,
|
||||
* some module properties can be controlled also.
|
||||
* Internal and external modules can be added, upgraded, and removed at
|
||||
* runtime. For example, an alternative renderer or proprietary font
|
||||
* driver can be registered and prioritized. Additionally, some module
|
||||
* properties can also be controlled.
|
||||
*
|
||||
* Here is a list of possible values of the `module_name` field in the
|
||||
* Here is a list of existing values of the `module_name` field in the
|
||||
* @FT_Module_Class structure.
|
||||
*
|
||||
* ```
|
||||
@ -86,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
|
||||
@ -328,6 +331,27 @@ FT_BEGIN_HEADER
|
||||
FT_Module module );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @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.
|
||||
*
|
||||
* @since:
|
||||
* 2.11
|
||||
*
|
||||
*/
|
||||
#define FT_FACE_DRIVER_NAME( face ) \
|
||||
( ( *FT_REINTERPRET_CAST( FT_Module_Class**, \
|
||||
( face )->driver ) )->module_name )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
@ -485,8 +509,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* ```
|
||||
* FREETYPE_PROPERTIES=truetype:interpreter-version=35 \
|
||||
* cff:no-stem-darkening=0 \
|
||||
* autofitter:warping=1
|
||||
* cff:no-stem-darkening=0
|
||||
* ```
|
||||
*
|
||||
* @inout:
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType module error offsets (specification).
|
||||
*
|
||||
* Copyright (C) 2001-2020 by
|
||||
* Copyright (C) 2001-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -171,6 +171,7 @@
|
||||
FT_MODERRDEF( Type42, 0x1400, "Type 42 module" )
|
||||
FT_MODERRDEF( Winfonts, 0x1500, "Windows FON/FNT module" )
|
||||
FT_MODERRDEF( GXvalid, 0x1600, "GX validation module" )
|
||||
FT_MODERRDEF( Sdf, 0x1700, "Signed distance field raster module" )
|
||||
|
||||
|
||||
#ifdef FT_MODERR_END_LIST
|
||||
|
@ -5,7 +5,7 @@
|
||||
* Support for the FT_Outline type used to store glyph shapes of
|
||||
* most scalable font formats (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -109,11 +109,13 @@ FT_BEGIN_HEADER
|
||||
* FreeType error code. 0~means success.
|
||||
*
|
||||
* @note:
|
||||
* A contour that contains a single point only is represented by a 'move
|
||||
* to' operation followed by 'line to' to the same point. In most cases,
|
||||
* it is best to filter this out before using the outline for stroking
|
||||
* purposes (otherwise it would result in a visible dot when round caps
|
||||
* are used).
|
||||
* Degenerate contours, segments, and Bezier arcs may be reported. In
|
||||
* most cases, it is best to filter these out before using the outline
|
||||
* for stroking or other path modification purposes (which may cause
|
||||
* degenerate segments to become non-degenrate and visible, like when
|
||||
* stroke caps are used or the path is otherwise outset). Some glyph
|
||||
* outlines may contain deliberate degenerate single points for mark
|
||||
* attachement.
|
||||
*
|
||||
* Similarly, the function returns success for an empty outline also
|
||||
* (doing nothing, this is, not calling any emitter); if necessary, you
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType API for possible FT_Parameter tags (specification only).
|
||||
*
|
||||
* Copyright (C) 2017-2020 by
|
||||
* Copyright (C) 2017-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -112,6 +112,21 @@ FT_BEGIN_HEADER
|
||||
FT_MAKE_TAG( 'i', 'n', 'c', 'r' )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @enum:
|
||||
* FT_PARAM_TAG_IGNORE_SBIX
|
||||
*
|
||||
* @description:
|
||||
* A tag for @FT_Parameter to make @FT_Open_Face ignore an 'sbix' table
|
||||
* while loading a font. Use this if @FT_FACE_FLAG_SBIX is set and you
|
||||
* want to access the outline glyphs in the font.
|
||||
*
|
||||
*/
|
||||
#define FT_PARAM_TAG_IGNORE_SBIX \
|
||||
FT_MAKE_TAG( 'i', 's', 'b', 'x' )
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @enum:
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType renderer modules public interface (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType size objects management (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -7,7 +7,7 @@
|
||||
*
|
||||
* This is _not_ used to retrieve glyph names!
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType path stroker (specification).
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -5,7 +5,7 @@
|
||||
* FreeType synthesizing code for emboldening and slanting
|
||||
* (specification).
|
||||
*
|
||||
* Copyright (C) 2000-2020 by
|
||||
* Copyright (C) 2000-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType low-level system interface definition (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType trigonometric functions (specification).
|
||||
*
|
||||
* Copyright (C) 2001-2020 by
|
||||
* Copyright (C) 2001-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType simple types definitions (specification only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -413,7 +413,7 @@ FT_BEGIN_HEADER
|
||||
typedef struct FT_Data_
|
||||
{
|
||||
const FT_Byte* pointer;
|
||||
FT_Int length;
|
||||
FT_UInt length;
|
||||
|
||||
} FT_Data;
|
||||
|
||||
@ -479,18 +479,17 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* @description:
|
||||
* This macro converts four-letter tags that are used to label TrueType
|
||||
* tables into an unsigned long, to be used within FreeType.
|
||||
* tables into an `FT_Tag` type, to be used within FreeType.
|
||||
*
|
||||
* @note:
|
||||
* The produced values **must** be 32-bit integers. Don't redefine this
|
||||
* macro.
|
||||
*/
|
||||
#define FT_MAKE_TAG( _x1, _x2, _x3, _x4 ) \
|
||||
(FT_Tag) \
|
||||
( ( (FT_ULong)_x1 << 24 ) | \
|
||||
( (FT_ULong)_x2 << 16 ) | \
|
||||
( (FT_ULong)_x3 << 8 ) | \
|
||||
(FT_ULong)_x4 )
|
||||
#define FT_MAKE_TAG( _x1, _x2, _x3, _x4 ) \
|
||||
( ( FT_STATIC_BYTE_CAST( FT_Tag, _x1 ) << 24 ) | \
|
||||
( FT_STATIC_BYTE_CAST( FT_Tag, _x2 ) << 16 ) | \
|
||||
( FT_STATIC_BYTE_CAST( FT_Tag, _x3 ) << 8 ) | \
|
||||
FT_STATIC_BYTE_CAST( FT_Tag, _x4 ) )
|
||||
|
||||
|
||||
/*************************************************************************/
|
||||
@ -588,7 +587,7 @@ FT_BEGIN_HEADER
|
||||
|
||||
|
||||
#define FT_IS_EMPTY( list ) ( (list).head == 0 )
|
||||
#define FT_BOOL( x ) ( (FT_Bool)( (x) != 0 ) )
|
||||
#define FT_BOOL( x ) FT_STATIC_CAST( FT_Bool, (x) != 0 )
|
||||
|
||||
/* concatenate C tokens */
|
||||
#define FT_ERR_XCAT( x, y ) x ## y
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* High-level 'autohint' module-specific interface (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Basic OpenType/CFF object type definitions (specification).
|
||||
*
|
||||
* Copyright (C) 2017-2020 by
|
||||
* Copyright (C) 2017-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -5,7 +5,7 @@
|
||||
* Basic OpenType/CFF type definitions and interface (specification
|
||||
* only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Compiler-specific macro definitions used internally by FreeType.
|
||||
*
|
||||
* Copyright (C) 2020 by
|
||||
* Copyright (C) 2020-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -71,12 +71,18 @@ FT_BEGIN_HEADER
|
||||
*/
|
||||
#define FT_DUMMY_STMNT FT_BEGIN_STMNT FT_END_STMNT
|
||||
|
||||
#ifdef _WIN64
|
||||
#ifdef __UINTPTR_TYPE__
|
||||
/*
|
||||
* GCC and Clang both provide a `__UINTPTR_TYPE__` that can be used to
|
||||
* avoid a dependency on `stdint.h`.
|
||||
*/
|
||||
# define FT_UINT_TO_POINTER( x ) (void *)(__UINTPTR_TYPE__)(x)
|
||||
#elif defined( _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)
|
||||
# define FT_UINT_TO_POINTER( x ) (void *)(unsigned __int64)(x)
|
||||
#else
|
||||
#define FT_UINT_TO_POINTER( x ) (void *)(unsigned long)(x)
|
||||
# define FT_UINT_TO_POINTER( x ) (void *)(unsigned long)(x)
|
||||
#endif
|
||||
|
||||
/*
|
||||
@ -216,79 +222,93 @@ FT_BEGIN_HEADER
|
||||
#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`. */
|
||||
/* */
|
||||
/*
|
||||
* 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. */
|
||||
/* */
|
||||
/*
|
||||
* 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. */
|
||||
/* */
|
||||
/*
|
||||
* 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_COMPARE_DEF, in addition, ensures the `cdecl` calling
|
||||
* convention on x86, required by the C library function `qsort`.
|
||||
*
|
||||
* 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
|
||||
|
||||
#if defined( __GNUC__ ) && defined( __i386__ )
|
||||
#define FT_COMPARE_DEF( x ) FT_CALLBACK_DEF( x ) __attribute__(( cdecl ))
|
||||
#elif defined( _MSC_VER ) && defined( _M_IX86 )
|
||||
#define FT_COMPARE_DEF( x ) FT_CALLBACK_DEF( x ) __cdecl
|
||||
#elif defined( __WATCOMC__ ) && __WATCOMC__ >= 1240
|
||||
#define FT_COMPARE_DEF( x ) FT_CALLBACK_DEF( x ) __watcall
|
||||
#else
|
||||
#define FT_COMPARE_DEF( x ) FT_CALLBACK_DEF( x )
|
||||
#endif
|
||||
|
||||
#define FT_BASE_CALLBACK( x ) FT_FUNCTION_DECLARATION( x )
|
||||
#define FT_BASE_CALLBACK_DEF( x ) FT_FUNCTION_DEFINITION( x )
|
||||
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Arithmetic computations (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -359,8 +359,8 @@ FT_BEGIN_HEADER
|
||||
|
||||
#ifndef FT_CONFIG_OPTION_NO_ASSEMBLER
|
||||
|
||||
#if defined( __GNUC__ ) && \
|
||||
( __GNUC__ > 3 || ( __GNUC__ == 3 && __GNUC_MINOR__ >= 4 ) )
|
||||
#if defined( __clang__ ) || ( defined( __GNUC__ ) && \
|
||||
( __GNUC__ > 3 || ( __GNUC__ == 3 && __GNUC_MINOR__ >= 4 ) ) )
|
||||
|
||||
#if FT_SIZEOF_INT == 4
|
||||
|
||||
@ -370,12 +370,25 @@ FT_BEGIN_HEADER
|
||||
|
||||
#define FT_MSB( x ) ( 31 - __builtin_clzl( x ) )
|
||||
|
||||
#endif /* __GNUC__ */
|
||||
#endif
|
||||
|
||||
#elif defined( _MSC_VER ) && _MSC_VER >= 1400
|
||||
|
||||
#elif defined( _MSC_VER ) && ( _MSC_VER >= 1400 )
|
||||
#if defined( _WIN32_WCE )
|
||||
|
||||
#if FT_SIZEOF_INT == 4
|
||||
#include <cmnintrin.h>
|
||||
#pragma intrinsic( _CountLeadingZeros )
|
||||
|
||||
#define FT_MSB( x ) ( 31 - _CountLeadingZeros( x ) )
|
||||
|
||||
#elif defined( _M_ARM64 ) || defined( _M_ARM )
|
||||
|
||||
#include <intrin.h>
|
||||
#pragma intrinsic( _CountLeadingZeros )
|
||||
|
||||
#define FT_MSB( x ) ( 31 - _CountLeadingZeros( x ) )
|
||||
|
||||
#elif defined( _M_IX86 ) || defined( _M_AMD64 ) || defined( _M_IA64 )
|
||||
|
||||
#include <intrin.h>
|
||||
#pragma intrinsic( _BitScanReverse )
|
||||
@ -391,15 +404,40 @@ FT_BEGIN_HEADER
|
||||
return (FT_Int32)where;
|
||||
}
|
||||
|
||||
#define FT_MSB( x ) ( FT_MSB_i386( x ) )
|
||||
#define FT_MSB( x ) FT_MSB_i386( x )
|
||||
|
||||
#endif
|
||||
|
||||
#endif /* _MSC_VER */
|
||||
#elif defined( __WATCOMC__ ) && defined( __386__ )
|
||||
|
||||
extern __inline FT_Int32
|
||||
FT_MSB_i386( FT_UInt32 x );
|
||||
|
||||
#pragma aux FT_MSB_i386 = \
|
||||
"bsr eax, eax" \
|
||||
parm [eax] nomemory \
|
||||
value [eax] \
|
||||
modify exact [eax] nomemory;
|
||||
|
||||
#define FT_MSB( x ) FT_MSB_i386( x )
|
||||
|
||||
#elif defined( __DECC ) || defined( __DECCXX )
|
||||
|
||||
#include <builtins.h>
|
||||
|
||||
#define FT_MSB( x ) (FT_Int)( 63 - _leadz( x ) )
|
||||
|
||||
#elif defined( _CRAYC )
|
||||
|
||||
#include <intrinsics.h>
|
||||
|
||||
#define FT_MSB( x ) (FT_Int)( 31 - _leadz32( x ) )
|
||||
|
||||
#endif /* FT_MSB macro definitions */
|
||||
|
||||
#endif /* !FT_CONFIG_OPTION_NO_ASSEMBLER */
|
||||
|
||||
|
||||
#ifndef FT_MSB
|
||||
|
||||
FT_BASE( FT_Int )
|
||||
@ -487,7 +525,7 @@ FT_BEGIN_HEADER
|
||||
#define NEG_INT32( a ) \
|
||||
(FT_Int32)( (FT_UInt32)0 - (FT_UInt32)(a) )
|
||||
|
||||
#ifdef FT_LONG64
|
||||
#ifdef FT_INT64
|
||||
|
||||
#define ADD_INT64( a, b ) \
|
||||
(FT_Int64)( (FT_UInt64)(a) + (FT_UInt64)(b) )
|
||||
@ -498,7 +536,7 @@ FT_BEGIN_HEADER
|
||||
#define NEG_INT64( a ) \
|
||||
(FT_Int64)( (FT_UInt64)0 - (FT_UInt64)(a) )
|
||||
|
||||
#endif /* FT_LONG64 */
|
||||
#endif /* FT_INT64 */
|
||||
|
||||
|
||||
FT_END_HEADER
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Debugging and logging component (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -31,9 +31,24 @@
|
||||
|
||||
#include "compiler-macros.h"
|
||||
|
||||
#ifdef FT_DEBUG_LOGGING
|
||||
#define DLG_STATIC
|
||||
#include <dlg/output.h>
|
||||
#include <dlg/dlg.h>
|
||||
|
||||
#include <freetype/ftlogging.h>
|
||||
#endif /* FT_DEBUG_LOGGING */
|
||||
|
||||
|
||||
FT_BEGIN_HEADER
|
||||
|
||||
/* force the definition of FT_DEBUG_LEVEL_TRACE if FT_DEBUG_LOGGING is */
|
||||
/* already defined. */
|
||||
/* */
|
||||
#ifdef FT_DEBUG_LOGGING
|
||||
#undef FT_DEBUG_LEVEL_TRACE
|
||||
#define FT_DEBUG_LEVEL_TRACE
|
||||
#endif
|
||||
|
||||
/* force the definition of FT_DEBUG_LEVEL_ERROR if FT_DEBUG_LEVEL_TRACE */
|
||||
/* is already defined; this simplifies the following #ifdefs */
|
||||
@ -82,20 +97,66 @@ FT_BEGIN_HEADER
|
||||
* Each component must define the macro FT_COMPONENT to a valid FT_Trace
|
||||
* value before using any TRACE macro.
|
||||
*
|
||||
* To get consistent logging output, there should be no newline character
|
||||
* (i.e., '\n') or a single trailing one in the message string of
|
||||
* `FT_TRACEx` and `FT_ERROR`.
|
||||
*/
|
||||
|
||||
|
||||
/*************************************************************************
|
||||
*
|
||||
* If FT_DEBUG_LOGGING is enabled, tracing messages are sent to dlg's API.
|
||||
* If FT_DEBUG_LOGGING is disabled, tracing messages are sent to
|
||||
* `FT_Message` (defined in ftdebug.c).
|
||||
*/
|
||||
#ifdef FT_DEBUG_LOGGING
|
||||
|
||||
/* we need two macros to convert the names of `FT_COMPONENT` to a string */
|
||||
#define FT_LOGGING_TAG( x ) FT_LOGGING_TAG_( x )
|
||||
#define FT_LOGGING_TAG_( x ) #x
|
||||
|
||||
/* we need two macros to convert the component and the trace level */
|
||||
/* to a string that combines them */
|
||||
#define FT_LOGGING_TAGX( x, y ) FT_LOGGING_TAGX_( x, y )
|
||||
#define FT_LOGGING_TAGX_( x, y ) #x ":" #y
|
||||
|
||||
|
||||
#define FT_LOG( level, varformat ) \
|
||||
do \
|
||||
{ \
|
||||
const char* dlg_tag = FT_LOGGING_TAGX( FT_COMPONENT, level ); \
|
||||
\
|
||||
\
|
||||
ft_add_tag( dlg_tag ); \
|
||||
if ( ft_trace_levels[FT_TRACE_COMP( FT_COMPONENT )] >= level ) \
|
||||
{ \
|
||||
if ( custom_output_handler != NULL ) \
|
||||
FT_Logging_Callback varformat; \
|
||||
else \
|
||||
dlg_trace varformat; \
|
||||
} \
|
||||
ft_remove_tag( dlg_tag ); \
|
||||
} while( 0 )
|
||||
|
||||
#else /* !FT_DEBUG_LOGGING */
|
||||
|
||||
#define FT_LOG( level, varformat ) \
|
||||
do \
|
||||
{ \
|
||||
if ( ft_trace_levels[FT_TRACE_COMP( FT_COMPONENT )] >= level ) \
|
||||
FT_Message varformat; \
|
||||
} while ( 0 )
|
||||
|
||||
#endif /* !FT_DEBUG_LOGGING */
|
||||
|
||||
|
||||
#ifdef FT_DEBUG_LEVEL_TRACE
|
||||
|
||||
/* we need two macros here to make cpp expand `FT_COMPONENT' */
|
||||
#define FT_TRACE_COMP( x ) FT_TRACE_COMP_( x )
|
||||
#define FT_TRACE_COMP_( x ) trace_ ## x
|
||||
|
||||
#define FT_TRACE( level, varformat ) \
|
||||
do \
|
||||
{ \
|
||||
if ( ft_trace_levels[FT_TRACE_COMP( FT_COMPONENT )] >= level ) \
|
||||
FT_Message varformat; \
|
||||
} while ( 0 )
|
||||
#define FT_TRACE( level, varformat ) FT_LOG( level, varformat )
|
||||
|
||||
#else /* !FT_DEBUG_LEVEL_TRACE */
|
||||
|
||||
@ -204,7 +265,32 @@ FT_BEGIN_HEADER
|
||||
|
||||
#ifdef FT_DEBUG_LEVEL_ERROR
|
||||
|
||||
#define FT_ERROR( varformat ) FT_Message varformat
|
||||
/**************************************************************************
|
||||
*
|
||||
* If FT_DEBUG_LOGGING is enabled, error messages are sent to dlg's API.
|
||||
* If FT_DEBUG_LOGGING is disabled, error messages are sent to `FT_Message`
|
||||
* (defined in ftdebug.c).
|
||||
*
|
||||
*/
|
||||
#ifdef FT_DEBUG_LOGGING
|
||||
|
||||
#define FT_ERROR( varformat ) \
|
||||
do \
|
||||
{ \
|
||||
const char* dlg_tag = FT_LOGGING_TAG( FT_COMPONENT ); \
|
||||
\
|
||||
\
|
||||
ft_add_tag( dlg_tag ); \
|
||||
dlg_trace varformat; \
|
||||
ft_remove_tag( dlg_tag ); \
|
||||
} while ( 0 )
|
||||
|
||||
#else /* !FT_DEBUG_LOGGING */
|
||||
|
||||
#define FT_ERROR( varformat ) FT_Message varformat
|
||||
|
||||
#endif /* !FT_DEBUG_LOGGING */
|
||||
|
||||
|
||||
#else /* !FT_DEBUG_LEVEL_ERROR */
|
||||
|
||||
@ -277,6 +363,77 @@ FT_BEGIN_HEADER
|
||||
FT_BASE( void )
|
||||
ft_debug_init( void );
|
||||
|
||||
|
||||
#ifdef FT_DEBUG_LOGGING
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* 'dlg' uses output handlers to control how and where log messages are
|
||||
* printed. Therefore we need to define a default output handler for
|
||||
* FreeType.
|
||||
*/
|
||||
FT_BASE( void )
|
||||
ft_log_handler( const struct dlg_origin* origin,
|
||||
const char* string,
|
||||
void* data );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* 1. `ft_default_log_handler` stores the function pointer that is used
|
||||
* internally by FreeType to print logs to a file.
|
||||
*
|
||||
* 2. `custom_output_handler` stores the function pointer to the callback
|
||||
* function provided by the user.
|
||||
*
|
||||
* It is defined in `ftdebug.c`.
|
||||
*/
|
||||
extern dlg_handler ft_default_log_handler;
|
||||
extern FT_Custom_Log_Handler custom_output_handler;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* If FT_DEBUG_LOGGING macro is enabled, FreeType needs to initialize and
|
||||
* un-initialize `FILE*`.
|
||||
*
|
||||
* These functions are defined in `ftdebug.c`.
|
||||
*/
|
||||
FT_BASE( void )
|
||||
ft_logging_init( void );
|
||||
|
||||
FT_BASE( void )
|
||||
ft_logging_deinit( void );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* For printing the name of `FT_COMPONENT` along with the actual log we
|
||||
* need to add a tag with the name of `FT_COMPONENT`.
|
||||
*
|
||||
* These functions are defined in `ftdebug.c`.
|
||||
*/
|
||||
FT_BASE( void )
|
||||
ft_add_tag( const char* tag );
|
||||
|
||||
FT_BASE( void )
|
||||
ft_remove_tag( const char* tag );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* A function to print log data using a custom callback logging function
|
||||
* (which is set using `FT_Set_Log_Handler`).
|
||||
*
|
||||
* This function is defined in `ftdebug.c`.
|
||||
*/
|
||||
FT_BASE( void )
|
||||
FT_Logging_Callback( const char* fmt,
|
||||
... );
|
||||
|
||||
#endif /* FT_DEBUG_LOGGING */
|
||||
|
||||
|
||||
FT_END_HEADER
|
||||
|
||||
#endif /* FTDEBUG_H_ */
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType internal font driver interface (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType glyph loader (specification).
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -22,6 +22,7 @@
|
||||
|
||||
#include <freetype/freetype.h>
|
||||
|
||||
#include "compiler-macros.h"
|
||||
|
||||
FT_BEGIN_HEADER
|
||||
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType memory management macros (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -344,14 +344,13 @@ extern "C++"
|
||||
#define FT_RENEW_ARRAY( ptr, curcnt, newcnt ) \
|
||||
FT_MEM_SET_ERROR( FT_MEM_RENEW_ARRAY( ptr, curcnt, newcnt ) )
|
||||
|
||||
#define FT_QNEW( ptr ) \
|
||||
FT_MEM_SET_ERROR( FT_MEM_QNEW( ptr ) )
|
||||
#define FT_QNEW( ptr ) FT_MEM_SET_ERROR( FT_MEM_QNEW( ptr ) )
|
||||
|
||||
#define FT_QNEW_ARRAY( ptr, count ) \
|
||||
FT_MEM_SET_ERROR( FT_MEM_NEW_ARRAY( ptr, count ) )
|
||||
#define FT_QNEW_ARRAY( ptr, count ) \
|
||||
FT_MEM_SET_ERROR( FT_MEM_QNEW_ARRAY( ptr, count ) )
|
||||
|
||||
#define FT_QRENEW_ARRAY( ptr, curcnt, newcnt ) \
|
||||
FT_MEM_SET_ERROR( FT_MEM_RENEW_ARRAY( ptr, curcnt, newcnt ) )
|
||||
#define FT_QRENEW_ARRAY( ptr, curcnt, newcnt ) \
|
||||
FT_MEM_SET_ERROR( FT_MEM_QRENEW_ARRAY( ptr, curcnt, newcnt ) )
|
||||
|
||||
|
||||
FT_BASE( FT_Pointer )
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType private base classes (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -418,7 +418,8 @@ FT_BEGIN_HEADER
|
||||
* initializing the glyph slot.
|
||||
*/
|
||||
|
||||
#define FT_GLYPH_OWN_BITMAP 0x1U
|
||||
#define FT_GLYPH_OWN_BITMAP 0x1U
|
||||
#define FT_GLYPH_OWN_GZIP_SVG 0x2U
|
||||
|
||||
typedef struct FT_Slot_InternalRec_
|
||||
{
|
||||
@ -673,7 +674,7 @@ FT_BEGIN_HEADER
|
||||
|
||||
|
||||
/* Set the metrics according to a size request. */
|
||||
FT_BASE( void )
|
||||
FT_BASE( FT_Error )
|
||||
FT_Request_Metrics( FT_Face face,
|
||||
FT_Size_Request req );
|
||||
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Get and set properties of PostScript drivers (specification).
|
||||
*
|
||||
* Copyright (C) 2017-2020 by
|
||||
* Copyright (C) 2017-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Embedded resource forks accessor (specification).
|
||||
*
|
||||
* Copyright (C) 2004-2020 by
|
||||
* Copyright (C) 2004-2022 by
|
||||
* Masatake YAMATO and Redhat K.K.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType services (specification only).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Stream handling (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -196,9 +196,9 @@ FT_BEGIN_HEADER
|
||||
FT_BYTE_U32( p, 2, 8 ) | \
|
||||
FT_BYTE_U32( p, 3, 0 ) )
|
||||
|
||||
#define FT_PEEK_OFF3( p ) FT_INT32( FT_BYTE_U32( p, 0, 16 ) | \
|
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
FT_BYTE_U32( p, 2, 0 ) )
|
||||
#define FT_PEEK_OFF3( p ) ( FT_INT32( FT_BYTE_U32( p, 0, 24 ) | \
|
||||
FT_BYTE_U32( p, 1, 16 ) | \
|
||||
FT_BYTE_U32( p, 2, 8 ) ) >> 8 )
|
||||
|
||||
#define FT_PEEK_UOFF3( p ) FT_UINT32( FT_BYTE_U32( p, 0, 16 ) | \
|
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
@ -220,9 +220,9 @@ FT_BEGIN_HEADER
|
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
FT_BYTE_U32( p, 0, 0 ) )
|
||||
|
||||
#define FT_PEEK_OFF3_LE( p ) FT_INT32( FT_BYTE_U32( p, 2, 16 ) | \
|
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
FT_BYTE_U32( p, 0, 0 ) )
|
||||
#define FT_PEEK_OFF3_LE( p ) ( FT_INT32( FT_BYTE_U32( p, 2, 24 ) | \
|
||||
FT_BYTE_U32( p, 1, 16 ) | \
|
||||
FT_BYTE_U32( p, 0, 8 ) ) >> 8 )
|
||||
|
||||
#define FT_PEEK_UOFF3_LE( p ) FT_UINT32( FT_BYTE_U32( p, 2, 16 ) | \
|
||||
FT_BYTE_U32( p, 1, 8 ) | \
|
||||
@ -305,11 +305,10 @@ FT_BEGIN_HEADER
|
||||
#else
|
||||
#define FT_GET_MACRO( func, type ) ( (type)func( stream ) )
|
||||
|
||||
#define FT_GET_CHAR() FT_GET_MACRO( FT_Stream_GetChar, FT_Char )
|
||||
#define FT_GET_BYTE() FT_GET_MACRO( FT_Stream_GetChar, FT_Byte )
|
||||
#define FT_GET_CHAR() FT_GET_MACRO( FT_Stream_GetByte, FT_Char )
|
||||
#define FT_GET_BYTE() FT_GET_MACRO( FT_Stream_GetByte, FT_Byte )
|
||||
#define FT_GET_SHORT() FT_GET_MACRO( FT_Stream_GetUShort, FT_Short )
|
||||
#define FT_GET_USHORT() FT_GET_MACRO( FT_Stream_GetUShort, FT_UShort )
|
||||
#define FT_GET_OFF3() FT_GET_MACRO( FT_Stream_GetUOffset, FT_Long )
|
||||
#define FT_GET_UOFF3() FT_GET_MACRO( FT_Stream_GetUOffset, FT_ULong )
|
||||
#define FT_GET_LONG() FT_GET_MACRO( FT_Stream_GetULong, FT_Long )
|
||||
#define FT_GET_ULONG() FT_GET_MACRO( FT_Stream_GetULong, FT_ULong )
|
||||
@ -333,11 +332,10 @@ FT_BEGIN_HEADER
|
||||
* `FT_STREAM_POS'. They use the full machinery to check whether a read is
|
||||
* valid.
|
||||
*/
|
||||
#define FT_READ_BYTE( var ) FT_READ_MACRO( FT_Stream_ReadChar, FT_Byte, var )
|
||||
#define FT_READ_CHAR( var ) FT_READ_MACRO( FT_Stream_ReadChar, FT_Char, var )
|
||||
#define FT_READ_BYTE( var ) FT_READ_MACRO( FT_Stream_ReadByte, FT_Byte, var )
|
||||
#define FT_READ_CHAR( var ) FT_READ_MACRO( FT_Stream_ReadByte, FT_Char, var )
|
||||
#define FT_READ_SHORT( var ) FT_READ_MACRO( FT_Stream_ReadUShort, FT_Short, var )
|
||||
#define FT_READ_USHORT( var ) FT_READ_MACRO( FT_Stream_ReadUShort, FT_UShort, var )
|
||||
#define FT_READ_OFF3( var ) FT_READ_MACRO( FT_Stream_ReadUOffset, FT_Long, var )
|
||||
#define FT_READ_UOFF3( var ) FT_READ_MACRO( FT_Stream_ReadUOffset, FT_ULong, var )
|
||||
#define FT_READ_LONG( var ) FT_READ_MACRO( FT_Stream_ReadULong, FT_Long, var )
|
||||
#define FT_READ_ULONG( var ) FT_READ_MACRO( FT_Stream_ReadULong, FT_ULong, var )
|
||||
@ -457,8 +455,8 @@ FT_BEGIN_HEADER
|
||||
|
||||
|
||||
/* read a byte from an entered frame */
|
||||
FT_BASE( FT_Char )
|
||||
FT_Stream_GetChar( FT_Stream stream );
|
||||
FT_BASE( FT_Byte )
|
||||
FT_Stream_GetByte( FT_Stream stream );
|
||||
|
||||
/* read a 16-bit big-endian unsigned integer from an entered frame */
|
||||
FT_BASE( FT_UShort )
|
||||
@ -482,8 +480,8 @@ FT_BEGIN_HEADER
|
||||
|
||||
|
||||
/* read a byte from a stream */
|
||||
FT_BASE( FT_Char )
|
||||
FT_Stream_ReadChar( FT_Stream stream,
|
||||
FT_BASE( FT_Byte )
|
||||
FT_Stream_ReadByte( FT_Stream stream,
|
||||
FT_Error* error );
|
||||
|
||||
/* read a 16-bit big-endian unsigned integer from a stream */
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Tracing handling (specification only).
|
||||
*
|
||||
* Copyright (C) 2002-2020 by
|
||||
* Copyright (C) 2002-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -18,6 +18,11 @@
|
||||
|
||||
/* definitions of trace levels for FreeType 2 */
|
||||
|
||||
/* the maximum string length (if the argument to `FT_TRACE_DEF` */
|
||||
/* gets used as a string) plus one charachter for ':' plus */
|
||||
/* another one for the trace level */
|
||||
#define FT_MAX_TRACE_LEVEL_LENGTH (9 + 1 + 1)
|
||||
|
||||
/* the first level must always be `trace_any' */
|
||||
FT_TRACE_DEF( any )
|
||||
|
||||
@ -38,12 +43,17 @@ FT_TRACE_DEF( checksum ) /* bitmap checksum (ftobjs.c) */
|
||||
FT_TRACE_DEF( mm ) /* MM interface (ftmm.c) */
|
||||
FT_TRACE_DEF( psprops ) /* PS driver properties (ftpsprop.c) */
|
||||
FT_TRACE_DEF( raccess ) /* resource fork accessor (ftrfork.c) */
|
||||
FT_TRACE_DEF( raster ) /* monochrome rasterizer (ftraster.c) */
|
||||
FT_TRACE_DEF( smooth ) /* anti-aliasing raster (ftgrays.c) */
|
||||
FT_TRACE_DEF( synth ) /* bold/slant synthesizer (ftsynth.c) */
|
||||
|
||||
/* Cache sub-system */
|
||||
FT_TRACE_DEF( cache ) /* cache sub-system (ftcache.c, etc.) */
|
||||
/* rasterizers */
|
||||
FT_TRACE_DEF( raster ) /* monochrome rasterizer (ftraster.c) */
|
||||
FT_TRACE_DEF( smooth ) /* anti-aliasing raster (ftgrays.c) */
|
||||
|
||||
/* ot-svg module */
|
||||
FT_TRACE_DEF( otsvg ) /* OT-SVG renderer (ftsvg.c) */
|
||||
|
||||
/* cache sub-system */
|
||||
FT_TRACE_DEF( cache ) /* cache sub-system (ftcache.c, etc.) */
|
||||
|
||||
/* SFNT driver components */
|
||||
FT_TRACE_DEF( sfdriver ) /* SFNT font driver (sfdriver.c) */
|
||||
@ -54,6 +64,7 @@ FT_TRACE_DEF( ttbdf ) /* TrueType embedded BDF (ttbdf.c) */
|
||||
FT_TRACE_DEF( ttcmap ) /* charmap handler (ttcmap.c) */
|
||||
FT_TRACE_DEF( ttcolr ) /* glyph layer table (ttcolr.c) */
|
||||
FT_TRACE_DEF( ttcpal ) /* color palette table (ttcpal.c) */
|
||||
FT_TRACE_DEF( ttsvg ) /* OpenType SVG table (ttsvg.c) */
|
||||
FT_TRACE_DEF( ttkern ) /* kerning handler (ttkern.c) */
|
||||
FT_TRACE_DEF( ttload ) /* basic TrueType tables (ttload.c) */
|
||||
FT_TRACE_DEF( ttmtx ) /* metrics-related tables (ttmtx.c) */
|
||||
@ -77,6 +88,7 @@ FT_TRACE_DEF( t1objs )
|
||||
FT_TRACE_DEF( t1parse )
|
||||
|
||||
/* PostScript helper module `psaux' */
|
||||
FT_TRACE_DEF( afmparse )
|
||||
FT_TRACE_DEF( cffdecode )
|
||||
FT_TRACE_DEF( psconv )
|
||||
FT_TRACE_DEF( psobjs )
|
||||
@ -151,8 +163,10 @@ FT_TRACE_DEF( afglobal )
|
||||
FT_TRACE_DEF( afhints )
|
||||
FT_TRACE_DEF( afmodule )
|
||||
FT_TRACE_DEF( aflatin )
|
||||
FT_TRACE_DEF( aflatin2 )
|
||||
FT_TRACE_DEF( afshaper )
|
||||
FT_TRACE_DEF( afwarp )
|
||||
|
||||
/* SDF components */
|
||||
FT_TRACE_DEF( sdf ) /* signed distance raster for outlines (ftsdf.c) */
|
||||
FT_TRACE_DEF( bsdf ) /* signed distance raster for bitmaps (ftbsdf.c) */
|
||||
|
||||
/* END */
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType validation support (specification).
|
||||
*
|
||||
* Copyright (C) 2004-2020 by
|
||||
* Copyright (C) 2004-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -5,7 +5,7 @@
|
||||
* Auxiliary functions and data structures related to PostScript fonts
|
||||
* (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -6,7 +6,7 @@
|
||||
* recorders (specification only). These are used to support native
|
||||
* T1/T2 hints in the 'type1', 'cid', and 'cff' font drivers.
|
||||
*
|
||||
* Copyright (C) 2001-2020 by
|
||||
* Copyright (C) 2001-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType BDF services (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType CFF tables loader service (specification).
|
||||
*
|
||||
* Copyright (C) 2017-2020 by
|
||||
* Copyright (C) 2017-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType CID font services (specification).
|
||||
*
|
||||
* Copyright (C) 2007-2020 by
|
||||
* Copyright (C) 2007-2022 by
|
||||
* Derek Clegg and Michael Toftdal.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType font format service (specification only).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType glyph dictionary services (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType API for validating TrueTypeGX/AAT tables (specification).
|
||||
*
|
||||
* Copyright (C) 2004-2020 by
|
||||
* Copyright (C) 2004-2022 by
|
||||
* Masatake YAMATO, Red Hat K.K.,
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType Kerning service (specification).
|
||||
*
|
||||
* Copyright (C) 2006-2020 by
|
||||
* Copyright (C) 2006-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType services for metrics variations (specification).
|
||||
*
|
||||
* Copyright (C) 2016-2020 by
|
||||
* Copyright (C) 2016-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType Multiple Masters and GX var services (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType OpenType validation service (specification).
|
||||
*
|
||||
* Copyright (C) 2004-2020 by
|
||||
* Copyright (C) 2004-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Internal PFR service functions (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType PostScript name services (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType property service (specification).
|
||||
*
|
||||
* Copyright (C) 2012-2020 by
|
||||
* Copyright (C) 2012-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType PostScript charmap service (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType PostScript info service (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType SFNT table loading service (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType TrueType/sfnt cmap extra information service.
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* Masatake YAMATO, Redhat K.K.,
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType TrueType engine query service (specification).
|
||||
*
|
||||
* Copyright (C) 2006-2020 by
|
||||
* Copyright (C) 2006-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType TrueType glyph service.
|
||||
*
|
||||
* Copyright (C) 2007-2020 by
|
||||
* Copyright (C) 2007-2022 by
|
||||
* David Turner.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* The FreeType Windows FNT/FONT service (specification).
|
||||
*
|
||||
* Copyright (C) 2003-2020 by
|
||||
* Copyright (C) 2003-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* High-level 'sfnt' driver interface (specification).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -311,6 +311,33 @@ FT_BEGIN_HEADER
|
||||
TT_SBit_MetricsRec *ametrics );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* TT_Load_Svg_Doc_Func
|
||||
*
|
||||
* @description:
|
||||
* Scan the SVG document list to find the document containing the glyph
|
||||
* that has the ID 'glyph*XXX*', where *XXX* is the value of
|
||||
* `glyph_index` as a decimal integer.
|
||||
*
|
||||
* @inout:
|
||||
* glyph ::
|
||||
* The glyph slot from which pointers to the SVG document list is to be
|
||||
* grabbed. The results are stored back in the slot.
|
||||
*
|
||||
* @input:
|
||||
* glyph_index ::
|
||||
* The index of the glyph that is to be looked up.
|
||||
*
|
||||
* @return:
|
||||
* FreeType error code. 0 means success.
|
||||
*/
|
||||
typedef FT_Error
|
||||
(*TT_Load_Svg_Doc_Func)( FT_GlyphSlot glyph,
|
||||
FT_UInt glyph_index );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
@ -524,6 +551,170 @@ FT_BEGIN_HEADER
|
||||
FT_LayerIterator* iterator );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* TT_Get_Color_Glyph_Paint_Func
|
||||
*
|
||||
* @description:
|
||||
* Find the root @FT_OpaquePaint object for a given glyph ID.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* The target face object.
|
||||
*
|
||||
* base_glyph ::
|
||||
* The glyph index the colored glyph layers are associated with.
|
||||
*
|
||||
* @output:
|
||||
* paint ::
|
||||
* The root @FT_OpaquePaint object.
|
||||
*
|
||||
* @return:
|
||||
* Value~1 if everything is OK. If no color glyph is found, or the root
|
||||
* paint could not be retrieved, value~0 gets returned. In case of an
|
||||
* error, value~0 is returned also.
|
||||
*/
|
||||
typedef FT_Bool
|
||||
( *TT_Get_Color_Glyph_Paint_Func )( TT_Face face,
|
||||
FT_UInt base_glyph,
|
||||
FT_Color_Root_Transform root_transform,
|
||||
FT_OpaquePaint *paint );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* TT_Get_Color_Glyph_ClipBox_Func
|
||||
*
|
||||
* @description:
|
||||
* Search for a 'COLR' v1 clip box for the specified `base_glyph` and
|
||||
* fill the `clip_box` parameter with the 'COLR' v1 'ClipBox' information
|
||||
* if one is found.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* A handle to the parent face object.
|
||||
*
|
||||
* base_glyph ::
|
||||
* The glyph index for which to retrieve the clip box.
|
||||
*
|
||||
* @output:
|
||||
* clip_box ::
|
||||
* The clip box for the requested `base_glyph` if one is found. The
|
||||
* clip box is computed taking scale and transformations configured on
|
||||
* the @FT_Face into account. @FT_ClipBox contains @FT_Vector values
|
||||
* in 26.6 format.
|
||||
*
|
||||
* @note:
|
||||
* To retrieve the clip box in font units, reset scale to units-per-em
|
||||
* and remove transforms configured using @FT_Set_Transform.
|
||||
*
|
||||
* @return:
|
||||
* Value~1 if a ClipBox is found. If no clip box is found or an
|
||||
* error occured, value~0 is returned.
|
||||
*/
|
||||
typedef FT_Bool
|
||||
( *TT_Get_Color_Glyph_ClipBox_Func )( TT_Face face,
|
||||
FT_UInt base_glyph,
|
||||
FT_ClipBox* clip_box );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* TT_Get_Paint_Layers_Func
|
||||
*
|
||||
* @description:
|
||||
* Access the layers of a `PaintColrLayers` table.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* The target face object.
|
||||
*
|
||||
* @inout:
|
||||
* iterator ::
|
||||
* The @FT_LayerIterator from an @FT_PaintColrLayers object, for which
|
||||
* the layers are to be retrieved. The internal state of the iterator
|
||||
* is incremented after one call to this function for retrieving one
|
||||
* layer.
|
||||
*
|
||||
* @output:
|
||||
* paint ::
|
||||
* The root @FT_OpaquePaint object referencing the actual paint table.
|
||||
*
|
||||
* @return:
|
||||
* Value~1 if everything is OK. Value~0 gets returned when the paint
|
||||
* object can not be retrieved or any other error occurs.
|
||||
*/
|
||||
typedef FT_Bool
|
||||
( *TT_Get_Paint_Layers_Func )( TT_Face face,
|
||||
FT_LayerIterator* iterator,
|
||||
FT_OpaquePaint *paint );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* TT_Get_Colorline_Stops_Func
|
||||
*
|
||||
* @description:
|
||||
* Get the gradient and solid fill information for a given glyph.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* The target face object.
|
||||
*
|
||||
* @inout:
|
||||
* iterator ::
|
||||
* An @FT_ColorStopIterator object. For the first call you should set
|
||||
* `iterator->p` to `NULL`. For all following calls, simply use the
|
||||
* same object again.
|
||||
*
|
||||
* @output:
|
||||
* color_stop ::
|
||||
* Color index and alpha value for the retrieved color stop.
|
||||
*
|
||||
* @return:
|
||||
* Value~1 if everything is OK. If there are no more color stops,
|
||||
* value~0 gets returned. In case of an error, value~0 is returned
|
||||
* also.
|
||||
*/
|
||||
typedef FT_Bool
|
||||
( *TT_Get_Colorline_Stops_Func )( TT_Face face,
|
||||
FT_ColorStop *color_stop,
|
||||
FT_ColorStopIterator* iterator );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* TT_Get_Paint_Func
|
||||
*
|
||||
* @description:
|
||||
* Get the paint details for a given @FT_OpaquePaint object.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* The target face object.
|
||||
*
|
||||
* opaque_paint ::
|
||||
* The @FT_OpaquePaint object.
|
||||
*
|
||||
* @output:
|
||||
* paint ::
|
||||
* An @FT_COLR_Paint object holding the details on `opaque_paint`.
|
||||
*
|
||||
* @return:
|
||||
* Value~1 if everything is OK. Value~0 if no details can be found for
|
||||
* this paint or any other error occured.
|
||||
*/
|
||||
typedef FT_Bool
|
||||
( *TT_Get_Paint_Func )( TT_Face face,
|
||||
FT_OpaquePaint opaque_paint,
|
||||
FT_COLR_Paint *paint );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
@ -709,73 +900,83 @@ FT_BEGIN_HEADER
|
||||
*/
|
||||
typedef struct SFNT_Interface_
|
||||
{
|
||||
TT_Loader_GotoTableFunc goto_table;
|
||||
TT_Loader_GotoTableFunc goto_table;
|
||||
|
||||
TT_Init_Face_Func init_face;
|
||||
TT_Load_Face_Func load_face;
|
||||
TT_Done_Face_Func done_face;
|
||||
FT_Module_Requester get_interface;
|
||||
TT_Init_Face_Func init_face;
|
||||
TT_Load_Face_Func load_face;
|
||||
TT_Done_Face_Func done_face;
|
||||
FT_Module_Requester get_interface;
|
||||
|
||||
TT_Load_Any_Func load_any;
|
||||
TT_Load_Any_Func load_any;
|
||||
|
||||
/* these functions are called by `load_face' but they can also */
|
||||
/* be called from external modules, if there is a need to do so */
|
||||
TT_Load_Table_Func load_head;
|
||||
TT_Load_Metrics_Func load_hhea;
|
||||
TT_Load_Table_Func load_cmap;
|
||||
TT_Load_Table_Func load_maxp;
|
||||
TT_Load_Table_Func load_os2;
|
||||
TT_Load_Table_Func load_post;
|
||||
TT_Load_Table_Func load_head;
|
||||
TT_Load_Metrics_Func load_hhea;
|
||||
TT_Load_Table_Func load_cmap;
|
||||
TT_Load_Table_Func load_maxp;
|
||||
TT_Load_Table_Func load_os2;
|
||||
TT_Load_Table_Func load_post;
|
||||
|
||||
TT_Load_Table_Func load_name;
|
||||
TT_Free_Table_Func free_name;
|
||||
TT_Load_Table_Func load_name;
|
||||
TT_Free_Table_Func free_name;
|
||||
|
||||
/* this field was called `load_kerning' up to version 2.1.10 */
|
||||
TT_Load_Table_Func load_kern;
|
||||
TT_Load_Table_Func load_kern;
|
||||
|
||||
TT_Load_Table_Func load_gasp;
|
||||
TT_Load_Table_Func load_pclt;
|
||||
TT_Load_Table_Func load_gasp;
|
||||
TT_Load_Table_Func load_pclt;
|
||||
|
||||
/* see `ttload.h'; this field was called `load_bitmap_header' up to */
|
||||
/* version 2.1.10 */
|
||||
TT_Load_Table_Func load_bhed;
|
||||
TT_Load_Table_Func load_bhed;
|
||||
|
||||
TT_Load_SBit_Image_Func load_sbit_image;
|
||||
TT_Load_SBit_Image_Func load_sbit_image;
|
||||
|
||||
/* see `ttpost.h' */
|
||||
TT_Get_PS_Name_Func get_psname;
|
||||
TT_Free_Table_Func free_psnames;
|
||||
TT_Get_PS_Name_Func get_psname;
|
||||
TT_Free_Table_Func free_psnames;
|
||||
|
||||
/* starting here, the structure differs from version 2.1.7 */
|
||||
|
||||
/* this field was introduced in version 2.1.8, named `get_psname' */
|
||||
TT_Face_GetKerningFunc get_kerning;
|
||||
TT_Face_GetKerningFunc get_kerning;
|
||||
|
||||
/* new elements introduced after version 2.1.10 */
|
||||
|
||||
/* load the font directory, i.e., the offset table and */
|
||||
/* the table directory */
|
||||
TT_Load_Table_Func load_font_dir;
|
||||
TT_Load_Metrics_Func load_hmtx;
|
||||
TT_Load_Table_Func load_font_dir;
|
||||
TT_Load_Metrics_Func load_hmtx;
|
||||
|
||||
TT_Load_Table_Func load_eblc;
|
||||
TT_Free_Table_Func free_eblc;
|
||||
TT_Load_Table_Func load_eblc;
|
||||
TT_Free_Table_Func free_eblc;
|
||||
|
||||
TT_Set_SBit_Strike_Func set_sbit_strike;
|
||||
TT_Load_Strike_Metrics_Func load_strike_metrics;
|
||||
|
||||
TT_Load_Table_Func load_cpal;
|
||||
TT_Load_Table_Func load_colr;
|
||||
TT_Free_Table_Func free_cpal;
|
||||
TT_Free_Table_Func free_colr;
|
||||
TT_Set_Palette_Func set_palette;
|
||||
TT_Get_Colr_Layer_Func get_colr_layer;
|
||||
TT_Blend_Colr_Func colr_blend;
|
||||
TT_Load_Table_Func load_cpal;
|
||||
TT_Load_Table_Func load_colr;
|
||||
TT_Free_Table_Func free_cpal;
|
||||
TT_Free_Table_Func free_colr;
|
||||
TT_Set_Palette_Func set_palette;
|
||||
TT_Get_Colr_Layer_Func get_colr_layer;
|
||||
TT_Get_Color_Glyph_Paint_Func get_colr_glyph_paint;
|
||||
TT_Get_Color_Glyph_ClipBox_Func get_color_glyph_clipbox;
|
||||
TT_Get_Paint_Layers_Func get_paint_layers;
|
||||
TT_Get_Colorline_Stops_Func get_colorline_stops;
|
||||
TT_Get_Paint_Func get_paint;
|
||||
TT_Blend_Colr_Func colr_blend;
|
||||
|
||||
TT_Get_Metrics_Func get_metrics;
|
||||
TT_Get_Metrics_Func get_metrics;
|
||||
|
||||
TT_Get_Name_Func get_name;
|
||||
TT_Get_Name_ID_Func get_name_id;
|
||||
TT_Get_Name_Func get_name;
|
||||
TT_Get_Name_ID_Func get_name_id;
|
||||
|
||||
/* OpenType SVG Support */
|
||||
TT_Load_Table_Func load_svg;
|
||||
TT_Free_Table_Func free_svg;
|
||||
TT_Load_Svg_Doc_Func load_svg_doc;
|
||||
|
||||
} SFNT_Interface;
|
||||
|
||||
@ -820,10 +1021,18 @@ FT_BEGIN_HEADER
|
||||
free_colr_, \
|
||||
set_palette_, \
|
||||
get_colr_layer_, \
|
||||
get_colr_glyph_paint_, \
|
||||
get_color_glyph_clipbox, \
|
||||
get_paint_layers_, \
|
||||
get_colorline_stops_, \
|
||||
get_paint_, \
|
||||
colr_blend_, \
|
||||
get_metrics_, \
|
||||
get_name_, \
|
||||
get_name_id_ ) \
|
||||
get_name_id_, \
|
||||
load_svg_, \
|
||||
free_svg_, \
|
||||
load_svg_doc_ ) \
|
||||
static const SFNT_Interface class_ = \
|
||||
{ \
|
||||
goto_table_, \
|
||||
@ -860,10 +1069,18 @@ FT_BEGIN_HEADER
|
||||
free_colr_, \
|
||||
set_palette_, \
|
||||
get_colr_layer_, \
|
||||
get_colr_glyph_paint_, \
|
||||
get_color_glyph_clipbox, \
|
||||
get_paint_layers_, \
|
||||
get_colorline_stops_, \
|
||||
get_paint_, \
|
||||
colr_blend_, \
|
||||
get_metrics_, \
|
||||
get_name_, \
|
||||
get_name_id_ \
|
||||
get_name_id_, \
|
||||
load_svg_, \
|
||||
free_svg_, \
|
||||
load_svg_doc_ \
|
||||
};
|
||||
|
||||
|
||||
|
@ -0,0 +1,46 @@
|
||||
/****************************************************************************
|
||||
*
|
||||
* svginterface.h
|
||||
*
|
||||
* Interface of ot-svg module (specification only).
|
||||
*
|
||||
* Copyright (C) 2022 by
|
||||
* David Turner, Robert Wilhelm, Werner Lemberg, and Moazin Khatti.
|
||||
*
|
||||
* 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 SVGINTERFACE_H_
|
||||
#define SVGINTERFACE_H_
|
||||
|
||||
#include <ft2build.h>
|
||||
#include <freetype/otsvg.h>
|
||||
|
||||
|
||||
FT_BEGIN_HEADER
|
||||
|
||||
typedef FT_Error
|
||||
(*Preset_Bitmap_Func)( FT_Module module,
|
||||
FT_GlyphSlot slot,
|
||||
FT_Bool cache );
|
||||
|
||||
typedef struct SVG_Interface_
|
||||
{
|
||||
Preset_Bitmap_Func preset_slot;
|
||||
|
||||
} SVG_Interface;
|
||||
|
||||
typedef SVG_Interface* SVG_Service;
|
||||
|
||||
FT_END_HEADER
|
||||
|
||||
#endif /* SVGINTERFACE_H_ */
|
||||
|
||||
|
||||
/* END */
|
@ -5,7 +5,7 @@
|
||||
* Basic Type1/Type2 type definitions and interface (specification
|
||||
* only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -5,7 +5,7 @@
|
||||
* Basic SFNT/TrueType type definitions and interface (specification
|
||||
* only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -1372,7 +1372,7 @@ FT_BEGIN_HEADER
|
||||
*
|
||||
* num_locations ::
|
||||
* The number of glyph locations in this TrueType file. This should be
|
||||
* identical to the number of glyphs. Ignored for Type 2 fonts.
|
||||
* one more than the number of glyphs. Ignored for Type 2 fonts.
|
||||
*
|
||||
* glyph_locations ::
|
||||
* An array of longs. These are offsets to glyph data within the
|
||||
@ -1390,8 +1390,8 @@ FT_BEGIN_HEADER
|
||||
* hdmx_record_size ::
|
||||
* The size of a single hdmx record.
|
||||
*
|
||||
* hdmx_record_sizes ::
|
||||
* An array holding the ppem sizes available in the 'hdmx' table.
|
||||
* hdmx_records ::
|
||||
* A array of pointers to the 'hdmx' table records sorted by ppem.
|
||||
*
|
||||
* sbit_table ::
|
||||
* A pointer to the font's embedded bitmap location table.
|
||||
@ -1598,14 +1598,14 @@ FT_BEGIN_HEADER
|
||||
FT_ULong horz_metrics_size;
|
||||
FT_ULong vert_metrics_size;
|
||||
|
||||
FT_ULong num_locations; /* in broken TTF, gid > 0xFFFF */
|
||||
FT_ULong num_locations; /* up to 0xFFFF + 1 */
|
||||
FT_Byte* glyph_locations;
|
||||
|
||||
FT_Byte* hdmx_table;
|
||||
FT_ULong hdmx_table_size;
|
||||
FT_UInt hdmx_record_count;
|
||||
FT_ULong hdmx_record_size;
|
||||
FT_Byte* hdmx_record_sizes;
|
||||
FT_Byte** hdmx_records;
|
||||
|
||||
FT_Byte* sbit_table;
|
||||
FT_ULong sbit_table_size;
|
||||
@ -1644,6 +1644,9 @@ FT_BEGIN_HEADER
|
||||
void* cpal;
|
||||
void* colr;
|
||||
|
||||
/* since 2.12 */
|
||||
void* svg;
|
||||
|
||||
} TT_FaceRec;
|
||||
|
||||
|
||||
@ -1734,7 +1737,7 @@ FT_BEGIN_HEADER
|
||||
FT_UInt glyph_index;
|
||||
|
||||
FT_Stream stream;
|
||||
FT_Int byte_len;
|
||||
FT_UInt byte_len;
|
||||
|
||||
FT_Short n_contours;
|
||||
FT_BBox bbox;
|
||||
@ -1769,6 +1772,9 @@ FT_BEGIN_HEADER
|
||||
/* since version 2.6.2 */
|
||||
FT_ListRec composites;
|
||||
|
||||
/* since version 2.11.2 */
|
||||
FT_Byte* widthp;
|
||||
|
||||
} TT_LoaderRec;
|
||||
|
||||
|
||||
|
@ -5,7 +5,7 @@
|
||||
* Basic WOFF/WOFF2 type definitions and interface (specification
|
||||
* only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -92,7 +92,7 @@ FT_BEGIN_HEADER
|
||||
*/
|
||||
typedef struct WOFF_TableRec_
|
||||
{
|
||||
FT_ULong Tag; /* table ID */
|
||||
FT_Tag Tag; /* table ID */
|
||||
FT_ULong Offset; /* table file offset */
|
||||
FT_ULong CompLength; /* compressed table length */
|
||||
FT_ULong OrigLength; /* uncompressed table length */
|
||||
@ -191,7 +191,7 @@ FT_BEGIN_HEADER
|
||||
typedef struct WOFF2_TableRec_
|
||||
{
|
||||
FT_Byte FlagByte; /* table type and flags */
|
||||
FT_ULong Tag; /* table file offset */
|
||||
FT_Tag Tag; /* table file offset */
|
||||
FT_ULong dst_length; /* uncompressed table length */
|
||||
FT_ULong TransformLength; /* transformed length */
|
||||
|
||||
|
@ -0,0 +1,336 @@
|
||||
/****************************************************************************
|
||||
*
|
||||
* otsvg.h
|
||||
*
|
||||
* Interface for OT-SVG support related things (specification).
|
||||
*
|
||||
* Copyright (C) 2022 by
|
||||
* David Turner, Robert Wilhelm, Werner Lemberg, and Moazin Khatti.
|
||||
*
|
||||
* 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 OTSVG_H_
|
||||
#define OTSVG_H_
|
||||
|
||||
#include <freetype/freetype.h>
|
||||
|
||||
#ifdef FREETYPE_H
|
||||
#error "freetype.h of FreeType 1 has been loaded!"
|
||||
#error "Please fix the directory search order for header files"
|
||||
#error "so that freetype.h of FreeType 2 is found first."
|
||||
#endif
|
||||
|
||||
|
||||
FT_BEGIN_HEADER
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @section:
|
||||
* svg_fonts
|
||||
*
|
||||
* @title:
|
||||
* OpenType SVG Fonts
|
||||
*
|
||||
* @abstract:
|
||||
* OT-SVG API between FreeType and an external SVG rendering library.
|
||||
*
|
||||
* @description:
|
||||
* This section describes the four hooks necessary to render SVG
|
||||
* 'documents' that are contained in an OpenType font's 'SVG~' table.
|
||||
*
|
||||
* For more information on the implementation, see our standard hooks
|
||||
* based on 'librsvg' in the [FreeType Demo
|
||||
* Programs](https://gitlab.freedesktop.org/freetype/freetype-demos)
|
||||
* repository.
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* SVG_Lib_Init_Func
|
||||
*
|
||||
* @description:
|
||||
* A callback that is called when the first OT-SVG glyph is rendered in
|
||||
* the lifetime of an @FT_Library object. In a typical implementation,
|
||||
* one would want to allocate a structure and point the `data_pointer`
|
||||
* to it and perform any library initializations that might be needed.
|
||||
*
|
||||
* @inout:
|
||||
* data_pointer ::
|
||||
* The SVG rendering module stores a pointer variable that can be used
|
||||
* by clients to store any data that needs to be shared across
|
||||
* different hooks. `data_pointer` is essentially a pointer to that
|
||||
* pointer such that it can be written to as well as read from.
|
||||
*
|
||||
* @return:
|
||||
* FreeType error code. 0 means success.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
typedef FT_Error
|
||||
(*SVG_Lib_Init_Func)( FT_Pointer *data_pointer );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* SVG_Lib_Free_Func
|
||||
*
|
||||
* @description:
|
||||
* A callback that is called when the `ot-svg` module is being freed.
|
||||
* It is only called if the init hook was called earlier. This means
|
||||
* that neither the init nor the free hook is called if no OT-SVG glyph
|
||||
* is rendered.
|
||||
*
|
||||
* In a typical implementation, one would want to free any state
|
||||
* structure that was allocated in the init hook and perform any
|
||||
* library-related closure that might be needed.
|
||||
*
|
||||
* @inout:
|
||||
* data_pointer ::
|
||||
* The SVG rendering module stores a pointer variable that can be used
|
||||
* by clients to store any data that needs to be shared across
|
||||
* different hooks. `data_pointer` is essentially a pointer to that
|
||||
* pointer such that it can be written to as well as read from.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
typedef void
|
||||
(*SVG_Lib_Free_Func)( FT_Pointer *data_pointer );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* SVG_Lib_Render_Func
|
||||
*
|
||||
* @description:
|
||||
* A callback that is called to render an OT-SVG glyph. This callback
|
||||
* hook is called right after the preset hook @SVG_Lib_Preset_Slot_Func
|
||||
* has been called with `cache` set to `TRUE`. The data necessary to
|
||||
* render is available through the handle @FT_SVG_Document, which is set
|
||||
* in the `other` field of @FT_GlyphSlotRec.
|
||||
*
|
||||
* The render hook is expected to render the SVG glyph to the bitmap
|
||||
* buffer that is allocated already at `slot->bitmap.buffer`. It also
|
||||
* sets the `num_grays` value as well as `slot->format`.
|
||||
*
|
||||
* @input:
|
||||
* slot ::
|
||||
* The slot to render.
|
||||
*
|
||||
* @inout:
|
||||
* data_pointer ::
|
||||
* The SVG rendering module stores a pointer variable that can be used
|
||||
* by clients to store any data that needs to be shared across
|
||||
* different hooks. `data_pointer` is essentially a pointer to that
|
||||
* pointer such that it can be written to as well as read from.
|
||||
*
|
||||
* @return:
|
||||
* FreeType error code. 0 means success.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
typedef FT_Error
|
||||
(*SVG_Lib_Render_Func)( FT_GlyphSlot slot,
|
||||
FT_Pointer *data_pointer );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @functype:
|
||||
* SVG_Lib_Preset_Slot_Func
|
||||
*
|
||||
* @description:
|
||||
* A callback that is called to preset the glyph slot. It is called from
|
||||
* two places.
|
||||
*
|
||||
* 1. When `FT_Load_Glyph` needs to preset the glyph slot.
|
||||
*
|
||||
* 2. Right before the `svg` module calls the render callback hook.
|
||||
*
|
||||
* When it is the former, the argument `cache` is set to `FALSE`. When
|
||||
* it is the latter, the argument `cache` is set to `TRUE`. This
|
||||
* distinction has been made because many calculations that are necessary
|
||||
* for presetting a glyph slot are the same needed later for the render
|
||||
* callback hook. Thus, if `cache` is `TRUE`, the hook can _cache_ those
|
||||
* calculations in a memory block referenced by the state pointer.
|
||||
*
|
||||
* This hook is expected to preset the slot by setting parameters such as
|
||||
* `bitmap_left`, `bitmap_top`, `width`, `rows`, `pitch`, and
|
||||
* `pixel_mode`. It is also expected to set all the metrics for the slot
|
||||
* including the vertical advance if it is not already set. Typically,
|
||||
* fonts have horizontal advances but not vertical ones. If those are
|
||||
* available, they had already been set, otherwise they have to be
|
||||
* estimated and set manually. The hook must take into account the
|
||||
* transformations that have been set, and translate the transformation
|
||||
* matrices into the SVG coordinate system, as the original matrix is
|
||||
* intended for the TTF/CFF coordinate system.
|
||||
*
|
||||
* @input:
|
||||
* slot ::
|
||||
* The glyph slot that has the SVG document loaded.
|
||||
*
|
||||
* cache ::
|
||||
* See description.
|
||||
*
|
||||
* @inout:
|
||||
* data_pointer ::
|
||||
* The SVG rendering module stores a pointer variable that can be used
|
||||
* by clients to store any data that needs to be shared across
|
||||
* different hooks. `data_pointer` is essentially a pointer to that
|
||||
* pointer such that it can be written to as well as read from.
|
||||
*
|
||||
* @return:
|
||||
* FreeType error code. 0 means success.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
typedef FT_Error
|
||||
(*SVG_Lib_Preset_Slot_Func)( FT_GlyphSlot slot,
|
||||
FT_Bool cache,
|
||||
FT_Pointer *state );
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @struct:
|
||||
* SVG_RendererHooks
|
||||
*
|
||||
* @description:
|
||||
* A structure that stores the four hooks needed to render OT-SVG glyphs
|
||||
* properly. The structure is publicly used to set the hooks via the
|
||||
* @svg-hooks driver property.
|
||||
*
|
||||
* The behavior of each hook is described in its documentation. One
|
||||
* thing to note is that the preset hook and the render hook often need
|
||||
* to do the same operations; therefore, it's better to cache the
|
||||
* intermediate data in a state structure to avoid calculating it twice.
|
||||
* For example, in the preset hook one can draw the glyph on a recorder
|
||||
* surface and later create a bitmap surface from it in the render hook.
|
||||
*
|
||||
* All four hooks must be non-NULL.
|
||||
*
|
||||
* @fields:
|
||||
* init_svg ::
|
||||
* The initialization hook.
|
||||
*
|
||||
* free_svg ::
|
||||
* The cleanup hook.
|
||||
*
|
||||
* render_hook ::
|
||||
* The render hook.
|
||||
*
|
||||
* preset_slot ::
|
||||
* The preset hook.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
typedef struct SVG_RendererHooks_
|
||||
{
|
||||
SVG_Lib_Init_Func init_svg;
|
||||
SVG_Lib_Free_Func free_svg;
|
||||
SVG_Lib_Render_Func render_svg;
|
||||
|
||||
SVG_Lib_Preset_Slot_Func preset_slot;
|
||||
|
||||
} SVG_RendererHooks;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @struct:
|
||||
* FT_SVG_DocumentRec
|
||||
*
|
||||
* @description:
|
||||
* A structure that models one SVG document.
|
||||
*
|
||||
* @fields:
|
||||
* svg_document ::
|
||||
* A pointer to the SVG document.
|
||||
*
|
||||
* svg_document_length ::
|
||||
* The length of `svg_document`.
|
||||
*
|
||||
* metrics ::
|
||||
* A metrics object storing the size information.
|
||||
*
|
||||
* units_per_EM ::
|
||||
* The size of the EM square.
|
||||
*
|
||||
* start_glyph_id ::
|
||||
* The first glyph ID in the glyph range covered by this document.
|
||||
*
|
||||
* end_glyph_id ::
|
||||
* The last glyph ID in the glyph range covered by this document.
|
||||
*
|
||||
* transform ::
|
||||
* A 2x2 transformation matrix to apply to the glyph while rendering
|
||||
* it.
|
||||
*
|
||||
* delta ::
|
||||
* The translation to apply to the glyph while rendering.
|
||||
*
|
||||
* @note:
|
||||
* When an @FT_GlyphSlot object `slot` is passed down to a renderer, the
|
||||
* renderer can only access the `metrics` and `units_per_EM` fields via
|
||||
* `slot->face`. However, when @FT_Glyph_To_Bitmap sets up a dummy
|
||||
* object, it has no way to set a `face` object. Thus, metrics
|
||||
* information and `units_per_EM` (which is necessary for OT-SVG) has to
|
||||
* be stored separately.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
typedef struct FT_SVG_DocumentRec_
|
||||
{
|
||||
FT_Byte* svg_document;
|
||||
FT_ULong svg_document_length;
|
||||
|
||||
FT_Size_Metrics metrics;
|
||||
FT_UShort units_per_EM;
|
||||
|
||||
FT_UShort start_glyph_id;
|
||||
FT_UShort end_glyph_id;
|
||||
|
||||
FT_Matrix transform;
|
||||
FT_Vector delta;
|
||||
|
||||
} FT_SVG_DocumentRec;
|
||||
|
||||
|
||||
/**************************************************************************
|
||||
*
|
||||
* @type:
|
||||
* FT_SVG_Document
|
||||
*
|
||||
* @description:
|
||||
* A handle to an @FT_SVG_DocumentRec object.
|
||||
*
|
||||
* @since:
|
||||
* 2.12
|
||||
*/
|
||||
typedef struct FT_SVG_DocumentRec_* FT_SVG_Document;
|
||||
|
||||
|
||||
FT_END_HEADER
|
||||
|
||||
#endif /* OTSVG_H_ */
|
||||
|
||||
|
||||
/* END */
|
@ -5,7 +5,7 @@
|
||||
* Basic Type 1/Type 2 tables definitions and interface (specification
|
||||
* only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -360,7 +360,7 @@ FT_BEGIN_HEADER
|
||||
|
||||
FT_UInt num_subrs;
|
||||
FT_ULong subrmap_offset;
|
||||
FT_Int sd_bytes;
|
||||
FT_UInt sd_bytes;
|
||||
|
||||
} CID_FaceDictRec;
|
||||
|
||||
@ -415,11 +415,11 @@ FT_BEGIN_HEADER
|
||||
FT_ULong xuid[16];
|
||||
|
||||
FT_ULong cidmap_offset;
|
||||
FT_Int fd_bytes;
|
||||
FT_Int gd_bytes;
|
||||
FT_UInt fd_bytes;
|
||||
FT_UInt gd_bytes;
|
||||
FT_ULong cid_count;
|
||||
|
||||
FT_Int num_dicts;
|
||||
FT_UInt num_dicts;
|
||||
CID_FaceDict font_dicts;
|
||||
|
||||
FT_ULong data_offset;
|
||||
@ -453,22 +453,22 @@ FT_BEGIN_HEADER
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Has_PS_Glyph_Names
|
||||
* FT_Has_PS_Glyph_Names
|
||||
*
|
||||
* @description:
|
||||
* Return true if a given face provides reliable PostScript glyph names.
|
||||
* This is similar to using the @FT_HAS_GLYPH_NAMES macro, except that
|
||||
* certain fonts (mostly TrueType) contain incorrect glyph name tables.
|
||||
* Return true if a given face provides reliable PostScript glyph names.
|
||||
* This is similar to using the @FT_HAS_GLYPH_NAMES macro, except that
|
||||
* certain fonts (mostly TrueType) contain incorrect glyph name tables.
|
||||
*
|
||||
* When this function returns true, the caller is sure that the glyph
|
||||
* names returned by @FT_Get_Glyph_Name are reliable.
|
||||
* When this function returns true, the caller is sure that the glyph
|
||||
* names returned by @FT_Get_Glyph_Name are reliable.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* face handle
|
||||
* face ::
|
||||
* face handle
|
||||
*
|
||||
* @return:
|
||||
* Boolean. True if glyph names are reliable.
|
||||
* Boolean. True if glyph names are reliable.
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_Int )
|
||||
@ -478,30 +478,40 @@ FT_BEGIN_HEADER
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Get_PS_Font_Info
|
||||
* FT_Get_PS_Font_Info
|
||||
*
|
||||
* @description:
|
||||
* Retrieve the @PS_FontInfoRec structure corresponding to a given
|
||||
* PostScript font.
|
||||
* Retrieve the @PS_FontInfoRec structure corresponding to a given
|
||||
* PostScript font.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* PostScript face handle.
|
||||
* face ::
|
||||
* PostScript face handle.
|
||||
*
|
||||
* @output:
|
||||
* afont_info ::
|
||||
* Output font info structure pointer.
|
||||
* afont_info ::
|
||||
* A pointer to a @PS_FontInfoRec object.
|
||||
*
|
||||
* @return:
|
||||
* FreeType error code. 0~means success.
|
||||
* FreeType error code. 0~means success.
|
||||
*
|
||||
* @note:
|
||||
* String pointers within the @PS_FontInfoRec structure are owned by the
|
||||
* face and don't need to be freed by the caller. Missing entries in
|
||||
* the font's FontInfo dictionary are represented by `NULL` pointers.
|
||||
* String pointers within the @PS_FontInfoRec structure are owned by the
|
||||
* face and don't need to be freed by the caller. Missing entries in the
|
||||
* font's FontInfo dictionary are represented by `NULL` pointers.
|
||||
*
|
||||
* If the font's format is not PostScript-based, this function will
|
||||
* return the `FT_Err_Invalid_Argument` error code.
|
||||
* The following font formats support this feature: 'Type~1', 'Type~42',
|
||||
* 'CFF', 'CID~Type~1'. For other font formats this function returns the
|
||||
* `FT_Err_Invalid_Argument` error code.
|
||||
*
|
||||
* @example:
|
||||
* ```
|
||||
* PS_FontInfoRec font_info;
|
||||
*
|
||||
*
|
||||
* error = FT_Get_PS_Font_Info( face, &font_info );
|
||||
* ...
|
||||
* ```
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_Error )
|
||||
@ -512,29 +522,39 @@ FT_BEGIN_HEADER
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Get_PS_Font_Private
|
||||
* FT_Get_PS_Font_Private
|
||||
*
|
||||
* @description:
|
||||
* Retrieve the @PS_PrivateRec structure corresponding to a given
|
||||
* PostScript font.
|
||||
* Retrieve the @PS_PrivateRec structure corresponding to a given
|
||||
* PostScript font.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* PostScript face handle.
|
||||
* face ::
|
||||
* PostScript face handle.
|
||||
*
|
||||
* @output:
|
||||
* afont_private ::
|
||||
* Output private dictionary structure pointer.
|
||||
* afont_private ::
|
||||
* A pointer to a @PS_PrivateRec object.
|
||||
*
|
||||
* @return:
|
||||
* FreeType error code. 0~means success.
|
||||
* FreeType error code. 0~means success.
|
||||
*
|
||||
* @note:
|
||||
* The string pointers within the @PS_PrivateRec structure are owned by
|
||||
* the face and don't need to be freed by the caller.
|
||||
* The string pointers within the @PS_PrivateRec structure are owned by
|
||||
* the face and don't need to be freed by the caller.
|
||||
*
|
||||
* If the font's format is not PostScript-based, this function returns
|
||||
* the `FT_Err_Invalid_Argument` error code.
|
||||
* Only the 'Type~1' font format supports this feature. For other font
|
||||
* formats this function returns the `FT_Err_Invalid_Argument` error
|
||||
* code.
|
||||
*
|
||||
* @example:
|
||||
* ```
|
||||
* PS_PrivateRec font_private;
|
||||
*
|
||||
*
|
||||
* error = FT_Get_PS_Font_Private( face, &font_private );
|
||||
* ...
|
||||
* ```
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_Error )
|
||||
@ -693,67 +713,67 @@ FT_BEGIN_HEADER
|
||||
/**************************************************************************
|
||||
*
|
||||
* @function:
|
||||
* FT_Get_PS_Font_Value
|
||||
* FT_Get_PS_Font_Value
|
||||
*
|
||||
* @description:
|
||||
* Retrieve the value for the supplied key from a PostScript font.
|
||||
* Retrieve the value for the supplied key from a PostScript font.
|
||||
*
|
||||
* @input:
|
||||
* face ::
|
||||
* PostScript face handle.
|
||||
* face ::
|
||||
* PostScript face handle.
|
||||
*
|
||||
* key ::
|
||||
* An enumeration value representing the dictionary key to retrieve.
|
||||
* key ::
|
||||
* An enumeration value representing the dictionary key to retrieve.
|
||||
*
|
||||
* idx ::
|
||||
* For array values, this specifies the index to be returned.
|
||||
* idx ::
|
||||
* For array values, this specifies the index to be returned.
|
||||
*
|
||||
* value ::
|
||||
* A pointer to memory into which to write the value.
|
||||
* value ::
|
||||
* A pointer to memory into which to write the value.
|
||||
*
|
||||
* valen_len ::
|
||||
* The size, in bytes, of the memory supplied for the value.
|
||||
* valen_len ::
|
||||
* The size, in bytes, of the memory supplied for the value.
|
||||
*
|
||||
* @output:
|
||||
* value ::
|
||||
* The value matching the above key, if it exists.
|
||||
* value ::
|
||||
* The value matching the above key, if it exists.
|
||||
*
|
||||
* @return:
|
||||
* The amount of memory (in bytes) required to hold the requested value
|
||||
* (if it exists, -1 otherwise).
|
||||
* The amount of memory (in bytes) required to hold the requested value
|
||||
* (if it exists, -1 otherwise).
|
||||
*
|
||||
* @note:
|
||||
* The values returned are not pointers into the internal structures of
|
||||
* the face, but are 'fresh' copies, so that the memory containing them
|
||||
* belongs to the calling application. This also enforces the
|
||||
* 'read-only' nature of these values, i.e., this function cannot be
|
||||
* used to manipulate the face.
|
||||
* The values returned are not pointers into the internal structures of
|
||||
* the face, but are 'fresh' copies, so that the memory containing them
|
||||
* belongs to the calling application. This also enforces the
|
||||
* 'read-only' nature of these values, i.e., this function cannot be
|
||||
* used to manipulate the face.
|
||||
*
|
||||
* `value` is a void pointer because the values returned can be of
|
||||
* various types.
|
||||
* `value` is a void pointer because the values returned can be of
|
||||
* various types.
|
||||
*
|
||||
* If either `value` is `NULL` or `value_len` is too small, just the
|
||||
* required memory size for the requested entry is returned.
|
||||
* If either `value` is `NULL` or `value_len` is too small, just the
|
||||
* required memory size for the requested entry is returned.
|
||||
*
|
||||
* The `idx` parameter is used, not only to retrieve elements of, for
|
||||
* example, the FontMatrix or FontBBox, but also to retrieve name keys
|
||||
* from the CharStrings dictionary, and the charstrings themselves. It
|
||||
* is ignored for atomic values.
|
||||
* The `idx` parameter is used, not only to retrieve elements of, for
|
||||
* example, the FontMatrix or FontBBox, but also to retrieve name keys
|
||||
* from the CharStrings dictionary, and the charstrings themselves. It
|
||||
* is ignored for atomic values.
|
||||
*
|
||||
* `PS_DICT_BLUE_SCALE` returns a value that is scaled up by 1000. To
|
||||
* get the value as in the font stream, you need to divide by 65536000.0
|
||||
* (to remove the FT_Fixed scale, and the x1000 scale).
|
||||
* `PS_DICT_BLUE_SCALE` returns a value that is scaled up by 1000. To
|
||||
* get the value as in the font stream, you need to divide by 65536000.0
|
||||
* (to remove the FT_Fixed scale, and the x1000 scale).
|
||||
*
|
||||
* IMPORTANT: Only key/value pairs read by the FreeType interpreter can
|
||||
* be retrieved. So, for example, PostScript procedures such as NP, ND,
|
||||
* and RD are not available. Arbitrary keys are, obviously, not be
|
||||
* available either.
|
||||
* IMPORTANT: Only key/value pairs read by the FreeType interpreter can
|
||||
* be retrieved. So, for example, PostScript procedures such as NP, ND,
|
||||
* and RD are not available. Arbitrary keys are, obviously, not be
|
||||
* available either.
|
||||
*
|
||||
* If the font's format is not PostScript-based, this function returns
|
||||
* the `FT_Err_Invalid_Argument` error code.
|
||||
* If the font's format is not PostScript-based, this function returns
|
||||
* the `FT_Err_Invalid_Argument` error code.
|
||||
*
|
||||
* @since:
|
||||
* 2.4.8
|
||||
* 2.4.8
|
||||
*
|
||||
*/
|
||||
FT_EXPORT( FT_Long )
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* TrueType name ID definitions (specification only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -591,7 +591,7 @@ FT_BEGIN_HEADER
|
||||
#define TT_MS_LANGID_MALAY_MALAYSIA 0x043E
|
||||
#define TT_MS_LANGID_MALAY_BRUNEI_DARUSSALAM 0x083E
|
||||
#define TT_MS_LANGID_KAZAKH_KAZAKHSTAN 0x043F
|
||||
#define TT_MS_LANGID_KYRGYZ_KYRGYZSTAN /* Cyrillic*/ 0x0440
|
||||
#define TT_MS_LANGID_KYRGYZ_KYRGYZSTAN /* Cyrillic */ 0x0440
|
||||
#define TT_MS_LANGID_KISWAHILI_KENYA 0x0441
|
||||
#define TT_MS_LANGID_TURKMEN_TURKMENISTAN 0x0442
|
||||
#define TT_MS_LANGID_UZBEK_UZBEKISTAN_LATIN 0x0443
|
||||
|
@ -5,7 +5,7 @@
|
||||
* Basic SFNT/TrueType tables definitions and interface
|
||||
* (specification only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Tags for TrueType and OpenType tables (specification only).
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
@ -95,6 +95,7 @@ FT_BEGIN_HEADER
|
||||
#define TTAG_sbix FT_MAKE_TAG( 's', 'b', 'i', 'x' )
|
||||
#define TTAG_sfnt FT_MAKE_TAG( 's', 'f', 'n', 't' )
|
||||
#define TTAG_SING FT_MAKE_TAG( 'S', 'I', 'N', 'G' )
|
||||
#define TTAG_SVG FT_MAKE_TAG( 'S', 'V', 'G', ' ' )
|
||||
#define TTAG_trak FT_MAKE_TAG( 't', 'r', 'a', 'k' )
|
||||
#define TTAG_true FT_MAKE_TAG( 't', 'r', 'u', 'e' )
|
||||
#define TTAG_ttc FT_MAKE_TAG( 't', 't', 'c', ' ' )
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* FreeType 2 build and setup macros.
|
||||
*
|
||||
* Copyright (C) 1996-2020 by
|
||||
* Copyright (C) 1996-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -1,285 +0,0 @@
|
||||
/****************************************************************************
|
||||
*
|
||||
* afangles.c
|
||||
*
|
||||
* Routines used to compute vector angles with limited accuracy
|
||||
* and very high speed. It also contains sorting routines (body).
|
||||
*
|
||||
* Copyright (C) 2003-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.
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
#include "aftypes.h"
|
||||
|
||||
|
||||
/*
|
||||
* We are not using `af_angle_atan' anymore, but we keep the source
|
||||
* code below just in case...
|
||||
*/
|
||||
|
||||
|
||||
#if 0
|
||||
|
||||
|
||||
/*
|
||||
* The trick here is to realize that we don't need a very accurate angle
|
||||
* approximation. We are going to use the result of `af_angle_atan' to
|
||||
* only compare the sign of angle differences, or check whether its
|
||||
* magnitude is very small.
|
||||
*
|
||||
* The approximation
|
||||
*
|
||||
* dy * PI / (|dx|+|dy|)
|
||||
*
|
||||
* should be enough, and much faster to compute.
|
||||
*/
|
||||
FT_LOCAL_DEF( AF_Angle )
|
||||
af_angle_atan( FT_Fixed dx,
|
||||
FT_Fixed dy )
|
||||
{
|
||||
AF_Angle angle;
|
||||
FT_Fixed ax = dx;
|
||||
FT_Fixed ay = dy;
|
||||
|
||||
|
||||
if ( ax < 0 )
|
||||
ax = -ax;
|
||||
if ( ay < 0 )
|
||||
ay = -ay;
|
||||
|
||||
ax += ay;
|
||||
|
||||
if ( ax == 0 )
|
||||
angle = 0;
|
||||
else
|
||||
{
|
||||
angle = ( AF_ANGLE_PI2 * dy ) / ( ax + ay );
|
||||
if ( dx < 0 )
|
||||
{
|
||||
if ( angle >= 0 )
|
||||
angle = AF_ANGLE_PI - angle;
|
||||
else
|
||||
angle = -AF_ANGLE_PI - angle;
|
||||
}
|
||||
}
|
||||
|
||||
return angle;
|
||||
}
|
||||
|
||||
|
||||
#elif 0
|
||||
|
||||
|
||||
/* the following table has been automatically generated with */
|
||||
/* the `mather.py' Python script */
|
||||
|
||||
#define AF_ATAN_BITS 8
|
||||
|
||||
static const FT_Byte af_arctan[1L << AF_ATAN_BITS] =
|
||||
{
|
||||
0, 0, 1, 1, 1, 2, 2, 2,
|
||||
3, 3, 3, 3, 4, 4, 4, 5,
|
||||
5, 5, 6, 6, 6, 7, 7, 7,
|
||||
8, 8, 8, 9, 9, 9, 10, 10,
|
||||
10, 10, 11, 11, 11, 12, 12, 12,
|
||||
13, 13, 13, 14, 14, 14, 14, 15,
|
||||
15, 15, 16, 16, 16, 17, 17, 17,
|
||||
18, 18, 18, 18, 19, 19, 19, 20,
|
||||
20, 20, 21, 21, 21, 21, 22, 22,
|
||||
22, 23, 23, 23, 24, 24, 24, 24,
|
||||
25, 25, 25, 26, 26, 26, 26, 27,
|
||||
27, 27, 28, 28, 28, 28, 29, 29,
|
||||
29, 30, 30, 30, 30, 31, 31, 31,
|
||||
31, 32, 32, 32, 33, 33, 33, 33,
|
||||
34, 34, 34, 34, 35, 35, 35, 35,
|
||||
36, 36, 36, 36, 37, 37, 37, 38,
|
||||
38, 38, 38, 39, 39, 39, 39, 40,
|
||||
40, 40, 40, 41, 41, 41, 41, 42,
|
||||
42, 42, 42, 42, 43, 43, 43, 43,
|
||||
44, 44, 44, 44, 45, 45, 45, 45,
|
||||
46, 46, 46, 46, 46, 47, 47, 47,
|
||||
47, 48, 48, 48, 48, 48, 49, 49,
|
||||
49, 49, 50, 50, 50, 50, 50, 51,
|
||||
51, 51, 51, 51, 52, 52, 52, 52,
|
||||
52, 53, 53, 53, 53, 53, 54, 54,
|
||||
54, 54, 54, 55, 55, 55, 55, 55,
|
||||
56, 56, 56, 56, 56, 57, 57, 57,
|
||||
57, 57, 57, 58, 58, 58, 58, 58,
|
||||
59, 59, 59, 59, 59, 59, 60, 60,
|
||||
60, 60, 60, 61, 61, 61, 61, 61,
|
||||
61, 62, 62, 62, 62, 62, 62, 63,
|
||||
63, 63, 63, 63, 63, 64, 64, 64
|
||||
};
|
||||
|
||||
|
||||
FT_LOCAL_DEF( AF_Angle )
|
||||
af_angle_atan( FT_Fixed dx,
|
||||
FT_Fixed dy )
|
||||
{
|
||||
AF_Angle angle;
|
||||
|
||||
|
||||
/* check trivial cases */
|
||||
if ( dy == 0 )
|
||||
{
|
||||
angle = 0;
|
||||
if ( dx < 0 )
|
||||
angle = AF_ANGLE_PI;
|
||||
return angle;
|
||||
}
|
||||
else if ( dx == 0 )
|
||||
{
|
||||
angle = AF_ANGLE_PI2;
|
||||
if ( dy < 0 )
|
||||
angle = -AF_ANGLE_PI2;
|
||||
return angle;
|
||||
}
|
||||
|
||||
angle = 0;
|
||||
if ( dx < 0 )
|
||||
{
|
||||
dx = -dx;
|
||||
dy = -dy;
|
||||
angle = AF_ANGLE_PI;
|
||||
}
|
||||
|
||||
if ( dy < 0 )
|
||||
{
|
||||
FT_Pos tmp;
|
||||
|
||||
|
||||
tmp = dx;
|
||||
dx = -dy;
|
||||
dy = tmp;
|
||||
angle -= AF_ANGLE_PI2;
|
||||
}
|
||||
|
||||
if ( dx == 0 && dy == 0 )
|
||||
return 0;
|
||||
|
||||
if ( dx == dy )
|
||||
angle += AF_ANGLE_PI4;
|
||||
else if ( dx > dy )
|
||||
angle += af_arctan[FT_DivFix( dy, dx ) >> ( 16 - AF_ATAN_BITS )];
|
||||
else
|
||||
angle += AF_ANGLE_PI2 -
|
||||
af_arctan[FT_DivFix( dx, dy ) >> ( 16 - AF_ATAN_BITS )];
|
||||
|
||||
if ( angle > AF_ANGLE_PI )
|
||||
angle -= AF_ANGLE_2PI;
|
||||
|
||||
return angle;
|
||||
}
|
||||
|
||||
|
||||
#endif /* 0 */
|
||||
|
||||
|
||||
FT_LOCAL_DEF( void )
|
||||
af_sort_pos( FT_UInt count,
|
||||
FT_Pos* table )
|
||||
{
|
||||
FT_UInt i, j;
|
||||
FT_Pos swap;
|
||||
|
||||
|
||||
for ( i = 1; i < count; i++ )
|
||||
{
|
||||
for ( j = i; j > 0; j-- )
|
||||
{
|
||||
if ( table[j] >= table[j - 1] )
|
||||
break;
|
||||
|
||||
swap = table[j];
|
||||
table[j] = table[j - 1];
|
||||
table[j - 1] = swap;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
FT_LOCAL_DEF( void )
|
||||
af_sort_and_quantize_widths( FT_UInt* count,
|
||||
AF_Width table,
|
||||
FT_Pos threshold )
|
||||
{
|
||||
FT_UInt i, j;
|
||||
FT_UInt cur_idx;
|
||||
FT_Pos cur_val;
|
||||
FT_Pos sum;
|
||||
AF_WidthRec swap;
|
||||
|
||||
|
||||
if ( *count == 1 )
|
||||
return;
|
||||
|
||||
/* sort */
|
||||
for ( i = 1; i < *count; i++ )
|
||||
{
|
||||
for ( j = i; j > 0; j-- )
|
||||
{
|
||||
if ( table[j].org >= table[j - 1].org )
|
||||
break;
|
||||
|
||||
swap = table[j];
|
||||
table[j] = table[j - 1];
|
||||
table[j - 1] = swap;
|
||||
}
|
||||
}
|
||||
|
||||
cur_idx = 0;
|
||||
cur_val = table[cur_idx].org;
|
||||
|
||||
/* compute and use mean values for clusters not larger than */
|
||||
/* `threshold'; this is very primitive and might not yield */
|
||||
/* the best result, but normally, using reference character */
|
||||
/* `o', `*count' is 2, so the code below is fully sufficient */
|
||||
for ( i = 1; i < *count; i++ )
|
||||
{
|
||||
if ( table[i].org - cur_val > threshold ||
|
||||
i == *count - 1 )
|
||||
{
|
||||
sum = 0;
|
||||
|
||||
/* fix loop for end of array */
|
||||
if ( table[i].org - cur_val <= threshold &&
|
||||
i == *count - 1 )
|
||||
i++;
|
||||
|
||||
for ( j = cur_idx; j < i; j++ )
|
||||
{
|
||||
sum += table[j].org;
|
||||
table[j].org = 0;
|
||||
}
|
||||
table[cur_idx].org = sum / (FT_Pos)j;
|
||||
|
||||
if ( i < *count - 1 )
|
||||
{
|
||||
cur_idx = i + 1;
|
||||
cur_val = table[cur_idx].org;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
cur_idx = 1;
|
||||
|
||||
/* compress array to remove zero values */
|
||||
for ( i = 1; i < *count; i++ )
|
||||
{
|
||||
if ( table[i].org )
|
||||
table[cur_idx++] = table[i];
|
||||
}
|
||||
|
||||
*count = cur_idx;
|
||||
}
|
||||
|
||||
|
||||
/* END */
|
@ -1,7 +0,0 @@
|
||||
/*
|
||||
* afangles.h
|
||||
*
|
||||
* This is a dummy file, used to please the build system. It is never
|
||||
* included by the auto-fitter sources.
|
||||
*
|
||||
*/
|
@ -7,7 +7,7 @@
|
||||
*
|
||||
* Auto-fitter data for blue strings (body).
|
||||
*
|
||||
* Copyright (C) 2013-2020 by
|
||||
* Copyright (C) 2013-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Auto-fitter data for blue strings (body).
|
||||
*
|
||||
* Copyright (C) 2013-2020 by
|
||||
* Copyright (C) 2013-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -2,7 +2,7 @@
|
||||
//
|
||||
// Auto-fitter data for blue strings.
|
||||
//
|
||||
// Copyright (C) 2013-2020 by
|
||||
// Copyright (C) 2013-2022 by
|
||||
// David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
//
|
||||
// This file is part of the FreeType project, and may only be used,
|
||||
|
@ -7,7 +7,7 @@
|
||||
*
|
||||
* Auto-fitter data for blue strings (specification).
|
||||
*
|
||||
* Copyright (C) 2013-2020 by
|
||||
* Copyright (C) 2013-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
@ -4,7 +4,7 @@
|
||||
*
|
||||
* Auto-fitter data for blue strings (specification).
|
||||
*
|
||||
* Copyright (C) 2013-2020 by
|
||||
* Copyright (C) 2013-2022 by
|
||||
* David Turner, Robert Wilhelm, and Werner Lemberg.
|
||||
*
|
||||
* This file is part of the FreeType project, and may only be used,
|
||||
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user