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