/***************************************************************************/ | |
/* */ | |
/* ftbbox.h */ | |
/* */ | |
/* FreeType exact bbox computation (specification). */ | |
/* */ | |
/* Copyright 1996-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. */ | |
/* */ | |
/***************************************************************************/ | |
/*************************************************************************/ | |
/* */ | |
/* 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: */ |