ScummVM API documentation
mactext.h
1 /* ScummVM - Graphic Adventure Engine
2  *
3  * ScummVM is the legal property of its developers, whose names
4  * are too numerous to list here. Please refer to the COPYRIGHT
5  * file distributed with this source distribution.
6  *
7  * This program is free software: you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License as published by
9  * the Free Software Foundation, either version 3 of the License, or
10  * (at your option) any later version.
11  *
12  * This program is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15  * GNU General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program. If not, see <http://www.gnu.org/licenses/>.
19  *
20  */
21 
22 #ifndef GRAPHICS_MACGUI_MACTEXT_H
23 #define GRAPHICS_MACGUI_MACTEXT_H
24 
25 #include "graphics/macgui/mactext-canvas.h"
26 
27 namespace Graphics {
28 
29 struct SelectedText {
30  int startX, startY;
31  int endX, endY;
32  int startRow, startCol;
33  int endRow, endCol;
34 
35  SelectedText() {
36  startX = startY = -1;
37  endX = endY = -1;
38  startRow = startCol = -1;
39  endRow = endCol = -1;
40  }
41 
42  bool needsRender() {
43  return startX != endX || startY != endY;
44  }
45 };
46 
47 class MacText : public MacWidget {
48 public:
49  MacText(MacWidget *parent, int x, int y, int w, int h, MacWindowManager *wm, const Common::U32String &s, const MacFont *font, uint32 fgcolor, uint32 bgcolor, int maxWidth, TextAlign textAlignment = kTextAlignLeft, int interlinear = 0, uint16 border = 0, uint16 gutter = 0, uint16 boxShadow = 0, uint16 textShadow = 0, bool fixedDims = true, bool scrollBar = false);
50  // 0 pixels between the lines by default
51 
52  MacText(const Common::U32String &s, MacWindowManager *wm, const MacFont *font, uint32 fgcolor, uint32 bgcolor, int maxWidth, TextAlign textAlignment, int interlinear = 0, bool fixedDims = true, bool scrollBar = false);
53 
54  MacText(const Common::U32String &s, MacWindowManager *wm, const Font *font, uint32 fgcolor, uint32 bgcolor, int maxWidth, TextAlign textAlignment, int interlinear = 0, bool fixedDims = true, bool scrollBar = false);
55 
56  virtual ~MacText();
57 
58  virtual void resize(int w, int h);
59  bool processEvent(Common::Event &event) override;
60 
61  bool needsRedraw() override { return _contentIsDirty || _cursorDirty; }
62 
63  WindowClick isInScrollBar(int x, int y) const;
64  void setScrollBar(bool enable);
65  void resizeScrollBar(int w, int h);
66 
67  void setAutoSelect(bool enable) { _autoSelect = enable; }
68 
69  void render();
70  void undrawCursor();
71  void draw(ManagedSurface *g, int x, int y, int w, int h, int xoff, int yoff);
72  bool draw(ManagedSurface *g, bool forceRedraw = false) override;
73  bool draw(bool forceRedraw = false) override;
74  void drawToPoint(ManagedSurface *g, Common::Rect srcRect, Common::Point dstPoint);
75  void drawToPoint(ManagedSurface *g, Common::Point dstPoint);
76 
77  ManagedSurface *getSurface() { return _canvas._surface; }
78  int getInterLinear() { return _canvas._interLinear; }
79  void setInterLinear(int interLinear);
80  void setMaxWidth(int maxWidth);
81  void setDefaultFormatting(uint16 fontId, byte textSlant, uint16 fontSize,
82  uint16 palinfo1, uint16 palinfo2, uint16 palinfo3);
83  const MacFontRun &getDefaultFormatting() { return _defaultFormatting; }
84 
85  void setAlignOffset(TextAlign align);
86  TextAlign getAlign() { return _canvas._textAlignment; }
87  virtual Common::Point calculateOffset();
88  void setActive(bool active) override;
89  void setEditable(bool editable);
90  void setInputPadding(bool enable){ _addInputPadding = enable; }
91 
92  void setColors(uint32 fg, uint32 bg) override;
93  // set fgcolor for line x
94  void setTextColor(uint32 color, uint32 line);
95  void setTextColor(uint32 color, uint32 start, uint32 end);
96 
97  void appendText(const Common::U32String &str, int fontId = kMacFontSystem, int fontSize = 12, int fontSlant = kMacFontRegular, bool skipAdd = false);
98  void appendText(const Common::U32String &str, int fontId = kMacFontSystem, int fontSize = 12, int fontSlant = kMacFontRegular, uint16 r = 0, uint16 g = 0, uint16 b = 0, bool skipAdd = false);
99  void appendText(const Common::U32String &str, const Font *font, uint16 r = 0, uint16 g = 0, uint16 b = 0, bool skipAdd = false);
100 
101  int getTextFont() { return _defaultFormatting.fontId; }
102  void enforceTextFont(uint16 fontId);
103 
104  int getRowCount();
105 
106  // because currently, we are counting linespacing as font height
107  int getTextSize() { return _defaultFormatting.fontSize; }
108  void setTextSize(int textSize);
109 
110  int getTextSize(int start, int end);
111  void setTextSize(int textSize, int start, int end);
112 
113  uint32 getTextColor() { return _defaultFormatting.fgcolor; }
114  uint32 getTextColor(int start, int end);
115 
116  int getTextFont(int start, int end);
117  void setTextFont(int fontId, int start, int end);
118 
119  int getTextSlant() { return _defaultFormatting.textSlant; }
120  int getTextSlant(int start, int end);
121  void setTextSlant(int textSlant, int start, int end);
122  void enforceTextSlant(int textSlant);
123 
124  // director text related-functions
125  int getMouseChar(int x, int y);
126  int getMouseWord(int x, int y);
127  int getMouseItem(int x, int y);
128  int getMouseLine(int x, int y);
129  Common::U32String getMouseLink(int x, int y);
130 
131  bool setImageArchive(const Common::Path &name) { return _canvas._imageArchive.setImageArchive(name); }
132 
133 private:
134  MacFontRun getTextChunks(int start, int end);
135  void setTextChunks(int start, int end, int param, void (*callback)(MacFontRun &, int));
136 
137  void appendText_(const Common::U32String &strWithFont, uint oldLen);
138  void deletePreviousCharInternal(int *row, int *col);
139  void insertTextFromClipboard();
140  MacFontRun getFgColor();
141 
142 public:
143  void appendTextDefault(const Common::U32String &str, bool skipAdd = false);
144  void appendTextDefault(const Common::String &str, bool skipAdd = false);
145  void clearText();
146  void removeLastLine();
147  int getLineCount() { return _canvas._text.size(); }
148  int getLastLineWidth();
149  int getTextHeight() { return _canvas._textMaxHeight; }
150  int getLineHeight(int line);
151  int getTextMaxWidth() { return _canvas._textMaxWidth; }
152 
153  void setText(const Common::U32String &str);
154 
155  void setFixDims(bool fixed) { _fixedDims = fixed; }
156  bool getFixDims() { return _fixedDims; }
157 
158  void deleteSelection();
159  void deletePreviousChar(int *row, int *col);
160  void addNewLine(int *row, int *col);
161  void insertChar(byte c, int *row, int *col);
162 
163  void getChunkPosFromIndex(int index, uint &lineNum, uint &chunkNum, uint &offset);
164  void getRowCol(int x, int y, int *sx, int *sy, int *row, int *col, int *chunk_ = nullptr);
165  void getLineCharacter(int x, int y, int *sx, int *sy, int *line, int *character, int *chunk_ = nullptr);
166  Common::U32String getTextChunk(int startRow, int startCol, int endRow, int endCol, bool formatted = false, bool newlines = true);
167 
168  Common::U32String getSelection(bool formatted = false, bool newlines = true);
169  uint getSelectionIndex(bool start);
170  void clearSelection();
171  Common::U32String cutSelection();
172  const SelectedText *getSelectedText() { return &_selectedText; }
173  bool hasSelection() { return _selectedText.endY != -1; }
174 
175  int getLineSpacing() { return _canvas._interLinear; }
176 
182  void setSelection(int pos, bool start);
183 
184  Common::U32String getEditedString();
185  Common::U32String getText() { return _str; }
186  Common::U32String getPlainText();
187 
188  void setSelRange(int selStart, int selEnd);
189 
190  void scroll(int delta);
191 
192  // Markdown
193 public:
194  void setMarkdownText(const Common::U32String &str);
195 
196 private:
197  void init(uint32 fgcolor, uint32 bgcolor, int maxWidth, TextAlign textAlignment, int interlinear, uint16 textShadow, bool macFontMode);
198  bool isCutAllowed();
199 
200  void recalcDims();
201 
202  void drawSelection(int xoff, int yoff);
203  void updateCursorPos();
204 
205  void startMarking(int x, int y);
206  void updateTextSelection(int x, int y);
207 
211  void clearChunkInput();
212 
213 public:
214  int _cursorX, _cursorY;
215  bool _cursorState;
216  int _cursorRow, _cursorCol;
217 
218  bool _cursorDirty;
219  Common::Rect *_cursorRect;
220  bool _cursorOff;
221  bool _selectable;
222 
223  int _scrollPos;
224 
225  bool _fullRefresh;
226 
227 protected:
228  Common::U32String _str;
229  const MacFont *_macFont;
230 
231  bool _fixedDims;
232  bool _scrollBar;
233  MacWindowBorder _scrollBorder;
234  ManagedSurface _borderSurface;
235 
236  int _selEnd;
237  int _selStart;
238 
239  MacTextCanvas _canvas;
240 
241  MacFontRun _defaultFormatting;
242  MacFontRun _currentFormatting;
243 
244 private:
245  ManagedSurface *_cursorSurface;
246  ManagedSurface *_cursorSurface2;
247 
248  int _editableRow;
249 
250  bool _addInputPadding;
251 
252  bool _inTextSelection;
253  SelectedText _selectedText;
254  bool _selectionIsDirty;
255 
256  MacMenu *_menu;
257 
258  bool _autoSelect;
259 };
260 
261 int getStringWidth(MacFontRun &format, const Common::U32String &str);
262 
263 } // End of namespace Graphics
264 
265 #endif
Definition: managed_surface.h:51
Definition: str.h:59
Definition: font.h:83
TextAlign
Definition: font.h:48
Definition: mactext.h:47
Align the text to the left.
Definition: font.h:51
Definition: rect.h:524
Definition: path.h:52
Definition: mactext-canvas.h:32
Definition: macwindowmanager.h:147
Definition: mactext-canvas.h:110
Definition: ustr.h:57
Definition: events.h:210
Definition: formatinfo.h:28
Definition: rect.h:144
Definition: macwidget.h:39
Definition: macmenu.h:94
Definition: mactext.h:29
Definition: macfontmanager.h:106
Definition: macwindowborder.h:81