1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
#pragma once
#include "StarApplication.hpp"
#include "StarStatisticsService.hpp"
#include "StarP2PNetworkingService.hpp"
#include "StarUserGeneratedContentService.hpp"
#include "StarDesktopService.hpp"
#include "StarImage.hpp"
namespace Star {
STAR_CLASS(ApplicationController);
// Audio format is always 16 bit signed integer samples
struct AudioFormat {
unsigned sampleRate;
unsigned channels;
};
// Window size defaults to 800x600, target update rate to 60hz, maximized and
// fullscreen are false, vsync is on, the cursor is visible, and audio and text
// input are disabled.
class ApplicationController {
public:
virtual ~ApplicationController() = default;
// Target hz at which update() will be called
virtual void setTargetUpdateRate(float targetUpdateRate) = 0;
// Window that controls how long the update rate will be increased or
// decreased to make up for rate errors in the past.
virtual void setUpdateTrackWindow(float updateTrackWindow) = 0;
// Maximum number of calls to update() that can occur before we force
// 'render()' to be called, even if we are still behind on our update rate.
virtual void setMaxFrameSkip(unsigned maxFrameSkip) = 0;
virtual void setApplicationTitle(String title) = 0;
virtual void setFullscreenWindow(Vec2U fullScreenResolution) = 0;
virtual void setNormalWindow(Vec2U windowSize) = 0;
virtual void setMaximizedWindow() = 0;
virtual void setBorderlessWindow() = 0;
virtual void setVSyncEnabled(bool vSync) = 0;
virtual void setCursorVisible(bool cursorVisible) = 0;
virtual void setCursorPosition(Vec2I cursorPosition) = 0;
virtual void setCursorHardware(bool cursorHardware) = 0;
virtual bool setCursorImage(const String& id, const ImageConstPtr& image, unsigned scale, const Vec2I& offset) = 0;
virtual void setAcceptingTextInput(bool acceptingTextInput) = 0;
virtual AudioFormat enableAudio() = 0;
virtual void disableAudio() = 0;
typedef void (*AudioCallback)(void* userdata, uint8_t* stream, int len);
virtual bool openAudioInputDevice(const char* name, int freq, int channels, void* userdata, AudioCallback callback) = 0;
virtual bool closeAudioInputDevice() = 0;
virtual bool hasClipboard() = 0;
virtual void setClipboard(String text) = 0;
virtual Maybe<String> getClipboard() = 0;
virtual bool isFocused() const = 0;
// Returns the latest actual measured update and render rate, which may be
// different than the target update rate.
virtual float updateRate() const = 0;
virtual float renderFps() const = 0;
virtual StatisticsServicePtr statisticsService() const = 0;
virtual P2PNetworkingServicePtr p2pNetworkingService() const = 0;
virtual UserGeneratedContentServicePtr userGeneratedContentService() const = 0;
virtual DesktopServicePtr desktopService() const = 0;
// Signals the application to quit
virtual void quit() = 0;
};
}
|