// ----------------- Includes: #ifndef IncludedEssenceAPIHeader #define IncludedEssenceAPIHeader #include #ifndef KERNEL #include #include #include #endif #include // --------- 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_1(x, y) x ## y #define EsDEFER_2(x, y) EsDEFER_1(x, y) #define EsDEFER_3(x) EsDEFER_2(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; inline EsGeneric(uintptr_t y) { u = y; } inline EsGeneric( intptr_t y) { i = y; } 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 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 (4096) #define ES_PAGE_BITS (12) typedef struct EsCRTjmp_buf { uintptr_t rsp, rbp, rbx, r12, r13, r14, r15, rip; } EsCRTjmp_buf; 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)) #endif #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_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 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 // --------- 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) // --------- Internal APIs: #if defined(ES_API) || defined(KERNEL) struct EsProcessStartupInformation { bool isDesktop, isBundle; uintptr_t applicationStartAddress; uintptr_t tlsImageStart; uintptr_t tlsImageBytes; uintptr_t tlsBytes; // All bytes after the image are to be zeroed. }; 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 ARCH_X86_64 #define BUNDLE_FILE_MAP_ADDRESS (0x100000000UL) #define BUNDLE_FILE_DESKTOP_MAP_ADDRESS (0xF0000000UL) #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; }; #ifdef KERNEL #define K_BOOT_DRIVE "" #else #define K_BOOT_DRIVE "0:" #endif #define K_OS_FOLDER K_BOOT_DRIVE "/Essence" #define K_DESKTOP_EXECUTABLE K_OS_FOLDER "/Desktop.esx" #define K_SYSTEM_CONFIGURATION K_OS_FOLDER "/System Configuration.ini" #define CREATION_ARGUMENT_MAIN (0) #define CREATION_ARGUMENT_ENVIRONMENT (1) #define CREATION_ARGUMENT_INITIAL_MOUNT_POINTS (2) #define WINDOW_SET_BITS_NORMAL (0) #define WINDOW_SET_BITS_SCROLL_HORIZONTAL (1) #define WINDOW_SET_BITS_SCROLL_VERTICAL (2) #define WINDOW_SET_BITS_AFTER_RESIZE (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 atan2f EsCRTatan2f #define atanf EsCRTatanf #define atoi EsCRTatoi #define bsearch EsCRTbsearch #define calloc EsCRTcalloc #define ceil EsCRTceil #define ceilf EsCRTceilf #define cosf EsCRTcosf #define exp EsCRTexp #define exp2f EsCRTexp2f #define fabs EsCRTfabs #define fabsf EsCRTfabsf #define floor EsCRTfloor #define floorf EsCRTfloorf #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 powf EsCRTpowf #define qsort EsCRTqsort #define rand EsCRTrand #define realloc EsCRTrealloc #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 strtol EsCRTstrtol #define strtoul EsCRTstrtoul #define tolower EsCRTtolower #define vsnprintf EsCRTvsnprintf #endif