52f911a12d
correctly. This doesn't slow down the loading of PS fonts significantly since charstrings aren't affected. * include/freetype/config/ftstdlib.h (ft_xdigit): Renamed to... (ft_isxdigit): This. Updated all callers. (ft_isdigit): New alias to `isdigit'. * include/freetype/internal/psaux.h (PS_Parser_FuncsRec): Renamed `skip_alpha' to `skip_PS_token'. Add parameter to `to_bytes' and change some argument types. * src/psaux/psauxmod.c (ps_parser_funcs): Updated. * src/psaux/psobjs.c (ft_char_table): New array to map character codes (ASCII and EBCDIC) of digits to numbers. (OP): New auxiliary macro holding either `>=' or `<' depending on the character encoding. (skip_comment): New function. (skip_spaces): Use it. (skip_alpha): Removed. (skip_literal_string, skip_string): New functions. (ps_parser_skip_PS_token): New function. This is a better replacement of... (ps_parser_skip_alpha): Removed. (ps_parser_to_token, ps+parser_to_token_array): Updated. (T1Radix): Rewritten, using `ft_char_table'. (t1_toint): Renamed to... (ps_toint): This. Update all callers. Use `ft_char_table'. (ps_tobytes): Add parameter to handle delimiters and change some argument types. Use `ft_char_table'. (t1_tofixed): Renamed to... (ps_tofixed): This. Update all callers. Use `ft_char_table'. (t1_tocoordarray): Renamed and updated to... (ps_tocoordarray): This. Update all callers. (t1_tofixedarray): Renamed and updated to... (ps_tofixedarray): This. Update all callers. (t1_tobool): Renamed to... (ps_tobool): This. Update all callers. (ps_parser_load_field): Updated. (ps_parser_load_field_table): Use `T1_MAX_TABLE_ELEMENTS' everywhere. (ps_parser_to_int, ps_parser_to_fixed, ps_parser_to_coord_array, ps_parser_to_fixed_array): Skip spaces. Updated. (ps_parser_to_bytes): Add parameter to handle delimiters and change some argument types. Updated. * src/psaux/psobjs.h: Updated. * src/cid/cidload.c (cid_parse_dict): Updated. * src/cid/cidparse.c (cid_parser_new): Check whether the `StartData' token was really found. * src/cid/cidparse.h (cid_parser_skip_alpha): Updated and renamed to... (cid_parser_skip_PS_token): This. * src/type1/t1parse.h (T1_ParserRec): Use `FT_Bool' for boolean fields. (T1_Skip_Alpha): Replaced with... (T1_Skip_PS_Token): This new macro. * src/type1/t1parse.c (hexa_value): Removed. (T1_Get_Private_Dict): Use `ft_isxdigit' and `psaux->ps_parser_funcs_to_bytes' for handling ASCII hexadecimal encoding. After decrypting, replace the four random bytes at the beginning with whitespace. * src/type1/t1load.c (t1_allocate_blend): Use proper error values. (parser_blend_design_positions, parse_blend_design_map, parse_weight_vector): Updated. (is_space): Handle `\f' also. (is_name_char): Removed. (read_binary_data): Updated. (parse_encoding): Use `ft_isdigit'. Updated. (parse_subrs): Updated. (TABLE_EXTEND): New macro. (parse_charstrings): Updated. Provide a workaround for buggy fonts which have more entries in the /CharStrings dictionary then expected; the function now adds some slots and skips entries which still exceed the new limit. (parse_dict): Updated. Terminate on the token `closefile'. * src/type42/t42parse.c (T1_Skip_Alpha): Replaced with... (T1_Skip_PS_Token): This new macro. Updated all callers. (t42_parse_encoding): Use `ft_isdigit'. * src/base/ftmm.c (ft_face_get_mm_service): Return FT_Err_OK if success.
467 lines
27 KiB
C
467 lines
27 KiB
C
/***************************************************************************/
|
|
/* */
|
|
/* ftoutln.h */
|
|
/* */
|
|
/* Support for the FT_Outline type used to store glyph shapes of */
|
|
/* most scalable font formats (specification). */
|
|
/* */
|
|
/* Copyright 1996-2001, 2002, 2003 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 __FTOUTLN_H__
|
|
#define __FTOUTLN_H__
|
|
|
|
|
|
#include <ft2build.h>
|
|
#include FT_FREETYPE_H
|
|
|
|
|
|
FT_BEGIN_HEADER
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Section> */
|
|
/* outline_processing */
|
|
/* */
|
|
/* <Title> */
|
|
/* Outline Processing */
|
|
/* */
|
|
/* <Abstract> */
|
|
/* Functions to create, transform, and render vectorial glyph images. */
|
|
/* */
|
|
/* <Description> */
|
|
/* This section contains routines used to create and destroy scalable */
|
|
/* glyph images known as `outlines'. These can also be measured, */
|
|
/* transformed, and converted into bitmaps and pixmaps. */
|
|
/* */
|
|
/* <Order> */
|
|
/* FT_Outline */
|
|
/* FT_OUTLINE_FLAGS */
|
|
/* FT_Outline_New */
|
|
/* FT_Outline_Done */
|
|
/* FT_Outline_Copy */
|
|
/* FT_Outline_Translate */
|
|
/* FT_Outline_Transform */
|
|
/* FT_Outline_Reverse */
|
|
/* FT_Outline_Check */
|
|
/* */
|
|
/* FT_Outline_Get_CBox */
|
|
/* FT_Outline_Get_BBox */
|
|
/* */
|
|
/* FT_Outline_Get_Bitmap */
|
|
/* FT_Outline_Render */
|
|
/* */
|
|
/* FT_Outline_Decompose */
|
|
/* FT_Outline_Funcs */
|
|
/* FT_Outline_MoveTo_Func */
|
|
/* FT_Outline_LineTo_Func */
|
|
/* FT_Outline_ConicTo_Func */
|
|
/* FT_Outline_CubicTo_Func */
|
|
/* */
|
|
/*************************************************************************/
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Decompose */
|
|
/* */
|
|
/* <Description> */
|
|
/* Walks over an outline's structure to decompose it into individual */
|
|
/* segments and Bezier arcs. This function is also able to emit */
|
|
/* `move to' and `close to' operations to indicate the start and end */
|
|
/* of new contours in the outline. */
|
|
/* */
|
|
/* <Input> */
|
|
/* outline :: A pointer to the source target. */
|
|
/* */
|
|
/* func_interface :: A table of `emitters', i.e,. function pointers */
|
|
/* called during decomposition to indicate path */
|
|
/* operations. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* user :: A typeless pointer which is passed to each */
|
|
/* emitter during the decomposition. It can be */
|
|
/* used to store the state during the */
|
|
/* decomposition. */
|
|
/* */
|
|
/* <Return> */
|
|
/* FreeType error code. 0 means sucess. */
|
|
/* */
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_Decompose( FT_Outline* outline,
|
|
const FT_Outline_Funcs* func_interface,
|
|
void* user );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_New */
|
|
/* */
|
|
/* <Description> */
|
|
/* Creates a new outline of a given size. */
|
|
/* */
|
|
/* <Input> */
|
|
/* library :: A handle to the library object from where the */
|
|
/* outline is allocated. Note however that the new */
|
|
/* outline will NOT necessarily be FREED, when */
|
|
/* destroying the library, by FT_Done_FreeType(). */
|
|
/* */
|
|
/* numPoints :: The maximal number of points within the outline. */
|
|
/* */
|
|
/* numContours :: The maximal number of contours within the outline. */
|
|
/* */
|
|
/* <Output> */
|
|
/* anoutline :: A handle to the new outline. NULL in case of */
|
|
/* error. */
|
|
/* */
|
|
/* <Return> */
|
|
/* FreeType error code. 0 means success. */
|
|
/* */
|
|
/* <Note> */
|
|
/* The reason why this function takes a `library' parameter is simply */
|
|
/* to use the library's memory allocator. */
|
|
/* */
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_New( FT_Library library,
|
|
FT_UInt numPoints,
|
|
FT_Int numContours,
|
|
FT_Outline *anoutline );
|
|
|
|
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_New_Internal( FT_Memory memory,
|
|
FT_UInt numPoints,
|
|
FT_Int numContours,
|
|
FT_Outline *anoutline );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Done */
|
|
/* */
|
|
/* <Description> */
|
|
/* Destroys an outline created with FT_Outline_New(). */
|
|
/* */
|
|
/* <Input> */
|
|
/* library :: A handle of the library object used to allocate the */
|
|
/* outline. */
|
|
/* */
|
|
/* outline :: A pointer to the outline object to be discarded. */
|
|
/* */
|
|
/* <Return> */
|
|
/* FreeType error code. 0 means success. */
|
|
/* */
|
|
/* <Note> */
|
|
/* If the outline's `owner' field is not set, only the outline */
|
|
/* descriptor will be released. */
|
|
/* */
|
|
/* The reason why this function takes an `library' parameter is */
|
|
/* simply to use FT_Free(). */
|
|
/* */
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_Done( FT_Library library,
|
|
FT_Outline* outline );
|
|
|
|
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_Done_Internal( FT_Memory memory,
|
|
FT_Outline* outline );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Check */
|
|
/* */
|
|
/* <Description> */
|
|
/* Check the contents of an outline descriptor. */
|
|
/* */
|
|
/* <Input> */
|
|
/* outline :: A handle to a source outline. */
|
|
/* */
|
|
/* <Return> */
|
|
/* FreeType error code. 0 means success. */
|
|
/* */
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_Check( FT_Outline* outline );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Get_CBox */
|
|
/* */
|
|
/* <Description> */
|
|
/* Returns an outline's `control box'. The control box encloses all */
|
|
/* the outline's points, including Bezier control points. Though it */
|
|
/* coincides with the exact bounding box for most glyphs, it can be */
|
|
/* slightly larger in some situations (like when rotating an outline */
|
|
/* which contains Bezier outside arcs). */
|
|
/* */
|
|
/* Computing the control box is very fast, while getting the bounding */
|
|
/* box can take much more time as it needs to walk over all segments */
|
|
/* and arcs in the outline. To get the latter, you can use the */
|
|
/* `ftbbox' component which is dedicated to this single task. */
|
|
/* */
|
|
/* <Input> */
|
|
/* outline :: A pointer to the source outline descriptor. */
|
|
/* */
|
|
/* <Output> */
|
|
/* acbox :: The outline's control box. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_Outline_Get_CBox( FT_Outline* outline,
|
|
FT_BBox *acbox );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Translate */
|
|
/* */
|
|
/* <Description> */
|
|
/* Applies a simple translation to the points of an outline. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* outline :: A pointer to the target outline descriptor. */
|
|
/* */
|
|
/* <Input> */
|
|
/* xOffset :: The horizontal offset. */
|
|
/* */
|
|
/* yOffset :: The vertical offset. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_Outline_Translate( FT_Outline* outline,
|
|
FT_Pos xOffset,
|
|
FT_Pos yOffset );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Copy */
|
|
/* */
|
|
/* <Description> */
|
|
/* Copies an outline into another one. Both objects must have the */
|
|
/* same sizes (number of points & number of contours) when this */
|
|
/* function is called. */
|
|
/* */
|
|
/* <Input> */
|
|
/* source :: A handle to the source outline. */
|
|
/* */
|
|
/* <Output> */
|
|
/* target :: A handle to the target outline. */
|
|
/* */
|
|
/* <Return> */
|
|
/* FreeType error code. 0 means success. */
|
|
/* */
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_Copy( FT_Outline* source,
|
|
FT_Outline *target );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Transform */
|
|
/* */
|
|
/* <Description> */
|
|
/* Applies a simple 2x2 matrix to all of an outline's points. Useful */
|
|
/* for applying rotations, slanting, flipping, etc. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* outline :: A pointer to the target outline descriptor. */
|
|
/* */
|
|
/* <Input> */
|
|
/* matrix :: A pointer to the transformation matrix. */
|
|
/* */
|
|
/* <Note> */
|
|
/* You can use FT_Outline_Translate() if you need to translate the */
|
|
/* outline's points. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_Outline_Transform( FT_Outline* outline,
|
|
FT_Matrix* matrix );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Reverse */
|
|
/* */
|
|
/* <Description> */
|
|
/* Reverses the drawing direction of an outline. This is used to */
|
|
/* ensure consistent fill conventions for mirrored glyphs. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* outline :: A pointer to the target outline descriptor. */
|
|
/* */
|
|
/* <Note> */
|
|
/* This functions toggles the bit flag `FT_OUTLINE_REVERSE_FILL' in */
|
|
/* the outline's `flags' field. */
|
|
/* */
|
|
/* It shouldn't be used by a normal client application, unless it */
|
|
/* knows what it is doing. */
|
|
/* */
|
|
FT_EXPORT( void )
|
|
FT_Outline_Reverse( FT_Outline* outline );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Get_Bitmap */
|
|
/* */
|
|
/* <Description> */
|
|
/* Renders an outline within a bitmap. The outline's image is simply */
|
|
/* OR-ed to the target bitmap. */
|
|
/* */
|
|
/* <Input> */
|
|
/* library :: A handle to a FreeType library object. */
|
|
/* */
|
|
/* outline :: A pointer to the source outline descriptor. */
|
|
/* */
|
|
/* <Output> */
|
|
/* abitmap :: A pointer to the target bitmap descriptor. */
|
|
/* */
|
|
/* <Return> */
|
|
/* FreeType error code. 0 means success. */
|
|
/* */
|
|
/* <Note> */
|
|
/* This function does NOT CREATE the bitmap, it only renders an */
|
|
/* outline image within the one you pass to it! */
|
|
/* */
|
|
/* It will use the raster correponding to the default glyph format. */
|
|
/* */
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_Get_Bitmap( FT_Library library,
|
|
FT_Outline* outline,
|
|
FT_Bitmap *abitmap );
|
|
|
|
|
|
/*************************************************************************/
|
|
/* */
|
|
/* <Function> */
|
|
/* FT_Outline_Render */
|
|
/* */
|
|
/* <Description> */
|
|
/* Renders an outline within a bitmap using the current scan-convert. */
|
|
/* This functions uses an FT_Raster_Params structure as an argument, */
|
|
/* allowing advanced features like direct composition, translucency, */
|
|
/* etc. */
|
|
/* */
|
|
/* <Input> */
|
|
/* library :: A handle to a FreeType library object. */
|
|
/* */
|
|
/* outline :: A pointer to the source outline descriptor. */
|
|
/* */
|
|
/* <InOut> */
|
|
/* params :: A pointer to a FT_Raster_Params structure used to */
|
|
/* describe the rendering operation. */
|
|
/* */
|
|
/* <Return> */
|
|
/* FreeType error code. 0 means success. */
|
|
/* */
|
|
/* <Note> */
|
|
/* You should know what you are doing and how FT_Raster_Params works */
|
|
/* to use this function. */
|
|
/* */
|
|
/* The field `params.source' will be set to `outline' before the scan */
|
|
/* converter is called, which means that the value you give to it is */
|
|
/* actually ignored. */
|
|
/* */
|
|
FT_EXPORT( FT_Error )
|
|
FT_Outline_Render( FT_Library library,
|
|
FT_Outline* outline,
|
|
FT_Raster_Params* params );
|
|
|
|
|
|
/**************************************************************************
|
|
*
|
|
* @enum:
|
|
* FT_Orientation
|
|
*
|
|
* @description:
|
|
* A list of values used to describe an outline's contour orientation.
|
|
*
|
|
* The TrueType and Postscript specifications use different conventions
|
|
* to determine whether outline contours should be filled or unfilled.
|
|
*
|
|
* @values:
|
|
* FT_ORIENTATION_TRUETYPE ::
|
|
* According to the TrueType specification, clockwise contours must
|
|
* be filled, and counter-clockwise ones must be unfilled.
|
|
*
|
|
* FT_ORIENTATION_POSTSCRIPT ::
|
|
* According to the Postscript specification, counter-clockwise contours
|
|
* must be filled, and clockwise ones must be unfilled.
|
|
*
|
|
* FT_ORIENTATION_FILL_RIGHT ::
|
|
* This is identical to @FT_ORIENTATION_TRUETYPE, but is used to
|
|
* remember that in TrueType, everything that is to the right of
|
|
* the drawing direction of a contour must be filled.
|
|
*
|
|
* FT_ORIENTATION_FILL_LEFT ::
|
|
* This is identical to @FT_ORIENTATION_POSTSCRIPT, but is used to
|
|
* remember that in Postscript, everything that is to the left of
|
|
* the drawing direction of a contour must be filled.
|
|
*/
|
|
typedef enum
|
|
{
|
|
FT_ORIENTATION_TRUETYPE = 0,
|
|
FT_ORIENTATION_POSTSCRIPT = 1,
|
|
FT_ORIENTATION_FILL_RIGHT = FT_ORIENTATION_TRUETYPE,
|
|
FT_ORIENTATION_FILL_LEFT = FT_ORIENTATION_POSTSCRIPT
|
|
|
|
} FT_Orientation;
|
|
|
|
|
|
/**************************************************************************
|
|
*
|
|
* @function:
|
|
* FT_Outline_Get_Orientation
|
|
*
|
|
* @description:
|
|
* This function analyzes a glyph outline and tries to compute its
|
|
* fill orientation (see @FT_Orientation). This is done by computing
|
|
* the direction of each global horizontal and/or vertical extrema
|
|
* within the outline.
|
|
*
|
|
* Note that this will return @FT_ORIENTATION_TRUETYPE for empty
|
|
* outlines.
|
|
*
|
|
* @input:
|
|
* outline ::
|
|
* A handle to the source outline.
|
|
*
|
|
* @return:
|
|
* The orientation.
|
|
*
|
|
*/
|
|
FT_EXPORT( FT_Orientation )
|
|
FT_Outline_Get_Orientation( FT_Outline* outline );
|
|
|
|
|
|
/* */
|
|
|
|
|
|
FT_END_HEADER
|
|
|
|
#endif /* __FTOUTLN_H__ */
|
|
|
|
|
|
/* END */
|