#$@%#$%!

Ngiler SH3LL 360
: / proc / thread-self / root / usr / include / freetype2 / freetype /

Information Server
MySQL : OFF Perl : OFF CURL : ON WGET : OFF PKEXEC : OFF

Directive	Local Value
IP Address	162.0.209.101
System	Linux premium169.web-hosting.com 4.18.0-553.50.1.lve.el8.x86_64 #1 SMP Thu Apr 17 19:10:24 UTC 2025 x86_64
User	luxeelil
PHP Version	8.0.30
Software	LiteSpeed
Doc root	Writable

Edit File : fttypes.h \| Size : 34.85 KB
/**************************************************************************/ / / / fttypes.h / / / / FreeType simple types definitions (specification only). / / / / Copyright 1996-2018 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 FTTYPES_H_ #define FTTYPES_H_ #include <ft2build.h> #include FT_CONFIG_CONFIG_H #include FT_SYSTEM_H #include FT_IMAGE_H #include <stddef.h> FT_BEGIN_HEADER /**********************************************************************/ / / / <Section> / / basic_types / / / / <Title> / / Basic Data Types / / / / <Abstract> / / The basic data types defined by the library. / / / / <Description> / / This section contains the basic data types defined by FreeType~2, / / ranging from simple scalar types to bitmap descriptors. More / / font-specific structures are defined in a different section. / / / / <Order> / / FT_Byte / / FT_Bytes / / FT_Char / / FT_Int / / FT_UInt / / FT_Int16 / / FT_UInt16 / / FT_Int32 / / FT_UInt32 / / FT_Int64 / / FT_UInt64 / / FT_Short / / FT_UShort / / FT_Long / / FT_ULong / / FT_Bool / / FT_Offset / / FT_PtrDist / / FT_String / / FT_Tag / / FT_Error / / FT_Fixed / / FT_Pointer / / FT_Pos / / FT_Vector / / FT_BBox / / FT_Matrix / / FT_FWord / / FT_UFWord / / FT_F2Dot14 / / FT_UnitVector / / FT_F26Dot6 / / FT_Data / / / / FT_MAKE_TAG / / / / FT_Generic / / FT_Generic_Finalizer / / / / FT_Bitmap / / FT_Pixel_Mode / / FT_Palette_Mode / / FT_Glyph_Format / / FT_IMAGE_TAG / / / /**********************************************************************/ /**********************************************************************/ / / / <Type> / / FT_Bool / / / / <Description> / / A typedef of unsigned char, used for simple booleans. As usual, / / values 1 and~0 represent true and false, respectively. / / / typedef unsigned char FT_Bool; /***********************************************************************/ / / / <Type> / / FT_FWord / / / / <Description> / / A signed 16-bit integer used to store a distance in original font / / units. / / / typedef signed short FT_FWord; / distance in FUnits / /***********************************************************************/ / / / <Type> / / FT_UFWord / / / / <Description> / / An unsigned 16-bit integer used to store a distance in original / / font units. / / / typedef unsigned short FT_UFWord; / unsigned distance / /***********************************************************************/ / / / <Type> / / FT_Char / / / / <Description> / / A simple typedef for the _signed_ char type. / / / typedef signed char FT_Char; /***********************************************************************/ / / / <Type> / / FT_Byte / / / / <Description> / / A simple typedef for the _unsigned_ char type. / / / typedef unsigned char FT_Byte; /***********************************************************************/ / / / <Type> / / FT_Bytes / / / / <Description> / / A typedef for constant memory areas. / / / typedef const FT_Byte FT_Bytes; /************************************************************************/ / / / <Type> / / FT_Tag / / / / <Description> / / A typedef for 32-bit tags (as used in the SFNT format). / / / typedef FT_UInt32 FT_Tag; /***********************************************************************/ / / / <Type> / / FT_String / / / / <Description> / / A simple typedef for the char type, usually used for strings. / / / typedef char FT_String; /***********************************************************************/ / / / <Type> / / FT_Short / / / / <Description> / / A typedef for signed short. / / / typedef signed short FT_Short; /***********************************************************************/ / / / <Type> / / FT_UShort / / / / <Description> / / A typedef for unsigned short. / / / typedef unsigned short FT_UShort; /***********************************************************************/ / / / <Type> / / FT_Int / / / / <Description> / / A typedef for the int type. / / / typedef signed int FT_Int; /***********************************************************************/ / / / <Type> / / FT_UInt / / / / <Description> / / A typedef for the unsigned int type. / / / typedef unsigned int FT_UInt; /***********************************************************************/ / / / <Type> / / FT_Long / / / / <Description> / / A typedef for signed long. / / / typedef signed long FT_Long; /***********************************************************************/ / / / <Type> / / FT_ULong / / / / <Description> / / A typedef for unsigned long. / / / typedef unsigned long FT_ULong; /***********************************************************************/ / / / <Type> / / FT_F2Dot14 / / / / <Description> / / A signed 2.14 fixed-point type used for unit vectors. / / / typedef signed short FT_F2Dot14; /***********************************************************************/ / / / <Type> / / FT_F26Dot6 / / / / <Description> / / A signed 26.6 fixed-point type used for vectorial pixel / / coordinates. / / / typedef signed long FT_F26Dot6; /***********************************************************************/ / / / <Type> / / FT_Fixed / / / / <Description> / / This type is used to store 16.16 fixed-point values, like scaling / / values or matrix coefficients. / / / typedef signed long FT_Fixed; /***********************************************************************/ / / / <Type> / / FT_Error / / / / <Description> / / The FreeType error code type. A value of~0 is always interpreted / / as a successful operation. / / / typedef int FT_Error; /***********************************************************************/ / / / <Type> / / FT_Pointer / / / / <Description> / / A simple typedef for a typeless pointer. / / / typedef void FT_Pointer; /************************************************************************/ / / / <Type> / / FT_Offset / / / / <Description> / / This is equivalent to the ANSI~C `size_t' type, i.e., the largest / / _unsigned_ integer type used to express a file size or position, / / or a memory block size. / / / typedef size_t FT_Offset; /***********************************************************************/ / / / <Type> / / FT_PtrDist / / / / <Description> / / This is equivalent to the ANSI~C `ptrdiff_t' type, i.e., the / / largest _signed_ integer type used to express the distance / / between two pointers. / / / typedef ft_ptrdiff_t FT_PtrDist; /***********************************************************************/ / / / <Struct> / / FT_UnitVector / / / / <Description> / / A simple structure used to store a 2D vector unit vector. Uses / / FT_F2Dot14 types. / / / / <Fields> / / x :: Horizontal coordinate. / / / / y :: Vertical coordinate. / / / typedef struct FT_UnitVector_ { FT_F2Dot14 x; FT_F2Dot14 y; } FT_UnitVector; /***********************************************************************/ / / / <Struct> / / FT_Matrix / / / / <Description> / / A simple structure used to store a 2x2 matrix. Coefficients are / / in 16.16 fixed-point format. The computation performed is: / / / / { / / x' = xxx + yxy / / y' = xyx + yyy / / } / / / / <Fields> / / xx :: Matrix coefficient. / / / / xy :: Matrix coefficient. / / / / yx :: Matrix coefficient. / / / / yy :: Matrix coefficient. / / / typedef struct FT_Matrix_ { FT_Fixed xx, xy; FT_Fixed yx, yy; } FT_Matrix; /***********************************************************************/ / / / <Struct> / / FT_Data / / / / <Description> / / Read-only binary data represented as a pointer and a length. / / / / <Fields> / / pointer :: The data. / / / / length :: The length of the data in bytes. / / / typedef struct FT_Data_ { const FT_Byte pointer; FT_Int length; } FT_Data; /************************************************************************/ / / / <FuncType> / / FT_Generic_Finalizer / / / / <Description> / / Describe a function used to destroy the `client' data of any / / FreeType object. See the description of the @FT_Generic type for / / details of usage. / / / / <Input> / / The address of the FreeType object that is under finalization. / / Its client data is accessed through its `generic' field. / / / typedef void (FT_Generic_Finalizer)( void* object ); /************************************************************************/ / / / <Struct> / / FT_Generic / / / / <Description> / / Client applications often need to associate their own data to a / / variety of FreeType core objects. For example, a text layout API / / might want to associate a glyph cache to a given size object. / / / / Some FreeType object contains a `generic' field, of type / / FT_Generic, which usage is left to client applications and font / / servers. / / / / It can be used to store a pointer to client-specific data, as well / / as the address of a `finalizer' function, which will be called by / / FreeType when the object is destroyed (for example, the previous / / client example would put the address of the glyph cache destructor / / in the `finalizer' field). / / / / <Fields> / / data :: A typeless pointer to any client-specified data. This / / field is completely ignored by the FreeType library. / / / / finalizer :: A pointer to a `generic finalizer' function, which / / will be called when the object is destroyed. If this / / field is set to NULL, no code will be called. / / / typedef struct FT_Generic_ { void data; FT_Generic_Finalizer finalizer; } FT_Generic; /************************************************************************/ / / / <Macro> / / FT_MAKE_TAG / / / / <Description> / / This macro converts four-letter tags that are used to label / / TrueType tables into an unsigned long, 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 ) /**********************************************************************/ /**********************************************************************/ / / / L I S T M A N A G E M E N T / / / /**********************************************************************/ /*********************************************************************/ /**********************************************************************/ / / / <Section> / / list_processing / / / /**********************************************************************/ /**********************************************************************/ / / / <Type> / / FT_ListNode / / / / <Description> / / Many elements and objects in FreeType are listed through an / / @FT_List record (see @FT_ListRec). As its name suggests, an / / FT_ListNode is a handle to a single list element. / / / typedef struct FT_ListNodeRec_ FT_ListNode; /************************************************************************/ / / / <Type> / / FT_List / / / / <Description> / / A handle to a list record (see @FT_ListRec). / / / typedef struct FT_ListRec_ FT_List; /************************************************************************/ / / / <Struct> / / FT_ListNodeRec / / / / <Description> / / A structure used to hold a single list element. / / / / <Fields> / / prev :: The previous element in the list. NULL if first. / / / / next :: The next element in the list. NULL if last. / / / / data :: A typeless pointer to the listed object. / / / typedef struct FT_ListNodeRec_ { FT_ListNode prev; FT_ListNode next; void data; } FT_ListNodeRec; /************************************************************************/ / / / <Struct> / / FT_ListRec / / / / <Description> / / A structure used to hold a simple doubly-linked list. These are / / used in many parts of FreeType. / / / / <Fields> / / head :: The head (first element) of doubly-linked list. / / / / tail :: The tail (last element) of doubly-linked list. / / / typedef struct FT_ListRec_ { FT_ListNode head; FT_ListNode tail; } FT_ListRec; / / #define FT_IS_EMPTY( list ) ( (list).head == 0 ) #define FT_BOOL( x ) ( (FT_Bool)( x ) ) / concatenate C tokens / #define FT_ERR_XCAT( x, y ) x ## y #define FT_ERR_CAT( x, y ) FT_ERR_XCAT( x, y ) / see `ftmoderr.h' for descriptions of the following macros / #define FT_ERR( e ) FT_ERR_CAT( FT_ERR_PREFIX, e ) #define FT_ERROR_BASE( x ) ( (x) & 0xFF ) #define FT_ERROR_MODULE( x ) ( (x) & 0xFF00U ) #define FT_ERR_EQ( x, e ) \ ( FT_ERROR_BASE( x ) == FT_ERROR_BASE( FT_ERR( e ) ) ) #define FT_ERR_NEQ( x, e ) \ ( FT_ERROR_BASE( x ) != FT_ERROR_BASE( FT_ERR( e ) ) ) FT_END_HEADER #endif / FTTYPES_H_ / / END */ Back

