hb-ot-var.h 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  1. /*
  2. * Copyright © 2017 Google, 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_OT_H_IN
  27. #error "Include <hb-ot.h> instead."
  28. #endif
  29. #ifndef HB_OT_VAR_H
  30. #define HB_OT_VAR_H
  31. #include "hb.h"
  32. HB_BEGIN_DECLS
  33. #define HB_OT_TAG_VAR_AXIS_ITALIC HB_TAG('i','t','a','l')
  34. #define HB_OT_TAG_VAR_AXIS_OPTICAL_SIZE HB_TAG('o','p','s','z')
  35. #define HB_OT_TAG_VAR_AXIS_SLANT HB_TAG('s','l','n','t')
  36. #define HB_OT_TAG_VAR_AXIS_WIDTH HB_TAG('w','d','t','h')
  37. #define HB_OT_TAG_VAR_AXIS_WEIGHT HB_TAG('w','g','h','t')
  38. /*
  39. * fvar / avar
  40. */
  41. HB_EXTERN hb_bool_t
  42. hb_ot_var_has_data (hb_face_t *face);
  43. /*
  44. * Variation axes.
  45. */
  46. HB_EXTERN unsigned int
  47. hb_ot_var_get_axis_count (hb_face_t *face);
  48. /**
  49. * hb_ot_var_axis_flags_t:
  50. * @HB_OT_VAR_AXIS_FLAG_HIDDEN: The axis should not be exposed directly in user interfaces.
  51. *
  52. * Since: 2.2.0
  53. */
  54. typedef enum { /*< flags >*/
  55. HB_OT_VAR_AXIS_FLAG_HIDDEN = 0x00000001u,
  56. _HB_OT_VAR_AXIS_FLAG_MAX_VALUE= HB_TAG_MAX_SIGNED /*< skip >*/
  57. } hb_ot_var_axis_flags_t;
  58. /**
  59. * hb_ot_var_axis_info_t:
  60. *
  61. * Since: 2.2.0
  62. */
  63. typedef struct hb_ot_var_axis_info_t
  64. {
  65. unsigned int axis_index;
  66. hb_tag_t tag;
  67. hb_ot_name_id_t name_id;
  68. hb_ot_var_axis_flags_t flags;
  69. float min_value;
  70. float default_value;
  71. float max_value;
  72. /*< private >*/
  73. unsigned int reserved;
  74. } hb_ot_var_axis_info_t;
  75. HB_EXTERN unsigned int
  76. hb_ot_var_get_axis_infos (hb_face_t *face,
  77. unsigned int start_offset,
  78. unsigned int *axes_count /* IN/OUT */,
  79. hb_ot_var_axis_info_t *axes_array /* OUT */);
  80. HB_EXTERN hb_bool_t
  81. hb_ot_var_find_axis_info (hb_face_t *face,
  82. hb_tag_t axis_tag,
  83. hb_ot_var_axis_info_t *axis_info);
  84. /*
  85. * Named instances.
  86. */
  87. HB_EXTERN unsigned int
  88. hb_ot_var_get_named_instance_count (hb_face_t *face);
  89. HB_EXTERN hb_ot_name_id_t
  90. hb_ot_var_named_instance_get_subfamily_name_id (hb_face_t *face,
  91. unsigned int instance_index);
  92. HB_EXTERN hb_ot_name_id_t
  93. hb_ot_var_named_instance_get_postscript_name_id (hb_face_t *face,
  94. unsigned int instance_index);
  95. HB_EXTERN unsigned int
  96. hb_ot_var_named_instance_get_design_coords (hb_face_t *face,
  97. unsigned int instance_index,
  98. unsigned int *coords_length, /* IN/OUT */
  99. float *coords /* OUT */);
  100. /*
  101. * Conversions.
  102. */
  103. HB_EXTERN void
  104. hb_ot_var_normalize_variations (hb_face_t *face,
  105. const hb_variation_t *variations, /* IN */
  106. unsigned int variations_length,
  107. int *coords, /* OUT */
  108. unsigned int coords_length);
  109. HB_EXTERN void
  110. hb_ot_var_normalize_coords (hb_face_t *face,
  111. unsigned int coords_length,
  112. const float *design_coords, /* IN */
  113. int *normalized_coords /* OUT */);
  114. HB_END_DECLS
  115. #endif /* HB_OT_VAR_H */