1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_GFX_PANGO_UTIL_H_
#define UI_GFX_PANGO_UTIL_H_
#include <cairo/cairo.h>
#include <pango/pango.h>
#include <string>
#include "base/i18n/rtl.h"
#include "base/logging.h"
#include "base/strings/string16.h"
#include "third_party/skia/include/core/SkColor.h"
#include "ui/base/ui_export.h"
typedef struct _PangoContext PangoContext;
namespace gfx {
class Font;
class PlatformFontPango;
class Rect;
// Creates and returns a PangoContext. The caller owns the context.
PangoContext* GetPangoContext();
// Returns the resolution (DPI) used by pango. A negative values means the
// resolution hasn't been set.
double GetPangoResolution();
// Utility class to ensure that PangoFontDescription is freed.
class ScopedPangoFontDescription {
public:
explicit ScopedPangoFontDescription(PangoFontDescription* description)
: description_(description) {
DCHECK(description);
}
~ScopedPangoFontDescription() {
pango_font_description_free(description_);
}
PangoFontDescription* get() { return description_; }
private:
PangoFontDescription* description_;
DISALLOW_COPY_AND_ASSIGN(ScopedPangoFontDescription);
};
// Uses Pango to draw text onto |cr|. This is the public method for d
void UI_EXPORT DrawTextOntoCairoSurface(cairo_t* cr,
const base::string16& text,
const gfx::Font& font,
const gfx::Rect& bounds,
const gfx::Rect& clip,
SkColor text_color,
int flags);
// ----------------------------------------------------------------------------
// All other methods in this file are only to be used within the ui/ directory.
// They are shared with internal skia interfaces.
// ----------------------------------------------------------------------------
// Setup pango |layout|; set the |text|, the font description based on |font|,
// the |width| in PANGO_SCALE for RTL locale, the base |text_direction|,
// alignment, ellipsis, word wrapping, resolution, etc.
void SetupPangoLayout(PangoLayout* layout,
const base::string16& text,
const gfx::Font& font,
int width,
base::i18n::TextDirection text_direction,
int flags);
// Setup pango layout |layout| the same way as SetupPangoLayout(), except this
// sets the font description based on |font_description|.
void SetupPangoLayoutWithFontDescription(
PangoLayout* layout,
const base::string16& text,
const std::string& font_description,
int width,
base::i18n::TextDirection text_direction,
int flags);
// Draws the |layout| (pango tuple of font, actual text, etc) onto |cr| using
// |text_color| as the cairo pattern.
void DrawPangoLayout(cairo_t* cr,
PangoLayout* layout,
const Font& font,
const gfx::Rect& bounds,
const gfx::Rect& text_rect,
SkColor text_color,
base::i18n::TextDirection text_direction,
int flags);
// Draw an underline under the text using |cr|, which must already be
// initialized with the correct source. |extra_edge_width| is added to the
// outer edge of the line.
void DrawPangoTextUnderline(cairo_t* cr,
gfx::PlatformFontPango* platform_font,
double extra_edge_width,
const Rect& text_rect);
// Returns the size in pixels for the specified |pango_font|.
size_t GetPangoFontSizeInPixels(PangoFontDescription* pango_font);
// Retrieves the Pango metrics for a Pango font description. Caches the metrics
// and never frees them. The metrics objects are relatively small and very
// expensive to look up.
PangoFontMetrics* GetPangoFontMetrics(PangoFontDescription* desc);
} // namespace gfx
#endif // UI_GFX_PANGO_UTIL_H_
|
