annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/include/harfbuzz/hb-ot-var.h @ 69:33d812a61356

planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 17:55:14 -0400
parents
children
rev   line source
jpayne@69 1 /*
jpayne@69 2 * Copyright © 2017 Google, Inc.
jpayne@69 3 *
jpayne@69 4 * This is part of HarfBuzz, a text shaping library.
jpayne@69 5 *
jpayne@69 6 * Permission is hereby granted, without written agreement and without
jpayne@69 7 * license or royalty fees, to use, copy, modify, and distribute this
jpayne@69 8 * software and its documentation for any purpose, provided that the
jpayne@69 9 * above copyright notice and the following two paragraphs appear in
jpayne@69 10 * all copies of this software.
jpayne@69 11 *
jpayne@69 12 * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
jpayne@69 13 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
jpayne@69 14 * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
jpayne@69 15 * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
jpayne@69 16 * DAMAGE.
jpayne@69 17 *
jpayne@69 18 * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
jpayne@69 19 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
jpayne@69 20 * FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
jpayne@69 21 * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
jpayne@69 22 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
jpayne@69 23 *
jpayne@69 24 * Red Hat Author(s): Behdad Esfahbod
jpayne@69 25 */
jpayne@69 26
jpayne@69 27 #ifndef HB_OT_H_IN
jpayne@69 28 #error "Include <hb-ot.h> instead."
jpayne@69 29 #endif
jpayne@69 30
jpayne@69 31 #ifndef HB_OT_VAR_H
jpayne@69 32 #define HB_OT_VAR_H
jpayne@69 33
jpayne@69 34 #include "hb.h"
jpayne@69 35
jpayne@69 36 HB_BEGIN_DECLS
jpayne@69 37
jpayne@69 38
jpayne@69 39 #define HB_OT_TAG_VAR_AXIS_ITALIC HB_TAG('i','t','a','l')
jpayne@69 40 #define HB_OT_TAG_VAR_AXIS_OPTICAL_SIZE HB_TAG('o','p','s','z')
jpayne@69 41 #define HB_OT_TAG_VAR_AXIS_SLANT HB_TAG('s','l','n','t')
jpayne@69 42 #define HB_OT_TAG_VAR_AXIS_WIDTH HB_TAG('w','d','t','h')
jpayne@69 43 #define HB_OT_TAG_VAR_AXIS_WEIGHT HB_TAG('w','g','h','t')
jpayne@69 44
jpayne@69 45
jpayne@69 46 /*
jpayne@69 47 * fvar / avar
jpayne@69 48 */
jpayne@69 49
jpayne@69 50 HB_EXTERN hb_bool_t
jpayne@69 51 hb_ot_var_has_data (hb_face_t *face);
jpayne@69 52
jpayne@69 53
jpayne@69 54 /*
jpayne@69 55 * Variation axes.
jpayne@69 56 */
jpayne@69 57
jpayne@69 58
jpayne@69 59 HB_EXTERN unsigned int
jpayne@69 60 hb_ot_var_get_axis_count (hb_face_t *face);
jpayne@69 61
jpayne@69 62 /**
jpayne@69 63 * hb_ot_var_axis_flags_t:
jpayne@69 64 * @HB_OT_VAR_AXIS_FLAG_HIDDEN: The axis should not be exposed directly in user interfaces.
jpayne@69 65 *
jpayne@69 66 * Since: 2.2.0
jpayne@69 67 */
jpayne@69 68 typedef enum { /*< flags >*/
jpayne@69 69 HB_OT_VAR_AXIS_FLAG_HIDDEN = 0x00000001u,
jpayne@69 70
jpayne@69 71 _HB_OT_VAR_AXIS_FLAG_MAX_VALUE= HB_TAG_MAX_SIGNED /*< skip >*/
jpayne@69 72 } hb_ot_var_axis_flags_t;
jpayne@69 73
jpayne@69 74 /**
jpayne@69 75 * hb_ot_var_axis_info_t:
jpayne@69 76 *
jpayne@69 77 * Since: 2.2.0
jpayne@69 78 */
jpayne@69 79 typedef struct hb_ot_var_axis_info_t
jpayne@69 80 {
jpayne@69 81 unsigned int axis_index;
jpayne@69 82 hb_tag_t tag;
jpayne@69 83 hb_ot_name_id_t name_id;
jpayne@69 84 hb_ot_var_axis_flags_t flags;
jpayne@69 85 float min_value;
jpayne@69 86 float default_value;
jpayne@69 87 float max_value;
jpayne@69 88 /*< private >*/
jpayne@69 89 unsigned int reserved;
jpayne@69 90 } hb_ot_var_axis_info_t;
jpayne@69 91
jpayne@69 92 HB_EXTERN unsigned int
jpayne@69 93 hb_ot_var_get_axis_infos (hb_face_t *face,
jpayne@69 94 unsigned int start_offset,
jpayne@69 95 unsigned int *axes_count /* IN/OUT */,
jpayne@69 96 hb_ot_var_axis_info_t *axes_array /* OUT */);
jpayne@69 97
jpayne@69 98 HB_EXTERN hb_bool_t
jpayne@69 99 hb_ot_var_find_axis_info (hb_face_t *face,
jpayne@69 100 hb_tag_t axis_tag,
jpayne@69 101 hb_ot_var_axis_info_t *axis_info);
jpayne@69 102
jpayne@69 103
jpayne@69 104 /*
jpayne@69 105 * Named instances.
jpayne@69 106 */
jpayne@69 107
jpayne@69 108 HB_EXTERN unsigned int
jpayne@69 109 hb_ot_var_get_named_instance_count (hb_face_t *face);
jpayne@69 110
jpayne@69 111 HB_EXTERN hb_ot_name_id_t
jpayne@69 112 hb_ot_var_named_instance_get_subfamily_name_id (hb_face_t *face,
jpayne@69 113 unsigned int instance_index);
jpayne@69 114
jpayne@69 115 HB_EXTERN hb_ot_name_id_t
jpayne@69 116 hb_ot_var_named_instance_get_postscript_name_id (hb_face_t *face,
jpayne@69 117 unsigned int instance_index);
jpayne@69 118
jpayne@69 119 HB_EXTERN unsigned int
jpayne@69 120 hb_ot_var_named_instance_get_design_coords (hb_face_t *face,
jpayne@69 121 unsigned int instance_index,
jpayne@69 122 unsigned int *coords_length, /* IN/OUT */
jpayne@69 123 float *coords /* OUT */);
jpayne@69 124
jpayne@69 125
jpayne@69 126 /*
jpayne@69 127 * Conversions.
jpayne@69 128 */
jpayne@69 129
jpayne@69 130 HB_EXTERN void
jpayne@69 131 hb_ot_var_normalize_variations (hb_face_t *face,
jpayne@69 132 const hb_variation_t *variations, /* IN */
jpayne@69 133 unsigned int variations_length,
jpayne@69 134 int *coords, /* OUT */
jpayne@69 135 unsigned int coords_length);
jpayne@69 136
jpayne@69 137 HB_EXTERN void
jpayne@69 138 hb_ot_var_normalize_coords (hb_face_t *face,
jpayne@69 139 unsigned int coords_length,
jpayne@69 140 const float *design_coords, /* IN */
jpayne@69 141 int *normalized_coords /* OUT */);
jpayne@69 142
jpayne@69 143
jpayne@69 144 HB_END_DECLS
jpayne@69 145
jpayne@69 146 #endif /* HB_OT_VAR_H */