Edit File : fttypes.h | Size : 34.85 KB

/***************************************************************************/
/*                                                                         */
/*  fttypes.h                                                              */
/*                                                                         */
/*    FreeType simple types definitions (specification only).              */
/*                                                                         */
/*  Copyright 1996-2018 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 FTTYPES_H_
#define FTTYPES_H_

#include <ft2build.h>
#include FT_CONFIG_CONFIG_H
#include FT_SYSTEM_H
#include FT_IMAGE_H

#include <stddef.h>

FT_BEGIN_HEADER

/*************************************************************************/
  /*                                                                       */
  /* <Section>                                                             */
  /*    basic_types                                                        */
  /*                                                                       */
  /* <Title>                                                               */
  /*    Basic Data Types                                                   */
  /*                                                                       */
  /* <Abstract>                                                            */
  /*    The basic data types defined by the library.                       */
  /*                                                                       */
  /* <Description>                                                         */
  /*    This section contains the basic data types defined by FreeType~2,  */
  /*    ranging from simple scalar types to bitmap descriptors.  More      */
  /*    font-specific structures are defined in a different section.       */
  /*                                                                       */
  /* <Order>                                                               */
  /*    FT_Byte                                                            */
  /*    FT_Bytes                                                           */
  /*    FT_Char                                                            */
  /*    FT_Int                                                             */
  /*    FT_UInt                                                            */
  /*    FT_Int16                                                           */
  /*    FT_UInt16                                                          */
  /*    FT_Int32                                                           */
  /*    FT_UInt32                                                          */
  /*    FT_Int64                                                           */
  /*    FT_UInt64                                                          */
  /*    FT_Short                                                           */
  /*    FT_UShort                                                          */
  /*    FT_Long                                                            */
  /*    FT_ULong                                                           */
  /*    FT_Bool                                                            */
  /*    FT_Offset                                                          */
  /*    FT_PtrDist                                                         */
  /*    FT_String                                                          */
  /*    FT_Tag                                                             */
  /*    FT_Error                                                           */
  /*    FT_Fixed                                                           */
  /*    FT_Pointer                                                         */
  /*    FT_Pos                                                             */
  /*    FT_Vector                                                          */
  /*    FT_BBox                                                            */
  /*    FT_Matrix                                                          */
  /*    FT_FWord                                                           */
  /*    FT_UFWord                                                          */
  /*    FT_F2Dot14                                                         */
  /*    FT_UnitVector                                                      */
  /*    FT_F26Dot6                                                         */
  /*    FT_Data                                                            */
  /*                                                                       */
  /*    FT_MAKE_TAG                                                        */
  /*                                                                       */
  /*    FT_Generic                                                         */
  /*    FT_Generic_Finalizer                                               */
  /*                                                                       */
  /*    FT_Bitmap                                                          */
  /*    FT_Pixel_Mode                                                      */
  /*    FT_Palette_Mode                                                    */
  /*    FT_Glyph_Format                                                    */
  /*    FT_IMAGE_TAG                                                       */
  /*                                                                       */
  /*************************************************************************/

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Bool                                                            */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef of unsigned char, used for simple booleans.  As usual,   */
  /*    values 1 and~0 represent true and false, respectively.             */
  /*                                                                       */
  typedef unsigned char  FT_Bool;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_FWord                                                           */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A signed 16-bit integer used to store a distance in original font  */
  /*    units.                                                             */
  /*                                                                       */
  typedef signed short  FT_FWord;   /* distance in FUnits */

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_UFWord                                                          */
  /*                                                                       */
  /* <Description>                                                         */
  /*    An unsigned 16-bit integer used to store a distance in original    */
  /*    font units.                                                        */
  /*                                                                       */
  typedef unsigned short  FT_UFWord;  /* unsigned distance */

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Char                                                            */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A simple typedef for the _signed_ char type.                       */
  /*                                                                       */
  typedef signed char  FT_Char;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Byte                                                            */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A simple typedef for the _unsigned_ char type.                     */
  /*                                                                       */
  typedef unsigned char  FT_Byte;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Bytes                                                           */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef for constant memory areas.                               */
  /*                                                                       */
  typedef const FT_Byte*  FT_Bytes;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Tag                                                             */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef for 32-bit tags (as used in the SFNT format).            */
  /*                                                                       */
  typedef FT_UInt32  FT_Tag;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_String                                                          */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A simple typedef for the char type, usually used for strings.      */
  /*                                                                       */
  typedef char  FT_String;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Short                                                           */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef for signed short.                                        */
  /*                                                                       */
  typedef signed short  FT_Short;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_UShort                                                          */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef for unsigned short.                                      */
  /*                                                                       */
  typedef unsigned short  FT_UShort;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Int                                                             */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef for the int type.                                        */
  /*                                                                       */
  typedef signed int  FT_Int;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_UInt                                                            */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef for the unsigned int type.                               */
  /*                                                                       */
  typedef unsigned int  FT_UInt;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Long                                                            */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef for signed long.                                         */
  /*                                                                       */
  typedef signed long  FT_Long;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_ULong                                                           */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A typedef for unsigned long.                                       */
  /*                                                                       */
  typedef unsigned long  FT_ULong;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_F2Dot14                                                         */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A signed 2.14 fixed-point type used for unit vectors.              */
  /*                                                                       */
  typedef signed short  FT_F2Dot14;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_F26Dot6                                                         */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A signed 26.6 fixed-point type used for vectorial pixel            */
  /*    coordinates.                                                       */
  /*                                                                       */
  typedef signed long  FT_F26Dot6;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Fixed                                                           */
  /*                                                                       */
  /* <Description>                                                         */
  /*    This type is used to store 16.16 fixed-point values, like scaling  */
  /*    values or matrix coefficients.                                     */
  /*                                                                       */
  typedef signed long  FT_Fixed;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Error                                                           */
  /*                                                                       */
  /* <Description>                                                         */
  /*    The FreeType error code type.  A value of~0 is always interpreted  */
  /*    as a successful operation.                                         */
  /*                                                                       */
  typedef int  FT_Error;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Pointer                                                         */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A simple typedef for a typeless pointer.                           */
  /*                                                                       */
  typedef void*  FT_Pointer;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_Offset                                                          */
  /*                                                                       */
  /* <Description>                                                         */
  /*    This is equivalent to the ANSI~C `size_t' type, i.e., the largest  */
  /*    _unsigned_ integer type used to express a file size or position,   */
  /*    or a memory block size.                                            */
  /*                                                                       */
  typedef size_t  FT_Offset;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_PtrDist                                                         */
  /*                                                                       */
  /* <Description>                                                         */
  /*    This is equivalent to the ANSI~C `ptrdiff_t' type, i.e., the       */
  /*    largest _signed_ integer type used to express the distance         */
  /*    between two pointers.                                              */
  /*                                                                       */
  typedef ft_ptrdiff_t  FT_PtrDist;

