1 /* cairo - a vector graphics library with display and print output 2 * 3 * Copyright © 2005 Red Hat, Inc 4 * 5 * This library is free software; you can redistribute it and/or 6 * modify it either under the terms of the GNU Lesser General Public 7 * License version 2.1 as published by the Free Software Foundation 8 * (the "LGPL") or, at your option, under the terms of the Mozilla 9 * Public License Version 1.1 (the "MPL"). If you do not alter this 10 * notice, a recipient may use your version of this file under either 11 * the MPL or the LGPL. 12 * 13 * You should have received a copy of the LGPL along with this library 14 * in the file COPYING-LGPL-2.1; if not, write to the Free Software 15 * Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, USA 16 * You should have received a copy of the MPL along with this library 17 * in the file COPYING-MPL-1.1 18 * 19 * The contents of this file are subject to the Mozilla Public License 20 * Version 1.1 (the "License"); you may not use this file except in 21 * compliance with the License. You may obtain a copy of the License at 22 * http://www.mozilla.org/MPL/ 23 * 24 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY 25 * OF ANY KIND, either express or implied. See the LGPL or the MPL for 26 * the specific language governing rights and limitations. 27 * 28 * The Original Code is the cairo graphics library. 29 * 30 * The Initial Developer of the Original Code is Red Hat, Inc. 31 * 32 * Contributor(s): 33 * Graydon Hoare <graydon@redhat.com> 34 * Owen Taylor <otaylor@redhat.com> 35 */ 36 37 #ifndef CAIRO_FT_H 38 #define CAIRO_FT_H 39 40 #include "cairo.h" 41 42 #if CAIRO_HAS_FT_FONT 43 44 /* Fontconfig/Freetype platform-specific font interface */ 45 46 #include <ft2build.h> 47 #include FT_FREETYPE_H 48 49 #if CAIRO_HAS_FC_FONT 50 #include <fontconfig/fontconfig.h> 51 #endif 52 53 CAIRO_BEGIN_DECLS 54 55 cairo_public cairo_font_face_t * 56 cairo_ft_font_face_create_for_ft_face (FT_Face face, 57 int load_flags, 58 unsigned int synth_flags, 59 void *face_context); 60 61 /** 62 * cairo_ft_synthesize_t: 63 * @CAIRO_FT_SYNTHESIZE_BOLD: Embolden the glyphs (redraw with a pixel offset) 64 * @CAIRO_FT_SYNTHESIZE_OBLIQUE: Slant the glyph outline by 12 degrees to the 65 * right. 66 * 67 * A set of synthesis options to control how FreeType renders the glyphs 68 * for a particular font face. 69 * 70 * Individual synthesis features of a #cairo_ft_font_face_t can be set 71 * using cairo_ft_font_face_set_synthesize(), or disabled using 72 * cairo_ft_font_face_unset_synthesize(). The currently enabled set of 73 * synthesis options can be queried with cairo_ft_font_face_get_synthesize(). 74 * 75 * Note: that when synthesizing glyphs, the font metrics returned will only 76 * be estimates. 77 * 78 * Since: 1.12 79 **/ 80 typedef enum { 81 CAIRO_FT_SYNTHESIZE_BOLD = 1 << 0, 82 CAIRO_FT_SYNTHESIZE_OBLIQUE = 1 << 1 83 } cairo_ft_synthesize_t; 84 85 cairo_public void 86 cairo_ft_font_face_set_synthesize (cairo_font_face_t *font_face, 87 unsigned int synth_flags); 88 89 cairo_public void 90 cairo_ft_font_face_unset_synthesize (cairo_font_face_t *font_face, 91 unsigned int synth_flags); 92 93 cairo_public unsigned int 94 cairo_ft_font_face_get_synthesize (cairo_font_face_t *font_face); 95 96 97 cairo_public FT_Face 98 cairo_ft_scaled_font_lock_face (cairo_scaled_font_t *scaled_font); 99 100 cairo_public void 101 cairo_ft_scaled_font_unlock_face (cairo_scaled_font_t *scaled_font); 102 103 #if CAIRO_HAS_FC_FONT 104 105 cairo_public cairo_font_face_t * 106 cairo_ft_font_face_create_for_pattern (FcPattern *pattern); 107 108 cairo_public void 109 cairo_ft_font_options_substitute (const cairo_font_options_t *options, 110 FcPattern *pattern); 111 112 #endif 113 114 CAIRO_END_DECLS 115 116 #else /* CAIRO_HAS_FT_FONT */ 117 # error Cairo was not compiled with support for the freetype font backend 118 #endif /* CAIRO_HAS_FT_FONT */ 119 120 #endif /* CAIRO_FT_H */ 121