OLD | NEW |
1 /***************************************************************************/ | 1 /***************************************************************************/ |
2 /* */ | 2 /* */ |
3 /* ftadvanc.h */ | 3 /* ftadvanc.h */ |
4 /* */ | 4 /* */ |
5 /* Quick computation of advance widths (specification only). */ | 5 /* Quick computation of advance widths (specification only). */ |
6 /* */ | 6 /* */ |
7 /* Copyright 2008 by */ | 7 /* Copyright 2008, 2013 by */ |
8 /* David Turner, Robert Wilhelm, and Werner Lemberg. */ | 8 /* David Turner, Robert Wilhelm, and Werner Lemberg. */ |
9 /* */ | 9 /* */ |
10 /* This file is part of the FreeType project, and may only be used, */ | 10 /* This file is part of the FreeType project, and may only be used, */ |
11 /* modified, and distributed under the terms of the FreeType project */ | 11 /* modified, and distributed under the terms of the FreeType project */ |
12 /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ | 12 /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ |
13 /* this file you indicate that you have read the license and */ | 13 /* this file you indicate that you have read the license and */ |
14 /* understand and accept it fully. */ | 14 /* understand and accept it fully. */ |
15 /* */ | 15 /* */ |
16 /***************************************************************************/ | 16 /***************************************************************************/ |
17 | 17 |
(...skipping 57 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
75 #define FT_ADVANCE_FLAG_FAST_ONLY 0x20000000UL | 75 #define FT_ADVANCE_FLAG_FAST_ONLY 0x20000000UL |
76 | 76 |
77 | 77 |
78 /*************************************************************************/ | 78 /*************************************************************************/ |
79 /* */ | 79 /* */ |
80 /* <Function> */ | 80 /* <Function> */ |
81 /* FT_Get_Advance */ | 81 /* FT_Get_Advance */ |
82 /* */ | 82 /* */ |
83 /* <Description> */ | 83 /* <Description> */ |
84 /* Retrieve the advance value of a given glyph outline in an */ | 84 /* Retrieve the advance value of a given glyph outline in an */ |
85 /* @FT_Face. By default, the unhinted advance is returned in font */ | 85 /* @FT_Face. */ |
86 /* units. */ | |
87 /* */ | 86 /* */ |
88 /* <Input> */ | 87 /* <Input> */ |
89 /* face :: The source @FT_Face handle. */ | 88 /* face :: The source @FT_Face handle. */ |
90 /* */ | 89 /* */ |
91 /* gindex :: The glyph index. */ | 90 /* gindex :: The glyph index. */ |
92 /* */ | 91 /* */ |
93 /* load_flags :: A set of bit flags similar to those used when */ | 92 /* load_flags :: A set of bit flags similar to those used when */ |
94 /* calling @FT_Load_Glyph, used to determine what kind */ | 93 /* calling @FT_Load_Glyph, used to determine what kind */ |
95 /* of advances you need. */ | 94 /* of advances you need. */ |
96 /* <Output> */ | 95 /* <Output> */ |
97 /* padvance :: The advance value, in either font units or 16.16 */ | 96 /* padvance :: The advance value. If scaling is performed (based on */ |
98 /* format. */ | 97 /* the value of `load_flags'), the advance value is in */ |
| 98 /* 16.16 format. Otherwise, it is in font units. */ |
99 /* */ | 99 /* */ |
100 /* If @FT_LOAD_VERTICAL_LAYOUT is set, this is the */ | 100 /* If @FT_LOAD_VERTICAL_LAYOUT is set, this is the */ |
101 /* vertical advance corresponding to a vertical layout. */ | 101 /* vertical advance corresponding to a vertical layout. */ |
102 /* Otherwise, it is the horizontal advance in a */ | 102 /* Otherwise, it is the horizontal advance in a */ |
103 /* horizontal layout. */ | 103 /* horizontal layout. */ |
104 /* */ | 104 /* */ |
105 /* <Return> */ | 105 /* <Return> */ |
106 /* FreeType error code. 0 means success. */ | 106 /* FreeType error code. 0 means success. */ |
107 /* */ | 107 /* */ |
108 /* <Note> */ | 108 /* <Note> */ |
(...skipping 11 matching lines...) Expand all Loading... |
120 FT_Fixed *padvance ); | 120 FT_Fixed *padvance ); |
121 | 121 |
122 | 122 |
123 /*************************************************************************/ | 123 /*************************************************************************/ |
124 /* */ | 124 /* */ |
125 /* <Function> */ | 125 /* <Function> */ |
126 /* FT_Get_Advances */ | 126 /* FT_Get_Advances */ |
127 /* */ | 127 /* */ |
128 /* <Description> */ | 128 /* <Description> */ |
129 /* Retrieve the advance values of several glyph outlines in an */ | 129 /* Retrieve the advance values of several glyph outlines in an */ |
130 /* @FT_Face. By default, the unhinted advances are returned in font */ | 130 /* @FT_Face. */ |
131 /* units. */ | |
132 /* */ | 131 /* */ |
133 /* <Input> */ | 132 /* <Input> */ |
134 /* face :: The source @FT_Face handle. */ | 133 /* face :: The source @FT_Face handle. */ |
135 /* */ | 134 /* */ |
136 /* start :: The first glyph index. */ | 135 /* start :: The first glyph index. */ |
137 /* */ | 136 /* */ |
138 /* count :: The number of advance values you want to retrieve. */ | 137 /* count :: The number of advance values you want to retrieve. */ |
139 /* */ | 138 /* */ |
140 /* load_flags :: A set of bit flags similar to those used when */ | 139 /* load_flags :: A set of bit flags similar to those used when */ |
141 /* calling @FT_Load_Glyph. */ | 140 /* calling @FT_Load_Glyph. */ |
142 /* */ | 141 /* */ |
143 /* <Output> */ | 142 /* <Output> */ |
144 /* padvance :: The advances, in either font units or 16.16 format. */ | 143 /* padvance :: The advance values. This array, to be provided by the */ |
145 /* This array must contain at least `count' elements. */ | 144 /* caller, must contain at least `count' elements. */ |
| 145 /* */ |
| 146 /* If scaling is performed (based on the value of */ |
| 147 /* `load_flags'), the advance values are in 16.16 format. */ |
| 148 /* Otherwise, they are in font units. */ |
146 /* */ | 149 /* */ |
147 /* If @FT_LOAD_VERTICAL_LAYOUT is set, these are the */ | 150 /* If @FT_LOAD_VERTICAL_LAYOUT is set, these are the */ |
148 /* vertical advances corresponding to a vertical layout. */ | 151 /* vertical advances corresponding to a vertical layout. */ |
149 /* Otherwise, they are the horizontal advances in a */ | 152 /* Otherwise, they are the horizontal advances in a */ |
150 /* horizontal layout. */ | 153 /* horizontal layout. */ |
151 /* */ | 154 /* */ |
152 /* <Return> */ | 155 /* <Return> */ |
153 /* FreeType error code. 0 means success. */ | 156 /* FreeType error code. 0 means success. */ |
154 /* */ | 157 /* */ |
155 /* <Note> */ | 158 /* <Note> */ |
(...skipping 14 matching lines...) Expand all Loading... |
170 | 173 |
171 /* */ | 174 /* */ |
172 | 175 |
173 | 176 |
174 FT_END_HEADER | 177 FT_END_HEADER |
175 | 178 |
176 #endif /* __FTADVANC_H__ */ | 179 #endif /* __FTADVANC_H__ */ |
177 | 180 |
178 | 181 |
179 /* END */ | 182 /* END */ |
OLD | NEW |