2017-12-06 23:15:54 +01:00
|
|
|
/***************************************************************************/
|
|
|
|
/* */
|
|
|
|
/* ftparams.h */
|
|
|
|
/* */
|
|
|
|
/* FreeType API for possible FT_Parameter tags (specification only). */
|
|
|
|
/* */
|
2018-01-02 09:33:57 +01:00
|
|
|
/* Copyright 2017-2018 by */
|
2017-12-06 23:15:54 +01:00
|
|
|
/* 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
|
New `ftdriver.h' file, covering all driver modules.
This reduces redundancy and increases synergy; it also reduces the
number of header files.
* include/freetype/config/ftheader.h (FT_DRIVER_H): New macro.
(FT_AUTOHINTER_H, FT_CFF_DRIVER_H, FT_TRUETYPE_DRIVER_H,
FT_PCF_DRIVER_H, FT_TYPE1_DRIVER_H): Make them aliases to
FT_DRIVER_H.
* include/freetype/ftautoh.h, include/freetype/ftcffdrv.h,
include/freetype/ftpcfdrv.h, include/freetype/ftt1drv.h,
include/freetype/ftttdrv.h: Replaced with...
* include/freetype/ftdriver.h: ...this new file.
(FT_CFF_HINTING_ADOBE, FT_T1_HINTING_ADOBE): Renamed to...
(FT_HINTING_ADOBE): ... this new macro.
(FT_CFF_HINTING_FREETYPE, FT_T1_HINTING_FREETYPE): Renamed to...
(FT_HINTING_FREETYPE): ... this new macro.
* src/*/*: Updated accordingly.
2017-12-08 18:38:41 +01:00
|
|
|
* with @FT_Property_Set (see @no-stem-darkening).
|
2017-12-06 23:15:54 +01:00
|
|
|
*
|
|
|
|
* 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
|
2018-01-08 11:16:11 +01:00
|
|
|
* version 2.9).
|
2017-12-06 23:15:54 +01:00
|
|
|
*
|
|
|
|
* @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 */
|