Skip to content

CHANGELOG.md

Latest commit

 

History

History
123 lines (94 loc) · 5.61 KB

CHANGELOG.md

File metadata and controls

123 lines (94 loc) · 5.61 KB

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

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

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.

[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.

[1.3.0] - 2025-11-21

Features

  • Video: Added Wayland backend support

  • 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 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.

  • 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.

  • Event: Added PAL_EVENT_WINDOW_DECORATION_MODE to PalEventType enum.

  • Event: Added PalDecorationMode enum.

Tests

  • Added native integration example: demonstrating Native API Integration with PAL API. see native_integration_test.c.

  • Added native instance example: demonstrating Native Instance or Display Integration with PAL API. see native_instance_test.c.

  • Added custom decoration example: demonstrating Custom Window Decoration. see custom_decoration_test.c.

Notes

  • No ABI changes - existing code remains compatible.

  • OpenGL tests may fail - The opengl system now needs to call palGLSetInstance() to set the instance or display before initializing. Failure to do this fails. This is a runtime behavior change. The tests are updated in the repo.

  • Pal mouse button event - The event.data now packs both the button and wayland seat serial (If on wayland). Existing code that reads as a single value without unpacking will see different values. This is a runtime behavior change. The input_window_test.c has been updated in the repo.

  • palJoinThread() - ABI remains unchanged but now takes the address of a pointer variable for the return value of the thread. PAL internally reinterpreted into a pointer-to-pointer. This is for ABI stability.

Example – Join thread and get the return value

void* retval;
palJoinThread(thread, &retval);