1/*
2 * Copyright © 2009 Red Hat, Inc.
3 * Copyright © 2012 Google, Inc.
4 *
5 * This is part of HarfBuzz, a text shaping library.
6 *
7 * Permission is hereby granted, without written agreement and without
8 * license or royalty fees, to use, copy, modify, and distribute this
9 * software and its documentation for any purpose, provided that the
10 * above copyright notice and the following two paragraphs appear in
11 * all copies of this software.
12 *
13 * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
14 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
15 * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
16 * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
17 * DAMAGE.
18 *
19 * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
20 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
21 * FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
22 * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
23 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
24 *
25 * Red Hat Author(s): Behdad Esfahbod
26 * Google Author(s): Behdad Esfahbod
27 */
28
29#include "hb.hh"
30
31#include "hb-font.hh"
32#include "hb-machinery.hh"
33
34#include "hb-ot.h"
35
36
37/**
38 * SECTION:hb-font
39 * @title: hb-font
40 * @short_description: Font objects
41 * @include: hb.h
42 *
43 * Font objects represent a font face at a certain size and other
44 * parameters (pixels per EM, points per EM, variation settings.)
45 * Fonts are created from font faces, and are used as input to
46 * hb_shape() among other things.
47 **/
48
49
50/*
51 * hb_font_funcs_t
52 */
53
54static hb_bool_t
55hb_font_get_font_h_extents_nil (hb_font_t *font HB_UNUSED,
56 void *font_data HB_UNUSED,
57 hb_font_extents_t *extents,
58 void *user_data HB_UNUSED)
59{
60 memset (extents, 0, sizeof (*extents));
61 return false;
62}
63static hb_bool_t
64hb_font_get_font_h_extents_default (hb_font_t *font,
65 void *font_data HB_UNUSED,
66 hb_font_extents_t *extents,
67 void *user_data HB_UNUSED)
68{
69 hb_bool_t ret = font->parent->get_font_h_extents (extents);
70 if (ret) {
71 extents->ascender = font->parent_scale_y_distance (extents->ascender);
72 extents->descender = font->parent_scale_y_distance (extents->descender);
73 extents->line_gap = font->parent_scale_y_distance (extents->line_gap);
74 }
75 return ret;
76}
77
78static hb_bool_t
79hb_font_get_font_v_extents_nil (hb_font_t *font HB_UNUSED,
80 void *font_data HB_UNUSED,
81 hb_font_extents_t *extents,
82 void *user_data HB_UNUSED)
83{
84 memset (extents, 0, sizeof (*extents));
85 return false;
86}
87static hb_bool_t
88hb_font_get_font_v_extents_default (hb_font_t *font,
89 void *font_data HB_UNUSED,
90 hb_font_extents_t *extents,
91 void *user_data HB_UNUSED)
92{
93 hb_bool_t ret = font->parent->get_font_v_extents (extents);
94 if (ret) {
95 extents->ascender = font->parent_scale_x_distance (extents->ascender);
96 extents->descender = font->parent_scale_x_distance (extents->descender);
97 extents->line_gap = font->parent_scale_x_distance (extents->line_gap);
98 }
99 return ret;
100}
101
102static hb_bool_t
103hb_font_get_nominal_glyph_nil (hb_font_t *font HB_UNUSED,
104 void *font_data HB_UNUSED,
105 hb_codepoint_t unicode HB_UNUSED,
106 hb_codepoint_t *glyph,
107 void *user_data HB_UNUSED)
108{
109 *glyph = 0;
110 return false;
111}
112static hb_bool_t
113hb_font_get_nominal_glyph_default (hb_font_t *font,
114 void *font_data HB_UNUSED,
115 hb_codepoint_t unicode,
116 hb_codepoint_t *glyph,
117 void *user_data HB_UNUSED)
118{
119 if (font->has_nominal_glyphs_func_set ())
120 {
121 return font->get_nominal_glyphs (1, &unicode, 0, glyph, 0);
122 }
123 return font->parent->get_nominal_glyph (unicode, glyph);
124}
125
126#define hb_font_get_nominal_glyphs_nil hb_font_get_nominal_glyphs_default
127static unsigned int
128hb_font_get_nominal_glyphs_default (hb_font_t *font,
129 void *font_data HB_UNUSED,
130 unsigned int count,
131 const hb_codepoint_t *first_unicode,
132 unsigned int unicode_stride,
133 hb_codepoint_t *first_glyph,
134 unsigned int glyph_stride,
135 void *user_data HB_UNUSED)
136{
137 if (font->has_nominal_glyph_func_set ())
138 {
139 for (unsigned int i = 0; i < count; i++)
140 {
141 if (!font->get_nominal_glyph (*first_unicode, first_glyph))
142 return i;
143
144 first_unicode = &StructAtOffsetUnaligned<hb_codepoint_t> (first_unicode, unicode_stride);
145 first_glyph = &StructAtOffsetUnaligned<hb_codepoint_t> (first_glyph, glyph_stride);
146 }
147 return count;
148 }
149
150 return font->parent->get_nominal_glyphs (count,
151 first_unicode, unicode_stride,
152 first_glyph, glyph_stride);
153}
154
155static hb_bool_t
156hb_font_get_variation_glyph_nil (hb_font_t *font HB_UNUSED,
157 void *font_data HB_UNUSED,
158 hb_codepoint_t unicode HB_UNUSED,
159 hb_codepoint_t variation_selector HB_UNUSED,
160 hb_codepoint_t *glyph,
161 void *user_data HB_UNUSED)
162{
163 *glyph = 0;
164 return false;
165}
166static hb_bool_t
167hb_font_get_variation_glyph_default (hb_font_t *font,
168 void *font_data HB_UNUSED,
169 hb_codepoint_t unicode,
170 hb_codepoint_t variation_selector,
171 hb_codepoint_t *glyph,
172 void *user_data HB_UNUSED)
173{
174 return font->parent->get_variation_glyph (unicode, variation_selector, glyph);
175}
176
177
178static hb_position_t
179hb_font_get_glyph_h_advance_nil (hb_font_t *font,
180 void *font_data HB_UNUSED,
181 hb_codepoint_t glyph HB_UNUSED,
182 void *user_data HB_UNUSED)
183{
184 return font->x_scale;
185}
186static hb_position_t
187hb_font_get_glyph_h_advance_default (hb_font_t *font,
188 void *font_data HB_UNUSED,
189 hb_codepoint_t glyph,
190 void *user_data HB_UNUSED)
191{
192 if (font->has_glyph_h_advances_func_set ())
193 {
194 hb_position_t ret;
195 font->get_glyph_h_advances (1, &glyph, 0, &ret, 0);
196 return ret;
197 }
198 return font->parent_scale_x_distance (font->parent->get_glyph_h_advance (glyph));
199}
200
201static hb_position_t
202hb_font_get_glyph_v_advance_nil (hb_font_t *font,
203 void *font_data HB_UNUSED,
204 hb_codepoint_t glyph HB_UNUSED,
205 void *user_data HB_UNUSED)
206{
207 /* TODO use font_extents.ascender+descender */
208 return font->y_scale;
209}
210static hb_position_t
211hb_font_get_glyph_v_advance_default (hb_font_t *font,
212 void *font_data HB_UNUSED,
213 hb_codepoint_t glyph,
214 void *user_data HB_UNUSED)
215{
216 if (font->has_glyph_v_advances_func_set ())
217 {
218 hb_position_t ret;
219 font->get_glyph_v_advances (1, &glyph, 0, &ret, 0);
220 return ret;
221 }
222 return font->parent_scale_y_distance (font->parent->get_glyph_v_advance (glyph));
223}
224
225#define hb_font_get_glyph_h_advances_nil hb_font_get_glyph_h_advances_default
226static void
227hb_font_get_glyph_h_advances_default (hb_font_t* font,
228 void* font_data HB_UNUSED,
229 unsigned int count,
230 const hb_codepoint_t *first_glyph,
231 unsigned int glyph_stride,
232 hb_position_t *first_advance,
233 unsigned int advance_stride,
234 void *user_data HB_UNUSED)
235{
236 if (font->has_glyph_h_advance_func_set ())
237 {
238 for (unsigned int i = 0; i < count; i++)
239 {
240 *first_advance = font->get_glyph_h_advance (*first_glyph);
241 first_glyph = &StructAtOffsetUnaligned<hb_codepoint_t> (first_glyph, glyph_stride);
242 first_advance = &StructAtOffsetUnaligned<hb_position_t> (first_advance, advance_stride);
243 }
244 return;
245 }
246
247 font->parent->get_glyph_h_advances (count,
248 first_glyph, glyph_stride,
249 first_advance, advance_stride);
250 for (unsigned int i = 0; i < count; i++)
251 {
252 *first_advance = font->parent_scale_x_distance (*first_advance);
253 first_advance = &StructAtOffsetUnaligned<hb_position_t> (first_advance, advance_stride);
254 }
255}
256
257#define hb_font_get_glyph_v_advances_nil hb_font_get_glyph_v_advances_default
258static void
259hb_font_get_glyph_v_advances_default (hb_font_t* font,
260 void* font_data HB_UNUSED,
261 unsigned int count,
262 const hb_codepoint_t *first_glyph,
263 unsigned int glyph_stride,
264 hb_position_t *first_advance,
265 unsigned int advance_stride,
266 void *user_data HB_UNUSED)
267{
268 if (font->has_glyph_v_advance_func_set ())
269 {
270 for (unsigned int i = 0; i < count; i++)
271 {
272 *first_advance = font->get_glyph_v_advance (*first_glyph);
273 first_glyph = &StructAtOffsetUnaligned<hb_codepoint_t> (first_glyph, glyph_stride);
274 first_advance = &StructAtOffsetUnaligned<hb_position_t> (first_advance, advance_stride);
275 }
276 return;
277 }
278
279 font->parent->get_glyph_v_advances (count,
280 first_glyph, glyph_stride,
281 first_advance, advance_stride);
282 for (unsigned int i = 0; i < count; i++)
283 {
284 *first_advance = font->parent_scale_y_distance (*first_advance);
285 first_advance = &StructAtOffsetUnaligned<hb_position_t> (first_advance, advance_stride);
286 }
287}
288
289static hb_bool_t
290hb_font_get_glyph_h_origin_nil (hb_font_t *font HB_UNUSED,
291 void *font_data HB_UNUSED,
292 hb_codepoint_t glyph HB_UNUSED,
293 hb_position_t *x,
294 hb_position_t *y,
295 void *user_data HB_UNUSED)
296{
297 *x = *y = 0;
298 return true;
299}
300static hb_bool_t
301hb_font_get_glyph_h_origin_default (hb_font_t *font,
302 void *font_data HB_UNUSED,
303 hb_codepoint_t glyph,
304 hb_position_t *x,
305 hb_position_t *y,
306 void *user_data HB_UNUSED)
307{
308 hb_bool_t ret = font->parent->get_glyph_h_origin (glyph, x, y);
309 if (ret)
310 font->parent_scale_position (x, y);
311 return ret;
312}
313
314static hb_bool_t
315hb_font_get_glyph_v_origin_nil (hb_font_t *font HB_UNUSED,
316 void *font_data HB_UNUSED,
317 hb_codepoint_t glyph HB_UNUSED,
318 hb_position_t *x,
319 hb_position_t *y,
320 void *user_data HB_UNUSED)
321{
322 *x = *y = 0;
323 return false;
324}
325static hb_bool_t
326hb_font_get_glyph_v_origin_default (hb_font_t *font,
327 void *font_data HB_UNUSED,
328 hb_codepoint_t glyph,
329 hb_position_t *x,
330 hb_position_t *y,
331 void *user_data HB_UNUSED)
332{
333 hb_bool_t ret = font->parent->get_glyph_v_origin (glyph, x, y);
334 if (ret)
335 font->parent_scale_position (x, y);
336 return ret;
337}
338
339static hb_position_t
340hb_font_get_glyph_h_kerning_nil (hb_font_t *font HB_UNUSED,
341 void *font_data HB_UNUSED,
342 hb_codepoint_t left_glyph HB_UNUSED,
343 hb_codepoint_t right_glyph HB_UNUSED,
344 void *user_data HB_UNUSED)
345{
346 return 0;
347}
348static hb_position_t
349hb_font_get_glyph_h_kerning_default (hb_font_t *font,
350 void *font_data HB_UNUSED,
351 hb_codepoint_t left_glyph,
352 hb_codepoint_t right_glyph,
353 void *user_data HB_UNUSED)
354{
355 return font->parent_scale_x_distance (font->parent->get_glyph_h_kerning (left_glyph, right_glyph));
356}
357
358static hb_position_t
359hb_font_get_glyph_v_kerning_nil (hb_font_t *font HB_UNUSED,
360 void *font_data HB_UNUSED,
361 hb_codepoint_t top_glyph HB_UNUSED,
362 hb_codepoint_t bottom_glyph HB_UNUSED,
363 void *user_data HB_UNUSED)
364{
365 return 0;
366}
367static hb_position_t
368hb_font_get_glyph_v_kerning_default (hb_font_t *font,
369 void *font_data HB_UNUSED,
370 hb_codepoint_t top_glyph,
371 hb_codepoint_t bottom_glyph,
372 void *user_data HB_UNUSED)
373{
374 return font->parent_scale_y_distance (font->parent->get_glyph_v_kerning (top_glyph, bottom_glyph));
375}
376
377static hb_bool_t
378hb_font_get_glyph_extents_nil (hb_font_t *font HB_UNUSED,
379 void *font_data HB_UNUSED,
380 hb_codepoint_t glyph HB_UNUSED,
381 hb_glyph_extents_t *extents,
382 void *user_data HB_UNUSED)
383{
384 memset (extents, 0, sizeof (*extents));
385 return false;
386}
387static hb_bool_t
388hb_font_get_glyph_extents_default (hb_font_t *font,
389 void *font_data HB_UNUSED,
390 hb_codepoint_t glyph,
391 hb_glyph_extents_t *extents,
392 void *user_data HB_UNUSED)
393{
394 hb_bool_t ret = font->parent->get_glyph_extents (glyph, extents);
395 if (ret) {
396 font->parent_scale_position (&extents->x_bearing, &extents->y_bearing);
397 font->parent_scale_distance (&extents->width, &extents->height);
398 }
399 return ret;
400}
401
402static hb_bool_t
403hb_font_get_glyph_contour_point_nil (hb_font_t *font HB_UNUSED,
404 void *font_data HB_UNUSED,
405 hb_codepoint_t glyph HB_UNUSED,
406 unsigned int point_index HB_UNUSED,
407 hb_position_t *x,
408 hb_position_t *y,
409 void *user_data HB_UNUSED)
410{
411 *x = *y = 0;
412 return false;
413}
414static hb_bool_t
415hb_font_get_glyph_contour_point_default (hb_font_t *font,
416 void *font_data HB_UNUSED,
417 hb_codepoint_t glyph,
418 unsigned int point_index,
419 hb_position_t *x,
420 hb_position_t *y,
421 void *user_data HB_UNUSED)
422{
423 hb_bool_t ret = font->parent->get_glyph_contour_point (glyph, point_index, x, y);
424 if (ret)
425 font->parent_scale_position (x, y);
426 return ret;
427}
428
429static hb_bool_t
430hb_font_get_glyph_name_nil (hb_font_t *font HB_UNUSED,
431 void *font_data HB_UNUSED,
432 hb_codepoint_t glyph HB_UNUSED,
433 char *name, unsigned int size,
434 void *user_data HB_UNUSED)
435{
436 if (size) *name = '\0';
437 return false;
438}
439static hb_bool_t
440hb_font_get_glyph_name_default (hb_font_t *font,
441 void *font_data HB_UNUSED,
442 hb_codepoint_t glyph,
443 char *name, unsigned int size,
444 void *user_data HB_UNUSED)
445{
446 return font->parent->get_glyph_name (glyph, name, size);
447}
448
449static hb_bool_t
450hb_font_get_glyph_from_name_nil (hb_font_t *font HB_UNUSED,
451 void *font_data HB_UNUSED,
452 const char *name HB_UNUSED,
453 int len HB_UNUSED, /* -1 means nul-terminated */
454 hb_codepoint_t *glyph,
455 void *user_data HB_UNUSED)
456{
457 *glyph = 0;
458 return false;
459}
460static hb_bool_t
461hb_font_get_glyph_from_name_default (hb_font_t *font,
462 void *font_data HB_UNUSED,
463 const char *name, int len, /* -1 means nul-terminated */
464 hb_codepoint_t *glyph,
465 void *user_data HB_UNUSED)
466{
467 return font->parent->get_glyph_from_name (name, len, glyph);
468}
469
470DEFINE_NULL_INSTANCE (hb_font_funcs_t) =
471{
472 HB_OBJECT_HEADER_STATIC,
473
474 {
475#define HB_FONT_FUNC_IMPLEMENT(name) nullptr,
476 HB_FONT_FUNCS_IMPLEMENT_CALLBACKS
477#undef HB_FONT_FUNC_IMPLEMENT
478 },
479 {
480#define HB_FONT_FUNC_IMPLEMENT(name) nullptr,
481 HB_FONT_FUNCS_IMPLEMENT_CALLBACKS
482#undef HB_FONT_FUNC_IMPLEMENT
483 },
484 {
485 {
486#define HB_FONT_FUNC_IMPLEMENT(name) hb_font_get_##name##_nil,
487 HB_FONT_FUNCS_IMPLEMENT_CALLBACKS
488#undef HB_FONT_FUNC_IMPLEMENT
489 }
490 }
491};
492
493static const hb_font_funcs_t _hb_font_funcs_default = {
494 HB_OBJECT_HEADER_STATIC,
495
496 {
497#define HB_FONT_FUNC_IMPLEMENT(name) nullptr,
498 HB_FONT_FUNCS_IMPLEMENT_CALLBACKS
499#undef HB_FONT_FUNC_IMPLEMENT
500 },
501 {
502#define HB_FONT_FUNC_IMPLEMENT(name) nullptr,
503 HB_FONT_FUNCS_IMPLEMENT_CALLBACKS
504#undef HB_FONT_FUNC_IMPLEMENT
505 },
506 {
507 {
508#define HB_FONT_FUNC_IMPLEMENT(name) hb_font_get_##name##_default,
509 HB_FONT_FUNCS_IMPLEMENT_CALLBACKS
510#undef HB_FONT_FUNC_IMPLEMENT
511 }
512 }
513};
514
515
516/**
517 * hb_font_funcs_create: (Xconstructor)
518 *
519 *
520 *
521 * Return value: (transfer full):
522 *
523 * Since: 0.9.2
524 **/
525hb_font_funcs_t *
526hb_font_funcs_create ()
527{
528 hb_font_funcs_t *ffuncs;
529
530 if (!(ffuncs = hb_object_create<hb_font_funcs_t> ()))
531 return hb_font_funcs_get_empty ();
532
533 ffuncs->get = _hb_font_funcs_default.get;
534
535 return ffuncs;
536}
537
538/**
539 * hb_font_funcs_get_empty:
540 *
541 *
542 *
543 * Return value: (transfer full):
544 *
545 * Since: 0.9.2
546 **/
547hb_font_funcs_t *
548hb_font_funcs_get_empty ()
549{
550 return const_cast<hb_font_funcs_t *> (&_hb_font_funcs_default);
551}
552
553/**
554 * hb_font_funcs_reference: (skip)
555 * @ffuncs: font functions.
556 *
557 *
558 *
559 * Return value:
560 *
561 * Since: 0.9.2
562 **/
563hb_font_funcs_t *
564hb_font_funcs_reference (hb_font_funcs_t *ffuncs)
565{
566 return hb_object_reference (ffuncs);
567}
568
569/**
570 * hb_font_funcs_destroy: (skip)
571 * @ffuncs: font functions.
572 *
573 *
574 *
575 * Since: 0.9.2
576 **/
577void
578hb_font_funcs_destroy (hb_font_funcs_t *ffuncs)
579{
580 if (!hb_object_destroy (ffuncs)) return;
581
582#define HB_FONT_FUNC_IMPLEMENT(name) if (ffuncs->destroy.name) \
583 ffuncs->destroy.name (ffuncs->user_data.name);
584 HB_FONT_FUNCS_IMPLEMENT_CALLBACKS
585#undef HB_FONT_FUNC_IMPLEMENT
586
587 free (ffuncs);
588}
589
590/**
591 * hb_font_funcs_set_user_data: (skip)
592 * @ffuncs: font functions.
593 * @key:
594 * @data:
595 * @destroy:
596 * @replace:
597 *
598 *
599 *
600 * Return value:
601 *
602 * Since: 0.9.2
603 **/
604hb_bool_t
605hb_font_funcs_set_user_data (hb_font_funcs_t *ffuncs,
606 hb_user_data_key_t *key,
607 void * data,
608 hb_destroy_func_t destroy,
609 hb_bool_t replace)
610{
611 return hb_object_set_user_data (ffuncs, key, data, destroy, replace);
612}
613
614/**
615 * hb_font_funcs_get_user_data: (skip)
616 * @ffuncs: font functions.
617 * @key:
618 *
619 *
620 *
621 * Return value: (transfer none):
622 *
623 * Since: 0.9.2
624 **/
625void *
626hb_font_funcs_get_user_data (hb_font_funcs_t *ffuncs,
627 hb_user_data_key_t *key)
628{
629 return hb_object_get_user_data (ffuncs, key);
630}
631
632
633/**
634 * hb_font_funcs_make_immutable:
635 * @ffuncs: font functions.
636 *
637 *
638 *
639 * Since: 0.9.2
640 **/
641void
642hb_font_funcs_make_immutable (hb_font_funcs_t *ffuncs)
643{
644 if (hb_object_is_immutable (ffuncs))
645 return;
646
647 hb_object_make_immutable (ffuncs);
648}
649
650/**
651 * hb_font_funcs_is_immutable:
652 * @ffuncs: font functions.
653 *
654 *
655 *
656 * Return value:
657 *
658 * Since: 0.9.2
659 **/
660hb_bool_t
661hb_font_funcs_is_immutable (hb_font_funcs_t *ffuncs)
662{
663 return hb_object_is_immutable (ffuncs);
664}
665
666
667#define HB_FONT_FUNC_IMPLEMENT(name) \
668 \
669void \
670hb_font_funcs_set_##name##_func (hb_font_funcs_t *ffuncs, \
671 hb_font_get_##name##_func_t func, \
672 void *user_data, \
673 hb_destroy_func_t destroy) \
674{ \
675 if (hb_object_is_immutable (ffuncs)) { \
676 if (destroy) \
677 destroy (user_data); \
678 return; \
679 } \
680 \
681 if (ffuncs->destroy.name) \
682 ffuncs->destroy.name (ffuncs->user_data.name); \
683 \
684 if (func) { \
685 ffuncs->get.f.name = func; \
686 ffuncs->user_data.name = user_data; \
687 ffuncs->destroy.name = destroy; \
688 } else { \
689 ffuncs->get.f.name = hb_font_get_##name##_default; \
690 ffuncs->user_data.name = nullptr; \
691 ffuncs->destroy.name = nullptr; \
692 } \
693}
694
695HB_FONT_FUNCS_IMPLEMENT_CALLBACKS
696#undef HB_FONT_FUNC_IMPLEMENT
697
698bool
699hb_font_t::has_func_set (unsigned int i)
700{
701 return this->klass->get.array[i] != _hb_font_funcs_default.get.array[i];
702}
703
704bool
705hb_font_t::has_func (unsigned int i)
706{
707 return has_func_set (i) ||
708 (parent && parent != &_hb_Null_hb_font_t && parent->has_func (i));
709}
710
711/* Public getters */
712
713/**
714 * hb_font_get_h_extents:
715 * @font: a font.
716 * @extents: (out):
717 *
718 *
719 *
720 * Return value:
721 *
722 * Since: 1.1.3
723 **/
724hb_bool_t
725hb_font_get_h_extents (hb_font_t *font,
726 hb_font_extents_t *extents)
727{
728 return font->get_font_h_extents (extents);
729}
730
731/**
732 * hb_font_get_v_extents:
733 * @font: a font.
734 * @extents: (out):
735 *
736 *
737 *
738 * Return value:
739 *
740 * Since: 1.1.3
741 **/
742hb_bool_t
743hb_font_get_v_extents (hb_font_t *font,
744 hb_font_extents_t *extents)
745{
746 return font->get_font_v_extents (extents);
747}
748
749/**
750 * hb_font_get_glyph:
751 * @font: a font.
752 * @unicode:
753 * @variation_selector:
754 * @glyph: (out):
755 *
756 *
757 *
758 * Return value:
759 *
760 * Since: 0.9.2
761 **/
762hb_bool_t
763hb_font_get_glyph (hb_font_t *font,
764 hb_codepoint_t unicode, hb_codepoint_t variation_selector,
765 hb_codepoint_t *glyph)
766{
767 if (unlikely (variation_selector))
768 return font->get_variation_glyph (unicode, variation_selector, glyph);
769 return font->get_nominal_glyph (unicode, glyph);
770}
771
772/**
773 * hb_font_get_nominal_glyph:
774 * @font: a font.
775 * @unicode:
776 * @glyph: (out):
777 *
778 *
779 *
780 * Return value:
781 *
782 * Since: 1.2.3
783 **/
784hb_bool_t
785hb_font_get_nominal_glyph (hb_font_t *font,
786 hb_codepoint_t unicode,
787 hb_codepoint_t *glyph)
788{
789 return font->get_nominal_glyph (unicode, glyph);
790}
791
792/**
793 * hb_font_get_variation_glyph:
794 * @font: a font.
795 * @unicode:
796 * @variation_selector:
797 * @glyph: (out):
798 *
799 *
800 *
801 * Return value:
802 *
803 * Since: 1.2.3
804 **/
805hb_bool_t
806hb_font_get_variation_glyph (hb_font_t *font,
807 hb_codepoint_t unicode, hb_codepoint_t variation_selector,
808 hb_codepoint_t *glyph)
809{
810 return font->get_variation_glyph (unicode, variation_selector, glyph);
811}
812
813/**
814 * hb_font_get_glyph_h_advance:
815 * @font: a font.
816 * @glyph:
817 *
818 *
819 *
820 * Return value:
821 *
822 * Since: 0.9.2
823 **/
824hb_position_t
825hb_font_get_glyph_h_advance (hb_font_t *font,
826 hb_codepoint_t glyph)
827{
828 return font->get_glyph_h_advance (glyph);
829}
830
831/**
832 * hb_font_get_glyph_v_advance:
833 * @font: a font.
834 * @glyph:
835 *
836 *
837 *
838 * Return value:
839 *
840 * Since: 0.9.2
841 **/
842hb_position_t
843hb_font_get_glyph_v_advance (hb_font_t *font,
844 hb_codepoint_t glyph)
845{
846 return font->get_glyph_v_advance (glyph);
847}
848
849/**
850 * hb_font_get_glyph_h_advances:
851 * @font: a font.
852 *
853 *
854 *
855 * Since: 1.8.6
856 **/
857void
858hb_font_get_glyph_h_advances (hb_font_t* font,
859 unsigned int count,
860 const hb_codepoint_t *first_glyph,
861 unsigned glyph_stride,
862 hb_position_t *first_advance,
863 unsigned advance_stride)
864{
865 font->get_glyph_h_advances (count, first_glyph, glyph_stride, first_advance, advance_stride);
866}
867/**
868 * hb_font_get_glyph_v_advances:
869 * @font: a font.
870 *
871 *
872 *
873 * Since: 1.8.6
874 **/
875void
876hb_font_get_glyph_v_advances (hb_font_t* font,
877 unsigned int count,
878 const hb_codepoint_t *first_glyph,
879 unsigned glyph_stride,
880 hb_position_t *first_advance,
881 unsigned advance_stride)
882{
883 font->get_glyph_v_advances (count, first_glyph, glyph_stride, first_advance, advance_stride);
884}
885
886/**
887 * hb_font_get_glyph_h_origin:
888 * @font: a font.
889 * @glyph:
890 * @x: (out):
891 * @y: (out):
892 *
893 *
894 *
895 * Return value:
896 *
897 * Since: 0.9.2
898 **/
899hb_bool_t
900hb_font_get_glyph_h_origin (hb_font_t *font,
901 hb_codepoint_t glyph,
902 hb_position_t *x, hb_position_t *y)
903{
904 return font->get_glyph_h_origin (glyph, x, y);
905}
906
907/**
908 * hb_font_get_glyph_v_origin:
909 * @font: a font.
910 * @glyph:
911 * @x: (out):
912 * @y: (out):
913 *
914 *
915 *
916 * Return value:
917 *
918 * Since: 0.9.2
919 **/
920hb_bool_t
921hb_font_get_glyph_v_origin (hb_font_t *font,
922 hb_codepoint_t glyph,
923 hb_position_t *x, hb_position_t *y)
924{
925 return font->get_glyph_v_origin (glyph, x, y);
926}
927
928/**
929 * hb_font_get_glyph_h_kerning:
930 * @font: a font.
931 * @left_glyph:
932 * @right_glyph:
933 *
934 *
935 *
936 * Return value:
937 *
938 * Since: 0.9.2
939 * Deprecated: 2.0.0
940 **/
941hb_position_t
942hb_font_get_glyph_h_kerning (hb_font_t *font,
943 hb_codepoint_t left_glyph, hb_codepoint_t right_glyph)
944{
945 return font->get_glyph_h_kerning (left_glyph, right_glyph);
946}
947
948/**
949 * hb_font_get_glyph_v_kerning:
950 * @font: a font.
951 * @top_glyph:
952 * @bottom_glyph:
953 *
954 *
955 *
956 * Return value:
957 *
958 * Since: 0.9.2
959 * Deprecated: 2.0.0
960 **/
961hb_position_t
962hb_font_get_glyph_v_kerning (hb_font_t *font,
963 hb_codepoint_t top_glyph, hb_codepoint_t bottom_glyph)
964{
965 return font->get_glyph_v_kerning (top_glyph, bottom_glyph);
966}
967
968/**
969 * hb_font_get_glyph_extents:
970 * @font: a font.
971 * @glyph:
972 * @extents: (out):
973 *
974 *
975 *
976 * Return value:
977 *
978 * Since: 0.9.2
979 **/
980hb_bool_t
981hb_font_get_glyph_extents (hb_font_t *font,
982 hb_codepoint_t glyph,
983 hb_glyph_extents_t *extents)
984{
985 return font->get_glyph_extents (glyph, extents);
986}
987
988/**
989 * hb_font_get_glyph_contour_point:
990 * @font: a font.
991 * @glyph:
992 * @point_index:
993 * @x: (out):
994 * @y: (out):
995 *
996 *
997 *
998 * Return value:
999 *
1000 * Since: 0.9.2
1001 **/
1002hb_bool_t
1003hb_font_get_glyph_contour_point (hb_font_t *font,
1004 hb_codepoint_t glyph, unsigned int point_index,
1005 hb_position_t *x, hb_position_t *y)
1006{
1007 return font->get_glyph_contour_point (glyph, point_index, x, y);
1008}
1009
1010/**
1011 * hb_font_get_glyph_name:
1012 * @font: a font.
1013 * @glyph:
1014 * @name: (array length=size):
1015 * @size:
1016 *
1017 *
1018 *
1019 * Return value:
1020 *
1021 * Since: 0.9.2
1022 **/
1023hb_bool_t
1024hb_font_get_glyph_name (hb_font_t *font,
1025 hb_codepoint_t glyph,
1026 char *name, unsigned int size)
1027{
1028 return font->get_glyph_name (glyph, name, size);
1029}
1030
1031/**
1032 * hb_font_get_glyph_from_name:
1033 * @font: a font.
1034 * @name: (array length=len):
1035 * @len:
1036 * @glyph: (out):
1037 *
1038 *
1039 *
1040 * Return value:
1041 *
1042 * Since: 0.9.2
1043 **/
1044hb_bool_t
1045hb_font_get_glyph_from_name (hb_font_t *font,
1046 const char *name, int len, /* -1 means nul-terminated */
1047 hb_codepoint_t *glyph)
1048{
1049 return font->get_glyph_from_name (name, len, glyph);
1050}
1051
1052
1053/* A bit higher-level, and with fallback */
1054
1055/**
1056 * hb_font_get_extents_for_direction:
1057 * @font: a font.
1058 * @direction:
1059 * @extents: (out):
1060 *
1061 *
1062 *
1063 * Since: 1.1.3
1064 **/
1065void
1066hb_font_get_extents_for_direction (hb_font_t *font,
1067 hb_direction_t direction,
1068 hb_font_extents_t *extents)
1069{
1070 return font->get_extents_for_direction (direction, extents);
1071}
1072/**
1073 * hb_font_get_glyph_advance_for_direction:
1074 * @font: a font.
1075 * @glyph:
1076 * @direction:
1077 * @x: (out):
1078 * @y: (out):
1079 *
1080 *
1081 *
1082 * Since: 0.9.2
1083 **/
1084void
1085hb_font_get_glyph_advance_for_direction (hb_font_t *font,
1086 hb_codepoint_t glyph,
1087 hb_direction_t direction,
1088 hb_position_t *x, hb_position_t *y)
1089{
1090 return font->get_glyph_advance_for_direction (glyph, direction, x, y);
1091}
1092/**
1093 * hb_font_get_glyph_advances_for_direction:
1094 * @font: a font.
1095 * @direction:
1096 *
1097 *
1098 *
1099 * Since: 1.8.6
1100 **/
1101HB_EXTERN void
1102hb_font_get_glyph_advances_for_direction (hb_font_t* font,
1103 hb_direction_t direction,
1104 unsigned int count,
1105 const hb_codepoint_t *first_glyph,
1106 unsigned glyph_stride,
1107 hb_position_t *first_advance,
1108 unsigned advance_stride)
1109{
1110 font->get_glyph_advances_for_direction (direction, count, first_glyph, glyph_stride, first_advance, advance_stride);
1111}
1112
1113/**
1114 * hb_font_get_glyph_origin_for_direction:
1115 * @font: a font.
1116 * @glyph:
1117 * @direction:
1118 * @x: (out):
1119 * @y: (out):
1120 *
1121 *
1122 *
1123 * Since: 0.9.2
1124 **/
1125void
1126hb_font_get_glyph_origin_for_direction (hb_font_t *font,
1127 hb_codepoint_t glyph,
1128 hb_direction_t direction,
1129 hb_position_t *x, hb_position_t *y)
1130{
1131 return font->get_glyph_origin_for_direction (glyph, direction, x, y);
1132}
1133
1134/**
1135 * hb_font_add_glyph_origin_for_direction:
1136 * @font: a font.
1137 * @glyph:
1138 * @direction:
1139 * @x: (out):
1140 * @y: (out):
1141 *
1142 *
1143 *
1144 * Since: 0.9.2
1145 **/
1146void
1147hb_font_add_glyph_origin_for_direction (hb_font_t *font,
1148 hb_codepoint_t glyph,
1149 hb_direction_t direction,
1150 hb_position_t *x, hb_position_t *y)
1151{
1152 return font->add_glyph_origin_for_direction (glyph, direction, x, y);
1153}
1154
1155/**
1156 * hb_font_subtract_glyph_origin_for_direction:
1157 * @font: a font.
1158 * @glyph:
1159 * @direction:
1160 * @x: (out):
1161 * @y: (out):
1162 *
1163 *
1164 *
1165 * Since: 0.9.2
1166 **/
1167void
1168hb_font_subtract_glyph_origin_for_direction (hb_font_t *font,
1169 hb_codepoint_t glyph,
1170 hb_direction_t direction,
1171 hb_position_t *x, hb_position_t *y)
1172{
1173 return font->subtract_glyph_origin_for_direction (glyph, direction, x, y);
1174}
1175
1176/**
1177 * hb_font_get_glyph_kerning_for_direction:
1178 * @font: a font.
1179 * @first_glyph:
1180 * @second_glyph:
1181 * @direction:
1182 * @x: (out):
1183 * @y: (out):
1184 *
1185 *
1186 *
1187 * Since: 0.9.2
1188 * Deprecated: 2.0.0
1189 **/
1190void
1191hb_font_get_glyph_kerning_for_direction (hb_font_t *font,
1192 hb_codepoint_t first_glyph, hb_codepoint_t second_glyph,
1193 hb_direction_t direction,
1194 hb_position_t *x, hb_position_t *y)
1195{
1196 return font->get_glyph_kerning_for_direction (first_glyph, second_glyph, direction, x, y);
1197}
1198
1199/**
1200 * hb_font_get_glyph_extents_for_origin:
1201 * @font: a font.
1202 * @glyph:
1203 * @direction:
1204 * @extents: (out):
1205 *
1206 *
1207 *
1208 * Return value:
1209 *
1210 * Since: 0.9.2
1211 **/
1212hb_bool_t
1213hb_font_get_glyph_extents_for_origin (hb_font_t *font,
1214 hb_codepoint_t glyph,
1215 hb_direction_t direction,
1216 hb_glyph_extents_t *extents)
1217{
1218 return font->get_glyph_extents_for_origin (glyph, direction, extents);
1219}
1220
1221/**
1222 * hb_font_get_glyph_contour_point_for_origin:
1223 * @font: a font.
1224 * @glyph:
1225 * @point_index:
1226 * @direction:
1227 * @x: (out):
1228 * @y: (out):
1229 *
1230 *
1231 *
1232 * Return value:
1233 *
1234 * Since: 0.9.2
1235 **/
1236hb_bool_t
1237hb_font_get_glyph_contour_point_for_origin (hb_font_t *font,
1238 hb_codepoint_t glyph, unsigned int point_index,
1239 hb_direction_t direction,
1240 hb_position_t *x, hb_position_t *y)
1241{
1242 return font->get_glyph_contour_point_for_origin (glyph, point_index, direction, x, y);
1243}
1244
1245/* Generates gidDDD if glyph has no name. */
1246/**
1247 * hb_font_glyph_to_string:
1248 * @font: a font.
1249 * @glyph:
1250 * @s: (array length=size):
1251 * @size:
1252 *
1253 *
1254 *
1255 * Since: 0.9.2
1256 **/
1257void
1258hb_font_glyph_to_string (hb_font_t *font,
1259 hb_codepoint_t glyph,
1260 char *s, unsigned int size)
1261{
1262 font->glyph_to_string (glyph, s, size);
1263}
1264
1265/* Parses gidDDD and uniUUUU strings automatically. */
1266/**
1267 * hb_font_glyph_from_string:
1268 * @font: a font.
1269 * @s: (array length=len) (element-type uint8_t):
1270 * @len:
1271 * @glyph: (out):
1272 *
1273 *
1274 *
1275 * Return value:
1276 *
1277 * Since: 0.9.2
1278 **/
1279hb_bool_t
1280hb_font_glyph_from_string (hb_font_t *font,
1281 const char *s, int len, /* -1 means nul-terminated */
1282 hb_codepoint_t *glyph)
1283{
1284 return font->glyph_from_string (s, len, glyph);
1285}
1286
1287
1288/*
1289 * hb_font_t
1290 */
1291
1292DEFINE_NULL_INSTANCE (hb_font_t) =
1293{
1294 HB_OBJECT_HEADER_STATIC,
1295
1296 nullptr, /* parent */
1297 const_cast<hb_face_t *> (&_hb_Null_hb_face_t),
1298
1299 1000, /* x_scale */
1300 1000, /* y_scale */
1301
1302 0, /* x_ppem */
1303 0, /* y_ppem */
1304 0, /* ptem */
1305
1306 0, /* num_coords */
1307 nullptr, /* coords */
1308
1309 const_cast<hb_font_funcs_t *> (&_hb_Null_hb_font_funcs_t),
1310
1311 /* Zero for the rest is fine. */
1312};
1313
1314
1315static hb_font_t *
1316_hb_font_create (hb_face_t *face)
1317{
1318 hb_font_t *font;
1319
1320 if (unlikely (!face))
1321 face = hb_face_get_empty ();
1322 if (!(font = hb_object_create<hb_font_t> ()))
1323 return hb_font_get_empty ();
1324
1325 hb_face_make_immutable (face);
1326 font->parent = hb_font_get_empty ();
1327 font->face = hb_face_reference (face);
1328 font->klass = hb_font_funcs_get_empty ();
1329 font->data.init0 (font);
1330 font->x_scale = font->y_scale = hb_face_get_upem (face);
1331
1332 return font;
1333}
1334
1335/**
1336 * hb_font_create: (Xconstructor)
1337 * @face: a face.
1338 *
1339 *
1340 *
1341 * Return value: (transfer full):
1342 *
1343 * Since: 0.9.2
1344 **/
1345hb_font_t *
1346hb_font_create (hb_face_t *face)
1347{
1348 hb_font_t *font = _hb_font_create (face);
1349
1350 /* Install our in-house, very lightweight, funcs. */
1351 hb_ot_font_set_funcs (font);
1352
1353 return font;
1354}
1355
1356/**
1357 * hb_font_create_sub_font:
1358 * @parent: parent font.
1359 *
1360 *
1361 *
1362 * Return value: (transfer full):
1363 *
1364 * Since: 0.9.2
1365 **/
1366hb_font_t *
1367hb_font_create_sub_font (hb_font_t *parent)
1368{
1369 if (unlikely (!parent))
1370 parent = hb_font_get_empty ();
1371
1372 hb_font_t *font = _hb_font_create (parent->face);
1373
1374 if (unlikely (hb_object_is_immutable (font)))
1375 return font;
1376
1377 font->parent = hb_font_reference (parent);
1378
1379 font->x_scale = parent->x_scale;
1380 font->y_scale = parent->y_scale;
1381 font->x_ppem = parent->x_ppem;
1382 font->y_ppem = parent->y_ppem;
1383 font->ptem = parent->ptem;
1384
1385 font->num_coords = parent->num_coords;
1386 if (!font->num_coords)
1387 font->coords = nullptr;
1388 else
1389 {
1390 unsigned int size = parent->num_coords * sizeof (parent->coords[0]);
1391 font->coords = (int *) malloc (size);
1392 if (unlikely (!font->coords))
1393 font->num_coords = 0;
1394 else
1395 memcpy (font->coords, parent->coords, size);
1396 }
1397
1398 return font;
1399}
1400
1401/**
1402 * hb_font_get_empty:
1403 *
1404 *
1405 *
1406 * Return value: (transfer full)
1407 *
1408 * Since: 0.9.2
1409 **/
1410hb_font_t *
1411hb_font_get_empty ()
1412{
1413 return const_cast<hb_font_t *> (&Null(hb_font_t));
1414}
1415
1416/**
1417 * hb_font_reference: (skip)
1418 * @font: a font.
1419 *
1420 *
1421 *
1422 * Return value: (transfer full):
1423 *
1424 * Since: 0.9.2
1425 **/
1426hb_font_t *
1427hb_font_reference (hb_font_t *font)
1428{
1429 return hb_object_reference (font);
1430}
1431
1432/**
1433 * hb_font_destroy: (skip)
1434 * @font: a font.
1435 *
1436 *
1437 *
1438 * Since: 0.9.2
1439 **/
1440void
1441hb_font_destroy (hb_font_t *font)
1442{
1443 if (!hb_object_destroy (font)) return;
1444
1445 font->data.fini ();
1446
1447 if (font->destroy)
1448 font->destroy (font->user_data);
1449
1450 hb_font_destroy (font->parent);
1451 hb_face_destroy (font->face);
1452 hb_font_funcs_destroy (font->klass);
1453
1454 free (font->coords);
1455
1456 free (font);
1457}
1458
1459/**
1460 * hb_font_set_user_data: (skip)
1461 * @font: a font.
1462 * @key:
1463 * @data:
1464 * @destroy:
1465 * @replace:
1466 *
1467 *
1468 *
1469 * Return value:
1470 *
1471 * Since: 0.9.2
1472 **/
1473hb_bool_t
1474hb_font_set_user_data (hb_font_t *font,
1475 hb_user_data_key_t *key,
1476 void * data,
1477 hb_destroy_func_t destroy,
1478 hb_bool_t replace)
1479{
1480 return hb_object_set_user_data (font, key, data, destroy, replace);
1481}
1482
1483/**
1484 * hb_font_get_user_data: (skip)
1485 * @font: a font.
1486 * @key:
1487 *
1488 *
1489 *
1490 * Return value: (transfer none):
1491 *
1492 * Since: 0.9.2
1493 **/
1494void *
1495hb_font_get_user_data (hb_font_t *font,
1496 hb_user_data_key_t *key)
1497{
1498 return hb_object_get_user_data (font, key);
1499}
1500
1501/**
1502 * hb_font_make_immutable:
1503 * @font: a font.
1504 *
1505 *
1506 *
1507 * Since: 0.9.2
1508 **/
1509void
1510hb_font_make_immutable (hb_font_t *font)
1511{
1512 if (hb_object_is_immutable (font))
1513 return;
1514
1515 if (font->parent)
1516 hb_font_make_immutable (font->parent);
1517
1518 hb_object_make_immutable (font);
1519}
1520
1521/**
1522 * hb_font_is_immutable:
1523 * @font: a font.
1524 *
1525 *
1526 *
1527 * Return value:
1528 *
1529 * Since: 0.9.2
1530 **/
1531hb_bool_t
1532hb_font_is_immutable (hb_font_t *font)
1533{
1534 return hb_object_is_immutable (font);
1535}
1536
1537/**
1538 * hb_font_set_parent:
1539 * @font: a font.
1540 * @parent: new parent.
1541 *
1542 * Sets parent font of @font.
1543 *
1544 * Since: 1.0.5
1545 **/
1546void
1547hb_font_set_parent (hb_font_t *font,
1548 hb_font_t *parent)
1549{
1550 if (hb_object_is_immutable (font))
1551 return;
1552
1553 if (!parent)
1554 parent = hb_font_get_empty ();
1555
1556 hb_font_t *old = font->parent;
1557
1558 font->parent = hb_font_reference (parent);
1559
1560 hb_font_destroy (old);
1561}
1562
1563/**
1564 * hb_font_get_parent:
1565 * @font: a font.
1566 *
1567 *
1568 *
1569 * Return value: (transfer none):
1570 *
1571 * Since: 0.9.2
1572 **/
1573hb_font_t *
1574hb_font_get_parent (hb_font_t *font)
1575{
1576 return font->parent;
1577}
1578
1579/**
1580 * hb_font_set_face:
1581 * @font: a font.
1582 * @face: new face.
1583 *
1584 * Sets font-face of @font.
1585 *
1586 * Since: 1.4.3
1587 **/
1588void
1589hb_font_set_face (hb_font_t *font,
1590 hb_face_t *face)
1591{
1592 if (hb_object_is_immutable (font))
1593 return;
1594
1595 if (unlikely (!face))
1596 face = hb_face_get_empty ();
1597
1598 hb_face_t *old = font->face;
1599
1600 font->face = hb_face_reference (face);
1601
1602 hb_face_destroy (old);
1603}
1604
1605/**
1606 * hb_font_get_face:
1607 * @font: a font.
1608 *
1609 *
1610 *
1611 * Return value: (transfer none):
1612 *
1613 * Since: 0.9.2
1614 **/
1615hb_face_t *
1616hb_font_get_face (hb_font_t *font)
1617{
1618 return font->face;
1619}
1620
1621
1622/**
1623 * hb_font_set_funcs:
1624 * @font: a font.
1625 * @klass: (closure font_data) (destroy destroy) (scope notified):
1626 * @font_data:
1627 * @destroy:
1628 *
1629 *
1630 *
1631 * Since: 0.9.2
1632 **/
1633void
1634hb_font_set_funcs (hb_font_t *font,
1635 hb_font_funcs_t *klass,
1636 void *font_data,
1637 hb_destroy_func_t destroy)
1638{
1639 if (hb_object_is_immutable (font))
1640 {
1641 if (destroy)
1642 destroy (font_data);
1643 return;
1644 }
1645
1646 if (font->destroy)
1647 font->destroy (font->user_data);
1648
1649 if (!klass)
1650 klass = hb_font_funcs_get_empty ();
1651
1652 hb_font_funcs_reference (klass);
1653 hb_font_funcs_destroy (font->klass);
1654 font->klass = klass;
1655 font->user_data = font_data;
1656 font->destroy = destroy;
1657}
1658
1659/**
1660 * hb_font_set_funcs_data:
1661 * @font: a font.
1662 * @font_data: (destroy destroy) (scope notified):
1663 * @destroy:
1664 *
1665 *
1666 *
1667 * Since: 0.9.2
1668 **/
1669void
1670hb_font_set_funcs_data (hb_font_t *font,
1671 void *font_data,
1672 hb_destroy_func_t destroy)
1673{
1674 /* Destroy user_data? */
1675 if (hb_object_is_immutable (font))
1676 {
1677 if (destroy)
1678 destroy (font_data);
1679 return;
1680 }
1681
1682 if (font->destroy)
1683 font->destroy (font->user_data);
1684
1685 font->user_data = font_data;
1686 font->destroy = destroy;
1687}
1688
1689
1690/**
1691 * hb_font_set_scale:
1692 * @font: a font.
1693 * @x_scale:
1694 * @y_scale:
1695 *
1696 *
1697 *
1698 * Since: 0.9.2
1699 **/
1700void
1701hb_font_set_scale (hb_font_t *font,
1702 int x_scale,
1703 int y_scale)
1704{
1705 if (hb_object_is_immutable (font))
1706 return;
1707
1708 font->x_scale = x_scale;
1709 font->y_scale = y_scale;
1710}
1711
1712/**
1713 * hb_font_get_scale:
1714 * @font: a font.
1715 * @x_scale: (out):
1716 * @y_scale: (out):
1717 *
1718 *
1719 *
1720 * Since: 0.9.2
1721 **/
1722void
1723hb_font_get_scale (hb_font_t *font,
1724 int *x_scale,
1725 int *y_scale)
1726{
1727 if (x_scale) *x_scale = font->x_scale;
1728 if (y_scale) *y_scale = font->y_scale;
1729}
1730
1731/**
1732 * hb_font_set_ppem:
1733 * @font: a font.
1734 * @x_ppem:
1735 * @y_ppem:
1736 *
1737 *
1738 *
1739 * Since: 0.9.2
1740 **/
1741void
1742hb_font_set_ppem (hb_font_t *font,
1743 unsigned int x_ppem,
1744 unsigned int y_ppem)
1745{
1746 if (hb_object_is_immutable (font))
1747 return;
1748
1749 font->x_ppem = x_ppem;
1750 font->y_ppem = y_ppem;
1751}
1752
1753/**
1754 * hb_font_get_ppem:
1755 * @font: a font.
1756 * @x_ppem: (out):
1757 * @y_ppem: (out):
1758 *
1759 *
1760 *
1761 * Since: 0.9.2
1762 **/
1763void
1764hb_font_get_ppem (hb_font_t *font,
1765 unsigned int *x_ppem,
1766 unsigned int *y_ppem)
1767{
1768 if (x_ppem) *x_ppem = font->x_ppem;
1769 if (y_ppem) *y_ppem = font->y_ppem;
1770}
1771
1772/**
1773 * hb_font_set_ptem:
1774 * @font: a font.
1775 * @ptem: font size in points.
1776 *
1777 * Sets "point size" of the font. Set to 0 to unset.
1778 *
1779 * There are 72 points in an inch.
1780 *
1781 * Since: 1.6.0
1782 **/
1783void
1784hb_font_set_ptem (hb_font_t *font, float ptem)
1785{
1786 if (hb_object_is_immutable (font))
1787 return;
1788
1789 font->ptem = ptem;
1790}
1791
1792/**
1793 * hb_font_get_ptem:
1794 * @font: a font.
1795 *
1796 * Gets the "point size" of the font. A value of 0 means unset.
1797 *
1798 * Return value: Point size.
1799 *
1800 * Since: 0.9.2
1801 **/
1802float
1803hb_font_get_ptem (hb_font_t *font)
1804{
1805 return font->ptem;
1806}
1807
1808/*
1809 * Variations
1810 */
1811
1812static void
1813_hb_font_adopt_var_coords_normalized (hb_font_t *font,
1814 int *coords, /* 2.14 normalized */
1815 unsigned int coords_length)
1816{
1817 free (font->coords);
1818
1819 font->coords = coords;
1820 font->num_coords = coords_length;
1821}
1822
1823/**
1824 * hb_font_set_variations:
1825 *
1826 * Since: 1.4.2
1827 */
1828void
1829hb_font_set_variations (hb_font_t *font,
1830 const hb_variation_t *variations,
1831 unsigned int variations_length)
1832{
1833 if (hb_object_is_immutable (font))
1834 return;
1835
1836 if (!variations_length)
1837 {
1838 hb_font_set_var_coords_normalized (font, nullptr, 0);
1839 return;
1840 }
1841
1842 unsigned int coords_length = hb_ot_var_get_axis_count (font->face);
1843
1844 int *normalized = coords_length ? (int *) calloc (coords_length, sizeof (int)) : nullptr;
1845 if (unlikely (coords_length && !normalized))
1846 return;
1847
1848 hb_ot_var_normalize_variations (font->face,
1849 variations, variations_length,
1850 normalized, coords_length);
1851 _hb_font_adopt_var_coords_normalized (font, normalized, coords_length);
1852}
1853
1854/**
1855 * hb_font_set_var_coords_design:
1856 *
1857 * Since: 1.4.2
1858 */
1859void
1860hb_font_set_var_coords_design (hb_font_t *font,
1861 const float *coords,
1862 unsigned int coords_length)
1863{
1864 if (hb_object_is_immutable (font))
1865 return;
1866
1867 int *normalized = coords_length ? (int *) calloc (coords_length, sizeof (int)) : nullptr;
1868 if (unlikely (coords_length && !normalized))
1869 return;
1870
1871 hb_ot_var_normalize_coords (font->face, coords_length, coords, normalized);
1872 _hb_font_adopt_var_coords_normalized (font, normalized, coords_length);
1873}
1874
1875/**
1876 * hb_font_set_var_coords_normalized:
1877 *
1878 * Since: 1.4.2
1879 */
1880void
1881hb_font_set_var_coords_normalized (hb_font_t *font,
1882 const int *coords, /* 2.14 normalized */
1883 unsigned int coords_length)
1884{
1885 if (hb_object_is_immutable (font))
1886 return;
1887
1888 int *copy = coords_length ? (int *) calloc (coords_length, sizeof (coords[0])) : nullptr;
1889 if (unlikely (coords_length && !copy))
1890 return;
1891
1892 if (coords_length)
1893 memcpy (copy, coords, coords_length * sizeof (coords[0]));
1894
1895 _hb_font_adopt_var_coords_normalized (font, copy, coords_length);
1896}
1897
1898/**
1899 * hb_font_get_var_coords_normalized:
1900 *
1901 * Return value is valid as long as variation coordinates of the font
1902 * are not modified.
1903 *
1904 * Since: 1.4.2
1905 */
1906const int *
1907hb_font_get_var_coords_normalized (hb_font_t *font,
1908 unsigned int *length)
1909{
1910 if (length)
1911 *length = font->num_coords;
1912
1913 return font->coords;
1914}
1915
1916
1917/*
1918 * Deprecated get_glyph_func():
1919 */
1920
1921struct hb_trampoline_closure_t
1922{
1923 void *user_data;
1924 hb_destroy_func_t destroy;
1925 unsigned int ref_count;
1926};
1927
1928template <typename FuncType>
1929struct hb_trampoline_t
1930{
1931 hb_trampoline_closure_t closure; /* Must be first. */
1932 FuncType func;
1933};
1934
1935template <typename FuncType>
1936static hb_trampoline_t<FuncType> *
1937trampoline_create (FuncType func,
1938 void *user_data,
1939 hb_destroy_func_t destroy)
1940{
1941 typedef hb_trampoline_t<FuncType> trampoline_t;
1942
1943 trampoline_t *trampoline = (trampoline_t *) calloc (1, sizeof (trampoline_t));
1944
1945 if (unlikely (!trampoline))
1946 return nullptr;
1947
1948 trampoline->closure.user_data = user_data;
1949 trampoline->closure.destroy = destroy;
1950 trampoline->closure.ref_count = 1;
1951 trampoline->func = func;
1952
1953 return trampoline;
1954}
1955
1956static void
1957trampoline_reference (hb_trampoline_closure_t *closure)
1958{
1959 closure->ref_count++;
1960}
1961
1962static void
1963trampoline_destroy (void *user_data)
1964{
1965 hb_trampoline_closure_t *closure = (hb_trampoline_closure_t *) user_data;
1966
1967 if (--closure->ref_count)
1968 return;
1969
1970 if (closure->destroy)
1971 closure->destroy (closure->user_data);
1972 free (closure);
1973}
1974
1975typedef hb_trampoline_t<hb_font_get_glyph_func_t> hb_font_get_glyph_trampoline_t;
1976
1977static hb_bool_t
1978hb_font_get_nominal_glyph_trampoline (hb_font_t *font,
1979 void *font_data,
1980 hb_codepoint_t unicode,
1981 hb_codepoint_t *glyph,
1982 void *user_data)
1983{
1984 hb_font_get_glyph_trampoline_t *trampoline = (hb_font_get_glyph_trampoline_t *) user_data;
1985 return trampoline->func (font, font_data, unicode, 0, glyph, trampoline->closure.user_data);
1986}
1987
1988static hb_bool_t
1989hb_font_get_variation_glyph_trampoline (hb_font_t *font,
1990 void *font_data,
1991 hb_codepoint_t unicode,
1992 hb_codepoint_t variation_selector,
1993 hb_codepoint_t *glyph,
1994 void *user_data)
1995{
1996 hb_font_get_glyph_trampoline_t *trampoline = (hb_font_get_glyph_trampoline_t *) user_data;
1997 return trampoline->func (font, font_data, unicode, variation_selector, glyph, trampoline->closure.user_data);
1998}
1999
2000/**
2001 * hb_font_funcs_set_glyph_func:
2002 * @ffuncs: font functions.
2003 * @func: (closure user_data) (destroy destroy) (scope notified): callback function.
2004 * @user_data: data to pass to @func.
2005 * @destroy: function to call when @user_data is not needed anymore.
2006 *
2007 * Deprecated. Use hb_font_funcs_set_nominal_glyph_func() and
2008 * hb_font_funcs_set_variation_glyph_func() instead.
2009 *
2010 * Since: 0.9.2
2011 * Deprecated: 1.2.3
2012 **/
2013void
2014hb_font_funcs_set_glyph_func (hb_font_funcs_t *ffuncs,
2015 hb_font_get_glyph_func_t func,
2016 void *user_data, hb_destroy_func_t destroy)
2017{
2018 hb_font_get_glyph_trampoline_t *trampoline;
2019
2020 trampoline = trampoline_create (func, user_data, destroy);
2021 if (unlikely (!trampoline))
2022 {
2023 if (destroy)
2024 destroy (user_data);
2025 return;
2026 }
2027
2028 hb_font_funcs_set_nominal_glyph_func (ffuncs,
2029 hb_font_get_nominal_glyph_trampoline,
2030 trampoline,
2031 trampoline_destroy);
2032
2033 trampoline_reference (&trampoline->closure);
2034 hb_font_funcs_set_variation_glyph_func (ffuncs,
2035 hb_font_get_variation_glyph_trampoline,
2036 trampoline,
2037 trampoline_destroy);
2038}
2039