Add graphics system

.clang-format

@@ -1,7 +1,10 @@
 
 BasedOnStyle: LLVM # use LLVM defauls
 IndentWidth: 4
-ColumnLimit: 80
+ColumnLimit: 100
+UseTab: Never
+UseCRLF: false
+LineEnding: LF
 
 # reset if not set
 AllowShortFunctionsOnASingleLine: None
@@ -35,4 +38,4 @@ BraceWrapping:
   IndentBraces:    false
   SplitEmptyFunction: true
   SplitEmptyRecord: true
-  SplitEmptyNamespace: true
+  SplitEmptyNamespace: true

.editorconfig

@@ -0,0 +1,19 @@
+
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 4
+tab_width = 4
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+max_line_width = 100
+
+[*.{yml, yaml}]
+indent_style = space
+indent_size = 2
+
+[*md]
+trim_trailing_whitespace = false

.github/CONTRIBUTING.md

@@ -38,4 +38,4 @@ Pull request checklist:
 
 - Ensure it compiles on **all** supported platforms.
 - Ensure the PR is focused and changes are relevant to the feature or bug fix.
-- Ensure your code is formatted with clang-format using the `clang-format` file in the repo.
+- Ensure your code is formatted with clang-format using the `clang-format` file in the repo.

.github/ISSUE_TEMPLATE/config.yaml

@@ -1 +1 @@
-blank_issues_enabled: false
+blank_issues_enabled: false

.github/workflows/clang-format.yml

@@ -17,7 +17,7 @@ jobs:
 
       - name: Install clang-format
         run: |
-          sudo apt-get update 
+          sudo apt-get update
           wget https://apt.llvm.org/llvm.sh
           chmod +x llvm.sh
           sudo ./llvm.sh 21

.gitignore

@@ -6,18 +6,25 @@
 **.vs
 
 # Binaries
-**bin
-**build
+/bin/
+/build/
+
+# build reflection
+include/pal/pal_config.h
 
 # MakeFiles
 Makefile
 **.make
 
 #  Visual studio files
 **.sln
+**.slnx
 **.filters
 **.user
 **.vcxproj
 
 # docs
