src/cairo-ft.h

   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 */