/*************************************************************************/
  /*                                                                       */
  /* <Struct>                                                              */
  /*    FT_UnitVector                                                      */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A simple structure used to store a 2D vector unit vector.  Uses    */
  /*    FT_F2Dot14 types.                                                  */
  /*                                                                       */
  /* <Fields>                                                              */
  /*    x :: Horizontal coordinate.                                        */
  /*                                                                       */
  /*    y :: Vertical coordinate.                                          */
  /*                                                                       */
  typedef struct  FT_UnitVector_
  {
    FT_F2Dot14  x;
    FT_F2Dot14  y;

} FT_UnitVector;

/*************************************************************************/
  /*                                                                       */
  /* <Struct>                                                              */
  /*    FT_Matrix                                                          */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A simple structure used to store a 2x2 matrix.  Coefficients are   */
  /*    in 16.16 fixed-point format.  The computation performed is:        */
  /*                                                                       */
  /*       {                                                               */
  /*          x' = x*xx + y*xy                                             */
  /*          y' = x*yx + y*yy                                             */
  /*       }                                                               */
  /*                                                                       */
  /* <Fields>                                                              */
  /*    xx :: Matrix coefficient.                                          */
  /*                                                                       */
  /*    xy :: Matrix coefficient.                                          */
  /*                                                                       */
  /*    yx :: Matrix coefficient.                                          */
  /*                                                                       */
  /*    yy :: Matrix coefficient.                                          */
  /*                                                                       */
  typedef struct  FT_Matrix_
  {
    FT_Fixed  xx, xy;
    FT_Fixed  yx, yy;

} FT_Matrix;

