• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright © 2009  Red Hat, 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 
27 #ifndef HB_H_IN
28 #error "Include <hb.h> instead."
29 #endif
30 
31 #ifndef HB_FONT_H
32 #define HB_FONT_H
33 
34 #include "hb-common.h"
35 #include "hb-face.h"
36 
37 HB_BEGIN_DECLS
38 
39 
40 typedef struct hb_font_t hb_font_t;
41 
42 
43 /*
44  * hb_font_funcs_t
45  */
46 
47 typedef struct hb_font_funcs_t hb_font_funcs_t;
48 
49 HB_EXTERN hb_font_funcs_t *
50 hb_font_funcs_create (void);
51 
52 HB_EXTERN hb_font_funcs_t *
53 hb_font_funcs_get_empty (void);
54 
55 HB_EXTERN hb_font_funcs_t *
56 hb_font_funcs_reference (hb_font_funcs_t *ffuncs);
57 
58 HB_EXTERN void
59 hb_font_funcs_destroy (hb_font_funcs_t *ffuncs);
60 
61 HB_EXTERN hb_bool_t
62 hb_font_funcs_set_user_data (hb_font_funcs_t    *ffuncs,
63 			     hb_user_data_key_t *key,
64 			     void *              data,
65 			     hb_destroy_func_t   destroy,
66 			     hb_bool_t           replace);
67 
68 
69 HB_EXTERN void *
70 hb_font_funcs_get_user_data (hb_font_funcs_t    *ffuncs,
71 			     hb_user_data_key_t *key);
72 
73 
74 HB_EXTERN void
75 hb_font_funcs_make_immutable (hb_font_funcs_t *ffuncs);
76 
77 HB_EXTERN hb_bool_t
78 hb_font_funcs_is_immutable (hb_font_funcs_t *ffuncs);
79 
80 
81 /* font and glyph extents */
82 
83 /* Note that typically ascender is positive and descender negative in coordinate systems that grow up. */
84 typedef struct hb_font_extents_t
85 {
86   hb_position_t ascender; /* typographic ascender. */
87   hb_position_t descender; /* typographic descender. */
88   hb_position_t line_gap; /* suggested line spacing gap. */
89   /*< private >*/
90   hb_position_t reserved9;
91   hb_position_t reserved8;
92   hb_position_t reserved7;
93   hb_position_t reserved6;
94   hb_position_t reserved5;
95   hb_position_t reserved4;
96   hb_position_t reserved3;
97   hb_position_t reserved2;
98   hb_position_t reserved1;
99 } hb_font_extents_t;
100 
101 /* Note that height is negative in coordinate systems that grow up. */
102 typedef struct hb_glyph_extents_t
103 {
104   hb_position_t x_bearing; /* left side of glyph from origin. */
105   hb_position_t y_bearing; /* top side of glyph from origin. */
106   hb_position_t width; /* distance from left to right side. */
107   hb_position_t height; /* distance from top to bottom side. */
108 } hb_glyph_extents_t;
109 
110 /* func types */
111 
112 typedef hb_bool_t (*hb_font_get_font_extents_func_t) (hb_font_t *font, void *font_data,
113 						       hb_font_extents_t *extents,
114 						       void *user_data);
115 typedef hb_font_get_font_extents_func_t hb_font_get_font_h_extents_func_t;
116 typedef hb_font_get_font_extents_func_t hb_font_get_font_v_extents_func_t;
117 
118 
119 typedef hb_bool_t (*hb_font_get_nominal_glyph_func_t) (hb_font_t *font, void *font_data,
120 						       hb_codepoint_t unicode,
121 						       hb_codepoint_t *glyph,
122 						       void *user_data);
123 typedef hb_bool_t (*hb_font_get_variation_glyph_func_t) (hb_font_t *font, void *font_data,
124 							 hb_codepoint_t unicode, hb_codepoint_t variation_selector,
125 							 hb_codepoint_t *glyph,
126 							 void *user_data);
127 
128 typedef unsigned int (*hb_font_get_nominal_glyphs_func_t) (hb_font_t *font, void *font_data,
129 							   unsigned int count,
130 							   const hb_codepoint_t *first_unicode,
131 							   unsigned int unicode_stride,
132 							   hb_codepoint_t *first_glyph,
133 							   unsigned int glyph_stride,
134 							   void *user_data);
135 
136 
137 typedef hb_position_t (*hb_font_get_glyph_advance_func_t) (hb_font_t *font, void *font_data,
138 							   hb_codepoint_t glyph,
139 							   void *user_data);
140 typedef hb_font_get_glyph_advance_func_t hb_font_get_glyph_h_advance_func_t;
141 typedef hb_font_get_glyph_advance_func_t hb_font_get_glyph_v_advance_func_t;
142 
143 typedef void (*hb_font_get_glyph_advances_func_t) (hb_font_t* font, void* font_data,
144 						   unsigned int count,
145 						   const hb_codepoint_t *first_glyph,
146 						   unsigned glyph_stride,
147 						   hb_position_t *first_advance,
148 						   unsigned advance_stride,
149 						   void *user_data);
150 typedef hb_font_get_glyph_advances_func_t hb_font_get_glyph_h_advances_func_t;
151 typedef hb_font_get_glyph_advances_func_t hb_font_get_glyph_v_advances_func_t;
152 
153 typedef hb_bool_t (*hb_font_get_glyph_origin_func_t) (hb_font_t *font, void *font_data,
154 						      hb_codepoint_t glyph,
155 						      hb_position_t *x, hb_position_t *y,
156 						      void *user_data);
157 typedef hb_font_get_glyph_origin_func_t hb_font_get_glyph_h_origin_func_t;
158 typedef hb_font_get_glyph_origin_func_t hb_font_get_glyph_v_origin_func_t;
159 
160 
161 typedef hb_bool_t (*hb_font_get_glyph_extents_func_t) (hb_font_t *font, void *font_data,
162 						       hb_codepoint_t glyph,
163 						       hb_glyph_extents_t *extents,
164 						       void *user_data);
165 typedef hb_bool_t (*hb_font_get_glyph_contour_point_func_t) (hb_font_t *font, void *font_data,
166 							     hb_codepoint_t glyph, unsigned int point_index,
167 							     hb_position_t *x, hb_position_t *y,
168 							     void *user_data);
169 
170 
171 typedef hb_bool_t (*hb_font_get_glyph_name_func_t) (hb_font_t *font, void *font_data,
172 						    hb_codepoint_t glyph,
173 						    char *name, unsigned int size,
174 						    void *user_data);
175 typedef hb_bool_t (*hb_font_get_glyph_from_name_func_t) (hb_font_t *font, void *font_data,
176 							 const char *name, int len, /* -1 means nul-terminated */
177 							 hb_codepoint_t *glyph,
178 							 void *user_data);
179 
180 
181 /* func setters */
182 
183 /**
184  * hb_font_funcs_set_font_h_extents_func:
185  * @ffuncs: font functions.
186  * @func: (closure user_data) (destroy destroy) (scope notified):
187  * @user_data:
188  * @destroy:
189  *
190  *
191  *
192  * Since: 1.1.2
193  **/
194 HB_EXTERN void
195 hb_font_funcs_set_font_h_extents_func (hb_font_funcs_t *ffuncs,
196 				       hb_font_get_font_h_extents_func_t func,
197 				       void *user_data, hb_destroy_func_t destroy);
198 
199 /**
200  * hb_font_funcs_set_font_v_extents_func:
201  * @ffuncs: font functions.
202  * @func: (closure user_data) (destroy destroy) (scope notified):
203  * @user_data:
204  * @destroy:
205  *
206  *
207  *
208  * Since: 1.1.2
209  **/
210 HB_EXTERN void
211 hb_font_funcs_set_font_v_extents_func (hb_font_funcs_t *ffuncs,
212 				       hb_font_get_font_v_extents_func_t func,
213 				       void *user_data, hb_destroy_func_t destroy);
214 
215 /**
216  * hb_font_funcs_set_nominal_glyph_func:
217  * @ffuncs: font functions.
218  * @func: (closure user_data) (destroy destroy) (scope notified):
219  * @user_data:
220  * @destroy:
221  *
222  *
223  *
224  * Since: 1.2.3
225  **/
226 HB_EXTERN void
227 hb_font_funcs_set_nominal_glyph_func (hb_font_funcs_t *ffuncs,
228 				      hb_font_get_nominal_glyph_func_t func,
229 				      void *user_data, hb_destroy_func_t destroy);
230 
231 /**
232  * hb_font_funcs_set_nominal_glyphs_func:
233  * @ffuncs: font functions.
234  * @func: (closure user_data) (destroy destroy) (scope notified):
235  * @user_data:
236  * @destroy:
237  *
238  *
239  *
240  * Since: 2.0.0
241  **/
242 HB_EXTERN void
243 hb_font_funcs_set_nominal_glyphs_func (hb_font_funcs_t *ffuncs,
244 				       hb_font_get_nominal_glyphs_func_t func,
245 				       void *user_data, hb_destroy_func_t destroy);
246 
247 /**
248  * hb_font_funcs_set_variation_glyph_func:
249  * @ffuncs: font functions.
250  * @func: (closure user_data) (destroy destroy) (scope notified):
251  * @user_data:
252  * @destroy:
253  *
254  *
255  *
256  * Since: 1.2.3
257  **/
258 HB_EXTERN void
259 hb_font_funcs_set_variation_glyph_func (hb_font_funcs_t *ffuncs,
260 					hb_font_get_variation_glyph_func_t func,
261 					void *user_data, hb_destroy_func_t destroy);
262 
263 /**
264  * hb_font_funcs_set_glyph_h_advance_func:
265  * @ffuncs: font functions.
266  * @func: (closure user_data) (destroy destroy) (scope notified):
267  * @user_data:
268  * @destroy:
269  *
270  *
271  *
272  * Since: 0.9.2
273  **/
274 HB_EXTERN void
275 hb_font_funcs_set_glyph_h_advance_func (hb_font_funcs_t *ffuncs,
276 					hb_font_get_glyph_h_advance_func_t func,
277 					void *user_data, hb_destroy_func_t destroy);
278 
279 /**
280  * hb_font_funcs_set_glyph_v_advance_func:
281  * @ffuncs: font functions.
282  * @func: (closure user_data) (destroy destroy) (scope notified):
283  * @user_data:
284  * @destroy:
285  *
286  *
287  *
288  * Since: 0.9.2
289  **/
290 HB_EXTERN void
291 hb_font_funcs_set_glyph_v_advance_func (hb_font_funcs_t *ffuncs,
292 					hb_font_get_glyph_v_advance_func_t func,
293 					void *user_data, hb_destroy_func_t destroy);
294 
295 /**
296  * hb_font_funcs_set_glyph_h_advances_func:
297  * @ffuncs: font functions.
298  * @func: (closure user_data) (destroy destroy) (scope notified):
299  * @user_data:
300  * @destroy:
301  *
302  *
303  *
304  * Since: 1.8.6
305  **/
306 HB_EXTERN void
307 hb_font_funcs_set_glyph_h_advances_func (hb_font_funcs_t *ffuncs,
308 					hb_font_get_glyph_h_advances_func_t func,
309 					void *user_data, hb_destroy_func_t destroy);
310 
311 /**
312  * hb_font_funcs_set_glyph_v_advances_func:
313  * @ffuncs: font functions.
314  * @func: (closure user_data) (destroy destroy) (scope notified):
315  * @user_data:
316  * @destroy:
317  *
318  *
319  *
320  * Since: 1.8.6
321  **/
322 HB_EXTERN void
323 hb_font_funcs_set_glyph_v_advances_func (hb_font_funcs_t *ffuncs,
324 					hb_font_get_glyph_v_advances_func_t func,
325 					void *user_data, hb_destroy_func_t destroy);
326 
327 /**
328  * hb_font_funcs_set_glyph_h_origin_func:
329  * @ffuncs: font functions.
330  * @func: (closure user_data) (destroy destroy) (scope notified):
331  * @user_data:
332  * @destroy:
333  *
334  *
335  *
336  * Since: 0.9.2
337  **/
338 HB_EXTERN void
339 hb_font_funcs_set_glyph_h_origin_func (hb_font_funcs_t *ffuncs,
340 				       hb_font_get_glyph_h_origin_func_t func,
341 				       void *user_data, hb_destroy_func_t destroy);
342 
343 /**
344  * hb_font_funcs_set_glyph_v_origin_func:
345  * @ffuncs: font functions.
346  * @func: (closure user_data) (destroy destroy) (scope notified):
347  * @user_data:
348  * @destroy:
349  *
350  *
351  *
352  * Since: 0.9.2
353  **/
354 HB_EXTERN void
355 hb_font_funcs_set_glyph_v_origin_func (hb_font_funcs_t *ffuncs,
356 				       hb_font_get_glyph_v_origin_func_t func,
357 				       void *user_data, hb_destroy_func_t destroy);
358 
359 /**
360  * hb_font_funcs_set_glyph_extents_func:
361  * @ffuncs: font functions.
362  * @func: (closure user_data) (destroy destroy) (scope notified):
363  * @user_data:
364  * @destroy:
365  *
366  *
367  *
368  * Since: 0.9.2
369  **/
370 HB_EXTERN void
371 hb_font_funcs_set_glyph_extents_func (hb_font_funcs_t *ffuncs,
372 				      hb_font_get_glyph_extents_func_t func,
373 				      void *user_data, hb_destroy_func_t destroy);
374 
375 /**
376  * hb_font_funcs_set_glyph_contour_point_func:
377  * @ffuncs: font functions.
378  * @func: (closure user_data) (destroy destroy) (scope notified):
379  * @user_data:
380  * @destroy:
381  *
382  *
383  *
384  * Since: 0.9.2
385  **/
386 HB_EXTERN void
387 hb_font_funcs_set_glyph_contour_point_func (hb_font_funcs_t *ffuncs,
388 					    hb_font_get_glyph_contour_point_func_t func,
389 					    void *user_data, hb_destroy_func_t destroy);
390 
391 /**
392  * hb_font_funcs_set_glyph_name_func:
393  * @ffuncs: font functions.
394  * @func: (closure user_data) (destroy destroy) (scope notified):
395  * @user_data:
396  * @destroy:
397  *
398  *
399  *
400  * Since: 0.9.2
401  **/
402 HB_EXTERN void
403 hb_font_funcs_set_glyph_name_func (hb_font_funcs_t *ffuncs,
404 				   hb_font_get_glyph_name_func_t func,
405 				   void *user_data, hb_destroy_func_t destroy);
406 
407 /**
408  * hb_font_funcs_set_glyph_from_name_func:
409  * @ffuncs: font functions.
410  * @func: (closure user_data) (destroy destroy) (scope notified):
411  * @user_data:
412  * @destroy:
413  *
414  *
415  *
416  * Since: 0.9.2
417  **/
418 HB_EXTERN void
419 hb_font_funcs_set_glyph_from_name_func (hb_font_funcs_t *ffuncs,
420 					hb_font_get_glyph_from_name_func_t func,
421 					void *user_data, hb_destroy_func_t destroy);
422 
423 /* func dispatch */
424 
425 HB_EXTERN hb_bool_t
426 hb_font_get_h_extents (hb_font_t *font,
427 		       hb_font_extents_t *extents);
428 HB_EXTERN hb_bool_t
429 hb_font_get_v_extents (hb_font_t *font,
430 		       hb_font_extents_t *extents);
431 
432 HB_EXTERN hb_bool_t
433 hb_font_get_nominal_glyph (hb_font_t *font,
434 			   hb_codepoint_t unicode,
435 			   hb_codepoint_t *glyph);
436 HB_EXTERN hb_bool_t
437 hb_font_get_variation_glyph (hb_font_t *font,
438 			     hb_codepoint_t unicode, hb_codepoint_t variation_selector,
439 			     hb_codepoint_t *glyph);
440 
441 HB_EXTERN hb_position_t
442 hb_font_get_glyph_h_advance (hb_font_t *font,
443 			     hb_codepoint_t glyph);
444 HB_EXTERN hb_position_t
445 hb_font_get_glyph_v_advance (hb_font_t *font,
446 			     hb_codepoint_t glyph);
447 
448 HB_EXTERN void
449 hb_font_get_glyph_h_advances (hb_font_t* font,
450 			      unsigned int count,
451 			      const hb_codepoint_t *first_glyph,
452 			      unsigned glyph_stride,
453 			      hb_position_t *first_advance,
454 			      unsigned advance_stride);
455 HB_EXTERN void
456 hb_font_get_glyph_v_advances (hb_font_t* font,
457 			      unsigned int count,
458 			      const hb_codepoint_t *first_glyph,
459 			      unsigned glyph_stride,
460 			      hb_position_t *first_advance,
461 			      unsigned advance_stride);
462 
463 HB_EXTERN hb_bool_t
464 hb_font_get_glyph_h_origin (hb_font_t *font,
465 			    hb_codepoint_t glyph,
466 			    hb_position_t *x, hb_position_t *y);
467 HB_EXTERN hb_bool_t
468 hb_font_get_glyph_v_origin (hb_font_t *font,
469 			    hb_codepoint_t glyph,
470 			    hb_position_t *x, hb_position_t *y);
471 
472 HB_EXTERN hb_bool_t
473 hb_font_get_glyph_extents (hb_font_t *font,
474 			   hb_codepoint_t glyph,
475 			   hb_glyph_extents_t *extents);
476 
477 HB_EXTERN hb_bool_t
478 hb_font_get_glyph_contour_point (hb_font_t *font,
479 				 hb_codepoint_t glyph, unsigned int point_index,
480 				 hb_position_t *x, hb_position_t *y);
481 
482 HB_EXTERN hb_bool_t
483 hb_font_get_glyph_name (hb_font_t *font,
484 			hb_codepoint_t glyph,
485 			char *name, unsigned int size);
486 HB_EXTERN hb_bool_t
487 hb_font_get_glyph_from_name (hb_font_t *font,
488 			     const char *name, int len, /* -1 means nul-terminated */
489 			     hb_codepoint_t *glyph);
490 
491 
492 /* high-level funcs, with fallback */
493 
494 /* Calls either hb_font_get_nominal_glyph() if variation_selector is 0,
495  * otherwise calls hb_font_get_variation_glyph(). */
496 HB_EXTERN hb_bool_t
497 hb_font_get_glyph (hb_font_t *font,
498 		   hb_codepoint_t unicode, hb_codepoint_t variation_selector,
499 		   hb_codepoint_t *glyph);
500 
501 HB_EXTERN void
502 hb_font_get_extents_for_direction (hb_font_t *font,
503 				   hb_direction_t direction,
504 				   hb_font_extents_t *extents);
505 HB_EXTERN void
506 hb_font_get_glyph_advance_for_direction (hb_font_t *font,
507 					 hb_codepoint_t glyph,
508 					 hb_direction_t direction,
509 					 hb_position_t *x, hb_position_t *y);
510 HB_EXTERN void
511 hb_font_get_glyph_advances_for_direction (hb_font_t* font,
512 					  hb_direction_t direction,
513 					  unsigned int count,
514 					  const hb_codepoint_t *first_glyph,
515 					  unsigned glyph_stride,
516 					  hb_position_t *first_advance,
517 					  unsigned advance_stride);
518 HB_EXTERN void
519 hb_font_get_glyph_origin_for_direction (hb_font_t *font,
520 					hb_codepoint_t glyph,
521 					hb_direction_t direction,
522 					hb_position_t *x, hb_position_t *y);
523 HB_EXTERN void
524 hb_font_add_glyph_origin_for_direction (hb_font_t *font,
525 					hb_codepoint_t glyph,
526 					hb_direction_t direction,
527 					hb_position_t *x, hb_position_t *y);
528 HB_EXTERN void
529 hb_font_subtract_glyph_origin_for_direction (hb_font_t *font,
530 					     hb_codepoint_t glyph,
531 					     hb_direction_t direction,
532 					     hb_position_t *x, hb_position_t *y);
533 
534 HB_EXTERN hb_bool_t
535 hb_font_get_glyph_extents_for_origin (hb_font_t *font,
536 				      hb_codepoint_t glyph,
537 				      hb_direction_t direction,
538 				      hb_glyph_extents_t *extents);
539 
540 HB_EXTERN hb_bool_t
541 hb_font_get_glyph_contour_point_for_origin (hb_font_t *font,
542 					    hb_codepoint_t glyph, unsigned int point_index,
543 					    hb_direction_t direction,
544 					    hb_position_t *x, hb_position_t *y);
545 
546 /* Generates gidDDD if glyph has no name. */
547 HB_EXTERN void
548 hb_font_glyph_to_string (hb_font_t *font,
549 			 hb_codepoint_t glyph,
550 			 char *s, unsigned int size);
551 /* Parses gidDDD and uniUUUU strings automatically. */
552 HB_EXTERN hb_bool_t
553 hb_font_glyph_from_string (hb_font_t *font,
554 			   const char *s, int len, /* -1 means nul-terminated */
555 			   hb_codepoint_t *glyph);
556 
557 
558 /*
559  * hb_font_t
560  */
561 
562 /* Fonts are very light-weight objects */
563 
564 HB_EXTERN hb_font_t *
565 hb_font_create (hb_face_t *face);
566 
567 HB_EXTERN hb_font_t *
568 hb_font_create_sub_font (hb_font_t *parent);
569 
570 HB_EXTERN hb_font_t *
571 hb_font_get_empty (void);
572 
573 HB_EXTERN hb_font_t *
574 hb_font_reference (hb_font_t *font);
575 
576 HB_EXTERN void
577 hb_font_destroy (hb_font_t *font);
578 
579 HB_EXTERN hb_bool_t
580 hb_font_set_user_data (hb_font_t          *font,
581 		       hb_user_data_key_t *key,
582 		       void *              data,
583 		       hb_destroy_func_t   destroy,
584 		       hb_bool_t           replace);
585 
586 
587 HB_EXTERN void *
588 hb_font_get_user_data (hb_font_t          *font,
589 		       hb_user_data_key_t *key);
590 
591 HB_EXTERN void
592 hb_font_make_immutable (hb_font_t *font);
593 
594 HB_EXTERN hb_bool_t
595 hb_font_is_immutable (hb_font_t *font);
596 
597 HB_EXTERN void
598 hb_font_set_parent (hb_font_t *font,
599 		    hb_font_t *parent);
600 
601 HB_EXTERN hb_font_t *
602 hb_font_get_parent (hb_font_t *font);
603 
604 HB_EXTERN void
605 hb_font_set_face (hb_font_t *font,
606 		  hb_face_t *face);
607 
608 HB_EXTERN hb_face_t *
609 hb_font_get_face (hb_font_t *font);
610 
611 
612 HB_EXTERN void
613 hb_font_set_funcs (hb_font_t         *font,
614 		   hb_font_funcs_t   *klass,
615 		   void              *font_data,
616 		   hb_destroy_func_t  destroy);
617 
618 /* Be *very* careful with this function! */
619 HB_EXTERN void
620 hb_font_set_funcs_data (hb_font_t         *font,
621 		        void              *font_data,
622 		        hb_destroy_func_t  destroy);
623 
624 
625 HB_EXTERN void
626 hb_font_set_scale (hb_font_t *font,
627 		   int x_scale,
628 		   int y_scale);
629 
630 HB_EXTERN void
631 hb_font_get_scale (hb_font_t *font,
632 		   int *x_scale,
633 		   int *y_scale);
634 
635 /*
636  * A zero value means "no hinting in that direction"
637  */
638 HB_EXTERN void
639 hb_font_set_ppem (hb_font_t *font,
640 		  unsigned int x_ppem,
641 		  unsigned int y_ppem);
642 
643 HB_EXTERN void
644 hb_font_get_ppem (hb_font_t *font,
645 		  unsigned int *x_ppem,
646 		  unsigned int *y_ppem);
647 
648 /*
649  * Point size per EM.  Used for optical-sizing in CoreText.
650  * A value of zero means "not set".
651  */
652 HB_EXTERN void
653 hb_font_set_ptem (hb_font_t *font, float ptem);
654 
655 HB_EXTERN float
656 hb_font_get_ptem (hb_font_t *font);
657 
658 HB_EXTERN void
659 hb_font_set_variations (hb_font_t *font,
660 			const hb_variation_t *variations,
661 			unsigned int variations_length);
662 
663 HB_EXTERN void
664 hb_font_set_var_coords_design (hb_font_t *font,
665 			       const float *coords,
666 			       unsigned int coords_length);
667 
668 HB_EXTERN void
669 hb_font_set_var_coords_normalized (hb_font_t *font,
670 				   const int *coords, /* 2.14 normalized */
671 				   unsigned int coords_length);
672 
673 HB_EXTERN const int *
674 hb_font_get_var_coords_normalized (hb_font_t *font,
675 				   unsigned int *length);
676 
677 HB_END_DECLS
678 
679 #endif /* HB_FONT_H */
680