2025-01-29 10:55:49 +01:00

725 lines
22 KiB
C

#pragma once
#include <kinc/global.h>
#include <kinc/log.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
/*! \file system.h
\brief Provides basic system and application-management functionality which doesn't fit anywhere else.
*/
#ifdef __cplusplus
extern "C" {
#endif
struct kinc_window_options;
struct kinc_framebuffer_options;
/// <summary>
/// Initializes a Kinc application and creates an initial window for systems which support windows (systems which do not support windows are treated as if the
/// would provide a single window which cannot change). This has to be called before any other Kinc-function with the exception of the Display-API which can
/// optionally be initialized beforehand using kinc_display_init.
/// </summary>
/// <returns>The id of the initial window</returns>
KINC_FUNC int kinc_init(const char *name, int width, int height, struct kinc_window_options *win, struct kinc_framebuffer_options *frame);
/// <summary>
/// Returns the current application name as set by kinc_init or kinc_set_application_name.
/// </summary>
/// <returns>The current name of the application</returns>
KINC_FUNC const char *kinc_application_name(void);
/// <summary>
/// Changes the application-name that was initially set by kinc_init.
/// </summary>
/// <param name="name">The new application-name</param>
KINC_FUNC void kinc_set_application_name(const char *name);
/// <summary>
/// Returns the current width of the initial application-window which is equivalent to calling kinc_window_width(0).
/// </summary>
/// <returns>The width of the initial window</returns>
KINC_FUNC int kinc_width(void);
/// <summary>
/// Returns the current height of the initial application-window which is equivalent to calling kinc_window_height(0).
/// </summary>
/// <returns>The height of the initial window</returns>
KINC_FUNC int kinc_height(void);
/// <summary>
/// Instruct the system to load up the provided URL which will usually open it in the system's default browser.
/// </summary>
/// <param name="url">The URL to open</param>
KINC_FUNC void kinc_load_url(const char *url);
/// <summary>
/// Returns an ID representing the current type of target-system.
/// </summary>
/// <returns>The ID representing the target system</returns>
KINC_FUNC const char *kinc_system_id(void);
/// <summary>
/// Returns the current system-language.
/// </summary>
/// <returns>The current system-language as a two-letter language code</returns>
KINC_FUNC const char *kinc_language(void);
/// <summary>
/// Vibrates the whole system if supported. This is primarily supported on mobile phones but don't blame us if your computer falls over.
/// </summary>
KINC_FUNC void kinc_vibrate(int milliseconds);
/// <summary>
/// Returns the portion of the screen which can be safely used for important content. This is mostly relevant for TVs which often scale the image by default and
/// thefore cut off some of the content.
/// </summary>
/// <returns>The safe-zone which can be multiplied with the width or height of the display to convert it to pixels</returns>
KINC_FUNC float kinc_safe_zone(void);
/// <summary>
/// Returns whether the system itself handles configuration of the safe-zone.
/// </summary>
/// <returns>Whether the safe-zone is handlet by the syste</returns>
KINC_FUNC bool kinc_automatic_safe_zone(void);
/// <summary>
/// Sets the safe-zone for systems which return false for kinc_automatic_safe_zone.
/// </summary>
/// <param name="value">The safe-zone for width and height as a ratio of the full display-resolution.</param>
KINC_FUNC void kinc_set_safe_zone(float value);
typedef uint64_t kinc_ticks_t;
/// <summary>
/// Returns the frequency of system-timestamps.
/// </summary>
/// <returns>The frequency of the system's timestamps in 1 / second</returns>
KINC_FUNC double kinc_frequency(void);
/// <summary>
/// Returns a timestamp for right now in a system-specific unit.
/// </summary>
/// <returns>The current timestamp</returns>
KINC_FUNC kinc_ticks_t kinc_timestamp(void);
/// <summary>
/// Returns the number of proper CPU-cores (not the number of hardware-threads)
/// </summary>
/// <returns>Number of cores</returns>
KINC_FUNC int kinc_cpu_cores(void);
/// <summary>
/// Returns the number of hardware-threads
/// </summary>
/// <returns>Number of hardware-threads</returns>
KINC_FUNC int kinc_hardware_threads(void);
/// <summary>
/// Returns the current time. This can also be calculated ala kinc_timestamp() / kinc_frequency() but kinc_time is a little more precise on some systems.
/// </summary>
/// <returns>The current time in seconds</returns>
KINC_FUNC double kinc_time(void);
/// <summary>
/// Starts Kinc's main-loop. kinc_set_update_callback should be called before kinc_start so the main-loop actually has something to do.
/// </summary>
KINC_FUNC void kinc_start(void);
/// <summary>
/// Stops Kinc's main loop and thereby returns to the function which called kinc_start.
/// </summary>
KINC_FUNC void kinc_stop(void);
/// <summary>
/// Instructs the system to login a user if that is supported.
/// </summary>
KINC_FUNC void kinc_login(void);
/// <summary>
/// Returns true if kinc_login was called and the login-process is still ongoing.
/// </summary>
/// <returns>Whether a login-process is still in progress</returns>
KINC_FUNC bool kinc_waiting_for_login(void);
/// <summary>
/// Unlocks an achievement or trophy or however you prefer to call it.
/// </summary>
/// <param name="id">The id of the achievement/tropy</param>
KINC_FUNC void kinc_unlock_achievement(int id);
/// <summary>
/// Disallows the system to logout the current user.
/// </summary>
KINC_FUNC void kinc_disallow_user_change(void);
/// <summary>
/// Allows the system to logout the current user.
/// </summary>
KINC_FUNC void kinc_allow_user_change(void);
/// <summary>
/// Instructs the system whether it is allowed to turn off the screen while the application is running.
/// </summary>
/// <param name="on">Whether turning off the screen is allowed</param>
KINC_FUNC void kinc_set_keep_screen_on(bool on);
/// <summary>
/// Tries to halt program-execution in an attached debugger when compiled in debug-mode (aka when NDEBUG is not defined).
/// </summary>
KINC_INLINE void kinc_debug_break(void) {
#ifndef NDEBUG
#if defined(_MSC_VER)
__debugbreak();
#elif defined(__clang__)
__builtin_debugtrap();
#else
#if defined(__aarch64__)
__asm__ volatile(".inst 0xd4200000");
#elif defined(__x86_64__)
__asm__ volatile("int $0x03");
#else
kinc_log(KINC_LOG_LEVEL_WARNING, "Oh no, kinc_debug_break is not implemented for the current compiler and CPU.");
#endif
#endif
#endif
}
/// <summary>
/// Returns whether a debugger is currently attached to the running program. This is not yet working though.
/// </summary>
/// <returns>Whether a debugger is currently attached</returns>
KINC_FUNC bool kinc_debugger_attached(void);
/// <summary>
/// Copies the provided string to the system's clipboard.
/// </summary>
/// <param name="text">The text to be copied into the clipboard</param>
KINC_FUNC void kinc_copy_to_clipboard(const char *text);
/// <summary>
/// Sets the update-callback which drives the application and is called for every frame.
/// </summary>
/// <param name="callback">The callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_update_callback(void (*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called whenever the application is brought to the foreground.
/// </summary>
/// <param name="callback">The foreground-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_foreground_callback(void (*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called whenever the application was paused and is being resumed.
/// </summary>
/// <param name="callback">The resume-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_resume_callback(void (*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called whenever the application is paused.
/// </summary>
/// <param name="callback">The pause-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_pause_callback(void (*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called whenever the application is brought to the background.
/// </summary>
/// <param name="callback">The background-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_background_callback(void (*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called whenever the application is about to shut down.
/// </summary>
/// <param name="callback">The shutdown-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_shutdown_callback(void (*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called when files are dropped on the application-window.
/// </summary>
/// <param name="callback">The drop-files-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_drop_files_callback(void (*callback)(wchar_t *, void *), void *data);
/// <summary>
/// Sets a callback which is called when the application is instructed to cut, typically via ctrl+x or cmd+x.
/// </summary>
/// <param name="callback">The cut-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_cut_callback(char *(*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called when the application is instructed to copy, typically via ctrl+c or cmd+c.
/// </summary>
/// <param name="callback">The copy-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_copy_callback(char *(*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called when the application is instructed to paste, typically via ctrl+v or cmd+v.
/// </summary>
/// <param name="callback">The paste-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_paste_callback(void (*callback)(char *, void *), void *data);
/// <summary>
/// Sets a callback which is called when a user logs in.
/// </summary>
/// <param name="callback">The login-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_login_callback(void (*callback)(void *), void *data);
/// <summary>
/// Sets a callback which is called when a user logs out.
/// </summary>
/// <param name="callback">The logout-callback</param>
/// <param name="data">Arbitrary data-pointer that's passed to the callback</param>
KINC_FUNC void kinc_set_logout_callback(void (*callback)(void *), void *data);
#ifdef KINC_VTUNE
#include <ittnotify.h>
extern __itt_domain *kinc_itt_domain;
#endif
#ifdef KINC_SUPERLUMINAL
#include <Superluminal/PerformanceAPI_capi.h>
#endif
/// <summary>
/// Starts a marker for profiling. Please match it with a marker_end-call in the same function.
/// </summary>
/// <param name="name">A unique name that will be shown in the profiler</param>
/// <param name="color">A nice color in RGBX that will show up in the profiler</param>
static inline void kinc_marker_start(const char *name, uint32_t color) {
#ifdef KINC_VTUNE
__itt_task_begin(kinc_itt_domain, __itt_null, __itt_null, __itt_string_handle_create(name));
#endif
#ifdef KINC_SUPERLUMINAL
PerformanceAPI_BeginEvent(name, NULL, color);
#endif
}
/// <summary>
/// Ends the previously started marker of the same function.
/// </summary>
static inline void kinc_marker_end(const char *name) {
#ifdef KINC_VTUNE
__itt_task_end(kinc_itt_domain);
#endif
#ifdef KINC_SUPERLUMINAL
PerformanceAPI_EndEvent();
#endif
}
/// <summary>
/// Currently only supported on Windows.
/// Starts up Live++ (see https://liveplusplus.tech), typically called right before kinc_start().
/// After calling this you can hit Ctrl+Alt+F11 to hot-reload.
/// Call Project.addLivePP(path) in your kfile to make this do something.
/// The path-parameter for addLivePP is the path to the unpacked Live++-archive that has to contain a LivePP-subdirectory.
/// This will set the appropricate compiler- and linker-options and set the KINC_LIVEPP-define
/// for the Debug- and Develop-configs (it does not touch the Release-config).
/// </summary>
/// <returns></returns>
KINC_FUNC void kinc_LivePP_start(void);
/// <summary>
/// Stops Live++, typically called right after kinc_start().
/// </summary>
/// <param name=""></param>
/// <returns></returns>
KINC_FUNC void kinc_LivePP_stop(void);
bool kinc_internal_frame(void);
const char *kinc_internal_save_path(void);
bool kinc_internal_handle_messages(void);
void kinc_internal_shutdown(void);
void kinc_internal_update_callback(void);
void kinc_internal_foreground_callback(void);
void kinc_internal_resume_callback(void);
void kinc_internal_pause_callback(void);
void kinc_internal_background_callback(void);
void kinc_internal_shutdown_callback(void);
void kinc_internal_drop_files_callback(wchar_t *);
char *kinc_internal_cut_callback(void);
char *kinc_internal_copy_callback(void);
void kinc_internal_paste_callback(char *);
void kinc_internal_login_callback(void);
void kinc_internal_logout_callback(void);
#ifdef KINC_IMPLEMENTATION_ROOT
#define KINC_IMPLEMENTATION
#endif
#ifdef KINC_IMPLEMENTATION
#ifdef KINC_IMPLEMENTATION_ROOT
#undef KINC_IMPLEMENTATION
#endif
#include <kinc/window.h>
#ifdef KINC_IMPLEMENTATION_ROOT
#define KINC_IMPLEMENTATION
#endif
#undef KINC_IMPLEMENTATION
#include <kinc/io/filereader.h>
#include <kinc/io/filewriter.h>
#define KINC_IMPLEMENTATION
#include <stdlib.h>
#include <string.h>
#if !defined(KORE_WASM) && !defined(KORE_EMSCRIPTEN) && !defined(KORE_ANDROID) && !defined(KORE_WINDOWS) && !defined(KORE_CONSOLE)
double kinc_time(void) {
return kinc_timestamp() / kinc_frequency();
}
#endif
static void (*update_callback)(void *) = NULL;
static void *update_callback_data = NULL;
static void (*foreground_callback)(void *) = NULL;
static void *foreground_callback_data = NULL;
static void (*background_callback)(void *) = NULL;
static void *background_callback_data = NULL;
static void (*pause_callback)(void *) = NULL;
static void *pause_callback_data = NULL;
static void (*resume_callback)(void *) = NULL;
static void *resume_callback_data = NULL;
static void (*shutdown_callback)(void *) = NULL;
static void *shutdown_callback_data = NULL;
static void (*drop_files_callback)(wchar_t *, void *) = NULL;
static void *drop_files_callback_data = NULL;
static char *(*cut_callback)(void *) = NULL;
static void *cut_callback_data = NULL;
static char *(*copy_callback)(void *) = NULL;
static void *copy_callback_data = NULL;
static void (*paste_callback)(char *, void *) = NULL;
static void *paste_callback_data = NULL;
static void (*login_callback)(void *) = NULL;
static void *login_callback_data = NULL;
static void (*logout_callback)(void *) = NULL;
static void *logout_callback_data = NULL;
#if defined(KORE_IOS) || defined(KORE_MACOS)
bool withAutoreleasepool(bool (*f)(void));
#endif
void kinc_set_update_callback(void (*callback)(void *), void *data) {
update_callback = callback;
update_callback_data = data;
}
void kinc_set_foreground_callback(void (*callback)(void *), void *data) {
foreground_callback = callback;
foreground_callback_data = data;
}
void kinc_set_resume_callback(void (*callback)(void *), void *data) {
resume_callback = callback;
resume_callback_data = data;
}
void kinc_set_pause_callback(void (*callback)(void *), void *data) {
pause_callback = callback;
pause_callback_data = data;
}
void kinc_set_background_callback(void (*callback)(void *), void *data) {
background_callback = callback;
background_callback_data = data;
}
void kinc_set_shutdown_callback(void (*callback)(void *), void *data) {
shutdown_callback = callback;
shutdown_callback_data = data;
}
void kinc_set_drop_files_callback(void (*callback)(wchar_t *, void *), void *data) {
drop_files_callback = callback;
drop_files_callback_data = data;
}
void kinc_set_cut_callback(char *(*callback)(void *), void *data) {
cut_callback = callback;
cut_callback_data = data;
}
void kinc_set_copy_callback(char *(*callback)(void *), void *data) {
copy_callback = callback;
copy_callback_data = data;
}
void kinc_set_paste_callback(void (*callback)(char *, void *), void *data) {
paste_callback = callback;
paste_callback_data = data;
}
void kinc_set_login_callback(void (*callback)(void *), void *data) {
login_callback = callback;
login_callback_data = data;
}
void kinc_set_logout_callback(void (*callback)(void *), void *data) {
logout_callback = callback;
logout_callback_data = data;
}
void kinc_internal_update_callback(void) {
if (update_callback != NULL) {
update_callback(update_callback_data);
}
}
void kinc_internal_foreground_callback(void) {
if (foreground_callback != NULL) {
foreground_callback(foreground_callback_data);
}
}
void kinc_internal_resume_callback(void) {
if (resume_callback != NULL) {
resume_callback(resume_callback_data);
}
}
void kinc_internal_pause_callback(void) {
if (pause_callback != NULL) {
pause_callback(pause_callback_data);
}
}
void kinc_internal_background_callback(void) {
if (background_callback != NULL) {
background_callback(background_callback_data);
}
}
void kinc_internal_shutdown_callback(void) {
if (shutdown_callback != NULL) {
shutdown_callback(shutdown_callback_data);
}
}
void kinc_internal_drop_files_callback(wchar_t *filePath) {
if (drop_files_callback != NULL) {
drop_files_callback(filePath, drop_files_callback_data);
}
}
char *kinc_internal_cut_callback(void) {
if (cut_callback != NULL) {
return cut_callback(cut_callback_data);
}
return NULL;
}
char *kinc_internal_copy_callback(void) {
if (copy_callback != NULL) {
return copy_callback(copy_callback_data);
}
return NULL;
}
void kinc_internal_paste_callback(char *value) {
if (paste_callback != NULL) {
paste_callback(value, paste_callback_data);
}
}
void kinc_internal_login_callback(void) {
if (login_callback != NULL) {
login_callback(login_callback_data);
}
}
void kinc_internal_logout_callback(void) {
if (logout_callback != NULL) {
logout_callback(logout_callback_data);
}
}
static bool running = false;
// static bool showWindowFlag = true;
static char application_name[1024] = {"Kinc Application"};
const char *kinc_application_name(void) {
return application_name;
}
void kinc_set_application_name(const char *name) {
strcpy(application_name, name);
}
#ifdef KORE_METAL
void shutdownMetalCompute(void);
#endif
void kinc_stop(void) {
running = false;
// TODO (DK) destroy graphics + windows, but afaik Application::~Application() was never called, so it's the same behavior now as well
// for (int windowIndex = 0; windowIndex < sizeof(windowIds) / sizeof(int); ++windowIndex) {
// Graphics::destroy(windowIndex);
//}
#ifdef KORE_METAL
shutdownMetalCompute();
#endif
}
bool kinc_internal_frame(void) {
kinc_internal_update_callback();
kinc_internal_handle_messages();
return running;
}
void kinc_start(void) {
running = true;
#if !defined(KORE_WASM) && !defined(KORE_EMSCRIPTEN) && !defined(KORE_TIZEN)
// if (Graphics::hasWindow()) Graphics::swapBuffers();
#if defined(KORE_IOS) || defined(KORE_MACOS)
while (withAutoreleasepool(kinc_internal_frame)) {
}
#else
while (kinc_internal_frame()) {
}
#endif
kinc_internal_shutdown();
#endif
}
int kinc_width(void) {
return kinc_window_width(0);
}
int kinc_height(void) {
return kinc_window_height(0);
}
#ifndef KHA
void kinc_memory_emergency(void) {}
#endif
#if !defined(KORE_SONY) && !defined(KORE_SWITCH)
static float safe_zone = 0.9f;
float kinc_safe_zone(void) {
#ifdef KORE_ANDROID
return 1.0f;
#else
return safe_zone;
#endif
}
bool kinc_automatic_safe_zone(void) {
#ifdef KORE_ANDROID
return true;
#else
return false;
#endif
}
void kinc_set_safe_zone(float value) {
safe_zone = value;
}
#endif
#if !defined(KORE_SONY)
bool is_save_load_initialized(void) {
return true;
}
bool is_ps4_japanese_button_style(void) {
return false;
}
bool is_save_load_broken(void) {
return false;
}
#endif
#if !defined(KORE_CONSOLE)
#define SAVE_RESULT_NONE 0
#define SAVE_RESULT_SUCCESS 1
#define SAVE_RESULT_FAILURE 2
volatile int save_result = SAVE_RESULT_SUCCESS;
void kinc_disallow_user_change(void) {}
void kinc_allow_user_change(void) {}
static uint8_t *current_file = NULL;
static size_t current_file_size = 0;
bool kinc_save_file_loaded(void) {
return true;
}
uint8_t *kinc_get_save_file(void) {
return current_file;
}
size_t kinc_get_save_file_size(void) {
return current_file_size;
}
void kinc_load_save_file(const char *filename) {
free(current_file);
current_file = NULL;
current_file_size = 0;
kinc_file_reader_t reader;
if (kinc_file_reader_open(&reader, filename, KINC_FILE_TYPE_SAVE)) {
current_file_size = kinc_file_reader_size(&reader);
current_file = (uint8_t *)malloc(current_file_size);
kinc_file_reader_read(&reader, current_file, current_file_size);
kinc_file_reader_close(&reader);
}
}
void kinc_save_save_file(const char *filename, uint8_t *data, size_t size) {
kinc_file_writer_t writer;
if (kinc_file_writer_open(&writer, filename)) {
kinc_file_writer_write(&writer, data, (int)size);
kinc_file_writer_close(&writer);
}
}
bool kinc_save_is_saving(void) {
return false;
}
bool kinc_waiting_for_login(void) {
return false;
}
#if !defined(KORE_WINDOWS) && !defined(KORE_LINUX) && !defined(KORE_MACOS)
void kinc_copy_to_clipboard(const char *text) {
kinc_log(KINC_LOG_LEVEL_WARNING, "Oh no, kinc_copy_to_clipboard is not implemented for this system.");
}
#endif
#endif
#endif
#ifdef __cplusplus
}
#endif