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
53CAIRO_BEGIN_DECLS
54
55cairo_public cairo_font_face_t *
56cairo_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 **/
78typedef enum {
79 CAIRO_FT_SYNTHESIZE_BOLD = 1 << 0,
80 CAIRO_FT_SYNTHESIZE_OBLIQUE = 1 << 1
81} cairo_ft_synthesize_t;
82
83cairo_public void
84cairo_ft_font_face_set_synthesize (cairo_font_face_t *font_face,
85 unsigned int synth_flags);
86
87cairo_public void
88cairo_ft_font_face_unset_synthesize (cairo_font_face_t *font_face,
89 unsigned int synth_flags);
90
91cairo_public unsigned int
92cairo_ft_font_face_get_synthesize (cairo_font_face_t *font_face);
93
94
95cairo_public FT_Face
96cairo_ft_scaled_font_lock_face (cairo_scaled_font_t *scaled_font);
97
98cairo_public void
99cairo_ft_scaled_font_unlock_face (cairo_scaled_font_t *scaled_font);
100
101#if CAIRO_HAS_FC_FONT
102
103cairo_public cairo_font_face_t *
104cairo_ft_font_face_create_for_pattern (FcPattern *pattern);
105
106cairo_public void
107cairo_ft_font_options_substitute (const cairo_font_options_t *options,
108 FcPattern *pattern);
109
110#endif
111
112CAIRO_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

source code of include/cairo/cairo-ft.h