rev |
line source |
nuclear@0
|
1 /***************************************************************************/
|
nuclear@0
|
2 /* */
|
nuclear@0
|
3 /* ftoutln.h */
|
nuclear@0
|
4 /* */
|
nuclear@0
|
5 /* Support for the FT_Outline type used to store glyph shapes of */
|
nuclear@0
|
6 /* most scalable font formats (specification). */
|
nuclear@0
|
7 /* */
|
nuclear@0
|
8 /* Copyright 1996-2001, 2002, 2003, 2005, 2006, 2007, 2008, 2009, 2010 by */
|
nuclear@0
|
9 /* David Turner, Robert Wilhelm, and Werner Lemberg. */
|
nuclear@0
|
10 /* */
|
nuclear@0
|
11 /* This file is part of the FreeType project, and may only be used, */
|
nuclear@0
|
12 /* modified, and distributed under the terms of the FreeType project */
|
nuclear@0
|
13 /* license, LICENSE.TXT. By continuing to use, modify, or distribute */
|
nuclear@0
|
14 /* this file you indicate that you have read the license and */
|
nuclear@0
|
15 /* understand and accept it fully. */
|
nuclear@0
|
16 /* */
|
nuclear@0
|
17 /***************************************************************************/
|
nuclear@0
|
18
|
nuclear@0
|
19
|
nuclear@0
|
20 #ifndef __FTOUTLN_H__
|
nuclear@0
|
21 #define __FTOUTLN_H__
|
nuclear@0
|
22
|
nuclear@0
|
23
|
nuclear@0
|
24 #include <ft2build.h>
|
nuclear@0
|
25 #include FT_FREETYPE_H
|
nuclear@0
|
26
|
nuclear@0
|
27 #ifdef FREETYPE_H
|
nuclear@0
|
28 #error "freetype.h of FreeType 1 has been loaded!"
|
nuclear@0
|
29 #error "Please fix the directory search order for header files"
|
nuclear@0
|
30 #error "so that freetype.h of FreeType 2 is found first."
|
nuclear@0
|
31 #endif
|
nuclear@0
|
32
|
nuclear@0
|
33
|
nuclear@0
|
34 FT_BEGIN_HEADER
|
nuclear@0
|
35
|
nuclear@0
|
36
|
nuclear@0
|
37 /*************************************************************************/
|
nuclear@0
|
38 /* */
|
nuclear@0
|
39 /* <Section> */
|
nuclear@0
|
40 /* outline_processing */
|
nuclear@0
|
41 /* */
|
nuclear@0
|
42 /* <Title> */
|
nuclear@0
|
43 /* Outline Processing */
|
nuclear@0
|
44 /* */
|
nuclear@0
|
45 /* <Abstract> */
|
nuclear@0
|
46 /* Functions to create, transform, and render vectorial glyph images. */
|
nuclear@0
|
47 /* */
|
nuclear@0
|
48 /* <Description> */
|
nuclear@0
|
49 /* This section contains routines used to create and destroy scalable */
|
nuclear@0
|
50 /* glyph images known as `outlines'. These can also be measured, */
|
nuclear@0
|
51 /* transformed, and converted into bitmaps and pixmaps. */
|
nuclear@0
|
52 /* */
|
nuclear@0
|
53 /* <Order> */
|
nuclear@0
|
54 /* FT_Outline */
|
nuclear@0
|
55 /* FT_OUTLINE_FLAGS */
|
nuclear@0
|
56 /* FT_Outline_New */
|
nuclear@0
|
57 /* FT_Outline_Done */
|
nuclear@0
|
58 /* FT_Outline_Copy */
|
nuclear@0
|
59 /* FT_Outline_Translate */
|
nuclear@0
|
60 /* FT_Outline_Transform */
|
nuclear@0
|
61 /* FT_Outline_Embolden */
|
nuclear@0
|
62 /* FT_Outline_Reverse */
|
nuclear@0
|
63 /* FT_Outline_Check */
|
nuclear@0
|
64 /* */
|
nuclear@0
|
65 /* FT_Outline_Get_CBox */
|
nuclear@0
|
66 /* FT_Outline_Get_BBox */
|
nuclear@0
|
67 /* */
|
nuclear@0
|
68 /* FT_Outline_Get_Bitmap */
|
nuclear@0
|
69 /* FT_Outline_Render */
|
nuclear@0
|
70 /* */
|
nuclear@0
|
71 /* FT_Outline_Decompose */
|
nuclear@0
|
72 /* FT_Outline_Funcs */
|
nuclear@0
|
73 /* FT_Outline_MoveTo_Func */
|
nuclear@0
|
74 /* FT_Outline_LineTo_Func */
|
nuclear@0
|
75 /* FT_Outline_ConicTo_Func */
|
nuclear@0
|
76 /* FT_Outline_CubicTo_Func */
|
nuclear@0
|
77 /* */
|
nuclear@0
|
78 /*************************************************************************/
|
nuclear@0
|
79
|
nuclear@0
|
80
|
nuclear@0
|
81 /*************************************************************************/
|
nuclear@0
|
82 /* */
|
nuclear@0
|
83 /* <Function> */
|
nuclear@0
|
84 /* FT_Outline_Decompose */
|
nuclear@0
|
85 /* */
|
nuclear@0
|
86 /* <Description> */
|
nuclear@0
|
87 /* Walk over an outline's structure to decompose it into individual */
|
nuclear@0
|
88 /* segments and Bézier arcs. This function also emits `move to' */
|
nuclear@0
|
89 /* operations to indicate the start of new contours in the outline. */
|
nuclear@0
|
90 /* */
|
nuclear@0
|
91 /* <Input> */
|
nuclear@0
|
92 /* outline :: A pointer to the source target. */
|
nuclear@0
|
93 /* */
|
nuclear@0
|
94 /* func_interface :: A table of `emitters', i.e., function pointers */
|
nuclear@0
|
95 /* called during decomposition to indicate path */
|
nuclear@0
|
96 /* operations. */
|
nuclear@0
|
97 /* */
|
nuclear@0
|
98 /* <InOut> */
|
nuclear@0
|
99 /* user :: A typeless pointer which is passed to each */
|
nuclear@0
|
100 /* emitter during the decomposition. It can be */
|
nuclear@0
|
101 /* used to store the state during the */
|
nuclear@0
|
102 /* decomposition. */
|
nuclear@0
|
103 /* */
|
nuclear@0
|
104 /* <Return> */
|
nuclear@0
|
105 /* FreeType error code. 0~means success. */
|
nuclear@0
|
106 /* */
|
nuclear@0
|
107 FT_EXPORT( FT_Error )
|
nuclear@0
|
108 FT_Outline_Decompose( FT_Outline* outline,
|
nuclear@0
|
109 const FT_Outline_Funcs* func_interface,
|
nuclear@0
|
110 void* user );
|
nuclear@0
|
111
|
nuclear@0
|
112
|
nuclear@0
|
113 /*************************************************************************/
|
nuclear@0
|
114 /* */
|
nuclear@0
|
115 /* <Function> */
|
nuclear@0
|
116 /* FT_Outline_New */
|
nuclear@0
|
117 /* */
|
nuclear@0
|
118 /* <Description> */
|
nuclear@0
|
119 /* Create a new outline of a given size. */
|
nuclear@0
|
120 /* */
|
nuclear@0
|
121 /* <Input> */
|
nuclear@0
|
122 /* library :: A handle to the library object from where the */
|
nuclear@0
|
123 /* outline is allocated. Note however that the new */
|
nuclear@0
|
124 /* outline will *not* necessarily be *freed*, when */
|
nuclear@0
|
125 /* destroying the library, by @FT_Done_FreeType. */
|
nuclear@0
|
126 /* */
|
nuclear@0
|
127 /* numPoints :: The maximal number of points within the outline. */
|
nuclear@0
|
128 /* */
|
nuclear@0
|
129 /* numContours :: The maximal number of contours within the outline. */
|
nuclear@0
|
130 /* */
|
nuclear@0
|
131 /* <Output> */
|
nuclear@0
|
132 /* anoutline :: A handle to the new outline. */
|
nuclear@0
|
133 /* */
|
nuclear@0
|
134 /* <Return> */
|
nuclear@0
|
135 /* FreeType error code. 0~means success. */
|
nuclear@0
|
136 /* */
|
nuclear@0
|
137 /* <Note> */
|
nuclear@0
|
138 /* The reason why this function takes a `library' parameter is simply */
|
nuclear@0
|
139 /* to use the library's memory allocator. */
|
nuclear@0
|
140 /* */
|
nuclear@0
|
141 FT_EXPORT( FT_Error )
|
nuclear@0
|
142 FT_Outline_New( FT_Library library,
|
nuclear@0
|
143 FT_UInt numPoints,
|
nuclear@0
|
144 FT_Int numContours,
|
nuclear@0
|
145 FT_Outline *anoutline );
|
nuclear@0
|
146
|
nuclear@0
|
147
|
nuclear@0
|
148 FT_EXPORT( FT_Error )
|
nuclear@0
|
149 FT_Outline_New_Internal( FT_Memory memory,
|
nuclear@0
|
150 FT_UInt numPoints,
|
nuclear@0
|
151 FT_Int numContours,
|
nuclear@0
|
152 FT_Outline *anoutline );
|
nuclear@0
|
153
|
nuclear@0
|
154
|
nuclear@0
|
155 /*************************************************************************/
|
nuclear@0
|
156 /* */
|
nuclear@0
|
157 /* <Function> */
|
nuclear@0
|
158 /* FT_Outline_Done */
|
nuclear@0
|
159 /* */
|
nuclear@0
|
160 /* <Description> */
|
nuclear@0
|
161 /* Destroy an outline created with @FT_Outline_New. */
|
nuclear@0
|
162 /* */
|
nuclear@0
|
163 /* <Input> */
|
nuclear@0
|
164 /* library :: A handle of the library object used to allocate the */
|
nuclear@0
|
165 /* outline. */
|
nuclear@0
|
166 /* */
|
nuclear@0
|
167 /* outline :: A pointer to the outline object to be discarded. */
|
nuclear@0
|
168 /* */
|
nuclear@0
|
169 /* <Return> */
|
nuclear@0
|
170 /* FreeType error code. 0~means success. */
|
nuclear@0
|
171 /* */
|
nuclear@0
|
172 /* <Note> */
|
nuclear@0
|
173 /* If the outline's `owner' field is not set, only the outline */
|
nuclear@0
|
174 /* descriptor will be released. */
|
nuclear@0
|
175 /* */
|
nuclear@0
|
176 /* The reason why this function takes an `library' parameter is */
|
nuclear@0
|
177 /* simply to use ft_mem_free(). */
|
nuclear@0
|
178 /* */
|
nuclear@0
|
179 FT_EXPORT( FT_Error )
|
nuclear@0
|
180 FT_Outline_Done( FT_Library library,
|
nuclear@0
|
181 FT_Outline* outline );
|
nuclear@0
|
182
|
nuclear@0
|
183
|
nuclear@0
|
184 FT_EXPORT( FT_Error )
|
nuclear@0
|
185 FT_Outline_Done_Internal( FT_Memory memory,
|
nuclear@0
|
186 FT_Outline* outline );
|
nuclear@0
|
187
|
nuclear@0
|
188
|
nuclear@0
|
189 /*************************************************************************/
|
nuclear@0
|
190 /* */
|
nuclear@0
|
191 /* <Function> */
|
nuclear@0
|
192 /* FT_Outline_Check */
|
nuclear@0
|
193 /* */
|
nuclear@0
|
194 /* <Description> */
|
nuclear@0
|
195 /* Check the contents of an outline descriptor. */
|
nuclear@0
|
196 /* */
|
nuclear@0
|
197 /* <Input> */
|
nuclear@0
|
198 /* outline :: A handle to a source outline. */
|
nuclear@0
|
199 /* */
|
nuclear@0
|
200 /* <Return> */
|
nuclear@0
|
201 /* FreeType error code. 0~means success. */
|
nuclear@0
|
202 /* */
|
nuclear@0
|
203 FT_EXPORT( FT_Error )
|
nuclear@0
|
204 FT_Outline_Check( FT_Outline* outline );
|
nuclear@0
|
205
|
nuclear@0
|
206
|
nuclear@0
|
207 /*************************************************************************/
|
nuclear@0
|
208 /* */
|
nuclear@0
|
209 /* <Function> */
|
nuclear@0
|
210 /* FT_Outline_Get_CBox */
|
nuclear@0
|
211 /* */
|
nuclear@0
|
212 /* <Description> */
|
nuclear@0
|
213 /* Return an outline's `control box'. The control box encloses all */
|
nuclear@0
|
214 /* the outline's points, including Bézier control points. Though it */
|
nuclear@0
|
215 /* coincides with the exact bounding box for most glyphs, it can be */
|
nuclear@0
|
216 /* slightly larger in some situations (like when rotating an outline */
|
nuclear@0
|
217 /* which contains Bézier outside arcs). */
|
nuclear@0
|
218 /* */
|
nuclear@0
|
219 /* Computing the control box is very fast, while getting the bounding */
|
nuclear@0
|
220 /* box can take much more time as it needs to walk over all segments */
|
nuclear@0
|
221 /* and arcs in the outline. To get the latter, you can use the */
|
nuclear@0
|
222 /* `ftbbox' component which is dedicated to this single task. */
|
nuclear@0
|
223 /* */
|
nuclear@0
|
224 /* <Input> */
|
nuclear@0
|
225 /* outline :: A pointer to the source outline descriptor. */
|
nuclear@0
|
226 /* */
|
nuclear@0
|
227 /* <Output> */
|
nuclear@0
|
228 /* acbox :: The outline's control box. */
|
nuclear@0
|
229 /* */
|
nuclear@0
|
230 FT_EXPORT( void )
|
nuclear@0
|
231 FT_Outline_Get_CBox( const FT_Outline* outline,
|
nuclear@0
|
232 FT_BBox *acbox );
|
nuclear@0
|
233
|
nuclear@0
|
234
|
nuclear@0
|
235 /*************************************************************************/
|
nuclear@0
|
236 /* */
|
nuclear@0
|
237 /* <Function> */
|
nuclear@0
|
238 /* FT_Outline_Translate */
|
nuclear@0
|
239 /* */
|
nuclear@0
|
240 /* <Description> */
|
nuclear@0
|
241 /* Apply a simple translation to the points of an outline. */
|
nuclear@0
|
242 /* */
|
nuclear@0
|
243 /* <InOut> */
|
nuclear@0
|
244 /* outline :: A pointer to the target outline descriptor. */
|
nuclear@0
|
245 /* */
|
nuclear@0
|
246 /* <Input> */
|
nuclear@0
|
247 /* xOffset :: The horizontal offset. */
|
nuclear@0
|
248 /* */
|
nuclear@0
|
249 /* yOffset :: The vertical offset. */
|
nuclear@0
|
250 /* */
|
nuclear@0
|
251 FT_EXPORT( void )
|
nuclear@0
|
252 FT_Outline_Translate( const FT_Outline* outline,
|
nuclear@0
|
253 FT_Pos xOffset,
|
nuclear@0
|
254 FT_Pos yOffset );
|
nuclear@0
|
255
|
nuclear@0
|
256
|
nuclear@0
|
257 /*************************************************************************/
|
nuclear@0
|
258 /* */
|
nuclear@0
|
259 /* <Function> */
|
nuclear@0
|
260 /* FT_Outline_Copy */
|
nuclear@0
|
261 /* */
|
nuclear@0
|
262 /* <Description> */
|
nuclear@0
|
263 /* Copy an outline into another one. Both objects must have the */
|
nuclear@0
|
264 /* same sizes (number of points & number of contours) when this */
|
nuclear@0
|
265 /* function is called. */
|
nuclear@0
|
266 /* */
|
nuclear@0
|
267 /* <Input> */
|
nuclear@0
|
268 /* source :: A handle to the source outline. */
|
nuclear@0
|
269 /* */
|
nuclear@0
|
270 /* <Output> */
|
nuclear@0
|
271 /* target :: A handle to the target outline. */
|
nuclear@0
|
272 /* */
|
nuclear@0
|
273 /* <Return> */
|
nuclear@0
|
274 /* FreeType error code. 0~means success. */
|
nuclear@0
|
275 /* */
|
nuclear@0
|
276 FT_EXPORT( FT_Error )
|
nuclear@0
|
277 FT_Outline_Copy( const FT_Outline* source,
|
nuclear@0
|
278 FT_Outline *target );
|
nuclear@0
|
279
|
nuclear@0
|
280
|
nuclear@0
|
281 /*************************************************************************/
|
nuclear@0
|
282 /* */
|
nuclear@0
|
283 /* <Function> */
|
nuclear@0
|
284 /* FT_Outline_Transform */
|
nuclear@0
|
285 /* */
|
nuclear@0
|
286 /* <Description> */
|
nuclear@0
|
287 /* Apply a simple 2x2 matrix to all of an outline's points. Useful */
|
nuclear@0
|
288 /* for applying rotations, slanting, flipping, etc. */
|
nuclear@0
|
289 /* */
|
nuclear@0
|
290 /* <InOut> */
|
nuclear@0
|
291 /* outline :: A pointer to the target outline descriptor. */
|
nuclear@0
|
292 /* */
|
nuclear@0
|
293 /* <Input> */
|
nuclear@0
|
294 /* matrix :: A pointer to the transformation matrix. */
|
nuclear@0
|
295 /* */
|
nuclear@0
|
296 /* <Note> */
|
nuclear@0
|
297 /* You can use @FT_Outline_Translate if you need to translate the */
|
nuclear@0
|
298 /* outline's points. */
|
nuclear@0
|
299 /* */
|
nuclear@0
|
300 FT_EXPORT( void )
|
nuclear@0
|
301 FT_Outline_Transform( const FT_Outline* outline,
|
nuclear@0
|
302 const FT_Matrix* matrix );
|
nuclear@0
|
303
|
nuclear@0
|
304
|
nuclear@0
|
305 /*************************************************************************/
|
nuclear@0
|
306 /* */
|
nuclear@0
|
307 /* <Function> */
|
nuclear@0
|
308 /* FT_Outline_Embolden */
|
nuclear@0
|
309 /* */
|
nuclear@0
|
310 /* <Description> */
|
nuclear@0
|
311 /* Embolden an outline. The new outline will be at most 4~times */
|
nuclear@0
|
312 /* `strength' pixels wider and higher. You may think of the left and */
|
nuclear@0
|
313 /* bottom borders as unchanged. */
|
nuclear@0
|
314 /* */
|
nuclear@0
|
315 /* Negative `strength' values to reduce the outline thickness are */
|
nuclear@0
|
316 /* possible also. */
|
nuclear@0
|
317 /* */
|
nuclear@0
|
318 /* <InOut> */
|
nuclear@0
|
319 /* outline :: A handle to the target outline. */
|
nuclear@0
|
320 /* */
|
nuclear@0
|
321 /* <Input> */
|
nuclear@0
|
322 /* strength :: How strong the glyph is emboldened. Expressed in */
|
nuclear@0
|
323 /* 26.6 pixel format. */
|
nuclear@0
|
324 /* */
|
nuclear@0
|
325 /* <Return> */
|
nuclear@0
|
326 /* FreeType error code. 0~means success. */
|
nuclear@0
|
327 /* */
|
nuclear@0
|
328 /* <Note> */
|
nuclear@0
|
329 /* The used algorithm to increase or decrease the thickness of the */
|
nuclear@0
|
330 /* glyph doesn't change the number of points; this means that certain */
|
nuclear@0
|
331 /* situations like acute angles or intersections are sometimes */
|
nuclear@0
|
332 /* handled incorrectly. */
|
nuclear@0
|
333 /* */
|
nuclear@0
|
334 /* If you need `better' metrics values you should call */
|
nuclear@0
|
335 /* @FT_Outline_Get_CBox ot @FT_Outline_Get_BBox. */
|
nuclear@0
|
336 /* */
|
nuclear@0
|
337 /* Example call: */
|
nuclear@0
|
338 /* */
|
nuclear@0
|
339 /* { */
|
nuclear@0
|
340 /* FT_Load_Glyph( face, index, FT_LOAD_DEFAULT ); */
|
nuclear@0
|
341 /* if ( face->slot->format == FT_GLYPH_FORMAT_OUTLINE ) */
|
nuclear@0
|
342 /* FT_Outline_Embolden( &face->slot->outline, strength ); */
|
nuclear@0
|
343 /* } */
|
nuclear@0
|
344 /* */
|
nuclear@0
|
345 FT_EXPORT( FT_Error )
|
nuclear@0
|
346 FT_Outline_Embolden( FT_Outline* outline,
|
nuclear@0
|
347 FT_Pos strength );
|
nuclear@0
|
348
|
nuclear@0
|
349
|
nuclear@0
|
350 /*************************************************************************/
|
nuclear@0
|
351 /* */
|
nuclear@0
|
352 /* <Function> */
|
nuclear@0
|
353 /* FT_Outline_Reverse */
|
nuclear@0
|
354 /* */
|
nuclear@0
|
355 /* <Description> */
|
nuclear@0
|
356 /* Reverse the drawing direction of an outline. This is used to */
|
nuclear@0
|
357 /* ensure consistent fill conventions for mirrored glyphs. */
|
nuclear@0
|
358 /* */
|
nuclear@0
|
359 /* <InOut> */
|
nuclear@0
|
360 /* outline :: A pointer to the target outline descriptor. */
|
nuclear@0
|
361 /* */
|
nuclear@0
|
362 /* <Note> */
|
nuclear@0
|
363 /* This function toggles the bit flag @FT_OUTLINE_REVERSE_FILL in */
|
nuclear@0
|
364 /* the outline's `flags' field. */
|
nuclear@0
|
365 /* */
|
nuclear@0
|
366 /* It shouldn't be used by a normal client application, unless it */
|
nuclear@0
|
367 /* knows what it is doing. */
|
nuclear@0
|
368 /* */
|
nuclear@0
|
369 FT_EXPORT( void )
|
nuclear@0
|
370 FT_Outline_Reverse( FT_Outline* outline );
|
nuclear@0
|
371
|
nuclear@0
|
372
|
nuclear@0
|
373 /*************************************************************************/
|
nuclear@0
|
374 /* */
|
nuclear@0
|
375 /* <Function> */
|
nuclear@0
|
376 /* FT_Outline_Get_Bitmap */
|
nuclear@0
|
377 /* */
|
nuclear@0
|
378 /* <Description> */
|
nuclear@0
|
379 /* Render an outline within a bitmap. The outline's image is simply */
|
nuclear@0
|
380 /* OR-ed to the target bitmap. */
|
nuclear@0
|
381 /* */
|
nuclear@0
|
382 /* <Input> */
|
nuclear@0
|
383 /* library :: A handle to a FreeType library object. */
|
nuclear@0
|
384 /* */
|
nuclear@0
|
385 /* outline :: A pointer to the source outline descriptor. */
|
nuclear@0
|
386 /* */
|
nuclear@0
|
387 /* <InOut> */
|
nuclear@0
|
388 /* abitmap :: A pointer to the target bitmap descriptor. */
|
nuclear@0
|
389 /* */
|
nuclear@0
|
390 /* <Return> */
|
nuclear@0
|
391 /* FreeType error code. 0~means success. */
|
nuclear@0
|
392 /* */
|
nuclear@0
|
393 /* <Note> */
|
nuclear@0
|
394 /* This function does NOT CREATE the bitmap, it only renders an */
|
nuclear@0
|
395 /* outline image within the one you pass to it! Consequently, the */
|
nuclear@0
|
396 /* various fields in `abitmap' should be set accordingly. */
|
nuclear@0
|
397 /* */
|
nuclear@0
|
398 /* It will use the raster corresponding to the default glyph format. */
|
nuclear@0
|
399 /* */
|
nuclear@0
|
400 /* The value of the `num_grays' field in `abitmap' is ignored. If */
|
nuclear@0
|
401 /* you select the gray-level rasterizer, and you want less than 256 */
|
nuclear@0
|
402 /* gray levels, you have to use @FT_Outline_Render directly. */
|
nuclear@0
|
403 /* */
|
nuclear@0
|
404 FT_EXPORT( FT_Error )
|
nuclear@0
|
405 FT_Outline_Get_Bitmap( FT_Library library,
|
nuclear@0
|
406 FT_Outline* outline,
|
nuclear@0
|
407 const FT_Bitmap *abitmap );
|
nuclear@0
|
408
|
nuclear@0
|
409
|
nuclear@0
|
410 /*************************************************************************/
|
nuclear@0
|
411 /* */
|
nuclear@0
|
412 /* <Function> */
|
nuclear@0
|
413 /* FT_Outline_Render */
|
nuclear@0
|
414 /* */
|
nuclear@0
|
415 /* <Description> */
|
nuclear@0
|
416 /* Render an outline within a bitmap using the current scan-convert. */
|
nuclear@0
|
417 /* This function uses an @FT_Raster_Params structure as an argument, */
|
nuclear@0
|
418 /* allowing advanced features like direct composition, translucency, */
|
nuclear@0
|
419 /* etc. */
|
nuclear@0
|
420 /* */
|
nuclear@0
|
421 /* <Input> */
|
nuclear@0
|
422 /* library :: A handle to a FreeType library object. */
|
nuclear@0
|
423 /* */
|
nuclear@0
|
424 /* outline :: A pointer to the source outline descriptor. */
|
nuclear@0
|
425 /* */
|
nuclear@0
|
426 /* <InOut> */
|
nuclear@0
|
427 /* params :: A pointer to an @FT_Raster_Params structure used to */
|
nuclear@0
|
428 /* describe the rendering operation. */
|
nuclear@0
|
429 /* */
|
nuclear@0
|
430 /* <Return> */
|
nuclear@0
|
431 /* FreeType error code. 0~means success. */
|
nuclear@0
|
432 /* */
|
nuclear@0
|
433 /* <Note> */
|
nuclear@0
|
434 /* You should know what you are doing and how @FT_Raster_Params works */
|
nuclear@0
|
435 /* to use this function. */
|
nuclear@0
|
436 /* */
|
nuclear@0
|
437 /* The field `params.source' will be set to `outline' before the scan */
|
nuclear@0
|
438 /* converter is called, which means that the value you give to it is */
|
nuclear@0
|
439 /* actually ignored. */
|
nuclear@0
|
440 /* */
|
nuclear@0
|
441 /* The gray-level rasterizer always uses 256 gray levels. If you */
|
nuclear@0
|
442 /* want less gray levels, you have to provide your own span callback. */
|
nuclear@0
|
443 /* See the @FT_RASTER_FLAG_DIRECT value of the `flags' field in the */
|
nuclear@0
|
444 /* @FT_Raster_Params structure for more details. */
|
nuclear@0
|
445 /* */
|
nuclear@0
|
446 FT_EXPORT( FT_Error )
|
nuclear@0
|
447 FT_Outline_Render( FT_Library library,
|
nuclear@0
|
448 FT_Outline* outline,
|
nuclear@0
|
449 FT_Raster_Params* params );
|
nuclear@0
|
450
|
nuclear@0
|
451
|
nuclear@0
|
452 /**************************************************************************
|
nuclear@0
|
453 *
|
nuclear@0
|
454 * @enum:
|
nuclear@0
|
455 * FT_Orientation
|
nuclear@0
|
456 *
|
nuclear@0
|
457 * @description:
|
nuclear@0
|
458 * A list of values used to describe an outline's contour orientation.
|
nuclear@0
|
459 *
|
nuclear@0
|
460 * The TrueType and PostScript specifications use different conventions
|
nuclear@0
|
461 * to determine whether outline contours should be filled or unfilled.
|
nuclear@0
|
462 *
|
nuclear@0
|
463 * @values:
|
nuclear@0
|
464 * FT_ORIENTATION_TRUETYPE ::
|
nuclear@0
|
465 * According to the TrueType specification, clockwise contours must
|
nuclear@0
|
466 * be filled, and counter-clockwise ones must be unfilled.
|
nuclear@0
|
467 *
|
nuclear@0
|
468 * FT_ORIENTATION_POSTSCRIPT ::
|
nuclear@0
|
469 * According to the PostScript specification, counter-clockwise contours
|
nuclear@0
|
470 * must be filled, and clockwise ones must be unfilled.
|
nuclear@0
|
471 *
|
nuclear@0
|
472 * FT_ORIENTATION_FILL_RIGHT ::
|
nuclear@0
|
473 * This is identical to @FT_ORIENTATION_TRUETYPE, but is used to
|
nuclear@0
|
474 * remember that in TrueType, everything that is to the right of
|
nuclear@0
|
475 * the drawing direction of a contour must be filled.
|
nuclear@0
|
476 *
|
nuclear@0
|
477 * FT_ORIENTATION_FILL_LEFT ::
|
nuclear@0
|
478 * This is identical to @FT_ORIENTATION_POSTSCRIPT, but is used to
|
nuclear@0
|
479 * remember that in PostScript, everything that is to the left of
|
nuclear@0
|
480 * the drawing direction of a contour must be filled.
|
nuclear@0
|
481 *
|
nuclear@0
|
482 * FT_ORIENTATION_NONE ::
|
nuclear@0
|
483 * The orientation cannot be determined. That is, different parts of
|
nuclear@0
|
484 * the glyph have different orientation.
|
nuclear@0
|
485 *
|
nuclear@0
|
486 */
|
nuclear@0
|
487 typedef enum FT_Orientation_
|
nuclear@0
|
488 {
|
nuclear@0
|
489 FT_ORIENTATION_TRUETYPE = 0,
|
nuclear@0
|
490 FT_ORIENTATION_POSTSCRIPT = 1,
|
nuclear@0
|
491 FT_ORIENTATION_FILL_RIGHT = FT_ORIENTATION_TRUETYPE,
|
nuclear@0
|
492 FT_ORIENTATION_FILL_LEFT = FT_ORIENTATION_POSTSCRIPT,
|
nuclear@0
|
493 FT_ORIENTATION_NONE
|
nuclear@0
|
494
|
nuclear@0
|
495 } FT_Orientation;
|
nuclear@0
|
496
|
nuclear@0
|
497
|
nuclear@0
|
498 /**************************************************************************
|
nuclear@0
|
499 *
|
nuclear@0
|
500 * @function:
|
nuclear@0
|
501 * FT_Outline_Get_Orientation
|
nuclear@0
|
502 *
|
nuclear@0
|
503 * @description:
|
nuclear@0
|
504 * This function analyzes a glyph outline and tries to compute its
|
nuclear@0
|
505 * fill orientation (see @FT_Orientation). This is done by computing
|
nuclear@0
|
506 * the direction of each global horizontal and/or vertical extrema
|
nuclear@0
|
507 * within the outline.
|
nuclear@0
|
508 *
|
nuclear@0
|
509 * Note that this will return @FT_ORIENTATION_TRUETYPE for empty
|
nuclear@0
|
510 * outlines.
|
nuclear@0
|
511 *
|
nuclear@0
|
512 * @input:
|
nuclear@0
|
513 * outline ::
|
nuclear@0
|
514 * A handle to the source outline.
|
nuclear@0
|
515 *
|
nuclear@0
|
516 * @return:
|
nuclear@0
|
517 * The orientation.
|
nuclear@0
|
518 *
|
nuclear@0
|
519 */
|
nuclear@0
|
520 FT_EXPORT( FT_Orientation )
|
nuclear@0
|
521 FT_Outline_Get_Orientation( FT_Outline* outline );
|
nuclear@0
|
522
|
nuclear@0
|
523
|
nuclear@0
|
524 /* */
|
nuclear@0
|
525
|
nuclear@0
|
526
|
nuclear@0
|
527 FT_END_HEADER
|
nuclear@0
|
528
|
nuclear@0
|
529 #endif /* __FTOUTLN_H__ */
|
nuclear@0
|
530
|
nuclear@0
|
531
|
nuclear@0
|
532 /* END */
|
nuclear@0
|
533
|
nuclear@0
|
534
|
nuclear@0
|
535 /* Local Variables: */
|
nuclear@0
|
536 /* coding: utf-8 */
|
nuclear@0
|
537 /* End: */
|