kc3-lang/freetype/include/ftbbox.h

• Show log

  Commit

• Hash : de43ace7
  Author :
  Date : 2014-12-02T23:06:04
  

  * include/*: Improve structure of documentation. . Add and update many `<Order>' tags. . Apply various documentation fixes. . Remove details to deprecated (or never implemented) data.

Download

• include/ftbbox.h

• /***************************************************************************/
  /*                                                                         */
  /*  ftbbox.h                                                               */
  /*                                                                         */
  /*    FreeType exact bbox computation (specification).                     */
  /*                                                                         */
  /*  Copyright 1996-2001, 2003, 2007, 2011, 2013 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.                                        */
  /*                                                                         */
  /***************************************************************************/
  
  
    /*************************************************************************/
    /*                                                                       */
    /* This component has a _single_ role: to compute exact outline bounding */
    /* boxes.                                                                */
    /*                                                                       */
    /* It is separated from the rest of the engine for various technical     */
    /* reasons.  It may well be integrated in `ftoutln' later.               */
    /*                                                                       */
    /*************************************************************************/
  
  
  #ifndef __FTBBOX_H__
  #define __FTBBOX_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>                                                             */
    /*    outline_processing                                                 */
    /*                                                                       */
    /*************************************************************************/
  
  
    /*************************************************************************/
    /*                                                                       */
    /* <Function>                                                            */
    /*    FT_Outline_Get_BBox                                                */
    /*                                                                       */
    /* <Description>                                                         */
    /*    Compute the exact bounding box of an outline.  This is slower      */
    /*    than computing the control box.  However, it uses an advanced      */
    /*    algorithm that returns _very_ quickly when the two boxes           */
    /*    coincide.  Otherwise, the outline Bézier arcs are traversed to     */
    /*    extract their extrema.                                             */
    /*                                                                       */
    /* <Input>                                                               */
    /*    outline :: A pointer to the source outline.                        */
    /*                                                                       */
    /* <Output>                                                              */
    /*    abbox   :: The outline's exact bounding box.                       */
    /*                                                                       */
    /* <Return>                                                              */
    /*    FreeType error code.  0~means success.                             */
    /*                                                                       */
    /* <Note>                                                                */
    /*    If the font is tricky and the glyph has been loaded with           */
    /*    @FT_LOAD_NO_SCALE, the resulting BBox is meaningless.  To get      */
    /*    reasonable values for the BBox it is necessary to load the glyph   */
    /*    at a large ppem value (so that the hinting instructions can        */
    /*    properly shift and scale the subglyphs), then extracting the BBox, */
    /*    which can be eventually converted back to font units.              */
    /*                                                                       */
    FT_EXPORT( FT_Error )
    FT_Outline_Get_BBox( FT_Outline*  outline,
                         FT_BBox     *abbox );
  
    /* */
  
  
  FT_END_HEADER
  
  #endif /* __FTBBOX_H__ */
  
  
  /* END */
  
  
  /* Local Variables: */
  /* coding: utf-8    */
  /* End:             */
  

Download