reactos/lib/3rdparty/freetype/include/internal/ftvalid.h

   1 /***************************************************************************/
   2 /*                                                                         */
   3 /*  ftvalid.h                                                              */
   4 /*                                                                         */
   5 /*    FreeType validation support (specification).                         */
   6 /*                                                                         */
   7 /*  Copyright 2004, 2013 by                                                */
   8 /*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
   9 /*                                                                         */
  10 /*  This file is part of the FreeType project, and may only be used,       */
  11 /*  modified, and distributed under the terms of the FreeType project      */
  12 /*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
  13 /*  this file you indicate that you have read the license and              */
  14 /*  understand and accept it fully.                                        */
  15 /*                                                                         */
  16 /***************************************************************************/
  17
  18
  19 #ifndef __FTVALID_H__
  20 #define __FTVALID_H__
  21
  22 #include <ft2build.h>
  23 #include FT_CONFIG_STANDARD_LIBRARY_H   /* for ft_setjmp and ft_longjmp */
  24
  25
  26 FT_BEGIN_HEADER
  27
  28
  29   /*************************************************************************/
  30   /*************************************************************************/
  31   /*************************************************************************/
  32   /****                                                                 ****/
  33   /****                                                                 ****/
  34   /****                    V A L I D A T I O N                          ****/
  35   /****                                                                 ****/
  36   /****                                                                 ****/
  37   /*************************************************************************/
  38   /*************************************************************************/
  39   /*************************************************************************/
  40
  41   /* handle to a validation object */
  42   typedef struct FT_ValidatorRec_ volatile*  FT_Validator;
  43
  44
  45   /*************************************************************************/
  46   /*                                                                       */
  47   /* There are three distinct validation levels defined here:              */
  48   /*                                                                       */
  49   /* FT_VALIDATE_DEFAULT ::                                                */
  50   /*   A table that passes this validation level can be used reliably by   */
  51   /*   FreeType.  It generally means that all offsets have been checked to */
  52   /*   prevent out-of-bound reads, that array counts are correct, etc.     */
  53   /*                                                                       */
  54   /* FT_VALIDATE_TIGHT ::                                                  */
  55   /*   A table that passes this validation level can be used reliably and  */
  56   /*   doesn't contain invalid data.  For example, a charmap table that    */
  57   /*   returns invalid glyph indices will not pass, even though it can     */
  58   /*   be used with FreeType in default mode (the library will simply      */
  59   /*   return an error later when trying to load the glyph).               */
  60   /*                                                                       */
  61   /*   It also checks that fields which must be a multiple of 2, 4, or 8,  */
  62   /*   don't have incorrect values, etc.                                   */
  63   /*                                                                       */
  64   /* FT_VALIDATE_PARANOID ::                                               */
  65   /*   Only for font debugging.  Checks that a table follows the           */
  66   /*   specification by 100%.  Very few fonts will be able to pass this    */
  67   /*   level anyway but it can be useful for certain tools like font       */
  68   /*   editors/converters.                                                 */
  69   /*                                                                       */
  70   typedef enum  FT_ValidationLevel_
  71   {
  72     FT_VALIDATE_DEFAULT = 0,
  73     FT_VALIDATE_TIGHT,
  74     FT_VALIDATE_PARANOID
  75
  76   } FT_ValidationLevel;
  77
  78
  79 #if defined( _MSC_VER )      /* Visual C++ (and Intel C++) */
  80   /* We disable the warning `structure was padded due to   */
  81   /* __declspec(align())' in order to compile cleanly with */
  82   /* the maximum level of warnings.                        */
  83 #pragma warning( push )
  84 #pragma warning( disable : 4324 )
  85 #endif /* _MSC_VER */
  86
  87   /* validator structure */
  88   typedef struct  FT_ValidatorRec_
  89   {
  90     const FT_Byte*      base;        /* address of table in memory       */
  91     const FT_Byte*      limit;       /* `base' + sizeof(table) in memory */
  92     FT_ValidationLevel  level;       /* validation level                 */
  93     FT_Error            error;       /* error returned. 0 means success  */
  94
  95     ft_jmp_buf          jump_buffer; /* used for exception handling      */
  96
  97   } FT_ValidatorRec;
  98
  99 #if defined( _MSC_VER )
 100 #pragma warning( pop )
 101 #endif
 102
 103 #define FT_VALIDATOR( x )  ( (FT_Validator)( x ) )
 104
 105
 106   FT_BASE( void )
 107   ft_validator_init( FT_Validator        valid,
 108                      const FT_Byte*      base,
 109                      const FT_Byte*      limit,
 110                      FT_ValidationLevel  level );
 111
 112   /* Do not use this. It's broken and will cause your validator to crash */
 113   /* if you run it on an invalid font.                                   */
 114   FT_BASE( FT_Int )
 115   ft_validator_run( FT_Validator  valid );
 116
 117   /* Sets the error field in a validator, then calls `longjmp' to return */
 118   /* to high-level caller.  Using `setjmp/longjmp' avoids many stupid    */
 119   /* error checks within the validation routines.                        */
 120   /*                                                                     */
 121   FT_BASE( void )
 122   ft_validator_error( FT_Validator  valid,
 123                       FT_Error      error );
 124
 125
 126   /* Calls ft_validate_error.  Assumes that the `valid' local variable */
 127   /* holds a pointer to the current validator object.                  */
 128   /*                                                                   */
 129   /* Use preprocessor prescan to pass FT_ERR_PREFIX.                   */
 130   /*                                                                   */
 131 #define FT_INVALID( _prefix, _error )  FT_INVALID_( _prefix, _error )
 132 #define FT_INVALID_( _prefix, _error ) \
 133           ft_validator_error( valid, _prefix ## _error )
 134
 135   /* called when a broken table is detected */
 136 #define FT_INVALID_TOO_SHORT \
 137           FT_INVALID( FT_ERR_PREFIX, Invalid_Table )
 138
 139   /* called when an invalid offset is detected */
 140 #define FT_INVALID_OFFSET \
 141           FT_INVALID( FT_ERR_PREFIX, Invalid_Offset )
 142
 143   /* called when an invalid format/value is detected */
 144 #define FT_INVALID_FORMAT \
 145           FT_INVALID( FT_ERR_PREFIX, Invalid_Table )
 146
 147   /* called when an invalid glyph index is detected */
 148 #define FT_INVALID_GLYPH_ID \
 149           FT_INVALID( FT_ERR_PREFIX, Invalid_Glyph_Index )
 150
 151   /* called when an invalid field value is detected */
 152 #define FT_INVALID_DATA \
 153           FT_INVALID( FT_ERR_PREFIX, Invalid_Table )
 154
 155
 156 FT_END_HEADER
 157
 158 #endif /* __FTVALID_H__ */
 159
 160
 161 /* END */