HandmadeHero/project/platform/platform.hpp

79 lines
2.6 KiB
C++
Raw Normal View History

2023-09-15 18:35:27 -07:00
/*
Platform abstraction layer for the project.
Services the platform provides to the engine & game.
2023-09-23 18:03:33 -07:00
2023-09-24 19:37:05 -07:00
This should be the only file the engine or game layer can include related to the platform layer.
(Public Interface essentially...)
2023-09-15 18:35:27 -07:00
*/
#pragma once
2023-09-20 21:26:23 -07:00
#pragma warning( disable: 4201 ) // Support for non-standard nameless struct or union extesnion
#pragma warning( disable: 4100 ) // Support for unreferenced formal parameters
#pragma warning( disable: 4800 ) // Support implicit conversion to bools
#pragma warning( disable: 4365 ) // Support for signed/unsigned mismatch auto-conversion
#pragma warning( disable: 4189 ) // Support for unused variables
#pragma warning( disable: 4514 ) // Support for unused inline functions
#pragma warning( disable: 4505 ) // Support for unused static functions
2023-09-21 23:16:40 -07:00
#pragma warning( disable: 5045 ) // Compiler will insert Spectre mitigation for memory load if /Qspectre switch specified
2023-09-20 21:26:23 -07:00
2023-09-23 18:03:33 -07:00
// TODO(Ed) : REMOVE THESE WHEN HE GETS TO THEM
#include <math.h> // TODO : Implement math ourselves
#include <stdio.h> // TODO : Implement output logging ourselves
#include "grime.hpp"
#include "macros.hpp"
#include "generics.hpp"
#include "math_constants.hpp"
#include "types.hpp"
2023-09-20 11:43:55 -07:00
#define NS_PLATFORM_BEGIN namespace platform {
#define NS_PLATFORM_END }
NS_PLATFORM_BEGIN
#if Build_Debug
/*
IMPORTANT : These are not for shipping code - they are blocking and the write isn't protected.
*/
struct Debug_FileContent
{
void* Data;
2023-09-20 21:26:23 -07:00
u32 Size;
char _PAD_[4];
2023-09-20 11:43:55 -07:00
};
void debug_file_free_content ( Debug_FileContent* file_content );
2023-09-23 18:03:33 -07:00
Debug_FileContent debug_file_read_content ( char const* file_path );
b32 debug_file_write_content( char const* file_path, u32 content_size, void* content_memory );
2023-09-20 11:43:55 -07:00
2023-09-24 19:37:05 -07:00
// Allows the engine or game to pause the renderering of any next frames.
// ( Prevents blipping of the black buffer )
void set_pause_rendering( b32 value );
#endif
2023-09-23 18:03:33 -07:00
// On-Demand platform interface.
// Everything exposed here should be based on a feature a game may want to provide a user
// (Example: Letting the user change the refresh-rate of the monitor or the engine's target frame-rate)
// TODO(Ed) : Implement this later when settings UI is setup.
#pragma region Settings Exposure
2023-09-24 19:37:05 -07:00
// Exposing specific properties for user configuration in settings
2023-09-23 18:03:33 -07:00
// Returns the current monitor refresh rate.
2023-09-24 19:37:05 -07:00
u32 get_monitor_refresh_rate();
2023-09-23 18:03:33 -07:00
// Sets the monitor refresh rate
// Must be of the compatiable listing for the monitor the window surface is presenting to.
void set_monitor_refresh_rate( u32 rate_in_hz );
2023-09-24 19:37:05 -07:00
u32 get_engine_frame_target();
2023-09-23 18:03:33 -07:00
2023-09-24 19:37:05 -07:00
void set_engine_frame_target( u32 rate_in_hz );
2023-09-23 18:03:33 -07:00
#pragma endregion Settings Exposure
2023-09-24 19:37:05 -07:00
NS_PLATFORM_END