Fission FSN
Loading...
Searching...
No Matches
fsIDisplay.h
Go to the documentation of this file.
1/********************************************************************
2*
3* Created: 3/3/2014 12:32
4*
5* File: fsIDisplay.h
6*
7* Author: Mick Waites
8*
9* Purpose: Creation and control of the app window and full
10* screen display (where applicable) and transformation
11* of visual entities from canvas space to screen space.
12*
13*********************************************************************/
14
15#ifndef fsIDisplayhdr
16#define fsIDisplayhdr
17
18#include <list>
19
21#include "fsINode.h"
22
23#include "src/fsCDisplayMode.h"
24
25class fsCAppCoreMain;
26class fsICursor;
27class fsCScreenFade;
28
29
30class fsIDisplay : protected fsINode
31{
32 friend class fsCAppCoreMain;
33 friend class fsICursor;
34 friend class fsCScreenFade;
35
36public:
37
39
40 void defaultCameraFlagSet(fsU32 pFlag);
41 fsBool wideScreenGet() const;
42
44
45 void fullScreenToggle();
48 // Height that level art and layouts are authored against. Differs from designCanvasHeightGet()
49 // only when appSettings adaptiveCanvasHeight has grown the canvas past the authored size.
54 fsBool screenModeSet(fsBool pFullScreen);
55 const fsVec2d& scaleGet() const;
56 const fsAffineMtx2d& renderMatrixGet() const;
57
58 static fsBool fixedAspectGet();
59
60 static fsIDisplay* create();
61 static fsIDisplay* instanceGet();
62 ~fsIDisplay() override;
63
64protected:
65
67 void clipWindowSet(const fsCDisplayMode* const pDisplayMode);
68
69 virtual fsBool windowModeAvailableGetDo(const fsCDisplayMode* const pBestMode) const { return false; }
70
71 virtual fsBool displayTypeIsDesktopGet() const = 0;
72 virtual fsPoint fixedDisplaySizeGet() const = 0;
74 virtual fsBool desktopScreenModeSetDo(const fsCDisplayMode* pDisplayMode, fsBool pFullScreen) = 0;
75
76 const fsPoint& startupDimensionsGet() const { return mStartupDimensions; }
77 void screenModeAdd(fsS32 pW, fsS32 pH, fsS32 pBitDepth);
78
79 fsIDisplay();
81
82private:
83
84 virtual void defaultCameraFlagSetDo(fsU32 pFlag) {}
85
86 virtual fsS32 retinaScaleFactorGetDo() const { return 1; }
87 virtual void clipWindowSetDo(const fsCDisplayMode* const pDisplayMode) {}
88
89 void windowModeLocate();
90
91 typedef fsBool (fsIDisplay::*fsTDistlayMemCriteriaFnc)(fsCDisplayMode* pScreenMode) const;
92 fsBool failSafeResolutionCriteria(fsCDisplayMode* pScreenMode) const;
93 fsBool desktopResolutionCriteria(fsCDisplayMode* pScreenMode) const;
94 void displayModeLocate(fsCDisplayMode*& pMode, fsTDistlayMemCriteriaFnc pCriteria, fsBool pFirstMatch);
95
96 void desktopScreenModesEnumerate();
97
98 void initialise();
99 void designedScreenModeDetermine(const fsCDisplayMode* pMode = nullptr);
100 void matrixSetForDisplaySize(const fsCDisplayMode* pDisplayMode);
101 void bestWindowedScreenModeDetermine();
102
103 void fixedAspectCalculate(fsF32& scaleX, fsF32& scaleY, const fsCDisplayMode* const pDisplayMode);
104
105 fsBool simulatedFixedDisplayConfigure();
106 fsBool mSimulatingFixedDisplay;
107
108 static const fsStr mAppCanvasWKey;
109 static const fsStr mAppCanvasHKey;
110
111 fsPoint mStartupDimensions;
112 fsCDisplayMode mDeviceOriginalDisplayMode;
113 fsCDisplayMode mDesktopWindowDisplayMode;
114
115 fsBool mFullScreen;
116
117 fsCDisplayMode* mBestDeviceDisplayMode;
118 std::list<fsCDisplayMode*> mScreenModes;
119};
120
121#endif
Definition fsAffineMtx2d.h:27
Definition fsCAppCoreMain.h:50
Definition fsCDisplayMode.h:20
Definition fsCScreenFade.h:25
Definition fsCUniqueId.h:21
Definition fsICursor.h:20
const fsPoint & startupDimensionsGet() const
Definition fsIDisplay.h:76
fsIDisplay()
Definition fsIDisplay.cpp:455
friend class fsCScreenFade
Definition fsIDisplay.h:34
const fsAffineMtx2d & renderMatrixGet() const
Definition fsIDisplay.cpp:125
const fsVec2d & scaleGet() const
Definition fsIDisplay.cpp:120
fsBool windowModeAvailableGet() const
Definition fsIDisplay.cpp:45
void clipWindowSet(const fsCDisplayMode *const pDisplayMode)
Definition fsIDisplay.cpp:391
void defaultCameraFlagSet(fsU32 pFlag)
Definition fsIDisplay.cpp:35
fsS32 designCanvasHeightGet() const
Definition fsIDisplay.cpp:81
friend class fsICursor
Definition fsIDisplay.h:33
fsS32 visibleCanvasHeightGet() const
Definition fsIDisplay.cpp:108
virtual fsBool desktopScreenModeSetDo(const fsCDisplayMode *pDisplayMode, fsBool pFullScreen)=0
static fsBool fixedAspectGet()
Definition fsIDisplay.cpp:40
static const fsCUniqueId mEventFullScreenToggleMsg
Definition fsIDisplay.h:38
static fsIDisplay * create()
Definition fsIDisplay.cpp:404
fsS32 retinaScaleFactorGet() const
Definition fsIDisplay.cpp:399
friend class fsCAppCoreMain
Definition fsIDisplay.h:32
virtual void desktopScreenModesEnumerateDo()=0
~fsIDisplay() override
Definition fsIDisplay.cpp:463
virtual fsBool windowModeAvailableGetDo(const fsCDisplayMode *const pBestMode) const
Definition fsIDisplay.h:69
void screenModeAdd(fsS32 pW, fsS32 pH, fsS32 pBitDepth)
Definition fsIDisplay.cpp:278
fsBool wideScreenGet() const
Definition fsIDisplay.cpp:170
fsCDisplayMode mDesignedDisplayMode
Definition fsIDisplay.h:80
static fsIDisplay * instanceGet()
Definition fsIDisplay.cpp:412
fsS32 authoredCanvasHeightGet() const
Definition fsIDisplay.cpp:86
void fullScreenToggle()
Definition fsIDisplay.cpp:55
fsS32 visibleCanvasWidthGet() const
Definition fsIDisplay.cpp:96
fsBool screenModeSet(fsBool pFullScreen)
Definition fsIDisplay.cpp:179
virtual fsBool displayTypeIsDesktopGet() const =0
fsS32 designCanvasWidthGet() const
Definition fsIDisplay.cpp:76
virtual fsPoint fixedDisplaySizeGet() const =0
fsBool displayIsWideScreenGet() const
Definition fsIDisplay.cpp:316
fsINode(const fsStr &pName)
Definition fsINode.cpp:678
unsigned int fsU32
Definition fsBaseTypes.h:21
bool fsBool
Definition fsBaseTypes.h:26
int fsS32
Definition fsBaseTypes.h:20
float fsF32
Definition fsBaseTypes.h:28
Definition fsPoint.h:17
Definition fsVec2d.h:16