1// Copyright (c) 2012 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef UI_GFX_PANGO_UTIL_H_
6#define UI_GFX_PANGO_UTIL_H_
7
8#include <cairo/cairo.h>
9#include <pango/pango.h>
10
11#include "base/i18n/rtl.h"
12#include "base/logging.h"
13#include "base/strings/string16.h"
14#include "third_party/skia/include/core/SkColor.h"
15#include "ui/gfx/gfx_export.h"
16
17namespace gfx {
18
19class FontList;
20
21// Utility class to ensure that PangoFontDescription is freed.
22class ScopedPangoFontDescription {
23 public:
24  explicit ScopedPangoFontDescription(PangoFontDescription* description)
25      : description_(description) {
26    DCHECK(description);
27  }
28
29  explicit ScopedPangoFontDescription(const std::string& str)
30      : description_(pango_font_description_from_string(str.c_str())) {
31    DCHECK(description_);
32  }
33
34  ~ScopedPangoFontDescription() {
35    pango_font_description_free(description_);
36  }
37
38  PangoFontDescription* get() { return description_; }
39
40 private:
41  PangoFontDescription* description_;
42
43  DISALLOW_COPY_AND_ASSIGN(ScopedPangoFontDescription);
44};
45
46// ----------------------------------------------------------------------------
47// All other methods in this file are only to be used within the ui/ directory.
48// They are shared with internal skia interfaces.
49// ----------------------------------------------------------------------------
50
51// Configures |layout| for the passed-in parameters.
52void SetUpPangoLayout(
53    PangoLayout* layout,
54    const base::string16& text,
55    const FontList& font_list,
56    base::i18n::TextDirection text_direction,
57    int flags);
58
59// Returns the size in pixels for the specified |pango_font|.
60int GetPangoFontSizeInPixels(PangoFontDescription* pango_font);
61
62// Retrieves the Pango metrics for a Pango font description. Caches the metrics
63// and never frees them. The metrics objects are relatively small and very
64// expensive to look up.
65PangoFontMetrics* GetPangoFontMetrics(PangoFontDescription* desc);
66
67}  // namespace gfx
68
69#endif  // UI_GFX_PANGO_UTIL_H_
70