|
|
@ -0,0 +1,422 @@ |
|
|
|
/********************************************************************************************** |
|
|
|
* |
|
|
|
* rcore_<platform> template - Functions to manage window, graphics device and inputs |
|
|
|
* |
|
|
|
* PLATFORM: HEADLESS |
|
|
|
* - Headless mode for all OSes, platform independant |
|
|
|
* - All graphical/audio/input related functions do nothing |
|
|
|
* |
|
|
|
* LIMITATIONS: |
|
|
|
* - Limitation 01 |
|
|
|
* - Limitation 02 |
|
|
|
* |
|
|
|
* POSSIBLE IMPROVEMENTS: |
|
|
|
* - Improvement 01 |
|
|
|
* - Improvement 02 |
|
|
|
* |
|
|
|
* ADDITIONAL NOTES: |
|
|
|
* - TRACELOG() function is located in raylib [utils] module |
|
|
|
* |
|
|
|
* CONFIGURATION: |
|
|
|
* #define RCORE_PLATFORM_CUSTOM_FLAG |
|
|
|
* Custom flag for rcore on target platform -not used- |
|
|
|
* |
|
|
|
* DEPENDENCIES: |
|
|
|
* - <platform-specific SDK dependency> |
|
|
|
* - gestures: Gestures system for touch-ready devices (or simulated from mouse inputs) |
|
|
|
* |
|
|
|
* |
|
|
|
* LICENSE: zlib/libpng |
|
|
|
* |
|
|
|
* Copyright (c) 2013-2025 Ramon Santamaria (@raysan5) and contributors |
|
|
|
* |
|
|
|
* This software is provided "as-is", without any express or implied warranty. In no event |
|
|
|
* will the authors be held liable for any damages arising from the use of this software. |
|
|
|
* |
|
|
|
* Permission is granted to anyone to use this software for any purpose, including commercial |
|
|
|
* applications, and to alter it and redistribute it freely, subject to the following restrictions: |
|
|
|
* |
|
|
|
* 1. The origin of this software must not be misrepresented; you must not claim that you |
|
|
|
* wrote the original software. If you use this software in a product, an acknowledgment |
|
|
|
* in the product documentation would be appreciated but is not required. |
|
|
|
* |
|
|
|
* 2. Altered source versions must be plainly marked as such, and must not be misrepresented |
|
|
|
* as being the original software. |
|
|
|
* |
|
|
|
* 3. This notice may not be removed or altered from any source distribution. |
|
|
|
* |
|
|
|
**********************************************************************************************/ |
|
|
|
|
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// Types and Structures Definition |
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
typedef struct { |
|
|
|
int unused; |
|
|
|
} PlatformData; |
|
|
|
|
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// Global Variables Definition |
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
extern CoreData CORE; // Global CORE state context |
|
|
|
|
|
|
|
static PlatformData platform = { 0 }; // Platform specific data |
|
|
|
|
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// Module Internal Functions Declaration |
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
int InitPlatform(void); // Initialize platform (graphics, inputs and more) |
|
|
|
bool InitGraphicsDevice(void); // Initialize graphics device |
|
|
|
|
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// Module Functions Declaration |
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// NOTE: Functions declaration is provided by raylib.h |
|
|
|
|
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// Module Functions Definition: Window and Graphics Device |
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
|
|
|
|
// Check if application should close |
|
|
|
bool WindowShouldClose(void) |
|
|
|
{ |
|
|
|
return true; |
|
|
|
} |
|
|
|
|
|
|
|
// Toggle fullscreen mode |
|
|
|
void ToggleFullscreen(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "ToggleFullscreen() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Toggle borderless windowed mode |
|
|
|
void ToggleBorderlessWindowed(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "ToggleBorderlessWindowed() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set window state: maximized, if resizable |
|
|
|
void MaximizeWindow(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "MaximizeWindow() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set window state: minimized |
|
|
|
void MinimizeWindow(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "MinimizeWindow() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Restore window from being minimized/maximized |
|
|
|
void RestoreWindow(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "RestoreWindow() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set window configuration state using flags |
|
|
|
void SetWindowState(unsigned int flags) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetWindowState() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Clear window configuration state flags |
|
|
|
void ClearWindowState(unsigned int flags) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "ClearWindowState() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set icon for window |
|
|
|
void SetWindowIcon(Image image) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetWindowIcon() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set icon for window |
|
|
|
void SetWindowIcons(Image *images, int count) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetWindowIcons() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set title for window |
|
|
|
void SetWindowTitle(const char *title) |
|
|
|
{ |
|
|
|
CORE.Window.title = title; |
|
|
|
} |
|
|
|
|
|
|
|
// Set window position on screen (windowed mode) |
|
|
|
void SetWindowPosition(int x, int y) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetWindowPosition() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set monitor for the current window |
|
|
|
void SetWindowMonitor(int monitor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetWindowMonitor() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set window minimum dimensions (FLAG_WINDOW_RESIZABLE) |
|
|
|
void SetWindowMinSize(int width, int height) |
|
|
|
{ |
|
|
|
CORE.Window.screenMin.width = width; |
|
|
|
CORE.Window.screenMin.height = height; |
|
|
|
} |
|
|
|
|
|
|
|
// Set window maximum dimensions (FLAG_WINDOW_RESIZABLE) |
|
|
|
void SetWindowMaxSize(int width, int height) |
|
|
|
{ |
|
|
|
CORE.Window.screenMax.width = width; |
|
|
|
CORE.Window.screenMax.height = height; |
|
|
|
} |
|
|
|
|
|
|
|
// Set window dimensions |
|
|
|
void SetWindowSize(int width, int height) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetWindowSize() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set window opacity, value opacity is between 0.0 and 1.0 |
|
|
|
void SetWindowOpacity(float opacity) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetWindowOpacity() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set window focused |
|
|
|
void SetWindowFocused(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetWindowFocused() not available on target platform"); |
|
|
|
} |
|
|
|
|
|
|
|
// Get native window handle |
|
|
|
void *GetWindowHandle(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetWindowHandle() not available in headless mode"); |
|
|
|
return NULL; |
|
|
|
} |
|
|
|
|
|
|
|
// Get number of monitors |
|
|
|
int GetMonitorCount(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetMonitorCount() not available in headless mode"); |
|
|
|
return 1; |
|
|
|
} |
|
|
|
|
|
|
|
// Get current monitor where window is placed |
|
|
|
int GetCurrentMonitor(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetCurrentMonitor() not available in headless mode"); |
|
|
|
return 0; |
|
|
|
} |
|
|
|
|
|
|
|
// Get selected monitor position |
|
|
|
Vector2 GetMonitorPosition(int monitor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetMonitorPosition() not available in headless mode"); |
|
|
|
return (Vector2){ 0, 0 }; |
|
|
|
} |
|
|
|
|
|
|
|
// Get selected monitor width (currently used by monitor) |
|
|
|
int GetMonitorWidth(int monitor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetMonitorWidth() not available in headless mode"); |
|
|
|
return 0; |
|
|
|
} |
|
|
|
|
|
|
|
// Get selected monitor height (currently used by monitor) |
|
|
|
int GetMonitorHeight(int monitor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetMonitorHeight() not available in headless mode"); |
|
|
|
return 0; |
|
|
|
} |
|
|
|
|
|
|
|
// Get selected monitor physical width in millimetres |
|
|
|
int GetMonitorPhysicalWidth(int monitor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetMonitorPhysicalWidth() not available in headless mode"); |
|
|
|
return 0; |
|
|
|
} |
|
|
|
|
|
|
|
// Get selected monitor physical height in millimetres |
|
|
|
int GetMonitorPhysicalHeight(int monitor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetMonitorPhysicalHeight() not available in headless mode"); |
|
|
|
return 0; |
|
|
|
} |
|
|
|
|
|
|
|
// Get selected monitor refresh rate |
|
|
|
int GetMonitorRefreshRate(int monitor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetMonitorRefreshRate() not available in headless mode"); |
|
|
|
return 0; |
|
|
|
} |
|
|
|
|
|
|
|
// Get the human-readable, UTF-8 encoded name of the selected monitor |
|
|
|
const char *GetMonitorName(int monitor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetMonitorName() not available in headless mode"); |
|
|
|
return ""; |
|
|
|
} |
|
|
|
|
|
|
|
// Get window position XY on monitor |
|
|
|
Vector2 GetWindowPosition(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetWindowPosition() not available in headless mode"); |
|
|
|
return (Vector2){ 0, 0 }; |
|
|
|
} |
|
|
|
|
|
|
|
// Get window scale DPI factor for current monitor |
|
|
|
Vector2 GetWindowScaleDPI(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetWindowScaleDPI() not available in headless mode"); |
|
|
|
return (Vector2){ 1.0f, 1.0f }; |
|
|
|
} |
|
|
|
|
|
|
|
// Set clipboard text content |
|
|
|
void SetClipboardText(const char *text) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetClipboardText() not available in headless mode"); |
|
|
|
} |
|
|
|
|
|
|
|
// Get clipboard text content |
|
|
|
// NOTE: returned string is allocated and freed by GLFW |
|
|
|
const char *GetClipboardText(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetClipboardText() not available in headless mode"); |
|
|
|
return NULL; |
|
|
|
} |
|
|
|
|
|
|
|
// Get clipboard image |
|
|
|
Image GetClipboardImage(void) |
|
|
|
{ |
|
|
|
Image image = { 0 }; |
|
|
|
|
|
|
|
TRACELOG(LOG_INFO, "GetClipboardImage() not available in headless mode"); |
|
|
|
|
|
|
|
return image; |
|
|
|
} |
|
|
|
|
|
|
|
// Show mouse cursor |
|
|
|
void ShowCursor(void) |
|
|
|
{ |
|
|
|
CORE.Input.Mouse.cursorHidden = false; |
|
|
|
} |
|
|
|
|
|
|
|
// Hides mouse cursor |
|
|
|
void HideCursor(void) |
|
|
|
{ |
|
|
|
CORE.Input.Mouse.cursorHidden = true; |
|
|
|
} |
|
|
|
|
|
|
|
// Enables cursor (unlock cursor) |
|
|
|
void EnableCursor(void) |
|
|
|
{ |
|
|
|
// Set cursor position in the middle |
|
|
|
SetMousePosition(CORE.Window.screen.width/2, CORE.Window.screen.height/2); |
|
|
|
|
|
|
|
CORE.Input.Mouse.cursorHidden = false; |
|
|
|
} |
|
|
|
|
|
|
|
// Disables cursor (lock cursor) |
|
|
|
void DisableCursor(void) |
|
|
|
{ |
|
|
|
// Set cursor position in the middle |
|
|
|
SetMousePosition(CORE.Window.screen.width/2, CORE.Window.screen.height/2); |
|
|
|
|
|
|
|
CORE.Input.Mouse.cursorHidden = true; |
|
|
|
} |
|
|
|
|
|
|
|
// Swap back buffer with front buffer (screen drawing) |
|
|
|
void SwapScreenBuffer(void) |
|
|
|
{ |
|
|
|
|
|
|
|
} |
|
|
|
|
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// Module Functions Definition: Misc |
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
|
|
|
|
// Get elapsed time measure in seconds since InitTimer() |
|
|
|
double GetTime(void) |
|
|
|
{ |
|
|
|
double time = 0.0; |
|
|
|
struct timespec ts = { 0 }; |
|
|
|
clock_gettime(CLOCK_MONOTONIC, &ts); |
|
|
|
unsigned long long int nanoSeconds = (unsigned long long int)ts.tv_sec*1000000000LLU + (unsigned long long int)ts.tv_nsec; |
|
|
|
|
|
|
|
time = (double)(nanoSeconds - CORE.Time.base)*1e-9; // Elapsed time since InitTimer() |
|
|
|
|
|
|
|
return time; |
|
|
|
} |
|
|
|
|
|
|
|
// Open URL with default system browser (if available) |
|
|
|
// NOTE: This function is only safe to use if you control the URL given. |
|
|
|
// A user could craft a malicious string performing another action. |
|
|
|
// Only call this function yourself not with user input or make sure to check the string yourself. |
|
|
|
// Ref: https://github.com/raysan5/raylib/issues/686 |
|
|
|
void OpenURL(const char *url) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "PLATFORM: URL: Cannot open URL in headless mode"); |
|
|
|
} |
|
|
|
|
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// Module Functions Definition: Inputs |
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
|
|
|
|
// Set internal gamepad mappings |
|
|
|
int SetGamepadMappings(const char *mappings) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetGamepadMappings() not available in headless mode"); |
|
|
|
return 0; |
|
|
|
} |
|
|
|
|
|
|
|
// Set gamepad vibration |
|
|
|
void SetGamepadVibration(int gamepad, float leftMotor, float rightMotor, float duration) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetGamepadVibration() not available in headless mode"); |
|
|
|
} |
|
|
|
|
|
|
|
// Set mouse position XY |
|
|
|
void SetMousePosition(int x, int y) |
|
|
|
{ |
|
|
|
CORE.Input.Mouse.currentPosition = (Vector2){ (float)x, (float)y }; |
|
|
|
CORE.Input.Mouse.previousPosition = CORE.Input.Mouse.currentPosition; |
|
|
|
} |
|
|
|
|
|
|
|
// Set mouse cursor |
|
|
|
void SetMouseCursor(int cursor) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "SetMouseCursor() not available in headless mode"); |
|
|
|
} |
|
|
|
|
|
|
|
// Get physical key name. |
|
|
|
const char *GetKeyName(int key) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "GetKeyName() not available in headless mode"); |
|
|
|
return ""; |
|
|
|
} |
|
|
|
|
|
|
|
// Register all input events |
|
|
|
void PollInputEvents(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "PLATFORM: EVENTS: Cannot poll events in headless mode"); |
|
|
|
} |
|
|
|
|
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
// Module Internal Functions Definition |
|
|
|
//---------------------------------------------------------------------------------- |
|
|
|
|
|
|
|
// Initialize platform: graphics, inputs and more |
|
|
|
int InitPlatform(void) |
|
|
|
{ |
|
|
|
TRACELOG(LOG_INFO, "PLATFORM: HEADLESS: No initialization required"); |
|
|
|
|
|
|
|
return 0; |
|
|
|
} |
|
|
|
|
|
|
|
// Close platform |
|
|
|
void ClosePlatform(void) |
|
|
|
{ |
|
|
|
|
|
|
|
} |
|
|
|
|
|
|
|
// EOF |
|
|
|
|