// This file is part of the Essence operating system. // It is released under the terms of the MIT license -- see LICENSE.md. // Written by: nakst. // ----------------- Includes: #ifndef IncludedEssenceAPIHeader #define IncludedEssenceAPIHeader #include #ifndef KERNEL #include #include #include #endif #include // --------- Architecture defines: #if defined(__i386__) #define ES_ARCH_X86_32 #define ES_BITS_32 #elif defined(__x86_64__) #define ES_ARCH_X86_64 #define ES_BITS_64 #else #error Architecture is not supported. #endif // --------- C++/C differences: #ifdef __cplusplus #define ES_EXTERN_C extern "C" #define ES_CONSTRUCTOR(x) x #define ES_NULL nullptr // Scoped defer: http://www.gingerbill.org/article/defer-in-cpp.html template struct _EsDefer4 { F f; _EsDefer4(F f) : f(f) {} ~_EsDefer4() { f(); } }; template _EsDefer4 _EsDeferFunction(F f) { return _EsDefer4(f); } #define EsDEFER_3(x) ES_C_PREPROCESSOR_JOIN(x, __COUNTER__) #define _EsDefer5(code) auto EsDEFER_3(_defer_) = _EsDeferFunction([&](){code;}) #define EsDefer(code) _EsDefer5(code) union EsGeneric { uintptr_t u; intptr_t i; void *p; inline EsGeneric() = default; #ifdef ES_BITS_64 inline EsGeneric(uintptr_t y) { u = y; } inline EsGeneric( intptr_t y) { i = y; } #endif inline EsGeneric(unsigned y) { u = y; } inline EsGeneric( int y) { i = y; } inline EsGeneric( void *y) { p = y; } inline bool operator==(EsGeneric r) const { return r.u == u; } }; #else #define ES_EXTERN_C extern #define ES_CONSTRUCTOR(x) #define ES_NULL 0 typedef union { uintptr_t u; intptr_t i; void *p; } EsGeneric; typedef struct EsElementPublic EsElementPublic; #endif // --------- Macros: #ifdef ES_ARCH_X86_64 #define ES_API_BASE ((void **) 0x1000) #define ES_SHARED_MEMORY_MAXIMUM_SIZE ((size_t) (1024) * 1024 * 1024 * 1024) #define ES_PAGE_SIZE ((uintptr_t) 4096) #define ES_PAGE_BITS (12) typedef struct EsCRTjmp_buf { uintptr_t rsp, rbp, rbx, r12, r13, r14, r15, rip; } EsCRTjmp_buf; #endif #ifdef ES_ARCH_X86_32 #define ES_API_BASE ((void **) 0x1000) #define ES_SHARED_MEMORY_MAXIMUM_SIZE ((size_t) 1024 * 1024 * 1024) #define ES_PAGE_SIZE ((uintptr_t) 4096) #define ES_PAGE_BITS (12) typedef struct EsCRTjmp_buf { uintptr_t esp, ebp, ebx, eip, esi, edi; } EsCRTjmp_buf; #endif ES_EXTERN_C int _EsCRTsetjmp(EsCRTjmp_buf *env); ES_EXTERN_C __attribute__((noreturn)) void _EsCRTlongjmp(EsCRTjmp_buf *env, int val); #define EsCRTsetjmp(x) _EsCRTsetjmp(&(x)) #define EsCRTlongjmp(x, y) _EsCRTlongjmp(&(x), (y)) #define _ES_C_PREPROCESSOR_JOIN(x, y) x ## y #define ES_C_PREPROCESSOR_JOIN(x, y) _ES_C_PREPROCESSOR_JOIN(x, y) #define EsContainerOf(type, member, pointer) ((type *) ((uint8_t *) pointer - offsetof(type, member))) #define ES_CHECK_ERROR(x) (((intptr_t) (x)) < (ES_SUCCESS)) #define ES_RECT_1(x) ((EsRectangle) { (int32_t) (x), (int32_t) (x), (int32_t) (x), (int32_t) (x) }) #define ES_RECT_1I(x) ((EsRectangle) { (int32_t) (x), (int32_t) -(x), (int32_t) (x), (int32_t) -(x) }) #define ES_RECT_1S(x) ((EsRectangle) { 0, (int32_t) (x), 0, (int32_t) (x) }) #define ES_RECT_2(x, y) ((EsRectangle) { (int32_t) (x), (int32_t) (x), (int32_t) (y), (int32_t) (y) }) #define ES_RECT_2I(x, y) ((EsRectangle) { (int32_t) (x), (int32_t) -(x), (int32_t) (y), (int32_t) -(y) }) #define ES_RECT_2S(x, y) ((EsRectangle) { 0, (int32_t) (x), 0, (int32_t) (y) }) #define ES_RECT_4(x, y, z, w) ((EsRectangle) { (int32_t) (x), (int32_t) (y), (int32_t) (z), (int32_t) (w) }) #define ES_RECT_4PD(x, y, w, h) ((EsRectangle) { (int32_t) (x), (int32_t) ((x) + (w)), (int32_t) (y), (int32_t) ((y) + (h)) }) #define ES_RECT_WIDTH(_r) ((_r).r - (_r).l) #define ES_RECT_HEIGHT(_r) ((_r).b - (_r).t) #define ES_RECT_TOTAL_H(_r) ((_r).r + (_r).l) #define ES_RECT_TOTAL_V(_r) ((_r).b + (_r).t) #define ES_RECT_SIZE(_r) ES_RECT_WIDTH(_r), ES_RECT_HEIGHT(_r) #define ES_RECT_TOP_LEFT(_r) (_r).l, (_r).t #define ES_RECT_BOTTOM_LEFT(_r) (_r).l, (_r).b #define ES_RECT_BOTTOM_RIGHT(_r) (_r).r, (_r).b #define ES_RECT_ALL(_r) (_r).l, (_r).r, (_r).t, (_r).b #define ES_RECT_VALID(_r) (ES_RECT_WIDTH(_r) > 0 && ES_RECT_HEIGHT(_r) > 0) #define ES_POINT(x, y) ((EsPoint) { (int32_t) (x), (int32_t) (y) }) #define EsKeyboardIsAltHeld() (EsKeyboardGetModifiers() & ES_MODIFIER_ALT) #define EsKeyboardIsCtrlHeld() (EsKeyboardGetModifiers() & ES_MODIFIER_CTRL) #define EsKeyboardIsShiftHeld() (EsKeyboardGetModifiers() & ES_MODIFIER_SHIFT) #define ES_MEMORY_MOVE_BACKWARDS - #define EsWaitSingle(object) EsWait(&object, 1, ES_WAIT_NO_TIMEOUT) #define EsObjectUnmap EsMemoryUnreserve #define EsElementSetEnabled(element, enabled) EsElementSetDisabled(element, !(enabled)) #define EsCommandSetEnabled(command, enabled) EsCommandSetDisabled(command, !(enabled)) #define EsClipboardHasText(clipboard) EsClipboardHasFormat(clipboard, ES_CLIPBOARD_FORMAT_TEXT) #define EsLiteral(x) (char *) x, EsCStringLength((char *) x) #define ES_STYLE_CAST(x) ((EsStyle *) (uintptr_t) (x)) #ifndef ES_INSTANCE_TYPE #define ES_INSTANCE_TYPE struct EsInstance #else struct ES_INSTANCE_TYPE; #endif #ifdef __cplusplus #define EsInstanceCreate(_message, ...) (static_cast(_EsInstanceCreate(sizeof(ES_INSTANCE_TYPE), _message, __VA_ARGS__))) #else #define EsInstanceCreate(_message, ...) ((ES_INSTANCE_TYPE *) _EsInstanceCreate(sizeof(ES_INSTANCE_TYPE), _message, __VA_ARGS__)) #endif #define ES_SAMPLE_FORMAT_BYTES_PER_SAMPLE(x) \ ((x) == ES_SAMPLE_FORMAT_U8 ? 1 : (x) == ES_SAMPLE_FORMAT_S16LE ? 2 : 4) #define ES_EXTRACT_BITS(value, end, start) (((value) >> (start)) & ((1 << ((end) - (start) + 1)) - 1)) // Moves the bits to the start. #define ES_ISOLATE_BITS(value, end, start) (((value)) & (((1 << ((end) - (start) + 1)) - 1) << (start))) // Keeps the bits in place. #ifndef KERNEL #ifdef ES_API ES_EXTERN_C uintptr_t _APISyscall(uintptr_t argument0, uintptr_t argument1, uintptr_t argument2, uintptr_t unused, uintptr_t argument3, uintptr_t argument4); #define EsSyscall(a, b, c, d, e) _APISyscall((a), (b), (c), 0, (d), (e)) #define _EsSyscall _APISyscall #else #define EsSyscall(a, b, c, d, e) _EsSyscall((a), (b), (c), 0, (d), (e)) #endif #endif #define ES_STRUCT_PACKED __attribute__((packed)) #define ES_FUNCTION_OPTIMISE_O2 __attribute__((optimize("-O2"))) #define ES_FUNCTION_OPTIMISE_O3 __attribute__((optimize("-O3"))) #ifdef ES_BITS_64 #define ES_PTR64_MS32(x) ((uint32_t) ((uintptr_t) (x) >> 32)) #define ES_PTR64_LS32(x) ((uint32_t) ((uintptr_t) (x) & 0xFFFFFFFF)) #else #define ES_PTR64_MS32(x) ((uint32_t) (0)) #define ES_PTR64_LS32(x) ((uint32_t) (x)) #endif // --------- Algorithms: #define ES_MACRO_SORT(_name, _type, _compar, _contextType) void _name(_type *base, size_t nmemb, _contextType context) { \ (void) context; \ if (nmemb <= 1) return; \ \ if (nmemb <= 16) { \ for (uintptr_t i = 1; i < nmemb; i++) { \ for (intptr_t j = i; j > 0; j--) { \ _type *_left = base + j, *_right = _left - 1; \ int result; _compar if (result >= 0) break; \ \ _type swap = base[j]; \ base[j] = base[j - 1]; \ base[j - 1] = swap; \ } \ } \ \ return; \ } \ \ intptr_t i = -1, j = nmemb; \ \ while (true) { \ _type *_left, *_right = base; \ int result; \ \ while (true) { _left = base + ++i; _compar if (result >= 0) break; } \ while (true) { _left = base + --j; _compar if (result <= 0) break; } \ \ if (i >= j) break; \ \ _type swap = base[i]; \ base[i] = base[j]; \ base[j] = swap; \ } \ \ _name(base, ++j, context); \ _name(base + j, nmemb - j, context); \ } \ #define ES_MACRO_SEARCH(_count, _compar, _result, _found) \ do { \ if (_count) { \ intptr_t low = 0; \ intptr_t high = _count - 1; \ \ while (low <= high) { \ uintptr_t index = ((high - low) >> 1) + low; \ int result; \ _compar \ \ if (result < 0) { \ high = index - 1; \ } else if (result > 0) { \ low = index + 1; \ } else { \ _result = index; \ _found = true; \ break; \ } \ } \ \ if (high < low) { \ _result = low; \ _found = false; \ } \ } else { \ _result = 0; \ _found = false; \ } \ } while (0) // --------- Misc: typedef uint64_t _EsLongConstant; typedef long double EsLongDouble; typedef const char *EsCString; #ifndef ES_API ES_EXTERN_C void _init(); ES_EXTERN_C void _start(); #endif #define EsAssert(x) do { if (!(x)) { EsAssertionFailure(__FILE__, __LINE__); } } while (0) #define EsCRTassert EsAssert #define ES_INFINITY __builtin_inff() #define ES_PI (3.1415926535897932384626433832795028841971693994) // --------- Internals: #if defined(ES_API) || defined(KERNEL) || defined(INSTALLER) struct _EsPOSIXSyscall { intptr_t index; intptr_t arguments[7]; }; #define BLEND_WINDOW_MATERIAL_NONE (0) #define BLEND_WINDOW_MATERIAL_GLASS (1) #define BLEND_WINDOW_MATERIAL_LIGHT_BLUR (2) #ifdef ES_ARCH_X86_64 #define BUNDLE_FILE_MAP_ADDRESS (0x100000000UL) #define BUNDLE_FILE_DESKTOP_MAP_ADDRESS (0xF0000000UL) #endif #ifdef ES_ARCH_X86_32 #define BUNDLE_FILE_MAP_ADDRESS (0xA0000000UL) #define BUNDLE_FILE_DESKTOP_MAP_ADDRESS (0xBC000000UL) #endif struct BundleHeader { #define BUNDLE_SIGNATURE (0x63BDAF45) uint32_t signature; uint32_t version; uint32_t fileCount; uint32_t _unused; uint64_t mapAddress; }; struct BundleFile { uint64_t nameCRC64; uint64_t bytes; uint64_t offset; }; struct MemoryAvailable { size_t available; size_t total; }; struct GlobalData { volatile int32_t clickChainTimeoutMs; volatile float uiScale; volatile bool swapLeftAndRightButtons; volatile bool showCursorShadow; volatile bool useSmartQuotes; volatile bool enableHoverState; volatile float animationTimeMultiplier; volatile uint64_t schedulerTimeMs; volatile uint64_t schedulerTimeOffset; volatile uint16_t keyboardLayout; }; #ifdef KERNEL #define K_BOOT_DRIVE "" #else #define K_BOOT_DRIVE "0:" #endif #define K_SYSTEM_FOLDER_NAME "Essence" #define K_SYSTEM_FOLDER K_BOOT_DRIVE "/" K_SYSTEM_FOLDER_NAME #define K_DESKTOP_EXECUTABLE K_SYSTEM_FOLDER "/Desktop.esx" #define K_SYSTEM_CONFIGURATION K_SYSTEM_FOLDER "/Default.ini" #define WINDOW_SET_BITS_NORMAL (0) #define WINDOW_SET_BITS_AFTER_RESIZE (1) #define FAST_SCROLL_HORIZONTAL (1) #define FAST_SCROLL_VERTICAL (2) #define FAST_SCROLL_DO_NOT_ATTEMPT (3) #define CURSOR_USE_ACCELERATION (1 << 0) #define CURSOR_USE_ALT_SLOW (1 << 1) #define CURSOR_SPEED(x) ((x) >> 16) #define CURSOR_TRAILS(x) (((x) >> 13) & 7) #define SHUTDOWN_ACTION_POWER_OFF (1) #define SHUTDOWN_ACTION_RESTART (2) #ifdef __cplusplus extern "C" const void *EsBufferRead(struct EsBuffer *buffer, size_t readBytes); extern "C" const void *EsBufferReadMany(struct EsBuffer *buffer, size_t a, size_t b); extern "C" void *EsBufferWrite(EsBuffer *buffer, const void *source, size_t writeBytes); #define EsBuffer_MEMBER_FUNCTIONS \ inline const void *Read(size_t readBytes) { return EsBufferRead(this, readBytes); } \ inline const void *Read(size_t a, size_t b) { return EsBufferReadMany(this, a, b); } \ inline void *Write(const void *source, size_t writeBytes) { return EsBufferWrite(this, source, writeBytes); } #endif #define ES_POSIX_SYSCALL_GET_POSIX_FD_PATH (0x10000) #define DESKTOP_MESSAGE_SIZE_LIMIT (0x4000) #endif // --------- CRT function macros: #ifdef ES_CRT_WITHOUT_PREFIX #define abs EsCRTabs #define acosf EsCRTacosf #define asinf EsCRTasinf #define assert EsCRTassert #define atan2 EsCRTatan2 #define atan2f EsCRTatan2f #define atanf EsCRTatanf #define atod EsCRTatod #define atof EsCRTatof #define atoi EsCRTatoi #define bsearch EsCRTbsearch #define calloc EsCRTcalloc #define cbrt EsCRTcbrt #define cbrtf EsCRTcbrtf #define ceil EsCRTceil #define ceilf EsCRTceilf #define cos EsCRTcos #define cosf EsCRTcosf #define exp EsCRTexp #define exp2f EsCRTexp2f #define fabs EsCRTfabs #define fabsf EsCRTfabsf #define floor EsCRTfloor #define floorf EsCRTfloorf #define fmod EsCRTfmod #define fmodf EsCRTfmodf #define free EsCRTfree #define getenv EsCRTgetenv #define isalpha EsCRTisalpha #define isdigit EsCRTisdigit #define isnanf EsCRTisnanf #define isspace EsCRTisspace #define isupper EsCRTisupper #define isxdigit EsCRTisxdigit #define malloc EsCRTmalloc #define memchr EsCRTmemchr #define memcmp EsCRTmemcmp #define memcpy EsCRTmemcpy #define memmove EsCRTmemmove #define memset EsCRTmemset #define pow EsCRTpow #define powf EsCRTpowf #define qsort EsCRTqsort #define rand EsCRTrand #define realloc EsCRTrealloc #define sin EsCRTsin #define sinf EsCRTsinf #define snprintf EsCRTsnprintf #define sprintf EsCRTsprintf #define sqrt EsCRTsqrt #define sqrtf EsCRTsqrtf #define strcat EsCRTstrcat #define strchr EsCRTstrchr #define strcmp EsCRTstrcmp #define strcpy EsCRTstrcpy #define strdup EsCRTstrdup #define strerror EsCRTstrerror #define strlen EsCRTstrlen #define strncmp EsCRTstrncmp #define strncpy EsCRTstrncpy #define strnlen EsCRTstrnlen #define strstr EsCRTstrstr #define strtod EsCRTstrtod #define strtof EsCRTstrtof #define strtol EsCRTstrtol #define strtoul EsCRTstrtoul #define tolower EsCRTtolower #define vsnprintf EsCRTvsnprintf #endif