/*************************************************************************/
  /*                                                                       */
  /* <Struct>                                                              */
  /*    FT_Data                                                            */
  /*                                                                       */
  /* <Description>                                                         */
  /*    Read-only binary data represented as a pointer and a length.       */
  /*                                                                       */
  /* <Fields>                                                              */
  /*    pointer :: The data.                                               */
  /*                                                                       */
  /*    length  :: The length of the data in bytes.                        */
  /*                                                                       */
  typedef struct  FT_Data_
  {
    const FT_Byte*  pointer;
    FT_Int          length;

} FT_Data;

/*************************************************************************/
  /*                                                                       */
  /* <FuncType>                                                            */
  /*    FT_Generic_Finalizer                                               */
  /*                                                                       */
  /* <Description>                                                         */
  /*    Describe a function used to destroy the `client' data of any       */
  /*    FreeType object.  See the description of the @FT_Generic type for  */
  /*    details of usage.                                                  */
  /*                                                                       */
  /* <Input>                                                               */
  /*    The address of the FreeType object that is under finalization.     */
  /*    Its client data is accessed through its `generic' field.           */
  /*                                                                       */
  typedef void  (*FT_Generic_Finalizer)( void*  object );

/*************************************************************************/
  /*                                                                       */
  /* <Struct>                                                              */
  /*    FT_Generic                                                         */
  /*                                                                       */
  /* <Description>                                                         */
  /*    Client applications often need to associate their own data to a    */
  /*    variety of FreeType core objects.  For example, a text layout API  */
  /*    might want to associate a glyph cache to a given size object.      */
  /*                                                                       */
  /*    Some FreeType object contains a `generic' field, of type           */
  /*    FT_Generic, which usage is left to client applications and font    */
  /*    servers.                                                           */
  /*                                                                       */
  /*    It can be used to store a pointer to client-specific data, as well */
  /*    as the address of a `finalizer' function, which will be called by  */
  /*    FreeType when the object is destroyed (for example, the previous   */
  /*    client example would put the address of the glyph cache destructor */
  /*    in the `finalizer' field).                                         */
  /*                                                                       */
  /* <Fields>                                                              */
  /*    data      :: A typeless pointer to any client-specified data. This */
  /*                 field is completely ignored by the FreeType library.  */
  /*                                                                       */
  /*    finalizer :: A pointer to a `generic finalizer' function, which    */
  /*                 will be called when the object is destroyed.  If this */
  /*                 field is set to NULL, no code will be called.         */
  /*                                                                       */
  typedef struct  FT_Generic_
  {
    void*                 data;
    FT_Generic_Finalizer  finalizer;

} FT_Generic;

