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 59 /** 60 * cairo_ft_synthesize_t: 61 * @CAIRO_FT_SYNTHESIZE_BOLD: Embolden the glyphs (redraw with a pixel offset) 62 * @CAIRO_FT_SYNTHESIZE_OBLIQUE: Slant the glyph outline by 12 degrees to the 63 * right. 64 * 65 * A set of synthesis options to control how FreeType renders the glyphs 66 * for a particular font face. 67 * 68 * Individual synthesis features of a #cairo_ft_font_face_t can be set 69 * using cairo_ft_font_face_set_synthesize(), or disabled using 70 * cairo_ft_font_face_unset_synthesize(). The currently enabled set of 71 * synthesis options can be queried with cairo_ft_font_face_get_synthesize(). 72 * 73 * Note: that when synthesizing glyphs, the font metrics returned will only 74 * be estimates. 75 * 76 * Since: 1.12 77 **/ 78 typedef enum { 79 CAIRO_FT_SYNTHESIZE_BOLD = 1 << 0, 80 CAIRO_FT_SYNTHESIZE_OBLIQUE = 1 << 1 81 } cairo_ft_synthesize_t; 82 83 cairo_public void 84 cairo_ft_font_face_set_synthesize (cairo_font_face_t *font_face, 85 unsigned int synth_flags); 86 87 cairo_public void 88 cairo_ft_font_face_unset_synthesize (cairo_font_face_t *font_face, 89 unsigned int synth_flags); 90 91 cairo_public unsigned int 92 cairo_ft_font_face_get_synthesize (cairo_font_face_t *font_face); 93 94 95 cairo_public FT_Face 96 cairo_ft_scaled_font_lock_face (cairo_scaled_font_t *scaled_font); 97 98 cairo_public void 99 cairo_ft_scaled_font_unlock_face (cairo_scaled_font_t *scaled_font); 100 101 #if CAIRO_HAS_FC_FONT 102 103 cairo_public cairo_font_face_t * 104 cairo_ft_font_face_create_for_pattern (FcPattern *pattern); 105 106 cairo_public void 107 cairo_ft_font_options_substitute (const cairo_font_options_t *options, 108 FcPattern *pattern); 109 110 #endif 111 112 CAIRO_END_DECLS 113 114 #else /* CAIRO_HAS_FT_FONT */ 115 # error Cairo was not compiled with support for the freetype font backend 116 #endif /* CAIRO_HAS_FT_FONT */ 117 118 #endif /* CAIRO_FT_H */ 119