include/harfbuzz/hb-ot-deprecated.h

0001 /*
0002  * Copyright © 2018  Google, Inc.
0003  *
0004  *  This is part of HarfBuzz, a text shaping library.
0005  *
0006  * Permission is hereby granted, without written agreement and without
0007  * license or royalty fees, to use, copy, modify, and distribute this
0008  * software and its documentation for any purpose, provided that the
0009  * above copyright notice and the following two paragraphs appear in
0010  * all copies of this software.
0011  *
0012  * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
0013  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
0014  * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
0015  * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
0016  * DAMAGE.
0017  *
0018  * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
0019  * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
0020  * FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
0021  * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
0022  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
0023  *
0024  * Google Author(s): Behdad Esfahbod
0025  */
0026
0027 #if !defined(HB_OT_H_IN) && !defined(HB_NO_SINGLE_HEADER_ERROR)
0028 #error "Include <hb-ot.h> instead."
0029 #endif
0030
0031 #ifndef HB_OT_DEPRECATED_H
0032 #define HB_OT_DEPRECATED_H
0033
0034 #include "hb.h"
0035 #include "hb-ot-name.h"
0036
0037
0038 HB_BEGIN_DECLS
0039
0040 #ifndef HB_DISABLE_DEPRECATED
0041
0042
0043 /* https://github.com/harfbuzz/harfbuzz/issues/1734 */
0044 /**
0045  * HB_MATH_GLYPH_PART_FLAG_EXTENDER:
0046  *
0047  * Use #HB_OT_MATH_GLYPH_PART_FLAG_EXTENDER instead.
0048  *
0049  * Deprecated: 2.5.1
0050  */
0051 #define HB_MATH_GLYPH_PART_FLAG_EXTENDER HB_OT_MATH_GLYPH_PART_FLAG_EXTENDER
0052
0053 /* https://github.com/harfbuzz/harfbuzz/pull/3417 */
0054 /**
0055  * HB_OT_MATH_SCRIPT:
0056  *
0057  * Use #HB_SCRIPT_MATH or #HB_OT_TAG_MATH_SCRIPT instead.
0058  *
0059  * <note>Previous versions of this documentation recommended passing
0060  * #HB_OT_MATH_SCRIPT to hb_buffer_set_script() to enable math shaping, but this
0061  * usage is no longer supported. Use #HB_SCRIPT_MATH instead.</note>
0062  *
0063  * Since: 1.3.3
0064  * Deprecated: 3.4.0
0065  */
0066 #define HB_OT_MATH_SCRIPT HB_OT_TAG_MATH_SCRIPT
0067
0068
0069 /* Like hb_ot_layout_table_find_script, but takes zero-terminated array of scripts to test */
0070 HB_DEPRECATED_FOR (hb_ot_layout_table_select_script)
0071 HB_EXTERN hb_bool_t
0072 hb_ot_layout_table_choose_script (hb_face_t      *face,
0073                   hb_tag_t        table_tag,
0074                   const hb_tag_t *script_tags,
0075                   unsigned int   *script_index,
0076                   hb_tag_t       *chosen_script);
0077
0078 HB_DEPRECATED_FOR (hb_ot_layout_script_select_language)
0079 HB_EXTERN hb_bool_t
0080 hb_ot_layout_script_find_language (hb_face_t    *face,
0081                    hb_tag_t      table_tag,
0082                    unsigned int  script_index,
0083                    hb_tag_t      language_tag,
0084                    unsigned int *language_index);
0085
0086 HB_DEPRECATED_FOR (hb_ot_tags_from_script_and_language)
0087 HB_EXTERN void
0088 hb_ot_tags_from_script (hb_script_t  script,
0089             hb_tag_t    *script_tag_1,
0090             hb_tag_t    *script_tag_2);
0091
0092 HB_DEPRECATED_FOR (hb_ot_tags_from_script_and_language)
0093 HB_EXTERN hb_tag_t
0094 hb_ot_tag_from_language (hb_language_t language);
0095
0096
0097 /**
0098  * HB_OT_VAR_NO_AXIS_INDEX:
0099  *
0100  * Do not use.
0101  *
0102  * Since: 1.4.2
0103  * Deprecated: 2.2.0
0104  */
0105 #define HB_OT_VAR_NO_AXIS_INDEX     0xFFFFFFFFu
0106
0107 /**
0108  * hb_ot_var_axis_t:
0109  * @tag: axis tag
0110  * @name_id: axis name identifier
0111  * @min_value: minimum value of the axis
0112  * @default_value: default value of the axis
0113  * @max_value: maximum value of the axis
0114  *
0115  * Use #hb_ot_var_axis_info_t instead.
0116  *
0117  * Since: 1.4.2
0118  * Deprecated: 2.2.0
0119  */
0120 typedef struct hb_ot_var_axis_t {
0121   hb_tag_t tag;
0122   hb_ot_name_id_t name_id;
0123   float min_value;
0124   float default_value;
0125   float max_value;
0126 } hb_ot_var_axis_t;
0127
0128 HB_DEPRECATED_FOR (hb_ot_var_get_axis_infos)
0129 HB_EXTERN unsigned int
0130 hb_ot_var_get_axes (hb_face_t        *face,
0131             unsigned int      start_offset,
0132             unsigned int     *axes_count /* IN/OUT */,
0133             hb_ot_var_axis_t *axes_array /* OUT */);
0134
0135 HB_DEPRECATED_FOR (hb_ot_var_find_axis_info)
0136 HB_EXTERN hb_bool_t
0137 hb_ot_var_find_axis (hb_face_t        *face,
0138              hb_tag_t          axis_tag,
0139              unsigned int     *axis_index,
0140              hb_ot_var_axis_t *axis_info);
0141
0142
0143 #endif
0144
0145 HB_END_DECLS
0146
0147 #endif /* HB_OT_DEPRECATED_H */