hb-ot-deprecated.h 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147
  1. /*
  2. * Copyright © 2018 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. * Google Author(s): Behdad Esfahbod
  25. */
  26. #if !defined(HB_OT_H_IN) && !defined(HB_NO_SINGLE_HEADER_ERROR)
  27. #error "Include <hb-ot.h> instead."
  28. #endif
  29. #ifndef HB_OT_DEPRECATED_H
  30. #define HB_OT_DEPRECATED_H
  31. #include "hb.h"
  32. #include "hb-ot-name.h"
  33. HB_BEGIN_DECLS
  34. #ifndef HB_DISABLE_DEPRECATED
  35. /* https://github.com/harfbuzz/harfbuzz/issues/1734 */
  36. /**
  37. * HB_MATH_GLYPH_PART_FLAG_EXTENDER:
  38. *
  39. * Use #HB_OT_MATH_GLYPH_PART_FLAG_EXTENDER instead.
  40. *
  41. * Deprecated: 2.5.1
  42. */
  43. #define HB_MATH_GLYPH_PART_FLAG_EXTENDER HB_OT_MATH_GLYPH_PART_FLAG_EXTENDER
  44. /* https://github.com/harfbuzz/harfbuzz/pull/3417 */
  45. /**
  46. * HB_OT_MATH_SCRIPT:
  47. *
  48. * Use #HB_SCRIPT_MATH or #HB_OT_TAG_MATH_SCRIPT instead.
  49. *
  50. * <note>Previous versions of this documentation recommended passing
  51. * #HB_OT_MATH_SCRIPT to hb_buffer_set_script() to enable math shaping, but this
  52. * usage is no longer supported. Use #HB_SCRIPT_MATH instead.</note>
  53. *
  54. * Since: 1.3.3
  55. * Deprecated: 3.4.0
  56. */
  57. #define HB_OT_MATH_SCRIPT HB_OT_TAG_MATH_SCRIPT
  58. /* Like hb_ot_layout_table_find_script, but takes zero-terminated array of scripts to test */
  59. HB_DEPRECATED_FOR (hb_ot_layout_table_select_script)
  60. HB_EXTERN hb_bool_t
  61. hb_ot_layout_table_choose_script (hb_face_t *face,
  62. hb_tag_t table_tag,
  63. const hb_tag_t *script_tags,
  64. unsigned int *script_index,
  65. hb_tag_t *chosen_script);
  66. HB_DEPRECATED_FOR (hb_ot_layout_script_select_language)
  67. HB_EXTERN hb_bool_t
  68. hb_ot_layout_script_find_language (hb_face_t *face,
  69. hb_tag_t table_tag,
  70. unsigned int script_index,
  71. hb_tag_t language_tag,
  72. unsigned int *language_index);
  73. HB_DEPRECATED_FOR (hb_ot_tags_from_script_and_language)
  74. HB_EXTERN void
  75. hb_ot_tags_from_script (hb_script_t script,
  76. hb_tag_t *script_tag_1,
  77. hb_tag_t *script_tag_2);
  78. HB_DEPRECATED_FOR (hb_ot_tags_from_script_and_language)
  79. HB_EXTERN hb_tag_t
  80. hb_ot_tag_from_language (hb_language_t language);
  81. /**
  82. * HB_OT_VAR_NO_AXIS_INDEX:
  83. *
  84. * Do not use.
  85. *
  86. * Since: 1.4.2
  87. * Deprecated: 2.2.0
  88. */
  89. #define HB_OT_VAR_NO_AXIS_INDEX 0xFFFFFFFFu
  90. /**
  91. * hb_ot_var_axis_t:
  92. * @tag: axis tag
  93. * @name_id: axis name identifier
  94. * @min_value: minimum value of the axis
  95. * @default_value: default value of the axis
  96. * @max_value: maximum value of the axis
  97. *
  98. * Use #hb_ot_var_axis_info_t instead.
  99. *
  100. * Since: 1.4.2
  101. * Deprecated: 2.2.0
  102. */
  103. typedef struct hb_ot_var_axis_t {
  104. hb_tag_t tag;
  105. hb_ot_name_id_t name_id;
  106. float min_value;
  107. float default_value;
  108. float max_value;
  109. } hb_ot_var_axis_t;
  110. HB_DEPRECATED_FOR (hb_ot_var_get_axis_infos)
  111. HB_EXTERN unsigned int
  112. hb_ot_var_get_axes (hb_face_t *face,
  113. unsigned int start_offset,
  114. unsigned int *axes_count /* IN/OUT */,
  115. hb_ot_var_axis_t *axes_array /* OUT */);
  116. HB_DEPRECATED_FOR (hb_ot_var_find_axis_info)
  117. HB_EXTERN hb_bool_t
  118. hb_ot_var_find_axis (hb_face_t *face,
  119. hb_tag_t axis_tag,
  120. unsigned int *axis_index,
  121. hb_ot_var_axis_t *axis_info);
  122. #endif
  123. HB_END_DECLS
  124. #endif /* HB_OT_DEPRECATED_H */