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 
91  void setColors(uint32 fg, uint32 bg) override;
92  // set fgcolor for line x
93  void setTextColor(uint32 color, uint32 line);
94  void setTextColor(uint32 color, uint32 start, uint32 end);
95 
96  void appendText(const Common::U32String &str, int fontId = kMacFontSystem, int fontSize = 12, int fontSlant = kMacFontRegular, bool skipAdd = false);
97  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);
98  void appendText(const Common::U32String &str, const Font *font, uint16 r = 0, uint16 g = 0, uint16 b = 0, bool skipAdd = false);
99 
100  int getTextFont() { return _defaultFormatting.fontId; }
101  void enforceTextFont(uint16 fontId);
102 
103  int getRowCount();
104 
105  // because currently, we are counting linespacing as font height
106  int getTextSize() { return _defaultFormatting.fontSize; }
107  void setTextSize(int textSize);
108 
109  int getTextSize(int start, int end);
110  void setTextSize(int textSize, int start, int end);
111 
112  uint32 getTextColor() { return _defaultFormatting.fgcolor; }
113  uint32 getTextColor(int start, int end);
114 
115  int getTextFont(int start, int end);
116  void setTextFont(int fontId, int start, int end);
117 
118  int getTextSlant() { return _defaultFormatting.textSlant; }
119  int getTextSlant(int start, int end);
120  void setTextSlant(int textSlant, int start, int end);
121  void enforceTextSlant(int textSlant);
122 
123  // director text related-functions
124  int getMouseChar(int x, int y);
125  int getMouseWord(int x, int y);
126  int getMouseItem(int x, int y);
127  int getMouseLine(int x, int y);
128  Common::U32String getMouseLink(int x, int y);
129 
130  bool setImageArchive(const Common::Path &name) { return _canvas._imageArchive.setImageArchive(name); }
131 
132 private:
133  MacFontRun getTextChunks(int start, int end);
134  void setTextChunks(int start, int end, int param, void (*callback)(MacFontRun &, int));
135 
136  void appendText_(const Common::U32String &strWithFont, uint oldLen);
137  void deletePreviousCharInternal(int *row, int *col);
138  void insertTextFromClipboard();
139  MacFontRun getFgColor();
140 
141 public:
142  void appendTextDefault(const Common::U32String &str, bool skipAdd = false);
143  void appendTextDefault(const Common::String &str, bool skipAdd = false);
144  void clearText();
145  void removeLastLine();
146  int getLineCount() { return _canvas._text.size(); }
147  int getLastLineWidth();
148  int getTextHeight() { return _canvas._textMaxHeight; }
149  int getLineHeight(int line);
150  int getTextMaxWidth() { return _canvas._textMaxWidth; }
151 
152  void setText(const Common::U32String &str);
153 
154  void setFixDims(bool fixed) { _fixedDims = fixed; }
155  bool getFixDims() { return _fixedDims; }
156 
157  void deleteSelection();
158  void deletePreviousChar(int *row, int *col);
159  void addNewLine(int *row, int *col);
160  void insertChar(byte c, int *row, int *col);
161 
162  void getChunkPosFromIndex(int index, uint &lineNum, uint &chunkNum, uint &offset);
163  void getRowCol(int x, int y, int *sx, int *sy, int *row, int *col, int *chunk_ = nullptr);
164  void getLineCharacter(int x, int y, int *sx, int *sy, int *line, int *character, int *chunk_ = nullptr);
165  Common::U32String getTextChunk(int startRow, int startCol, int endRow, int endCol, bool formatted = false, bool newlines = true);
166 
167  Common::U32String getSelection(bool formatted = false, bool newlines = true);
168  uint getSelectionIndex(bool start);
169  void clearSelection();
170  Common::U32String cutSelection();
171  const SelectedText *getSelectedText() { return &_selectedText; }
172  bool hasSelection() { return _selectedText.endY != -1; }
173 
174  int getLineSpacing() { return _canvas._interLinear; }
175 
181  void setSelection(int pos, bool start);
182 
183  Common::U32String getEditedString();
184  Common::U32String getText() { return _str; }
185  Common::U32String getPlainText();
186 
187  void setSelRange(int selStart, int selEnd);
188 
189  void scroll(int delta);
190 
191  // Markdown
192 public:
193  void setMarkdownText(const Common::U32String &str);
194 
195 private:
196  void init(uint32 fgcolor, uint32 bgcolor, int maxWidth, TextAlign textAlignment, int interlinear, uint16 textShadow, bool macFontMode);
197  bool isCutAllowed();
198 
199  void recalcDims();
200 
201  void drawSelection(int xoff, int yoff);
202  void updateCursorPos();
203 
204  void startMarking(int x, int y);
205  void updateTextSelection(int x, int y);
206 
210  void clearChunkInput();
211 
212 public:
213  int _cursorX, _cursorY;
214  bool _cursorState;
215  int _cursorRow, _cursorCol;
216 
217  bool _cursorDirty;
218  Common::Rect *_cursorRect;
219  bool _cursorOff;
220  bool _selectable;
221 
222  int _scrollPos;
223 
224  bool _fullRefresh;
225 
226 protected:
227  Common::U32String _str;
228  const MacFont *_macFont;
229 
230  bool _fixedDims;
231  bool _scrollBar;
232  MacWindowBorder _scrollBorder;
233  ManagedSurface _borderSurface;
234 
235  int _selEnd;
236  int _selStart;
237 
238  MacTextCanvas _canvas;
239 
240  MacFontRun _defaultFormatting;
241  MacFontRun _currentFormatting;
242 
243 private:
244  ManagedSurface *_cursorSurface;
245  ManagedSurface *_cursorSurface2;
246 
247  int _editableRow;
248 
249  bool _inTextSelection;
250  SelectedText _selectedText;
251  bool _selectionIsDirty;
252 
253  MacMenu *_menu;
254 
255  bool _autoSelect;
256 };
257 
258 int getStringWidth(MacFontRun &format, const Common::U32String &str);
259 
260 } // End of namespace Graphics
261 
262 #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:80