ScummVM API documentation
macwindowmanager.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_MACWINDOWMANAGER_H
23 #define GRAPHICS_MACGUI_MACWINDOWMANAGER_H
24 
25 #include "common/hashmap.h"
26 #include "common/list.h"
27 #include "common/mutex.h"
28 #include "common/stack.h"
29 #include "common/events.h"
30 
31 #include "graphics/font.h"
32 #include "graphics/fontman.h"
33 #include "graphics/palette.h"
34 #include "graphics/macgui/macwindow.h"
35 #include "graphics/macgui/macmenu.h"
36 
37 #include "engines/engine.h"
38 
39 namespace Common {
40 class Archive;
41 }
42 
43 namespace Graphics {
44 
45 namespace MacGUIConstants {
46 enum {
47  kDesktopArc = 7
48 };
49 
50 enum {
51  kColorBlack = 0,
52  kColorGray80 = 1,
53  kColorGray88 = 2,
54  kColorGrayEE = 3,
55  kColorWhite = 4,
56  kColorGreen = 5,
57  kColorGreen2 = 6,
58  kColorCount
59 };
60 
61 enum {
62  kPatternSolid = 1,
63  kPatternStripes = 2,
64  kPatternCheckers = 3,
65  kPatternCheckers2 = 4,
66  kPatternLightGray = 5,
67  kPatternDarkGray = 6
68 };
69 
70 enum MacCursorType {
71  kMacCursorArrow,
72  kMacCursorBeam,
73  kMacCursorCrossHair,
74  kMacCursorCrossBar,
75  kMacCursorWatch,
76  kMacCursorCustom,
77  kMacCursorOff
78 };
79 
80 enum {
81  kWMModeNone = 0,
82  kWMModeNoDesktop = (1 << 0),
83  kWMModeAutohideMenu = (1 << 1),
84  kWMModalMenuMode = (1 << 2),
85  kWMModeForceBuiltinFonts = (1 << 3),
86  kWMModeUnicode = (1 << 4),
87  kWMModeManualDrawWidgets = (1 << 5),
88  kWMModeFullscreen = (1 << 6),
89  kWMModeButtonDialogStyle = (1 << 7),
90  kWMMode32bpp = (1 << 8),
91  kWMNoScummVMWallpaper = (1 << 9),
92  kWMModeWin95 = (1 << 10),
93  kWMModeForceMacFontsInWin95 = (1 << 11), // Enforce Mac font for languages which don't have glyphs in ms_sans_serif.ttf
94  kWMModeNoCursorOverride = (1 << 12),
95  kWMModeForceMacBorder = (1 << 13),
96 };
97 
98 }
99 using namespace MacGUIConstants;
100 
101 class Cursor;
102 
103 class ManagedSurface;
104 
105 class MacCursor;
106 class MacMenu;
107 class MacTextWindow;
108 class MacWidget;
109 
110 class MacFont;
111 
112 class MacFontManager;
113 
114 typedef Common::Array<byte *> MacPatterns;
115 
116 struct MacPlotData {
117  Graphics::ManagedSurface *surface;
119  MacPatterns *patterns;
120  uint fillType;
121  int fillOriginX;
122  int fillOriginY;
123  int thickness;
124  uint bgColor;
125  bool invert;
126 
127  MacPlotData(Graphics::ManagedSurface *s, Graphics::ManagedSurface *m, MacPatterns *p, uint f, int fx, int fy, int t, uint bg, bool inv = false) :
128  surface(s), mask(m), patterns(p), fillType(f), fillOriginX(fx), fillOriginY(fy), thickness(t), bgColor(bg), invert(inv) {
129  }
130 };
131 
132 struct ZoomBox {
133  Common::Rect start;
134  Common::Rect end;
136  int delay;
137  int step;
138  uint32 startTime;
139  uint32 nextTime;
140 };
141 
142 typedef void (* MacDrawPixPtr)(int, int, int, void *);
143 
149 public:
150  MacWindowManager(uint32 mode = 0, MacPatterns *patterns = nullptr, Common::Language language = Common::UNK_LANG);
151  ~MacWindowManager();
152 
153  MacDrawPixPtr getDrawPixel();
154  MacDrawPixPtr getDrawInvertPixel();
155 
161  void setScreen(ManagedSurface *screen);
162 
168  void setScreen(int w, int h);
169 
170  int getWidth();
171 
172  int getHeight();
173 
182  MacWindow *addWindow(bool scrollable, bool resizable, bool editable);
183  MacTextWindow *addTextWindow(const MacFont *font, int fgcolor, int bgcolor, int maxWidth, TextAlign textAlignment, MacMenu *menu, bool cursorHandler = true);
184  MacTextWindow *addTextWindow(const Font *font, int fgcolor, int bgcolor, int maxWidth, TextAlign textAlignment, MacMenu *menu, bool cursorHandler = true);
185  void resizeScreen(int w, int h);
186 
192  void addWindowInitialized(MacWindow *macwindow);
197  int getLastId() { return _lastId; }
202  int getNextId() { return _lastId++; }
209  MacMenu *addMenu();
210  void addMenu(int id, MacMenu *menu);
211 
212  void removeMenu();
213  void activateMenu();
214 
215  void activateScreenCopy();
216  void disableScreenCopy();
217 
218  bool isMenuActive();
219  void setDesktopMode(uint32 mode);
220 
224  void setMenuHotzone(const Common::Rect &rect) { _menuHotzone = rect; }
225 
229  void setMenuDelay(int delay) { _menuDelay = delay; }
230 
235  void setActiveWindow(int id);
236 
242  MacWindow *findWindowAtPoint(int16 x, int16 y);
247  MacWindow *findWindowAtPoint(Common::Point point);
248 
254  void removeWindow(MacWindow *target);
255 
260  void setFullRefresh(bool redraw) { _fullRefresh = redraw; }
261 
268  void draw();
269 
277  bool processEvent(Common::Event &event);
278 
284  BaseMacWindow *getWindow(int id) { return _windows[id]; }
285 
290  MacPatterns &getPatterns() { return _patterns; }
291 
297  void setActiveWidget(MacWidget *widget);
298 
305  void setLockedWidget(MacWidget *widget);
306 
312  void setBackgroundWindow(MacWindow *window);
313 
314  MacPatterns &getBuiltinPatterns() { return _builtinPatterns; }
315 
316  MacWidget *getActiveWidget() { return _activeWidget; }
317  MacWidget *getLockedWidget() { return _lockedWidget; }
318 
319  Common::Rect getScreenBounds() { return _screen ? _screen->getBounds() : _screenDims; }
320 
321  void clearWidgetRefs(MacWidget *widget);
322 
323  void printWMMode(int debuglevel = 0);
324 
325 private:
326  void replaceCursorType(MacCursorType type);
327 
328 public:
329  MacCursorType getCursorType() const;
330 
331  void pushCursor(MacCursorType type, Cursor *cursor = nullptr);
332  void replaceCursor(MacCursorType type, Cursor *cursor = nullptr);
333 
334  void pushCustomCursor(const byte *data, int w, int h, int hx, int hy, int transcolor);
335  void replaceCustomCursor(const byte *data, int w, int h, int hx, int hy, int transcolor);
336  void pushCustomCursor(const Graphics::Cursor *cursor);
337  void popCursor();
338 
339  PauseToken pauseEngine();
340 
341  void setMode(uint32 mode);
342 
343  void setEngine(Engine *engine);
344  void setEngineRedrawCallback(void *engine, void (*redrawCallback)(void *engine));
345 
346  void passPalette(const byte *palette, uint size);
347  template <typename T> void decomposeColor(uint32 color, byte &r, byte &g, byte &b);
348  uint32 findBestColor(byte cr, byte cg, byte cb);
349  uint32 findBestColor(uint32 color);
350  void setDesktopColor(byte, byte, byte);
351 
352  byte inverter(byte src);
353 
354  const byte *getPalette() { return _palette; }
355  uint getPaletteSize() { return _paletteSize; }
356 
357  void renderZoomBox(bool redraw = false);
358  void addZoomBox(ZoomBox *box);
359 
360  void removeMarked();
361 
362  void loadDataBundle();
363  void cleanupDataBundle();
364  void cleanupDesktopBmp();
365 
366  BorderOffsets getBorderOffsets(uint32 windowType);
367  Common::SeekableReadStream *getBorderFile(uint32 windowType, uint32 flags);
368  Common::SeekableReadStream *getFile(const Common::Path &filename);
369 
370  void setTextInClipboard(const Common::U32String &str);
376  Common::U32String getTextFromClipboard(const Common::U32String &format = Common::U32String(), int *size = nullptr);
377 
383  void clearHandlingWidgets();
384 
385  void setMenuItemCheckMark(MacMenuItem *menuItem, bool checkMark);
386  void setMenuItemEnabled(MacMenuItem *menuItem, bool enabled);
387  void setMenuItemName(MacMenuItem *menuItem, const Common::String &name);
388  void setMenuItemAction(MacMenuItem *menuItem, int actionId);
389 
390  bool getMenuItemCheckMark(MacMenuItem *menuItem);
391  bool getMenuItemEnabled(MacMenuItem *menuItem);
392  Common::String getMenuItemName(MacMenuItem *menuItem);
393  int getMenuItemAction(MacMenuItem *menuItem);
394  MacMenu *getMenu();
395  MacMenu *getMenu(int id);
396 
397 public:
398  MacFontManager *_fontMan;
399  uint32 _mode;
400  Common::Language _language;
401 
402  Common::Point _lastClickPos;
403  Common::Point _lastMousePos;
404  Common::Rect _menuHotzone;
405 
406  uint32 _menuTimer;
407  bool _mouseDown;
408 
409  uint32 _colorBlack, _colorGray80, _colorGray88, _colorGrayEE, _colorWhite, _colorGreen, _colorGreen2;
410 
411  MacWidget *_hoveredWidget;
412 
413  // we use it to indicate whether we are clicking the hilite-able widget.
414  // In list style button mode, we will highlight the subsequent buttons only when we've clicked the hilite-able button initially
415  bool _hilitingWidget;
416 
417 private:
418  void loadDesktop();
419  void drawDesktop();
420 
421  void removeFromStack(BaseMacWindow *target);
422  void removeFromWindowList(BaseMacWindow *target);
423 
424  void zoomBoxInner(Common::Rect &r, Graphics::MacPlotData &pd);
425  bool haveZoomBox() { return !_zoomBoxes.empty(); }
426 
427  void adjustDimensions(const Common::Rect &clip, const Common::Rect &dims, int &adjWidth, int &adjHeight);
428 
429 public:
430  Surface *_desktopBmp;
431  ManagedSurface *_desktop;
432  PixelFormat _pixelformat;
433 
434  ManagedSurface *_screen;
435  ManagedSurface *_screenCopy;
436  Common::Rect _screenDims;
437 
438 private:
439  Common::Mutex _mutex;
440  Common::List<BaseMacWindow *> _windowStack;
442 
443  Common::List<BaseMacWindow *> _windowsToRemove;
444  bool _needsRemoval;
445 
446  int _lastId;
447  int _activeWindow;
448 
449  bool _fullRefresh;
450 
451  bool _inEditableArea;
452 
453  MacPatterns _patterns;
454  MacPatterns _builtinPatterns;
455  byte *_palette;
456  uint _paletteSize;
457 
458  MacMenu *_menu;
459  uint32 _menuDelay;
460 
461  Engine *_engineP;
462  void *_engineR;
463  void (*_redrawEngineCallback)(void *engine);
464 
465  MacCursorType _tempType = kMacCursorArrow;
466  Common::Stack<MacCursorType> _cursorTypeStack;
467  Cursor *_cursor = nullptr;
468 
469  MacWidget *_activeWidget;
470  MacWidget *_lockedWidget;
471  MacWindow *_backgroundWindow;
472 
473  PauseToken *_screenCopyPauseToken;
474 
475  Common::Array<ZoomBox *> _zoomBoxes;
476  Graphics::PaletteLookup _paletteLookup;
477  Common::HashMap<uint, uint> _invertColorHash;
478 
479  Common::Archive *_dataBundle;
480 
481  Common::U32String _clipboard;
482 };
483 
484 const Common::U32String::value_type *readHex(uint16 *res, const Common::U32String::value_type *s, int len);
485 
486 } // End of namespace Graphics
487 
488 #endif
Definition: managed_surface.h:51
Definition: engine.h:102
Definition: str.h:59
Definition: font.h:82
TextAlign
Definition: font.h:48
Definition: surface.h:67
BaseMacWindow * getWindow(int id)
Definition: macwindowmanager.h:284
Definition: pixelformat.h:138
Definition: macfontmanager.h:127
Definition: macwindow.h:192
Definition: mactextwindow.h:30
Definition: macwindowmanager.h:132
MacPatterns & getPatterns()
Definition: macwindowmanager.h:290
Definition: palette.h:153
Definition: list.h:44
Definition: rect.h:144
Definition: path.h:52
void setMenuHotzone(const Common::Rect &rect)
Definition: macwindowmanager.h:224
Definition: stream.h:745
Definition: macwindowmanager.h:148
int getNextId()
Definition: macwindowmanager.h:202
Definition: archive.h:141
Definition: macwindowborder.h:57
Definition: hashmap.h:85
Definition: ustr.h:57
Definition: atari-cursor.h:38
Definition: cursor.h:42
Definition: events.h:199
Definition: algorithm.h:29
Definition: formatinfo.h:28
Definition: mutex.h:67
Definition: rect.h:45
Definition: macwidget.h:39
Definition: macmenu.h:94
Definition: macwindowmanager.h:116
Definition: macfontmanager.h:85
int getLastId()
Definition: macwindowmanager.h:197
Definition: macmenu.h:59
Definition: macwindow.h:73
Definition: engine.h:143
void setMenuDelay(int delay)
Definition: macwindowmanager.h:229
Language
Definition: language.h:45
void setFullRefresh(bool redraw)
Definition: macwindowmanager.h:260