hb-face.h 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158
  1. /*
  2. * Copyright © 2009 Red Hat, Inc.
  3. *
  4. * This is part of HarfBuzz, a text shaping library.
  5. *
  6. * Permission is hereby granted, without written agreement and without
  7. * license or royalty fees, to use, copy, modify, and distribute this
  8. * software and its documentation for any purpose, provided that the
  9. * above copyright notice and the following two paragraphs appear in
  10. * all copies of this software.
  11. *
  12. * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
  13. * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  14. * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
  15. * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  16. * DAMAGE.
  17. *
  18. * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
  19. * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  20. * FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
  21. * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
  22. * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  23. *
  24. * Red Hat Author(s): Behdad Esfahbod
  25. */
  26. #ifndef HB_H_IN
  27. #error "Include <hb.h> instead."
  28. #endif
  29. #ifndef HB_FACE_H
  30. #define HB_FACE_H
  31. #include "hb-common.h"
  32. #include "hb-blob.h"
  33. #include "hb-set.h"
  34. HB_BEGIN_DECLS
  35. HB_EXTERN unsigned int
  36. hb_face_count (hb_blob_t *blob);
  37. /*
  38. * hb_face_t
  39. */
  40. typedef struct hb_face_t hb_face_t;
  41. HB_EXTERN hb_face_t *
  42. hb_face_create (hb_blob_t *blob,
  43. unsigned int index);
  44. typedef hb_blob_t * (*hb_reference_table_func_t) (hb_face_t *face, hb_tag_t tag, void *user_data);
  45. /* calls destroy() when not needing user_data anymore */
  46. HB_EXTERN hb_face_t *
  47. hb_face_create_for_tables (hb_reference_table_func_t reference_table_func,
  48. void *user_data,
  49. hb_destroy_func_t destroy);
  50. HB_EXTERN hb_face_t *
  51. hb_face_get_empty (void);
  52. HB_EXTERN hb_face_t *
  53. hb_face_reference (hb_face_t *face);
  54. HB_EXTERN void
  55. hb_face_destroy (hb_face_t *face);
  56. HB_EXTERN hb_bool_t
  57. hb_face_set_user_data (hb_face_t *face,
  58. hb_user_data_key_t *key,
  59. void * data,
  60. hb_destroy_func_t destroy,
  61. hb_bool_t replace);
  62. HB_EXTERN void *
  63. hb_face_get_user_data (const hb_face_t *face,
  64. hb_user_data_key_t *key);
  65. HB_EXTERN void
  66. hb_face_make_immutable (hb_face_t *face);
  67. HB_EXTERN hb_bool_t
  68. hb_face_is_immutable (const hb_face_t *face);
  69. HB_EXTERN hb_blob_t *
  70. hb_face_reference_table (const hb_face_t *face,
  71. hb_tag_t tag);
  72. HB_EXTERN hb_blob_t *
  73. hb_face_reference_blob (hb_face_t *face);
  74. HB_EXTERN void
  75. hb_face_set_index (hb_face_t *face,
  76. unsigned int index);
  77. HB_EXTERN unsigned int
  78. hb_face_get_index (const hb_face_t *face);
  79. HB_EXTERN void
  80. hb_face_set_upem (hb_face_t *face,
  81. unsigned int upem);
  82. HB_EXTERN unsigned int
  83. hb_face_get_upem (const hb_face_t *face);
  84. HB_EXTERN void
  85. hb_face_set_glyph_count (hb_face_t *face,
  86. unsigned int glyph_count);
  87. HB_EXTERN unsigned int
  88. hb_face_get_glyph_count (const hb_face_t *face);
  89. HB_EXTERN unsigned int
  90. hb_face_get_table_tags (const hb_face_t *face,
  91. unsigned int start_offset,
  92. unsigned int *table_count, /* IN/OUT */
  93. hb_tag_t *table_tags /* OUT */);
  94. /*
  95. * Character set.
  96. */
  97. HB_EXTERN void
  98. hb_face_collect_unicodes (hb_face_t *face,
  99. hb_set_t *out);
  100. HB_EXTERN void
  101. hb_face_collect_variation_selectors (hb_face_t *face,
  102. hb_set_t *out);
  103. HB_EXTERN void
  104. hb_face_collect_variation_unicodes (hb_face_t *face,
  105. hb_codepoint_t variation_selector,
  106. hb_set_t *out);
  107. /*
  108. * Builder face.
  109. */
  110. HB_EXTERN hb_face_t *
  111. hb_face_builder_create (void);
  112. HB_EXTERN hb_bool_t
  113. hb_face_builder_add_table (hb_face_t *face,
  114. hb_tag_t tag,
  115. hb_blob_t *blob);
  116. HB_END_DECLS
  117. #endif /* HB_FACE_H */