8502c98b15
We no longer `pollute' the namespace of possible header file names; instead we move `ft2build.h' up by one level so that it gets installed in the default include directory (e.g., /usr/local/include). After this commit, only `ft2build.h' stays in the compiler's include path. No visible changes for the user who follows the standard FreeType header inclusion rules. * include/*: Move to ... * include/freetype2/*: This directory, except `ft2build.h'. * CMakeLists.txt (PUBLIC_HEADERS, PUBLIC_CONFIG_HEADERS, PRIVATE_HEADERS), Jamfile (HDRMACRO, RefDoc), autogen.sh: Updated. * builds/amiga/include/config/ftconfig.h, builds/freetype.mk (PUBLIC_DIR), builds/symbian/bld.inf, builds/toplevel.mk (work), builds/unix/install.mk (install, uninstall), builds/unix/freetype2.in: Updated. * builds/unix/freetype-config.in: Updated. Emit -I directory only if it is not `/usr/include'. * builds/wince/*, builds/windows/*: Updated. * devel/ft2build.h, include/ft2build.h: Updated. * include/freetype2/config/ftheader.h, include/freetype2/internal/ftserv.h, include/freetype2/internal/internal.h: Update all header file macros. * src/tools/chktrcmp.py (TRACE_DEF_FILES): Updated. * docs/*: Updated.
173 lines
6.1 KiB
C
173 lines
6.1 KiB
C
/***************************************************************************/
|
|
/* */
|
|
/* ftpfr.h */
|
|
/* */
|
|
/* FreeType API for accessing PFR-specific data (specification only). */
|
|
/* */
|
|
/* Copyright 2002-2015 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 __FTPFR_H__
|
|
#define __FTPFR_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> */
|
|
/* pfr_fonts */
|
|
/* */
|
|
/* <Title> */
|
|
/* PFR Fonts */
|
|
/* */
|
|
/* <Abstract> */
|
|
/* PFR/TrueDoc specific API. */
|
|
/* */
|
|
/* <Description> */
|
|
/* This section contains the declaration of PFR-specific functions. */
|
|
/* */
|
|
/*************************************************************************/
|
|
|
|
|
|
/**********************************************************************
|
|
*
|
|
* @function:
|
|
* FT_Get_PFR_Metrics
|
|
*
|
|
* @description:
|
|
* Return the outline and metrics resolutions of a given PFR face.
|
|
*
|
|
* @input:
|
|
* face :: Handle to the input face. It can be a non-PFR face.
|
|
*
|
|
* @output:
|
|
* aoutline_resolution ::
|
|
* Outline resolution. This is equivalent to `face->units_per_EM'
|
|
* for non-PFR fonts. Optional (parameter can be NULL).
|
|
*
|
|
* ametrics_resolution ::
|
|
* Metrics resolution. This is equivalent to `outline_resolution'
|
|
* for non-PFR fonts. Optional (parameter can be NULL).
|
|
*
|
|
* ametrics_x_scale ::
|
|
* A 16.16 fixed-point number used to scale distance expressed
|
|
* in metrics units to device sub-pixels. This is equivalent to
|
|
* `face->size->x_scale', but for metrics only. Optional (parameter
|
|
* can be NULL).
|
|
*
|
|
* ametrics_y_scale ::
|
|
* Same as `ametrics_x_scale' but for the vertical direction.
|
|
* optional (parameter can be NULL).
|
|
*
|
|
* @return:
|
|
* FreeType error code. 0~means success.
|
|
*
|
|
* @note:
|
|
* If the input face is not a PFR, this function will return an error.
|
|
* However, in all cases, it will return valid values.
|
|
*/
|
|
FT_EXPORT( FT_Error )
|
|
FT_Get_PFR_Metrics( FT_Face face,
|
|
FT_UInt *aoutline_resolution,
|
|
FT_UInt *ametrics_resolution,
|
|
FT_Fixed *ametrics_x_scale,
|
|
FT_Fixed *ametrics_y_scale );
|
|
|
|
|
|
/**********************************************************************
|
|
*
|
|
* @function:
|
|
* FT_Get_PFR_Kerning
|
|
*
|
|
* @description:
|
|
* Return the kerning pair corresponding to two glyphs in a PFR face.
|
|
* The distance is expressed in metrics units, unlike the result of
|
|
* @FT_Get_Kerning.
|
|
*
|
|
* @input:
|
|
* face :: A handle to the input face.
|
|
*
|
|
* left :: Index of the left glyph.
|
|
*
|
|
* right :: Index of the right glyph.
|
|
*
|
|
* @output:
|
|
* avector :: A kerning vector.
|
|
*
|
|
* @return:
|
|
* FreeType error code. 0~means success.
|
|
*
|
|
* @note:
|
|
* This function always return distances in original PFR metrics
|
|
* units. This is unlike @FT_Get_Kerning with the @FT_KERNING_UNSCALED
|
|
* mode, which always returns distances converted to outline units.
|
|
*
|
|
* You can use the value of the `x_scale' and `y_scale' parameters
|
|
* returned by @FT_Get_PFR_Metrics to scale these to device sub-pixels.
|
|
*/
|
|
FT_EXPORT( FT_Error )
|
|
FT_Get_PFR_Kerning( FT_Face face,
|
|
FT_UInt left,
|
|
FT_UInt right,
|
|
FT_Vector *avector );
|
|
|
|
|
|
/**********************************************************************
|
|
*
|
|
* @function:
|
|
* FT_Get_PFR_Advance
|
|
*
|
|
* @description:
|
|
* Return a given glyph advance, expressed in original metrics units,
|
|
* from a PFR font.
|
|
*
|
|
* @input:
|
|
* face :: A handle to the input face.
|
|
*
|
|
* gindex :: The glyph index.
|
|
*
|
|
* @output:
|
|
* aadvance :: The glyph advance in metrics units.
|
|
*
|
|
* @return:
|
|
* FreeType error code. 0~means success.
|
|
*
|
|
* @note:
|
|
* You can use the `x_scale' or `y_scale' results of @FT_Get_PFR_Metrics
|
|
* to convert the advance to device sub-pixels (i.e., 1/64th of pixels).
|
|
*/
|
|
FT_EXPORT( FT_Error )
|
|
FT_Get_PFR_Advance( FT_Face face,
|
|
FT_UInt gindex,
|
|
FT_Pos *aadvance );
|
|
|
|
/* */
|
|
|
|
|
|
FT_END_HEADER
|
|
|
|
#endif /* __FTPFR_H__ */
|
|
|
|
|
|
/* END */
|