new API for TrackingText and similar items
[ardour.git] / libs / canvas / canvas / text.h
1 /*
2     Copyright (C) 2011-2013 Paul Davis
3     Author: Carl Hetherington <cth@carlh.net>
4
5     This program is free software; you can redistribute it and/or modify
6     it under the terms of the GNU General Public License as published by
7     the Free Software Foundation; either version 2 of the License, or
8     (at your option) any later version.
9
10     This program is distributed in the hope that it will be useful,
11     but WITHOUT ANY WARRANTY; without even the implied warranty of
12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13     GNU General Public License for more details.
14
15     You should have received a copy of the GNU General Public License
16     along with this program; if not, write to the Free Software
17     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
18 */
19
20 #ifndef __ardour_canvas_text_h__
21 #define __ardour_canvas_text_h__
22
23 #include <pangomm/fontdescription.h>
24 #include <pangomm/layout.h>
25
26 #include "canvas/visibility.h"
27 #include "canvas/item.h"
28
29 namespace ArdourCanvas {
30
31 class LIBCANVAS_API Text : public Item
32 {
33 public:
34         Text (Canvas*);
35         Text (Item*);
36        ~Text();
37
38         void render (Rect const &, Cairo::RefPtr<Cairo::Context>) const;
39         void compute_bounding_box () const;
40
41         void set (std::string const &);
42         void set_color (uint32_t);
43         void set_font_description (Pango::FontDescription);
44         void set_alignment (Pango::Alignment);
45
46         void clamp_width (double);
47
48         void set_size_chars (int nchars);
49         void dump (std::ostream&) const;
50
51         std::string text() const { return _text; }
52
53 private:
54         std::string      _text;
55         uint32_t         _color;
56         Pango::FontDescription* _font_description;
57         Pango::Alignment _alignment;
58         mutable Cairo::RefPtr<Cairo::ImageSurface> _image;
59         mutable Duple _origin;
60         mutable double _width;
61         mutable double _height;
62         mutable bool _need_redraw;
63         double _clamped_width;
64
65         void redraw (Cairo::RefPtr<Cairo::Context>) const;
66         void redraw (Glib::RefPtr<Pango::Context>) const;
67         void _redraw (Glib::RefPtr<Pango::Layout>) const;
68 };
69
70 }
71
72 #endif /* __ardour_canvas_text_h__ */