1 | /* Canvas for random-access procedural text art. |
2 | Copyright (C) 2023-2024 Free Software Foundation, Inc. |
3 | Contributed by David Malcolm <dmalcolm@redhat.com>. |
4 | |
5 | This file is part of GCC. |
6 | |
7 | GCC is free software; you can redistribute it and/or modify it |
8 | under the terms of the GNU General Public License as published by |
9 | the Free Software Foundation; either version 3, or (at your option) |
10 | any later version. |
11 | |
12 | GCC is distributed in the hope that it will be useful, but |
13 | WITHOUT ANY WARRANTY; without even the implied warranty of |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
15 | General Public License for more details. |
16 | |
17 | You should have received a copy of the GNU General Public License |
18 | along with GCC; see the file COPYING3. If not see |
19 | <http://www.gnu.org/licenses/>. */ |
20 | |
21 | #ifndef GCC_TEXT_ART_CANVAS_H |
22 | #define GCC_TEXT_ART_CANVAS_H |
23 | |
24 | #include "text-art/types.h" |
25 | |
26 | namespace text_art { |
27 | |
28 | class canvas; |
29 | |
30 | /* A 2 dimensional grid of text cells (a "canvas"), which |
31 | can be written to ("painted") via random access, and then |
32 | written out to a pretty_printer once the picture is complete. |
33 | |
34 | Each text cell can be styled independently (colorization, |
35 | URLs, etc). */ |
36 | |
37 | class canvas |
38 | { |
39 | public: |
40 | typedef styled_unichar cell_t; |
41 | typedef size<class canvas> size_t; |
42 | typedef coord<class canvas> coord_t; |
43 | typedef range<class canvas> range_t; |
44 | typedef rect<class canvas> rect_t; |
45 | |
46 | canvas (size_t size, const style_manager &style_mgr); |
47 | |
48 | size_t get_size () const { return m_cells.get_size (); } |
49 | |
50 | void paint (coord_t coord, cell_t c); |
51 | void paint_text (coord_t coord, const styled_string &text); |
52 | |
53 | void fill (rect_t rect, cell_t c); |
54 | void debug_fill (); |
55 | |
56 | void print_to_pp (pretty_printer *pp, |
57 | const char *per_line_prefix = NULL) const; |
58 | void debug (bool styled) const; |
59 | |
60 | const cell_t &get (coord_t coord) const |
61 | { |
62 | return m_cells.get (coord); |
63 | } |
64 | |
65 | private: |
66 | int get_final_x_in_row (int y) const; |
67 | |
68 | array2<cell_t, size_t, coord_t> m_cells; |
69 | const style_manager &m_style_mgr; |
70 | }; |
71 | |
72 | } // namespace text_art |
73 | |
74 | #endif /* GCC_TEXT_ART_CANVAS_H */ |
75 | |