vrshoot

annotate libs/ft2static/freetype/ftoutln.h @ 0:b2f14e535253

find changesets by author, revision, files, or words in the commit message
initial commit
author John Tsiombikas <nuclear@member.fsf.org>
date Sat, 01 Feb 2014 19:58:19 +0200
parents
children
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: */