/*************************************************************************/
  /*                                                                       */
  /* <Macro>                                                               */
  /*    FT_MAKE_TAG                                                        */
  /*                                                                       */
  /* <Description>                                                         */
  /*    This macro converts four-letter tags that are used to label        */
  /*    TrueType tables into an unsigned long, 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         )

/*************************************************************************/
  /*************************************************************************/
  /*                                                                       */
  /*                    L I S T   M A N A G E M E N T                      */
  /*                                                                       */
  /*************************************************************************/
  /*************************************************************************/

/*************************************************************************/
  /*                                                                       */
  /* <Section>                                                             */
  /*    list_processing                                                    */
  /*                                                                       */
  /*************************************************************************/

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_ListNode                                                        */
  /*                                                                       */
  /* <Description>                                                         */
  /*     Many elements and objects in FreeType are listed through an       */
  /*     @FT_List record (see @FT_ListRec).  As its name suggests, an      */
  /*     FT_ListNode is a handle to a single list element.                 */
  /*                                                                       */
  typedef struct FT_ListNodeRec_*  FT_ListNode;

/*************************************************************************/
  /*                                                                       */
  /* <Type>                                                                */
  /*    FT_List                                                            */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A handle to a list record (see @FT_ListRec).                       */
  /*                                                                       */
  typedef struct FT_ListRec_*  FT_List;

