jpayne@69: /*
jpayne@69:  * Copyright © 2017  Google, Inc.
jpayne@69:  *
jpayne@69:  *  This is part of HarfBuzz, a text shaping library.
jpayne@69:  *
jpayne@69:  * Permission is hereby granted, without written agreement and without
jpayne@69:  * license or royalty fees, to use, copy, modify, and distribute this
jpayne@69:  * software and its documentation for any purpose, provided that the
jpayne@69:  * above copyright notice and the following two paragraphs appear in
jpayne@69:  * all copies of this software.
jpayne@69:  *
jpayne@69:  * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
jpayne@69:  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
jpayne@69:  * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
jpayne@69:  * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
jpayne@69:  * DAMAGE.
jpayne@69:  *
jpayne@69:  * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
jpayne@69:  * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
jpayne@69:  * FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
jpayne@69:  * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
jpayne@69:  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
jpayne@69:  *
jpayne@69:  * Red Hat Author(s): Behdad Esfahbod
jpayne@69:  */
jpayne@69: 
jpayne@69: #ifndef HB_OT_H_IN
jpayne@69: #error "Include <hb-ot.h> instead."
jpayne@69: #endif
jpayne@69: 
jpayne@69: #ifndef HB_OT_VAR_H
jpayne@69: #define HB_OT_VAR_H
jpayne@69: 
jpayne@69: #include "hb.h"
jpayne@69: 
jpayne@69: HB_BEGIN_DECLS
jpayne@69: 
jpayne@69: 
jpayne@69: #define HB_OT_TAG_VAR_AXIS_ITALIC	HB_TAG('i','t','a','l')
jpayne@69: #define HB_OT_TAG_VAR_AXIS_OPTICAL_SIZE	HB_TAG('o','p','s','z')
jpayne@69: #define HB_OT_TAG_VAR_AXIS_SLANT	HB_TAG('s','l','n','t')
jpayne@69: #define HB_OT_TAG_VAR_AXIS_WIDTH	HB_TAG('w','d','t','h')
jpayne@69: #define HB_OT_TAG_VAR_AXIS_WEIGHT	HB_TAG('w','g','h','t')
jpayne@69: 
jpayne@69: 
jpayne@69: /*
jpayne@69:  * fvar / avar
jpayne@69:  */
jpayne@69: 
jpayne@69: HB_EXTERN hb_bool_t
jpayne@69: hb_ot_var_has_data (hb_face_t *face);
jpayne@69: 
jpayne@69: 
jpayne@69: /*
jpayne@69:  * Variation axes.
jpayne@69:  */
jpayne@69: 
jpayne@69: 
jpayne@69: HB_EXTERN unsigned int
jpayne@69: hb_ot_var_get_axis_count (hb_face_t *face);
jpayne@69: 
jpayne@69: /**
jpayne@69:  * hb_ot_var_axis_flags_t:
jpayne@69:  * @HB_OT_VAR_AXIS_FLAG_HIDDEN: The axis should not be exposed directly in user interfaces.
jpayne@69:  *
jpayne@69:  * Since: 2.2.0
jpayne@69:  */
jpayne@69: typedef enum { /*< flags >*/
jpayne@69:   HB_OT_VAR_AXIS_FLAG_HIDDEN	= 0x00000001u,
jpayne@69: 
jpayne@69:   _HB_OT_VAR_AXIS_FLAG_MAX_VALUE= HB_TAG_MAX_SIGNED /*< skip >*/
jpayne@69: } hb_ot_var_axis_flags_t;
jpayne@69: 
jpayne@69: /**
jpayne@69:  * hb_ot_var_axis_info_t:
jpayne@69:  *
jpayne@69:  * Since: 2.2.0
jpayne@69:  */
jpayne@69: typedef struct hb_ot_var_axis_info_t
jpayne@69: {
jpayne@69:   unsigned int			axis_index;
jpayne@69:   hb_tag_t			tag;
jpayne@69:   hb_ot_name_id_t		name_id;
jpayne@69:   hb_ot_var_axis_flags_t	flags;
jpayne@69:   float				min_value;
jpayne@69:   float				default_value;
jpayne@69:   float				max_value;
jpayne@69:   /*< private >*/
jpayne@69:   unsigned int			reserved;
jpayne@69: } hb_ot_var_axis_info_t;
jpayne@69: 
jpayne@69: HB_EXTERN unsigned int
jpayne@69: hb_ot_var_get_axis_infos (hb_face_t             *face,
jpayne@69: 			  unsigned int           start_offset,
jpayne@69: 			  unsigned int          *axes_count /* IN/OUT */,
jpayne@69: 			  hb_ot_var_axis_info_t *axes_array /* OUT */);
jpayne@69: 
jpayne@69: HB_EXTERN hb_bool_t
jpayne@69: hb_ot_var_find_axis_info (hb_face_t             *face,
jpayne@69: 			  hb_tag_t               axis_tag,
jpayne@69: 			  hb_ot_var_axis_info_t *axis_info);
jpayne@69: 
jpayne@69: 
jpayne@69: /*
jpayne@69:  * Named instances.
jpayne@69:  */
jpayne@69: 
jpayne@69: HB_EXTERN unsigned int
jpayne@69: hb_ot_var_get_named_instance_count (hb_face_t *face);
jpayne@69: 
jpayne@69: HB_EXTERN hb_ot_name_id_t
jpayne@69: hb_ot_var_named_instance_get_subfamily_name_id (hb_face_t   *face,
jpayne@69: 						unsigned int instance_index);
jpayne@69: 
jpayne@69: HB_EXTERN hb_ot_name_id_t
jpayne@69: hb_ot_var_named_instance_get_postscript_name_id (hb_face_t  *face,
jpayne@69: 						unsigned int instance_index);
jpayne@69: 
jpayne@69: HB_EXTERN unsigned int
jpayne@69: hb_ot_var_named_instance_get_design_coords (hb_face_t    *face,
jpayne@69: 					    unsigned int  instance_index,
jpayne@69: 					    unsigned int *coords_length, /* IN/OUT */
jpayne@69: 					    float        *coords         /* OUT */);
jpayne@69: 
jpayne@69: 
jpayne@69: /*
jpayne@69:  * Conversions.
jpayne@69:  */
jpayne@69: 
jpayne@69: HB_EXTERN void
jpayne@69: hb_ot_var_normalize_variations (hb_face_t            *face,
jpayne@69: 				const hb_variation_t *variations, /* IN */
jpayne@69: 				unsigned int          variations_length,
jpayne@69: 				int                  *coords, /* OUT */
jpayne@69: 				unsigned int          coords_length);
jpayne@69: 
jpayne@69: HB_EXTERN void
jpayne@69: hb_ot_var_normalize_coords (hb_face_t    *face,
jpayne@69: 			    unsigned int coords_length,
jpayne@69: 			    const float *design_coords, /* IN */
jpayne@69: 			    int *normalized_coords /* OUT */);
jpayne@69: 
jpayne@69: 
jpayne@69: HB_END_DECLS
jpayne@69: 
jpayne@69: #endif /* HB_OT_VAR_H */