OpenTTD Source
20240917-master-g9ab0a47812
|
Go to the documentation of this file.
10 #ifndef VIDEO_VIDEO_DRIVER_HPP
11 #define VIDEO_VIDEO_DRIVER_HPP
13 #include "../driver.h"
14 #include "../core/geometry_type.hpp"
15 #include "../core/math_func.hpp"
16 #include "../gfx_func.h"
17 #include "../settings_type.h"
18 #include "../zoom_type.h"
19 #include "../network/network_func.h"
22 #include <condition_variable>
48 virtual void MakeDirty(
int left,
int top,
int width,
int height) = 0;
85 virtual bool ClaimMousePointer()
175 return Clamp(dpi_scale * 100, MIN_INTERFACE_SCALE, MAX_INTERFACE_SCALE);
178 virtual std::string_view GetInfoString()
const
191 std::lock_guard<std::mutex>
lock(this->cmd_queue_mutex);
193 this->cmd_queue.emplace_back(std::forward<std::function<
void()>>(func));
313 std::chrono::steady_clock::duration GetGameInterval()
315 #ifdef DEBUG_DUMP_COMMANDS
317 extern bool _ddc_fastforward;
318 if (_ddc_fastforward)
return std::chrono::microseconds(0);
324 if (
_game_speed == 0)
return std::chrono::microseconds(0);
329 std::chrono::steady_clock::duration GetDrawInterval()
332 if (
_video_vsync && this->uses_hardware_acceleration)
return std::chrono::microseconds(0);
339 std::vector<std::function<void()>> cmds{};
345 std::lock_guard<std::mutex>
lock(this->cmd_queue_mutex);
346 cmds.swap(this->cmd_queue);
349 for (
auto &f : cmds) {
354 std::chrono::steady_clock::time_point next_game_tick;
355 std::chrono::steady_clock::time_point next_draw_tick;
360 bool is_game_threaded;
361 std::thread game_thread;
362 std::mutex game_state_mutex;
363 std::mutex game_thread_wait_mutex;
365 bool uses_hardware_acceleration;
370 std::mutex cmd_queue_mutex;
371 std::vector<std::function<void()>> cmd_queue;
void Tick()
Give the video-driver a tick.
virtual bool HasAnimBuffer()
Does this video driver support a separate animation buffer in addition to the colour buffer?
static Driver ** GetActiveDriver(Driver::Type type)
Get the active driver for the given type.
The base of all video drivers.
Dimensions (a width and height) of a rectangle in 2D.
std::mutex lock
synchronization for playback status fields
virtual void CheckPaletteAnim()
Process any pending palette animation.
virtual void ToggleVsync([[maybe_unused]] bool vsync)
Change the vsync setting.
virtual void MakeDirty(int left, int top, int width, int height)=0
Mark a particular area dirty.
virtual bool ToggleFullscreen(bool fullscreen)=0
Change the full screen setting.
Dimension _cur_resolution
The current resolution.
ClientSettings _settings_client
The current settings for this game.
constexpr uint ClampU(const uint a, const uint min, const uint max)
Clamp an unsigned integer between an interval.
virtual bool HasGUI() const
Whether the driver has a graphical user interface with the end user.
void StartGameThread()
Start the loop for game-tick.
virtual void ClearSystemSprites()
Clear all cached sprites.
bool _video_vsync
Whether we should use vsync (only if active video driver supports HW acceleration).
virtual float GetDPIScale()
Get DPI scaling factor of the screen OTTD is displayed on.
uint16_t refresh_rate
How often we refresh the screen (time between draw-ticks).
const uint DEFAULT_WINDOW_HEIGHT
Default window height.
virtual void InputLoop()
Handle input logic, is CTRL pressed, should we fast-forward, etc.
virtual std::vector< int > GetListOfMonitorRefreshRates()
Get a list of refresh rates of each available monitor.
virtual void Paint()
Paint the window.
bool _rightclick_emulate
Whether right clicking is emulated.
const uint ALLOWED_DRIFT
How many times videodriver can miss deadlines without it being overly compensated.
PauseMode _pause_mode
The current pause mode.
virtual uint8_t * GetAnimBuffer()
Get a pointer to the animation buffer of the video back-end.
virtual bool ChangeResolution(int w, int h)=0
Change the resolution of the window.
void QueueOnMainThread(std::function< void()> &&func)
Queue a function to be called on the main thread with game state lock held and video buffer locked.
uint16_t _game_speed
Current game-speed; 100 is 1x, 0 is infinite.
static VideoDriver * GetInstance()
Get the currently active instance of the video driver.
virtual void UnlockVideoBuffer()
Unlock a previously locked video buffer.
virtual bool UseSystemCursor()
Get whether the mouse cursor is drawn by the video driver.
void GameLoopPause()
Pause the game-loop for a bit, releasing the game-state lock.
void StopGameThread()
Stop the loop for the game-tick.
virtual void PopulateSystemSprites()
Populate all sprites in cache.
virtual std::string_view GetName() const =0
Get the name of this driver.
static std::string GetCaption()
Get the caption to use for the game's title bar.
void UpdateAutoResolution()
Apply resolution auto-detection and clamp to sensible defaults.
@ DT_VIDEO
A video driver.
bool unlock
Stores if the lock did anything that has to be undone.
void DrainCommandQueue()
Execute all queued commands.
std::string _ini_videodriver
The video driver a stored in the configuration file.
bool fast_forward_via_key
The fast-forward was enabled by key press.
virtual int GetSuggestedUIScale()
Get a suggested default GUI scale taking screen DPI into account.
bool _video_hw_accel
Whether to consider hardware accelerated video drivers on startup.
static const uint MILLISECONDS_PER_TICK
The number of milliseconds per game tick.
void SleepTillNextTick()
Sleep till the next tick is about to happen.
virtual void MainLoop()=0
Perform the actual drawing.
bool fast_forward_key_pressed
The fast-forward key is being pressed.
virtual bool HasEfficient8Bpp() const
Has this video driver an efficient code path for palette animated 8-bpp sprites?
virtual bool LockVideoBuffer()
Make sure the video buffer is ready for drawing.
virtual void EditBoxLostFocus()
An edit box lost the input focus.
const uint DEFAULT_WINDOW_WIDTH
Default window width.
constexpr T Clamp(const T a, const T min, const T max)
Clamp a value between an interval.
A driver for communicating with the user.
std::vector< Dimension > _resolutions
List of resolutions.
virtual bool PollEvent()
Process a single system event.
Helper struct to ensure the video buffer is locked and ready for drawing.
GUISettings gui
settings related to the GUI
virtual Dimension GetScreenSize() const
Get the resolution of the main screen.
virtual void EditBoxGainedFocus()
An edit box gained the input focus.
virtual bool AfterBlitterChange()
Callback invoked after the blitter was changed.