-docs/**html
+docs/**html
+
+# ppm files
+**.ppm

CHANGELOG.md

@@ -1,74 +1,134 @@
-# CHANGELOG
 
-## [1.0.0] - 2025-09-27
-- Initial stable release of PAL.
-
-## [1.0.1] - 2025-10-01
-
-**Bugfix release** - improve C/C++ interop and build integration
+<!-- ===========================================================-->
+<!-- PAL V2.0.0 -->
+<!-- =========================================================== -->
 
-### Fixed
-- Added extern "C" guards to all exported functions so PAL can now be linked from both **C** and **C++** projects.
-- Fixed a **condition variable** bug where the wrong thread could acquire the mutex first, causing intermittent locking issues. See **tests/condvar_test.c**
-- Updated premake scripts to allow **PAL to be included as a submodule or directly in another workspace** if the build system is **premake**.
-
-### Notes
-- No API or ABI changes
-- Safe upgrade from **v1.0** - just rebuild your project after updating.
-
-## [1.1.0] - 2025-10-17
+## 2.0.0
 
 ### Features
-- **Build:** Added Linux platform support across all modules.
-- **Core:** Added Linux backend support.
-- **Video:** Added X11-based backend support.
-- **Thread:** Added Linux backend support.
-- **Opengl:** Added Linux backend support.
-- **System:** Added Linux backend support.
-- **Video:** Added **palCreateCursorFrom()** to create system cursors.
-- **Video:** Added **palSetFBConfig()** to select window FBConfig.
-- **Video:** Added **PAL_VIDEO_FEATURE_WINDOW_SET_ICON** to `PalVideoFeatures` enum.
-- **System:** Added **PAL_PLATFORM_API_COCOA** to `PalPlatformApiType` enum.
-- **System:** Added **PAL_PLATFORM_API_ANDRIOD** to `PalPlatformApiType` enum.
-- **System:** Added **PAL_PLATFORM_API_UIKIT** to `PalPlatformApiType` enum.
-- **System:** Added **PAL_PLATFORM_API_HEADLESS** to `PalPlatformApiType` enum.
-- **Core:** Added **PAL_RESULT_INVALID_FBCONFIG_BACKEND** to `PalResult` enum.
 
-### Changed
-- **System:** `PalCPUInfo.architecture` is now determined at runtime instead of build time.
-- **Opengl:** **palEnumerateGLFBConfigs()** now does not use the `glWindow` paramter. Set to `nullptr`
+- Added a graphics system API (`pal2/pal_graphics.h`). (#4)
+- Added `palGetResultCode()` to get the result code from a result value. (#4)
+- Added `palGetResultSource()` to get the result source from a result value. (#4)
+- Added `palGetResultNativeCode()` to get the result native code from a result value. (#4)
+- Added `palGetSupportedGLAPIs()` to check supported opengl api types. (#4)
+- Added type `PalResultCode` with values: (#4)
+  - `PAL_RESULT_CODE_INVALID_ARGUMENT`
+  - `PAL_RESULT_CODE_OUT_OF_MEMORY`
+  - `PAL_RESULT_CODE_PLATFORM_FAILURE`
+  - `PAL_RESULT_CODE_TIMEOUT`
+  - `PAL_RESULT_CODE_INVALID_HANDLE`
+  - `PAL_RESULT_CODE_FEATURE_NOT_SUPPORTED`
+  - `PAL_RESULT_CODE_INVALID_OPERATION`
+  - `PAL_RESULT_CODE_DEVICE_LOST`
+  - `PAL_RESULT_CODE_OUT_OF_DATE`
+- Added type `PalResultSource` with values: (#4)
+  - `PAL_RESULT_SOURCE_NONE`
+  - `PAL_RESULT_SOURCE_WIN32`
+  - `PAL_RESULT_SOURCE_POSIX`
+  - `PAL_RESULT_SOURCE_EGL`
+  - `PAL_RESULT_SOURCE_VULKAN`
+  - `PAL_RESULT_SOURCE_D3D12`
+  - `PAL_RESULT_SOURCE_METAL`
+- Added type `PalGLBackend` with values: (#4)
+  - `PAL_GL_BACKEND_EGL`
+  - `PAL_GL_BACKEND_GLX`
+  - `PAL_GL_BACKEND_WGL`
+- Added type `PalGLAPI` with values: (#4)
+  - `PAL_GL_API_OPENGL`
+  - `PAL_GL_API_OPENGL_ES`
+- Added `_COUNT` constants to all type groups (eg. `PAL_EVENT_TYPE_COUNT`). (#4)
+- Added `PAL_GL_GRAPHICS_CARD_NAME_SIZE`,`PAL_GL_VENDOR_NAME_SIZE` and `PAL_GL_VERSION_NAME_SIZE` constants. (#4)
 
-### Fixed
-- Fixed a bug where **enter modal mode and exit modal mode** operations triggered only one event.
-- Fixed repeated window state event (**minimized**, **maximized**, **restore**).
+### Changes
 
-### Notes
-- No API or ABI changes - existing Windows code remains compatible.
-- Linux video support currently targets **X11** only: **Wayland** is planned for future releases.
-- Safe upgrade from **v1.0.1** - just rebuild your project after updating.
+- Moved all public header files to `pal2` directory (eg. `pal2/pal_video.h`). (#4)
+- `palGetVersion()` now returns `void` and takes a pointer to the struct. (#4)
+- `palFormatResult()` now takes two additional parameters (#4)
+- Converted all enum types to fixed-width integer types and their values to standalone constants (eg. `PalResult` to `uint64_t`). (#4)
+- Removed all previous `PalResult` values except: `PAL_RESULT_SUCCESS` (#4)
+- Removed `palGLSetInstance()` function. (#4)
+- Removed `palGLGetBackend()` function. (#4)
+- Removed `palGetVideoFeaturesEx()` function and `PalVideoFeatures64` enum. (#4)
+- Removed `palGetWindowHandleInfoEx()` function and `PalWindowHandleInfoEX` struct. (#4)
+- Removed `palGetRawMouseWheelDelta()` function. (#4)
+- Removed `palSetPreferredInstance()` function. (#4)
+- Removed `palSetFBConfig()` function. (#4)
+- Removed `PAL_FBCONFIG_BACKEND_GLES`. (#4)
+- `palInitGL()` now takes two additional parameters. (#4)
+- `palEnumerateGLFBConfigs()` no longer takes the `glWindow` and `count` now as `uint32_t` (#4)
+- `palInitVideo()` now takes an additional parameter. (#4)
+- `palGetWindowHandleInfo()` now returns `PalResult` and takes a pointer to the struct. (#4)
+- `PalGLInfo` now has `backend` and `api` fields. (#4)
+- Renamed `nativeDisplay` to `nativeInstance` in `PalWindowHandleInfo`. (#4)
+- Renamed `display` to `instance` in `PalGLWindow`. (#4)
+- `PalWindowHandleInfo` now has `nativeHandle1`, `nativeHandle2` and `nativeHandle3` fields. (#4)
+- `PalWindowCreateInfo` now has `state`, `appName`, `instanceName`, `fbConfigBackend` and `fbConfigIndex` fields. (#4)
+- Removed `maximized` and `minimized` in `PalWindowCreateInfo`. (#4)
+- Removed `UintXX` and `IntXX` types in favor of standard `uintXX_t` and `intXX_t`. (#4)
+- Removed `_MAX` constants from all type groups (eg. `PAL_EVENT_MAX`). (#4)
+- Replaced standard `bool` type and `true`/`false` constants with `PalBool` type and `PAL_TRUE`/`PAL_FALSE`. (#4)
+- Renamed `PalGLRelease` to `PalGLReleaseBehavior`. (#4)
+- Renamed `palGLGetProcAddress()` to `palGetGLProcAddress()`. (#4)
+- Renamed event type constants from `PAL_EVENT_**` to `PAL_EVENT_TYPE_**`. (#4)
+- Renamed dispatch mode constants from `PAL_DISPATCH_**` to `PAL_DISPATCH_MODE_**`. (#4)
+- Renamed platform type constants from `PAL_PLATFORM_**` to `PAL_PLATFORM_TYPE_**`. (#4)
+- Renamed platform api type constants from `PAL_PLATFORM_API_**` to `PAL_PLATFORM_API_TYPE_**`. (#4)
+- Renamed cursor type constants from `PAL_CURSOR_**` to `PAL_CURSOR_TYPE_**`. (#4)
+- Renamed flash flag constants from `PAL_FLASH_**` to `PAL_FLASH_FLAG_**`. (#4)
+- Renamed fbConfig backend type constants from `PAL_FBCONFIG_BACKEND_**` to `PAL_FBCONFIG_BACKEND_**`. (#4)
+- Renamed `PalFlashFlag` to `PalFlashFlags`. (#4)
+- `palGetMouseDelta()` now takes `dx` and `dy` paramters as `float`. (#4)
+- `palEnumerateMonitors()` now takes `count` paramter as `uint32_t`. (#4)
+- `palEnumerateMonitorModes()` now takes `count` paramter as `uint32_t`. (#4)
+- `palGetClosestGLFBConfig()` now takes `count` paramter as `uint32_t`. (#4)
+- `palGetMouseWheelDelta()` now takes `dx` and `dy` paramters as `float`. (#4)
+- `palJoinThread()` now takes `retval` paramters as `void**`. (#4)
+- `palUnpackUint32()` now takes `data` paramters as `uint64_t`. (#4)
+- `palUnpackInt32()` now takes `data` paramters as `uint64_t`. (#4)
+- `palUnpackPointer()` now takes `data` paramters as `uint64_t`. (#4)
+- `palUnpackFloat()` now takes `data` paramters as `uint64_t`. (#4)
+- `palPackUint32()` now returns `uint64_t` instead of `int64_t`. (#4)
+- `palPackInt32()` now returns `uint64_t` instead of `int64_t`. (#4)
+- `palPackPointer()` now returns `uint64_t` instead of `int64_t`. (#4)
+- `palPackFloat()` now returns `uint64_t` instead of `int64_t`. (#4)
+- These function now returns `void` instead of `PalResult` and does not do runtime validation anymore: (#4)
+  - `palGetPlatformInfo()`
+  - `palGetCPUInfo()`
+  - `palGetThreadName()`
+  - `palGetPrimaryMonitor()`
+  - `palGetMonitorInfo()`
+  - `palEnumerateMonitorModes()`
+  - `palGetCurrentMonitorMode()`
+  - `palMinimizeWindow()`
+  - `palMaximizeWindow()`
+  - `palRestoreWindow()`
+  - `palShowWindow()`
+  - `palHideWindow()`
+  - `palGetWindowStyle()`
+  - `palGetWindowMonitor()`
+  - `palGetWindowTitle()`
+  - `palGetWindowPos()`
+  - `palGetWindowSize()`
+  - `palGetWindowState()`
+  - `palGetWindowHandleInfo()`
+  - `palSetWindowStyle()`
+  - `palSetWindowTitle()`
+  - `palSetWindowPos()`
+  - `palSetWindowSize()`
+  - `palSetFocusWindow()`
+  - `palSetWindowIcon()`
+  - `palClipCursor()`
+  - `palGetCursorPos()`
+  - `palSetCursorPos()`
+  - `palSetWindowCursor()`
+  - `palSetWindowOpacity()`
+  - `palFlashWindow()`
+  - `palSetSwapInterval()`
 
-## [1.2.0] - 2025-10-22
-
-### Features
-- **Video:** Added **palGetInstance()** to retrieve the native display or instance handle.
-- **Video:** Added **palAttachWindow()** for attaching **foreign windows** to PAL.
-- **Video:** Added **palDetachWindow()** for detaching **foreign windows** from PAL.
-- **Event:** Added **PAL_EVENT_KEYCHAR** to `PalEventType` enum.
-- **Event:** Added documentation for event bits(payload) layout.
-
-### Naming Update
-- PAL now stands for **Prime Abstraction Layer**, 
-reflecting its role as the primary explicit foundation for OS and graphics abstraction.
-- All API remains unchanged — this is an identity update only.
-
-### Tests
-- Added multi-threaded OpenGL example: demonstrating **Multi-Threaded OpenGL Rendering**. see **multi_thread_opengl_test.c**.
-- Added attaching and detach foreign windows example. see **attach_window_test.c**
-- Added key character example. see **char_event_test.c**
-
-### Notes
-- No API or ABI changes - existing code remains compatible.
-- Safe upgrade from **v1.1.0** - just rebuild your project after updating.
+<!-- =========================================================== -->
+<!-- PAL V1.3.0 -->
+<!-- =========================================================== -->
 
 ## [1.3.0] - 2025-11-21
 
@@ -77,11 +137,11 @@ reflecting its role as the primary explicit foundation for OS and graphics abstr
 - **Video:** Added **palGetVideoFeaturesEx()** to check old and extended supported features.
 - **Video:** Added **palGetWindowHandleInfoEx()** to get extended window handles.
 - **Video:** Added **palGetRawMouseWheelDelta()** to get raw mouse wheel delta.
-- **Video:** Added **PAL_CONFIG_BACKEND_GLES** to `PalFBConfigBackend` enum.
+- **Video:** Added **PAL_FBCONFIG_BACKEND_GLES** to `PalFBConfigBackend` enum.
 - **Video:** Added **palSetPreferredInstance()** to set the native instance or display PAL video should use rather than creating a new one.
 
-- **Core:** Added **palPackFloat()** to combine two floats into a single Int64 integer.
-- **Core:** Added **palUnpackFloat()** to retreive two floats from a single Int64 integer.
+- **Core:** Added **palPackFloat()** to combine two floats into a single int64_t integer.
+- **Core:** Added **palUnpackFloat()** to retreive two floats from a single int64_t integer.
 
 - **OpenGL:** Added **palGLSetInstance()** to set the native instance or display PAL opengl should use. This must be set before calling **palInitGL()**.
 - **OpenGL:** Added **palGLGetBackend()** to get the opengl backend.
@@ -121,3 +181,88 @@ void* retval;
 palJoinThread(thread, &retval);
 ```
 
+<!-- =========================================================== -->
+<!-- PAL V1.2.0 -->
+<!-- =========================================================== -->
+
+## [1.2.0] - 2025-10-22
+
+### Features
+- **Video:** Added **palGetInstance()** to retrieve the native display or instance handle.
+- **Video:** Added **palAttachWindow()** for attaching **foreign windows** to PAL.
+- **Video:** Added **palDetachWindow()** for detaching **foreign windows** from PAL.
+- **Event:** Added **PAL_EVENT_KEYCHAR** to `PalEventType` enum.
+- **Event:** Added documentation for event bits(payload) layout.
+
+### Naming Update
+- PAL now stands for **Prime Abstraction Layer**, 
+reflecting its role as the primary explicit foundation for OS and graphics abstraction.
+- All API remains unchanged — this is an identity update only.
+
+### Tests
+- Added multi-threaded OpenGL example: demonstrating **Multi-Threaded OpenGL Rendering**. see **multi_thread_opengl_test.c**.
+- Added attaching and detach foreign windows example. see **attach_window_test.c**
+- Added key character example. see **char_event_test.c**
+
+### Notes
+- No API or ABI changes - existing code remains compatible.
+- Safe upgrade from **v1.1.0** - just rebuild your project after updating.
+
+<!-- =========================================================== -->
+<!-- PAL V1.1.0 -->
+<!-- =========================================================== -->
+
+## [1.1.0] - 2025-10-17
+
+### Features
+- **Build:** Added Linux platform support across all modules.
+- **Core:** Added Linux backend support.
+- **Video:** Added X11-based backend support.
+- **Thread:** Added Linux backend support.
+- **Opengl:** Added Linux backend support.
+- **System:** Added Linux backend support.
+- **Video:** Added **palCreateCursorFrom()** to create system cursors.
+- **Video:** Added **palSetFBConfig()** to select window FBConfig.
+- **Video:** Added **PAL_VIDEO_FEATURE_WINDOW_SET_ICON** to `PalVideoFeatures` enum.
+- **System:** Added **PAL_PLATFORM_API_COCOA** to `PalPlatformApiType` enum.
+- **System:** Added **PAL_PLATFORM_API_ANDRIOD** to `PalPlatformApiType` enum.
+- **System:** Added **PAL_PLATFORM_API_UIKIT** to `PalPlatformApiType` enum.
+- **System:** Added **PAL_PLATFORM_API_HEADLESS** to `PalPlatformApiType` enum.
+- **Core:** Added **PAL_RESULT_INVALID_FBCONFIG_BACKEND** to `PalResult` enum.
+
+### Changed
+- **System:** `PalCPUInfo.architecture` is now determined at runtime instead of build time.
+- **Opengl:** **palEnumerateGLFBConfigs()** now does not use the `glWindow` paramter. Set to `nullptr`
+
+### Fixed
+- Fixed a bug where **enter modal mode and exit modal mode** operations triggered only one event.
+- Fixed repeated window state event (**minimized**, **maximized**, **restore**).
+
+### Notes
+- No API or ABI changes - existing Windows code remains compatible.
+- Linux video support currently targets **X11** only: **Wayland** is planned for future releases.
+- Safe upgrade from **v1.0.1** - just rebuild your project after updating.
+
+<!-- =========================================================== -->
+<!-- PAL V1.0.1 -->
+<!-- =========================================================== -->
+
+## [1.0.1] - 2025-10-01
+
+**Bugfix release** - improve C/C++ interop and build integration
+
+### Fixed
+- Added extern "C" guards to all exported functions so PAL can now be linked from both **C** and **C++** projects.
+- Fixed a **condition variable** bug where the wrong thread could acquire the mutex first, causing intermittent locking issues. See **tests/condvar_test.c**
+- Updated premake scripts to allow **PAL to be included as a submodule or directly in another workspace** if the build system is **premake**.
+
+### Notes
+- No API or ABI changes
+- Safe upgrade from **v1.0** - just rebuild your project after updating.
+
+<!-- =========================================================== -->
+<!-- PAL V1.0.0 -->
+<!-- =========================================================== -->
+
+## [1.0.0] - 2025-09-27
+- Initial stable release of PAL.