Repository navigation
Releases
v0.12.0
TLDR
The biggest changes with this release are the addition of realistic sky/atmosphere rendering, an initial CPU graphics backend, and moving both the graphics and shader extensions into their own binaries.
There are also a few smaller API and backend improvements, including trickled IO support for low framerates, a swapchain-like blit operation for windows, and some cleanup to the build target API in the build system.
Changelog
Breaking Changes
plShaderI v2.0.1
- moved shader extension to a separate binary (pl_shader_ext.dll/.so/.dylib)
pl-build v2.0.0
- removed bool parameters for targets
- added keyword arguments for reloadable, cache, and max_cache_age_mins
plGraphicsI v2.1.3
- moved graphics extension to a separate binary (pl_graphics_ext.dll/.so/.dylib)
Update Examples
Loading extensions will now require explicitly loading graphics/shader:
// load extensions
ptExtensionRegistry->load("pl_unity_ext", nullptr, nullptr, true);
ptExtensionRegistry->load("pl_platform_ext", "pl_load_platform_ext", "pl_unload_platform_ext", false);
ptExtensionRegistry->load("pl_dear_imgui_ext", "pl_load_dear_imgui_ext", "pl_unload_dear_imgui_ext", false);
ptExtensionRegistry->load("pl_shader_ext", "pl_load_shader_ext", "pl_unload_shader_ext", true);
ptExtensionRegistry->load("pl_graphics_ext", "pl_load_graphics_ext", "pl_unload_graphics_ext", true);
// cpu backend (use these instead of the graphics/shader above
// ptExtensionRegistry->load("pl_shader_cpu_ext", "pl_load_shader_ext", "pl_unload_shader_ext", true);
// ptExtensionRegistry->load("pl_graphics_cpu_ext", "pl_load_graphics_ext", "pl_unload_graphics_ext", true);Features
plRenderer
- added realistic sky/atmosphere rendering
plIOI v1.2.0
- added trickled IO support for low framerates
plGraphicsI v2.1.3
- added initial CPU graphics backend
plWindowI v2.1.0
- added swapchain-like blit operation functions (used by graphics cpu backend)
Fixes
plGraphicsI v2.1.3
- fixed Vulkan backend issue where dynamic bindings didn't work unless other bind groups were also set
- fixed Metal backend not setting the viewport/scissor when beginning a render pass, which caused inconsistent behavior between backends
v0.11.0
TLDR
The biggest changes with this release are removing the experimental backend (i.e. glfw reliance) and moving windowing into the platform extension. This has been overdue for a while. The biggest change from the user standpoint is that multi-viewport support is temporarily removed.
For those using the "new_project.py" script. You may want to start fresh if you modified any of the user build scripts.
Changelog
Breaking Changes
core
- plWindowI moved to pl_platform_ext.h
- remove experimental backends (i.e. glfw)
graphics api v2.1.0
- bNonUniformIndexing removed from plTextureBinding
- removed native vulkan/metal exposure
Fixes
camera api v1.0.3
- fixed project matrix calculations
Features
- added new pilotlight imgui backend (temporarily removed multiviewport support)
graphics api v2.1.0
- added 3D texture support
timer api v1.0.0
- added high res timer api to pl_platform_ext.h
Fixes
build v1.5.1
- fixed issue where cached targets were always built anyway on Linux/MacOs
graphics api v2.1.0
- fixed metal backend not properly recycling bind groups
- fixed metal backend not honoring buffer row lengths in copy_buffer_to_texture(...)
v0.10.1
News
We will now start utilizing releases (in addition to the tags we have been using).
Changelog
Breaking Changes
All of the breaking changes are related to the graphics API v1 to v2 upgrade and updates to the naming convention for enums being prepended with an "e" instead of a "t".
graphics api v2.0.0
Many of these changes have been a long time coming. The caveat is that now we require Metal 4.0 and Vulkan 1.4. For MacOS users this means we now only support Apple silicon (M1+) and MacOS 26 or greater. For Windows & Linux users you need to ensure your graphics drivers are updated and that your graphics card supports Vulkan 1.4 (most desktop cards do).
- moved from renderpasses to dynamic rendering
- removed explicit image layouts
- removed events (for now)
- added consumer, producer, & intrapass barriers
- removed render, compute, & blit encoders
- combined blit & compute passes
- changed enum members to start with "e"
- removed plBeginCommandInfo when starting command recordings (now everything is given at submit time)
- added size parameter when allocating dynamic memory blocks
- removed all obsolete items
- plBindGroupUpdateData now uses arrays to allow in-place creation
- plGraphicsState parameters start with "b", "e", or "u" instead of "ul"
- plSubmitInfo now contains the wait semaphore information
- removed transient attachment types (for now)
draw api v3.0.0
- submit_2d_drawlist now takes command buffer & plRenderAttachmentInfo for gfx 2.0 changes
- submit_3d_drawlist now takes command buffer & plRenderAttachmentInfo for gfx 2.0 changes
dxt api v2.0.0
- renamed plDxtInfo struct member from tFlags to eFlags
ecs extension v2.0.0
- renamed plTransformComponent struct member from tFlags to eFlags
shader api
- renamed plShaderOptions struct member from tFlags to eFlags
- renamed plShaderOptions struct member from tOptimizationLevel to eOptimizationLevel
starter api
- begin_main_pass(...) now returns command buffer instead of encoders
- removed blit encoders
- removed render pass stuff
- added get_render_attachment_info(...)
- changed plStarterInit member tFlags to eFlags
file api v2.0.0
- renamed plDirectoryEntry struct member from tType to eType
Features
starter api v2.1.0
- added get_readback_buffer(...) & return_readback_buffer(...)
- added get_staging_buffer(...) & return_staging_buffer(...)
- added create_texture(...)
- added create_buffer(...)
Fixes
graphics api v2.0.0
- fixed copy buffer to texture issues with texture arrays