[Index] [TOC]

FreeType-2.5.0 API Reference

The CFF driver

Synopsis

hinting-engineFT_CFF_HINTING_XXXno-stem-darkening


While FreeType's CFF 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.

The CFF driver's module name is ‘cff’.


hinting-engine

Thanks to Adobe, which contributed a new hinting (and parsing) engine, an application can select between ‘freetype’ and ‘adobe’ if compiled with CFF_CONFIG_OPTION_OLD_ENGINE. If this configuration macro isn't defined, ‘hinting-engine’ does nothing.

The default engine is ‘freetype’ if CFF_CONFIG_OPTION_OLD_ENGINE is defined, and ‘adobe’ otherwise.

The following example code demonstrates how to select Adobe's hinting engine (omitting the error handling).

  FT_Library  library;
  FT_Face     face;
  FT_UInt     hinting_engine = FT_CFF_HINTING_ADOBE;


  FT_Init_FreeType( &library );

  FT_Property_Set( library, "cff",
                            "hinting-engine", &hinting_engine );

note

This property can be used with FT_Property_Get also.


[Index] [TOC]

FT_CFF_HINTING_XXX

Defined in FT_CFF_DRIVER_H (freetype/ftcffdrv.h).


#define FT_CFF_HINTING_FREETYPE  0
#define FT_CFF_HINTING_ADOBE     1


A list of constants used for the hinting-engine property to select the hinting engine for CFF fonts.


values

FT_CFF_HINTING_FREETYPE

Use the old FreeType hinting engine.

FT_CFF_HINTING_ADOBE

Use the hinting engine contributed by Adobe.


[Index] [TOC]

no-stem-darkening

By default, the Adobe CFF engine darkens stems at smaller sizes, regardless of hinting, to enhance contrast. Setting this property, stem darkening gets switched off.

Note that stem darkening is never applied if FT_LOAD_NO_SCALE is set.

  FT_Library  library;
  FT_Face     face;
  FT_Bool     no_stem_darkening = TRUE;


  FT_Init_FreeType( &library );

  FT_Property_Set( library, "cff",
                            "no-stem-darkening", &no_stem_darkening );

note

This property can be used with FT_Property_Get also.


[Index] [TOC]