topical media & game development
[] readme course(s) preface I 1 2 II 3 4 III 5 6 7 IV 8 9 10 V 11 12 afterthought(s) appendix reference(s) example(s) resource(s) _

talk show tell print

lib-of-vs-libs-free-type-2.1.4-include-freetype2-freetype-ftpfr.h / h
************************************************************************

  
  /*                                                                         */
  /*  ftpfr.h                                                                */
  /*                                                                         */
  /*    FreeType API for accessing PFR-specific data                         */
  /*                                                                         */
  /*  Copyright 2002 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
  
  FT_BEGIN_HEADER
**********************************************************************

  
    /*                                                                       */
    /* <Section>                                                             */
    /*    pfr_fonts                                                          */
    /*                                                                       */
    /* <Title>                                                               */
    /*    PFR Fonts                                                          */
    /*                                                                       */
    /* <Abstract>                                                            */
    /*    PFR/TrueDoc specific APIs                                          */
    /*                                                                       */
    /* <Description>                                                         */
    /*    This section contains the declaration of PFR-specific functions.   */
    /*                                                                       */
**********************************************************************
******************************************************************** @function: FT_Get_PFR_Metrics @description: returns the outline and metrics resolutions of a given PFR face. @input: face :: handle to input face. It can be a non-PFR face. @output: aoutline_resolution :: outline resolution. This is equivalent to "face->units_per_EM". optional (parameter can be NULL) ametrics_resolution :: metrics_resolution. This is equivalent to "outline_resolution" for non-PFR fonts. can be NULL 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) @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: returns 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 :: handle to input face. left :: left glyph index right :: right glyph index @output: avector :: kerning vector @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 return 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: returns a given glyph advance, expressed in original metrics units, from a PFR font. @input: face :: handle to input face. gindex :: glyph index @output: aadvance :: glyph advance in metrics units @return: 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 /* __FTBDF_H__ */
  
  /* END */
[] readme course(s) preface I 1 2 II 3 4 III 5 6 7 IV 8 9 10 V 11 12 afterthought(s) appendix reference(s) example(s) resource(s) _

(C) Æliens 04/09/2009

You may not copy or print any of this material without explicit permission of the author or the publisher. In case of other copyright issues, contact the author.