1/*
2 * Copyright © 2013 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
27#if !defined(HB_H_IN) && !defined(HB_NO_SINGLE_HEADER_ERROR)
28#error "Include <hb.h> instead."
29#endif
30
31#ifndef HB_DEPRECATED_H
32#define HB_DEPRECATED_H
33
34#include "hb-common.h"
35#include "hb-unicode.h"
36#include "hb-font.h"
37#include "hb-set.h"
38
39
40/**
41 * SECTION:hb-deprecated
42 * @title: hb-deprecated
43 * @short_description: Deprecated API
44 * @include: hb.h
45 *
46 * These API have been deprecated in favor of newer API, or because they
47 * were deemed unnecessary.
48 **/
49
50
51HB_BEGIN_DECLS
52
53#ifndef HB_DISABLE_DEPRECATED
54
55
56/**
57 * HB_SCRIPT_CANADIAN_ABORIGINAL:
58 *
59 * Use #HB_SCRIPT_CANADIAN_SYLLABICS instead:
60 *
61 * Deprecated: 0.9.20
62 */
63#define HB_SCRIPT_CANADIAN_ABORIGINAL HB_SCRIPT_CANADIAN_SYLLABICS
64
65/**
66 * HB_BUFFER_FLAGS_DEFAULT:
67 *
68 * Use #HB_BUFFER_FLAG_DEFAULT instead.
69 *
70 * Deprecated: 0.9.20
71 */
72#define HB_BUFFER_FLAGS_DEFAULT HB_BUFFER_FLAG_DEFAULT
73/**
74 * HB_BUFFER_SERIALIZE_FLAGS_DEFAULT:
75 *
76 * Use #HB_BUFFER_SERIALIZE_FLAG_DEFAULT instead.
77 *
78 * Deprecated: 0.9.20
79 */
80#define HB_BUFFER_SERIALIZE_FLAGS_DEFAULT HB_BUFFER_SERIALIZE_FLAG_DEFAULT
81
82/**
83 * hb_font_get_glyph_func_t:
84 * @font: #hb_font_t to work upon
85 * @font_data: @font user data pointer
86 * @unicode: The Unicode code point to query
87 * @variation_selector: The variation-selector code point to query
88 * @glyph: (out): The glyph ID retrieved
89 * @user_data: User data pointer passed by the caller
90 *
91 * A virtual method for the #hb_font_funcs_t of an #hb_font_t object.
92 *
93 * This method should retrieve the glyph ID for a specified Unicode code point
94 * font, with an optional variation selector.
95 *
96 * Return value: `true` if data found, `false` otherwise
97 * Deprecated: 1.2.3
98 *
99 **/
100typedef hb_bool_t (*hb_font_get_glyph_func_t) (hb_font_t *font, void *font_data,
101 hb_codepoint_t unicode, hb_codepoint_t variation_selector,
102 hb_codepoint_t *glyph,
103 void *user_data);
104
105HB_DEPRECATED_FOR (hb_font_funcs_set_nominal_glyph_func and hb_font_funcs_set_variation_glyph_func)
106HB_EXTERN void
107hb_font_funcs_set_glyph_func (hb_font_funcs_t *ffuncs,
108 hb_font_get_glyph_func_t func,
109 void *user_data, hb_destroy_func_t destroy);
110
111/* https://github.com/harfbuzz/harfbuzz/pull/4207 */
112/**
113 * HB_UNICODE_COMBINING_CLASS_CCC133:
114 *
115 * [Tibetan]
116 *
117 * Deprecated: 7.2.0
118 **/
119#define HB_UNICODE_COMBINING_CLASS_CCC133 133
120
121/**
122 * hb_unicode_eastasian_width_func_t:
123 * @ufuncs: A Unicode-functions structure
124 * @unicode: The code point to query
125 * @user_data: User data pointer passed by the caller
126 *
127 * A virtual method for the #hb_unicode_funcs_t structure.
128 *
129 * Deprecated: 2.0.0
130 */
131typedef unsigned int (*hb_unicode_eastasian_width_func_t) (hb_unicode_funcs_t *ufuncs,
132 hb_codepoint_t unicode,
133 void *user_data);
134
135/**
136 * hb_unicode_funcs_set_eastasian_width_func:
137 * @ufuncs: a Unicode-function structure
138 * @func: (closure user_data) (destroy destroy) (scope notified): The callback function to assign
139 * @user_data: Data to pass to @func
140 * @destroy: (nullable): The function to call when @user_data is not needed anymore
141 *
142 * Sets the implementation function for #hb_unicode_eastasian_width_func_t.
143 *
144 * Since: 0.9.2
145 * Deprecated: 2.0.0
146 **/
147HB_EXTERN HB_DEPRECATED void
148hb_unicode_funcs_set_eastasian_width_func (hb_unicode_funcs_t *ufuncs,
149 hb_unicode_eastasian_width_func_t func,
150 void *user_data, hb_destroy_func_t destroy);
151
152/**
153 * hb_unicode_eastasian_width:
154 * @ufuncs: a Unicode-function structure
155 * @unicode: The code point to query
156 *
157 * Don't use. Not used by HarfBuzz.
158 *
159 * Since: 0.9.2
160 * Deprecated: 2.0.0
161 **/
162HB_EXTERN HB_DEPRECATED unsigned int
163hb_unicode_eastasian_width (hb_unicode_funcs_t *ufuncs,
164 hb_codepoint_t unicode);
165
166
167/**
168 * hb_unicode_decompose_compatibility_func_t:
169 * @ufuncs: a Unicode function structure
170 * @u: codepoint to decompose
171 * @decomposed: address of codepoint array (of length #HB_UNICODE_MAX_DECOMPOSITION_LEN) to write decomposition into
172 * @user_data: user data pointer as passed to hb_unicode_funcs_set_decompose_compatibility_func()
173 *
174 * Fully decompose @u to its Unicode compatibility decomposition. The codepoints of the decomposition will be written to @decomposed.
175 * The complete length of the decomposition will be returned.
176 *
177 * If @u has no compatibility decomposition, zero should be returned.
178 *
179 * The Unicode standard guarantees that a buffer of length #HB_UNICODE_MAX_DECOMPOSITION_LEN codepoints will always be sufficient for any
180 * compatibility decomposition plus an terminating value of 0. Consequently, @decompose must be allocated by the caller to be at least this length. Implementations
181 * of this function type must ensure that they do not write past the provided array.
182 *
183 * Return value: number of codepoints in the full compatibility decomposition of @u, or 0 if no decomposition available.
184 *
185 * Deprecated: 2.0.0
186 */
187typedef unsigned int (*hb_unicode_decompose_compatibility_func_t) (hb_unicode_funcs_t *ufuncs,
188 hb_codepoint_t u,
189 hb_codepoint_t *decomposed,
190 void *user_data);
191
192/**
193 * HB_UNICODE_MAX_DECOMPOSITION_LEN:
194 *
195 * See Unicode 6.1 for details on the maximum decomposition length.
196 *
197 * Deprecated: 2.0.0
198 */
199#define HB_UNICODE_MAX_DECOMPOSITION_LEN (18+1) /* codepoints */
200
201/**
202 * hb_unicode_funcs_set_decompose_compatibility_func:
203 * @ufuncs: A Unicode-functions structure
204 * @func: (closure user_data) (destroy destroy) (scope notified): The callback function to assign
205 * @user_data: Data to pass to @func
206 * @destroy: (nullable): The function to call when @user_data is not needed anymore
207 *
208 * Sets the implementation function for #hb_unicode_decompose_compatibility_func_t.
209 *
210 *
211 *
212 * Since: 0.9.2
213 * Deprecated: 2.0.0
214 **/
215HB_EXTERN HB_DEPRECATED void
216hb_unicode_funcs_set_decompose_compatibility_func (hb_unicode_funcs_t *ufuncs,
217 hb_unicode_decompose_compatibility_func_t func,
218 void *user_data, hb_destroy_func_t destroy);
219
220HB_EXTERN HB_DEPRECATED unsigned int
221hb_unicode_decompose_compatibility (hb_unicode_funcs_t *ufuncs,
222 hb_codepoint_t u,
223 hb_codepoint_t *decomposed);
224
225
226/**
227 * hb_font_get_glyph_v_kerning_func_t:
228 *
229 * A virtual method for the #hb_font_funcs_t of an #hb_font_t object.
230 *
231 * This method should retrieve the kerning-adjustment value for a glyph-pair in
232 * the specified font, for vertical text segments.
233 *
234 **/
235typedef hb_font_get_glyph_kerning_func_t hb_font_get_glyph_v_kerning_func_t;
236
237/**
238 * hb_font_funcs_set_glyph_v_kerning_func:
239 * @ffuncs: A font-function structure
240 * @func: (closure user_data) (destroy destroy) (scope notified): The callback function to assign
241 * @user_data: Data to pass to @func
242 * @destroy: (nullable): The function to call when @user_data is not needed anymore
243 *
244 * Sets the implementation function for #hb_font_get_glyph_v_kerning_func_t.
245 *
246 * Since: 0.9.2
247 * Deprecated: 2.0.0
248 **/
249HB_EXTERN void
250hb_font_funcs_set_glyph_v_kerning_func (hb_font_funcs_t *ffuncs,
251 hb_font_get_glyph_v_kerning_func_t func,
252 void *user_data, hb_destroy_func_t destroy);
253
254HB_EXTERN hb_position_t
255hb_font_get_glyph_v_kerning (hb_font_t *font,
256 hb_codepoint_t top_glyph, hb_codepoint_t bottom_glyph);
257
258
259/**
260 * hb_font_get_glyph_shape_func_t:
261 * @font: #hb_font_t to work upon
262 * @font_data: @font user data pointer
263 * @glyph: The glyph ID to query
264 * @draw_funcs: The draw functions to send the shape data to
265 * @draw_data: The data accompanying the draw functions
266 * @user_data: User data pointer passed by the caller
267 *
268 * A virtual method for the #hb_font_funcs_t of an #hb_font_t object.
269 *
270 * Since: 4.0.0
271 * Deprecated: 7.0.0: Use #hb_font_draw_glyph_func_t instead
272 **/
273typedef void (*hb_font_get_glyph_shape_func_t) (hb_font_t *font, void *font_data,
274 hb_codepoint_t glyph,
275 hb_draw_funcs_t *draw_funcs, void *draw_data,
276 void *user_data);
277
278/**
279 * hb_font_funcs_set_glyph_shape_func:
280 * @ffuncs: A font-function structure
281 * @func: (closure user_data) (destroy destroy) (scope notified): The callback function to assign
282 * @user_data: Data to pass to @func
283 * @destroy: (nullable): The function to call when @user_data is not needed anymore
284 *
285 * Sets the implementation function for #hb_font_get_glyph_shape_func_t,
286 * which is the same as #hb_font_draw_glyph_func_t.
287 *
288 * Since: 4.0.0
289 * Deprecated: 7.0.0: Use hb_font_funcs_set_draw_glyph_func() instead
290 **/
291HB_DEPRECATED_FOR (hb_font_funcs_set_draw_glyph_func)
292HB_EXTERN void
293hb_font_funcs_set_glyph_shape_func (hb_font_funcs_t *ffuncs,
294 hb_font_get_glyph_shape_func_t func,
295 void *user_data, hb_destroy_func_t destroy);
296
297HB_DEPRECATED_FOR (hb_font_draw_glyph)
298HB_EXTERN void
299hb_font_get_glyph_shape (hb_font_t *font,
300 hb_codepoint_t glyph,
301 hb_draw_funcs_t *dfuncs, void *draw_data);
302
303
304#endif
305
306
307HB_END_DECLS
308
309#endif /* HB_DEPRECATED_H */
310