Changeset 251 for trunk/poppler/freetype2/include/freetype/ftcache.h
- Timestamp:
- Jun 30, 2008, 6:26:14 PM (13 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/poppler/freetype2/include/freetype/ftcache.h
r209 r251 5 5 /* FreeType Cache subsystem (specification). */ 6 6 /* */ 7 /* Copyright 1996-2001, 2002, 2003, 2004, 2005, 2006, 2007 by*/7 /* Copyright 1996-2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 by */ 8 8 /* David Turner, Robert Wilhelm, and Werner Lemberg. */ 9 9 /* */ … … 37 37 * 38 38 * <Abstract> 39 * How to cache face, size, and glyph data with FreeType 39 * How to cache face, size, and glyph data with FreeType~2. 40 40 * 41 41 * <Description> 42 * This section describes the FreeType 42 * This section describes the FreeType~2 cache sub-system, which is used 43 43 * to limit the number of concurrently opened @FT_Face and @FT_Size 44 44 * objects, as well as caching information like character maps and glyph … … 166 166 * memory leaks and crashes. 167 167 */ 168 typedef struct FTC_FaceIDRec_*FTC_FaceID;168 typedef FT_Pointer FTC_FaceID; 169 169 170 170 … … 194 194 * 195 195 * <Return> 196 * FreeType error code. 0 196 * FreeType error code. 0~means success. 197 197 * 198 198 * <Note> … … 261 261 /* <Description> */ 262 262 /* An opaque handle to a cache node object. Each cache node is */ 263 /* reference-counted. A node with a count of 263 /* reference-counted. A node with a count of~0 might be flushed */ 264 264 /* out of a full cache whenever a lookup request is performed. */ 265 265 /* */ … … 280 280 /* */ 281 281 /* <Description> */ 282 /* Create s a new cache manager.*/282 /* Create a new cache manager. */ 283 283 /* */ 284 284 /* <Input> */ … … 286 286 /* */ 287 287 /* max_faces :: Maximum number of opened @FT_Face objects managed by */ 288 /* this cache instance. Use 288 /* this cache instance. Use~0 for defaults. */ 289 289 /* */ 290 290 /* max_sizes :: Maximum number of opened @FT_Size objects managed by */ 291 /* this cache instance. Use 291 /* this cache instance. Use~0 for defaults. */ 292 292 /* */ 293 293 /* max_bytes :: Maximum number of bytes to use for cached data nodes. */ 294 /* Use 294 /* Use~0 for defaults. Note that this value does not */ 295 295 /* account for managed @FT_Face and @FT_Size objects. */ 296 296 /* */ … … 302 302 /* */ 303 303 /* <Output> */ 304 /* amanager :: A handle to a new manager object. 0 304 /* amanager :: A handle to a new manager object. 0~in case of */ 305 305 /* failure. */ 306 306 /* */ 307 307 /* <Return> */ 308 /* FreeType error code. 0 308 /* FreeType error code. 0~means success. */ 309 309 /* */ 310 310 FT_EXPORT( FT_Error ) … … 324 324 /* */ 325 325 /* <Description> */ 326 /* Empt ies a given cache manager. This simply gets rid of all the*/326 /* Empty a given cache manager. This simply gets rid of all the */ 327 327 /* currently cached @FT_Face and @FT_Size objects within the manager. */ 328 328 /* */ … … 340 340 /* */ 341 341 /* <Description> */ 342 /* Destroy s a given manager after emptying it.*/342 /* Destroy a given manager after emptying it. */ 343 343 /* */ 344 344 /* <Input> */ … … 355 355 /* */ 356 356 /* <Description> */ 357 /* Retrieve s the @FT_Face object that corresponds to a given face ID*/357 /* Retrieve the @FT_Face object that corresponds to a given face ID */ 358 358 /* through a cache manager. */ 359 359 /* */ … … 367 367 /* */ 368 368 /* <Return> */ 369 /* FreeType error code. 0 369 /* FreeType error code. 0~means success. */ 370 370 /* */ 371 371 /* <Note> */ … … 416 416 /* Otherwise, they are expressed as 1/64th of points. */ 417 417 /* */ 418 /* x_res :: Only used when `pixel' is value 418 /* x_res :: Only used when `pixel' is value~0 to indicate the */ 419 419 /* horizontal resolution in dpi. */ 420 420 /* */ 421 /* y_res :: Only used when `pixel' is value 421 /* y_res :: Only used when `pixel' is value~0 to indicate the */ 422 422 /* vertical resolution in dpi. */ 423 423 /* */ … … 435 435 FT_UInt y_res; 436 436 437 } FTC_ScalerRec, *FTC_Scaler; 437 } FTC_ScalerRec; 438 439 440 /*************************************************************************/ 441 /* */ 442 /* <Struct> */ 443 /* FTC_Scaler */ 444 /* */ 445 /* <Description> */ 446 /* A handle to an @FTC_ScalerRec structure. */ 447 /* */ 448 typedef struct FTC_ScalerRec_* FTC_Scaler; 438 449 439 450 … … 456 467 /* */ 457 468 /* <Return> */ 458 /* FreeType error code. 0 469 /* FreeType error code. 0~means success. */ 459 470 /* */ 460 471 /* <Note> */ … … 570 581 * 571 582 * @return: 572 * FreeType error code. 0 583 * FreeType error code. 0~means success. 573 584 * 574 585 * @note: … … 605 616 * 606 617 * @return: 607 * Glyph index. 0 618 * Glyph index. 0~means `no glyph'. 608 619 * 609 620 */ … … 711 722 /* */ 712 723 /* <Description> */ 713 /* Create s a new glyph image cache.*/724 /* Create a new glyph image cache. */ 714 725 /* */ 715 726 /* <Input> */ … … 720 731 /* */ 721 732 /* <Return> */ 722 /* FreeType error code. 0 733 /* FreeType error code. 0~means success. */ 723 734 /* */ 724 735 FT_EXPORT( FT_Error ) … … 733 744 /* */ 734 745 /* <Description> */ 735 /* Retrieve s a given glyph image from a glyph image cache.*/746 /* Retrieve a given glyph image from a glyph image cache. */ 736 747 /* */ 737 748 /* <Input> */ … … 743 754 /* */ 744 755 /* <Output> */ 745 /* aglyph :: The corresponding @FT_Glyph object. 0 756 /* aglyph :: The corresponding @FT_Glyph object. 0~in case of */ 746 757 /* failure. */ 747 758 /* */ … … 751 762 /* */ 752 763 /* <Return> */ 753 /* FreeType error code. 0 764 /* FreeType error code. 0~means success. */ 754 765 /* */ 755 766 /* <Note> */ … … 796 807 /* */ 797 808 /* <Output> */ 798 /* aglyph :: The corresponding @FT_Glyph object. 0 809 /* aglyph :: The corresponding @FT_Glyph object. 0~in case of */ 799 810 /* failure. */ 800 811 /* */ … … 804 815 /* */ 805 816 /* <Return> */ 806 /* FreeType error code. 0 817 /* FreeType error code. 0~means success. */ 807 818 /* */ 808 819 /* <Note> */ … … 863 874 /* baseline) to the upper bitmap border (a.k.a. `top */ 864 875 /* side bearing'). The distance is positive for upwards */ 865 /* Ycoordinates. */876 /* y~coordinates. */ 866 877 /* */ 867 878 /* format :: The format of the glyph bitmap (monochrome or gray). */ 868 879 /* */ 869 /* max_grays :: Maximum gray level value (in the range 1 to 880 /* max_grays :: Maximum gray level value (in the range 1 to~255). */ 870 881 /* */ 871 882 /* pitch :: The number of bytes per bitmap line. May be positive */ … … 916 927 /* */ 917 928 /* <Description> */ 918 /* Create s a new cache to store small glyph bitmaps.*/929 /* Create a new cache to store small glyph bitmaps. */ 919 930 /* */ 920 931 /* <Input> */ … … 925 936 /* */ 926 937 /* <Return> */ 927 /* FreeType error code. 0 938 /* FreeType error code. 0~means success. */ 928 939 /* */ 929 940 FT_EXPORT( FT_Error ) … … 938 949 /* */ 939 950 /* <Description> */ 940 /* Look s up a given small glyph bitmap in a given sbit cache and*/951 /* Look up a given small glyph bitmap in a given sbit cache and */ 941 952 /* `lock' it to prevent its flushing from the cache until needed. */ 942 953 /* */ … … 956 967 /* */ 957 968 /* <Return> */ 958 /* FreeType error code. 0 969 /* FreeType error code. 0~means success. */ 959 970 /* */ 960 971 /* <Note> */ … … 964 975 /* treat them as persistent data. */ 965 976 /* */ 966 /* The descriptor's `buffer' field is set to 977 /* The descriptor's `buffer' field is set to~0 to indicate a missing */ 967 978 /* glyph bitmap. */ 968 979 /* */ … … 1011 1022 /* */ 1012 1023 /* <Return> */ 1013 /* FreeType error code. 0 1024 /* FreeType error code. 0~means success. */ 1014 1025 /* */ 1015 1026 /* <Note> */ … … 1019 1030 /* treat them as persistent data. */ 1020 1031 /* */ 1021 /* The descriptor's `buffer' field is set to 1032 /* The descriptor's `buffer' field is set to~0 to indicate a missing */ 1022 1033 /* glyph bitmap. */ 1023 1034 /* */
Note: See TracChangeset
for help on using the changeset viewer.
