include/harfbuzz/hb-ot-meta.h

0001 /*
0002  * Copyright © 2019  Ebrahim Byagowi
0003  *
0004  *  This is part of HarfBuzz, a text shaping library.
0005  *
0006  * Permission is hereby granted, without written agreement and without
0007  * license or royalty fees, to use, copy, modify, and distribute this
0008  * software and its documentation for any purpose, provided that the
0009  * above copyright notice and the following two paragraphs appear in
0010  * all copies of this software.
0011  *
0012  * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
0013  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
0014  * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
0015  * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
0016  * DAMAGE.
0017  *
0018  * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
0019  * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
0020  * FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
0021  * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
0022  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
0023  */
0024
0025 #if !defined(HB_OT_H_IN) && !defined(HB_NO_SINGLE_HEADER_ERROR)
0026 #error "Include <hb-ot.h> instead."
0027 #endif
0028
0029 #ifndef HB_OT_META_H
0030 #define HB_OT_META_H
0031
0032 #include "hb.h"
0033
0034 HB_BEGIN_DECLS
0035
0036 /**
0037  * hb_ot_meta_tag_t:
0038  * @HB_OT_META_TAG_DESIGN_LANGUAGES: Design languages. Text, using only
0039  * Basic Latin (ASCII) characters. Indicates languages and/or scripts
0040  * for the user audiences that the font was primarily designed for.
0041  * @HB_OT_META_TAG_SUPPORTED_LANGUAGES: Supported languages. Text, using
0042  * only Basic Latin (ASCII) characters. Indicates languages and/or scripts
0043  * that the font is declared to be capable of supporting.
0044  *
0045  * Known metadata tags from https://docs.microsoft.com/en-us/typography/opentype/spec/meta
0046  *
0047  * Since: 2.6.0
0048  **/
0049 typedef enum {
0050 /*
0051    HB_OT_META_TAG_APPL      = HB_TAG ('a','p','p','l'),
0052    HB_OT_META_TAG_BILD      = HB_TAG ('b','i','l','d'),
0053 */
0054   HB_OT_META_TAG_DESIGN_LANGUAGES   = HB_TAG ('d','l','n','g'),
0055   HB_OT_META_TAG_SUPPORTED_LANGUAGES    = HB_TAG ('s','l','n','g'),
0056
0057   /*< private >*/
0058   _HB_OT_META_TAG_MAX_VALUE = HB_TAG_MAX_SIGNED /*< skip >*/
0059 } hb_ot_meta_tag_t;
0060
0061 HB_EXTERN unsigned int
0062 hb_ot_meta_get_entry_tags (hb_face_t        *face,
0063                unsigned int      start_offset,
0064                unsigned int     *entries_count, /* IN/OUT.  May be NULL. */
0065                hb_ot_meta_tag_t *entries        /* OUT.     May be NULL. */);
0066
0067 HB_EXTERN hb_blob_t *
0068 hb_ot_meta_reference_entry (hb_face_t *face, hb_ot_meta_tag_t meta_tag);
0069
0070 HB_END_DECLS
0071
0072 #endif /* HB_OT_META_H */