OLD | NEW |
1 /***************************************************************************/ | 1 /***************************************************************************/ |
2 /* */ | 2 /* */ |
3 /* t1tables.h */ | 3 /* t1tables.h */ |
4 /* */ | 4 /* */ |
5 /* Basic Type 1/Type 2 tables definitions and interface (specification */ | 5 /* Basic Type 1/Type 2 tables definitions and interface (specification */ |
6 /* only). */ | 6 /* only). */ |
7 /* */ | 7 /* */ |
8 /* Copyright 1996-2001, 2002, 2003, 2004, 2006, 2008, 2009 by */ | 8 /* Copyright 1996-2004, 2006, 2008, 2009, 2011 by */ |
9 /* David Turner, Robert Wilhelm, and Werner Lemberg. */ | 9 /* David Turner, Robert Wilhelm, and Werner Lemberg. */ |
10 /* */ | 10 /* */ |
11 /* This file is part of the FreeType project, and may only be used, */ | 11 /* This file is part of the FreeType project, and may only be used, */ |
12 /* modified, and distributed under the terms of the FreeType project */ | 12 /* modified, and distributed under the terms of the FreeType project */ |
13 /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ | 13 /* license, LICENSE.TXT. By continuing to use, modify, or distribute */ |
14 /* this file you indicate that you have read the license and */ | 14 /* this file you indicate that you have read the license and */ |
15 /* understand and accept it fully. */ | 15 /* understand and accept it fully. */ |
16 /* */ | 16 /* */ |
17 /***************************************************************************/ | 17 /***************************************************************************/ |
18 | 18 |
(...skipping 467 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
486 * the face and don't need to be freed by the caller. | 486 * the face and don't need to be freed by the caller. |
487 * | 487 * |
488 * If the font's format is not PostScript-based, this function returns | 488 * If the font's format is not PostScript-based, this function returns |
489 * the `FT_Err_Invalid_Argument' error code. | 489 * the `FT_Err_Invalid_Argument' error code. |
490 * | 490 * |
491 */ | 491 */ |
492 FT_EXPORT( FT_Error ) | 492 FT_EXPORT( FT_Error ) |
493 FT_Get_PS_Font_Private( FT_Face face, | 493 FT_Get_PS_Font_Private( FT_Face face, |
494 PS_Private afont_private ); | 494 PS_Private afont_private ); |
495 | 495 |
| 496 |
| 497 /*************************************************************************/ |
| 498 /* */ |
| 499 /* <Enum> */ |
| 500 /* T1_EncodingType */ |
| 501 /* */ |
| 502 /* <Description> */ |
| 503 /* An enumeration describing the `Encoding' entry in a Type 1 */ |
| 504 /* dictionary. */ |
| 505 /* */ |
| 506 typedef enum T1_EncodingType_ |
| 507 { |
| 508 T1_ENCODING_TYPE_NONE = 0, |
| 509 T1_ENCODING_TYPE_ARRAY, |
| 510 T1_ENCODING_TYPE_STANDARD, |
| 511 T1_ENCODING_TYPE_ISOLATIN1, |
| 512 T1_ENCODING_TYPE_EXPERT |
| 513 |
| 514 } T1_EncodingType; |
| 515 |
| 516 |
| 517 /*************************************************************************/ |
| 518 /* */ |
| 519 /* <Enum> */ |
| 520 /* PS_Dict_Keys */ |
| 521 /* */ |
| 522 /* <Description> */ |
| 523 /* An enumeration used in calls to @FT_Get_PS_Font_Value to identify */ |
| 524 /* the Type~1 dictionary entry to retrieve. */ |
| 525 /* */ |
| 526 typedef enum PS_Dict_Keys_ |
| 527 { |
| 528 /* conventionally in the font dictionary */ |
| 529 PS_DICT_FONT_TYPE, /* FT_Byte */ |
| 530 PS_DICT_FONT_MATRIX, /* FT_Fixed */ |
| 531 PS_DICT_FONT_BBOX, /* FT_Fixed */ |
| 532 PS_DICT_PAINT_TYPE, /* FT_Byte */ |
| 533 PS_DICT_FONT_NAME, /* FT_String* */ |
| 534 PS_DICT_UNIQUE_ID, /* FT_Int */ |
| 535 PS_DICT_NUM_CHAR_STRINGS, /* FT_Int */ |
| 536 PS_DICT_CHAR_STRING_KEY, /* FT_String* */ |
| 537 PS_DICT_CHAR_STRING, /* FT_String* */ |
| 538 PS_DICT_ENCODING_TYPE, /* T1_EncodingType */ |
| 539 PS_DICT_ENCODING_ENTRY, /* FT_String* */ |
| 540 |
| 541 /* conventionally in the font Private dictionary */ |
| 542 PS_DICT_NUM_SUBRS, /* FT_Int */ |
| 543 PS_DICT_SUBR, /* FT_String* */ |
| 544 PS_DICT_STD_HW, /* FT_UShort */ |
| 545 PS_DICT_STD_VW, /* FT_UShort */ |
| 546 PS_DICT_NUM_BLUE_VALUES, /* FT_Byte */ |
| 547 PS_DICT_BLUE_VALUE, /* FT_Short */ |
| 548 PS_DICT_BLUE_FUZZ, /* FT_Int */ |
| 549 PS_DICT_NUM_OTHER_BLUES, /* FT_Byte */ |
| 550 PS_DICT_OTHER_BLUE, /* FT_Short */ |
| 551 PS_DICT_NUM_FAMILY_BLUES, /* FT_Byte */ |
| 552 PS_DICT_FAMILY_BLUE, /* FT_Short */ |
| 553 PS_DICT_NUM_FAMILY_OTHER_BLUES, /* FT_Byte */ |
| 554 PS_DICT_FAMILY_OTHER_BLUE, /* FT_Short */ |
| 555 PS_DICT_BLUE_SCALE, /* FT_Fixed */ |
| 556 PS_DICT_BLUE_SHIFT, /* FT_Int */ |
| 557 PS_DICT_NUM_STEM_SNAP_H, /* FT_Byte */ |
| 558 PS_DICT_STEM_SNAP_H, /* FT_Short */ |
| 559 PS_DICT_NUM_STEM_SNAP_V, /* FT_Byte */ |
| 560 PS_DICT_STEM_SNAP_V, /* FT_Short */ |
| 561 PS_DICT_FORCE_BOLD, /* FT_Bool */ |
| 562 PS_DICT_RND_STEM_UP, /* FT_Bool */ |
| 563 PS_DICT_MIN_FEATURE, /* FT_Short */ |
| 564 PS_DICT_LEN_IV, /* FT_Int */ |
| 565 PS_DICT_PASSWORD, /* FT_Long */ |
| 566 PS_DICT_LANGUAGE_GROUP, /* FT_Long */ |
| 567 |
| 568 /* conventionally in the font FontInfo dictionary */ |
| 569 PS_DICT_VERSION, /* FT_String* */ |
| 570 PS_DICT_NOTICE, /* FT_String* */ |
| 571 PS_DICT_FULL_NAME, /* FT_String* */ |
| 572 PS_DICT_FAMILY_NAME, /* FT_String* */ |
| 573 PS_DICT_WEIGHT, /* FT_String* */ |
| 574 PS_DICT_IS_FIXED_PITCH, /* FT_Bool */ |
| 575 PS_DICT_UNDERLINE_POSITION, /* FT_Short */ |
| 576 PS_DICT_UNDERLINE_THICKNESS, /* FT_UShort */ |
| 577 PS_DICT_FS_TYPE, /* FT_UShort */ |
| 578 PS_DICT_ITALIC_ANGLE, /* FT_Long */ |
| 579 |
| 580 PS_DICT_MAX = PS_DICT_ITALIC_ANGLE |
| 581 |
| 582 } PS_Dict_Keys; |
| 583 |
| 584 |
| 585 /************************************************************************ |
| 586 * |
| 587 * @function: |
| 588 * FT_Get_PS_Font_Value |
| 589 * |
| 590 * @description: |
| 591 * Retrieve the value for the supplied key from a PostScript font. |
| 592 * |
| 593 * @input: |
| 594 * face :: |
| 595 * PostScript face handle. |
| 596 * |
| 597 * key :: |
| 598 * An enumeration value representing the dictionary key to retrieve. |
| 599 * |
| 600 * idx :: |
| 601 * For array values, this specifies the index to be returned. |
| 602 * |
| 603 * value :: |
| 604 * A pointer to memory into which to write the value. |
| 605 * |
| 606 * valen_len :: |
| 607 * The size, in bytes, of the memory supplied for the value. |
| 608 * |
| 609 * @output: |
| 610 * value :: |
| 611 * The value matching the above key, if it exists. |
| 612 * |
| 613 * @return: |
| 614 * The amount of memory (in bytes) required to hold the requested |
| 615 * value (if it exists, -1 otherwise). |
| 616 * |
| 617 * @note: |
| 618 * The values returned are not pointers into the internal structures of |
| 619 * the face, but are `fresh' copies, so that the memory containing them |
| 620 * belongs to the calling application. This also enforces the |
| 621 * `read-only' nature of these values, i.e., this function cannot be |
| 622 * used to manipulate the face. |
| 623 * |
| 624 * `value' is a void pointer because the values returned can be of |
| 625 * various types. |
| 626 * |
| 627 * If either `value' is NULL or `value_len' is too small, just the |
| 628 * required memory size for the requested entry is returned. |
| 629 * |
| 630 * The `idx' parameter is used, not only to retrieve elements of, for |
| 631 * example, the FontMatrix or FontBBox, but also to retrieve name keys |
| 632 * from the CharStrings dictionary, and the charstrings themselves. It |
| 633 * is ignored for atomic values. |
| 634 * |
| 635 * PS_DICT_BLUE_SCALE returns a value that is scaled up by 1000. To |
| 636 * get the value as in the font stream, you need to divide by |
| 637 * 65536000.0 (to remove the FT_Fixed scale, and the x1000 scale). |
| 638 * |
| 639 * IMPORTANT: Only key/value pairs read by the FreeType interpreter can |
| 640 * be retrieved. So, for example, PostScript procedures such as NP, |
| 641 * ND, and RD are not available. Arbitrary keys are, obviously, not be |
| 642 * available either. |
| 643 * |
| 644 * If the font's format is not PostScript-based, this function returns |
| 645 * the `FT_Err_Invalid_Argument' error code. |
| 646 * |
| 647 */ |
| 648 FT_EXPORT( FT_Long ) |
| 649 FT_Get_PS_Font_Value( FT_Face face, |
| 650 PS_Dict_Keys key, |
| 651 FT_UInt idx, |
| 652 void *value, |
| 653 FT_Long value_len ); |
| 654 |
496 /* */ | 655 /* */ |
497 | 656 |
498 | |
499 FT_END_HEADER | 657 FT_END_HEADER |
500 | 658 |
501 #endif /* __T1TABLES_H__ */ | 659 #endif /* __T1TABLES_H__ */ |
502 | 660 |
503 | 661 |
504 /* END */ | 662 /* END */ |
OLD | NEW |