1 /*
2 * Copyright © 2019 Ebrahim Byagowi
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
25 #include "hb.hh"
26
27 #ifndef HB_NO_META
28
29 #include "hb-ot-meta-table.hh"
30
31 /**
32 * SECTION:hb-ot-meta
33 * @title: hb-ot-meta
34 * @short_description: OpenType Metadata
35 * @include: hb-ot.h
36 *
37 * Functions for fetching metadata from fonts.
38 **/
39
40 /**
41 * hb_ot_meta_get_entry_tags:
42 * @face: a face object
43 * @start_offset: iteration's start offset
44 * @entries_count:(inout) (optional): buffer size as input, filled size as output
45 * @entries: (out caller-allocates) (array length=entries_count): entries tags buffer
46 *
47 * Fetches all available feature types.
48 *
49 * Return value: Number of all available feature types.
50 *
51 * Since: 2.6.0
52 **/
53 unsigned int
hb_ot_meta_get_entry_tags(hb_face_t * face,unsigned int start_offset,unsigned int * entries_count,hb_ot_meta_tag_t * entries)54 hb_ot_meta_get_entry_tags (hb_face_t *face,
55 unsigned int start_offset,
56 unsigned int *entries_count, /* IN/OUT. May be NULL. */
57 hb_ot_meta_tag_t *entries /* OUT. May be NULL. */)
58 {
59 return face->table.meta->get_entries (start_offset, entries_count, entries);
60 }
61
62 /**
63 * hb_ot_meta_reference_entry:
64 * @face: a #hb_face_t object.
65 * @meta_tag: tag of metadata you like to have.
66 *
67 * It fetches metadata entry of a given tag from a font.
68 *
69 * Returns: (transfer full): A blob containing the blob.
70 *
71 * Since: 2.6.0
72 **/
73 hb_blob_t *
hb_ot_meta_reference_entry(hb_face_t * face,hb_ot_meta_tag_t meta_tag)74 hb_ot_meta_reference_entry (hb_face_t *face, hb_ot_meta_tag_t meta_tag)
75 {
76 return face->table.meta->reference_entry (meta_tag);
77 }
78
79 #endif
80