/src/harfbuzz/src/hb-ot-meta.cc
Line | Count | Source |
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 |
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 | 1.21M | { |
59 | 1.21M | return face->table.meta->get_entries (start_offset, entries_count, entries); |
60 | 1.21M | } |
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 * |
74 | | hb_ot_meta_reference_entry (hb_face_t *face, hb_ot_meta_tag_t meta_tag) |
75 | 1.21M | { |
76 | 1.21M | return face->table.meta->reference_entry (meta_tag); |
77 | 1.21M | } |
78 | | |
79 | | #endif |