ftlcdfil.h | ftlcdfil.h | |||
---|---|---|---|---|
/************************************************************************** */ | /************************************************************************** */ | |||
/* */ | /* */ | |||
/* ftlcdfil.h */ | /* ftlcdfil.h */ | |||
/* */ | /* */ | |||
/* FreeType API for color filtering of subpixel bitmap glyphs */ | /* FreeType API for color filtering of subpixel bitmap glyphs */ | |||
/* (specification). */ | /* (specification). */ | |||
/* */ | /* */ | |||
/* Copyright 2006, 2007, 2008 by */ | /* Copyright 2006, 2007, 2008, 2010 by */ | |||
/* David Turner, Robert Wilhelm, and Werner Lemberg. */ | /* David Turner, Robert Wilhelm, and Werner Lemberg. */ | |||
/* */ | /* */ | |||
/* This file is part of the FreeType project, and may only be used, */ | /* This file is part of the FreeType project, and may only be used, */ | |||
/* modified, and distributed under the terms of the FreeType project */ | /* modified, and distributed under the terms of the FreeType project */ | |||
/* license, LICENSE.TXT. By continuing to use, modify, or distribute */ | /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ | |||
/* this file you indicate that you have read the license and */ | /* this file you indicate that you have read the license and */ | |||
/* understand and accept it fully. */ | /* understand and accept it fully. */ | |||
/* */ | /* */ | |||
/************************************************************************** */ | /************************************************************************** */ | |||
skipping to change at line 58 | skipping to change at line 58 | |||
* which would occur with unfiltered rendering. | * which would occur with unfiltered rendering. | |||
* | * | |||
* Note that no filter is active by default, and that this function is | * Note that no filter is active by default, and that this function is | |||
* *not* implemented in default builds of the library. You need to | * *not* implemented in default builds of the library. You need to | |||
* #define FT_CONFIG_OPTION_SUBPIXEL_RENDERING in your `ftoption.h' fil e | * #define FT_CONFIG_OPTION_SUBPIXEL_RENDERING in your `ftoption.h' fil e | |||
* in order to activate it. | * in order to activate it. | |||
*/ | */ | |||
/************************************************************************ **** | /************************************************************************ **** | |||
* | * | |||
* @func: | * @enum: | |||
* FT_LcdFilter | * FT_LcdFilter | |||
* | * | |||
* @description: | * @description: | |||
* A list of values to identify various types of LCD filters. | * A list of values to identify various types of LCD filters. | |||
* | * | |||
* @values: | * @values: | |||
* FT_LCD_FILTER_NONE :: | * FT_LCD_FILTER_NONE :: | |||
* Do not perform filtering. When used with subpixel rendering, this | * Do not perform filtering. When used with subpixel rendering, this | |||
* results in sometimes severe color fringes. | * results in sometimes severe color fringes. | |||
* | * | |||
skipping to change at line 160 | skipping to change at line 160 | |||
* need to modify their layout and glyph positioning code when enabling | * need to modify their layout and glyph positioning code when enabling | |||
* the filter. | * the filter. | |||
* | * | |||
* @since: | * @since: | |||
* 2.3.0 | * 2.3.0 | |||
*/ | */ | |||
FT_EXPORT( FT_Error ) | FT_EXPORT( FT_Error ) | |||
FT_Library_SetLcdFilter( FT_Library library, | FT_Library_SetLcdFilter( FT_Library library, | |||
FT_LcdFilter filter ); | FT_LcdFilter filter ); | |||
/************************************************************************ | ||||
** | ||||
* | ||||
* @func: | ||||
* FT_Library_SetLcdFilterWeights | ||||
* | ||||
* @description: | ||||
* Use this function to override the filter weights selected by | ||||
* @FT_Library_SetLcdFilter. By default, FreeType uses the quintuple | ||||
* (0x00, 0x55, 0x56, 0x55, 0x00) for FT_LCD_FILTER_LIGHT, and (0x10, | ||||
* 0x40, 0x70, 0x40, 0x10) for FT_LCD_FILTER_DEFAULT and | ||||
* FT_LCD_FILTER_LEGACY. | ||||
* | ||||
* @input: | ||||
* library :: | ||||
* A handle to the target library instance. | ||||
* | ||||
* weights :: | ||||
* A pointer to an array; the function copies the first five bytes an | ||||
d | ||||
* uses them to specify the filter weights. | ||||
* | ||||
* @return: | ||||
* FreeType error code. 0~means success. | ||||
* | ||||
* @note: | ||||
* Due to *PATENTS* covering subpixel rendering, this function doesn't | ||||
* do anything except returning `FT_Err_Unimplemented_Feature' if the | ||||
* configuration macro FT_CONFIG_OPTION_SUBPIXEL_RENDERING is not | ||||
* defined in your build of the library, which should correspond to all | ||||
* default builds of FreeType. | ||||
* | ||||
* This function must be called after @FT_Library_SetLcdFilter to have | ||||
* any effect. | ||||
* | ||||
* @since: | ||||
* 2.4.0 | ||||
*/ | ||||
FT_EXPORT( FT_Error ) | ||||
FT_Library_SetLcdFilterWeights( FT_Library library, | ||||
unsigned char *weights ); | ||||
/* */ | /* */ | |||
FT_END_HEADER | FT_END_HEADER | |||
#endif /* __FT_LCD_FILTER_H__ */ | #endif /* __FT_LCD_FILTER_H__ */ | |||
/* END */ | /* END */ | |||
End of changes. 3 change blocks. | ||||
2 lines changed or deleted | 44 lines changed or added | |||
This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ |