kc3-lang/freetype/include/freetype/ftparams.h

• Show log

  Commit

• Hash : ed7f0913
  Author :
  Date : 2017-12-06T23:15:54
  

  New header file `ftparams.h' that collects all parameter tags. * include/freetype/config/ftheader.h (FT_PARAMETER_TAGS_H): New macro. (FT_TRUETYPE_UNPATENTED_H, FT_UNPATENTED_HINTING_H): Define it to `ftparams.h'. * include/freetype/ftautoh.h, include/freetype/ftcffdrv.h, include/freetype/ftincrem.h, include/freetype/ftlcdfil.h, include/freetype/ftsnames.h, include/freetype/ftt1drv.h: Include FT_PARAMETER_TAGS_H. Move FT_PARAM_TAG_XXX definitions to... * include/freetype/ftparams.h: ...this new file. * include/freetype/ttunpat.h: Remove. No longer needed.

Download

• include/freetype/ftparams.h

• /***************************************************************************/
  /*                                                                         */
  /*  ftparams.h                                                             */
  /*                                                                         */
  /*    FreeType API for possible FT_Parameter tags (specification only).    */
  /*                                                                         */
  /*  Copyright 2017 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 FTPARAMS_H_
  #define FTPARAMS_H_
  
  #include <ft2build.h>
  #include FT_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:
     *   parameter_tags
     *
     * @title:
     *   Parameter Tags
     *
     * @abstract:
     *   Macros for driver property and font loading parameter tags.
     *
     * @description:
     *   This section contains macros for the @FT_Parameter structure that are
     *   used with various functions to activate some special functionality or
     *   different behaviour of various components of FreeType.
     *
     */
  
  
    /***************************************************************************
     *
     * @constant:
     *   FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_FAMILY
     *
     * @description:
     *   A tag for @FT_Parameter to make @FT_Open_Face ignore typographic
     *   family names in the `name' table (introduced in OpenType version
     *   1.4).  Use this for backward compatibility with legacy systems that
     *   have a four-faces-per-family restriction.
     *
     * @since:
     *   2.8
     *
     */
  #define FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_FAMILY \
            FT_MAKE_TAG( 'i', 'g', 'p', 'f' )
  
  
    /* this constant is deprecated */
  #define FT_PARAM_TAG_IGNORE_PREFERRED_FAMILY \
            FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_FAMILY
  
  
    /***************************************************************************
     *
     * @constant:
     *   FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_SUBFAMILY
     *
     * @description:
     *   A tag for @FT_Parameter to make @FT_Open_Face ignore typographic
     *   subfamily names in the `name' table (introduced in OpenType version
     *   1.4).  Use this for backward compatibility with legacy systems that
     *   have a four-faces-per-family restriction.
     *
     * @since:
     *   2.8
     *
     */
  #define FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_SUBFAMILY \
            FT_MAKE_TAG( 'i', 'g', 'p', 's' )
  
  
    /* this constant is deprecated */
  #define FT_PARAM_TAG_IGNORE_PREFERRED_SUBFAMILY \
            FT_PARAM_TAG_IGNORE_TYPOGRAPHIC_SUBFAMILY
  
  
    /***************************************************************************
     *
     * @constant:
     *   FT_PARAM_TAG_INCREMENTAL
     *
     * @description:
     *   An @FT_Parameter tag to be used with @FT_Open_Face to indicate
     *   incremental glyph loading.
     *
     */
  #define FT_PARAM_TAG_INCREMENTAL \
            FT_MAKE_TAG( 'i', 'n', 'c', 'r' )
  
  
    /**************************************************************************
     *
     * @constant:
     *   FT_PARAM_TAG_LCD_FILTER_WEIGHTS
     *
     * @description:
     *   An @FT_Parameter tag to be used with @FT_Face_Properties.  The
     *   corresponding argument specifies the five LCD filter weights for a
     *   given face (if using @FT_LOAD_TARGET_LCD, for example), overriding
     *   the global default values or the values set up with
     *   @FT_Library_SetLcdFilterWeights.
     *
     * @since:
     *   2.8
     *
     */
  #define FT_PARAM_TAG_LCD_FILTER_WEIGHTS \
            FT_MAKE_TAG( 'l', 'c', 'd', 'f' )
  
  
    /**************************************************************************
     *
     * @constant:
     *   FT_PARAM_TAG_RANDOM_SEED
     *
     * @description:
     *   An @FT_Parameter tag to be used with @FT_Face_Properties.  The
     *   corresponding 32bit signed integer argument overrides the font
     *   driver's random seed value with a face-specific one; see
     *   @random-seed.
     *
     * @since:
     *   2.8
     *
     */
  #define FT_PARAM_TAG_RANDOM_SEED \
            FT_MAKE_TAG( 's', 'e', 'e', 'd' )
  
  
    /**************************************************************************
     *
     * @constant:
     *   FT_PARAM_TAG_STEM_DARKENING
     *
     * @description:
     *   An @FT_Parameter tag to be used with @FT_Face_Properties.  The
     *   corresponding Boolean argument specifies whether to apply stem
     *   darkening, overriding the global default values or the values set up
     *   with @FT_Property_Set (see @no-stem-darkening[autofit] and
     *   @no-stem-darkening[cff]).
     *
     *   This is a passive setting that only takes effect if the font driver
     *   or autohinter honors it, which the CFF, Type~1, and CID drivers
     *   always do, but the autohinter only in `light' hinting mode (as of
     *   version 2.8.2).
     *
     * @since:
     *   2.8
     *
     */
  #define FT_PARAM_TAG_STEM_DARKENING \
            FT_MAKE_TAG( 'd', 'a', 'r', 'k' )
  
  
   /***************************************************************************
    *
    * @constant:
    *   FT_PARAM_TAG_UNPATENTED_HINTING
    *
    * @description:
    *   Deprecated, no effect.
    *
    *   Previously: A constant used as the tag of an @FT_Parameter structure to
    *   indicate that unpatented methods only should be used by the TrueType
    *   bytecode interpreter for a typeface opened by @FT_Open_Face.
    *
    */
  #define FT_PARAM_TAG_UNPATENTED_HINTING \
            FT_MAKE_TAG( 'u', 'n', 'p', 'a' )
  
  
    /* */
  
  
  FT_END_HEADER
  
  
  #endif /* FTPARAMS_H_ */
  
  
  /* END */
  

Download