/*************************************************************************/
  /*                                                                       */
  /* <Struct>                                                              */
  /*    FT_ListNodeRec                                                     */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A structure used to hold a single list element.                    */
  /*                                                                       */
  /* <Fields>                                                              */
  /*    prev :: The previous element in the list.  NULL if first.          */
  /*                                                                       */
  /*    next :: The next element in the list.  NULL if last.               */
  /*                                                                       */
  /*    data :: A typeless pointer to the listed object.                   */
  /*                                                                       */
  typedef struct  FT_ListNodeRec_
  {
    FT_ListNode  prev;
    FT_ListNode  next;
    void*        data;

} FT_ListNodeRec;

/*************************************************************************/
  /*                                                                       */
  /* <Struct>                                                              */
  /*    FT_ListRec                                                         */
  /*                                                                       */
  /* <Description>                                                         */
  /*    A structure used to hold a simple doubly-linked list.  These are   */
  /*    used in many parts of FreeType.                                    */
  /*                                                                       */
  /* <Fields>                                                              */
  /*    head :: The head (first element) of doubly-linked list.            */
  /*                                                                       */
  /*    tail :: The tail (last element) of doubly-linked list.             */
  /*                                                                       */
  typedef struct  FT_ListRec_
  {
    FT_ListNode  head;
    FT_ListNode  tail;

} FT_ListRec;

/* */

#define FT_IS_EMPTY( list )  ( (list).head == 0 )
#define FT_BOOL( x )  ( (FT_Bool)( x ) )

/* concatenate C tokens */
#define FT_ERR_XCAT( x, y )  x ## y
#define FT_ERR_CAT( x, y )   FT_ERR_XCAT( x, y )

/* see `ftmoderr.h' for descriptions of the following macros */

#define FT_ERR( e )  FT_ERR_CAT( FT_ERR_PREFIX, e )

#define FT_ERROR_BASE( x )    ( (x) & 0xFF )
#define FT_ERROR_MODULE( x )  ( (x) & 0xFF00U )

#define FT_ERR_EQ( x, e )                                        \
          ( FT_ERROR_BASE( x ) == FT_ERROR_BASE( FT_ERR( e ) ) )
#define FT_ERR_NEQ( x, e )                                       \
          ( FT_ERROR_BASE( x ) != FT_ERROR_BASE( FT_ERR( e ) ) )

FT_END_HEADER

#endif /* FTTYPES_H_ */

/* END */

Back