make computation of OS X pango text width correction less intrusive/more efficient.
[ardour.git] / libs / canvas / text.cc
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 #include <gdk/gdk.h>
21
22 #include <cairomm/cairomm.h>
23 #include <gtkmm/window.h>
24 #include <gtkmm/label.h>
25
26 #include "pbd/stacktrace.h"
27
28 #include "canvas/text.h"
29 #include "canvas/canvas.h"
30 #include "canvas/utils.h"
31 #include "canvas/colors.h"
32
33 using namespace std;
34 using namespace ArdourCanvas;
35
36
37 Text::Text (Canvas* c)
38         : Item (c)
39         , _color (0x000000ff)
40         , _font_description (0)
41         , _alignment (Pango::ALIGN_LEFT)
42         , _width (0)
43         , _height (0)
44         , _need_redraw (false)
45         , _width_correction (-1)
46         , _clamped_width (COORD_MAX)
47 {
48         _outline = false;
49 }
50
51 Text::Text (Item* parent)
52         : Item (parent)
53         , _color (0x000000ff)
54         , _font_description (0)
55         , _alignment (Pango::ALIGN_LEFT)
56         , _width (0)
57         , _height (0)
58         , _need_redraw (false)
59         , _width_correction (-1)
60         , _clamped_width (COORD_MAX)
61 {
62         _outline = false;
63 }
64
65 Text::~Text ()
66 {
67         delete _font_description;
68 }
69
70 void
71 Text::set (string const & text)
72 {
73         begin_change ();
74         
75         _text = text;
76
77         _need_redraw = true;
78         _bounding_box_dirty = true;
79
80         end_change ();
81 }
82
83 void
84 Text::_redraw (Cairo::RefPtr<Cairo::Context> context) const
85 {
86         if (_text.empty()) {
87                 return;
88         }
89
90         Glib::RefPtr<Pango::Layout> layout = Pango::Layout::create (context);
91
92         __redraw (layout);
93 }
94
95 void
96 Text::_redraw (Glib::RefPtr<Pango::Context> context) const
97 {
98         if (_text.empty()) {
99                 return;
100         }
101
102         Glib::RefPtr<Pango::Layout> layout = Pango::Layout::create (context);
103         __redraw (layout);
104 }
105
106 void
107 Text::__redraw (Glib::RefPtr<Pango::Layout> layout) const
108 {
109 #ifdef __APPLE__
110         if (_width_correction < 0.0) {
111                 // Pango returns incorrect text width on some OS X
112                 // So we have to make a correction
113                 // To determine the correct indent take the largest symbol for which the width is correct
114                 // and make the calculation
115                 Gtk::Window win;
116                 Gtk::Label foo;
117                 win.add (foo);
118                 
119                 int width = 0;
120                 int height = 0;
121                 Glib::RefPtr<Pango::Layout> test_layout = foo.create_pango_layout ("H");
122                 test_layout->set_font_description (*_font_description);
123                 test_layout->get_pixel_size (width, height);
124                 
125                 _width_correction = width*1.5;
126         }
127 #else
128         /* don't bother with a conditional here */
129         _width_correction = 0.0;
130 #endif
131
132         layout->set_text (_text);
133
134         if (_font_description) {
135                 layout->set_font_description (*_font_description);
136         }
137
138         layout->set_alignment (_alignment);
139     
140         int w;
141         int h;
142
143         layout->get_pixel_size (w, h);
144
145         _width = w + _width_correction;
146         _height = h;
147
148         _image = Cairo::ImageSurface::create (Cairo::FORMAT_ARGB32, _width, _height);
149
150         Cairo::RefPtr<Cairo::Context> img_context = Cairo::Context::create (_image);
151
152         /* and draw, in the appropriate color of course */
153
154         if (_outline) {
155                 set_source_rgba (img_context, _outline_color);
156                 layout->update_from_cairo_context (img_context);
157                 pango_cairo_layout_path (img_context->cobj(), layout->gobj());
158                 img_context->stroke_preserve ();
159                 set_source_rgba (img_context, _color);
160                 img_context->fill ();
161         } else {
162                 set_source_rgba (img_context, _color);
163                 layout->show_in_cairo_context (img_context);
164         }
165
166         /* text has now been rendered in _image and is ready for blit in
167          * ::render 
168          */
169
170         _need_redraw = false;
171 }
172
173 void
174 Text::render (Rect const & area, Cairo::RefPtr<Cairo::Context> context) const
175 {
176         if (_text.empty()) {
177                 return;
178         }
179
180         Rect self = item_to_window (Rect (0, 0, min (_clamped_width, (double)_image->get_width ()), _image->get_height ()));
181         boost::optional<Rect> i = self.intersection (area);
182         
183         if (!i) {
184                 return;
185         }
186
187         if (_need_redraw) {
188                 _redraw (context);
189         }
190         
191         Rect intersection (i.get());
192
193         context->rectangle (intersection.x0, intersection.y0, intersection.width(), intersection.height());
194         context->set_source (_image, self.x0, self.y0);
195         context->fill ();
196 }
197
198 void
199 Text::clamp_width (double w)
200 {
201         begin_change ();
202         _clamped_width = w;
203         _bounding_box_dirty = true;
204         end_change ();
205 }
206
207 void
208 Text::compute_bounding_box () const
209 {
210         if (!_canvas || _text.empty()) {
211                 _bounding_box = boost::optional<Rect> ();
212                 _bounding_box_dirty = false;
213                 return;
214         }
215
216         if (_bounding_box_dirty) {
217                 if (_need_redraw || !_image) {
218                         Glib::RefPtr<Pango::Context> context = Glib::wrap (gdk_pango_context_get()); // context now owns C object and will free it
219                         _redraw (context);
220                 }
221                 _bounding_box = Rect (0, 0, min (_clamped_width, (double) _image->get_width()), _image->get_height());
222                 _bounding_box_dirty = false;
223         }
224 }
225
226 void
227 Text::set_alignment (Pango::Alignment alignment)
228 {
229         begin_change ();
230         
231         _alignment = alignment;
232         _need_redraw = true;
233         _bounding_box_dirty = true;
234         end_change ();
235 }
236
237 void
238 Text::set_font_description (Pango::FontDescription font_description)
239 {
240         begin_change ();
241         
242         _font_description = new Pango::FontDescription (font_description);
243         _need_redraw = true;
244         _width_correction = -1.0;
245
246         _bounding_box_dirty = true;
247         end_change ();
248 }
249
250 void
251 Text::set_color (Color color)
252 {
253         begin_change ();
254
255         _color = color;
256         if (_outline) {
257                 set_outline_color (contrasting_text_color (_color));
258         }
259         _need_redraw = true;
260
261         end_change ();
262 }
263
264                 
265 void
266 Text::dump (ostream& o) const
267 {
268         Item::dump (o);
269
270         o << _canvas->indent() << '\t' << " text = " << _text << endl
271           << _canvas->indent() << " color = " << _color;
272
273         o << endl;
274 }
275
276
277 double
278 Text::text_width() const
279 {
280     if (_need_redraw) {
281         redraw ();
282     }
283     
284     return _width;
285 }