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_reference_entry:
42 * @face: a face object
43 * @start_offset: iteration's start offset
44 * @entries_count:(inout) (allow-none): buffer size as input, filled size as output
45 * @entries: (out caller-allocates) (array length=entries_count): entries tags buffer
46 *
47 * Return value: Number of all available feature types.
48 *
49 * Since: 2.6.0
50 **/
51 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)52 hb_ot_meta_get_entry_tags (hb_face_t *face,
53 unsigned int start_offset,
54 unsigned int *entries_count, /* IN/OUT. May be NULL. */
55 hb_ot_meta_tag_t *entries /* OUT. May be NULL. */)
56 {
57 return face->table.meta->get_entries (start_offset, entries_count, entries);
58 }
59
60 /**
61 * hb_ot_meta_reference_entry:
62 * @face: a #hb_face_t object.
63 * @meta_tag: tag of metadata you like to have.
64 *
65 * It fetches metadata entry of a given tag from a font.
66 *
67 * Returns: (transfer full): A blob containing the blob.
68 *
69 * Since: 2.6.0
70 **/
71 hb_blob_t *
hb_ot_meta_reference_entry(hb_face_t * face,hb_ot_meta_tag_t meta_tag)72 hb_ot_meta_reference_entry (hb_face_t *face, hb_ot_meta_tag_t meta_tag)
73 {
74 return face->table.meta->reference_entry (meta_tag);
75 }
76
77 #endif
78