Tags

v6.292.1

This minor release includes several important bug fixes to downscaler
kernels, a new and improved default perceptual gamut mapping mode, and
an overhaul of the `plplay` demo program's core timing loop. It also
drops the requirement for VK_KHR_synchronization2, which was
unnecessarily and prohibitively strict in practice.

Note that because this minor release does not change the public API,
several new options related to the above changes are not yet exposed as
part of this release.

Fixes and other enhancements:
- improve the quality of fallback tone-mapping (without state object)
- implement fast path for saturation mapping
- don't clip overlays during tone mapping / gamut conversion
- enhance gamut 3DLUT visualization
- fix aliasing when antiringing during downscaling
- fix aliasing when downscaling with polar (EWA) filters
- revert requirement for VK_KHR_synchronization2
- fix possible queue underrun bug on very high fps sources
- correctly support displays above 200 Hz
- improve timing loop of plplay
- add CPU metrics and frame statistics to plplay
- fix build errors on 32-bit windows
- correctly flush when submitting frame on opengl
- fix bug when using contrast recovery with bilinear sampling
- fix compilation warning on some platforms
- properly handle interpolation on single frame files
- fix memory leak of d3d11 helper buffer
- fix vulkan debug_extra not being respected
- remove unusable rxgxbxax10/12 formats
- various fixes to the test framework
- fix compute shaders being incorrectly enabled at too-low GLSL versions
- fix capability masking when limiting max GLSL version
- fix HLG source peak tuning logic when display luminance is known
- fix unintended tone-mapping from SDR sources with embedded ICC
  profiles on unknown SDR displays
- fix ICC profile luminance metadata being ignored on redraws when using
  pl_render_image_mix
- improve quality of perceptual gamut mapper, and vastly decrease time
  to compute
- increase default 3DLUT precision
- fix numerical accuracy of pl_primaries_superset
- disable gamut mapping if either colorspace does not describe a normal RGB
  colorspace (e.g. swapped channels from synthetic test ICC profiles)

v6.292.0

This release focuses on a major overhaul of gamut mapping, including an
all-new perceptual colorspace (IPTPQc4) and related set of 3DLUT
generation primitives. The new default gamut mapping has been replaced
by a perceptual soft-clip operation which attempts mapping primaries
onto primaries while preserving a balance of both intensity and
chromaticity. The old bespoke tone mapping modes have been replaced by a
single colorimetric (IPTPQc4) tone mapping scheme. Lastly, a new HDR
contrast recovery option helps preserve detail in very bright
tone-mapped regions.

In addition, this release focuses on major performance improvements to
the shader generation system, considerably reducing CPU overhead in
release builds.

Finally, full support has been added for libavutil Vulkan hwcontexts,
allowing libplacebo to work directly with Vulkan Video decoding without
any memory copy overhead.

Additions:
- add `pl_shader_info`
- add `pl_ipt_lms2rgb/rgb2lms and pl_ipt_lms2ipt/ipt2lms`
- add <libplacebo/gamut_mapping.h>
- add `pl_color_map_params.visualize_hue/theta` to visualize gamut 3DLUT
- add `pl_vulkan_required_features`
- add `pl_get_mapped_avframe` to retrieve AVFrame from mapped pl_frame
- add `linear` frame mixer to pl_frame_mixers
- add `pl_render_params.corner_rounding`
- add `pl_matrix2x2_scale/invert` and `pl_transform2x2_scale/invert`
- add `pl_shader_distort` and `pl_render_params.distort_params` to
  enable arbitrary affine distortions (e.g. arbitrary rotation, shear,
  flip/scale) as a final output post-processing step
- add PL_HOOK_PRE_OUTPUT
- add `pl_shader_color_map_ex` and `pl_color_map_args` as a more
  flexible API variant of `pl_shader_color_map`
- add `pl_color_map_parms.contrast_recovery/smoothness` settings, plus
  `pl_color_map_args.feature_map` and `pl_shader_extract_features`
- add `pl_transform2x2_bounds` to compute bounding box of transform
- add `PL_COLOR_HDR_BLACK`, `PL_COLOR_SDR_CONTRAST` and
  `PL_COLOR_HLG_PEAK` to replace previously-hardcoded magic constants
- add `pl_peak_detect_high_quality_params` and
  `pl_color_map_high_quality_params`

Changes:
- drop public APIs deprecated for libplacebo v4
- require vulkan 1.3 headers at compile time
- require vulkan 1.2 as a minimum runtime version
- require a minimum version of GLSL 130 (GL/ES 3.0+)
- require a mininum version of meson 0.63 to build
- `pl_dispatch_info.shader` has been changed from `pl_shader_res` to
  `pl_shader_info`, which may require updating some code (the fields
  should be mostly backwards compatible)
- complete refactor of `pl_color_map_params` gamut mapping settings
- reduce default tone-mapping LUT size from 1024 to 256
- deprecate `pl_vulkan.queues`
- add `pl_vulkan_params.extra_queues` to enable more queue types
- users are no longer required to use extension-specific vulkan feature
  structs, and may freely mix and match them with vulkan 1.x
  meta-structs - additionally, both types of structs are reported in
  `pl_vulkan.features`
- `pl_vulkan_wrap_params.aspect` can now be left as 0 when not mapping
  individual planes of planar images
- also enable subgroup clustered and quad operations in shaders
- change type of `pl_vulkan.(un)lock_queue` to uint32_t, to match Vulkan
  API and libavutil vulkan hwcontext
- enable peak detection (sans histogram) by default in
  `pl_render_default_params`

Fixes and performance enhancements:
- drop various backwards compatibility paths for GLSL 110
- fix clipping artefacts when using textureless linear tone-mapping
- fix source black point determination when using ICC profiles
- vastly improve CPU overhead of shader (re-)generation on release
  builds, at the cost of less friendly variable names
- significantly improve CPU overhead of pl_shader-related internal
  temporary allocations and various other related operations
- fix HDR passthrough minimum luma value being ignored
- minor fixes and performance improvements on internal allocator
- fix various possible sources of minor memory leaks
- various fixes and improvements to the meson build scripts
- work-around nvidia-specific swapchain resizing bug, at the cost of
  performance when resizing the window
- fix frame queue FPS estimation for non-monotonic PTS
- fix negative inputs edge case in pl_hdr_rescale
- clamp detected HDR peak to legal PQ range
- avoid unnecessary tone-mapping LUT regeneration on static content
- minor optimizations to the fast bicubic shader
- minor theoretical overhead reduction by forcing LOD level
- fix pl_map_avframe_ex data buffer handling
- various improvements and bug fixes to the `plplay` demo program
- correctly handle v4 perceptual ICC profiles
- fix memory leak of vulkan queue locks
- fix theoretical UB in vulkan memory barrier ordering semantics
- relax unnecessarily strict / redundant host memory barriers
- improve debug logging to understand where VRAM is being allocated
- reduce fragmentation of large VRAM allocations (>= 64 MB)
- fix edge case where DRM format modifier was incorrectly checked on
  export
- correctly find vulkan SDK headers via VULKAN_SDK env var
- correctly init d3d11 monitored fences
- various fixes to d3d11 error reporting and logging
- fix extension loading on pl_vulkan_import
- various fixes to d3d11 register allocation
- fix edge case when encountering incomplete interlaced streams
- fix pl_queue_update with explicitly provided "extreme" vsync ratios
- properly hold last interpolated frame for an extra 1/fps duration
- fix off-by-one in interpolation EOF semantics
- fix discontinuity in black point handling of st2094-40
- fix possible double-acquire in pl_renderer frame acquisition logic, as
  well as a possible use-after-unacquire
- correctly handle mistagged YCbCr AVFrames (e.g. tagged as RGB)
- fix incorrect clamping in pl_render_image(..., NULL) path
- fix crash when effectively rendering to blank/empty target crop
- fix alpha blending output
- significantly speed up mathematical opeations on mingw builds
- fix ICC profile gamma estimation for very strange synthetic test
  profiles
- fix excessive saturation when using black point compensation,
  inverse tone mapping, or tone mapping very bright videos
- fix edge case where pl_frame_queue returned frames too early
- various fixes to `pl_color_space_nominal_luma_ex`
- fix issue when using peak detection on older GPUs
- substantially improve performance of peak detection shader, especially
  when measuring a frame histogram
- correctly hook PL_HOOK_SCALED even when using free/bilinear sampling
- peak detection is now performed after downscaling, when viewing
  high-res HDR content on a low-res monitor/window
- fix clipping of overlays on targets with HDR metadata

v6.292.0-rc3

This release focuses on a major overhaul of gamut mapping, including an
all-new perceptual colorspace (IPTPQc4) and related set of 3DLUT
generation primitives. The new default gamut mapping has been replaced
by a perceptual soft-clip operation which attempts mapping primaries
onto primaries while preserving a balance of both intensity and
chromaticity. The old bespoke tone mapping modes have been replaced by a
single colorimetric (IPTPQc4) tone mapping scheme. Lastly, a new HDR
contrast recovery option helps preserve detail in very bright
tone-mapped regions.

In addition, this release focuses on major performance improvements to
the shader generation system, considerably reducing CPU overhead in
release builds.

Finally, full support has been added for libavutil Vulkan hwcontexts,
allowing libplacebo to work directly with Vulkan Video decoding without
any memory copy overhead.

Additions:
- add `pl_shader_info`
- add `pl_ipt_lms2rgb/rgb2lms and pl_ipt_lms2ipt/ipt2lms`
- add <libplacebo/gamut_mapping.h>
- add `pl_color_map_params.visualize_hue/theta` to visualize gamut 3DLUT
- add `pl_vulkan_required_features`
- add `pl_get_mapped_avframe` to retrieve AVFrame from mapped pl_frame
- add `linear` frame mixer to pl_frame_mixers
- add `pl_render_params.corner_rounding`
- add `pl_matrix2x2_scale/invert` and `pl_transform2x2_scale/invert`
- add `pl_shader_distort` and `pl_render_params.distort_params` to
  enable arbitrary affine distortions (e.g. arbitrary rotation, shear,
  flip/scale) as a final output post-processing step
- add PL_HOOK_PRE_OUTPUT
- add `pl_shader_color_map_ex` and `pl_color_map_args` as a more
  flexible API variant of `pl_shader_color_map`
- add `pl_color_map_parms.contrast_recovery/smoothness` settings, plus
  `pl_color_map_args.feature_map` and `pl_shader_extract_features`
- add `pl_transform2x2_bounds` to compute bounding box of transform
- add `PL_COLOR_HDR_BLACK`, `PL_COLOR_SDR_CONTRAST` and
  `PL_COLOR_HLG_PEAK` to replace previously-hardcoded magic constants
- add `pl_peak_detect_high_quality_params` and
  `pl_color_map_high_quality_params`

Changes:
- drop public APIs deprecated for libplacebo v4
- require vulkan 1.3 headers at compile time
- require vulkan 1.2 as a minimum runtime version
- require a minimum version of GLSL 130 (GL/ES 3.0+)
- require a mininum version of meson 0.63 to build
- `pl_dispatch_info.shader` has been changed from `pl_shader_res` to
  `pl_shader_info`, which may require updating some code (the fields
  should be mostly backwards compatible)
- complete refactor of `pl_color_map_params` gamut mapping settings
- reduce default tone-mapping LUT size from 1024 to 256
- deprecate `pl_vulkan.queues`
- add `pl_vulkan_params.extra_queues` to enable more queue types
- users are no longer required to use extension-specific vulkan feature
  structs, and may freely mix and match them with vulkan 1.x
  meta-structs - additionally, both types of structs are reported in
  `pl_vulkan.features`
- `pl_vulkan_wrap_params.aspect` can now be left as 0 when not mapping
  individual planes of planar images
- also enable subgroup clustered and quad operations in shaders
- change type of `pl_vulkan.(un)lock_queue` to uint32_t, to match Vulkan
  API and libavutil vulkan hwcontext
- enable peak detection (sans histogram) by default in
  `pl_render_default_params`

Fixes and performance enhancements:
- drop various backwards compatibility paths for GLSL 110
- fix clipping artefacts when using textureless linear tone-mapping
- fix source black point determination when using ICC profiles
- vastly improve CPU overhead of shader (re-)generation on release
  builds, at the cost of less friendly variable names
- significantly improve CPU overhead of pl_shader-related internal
  temporary allocations and various other related operations
- fix HDR passthrough minimum luma value being ignored
- minor fixes and performance improvements on internal allocator
- fix various possible sources of minor memory leaks
- various fixes and improvements to the meson build scripts
- work-around nvidia-specific swapchain resizing bug, at the cost of
  performance when resizing the window
- fix frame queue FPS estimation for non-monotonic PTS
- fix negative inputs edge case in pl_hdr_rescale
- clamp detected HDR peak to legal PQ range
- avoid unnecessary tone-mapping LUT regeneration on static content
- minor optimizations to the fast bicubic shader
- minor theoretical overhead reduction by forcing LOD level
- fix pl_map_avframe_ex data buffer handling
- various improvements and bug fixes to the `plplay` demo program
- correctly handle v4 perceptual ICC profiles
- fix memory leak of vulkan queue locks
- fix theoretical UB in vulkan memory barrier ordering semantics
- relax unnecessarily strict / redundant host memory barriers
- improve debug logging to understand where VRAM is being allocated
- reduce fragmentation of large VRAM allocations (>= 64 MB)
- fix edge case where DRM format modifier was incorrectly checked on
  export
- correctly find vulkan SDK headers via VULKAN_SDK env var
- correctly init d3d11 monitored fences
- various fixes to d3d11 error reporting and logging
- fix extension loading on pl_vulkan_import
- various fixes to d3d11 register allocation
- fix edge case when encountering incomplete interlaced streams
- fix pl_queue_update with explicitly provided "extreme" vsync ratios
- properly hold last interpolated frame for an extra 1/fps duration
- fix off-by-one in interpolation EOF semantics
- fix discontinuity in black point handling of st2094-40
- fix possible double-acquire in pl_renderer frame acquisition logic, as
  well as a possible use-after-unacquire
- correctly handle mistagged YCbCr AVFrames (e.g. tagged as RGB)
- fix incorrect clamping in pl_render_image(..., NULL) path
- fix crash when effectively rendering to blank/empty target crop
- fix alpha blending output
- significantly speed up mathematical opeations on mingw builds
- fix ICC profile gamma estimation for very strange synthetic test
  profiles
- fix excessive saturation when using black point compensation,
  inverse tone mapping, or tone mapping very bright videos
- fix edge case where pl_frame_queue returned frames too early
- various fixes to `pl_color_space_nominal_luma_ex`
- fix issue when using peak detection on older GPUs
- substantially improve performance of peak detection shader, especially
  when measuring a frame histogram
- correctly hook PL_HOOK_SCALED even when using free/bilinear sampling
- peak detection is now performed after downscaling, when viewing
  high-res HDR content on a low-res monitor/window

v6.291.0-rc2

This release focuses on a major overhaul of gamut mapping, including an
all-new perceptual colorspace (IPTPQc4) and related set of 3DLUT
generation primitives. The new default gamut mapping has been replaced
by a perceptual soft-clip operation which attempts mapping primaries
onto primaries while preserving a balance of both intensity and
chromaticity. The old bespoke tone mapping modes have been replaced by a
single colorimetric (IPTPQc4) tone mapping scheme. Lastly, a new HDR
contrast recovery option helps preserve detail in very bright
tone-mapped regions.

In addition, this release focuses on major performance improvements to
the shader generation system, considerably reducing CPU overhead in
release builds.

Finally, full support has been added for libavutil Vulkan hwcontexts,
allowing libplacebo to work directly with Vulkan Video decoding without
any memory copy overhead.

Additions:
- add `pl_shader_info`
- add `pl_ipt_lms2rgb/rgb2lms and pl_ipt_lms2ipt/ipt2lms`
- add <libplacebo/gamut_mapping.h>
- add `pl_color_map_params.visualize_hue/theta` to visualize gamut 3DLUT
- add `pl_vulkan_required_features`
- add `pl_get_mapped_avframe` to retrieve AVFrame from mapped pl_frame
- add `linear` frame mixer to pl_frame_mixers
- add `pl_render_params.corner_rounding`
- add `pl_matrix2x2_scale/invert` and `pl_transform2x2_scale/invert`
- add `pl_shader_distort` and `pl_render_params.distort_params` to
  enable arbitrary affine distortions (e.g. arbitrary rotation, shear,
  flip/scale) as a final output post-processing step
- add PL_HOOK_PRE_OUTPUT
- add `pl_shader_color_map_ex` and `pl_color_map_args` as a more
  flexible API variant of `pl_shader_color_map`
- add `pl_color_map_parms.contrast_recovery/smoothness` settings, plus
  `pl_color_map_args.feature_map` and `pl_shader_extract_features`
- add `pl_transform2x2_bounds` to compute bounding box of transform
- add `PL_COLOR_HDR_BLACK`, `PL_COLOR_SDR_CONTRAST` and
  `PL_COLOR_HLG_PEAK` to replace previously-hardcoded magic constants

Changes:
- drop public APIs deprecated for libplacebo v4
- require vulkan 1.3 headers at compile time
- require vulkan 1.2 as a minimum runtime version
- require a minimum version of GLSL 130 (GL/ES 3.0+)
- require a mininum version of meson 0.63 to build
- `pl_dispatch_info.shader` has been changed from `pl_shader_res` to
  `pl_shader_info`, which may require updating some code (the fields
  should be mostly backwards compatible)
- complete refactor of `pl_color_map_params` gamut mapping settings
- reduce default tone-mapping LUT size from 1024 to 256
- deprecate `pl_vulkan.queues`
- add `pl_vulkan_params.extra_queues` to enable more queue types
- users are no longer required to use extension-specific vulkan feature
  structs, and may freely mix and match them with vulkan 1.x
  meta-structs - additionally, both types of structs are reported in
  `pl_vulkan.features`
- `pl_vulkan_wrap_params.aspect` can now be left as 0 when not mapping
  individual planes of planar images
- also enable subgroup clustered and quad operations in shaders
- change type of `pl_vulkan.(un)lock_queue` to uint32_t, to match Vulkan
  API and libavutil vulkan hwcontext

Fixes and performance enhancements:
- drop various backwards compatibility paths for GLSL 110
- fix clipping artefacts when using textureless linear tone-mapping
- fix source black point determination when using ICC profiles
- vastly improve CPU overhead of shader (re-)generation on release
  builds, at the cost of less friendly variable names
- significantly improve CPU overhead of pl_shader-related internal
  temporary allocations and various other related operations
- fix HDR passthrough minimum luma value being ignored
- minor fixes and performance improvements on internal allocator
- fix various possible sources of minor memory leaks
- various fixes and improvements to the meson build scripts
- work-around nvidia-specific swapchain resizing bug, at the cost of
  performance when resizing the window
- fix frame queue FPS estimation for non-monotonic PTS
- fix negative inputs edge case in pl_hdr_rescale
- clamp detected HDR peak to legal PQ range
- avoid unnecessary tone-mapping LUT regeneration on static content
- minor optimizations to the fast bicubic shader
- minor theoretical overhead reduction by forcing LOD level
- fix pl_map_avframe_ex data buffer handling
- various improvements and bug fixes to the `plplay` demo program
- correctly handle v4 perceptual ICC profiles
- fix memory leak of vulkan queue locks
- fix theoretical UB in vulkan memory barrier ordering semantics
- relax unnecessarily strict / redundant host memory barriers
- improve debug logging to understand where VRAM is being allocated
- reduce fragmentation of large VRAM allocations (>= 64 MB)
- fix edge case where DRM format modifier was incorrectly checked on
  export
- correctly find vulkan SDK headers via VULKAN_SDK env var
- correctly init d3d11 monitored fences
- various fixes to d3d11 error reporting and logging
- fix extension loading on pl_vulkan_import
- various fixes to d3d11 register allocation
- fix edge case when encountering incomplete interlaced streams
- fix pl_queue_update with explicitly provided "extreme" vsync ratios
- properly hold last interpolated frame for an extra 1/fps duration
- fix off-by-one in interpolation EOF semantics
- fix discontinuity in black point handling of st2094-40
- fix possible double-acquire in pl_renderer frame acquisition logic, as
  well as a possible use-after-unacquire
- correctly handle mistagged YCbCr AVFrames (e.g. tagged as RGB)
- fix incorrect clamping in pl_render_image(..., NULL) path
- fix crash when effectively rendering to blank/empty target crop
- fix alpha blending output
- significantly speed up mathematical opeations on mingw builds
- fix ICC profile gamma estimation for very strange synthetic test
  profiles
- fix excessive saturation when using black point compensation,
  inverse tone mapping, or tone mapping very bright videos
- fix edge case where pl_frame_queue returned frames too early
- various fixes to `pl_color_space_nominal_luma_ex`
- fix issue when using peak detection on older GPUs

v6.287.0-rc1

This release focuses on a major overhaul of gamut mapping, including an
all-new perceptual colorspace (IPTPQc4) and related set of 3DLUT
generation primitives. The new default gamut mapping has been replaced
by a perceptual soft-knee operation which attempts mapping primaries
onto primaries while preserving a balance of both intensity and
chromaticity. The old bespoke tone mapping modes have been replaced by a
single tunable LMS/IPTPQc4 hybrid tone mapping scheme. Lastly, a
new HDR contrast recovery option helps preserve detail in very bright
tone-mapped regions.

In addition, this release focuses on major performance improvements to
the shader generation system, considerably reducing CPU overhead in
release builds.

Finally, full support has been added for libavutil Vulkan hwcontexts,
allowing libplacebo to work directly with Vulkan Video decoding without
any memory copy overhead.

Additions:
- add `pl_shader_info`
- add `pl_ipt_lms2rgb/rgb2lms and pl_ipt_lms2ipt/ipt2lms`
- add <libplacebo/gamut_mapping.h>
- add `pl_color_map_params.visualize_hue/theta` to visualize gamut 3DLUT
- add `pl_vulkan_required_features`
- add `pl_get_mapped_avframe` to retrieve AVFrame from mapped pl_frame
- add `linear` frame mixer to pl_frame_mixers
- add `pl_render_params.corner_rounding`
- add `pl_matrix2x2_scale/invert` and `pl_transform2x2_scale/invert`
- add `pl_shader_distort` and `pl_render_params.distort_params` to
  enable arbitrary affine distortions (e.g. arbitrary rotation, shear,
  flip/scale) as a final output post-processing step
- add PL_HOOK_PRE_OUTPUT
- add `pl_shader_color_map_ex` and `pl_color_map_args` as a more
  flexible API variant of `pl_shader_color_map`
- add `pl_color_map_parms.contrast_recovery/smoothness` settings, plus
  `pl_color_map_args.feature_map` and `pl_shader_extract_features`
- add `pl_transform2x2_bounds` to compute bounding box of transform

Changes:
- drop public APIs deprecated for libplacebo v4
- require vulkan 1.3 headers at compile time
- require vulkan 1.2 as a minimum runtime version
- require a minimum version of GLSL 130 (GL/ES 3.0+)
- require a mininum version of meson 0.63 to build
- `pl_dispatch_info.shader` has been changed from `pl_shader_res` to
  `pl_shader_info`, which may require updating some code (the fields
  should be mostly backwards compatible)
- complete refactor of `pl_color_map_params` gamut mapping settings
- reduce default tone-mapping LUT size from 1024 to 256
- deprecate `pl_vulkan.queues`
- add `pl_vulkan_params.extra_queues` to enable more queue types
- users are no longer required to use extension-specific vulkan feature
  structs, and may freely mix and match them with vulkan 1.x
  meta-structs - additionally, both types of structs are reported in
  `pl_vulkan.features`
- `pl_vulkan_wrap_params.aspect` can now be left as 0 when not mapping
  individual planes of planar images
- also enable subgroup clustered and quad operations in shaders
- change type of `pl_vulkan.(un)lock_queue` to uint32_t, to match Vulkan
  API and libavutil vulkan hwcontext

Fixes and performance enhancements:
- drop various backwards compatibility paths for GLSL 110
- fix clipping artefacts when using textureless linear tone-mapping
- fix source black point determination when using ICC profiles
- vastly improve CPU overhead of shader (re-)generation on release
  builds, at the cost of less friendly variable names
- significantly improve CPU overhead of pl_shader-related internal
  temporary allocations and various other related operations
- fix HDR passthrough minimum luma value being ignored
- minor fixes and performance improvements on internal allocator
- fix various possible sources of minor memory leaks
- various fixes and improvements to the meson build scripts
- work-around nvidia-specific swapchain resizing bug, at the cost of
  performance when resizing the window
- fix frame queue FPS estimation for non-monotonic PTS
- fix negative inputs edge case in pl_hdr_rescale
- clamp detected HDR peak to legal PQ range
- avoid unnecessary tone-mapping LUT regeneration on static content
- minor optimizations to the fast bicubic shader
- minor theoretical overhead reduction by forcing LOD level
- fix pl_map_avframe_ex data buffer handling
- various improvements to the `plplay` demo program
- correctly handle v4 perceptual ICC profiles
- fix memory leak of vulkan queue locks
- fix theoretical UB in vulkan memory barrier ordering semantics
- relax unnecessarily strict / redundant host memory barriers
- improve debug logging to understand where VRAM is being allocated
- reduce fragmentation of large VRAM allocations (>= 64 MB)
- fix edge case where DRM format modifier was incorrectly checked on
  export
- correctly find vulkan SDK headers via VULKAN_SDK env var
- correctly init d3d11 monitored fences
- various fixes to d3d11 error reporting and logging
- fix extension loading on pl_vulkan_import
- various fixes to d3d11 register allocation
- fix edge case when encountering incomplete interlaced streams
- fix pl_queue_update with explicitly provided "extreme" vsync ratios
- properly hold last interpolated frame for an extra 1/fps duration
- fix off-by-one in interpolation EOF semantics
- fix discontinuity in black point handling of st2094-40
- fix possible double-acquire in pl_renderer frame acquisition logic, as
  well as a possible use-after-unacquire
- correctly handle mistagged YCbCr AVFrames (e.g. tagged as RGB)
- fix incorrect clamping in pl_render_image(..., NULL) path
- fix crash when effectively rendering to blank/empty target crop
- fix alpha blending output
- significantly speed up mathematical opeations on mingw builds
- fix ICC profile gamma estimation for very strange synthetic test
  profiles
- fix excessive saturation when using black point compensation or
  inverse tone mapping

v5.264.1

This bugfix release fixes a major regression in the v5.264.0
tone-mapping redesign which resulted in garbage pixels (and unnecessary
tone-mapping) when using an ICC output profile, as well as other minor
miscellaneous fixes.

Fixes:
- fix linear tone mapping resulting in garbage pixels appearing in and
  around black and near-black regions
- fix ICC profiles incorrectly resulting in tone-mapping being enabled
- fix minimum meson version being incorrectly set
- fix HDR10 static metadata minimum brightness not being sent when using
  HDR passthrough
- fix left-over debug junk that could possibly cause a shader
  miscompilation on older GLSL
- fix a possible memleak in pl_renderer
- fix several hypothetical sources of UB inside internal code
- various minor fixes to misleading or missing log messages

v5.264.0

This release focuses on a major overhaul of HDR tone-mapping, including
support for HDR10+ and PQ CIE Y dynamic metadata (including ST2094-40
OOTF), an entirely rewritten peak detection shader (using a frame
histogram), a reimagined new default 'spline' tone-mapping function, and
two new debug overlays to visualize the tone-mapping LUT and clipped
pixels.

In addition, this release offers proper native support for DCI Digital
Cinema Distribution Master (XYZ) decoding, integration with libdovi for
Dolby Vision RPU parsing, native support for planar (YCbCr) vulkan
texture formats, and a major overhaul of the vulkan command scheduling
and synchronization code.

Additions:
- add PL_COLOR_PRIM_ACES_AP0 and PL_COLOR_PRIM_ACES_AP1
- add pl_tone_map_params_infer
- add pl_plane_data_from_comps (not restricted to 64-bit formats)
- add pl_hook.parameters and the ability to use //!PARAM directives
  inside mpv-style shaders
- add pl_gpu_limits.host_cached to test for host-cached host-mapped
  buffer support
- add pl_vukan.get_proc_addr
- add pl_vulkan_sem_create/destroy, to create (exportable) vulkan
  semaphores for use with the vulkan image interop API
- add pl_vulkan_hold_ex and pl_vulkan_release_ex
- add pl_vulkan_wrap_params.aspect to wrap individual planes of planar
  images
- add support for packed 16-bit formats (rx10, rxgx10 etc.)
- add support for planar textures (pl_fmt.planes and pl_tex.planes), and
  introduce planar texture formats (g8_br8_420, gx10_bx10_rx10_444 etc)
- add support for 3-component formats (rgb8, rgb16 etc) to d3d11
- add PL_COLOR_TRC_ST428 (DCI digital cinema XYZ transfer function)
- add pl_plane_data.swapped to support uploading non-native endian data
- add pl_hdr_metadata.scene_max/avg and pl_hdr_metadata.ootf for HDR10+
  dynamic metadata
- add pl_map_hdr_metadata and pl_frame_map_avdovi_metadata
- add pl_tone_map_params.hdr
- add pl_tone_map_st2094_10 and pl_tone_map_st2094_40
- add pl_color_map_params.visualize_lut and visualize_rect
- add pl_hook.signature to help identify hooks (for error tracking)
- add pl_renderer_get_errors and pl_renderer_reset_errors to query the
  renderer for internal errors
- add <libplacebo/utils/dolbyvision.h> for parsing DV RPUs (based on
  libdovi)
- add a compile-time option to disable dolbyvision support
- add support for sampling from integer textures on d3d11
- add pl_color_space_nominal_peak_ex
- add pl_get_detected_hdr_metadata
- add pl_hdr_metadata.max_pq_y and avg_pq_y
- add pl_tone_map_params.input_avg
- add pl_hdr_metadata_type and pl_hdr_metadata_contains, as well as
  pl_color_map_params.metadata, to influence the choice of HDR metadata
- add pl_peak_detect_params.percentile
- add pl_color_map_params.show_clipping

Changes:
- deprecate pl_sync and pl_tex_export (in favor of pl_vulkan_sem_create
  and pl_vulkan_hold_ex)
- deprecate pl_vulkan_hold, pl_vulkan_hold_raw and pl_vulkan_release (in
  favor of their _ex counterparts)
- improve tone-mapping default function/mode heuristics
- remove pl_swapchain.impl from public-facing struct
- pl_tone_map_spline has been substantially rewritten and replaced by a
  similar but different algorithm, with a new tunable parameter
  (influencing the desired subjective contrast level)
- pl_color_map_params.lut_size now only affects a 1D LUT, rather than a
  2D LUT, and the default has been increased from 256 to 1024
- move pl_renderer_params.allow_delayed_peak_detect to
  pl_peak_detect_params.allow_delayed
- deprecate pl_get_detected_peak, replaced by
  pl_get_detected_hdr_metadata
- deprecate/remove pl_peak_detect_params.overshoot_margin
- move pl_hdr_rescale from <libplacebo/tone_mapping.h> to
  <libplacebo/colorspace.h>

Fixes and performance enhancements:
- correctly accept even very wide ICC profiles
- fix dynamic LUT generation suddenly switching between different tone
  mapping functions when using `pl_tone_map_auto`
- correctly report buffer size limits in pl_vulkan.gpu->limits
- fix an issue where zooming into a fullscreen image did not correctly
  invalidate the frame cache
- fix building with recent versions of glslang
- fix unintentional sub-pixel distortions when cropping
- fix sampling from GL_OES_EGL_image_external targets on GL ES 3.x
- fix UB when using VK_EXT_full_screen_exclusive
- fix choice of default SDR curves when targetting PL_COLOR_TRC_UNKNOWN
- infer correct color gamut / primaries when using PL_COLOR_SYSTEM_XYZ
- fix corner case when combinig linear input with non-linear scaling
- fix compute shader blit fallback rounding
- optimize blitting from 1 pixel sources
- fix UB when drawing from image formats where alpha was the first
  component
- fix pl_vulkan_wrap incorrectly rejecting 1D/3D textures
- fix pl_vulkan_wrap ignoring renderable/host_readable caps
- fix GLSL codegen for non-float samplerBuffer
- adjust precision of whitepoints to match common practice
- fix d3d11 texel buffer initialization
- fix frequent shader recompilation in pl_shader_dovi_reshape
- correctly decode white point of DCI XYZ content
- fix issue where OpenGL shaders with multiple buffer block bindings
  (UBOs/SSBOs) were not correctly initialized on older GLSL
- various fixes and improvements to the vulkan memory selection logic
- fix memory leak on d3d11
- fix possible crash on older OpenGL drivers
- fix texture blit fallback shader on older GLSL
- avoid implementation-defined behavior when using SSBOs on older GLSL
- fix memory leak when pl_mpv_user_shader_parse fails
- fix memory leak when using deinterlaced frames in pl_queue
- fix thread-unsafe array usage in pl_pass_create on vulkan
- fix issue where BT.2446 was unintentionally picked for HDR->HDR
  inverse tone mapping
- fix double mutex unlock in vulkan memory allocator
- fix <libplacebo/shaders/deinterlacing.h> and <libplacebo/d3d11.h> headers
- fix missing host read/write dependencies vulkan buffers
- fix build on newer vulkan headers
- fix various build issues on 32-bit platforms
- fix issue when shader LUTs fail being created
- fix possible UB in AV1 film grain shader
- substantially rewrite vulkan command/object synchronization to take
  full advantage of timeline semaphores, drastically reducing the number
  of semaphores and synchronization primitives that were emitted
- properly clean up after old/unused shader cache entries
- fix timing of vulkan uninit debug messages
- correctly prefer mingw vulkan headers over system-wide vulkan headers
  when building inside mingw
- improve performance of string concatenation operations when
  constructing shaders
- fix vulkan swapchain recreation when swapchain size is unchanged
- fix unnecessary/redundant tone-mapping when drawing overlays
- fix discontinuity when using PL_TONE_MAP_AUTO and the source peak
  falls below the target peak
- fix overly aggressive saturation when using PL_TONE_MAP_LUMA for small
  range conversions
- various fixes for using libplacebo from C++
- always go through full tone-mapping LUT even when performing only
  black-point-compensation
- performance improvement (LUT bypass) for pl_tone_map_linear
- improve debugging of vulkan leak detection and out-of-memory errors
- fix possible segfault when vulkan/d3d11 context creation fails
- avoid deprecated features when compiling SPIR-V for newer vulkan
- fix various issues caused by a poor choice of color mixing space when
  using pl_render_image_mix and HDR sources/displays
- correctly invalidate frame cache when rendering single frames with
  updated parameters/dimensions
- correctly reset peak detection state when params change
- fix unintentional RGB hard-clip before luma-based tone-mapping
- correctly enable vulkan validation features extension when using
  pl_vk_inst_params.debug_extra
- emit correct texture barrier when pl_pass_params.load_target is true
- various fixes and improvements to the test framework
- various fixes and improvements to demos/plplay

v5.264.0-rc1

This release focuses on a major overhaul of HDR tone-mapping, including
support for HDR10+ and PQ CIE Y dynamic metadata (including ST2094-40
OOTF), an entirely rewritten peak detection shader (using a frame
histogram), a reimagined new default 'spline' tone-mapping function, and
two new debug overlays to visualize the tone-mapping LUT and clipped
pixels.

In addition, this release offers proper native support for DCI Digital
Cinema Distribution Master (XYZ) decoding, integration with libdovi for
Dolby Vision RPU parsing, native support for planar (YCbCr) vulkan
texture formats, and a major overhaul of the vulkan command scheduling
and synchronization code.

Additions:
- add PL_COLOR_PRIM_ACES_AP0 and PL_COLOR_PRIM_ACES_AP1
- add pl_tone_map_params_infer
- add pl_plane_data_from_comps (not restricted to 64-bit formats)
- add pl_hook.parameters and the ability to use //!PARAM directives
  inside mpv-style shaders
- add pl_gpu_limits.host_cached to test for host-cached host-mapped
  buffer support
- add pl_vukan.get_proc_addr
- add pl_vulkan_sem_create/destroy, to create (exportable) vulkan
  semaphores for use with the vulkan image interop API
- add pl_vulkan_hold_ex and pl_vulkan_release_ex
- add pl_vulkan_wrap_params.aspect to wrap individual planes of planar
  images
- add support for packed 16-bit formats (rx10, rxgx10 etc.)
- add support for planar textures (pl_fmt.planes and pl_tex.planes), and
  introduce planar texture formats (g8_br8_420, gx10_bx10_rx10_444 etc)
- add support for 3-component formats (rgb8, rgb16 etc) to d3d11
- add PL_COLOR_TRC_ST428 (DCI digital cinema XYZ transfer function)
- add pl_plane_data.swapped to support uploading non-native endian data
- add pl_hdr_metadata.scene_max/avg and pl_hdr_metadata.ootf for HDR10+
  dynamic metadata
- add pl_map_hdr_metadata and pl_frame_map_avdovi_metadata
- add pl_tone_map_params.hdr
- add pl_tone_map_st2094_10 and pl_tone_map_st2094_40
- add pl_color_map_params.visualize_lut and visualize_rect
- add pl_hook.signature to help identify hooks (for error tracking)
- add pl_renderer_get_errors and pl_renderer_reset_errors to query the
  renderer for internal errors
- add <libplacebo/utils/dolbyvision.h> for parsing DV RPUs (based on
  libdovi)
- add support for sampling from integer textures on d3d11
- add pl_color_space_nominal_peak_ex
- add pl_get_detected_hdr_metadata
- add pl_hdr_metadata.max_pq_y and avg_pq_y
- add pl_tone_map_params.input_avg
- add pl_hdr_metadata_type and pl_hdr_metadata_contains, as well as
  pl_color_map_params.metadata, to influence the choice of HDR metadata
- add pl_peak_detect_params.percentile
- add pl_color_map_params.show_clipping

Changes:
- deprecate pl_sync and pl_tex_export (in favor of pl_vulkan_sem_create
  and pl_vulkan_hold_ex)
- deprecate pl_vulkan_hold, pl_vulkan_hold_raw and pl_vulkan_release (in
  favor of their _ex counterparts)
- improve tone-mapping default function/mode heuristics
- remove pl_swapchain.impl from public-facing struct
- pl_tone_map_spline has been substantially rewritten and replaced by a
  similar but different algorithm, with a new tunable parameter
  (influencing the desired subjective contrast level)
- pl_color_map_params.lut_size now only affects a 1D LUT, rather than a
  2D LUT, and the default has been increased from 256 to 1024
- move pl_renderer_params.allow_delayed_peak_detect to
  pl_peak_detect_params.allow_delayed
- deprecate pl_get_detected_peak, replaced by
  pl_get_detected_hdr_metadata
- deprecate/remove pl_peak_detect_params.overshoot_margin
- move pl_hdr_rescale from <libplacebo/tone_mapping.h> to
  <libplacebo/colorspace.h>

Fixes and performance enhancements:
- correctly accept even very wide ICC profiles
- fix dynamic LUT generation suddenly switching between different tone
  mapping functions when using `pl_tone_map_auto`
- correctly report buffer size limits in pl_vulkan.gpu->limits
- fix an issue where zooming into a fullscreen image did not correctly
  invalidate the frame cache
- fix building with recent versions of glslang
- fix unintentional sub-pixel distortions when cropping
- fix sampling from GL_OES_EGL_image_external targets on GL ES 3.x
- fix UB when using VK_EXT_full_screen_exclusive
- fix choice of default SDR curves when targetting PL_COLOR_TRC_UNKNOWN
- infer correct color gamut / primaries when using PL_COLOR_SYSTEM_XYZ
- fix corner case when combinig linear input with non-linear scaling
- fix compute shader blit fallback rounding
- optimize blitting from 1 pixel sources
- fix UB when drawing from image formats where alpha was the first
  component
- fix pl_vulkan_wrap incorrectly rejecting 1D/3D textures
- fix pl_vulkan_wrap ignoring renderable/host_readable caps
- fix GLSL codegen for non-float samplerBuffer
- adjust precision of whitepoints to match common practice
- fix d3d11 texel buffer initialization
- fix frequent shader recompilation in pl_shader_dovi_reshape
- correctly decode white point of DCI XYZ content
- fix issue where OpenGL shaders with multiple buffer block bindings
  (UBOs/SSBOs) were not correctly initialized on older GLSL
- various fixes and improvements to the vulkan memory selection logic
- fix memory leak on d3d11
- fix possible crash on older OpenGL drivers
- fix texture blit fallback shader on older GLSL
- avoid implementation-defined behavior when using SSBOs on older GLSL
- fix memory leak when pl_mpv_user_shader_parse fails
- fix memory leak when using deinterlaced frames in pl_queue
- fix thread-unsafe array usage in pl_pass_create on vulkan
- fix issue where BT.2446 was unintentionally picked for HDR->HDR
  inverse tone mapping
- fix double mutex unlock in vulkan memory allocator
- fix <libplacebo/shaders/deinterlacing.h> and <libplacebo/d3d11.h> headers
- fix missing host read/write dependencies vulkan buffers
- fix build on newer vulkan headers
- fix various build issues on 32-bit platforms
- fix issue when shader LUTs fail being created
- fix possible UB in AV1 film grain shader
- substantially rewrite vulkan command/object synchronization to take
  full advantage of timeline semaphores, drastically reducing the number
  of semaphores and synchronization primitives that were emitted
- properly clean up after old/unused shader cache entries
- fix timing of vulkan uninit debug messages
- correctly prefer mingw vulkan headers over system-wide vulkan headers
  when building inside mingw
- improve performance of string concatenation operations when
  constructing shaders
- fix vulkan swapchain recreation when swapchain size is unchanged
- fix unnecessary/redundant tone-mapping when drawing overlays
- fix discontinuity when using PL_TONE_MAP_AUTO and the source peak
  falls below the target peak
- fix overly aggressive saturation when using PL_TONE_MAP_LUMA for small
  range conversions
- various fixes for using libplacebo from C++
- always go through full tone-mapping LUT even when performing only
  black-point-compensation
- performance improvement (LUT bypass) for pl_tone_map_linear
- improve debugging of vulkan leak detection and out-of-memory errors
- fix possible segfault when vulkan/d3d11 context creation fails
- avoid deprecated features when compiling SPIR-V for newer vulkan
- fix various issues caused by a poor choice of color mixing space when
  using pl_render_image_mix and HDR sources/displays
- correctly invalidate frame cache when rendering single frames with
  updated parameters/dimensions
- correctly reset peak detection state when params change
- fix unintentional RGB hard-clip before luma-based tone-mapping
- correctly enable vulkan validation features extension when using
  pl_vk_inst_params.debug_extra
- emit correct texture barrier when pl_pass_params.load_target is true
- various fixes and improvements to the test framework
- various fixes and improvements to demos/plplay

v5.229.2

This bugfix release fixes a number of minor issues that have come up
since v5.229.1:

Fixes and performance enhancements:
- allow `plplay` to support hardware decoding with EGL
- fix an issue where custom shaders with `//!SAVE MAIN` did not save
  textures
- fix a number of minor memory leaks
- fix an issue where custom shaders that tried binding conditionally
  excluded textures generated superfluous errors
- fix an issue where the libav helpers ran into undefined behavior when
  operating on the 128-bit image formats in recent versions of ffmpeg
- fix a build issue on BSD platforms without libdl
- fix an issue where freeing `pl_shader_obj` too early could lead to
  use-after-free errors if shaders still referenced these objects
- fix an issue where applying film grain after debanding could trigger
  an assertion due to a change in bit depth
- fix an issue where film grain generation was unnecessarily verbose due
  to LUT updates
- fix an issue where tone mapping desaturation was not working as
  intended, resulting in strongly oversaturated colors
- fix an issue where the red channel sometimes got unintentionally
  deleted from RGB input images
- fix an issue where AV1 film grain synthesis did not work on pictures
  above 12 bit depth, such as could be the output of a previous filter
- remove an unnecessary assertion that caused build issues on some
  versions of clang
- fix an issue where we unintentionally used linear downscaling on HDR
  sources
- fix an issue with false negatives in the PL_GAMUT_WARN algorithm, and
  also change the algorithm to make it more visually obvious
- fix an issue where OpenGL on WSL2 was unintentionally rejected as a
  software rasterizer

v5.229.1

This minor release fixes a crucial bug in v5.229.0, which caused a
regression when using orthogonal scaler kernels on anything but simple
scaling ratios, as well as other minor fixes.

Fixes and performance enhancements:
- fix an issue where the pl_shader_sample_ortho refactor broke
  orthogonal scalers inside pl_renderer, for anything but very simply
  scaling ratios
- fix an issue where pl_shader_sample_ortho2 rejected some scaling
  ratios due to floating point inaccuracy
- fix an issue where some extreme 'test' ICC profiles were unfairly
  rejected by the gamma detection code
- fix an issue where some oddly-crafted ICC profiles could result in
  NaNs propagating into the shader math

v5.229.0

This is a major release, bumping up the major version to v5 and dropping
all APIs deprecated in v3.x. The other major breaking change of this
release is a switch away from the external `libepoxy` and `mako`
dependencies in favor of the (optionally bundled) `glad2` and `jinja2`.
These are now included, along with various other build-time dependencies,
as git submodules. Users are advised to clone with `git clone
--recursive` in order to satisfy these dependencies automatically, while
distros maintainers are nonetheless encouraged to continue packaging
them.

In addition, this release brings with it a number of new features and
changes - including support for fully automatic GPU deinterlacing, error
diffusion dithering, gamma-aware dithering, and a number of improvements
to the handling of HDR sources and output displays, as well as several
notable bug fixes and performance enhancements.

Additions:
- add `pl_gpu_limits.array_size_constants` to indicate whether or not
  push constants can be used to size arrays
- add PL_HANDLE_MTL_TEX, PL_HANDLE_IOSURFACE and `pl_shared_mem.plane`
  to improve interop with MoltenVK
- add the informational fields `pl_opengl.major, `pl_opengl.minor`,
  `pl_opengl_extensions` and the `pl_opengl_has_ext` utility function
- add `pl_opengl_params.get_proc_addr` and `get_proc_addr_ex`
- add `pl_deband_params.grain_neutral`, the effect of which is to scale
  down / disable adding noise near this value
- add <libplacebo/shaders/deinterlacing.h>, containing a basic
  implementation of yadif, bob and weave
- add support for deinterlacing metadata to `pl_render_params`,
  `pl_frame`, and `pl_source_frame`
- add <libplacebo/shaders/dithering.h>, splitting this off from its
  previous location inside <libplacebo/shaders/colorspace.h>
- add `pl_shader_error_diffusion` and related helper functions, as well
  as `pl_render_params.error_diffusion`
- add `pl_dither_params.transfer` to support gamma-aware dithering
- add `pl_icc_params.force_bpc` to help work around black point
  compensation issues on "broken" v4 and v2 profiles

Changes:
- fields and functions deprecated in libplacebo v3 have been removed
- `python3-mako` is now bundled as a submodule to make resolving this
  dependency easier
- drop `libepoxy` as a dependency, and require `glad` v2 instead, the
  latter of which is added as a submodule to make building easier
- drop the `PL_STRUCT` transitional macro, and switch to a consistent
  API where e.g. `pl_tex` is a typedef of `const struct pl_tex_t *`.
- `PL_LUT_CONVERSION` now explicitly overrides ICC profiles as well
- HDR color spaces no longer default to having a black point of 0.005
  nits, instead now defaulting to "true" black (1e-7 nits)
- BT.1886 sources are now automatically tuned to match the swapchain /
  detected target contrast, rather than defaulting to 1000:1
- move `pl_queue_params.frame_duration` to `pl_source_frame.duration`
- the `vulkan-link` and `opengl-loader` boolean meson options have been
  removed in favor of the `vk-proc-addr` and `gl-proc-addr` feature
  flags, defaulting to `auto` instead of `yes`
- a copy of `vulkan.h` and `vk.xml` have been bundled as submodules to
  make satisfying these dependencies easier
- `<libplacebo/opengl.h>`, `<libplacebo/vulkan.h>` and
  `<libplacebo/d3d11.h`> are now installed unconditonally, with stubs
  for `pl_vulkan_create` etc. available even if these features are
  disabled at compile time
- `pl_render_info.index` no longer indicates the number of frames being
  mixed on PL_RENDER_STAGE_BLEND, instead being relegated to the new
  field `pl_render_info.count`
- `pl_shader_sample_ortho` has been reworked in order to fix a design
  flaw in its API, see `pl_shader_sample_ortho2` for its replacement

Fixes and performance enhancements:
- fix a bug where shaders with dynamically sized arrays would fail to
  compile on MoltenVK
- reduce the frequency at which polar compute shaders need to be
  recompiled
- fix compilation issues with MSVC
- fix an issue where vulkan portability extensions were not correctly
  detected
- fix a possible deadlock when using a multi-threaded opengl context
- specify the correct calling convention for EGL debug callbacks
- fix a bug where PL_INTENT_ABSOLUTE_COLORIMETRIC broke ICC profiles
- improve the handling of perceptual ICC profiles, especially on
  "broken" v4 or v2 profiles
- fix undefined behavior on 32-bit vulkan systems
- fix bugs in the vulkan swapchain recreation
- fix an issue where HDR metadata was not correctly reflected back to
  the renderer on vulkan swapchains
- fix a bug where d3d11 swapchains failed being created on older
  versions of windows where high-bit-depth swapchains are unavailable
- fix a bug where HDR metadata sent to the swapchain was not correctly
  inferred to valid values
- `pl_shader_deband` has been rewritten to slightly improve performance,
  especially when the texture has more channels than necessary
- `pl_shader_deband` no longer raises the black point due to clipping
- fix build issues on GCC < 6
- improve validity of partially set `pl_color_space` structs
- fix `pl_find_tone_map_function` not having an implementation
- fix a bug where cubic spline frame mixing did not work in `plplay`
- fix a memory leak in `pl_queue_destroy`
- fix a bug where changing `pl_icc_params.max_luma` or `intent` did not
  correctly invalidate the ICC 3DLUT and renderer cache
- greatly improve the performance and accuracy of 3DLUTs (ICC, .cube)
- fix compilation on newer glslang and make this code forward-compatible
- fix an issue where `pl_shader_dither` raised the apparent brightness
  of the image when dithering to low bit depths
- fix compilation on vulkan systems with `vulkan.h` available but no
  vulkan loader
- fix an issue where DV metadata requiring an EL was partially applied
- fix an issue where PQ HDR sources were incorrectly assumed to have a
  black point scaled to the mastering display, rather than absolute zero
- fix an issue where disabling `async_compute` led to undefined behavior
  on systems with async compute queues available
- fix an issue where debanding was applied *after* user shaders, causing
  massive performance/quality loss in the case of user shaders that
  upscaled the input planes somehow - in exchange for a slight
  performance penalty when rendering a heavily cropped source image with
  debanding enabled
- fix an issue where plane shaders were sometimes not correctly merged
  with the following image combination shader
- fix an issue where inverse tone mapping did not work with
  `pl_tone_map_auto`
- fix a massive performance regression in the non-compute fallback polar
  shader, especially on nvidia and apple systems - in exchange for a
  slight performance penalty on AMD systems
- slightly boost the performance of shader LUTs in some very specific
  circumstances
- fix an issue where nonlinear shader LUTs did not work on GLSL < 130
- fix an issue where libdl was incorrectly required on windows
- fix an issue where fullscreen exclusive mode triggered freezes on
  certain platforms (e.g. AMD+Windows), by disabling fs exclusive mode
- fix an issue where the wrong (GLES) extension was used for EGL image
  imports on desktop GL
- fix a bug where host pointer imports could trigger an assertion
  failure on some platforms (e.g. intel+windows)
- fix build issues on some platforms (windows llvm/mingw, emscripten)

v5.228.0-rc2

This is a major release, bumping up the major version to v5 and dropping
all APIs deprecated in v3.x. The other major breaking change of this
release is a switch away from the external `libepoxy` and `mako`
dependencies in favor of the (optionally bundled) `glad2` and `jinja2`.
These are now included, along with various other build-time dependencies,
as git submodules. Users are advised to clone with `git clone
--recursive` in order to satisfy these dependencies automatically, while
distros maintainers are nonetheless encouraged to continue packaging
them.

In addition, this release brings with it a number of new features and
changes - including support for fully automatic GPU deinterlacing, error
diffusion dithering, gamma-aware dithering, and a number of improvements
to the handling of HDR sources and output displays, as well as several
notable bug fixes and performance enhancements.

Additions:
- add `pl_gpu_limits.array_size_constants` to indicate whether or not
  push constants can be used to size arrays
- add PL_HANDLE_MTL_TEX, PL_HANDLE_IOSURFACE and `pl_shared_mem.plane`
  to improve interop with MoltenVK
- add the informational fields `pl_opengl.major, `pl_opengl.minor`,
  `pl_opengl_extensions` and the `pl_opengl_has_ext` utility function
- add `pl_opengl_params.get_proc_addr` and `get_proc_addr_ex`
- add `pl_deband_params.grain_neutral`, the effect of which is to scale
  down / disable adding noise near this value
- add <libplacebo/shaders/deinterlacing.h>, containing a basic
  implementation of yadif, bob and weave
- add support for deinterlacing metadata to `pl_render_params`,
  `pl_frame`, and `pl_source_frame`
- add <libplacebo/shaders/dithering.h>, splitting this off from its
  previous location inside <libplacebo/shaders/colorspace.h>
- add `pl_shader_error_diffusion` and related helper functions, as well
  as `pl_render_params.error_diffusion`
- add `pl_dither_params.transfer` to support gamma-aware dithering
- add `pl_icc_params.force_bpc` to help work around black point
  compensation issues on "broken" v4 and v2 profiles

Changes:
- fields and functions deprecated in libplacebo v3 have been removed
- `python3-mako` is now bundled as a submodule to make resolving this
  dependency easier
- drop `libepoxy` as a dependency, and require `glad` v2 instead, the
  latter of which is added as a submodule to make building easier
- drop the `PL_STRUCT` transitional macro, and switch to a consistent
  API where e.g. `pl_tex` is a typedef of `const struct pl_tex_t *`.
- `PL_LUT_CONVERSION` now explicitly overrides ICC profiles as well
- HDR color spaces no longer default to having a black point of 0.005
  nits, instead now defaulting to "true" black (1e-7 nits)
- BT.1886 sources are now automatically tuned to match the swapchain /
  detected target contrast, rather than defaulting to 1000:1
- move `pl_queue_params.frame_duration` to `pl_source_frame.duration`
- the `vulkan-link` and `opengl-loader` boolean meson options have been
  removed in favor of the `vk-proc-addr` and `gl-proc-addr` feature
  flags, defaulting to `auto` instead of `yes`
- a copy of `vulkan.h` and `vk.xml` have been bundled as submodules to
  make satisfying these dependencies easier
- `<libplacebo/opengl.h>`, `<libplacebo/vulkan.h>` and
  `<libplacebo/d3d11.h`> are now installed unconditonally, with stubs
  for `pl_vulkan_create` etc. available even if these features are
  disabled at compile time
- `pl_render_info.index` no longer indicates the number of frames being
  mixed on PL_RENDER_STAGE_BLEND, instead being relegated to the new
  field `pl_render_info.count`

Fixes and performance enhancements:
- fix a bug where shaders with dynamically sized arrays would fail to
  compile on MoltenVK
- reduce the frequency at which polar compute shaders need to be
  recompiled
- fix compilation issues with MSVC
- fix an issue where vulkan portability extensions were not correctly
  detected
- fix a possible deadlock when using a multi-threaded opengl context
- specify the correct calling convention for EGL debug callbacks
- fix a bug where PL_INTENT_ABSOLUTE_COLORIMETRIC broke ICC profiles
- improve the handling of perceptual ICC profiles, especially on
  "broken" v4 or v2 profiles
- fix undefined behavior on 32-bit vulkan systems
- fix bugs in the vulkan swapchain recreation
- fix an issue where HDR metadata was not correctly reflected back to
  the renderer on vulkan swapchains
- fix a bug where d3d11 swapchains failed being created on older
  versions of windows where high-bit-depth swapchains are unavailable
- fix a bug where HDR metadata sent to the swapchain was not correctly
  inferred to valid values
- `pl_shader_deband` has been rewritten to slightly improve performance,
  especially when the texture has more channels than necessary
- `pl_shader_deband` no longer raises the black point due to clipping
- fix build issues on GCC < 6
- improve validity of partially set `pl_color_space` structs
- fix `pl_find_tone_map_function` not having an implementation
- fix a bug where cubic spline frame mixing did not work in `plplay`
- fix a memory leak in `pl_queue_destroy`
- fix a bug where changing `pl_icc_params.max_luma` or `intent` did not
  correctly invalidate the ICC 3DLUT and renderer cache
- greatly improve the performance and accuracy of 3DLUTs (ICC, .cube)
- fix compilation on newer glslang and make this code forward-compatible
- fix an issue where `pl_shader_dither` raised the apparent brightness
  of the image when dithering to low bit depths
- fix compilation on vulkan systems with `vulkan.h` available but no
  vulkan loader
- fix an issue where DV metadata requiring an EL was partially applied
- fix an issue where PQ HDR sources were incorrectly assumed to have a
  black point scaled to the mastering display, rather than absolute zero
- fix an issue where disabling `async_compute` led to undefined behavior
  on systems with async compute queues available
- fix an issue where debanding was applied *after* user shaders, causing
  massive performance/quality loss in the case of user shaders that
  upscaled the input planes somehow - in exchange for a slight
  performance penalty when rendering a heavily cropped source image with
  debanding enabled
- fix an issue where plane shaders were sometimes not correctly merged
  with the following image combination shader
- fix an issue where inverse tone mapping did not work with
  `pl_tone_map_auto`
- fix a massive performance regression in the non-compute fallback polar
  shader, especially on nvidia and apple systems - in exchange for a
  slight performance penalty on AMD systems
- slightly boost the performance of shader LUTs in some very specific
  circumstances
- fix an issue where nonlinear shader LUTs did not work on GLSL < 130
- fix an issue where libdl was incorrectly required on windows
- fix an issue where fullscreen exclusive mode triggered freezes on
  certain platforms (e.g. AMD+Windows), by disabling fs exclusive mode
- fix an issue where the wrong (GLES) extension was used for EGL image
  imports on desktop GL

v5.228.0-rc1

This is a major release, bumping up the major version to v5 and dropping
all APIs deprecated in v3.x. The other major breaking change of this
release is a switch away from the external `libepoxy` OpenGL dependency
in favor of the (optionally bundled) `glad` version 2. This is now
included, along with various other build-time dependencies, as git
submodules. Users are advised to clone with `git clone --recursive` in
order to satisfy these dependencies automatically, while distros
maintainers are nonetheless encouraged to continue packaging them.

In addition, this release brings with it a number of new features and
changes - including support for fully automatic GPU deinterlacing, error
diffusion dithering, gamma-aware dithering, and a number of improvements
to the handling of HDR sources and output displays, as well as several
notable bug fixes and performance enhancements.

Additions:
- add `pl_gpu_limits.array_size_constants` to indicate whether or not
  push constants can be used to size arrays
- add PL_HANDLE_MTL_TEX, PL_HANDLE_IOSURFACE and `pl_shared_mem.plane`
  to improve interop with MoltenVK
- add the informational fields `pl_opengl.major, `pl_opengl.minor`,
  `pl_opengl_extensions` and the `pl_opengl_has_ext` utility function
- add `pl_opengl_params.get_proc_addr` and `get_proc_addr_ex`
- add `pl_deband_params.grain_neutral`, the effect of which is to scale
  down / disable adding noise near this value
- add <libplacebo/shaders/deinterlacing.h>, containing a basic
  implementation of yadif, bob and weave
- add support for deinterlacing metadata to `pl_render_params`,
  `pl_frame`, and `pl_source_frame`
- add <libplacebo/shaders/dithering.h>, splitting this off from its
  previous location inside <libplacebo/shaders/colorspace.h>
- add `pl_shader_error_diffusion` and related helper functions, as well
  as `pl_render_params.error_diffusion`
- add `pl_dither_params.transfer` to support gamma-aware dithering
- add `pl_icc_params.force_bpc` to help work around black point
  compensation issues on "broken" v4 and v2 profiles

Changes:
- fields and functions deprecated in libplacebo v3 have been removed
- `python3-mako` is now bundled as a submodule to make resolving this
  dependency easier
- drop `libepoxy` as a dependency, and require `glad` v2 instead, the
  latter of which is added as a submodule to make building easier
- drop the `PL_STRUCT` transitional macro, and switch to a consistent
  API where e.g. `pl_tex` is a typedef of `const struct pl_tex_t *`.
- `PL_LUT_CONVERSION` now explicitly overrides ICC profiles as well
- HDR color spaces no longer default to having a black point of 0.005
  nits, instead now defaulting to "true" black (1e-7 nits)
- BT.1886 sources are now automatically tuned to match the swapchain /
  detected target contrast, rather than defaulting to 1000:1
- move `pl_queue_params.frame_duration` to `pl_source_frame.duration`
- the `vulkan-link` and `opengl-loader` boolean meson options have been
  removed in favor of the `vk-proc-addr` and `gl-proc-addr` feature
  flags, defaulting to `auto` instead of `yes`
- a copy of `vulkan.h` and `vk.xml` have been bundled as submodules to
  make satisfying these dependencies easier
- `<libplacebo/opengl.h>`, `<libplacebo/vulkan.h>` and
  `<libplacebo/d3d11.h`> are now installed unconditonally, with stubs
  for `pl_vulkan_create` etc. available even if these features are
  disabled at compile time
- `pl_render_info.index` no longer indicates the number of frames being
  mixed on PL_RENDER_STAGE_BLEND, instead being relegated to the new
  field `pl_render_info.count`

Fixes and performance enhancements:
- fix a bug where shaders with dynamically sized arrays would fail to
  compile on MoltenVK
- reduce the frequency at which polar compute shaders need to be
  recompiled
- fix compilation issues with MSVC
- fix an issue where vulkan portability extensions were not correctly
  detected
- fix a possible deadlock when using a multi-threaded opengl context
- specify the correct calling convention for EGL debug callbacks
- fix a bug where PL_INTENT_ABSOLUTE_COLORIMETRIC broke ICC profiles
- improve the handling of perceptual ICC profiles, especially on
  "broken" v4 or v2 profiles
- fix undefined behavior on 32-bit vulkan systems
- fix bugs in the vulkan swapchain recreation
- fix an issue where HDR metadata was not correctly reflected back to
  the renderer on vulkan swapchains
- fix a bug where d3d11 swapchains failed being created on older
  versions of windows where high-bit-depth swapchains are unavailable
- fix a bug where HDR metadata sent to the swapchain was not correctly
  inferred to valid values
- `pl_shader_deband` has been rewritten to slightly improve performance,
  especially when the texture has more channels than necessary
- `pl_shader_deband` no longer raises the black point due to clipping
- fix build issues on GCC < 6
- improve validity of partially set `pl_color_space` structs
- fix `pl_find_tone_map_function` not having an implementation
- fix a bug where cubic spline frame mixing did not work in `plplay`
- fix a memory leak in `pl_queue_destroy`
- fix a bug where changing `pl_icc_params.max_luma` or `intent` did not
  correctly invalidate the ICC 3DLUT and renderer cache
- greatly improve the performance and accuracy of 3DLUTs (ICC, .cube)
- fix compilation on newer glslang and make this code forward-compatible
- fix an issue where `pl_shader_dither` raised the apparent brightness
  of the image when dithering to low bit depths
- fix compilation on vulkan systems with `vulkan.h` available but no
  vulkan loader
- fix an issue where DV metadata requiring an EL was partially applied
- fix an issue where PQ HDR sources were incorrectly assumed to have a
  black point scaled to the mastering display, rather than absolute zero
- fix an issue where disabling `async_compute` led to undefined behavior
  on systems with async compute queues available
- fix an issue where debanding was applied *after* user shaders, causing
  massive performance/quality loss in the case of user shaders that
  upscaled the input planes somehow - in exchange for a slight
  performance penalty when rendering a heavily cropped source image with
  debanding enabled
- fix an issue where plane shaders were sometimes not correctly merged
  with the following image combination shader
- fix an issue where inverse tone mapping did not work with
  `pl_tone_map_auto`
- fix a massive performance regression in the non-compute fallback polar
  shader, especially on nvidia and apple systems - in exchange for a
  slight performance penalty on AMD systems
- slightly boost the performance of shader LUTs in some very specific
  circumstances
- fix an issue where nonlinear shader LUTs did not work on GLSL < 130

v4.208.0

This major release brings with it a number of fixes and changes for
compatibility with both upstream and downstream projects, native HDR
output on D3D11, and a complete redesign of the way ICC profiles are
handled.

Additions:
- add helper macros linearize() and delinearize(), expanding to the
  definition of the gamma function in use for the video signal
- add various new helper functions relating to colorspaces and
  primaries, see the API change log for a more comprehensive list
- add `pl_render_params.force_low_bit_depth_fbos` for
  debugging/performance tweaking purposes
- add `pl_plane.flipped`, to allow representing individual flipped
  frames in a way that semantically decouples from the presentation rect
  (e.g. for OpenGL framebuffers, or planes with negative stride)
- add '%' and '=' as operators to custom shaders, matching mpv
- add `pl_vulkan.(un)lock_queue` for interop with other libraries
- add `pl_frame.acquire/release` for better interop with hardware
  decoders. These are only called on an as-needed basis immediately
  before and after a frame is actually used for rendering, with only one
  frame being acquired at any given time
- add `pl_film_grain_from_av` helper function
- add support for configuring the swapchain color space on D3D11, using
  the existing pl_swapchain_colorspace_hint mechanism
- add an entirely new ICC profile shader API, allowing ICC profiles to
  be persistently opened (pl_icc_open) and their metadata exposed,
  with explicit `pl_icc_decode` and `pl_icc_encode` operations instead
  of a single monolithic decode+apply step
- add `pl_render_params.plane_up/downscaler`, allowing to override the
  upscaler/downscaler for subsampled chroma planes in particular
- add `pl_filter_function/config.name` for debugging/logging purposes

Changes:
- pl_log_create is no longer an exported symbol, instead becoming
  versioned by the compiled API version. `pl_log_create` is now a macro
  expanding to the name of this versioned function
- `pl_overlay_part` has been refactored, adding the new field `coords`
  to control the coordinate system relative to which the part is placed
  on-screen, as well as being generalized to support floating point
  positions
- deprecate PL_HOOK_PRE_OVERLAY, as a result of overlays no longer being
  applied during the rendering pipeline
- default `pl_color_map_params.gamut_mode` to PL_GAMUT_CLIP, replacing
  PL_GAMUT_DARKEN
- DRM modifiers are now required for vulkan dmabuf interop
- `pl_vulkan.queue_*` are now *always* set to valid queues for that
  operation type, even if it means including duplicates
- `pl_render_image` with NULL image now reports itself as a blend pass
  (blending 0 frames) instead of a frame pass to the info callbacks
- completely refactor/remove the old ICC/3DLUT shader API
  (`pl_icc_update`, `pl_icc_apply` etc.)
- <libplacebo/shaders/icc.h> is now installed unconditionally, with
  `pl_icc_open` simply failing when built without lcms2
- versions of glslang before the new versioning scheme (10.x.x) are no
  longer supported

Fixes and performance enhancements:
- fix pl_tone_map_reinhard.param_min to prevent division by zero
- fix left-over asserts preventing misaligned buffer uploads via
  pl_upload_plane
- fix bug where emulated rgb textures had alpha incorrectly
  preinitialized to 0 instead of 1
- overlays are now always rendered onto the final blended image, solving
  various bugs and unexpected edge cases due to image overlays being
  blended in the middle of the rendering pipeline
- fix a bug where tone-mapping without a state object resulted in broken
  behavior
- allow `pl_shader_sample_polar` to work with external samplers or
  flipped textures without incurring a performance penalty
- fix the behavior of pl_shader_sample_oversample, which was previously
  producing very wrong results
- fix an issue where the dither depth was incorrectly picked in a number
  of edge cases
- fix a number of issues with the H.274 film grain shader
- fix a bug where grayscale images were slightly too green
- fix a bug where `pl_vulkan.queue_transfer` was never set
- fix possible UB in pl_opengl_wrap_tex on some drivers with broken
  texture channel depth queries
- fix issue where some shader LUTs were being regenerated on every
  single frame rather than properly cached
- fix shader compilation error on older GLSL
- fix bug where images were sometimes undesiredly being scaled in linear
  light
- fix SDR<->SDR tone-mapping to properly be a no-op (linear stretch)
- fix use-after-free in pl_get_buffer2's error path
- fix d3d11 build issues on older versions of the SDK
- fix edge case where auto-detected vulkan in the absence of
  glslang/shaderc caused the build to fail
- fix build issues with up-to-date vulkan SDK
- fix issue where non-coherent buffer imports were used in ways not
  adhering to the non-coherent memory atom size
- fix various issues and undefined behavior when flushing mapped
  buffers, especially for non-coherent memory
- avoid some validation warnings about improper pipeline barriers
- fix runtime error with up-to-date MoltenVK
- fix issue where some pl_frame_mix structs resulted no frames being
  mixed, triggering an assertion
- fix bug where overlays were drawn flipped onto flipped planes when
  rendering a NULL image
- fix allocation alignment issues on some platforms (notably win32 i686)
- fix compatibility issues with older macOS
- fix error handling in pl_cond_timedwait
- fix build issues with older vulkan versions
- fix build issue of demos/sdlimage in some configurations
- reduce VRAM consumption of ICC 3DLUTs by 50%

v4.208.0-rc2

This major release brings with it a number of fixes and changes for
compatibility with both upstream and downstream projects, native HDR
output on D3D11, and a complete redesign of the way ICC profiles are
handled.

Additions:
- add helper macros linearize() and delinearize(), expanding to the
  definition of the gamma function in use for the video signal
- add various new helper functions relating to colorspaces and
  primaries, see the API change log for a more comprehensive list
- add `pl_render_params.force_low_bit_depth_fbos` for
  debugging/performance tweaking purposes
- add `pl_plane.flipped`, to allow representing individual flipped
  frames in a way that semantically decouples from the presentation rect
  (e.g. for OpenGL framebuffers, or planes with negative stride)
- add '%' and '=' as operators to custom shaders, matching mpv
- add `pl_vulkan.(un)lock_queue` for interop with other libraries
- add `pl_frame.acquire/release` for better interop with hardware
  decoders. These are only called on an as-needed basis immediately
  before and after a frame is actually used for rendering, with only one
  frame being acquired at any given time
- add `pl_film_grain_from_av` helper function
- add support for configuring the swapchain color space on D3D11, using
  the existing pl_swapchain_colorspace_hint mechanism
- add an entirely new ICC profile shader API, allowing ICC profiles to
  be persistently opened (pl_icc_open) and their metadata exposed,
  with explicit `pl_icc_decode` and `pl_icc_encode` operations instead
  of a single monolithic decode+apply step
- add `pl_render_params.plane_up/downscaler`, allowing to override the
  upscaler/downscaler for subsampled chroma planes in particular
- add `pl_filter_function/config.name` for debugging/logging purposes

Changes:
- pl_log_create is no longer an exported symbol, instead becoming
  versioned by the compiled API version. `pl_log_create` is now a macro
  expanding to the name of this versioned function
- `pl_overlay_part` has been refactored, adding the new field `coords`
  to control the coordinate system relative to which the part is placed
  on-screen, as well as being generalized to support floating point
  positions
- deprecate PL_HOOK_PRE_OVERLAY, as a result of overlays no longer being
  applied during the rendering pipeline
- default `pl_color_map_params.gamut_mode` to PL_GAMUT_CLIP, replacing
  PL_GAMUT_DARKEN
- DRM modifiers are now required for vulkan dmabuf interop
- `pl_vulkan.queue_*` are now *always* set to valid queues for that
  operation type, even if it means including duplicates
- `pl_render_image` with NULL image now reports itself as a blend pass
  (blending 0 frames) instead of a frame pass to the info callbacks
- completely refactor/remove the old ICC/3DLUT shader API
  (`pl_icc_update`, `pl_icc_apply` etc.)
- <libplacebo/shaders/icc.h> is now installed unconditionally, with
  `pl_icc_open` simply failing when built without lcms2
- versions of glslang before the new versioning scheme (10.x.x) are no
  longer supported

Fixes and performance enhancements:
- fix pl_tone_map_reinhard.param_min to prevent division by zero
- fix left-over asserts preventing misaligned buffer uploads via
  pl_upload_plane
- fix bug where emulated rgb textures had alpha incorrectly
  preinitialized to 0 instead of 1
- overlays are now always rendered onto the final blended image, solving
  various bugs and unexpected edge cases due to image overlays being
  blended in the middle of the rendering pipeline
- fix a bug where tone-mapping without a state object resulted in broken
  behavior
- allow `pl_shader_sample_polar` to work with external samplers or
  flipped textures without incurring a performance penalty
- fix the behavior of pl_shader_sample_oversample, which was previously
  producing very wrong results
- fix an issue where the dither depth was incorrectly picked in a number
  of edge cases
- fix a number of issues with the H.274 film grain shader
- fix a bug where grayscale images were slightly too green
- fix a bug where `pl_vulkan.queue_transfer` was never set
- fix possible UB in pl_opengl_wrap_tex on some drivers with broken
  texture channel depth queries
- fix issue where some shader LUTs were being regenerated on every
  single frame rather than properly cached
- fix shader compilation error on older GLSL
- fix bug where images were sometimes undesiredly being scaled in linear
  light
- fix SDR<->SDR tone-mapping to properly be a no-op (linear stretch)
- fix use-after-free in pl_get_buffer2's error path
- fix d3d11 build issues on older versions of the SDK
- fix edge case where auto-detected vulkan in the absence of
  glslang/shaderc caused the build to fail
- fix build issues with up-to-date vulkan SDK
- fix issue where non-coherent buffer imports were used in ways not
  adhering to the non-coherent memory atom size
- fix various issues and undefined behavior when flushing mapped
  buffers, especially for non-coherent memory
- avoid some validation warnings about improper pipeline barriers
- fix runtime error with up-to-date MoltenVK
- fix issue where some pl_frame_mix structs resulted no frames being
  mixed, triggering an assertion
- fix bug where overlays were drawn flipped onto flipped planes when
  rendering a NULL image
- fix allocation alignment issues on some platforms (notably win32 i686)
- fix compatibility issues with older macOS
- fix error handling in pl_cond_timedwait
- fix build issues with older vulkan versions
- fix build issue of demos/sdlimage in some configurations

v4.208.0-rc1

This major release brings with it a number of fixes and changes for
compatibility with both upstream and downstream projects, native HDR
output on D3D11, and a complete redesign of the way ICC profiles are
handled.

Additions:
- add helper macros linearize() and delinearize(), expanding to the
  definition of the gamma function in use for the video signal
- add various new helper functions relating to colorspaces and
  primaries, see the API change log for a more comprehensive list
- add `pl_render_params.force_low_bit_depth_fbos` for
  debugging/performance tweaking purposes
- add `pl_plane.flipped`, to allow representing individual flipped
  frames in a way that semantically decouples from the presentation rect
  (e.g. for OpenGL framebuffers, or planes with negative stride)
- add '%' and '=' as operators to custom shaders, matching mpv
- add `pl_vulkan.(un)lock_queue` for interop with other libraries
- add `pl_frame.acquire/release` for better interop with hardware
  decoders. These are only called on an as-needed basis immediately
  before and after a frame is actually used for rendering, with only one
  frame being acquired at any given time
- add `pl_film_grain_from_av` helper function
- add support for configuring the swapchain color space on D3D11, using
  the existing pl_swapchain_colorspace_hint mechanism
- add an entirely new ICC profile shader API, allowing ICC profiles to
  be persistently opened (pl_icc_open) and their metadata exposed,
  with explicit `pl_icc_decode` and `pl_icc_encode` operations instead
  of a single monolithic decode+apply step
- add `pl_render_params.plane_up/downscaler`, allowing to override the
  upscaler/downscaler for subsampled chroma planes in particular
- ad `pl_filter_function/config.name` for debugging/logging purposes

Changes:
- pl_log_create is no longer an exported symbol, instead becoming
  versioned by the compiled API version. `pl_log_create` is now a macro
  expanding to the name of this versioned function
- `pl_overlay_part` has been refactored, adding the new field `coords`
  to control the coordinate system relative to which the part is placed
  on-screen, as well as being generalized to support floating point
  positions
- deprecate PL_HOOK_PRE_OVERLAY, as a result of overlays no longer being
  applied during the rendering pipeline
- default `pl_color_map_params.gamut_mode` to PL_GAMUT_CLIP, replacing
  PL_GAMUT_DARKEN
- DRM modifiers are now required for vulkan dmabuf interop
- `pl_vulkan.queue_*` are now *always* set to valid queues for that
  operation type, even if it means including duplicates
- `pl_render_image` with NULL image now reports itself as a blend pass
  (blending 0 frames) instead of a frame pass to the info callbacks
- completely refactor/remove the old ICC/3DLUT shader API
  (`pl_icc_update`, `pl_icc_apply` etc.)
- <libplacebo/shaders/icc.h> is now installed unconditionally, with
  `pl_icc_open` simply failing when built without lcms2

Fixes and performance enhancements:
- fix pl_tone_map_reinhard.param_min to prevent division by zero
- fix left-over asserts preventing misaligned buffer uploads via
  pl_upload_plane
- fix bug where emulated rgb textures had alpha incorrectly
  preinitialized to 0 instead of 1
- overlays are now always rendered onto the final blended image, solving
  various bugs and unexpected edge cases due to image overlays being
  blended in the middle of the rendering pipeline
- fix a bug where tone-mapping without a state object resulted in broken
  behavior
- allow `pl_shader_sample_polar` to work with external samplers or
  flipped textures without incurring a performance penalty
- fix the behavior of pl_shader_sample_oversample, which was previously
  producing very wrong results
- fix an issue where the dither depth was incorrectly picked in a number
  of edge cases
- fix a number of issues with the H.274 film grain shader
- fix a bug where grayscale images were slightly too green
- fix a bug where `pl_vulkan.queue_transfer` was never set
- fix possible UB in pl_opengl_wrap_tex on some drivers with broken
  texture channel depth queries
- fix issue where some shader LUTs were being regenerated on every
  single frame rather than properly cached
- fix shader compilation error on older GLSL
- fix bug where images were sometimes undesiredly being scaled in linear
  light
- fix SDR<->SDR tone-mapping to properly be a no-op (linear stretch)
- fix use-after-free in pl_get_buffer2's error path
- fix d3d11 build issues on older versions of the SDK
- fix edge case where auto-detected vulkan in the absence of
  glslang/shaderc caused the build to fail
- fix build issues with up-to-date vulkan SDK
- fix issue where non-coherent buffer imports were used in ways not
  adhering to the non-coherent memory atom size
- fix various issues and undefined behavior when flushing mapped
  buffers, especially for non-coherent memory
- avoid some validation warnings about improper pipeline barriers
- fix runtime error with up-to-date MoltenVK
- fix issue where some pl_frame_mix structs resulted no frames being
  mixed, triggering an assertion
- fix bug where overlays were drawn flipped onto flipped planes when
  rendering a NULL image

v4.192.1

This is a minor bugfix release, containing some crucial follow-up for
v4.192.0, most notably a fix for a regression in the YCbCr decoding
logic that resulted in slightly green-shifted output on 10/12-bit files.

Fixes and performance enhancements:
- fix a regression causing incorrect YCbCr decoding for 10-bit content
- fix overzealous error detection on OpenGL initialization
- fix build issue caused by the use of 64-bit atomics on some platforms
- fix a regression in renderer functionality caused by an unintended
  restriction of FBO requirements on certain platforms (older d3d11)
- fix an issue where certain d3d11 texture formats were not blittable
- fix debug layer checks on d3d 11.0
- fix context creation on older d3d11 runtimes
- fix an issue where PL_TONE_MAP_HYBRID unintentionally oversaturated
  low brightness scenes
- fix a build issue on certain BSD platforms
- update nuklear to 4.9.5, fixing some build-time warnings
- fix an issue where a change to the d3d11 swapchain code resulted in
  lots of unnecessary log spam
- fix an issue where some d3d11 formats were detected as gatherable, but
  not sampleable

v4.192.0

This is a minor release, designed to synchronize with the release of
FFmpeg 5.0. It focuses mainly on improvements to color space handling -
including support for Dolby Vision Profile 5/8 content, completely
rewritten HDR tone/gamut mapping, and bringing `pl_color_space` more in
line with HDR10 metadata. Libplacebo now generally respects things like
mastering color space metadata, especially for PL_INTENT_SATURATION.
This technology is not yet perfect, and will be iterated upon in future
versions of libplacebo. This release serves mainly to lay the API
groundwork.

Other notable changes include support for H.274 film grain synthesis, as well
as improvements to the AVFrame<->libplacebo interop (in particular, support for
hardware accelerated frames), and various fixes related to alpha transparency.

As usual, also includes a number of bug fixes, performance improvements, and
miscellaneous improvements to the API and debug messages - such as the
inclusion of a brand-new Vulkan memory allocator, and a complete overhaul of
the Vulkan synchronization infrastructure to use timeline semaphores,
again for compatibility with FFmpeg Vulkan contexts.

Additions:
- add support for H.274 film grain synthesis
- add preprocessor macros for all params structs, allowing users to write e.g.
  `pl_render_params(.foo = bar)` to construct a `pl_render_params` pointer
  which implicitly includes any default fields, without the need for explicitly
  reading from pl_render_default_params
- add support for video/display rotation in the renderer
- add `pl_frame_copy_stream_props`
- add support for blending transparency against a checkerboard pattern
- add `pl_fmt.signature`, for render pass compatibility
- add `pl_pass_params.index_fmt` to allow 32-bit index buffers
- add `pl_dispatch_reset_frame`, to allow explicitly advancing the state
  of the PRNG and/or triggering garbage collection
- add the possibility of adding extra debug tags to GPU resources, which
  the default params helper macros set to the current source location
- add `pl_gpu_limits.max_variable_comps`, correctly specifying the upper
  bound on the number of uniform variable floats
- add `pl_vulkan_get`, `pl_opengl_get` and `pl_d3d11_get`
- add `pl_shader_set_alpha`
- add `pl_map_avframe_ex` and `pl_unmap_avframe`, which allow mapping extra
  AVFrame resources, and also support the use of hardware frames such as vaapi,
  dmabuf or vulkan
- add support for Dolby Vision color reshaping, via PL_COLOR_SYSTEM_DOLBYVISION
  and `pl_dovi_metadata` - including automatic mapping from AVFrames
- add <libplacebo/tone_mapping.h>, defining a collection of tone mapping
  primitives, and mechanisms for constructing LUTs, and including new
  functions such as BT.2446a and `spline`, as well as improvements to old
  curves such as `hable` and `linear` to make them more perceptually linear
- add a variety of new tone mapping modes (see `pl_tone_map_mode`), including
  auto-selection based on heuristics of the source characteristics
- add a variety of new gamut mapping modes (see `pl_gamut_mode`)
- add support for `NAME_gather` macros for use in user shaders

Changes:
- replace <libplacebo/shaders/av1.h> by the more general
  <libplacebo/shaders/film_grain.h>
- remove API members deprecated for libplacebo v3
- PL_ALPHA_UNKNOWN tagging on files is now assumed to be PL_ALPHA_INDEPENDENT,
  rather than PL_ALPHA_PREMULTIPLIED, and `pl_shader_decode_color` now also
  outputs independent alpha by default
- the `box` filter was removed entirely, due to a number of issues preventing
  it from being effectively useful in practice
- replace `pl_tex_transfer.stride_w/h` (specified in texels) by
  `row/depth_pitch` (specified in bytes)
- replace `pl_pass_params.target_dummy` by `target_format`, and
  requiring that rendered textures are compatible with this format
- allow calling `pl_queue_update` on NULL
- <libplacebo/vulkan.h> now requires support for the timeline semaphores
  feature, included automatically in Vulkan 1.2 and available via
  VK_KHR_timeline_semaphore in previous versions
- change pl_vulkan_hold/release API: removing VkAccessFlags, and replacing the
  VkSemaphore by pl_vulkan_sem (for timeline semaphore support)
- `pl_queue_push` may now be used to push frames out-of-order
- `pl_render_image_mix` may now be used on single frames, in which case
  libplacebo will still go through the mixer cache, potentially speeding up
  single-frame redraws (see: `pl_render_params.skip_caching_single_frames`)
- remove `pl_vulkan_params.disable_events`
- `pl_shared_mem.size` no longer needs to be set for DMABUFs and D3D11 textures
- remove support for 64-bit integer texture formats, since these are very
  poorly supported on most platforms and also extremely rarely needed
- completely refactor all of the tone mapping settings in `pl_color_map_params`,
  replacing the old `desaturation_*` and `tone_mapping_algo` by the new
  `tone_mapping_mode` and `tone_mapping_function`, and the old `gamut_warning`
  and `gamut_clipping` by the new `gamut_mode`
- completely refactor `pl_color_space`: deprecate the old `sig_peak`,
  `sig_scale` etc. fields in favor of merging `pl_hdr_metadata` into this
  struct, and update the API of several functions that previusly took
  `pl_color_space` struct values, to instead take pointers
- remove `pl_color_light` entirely, instead treating the OOTF as an inseparable
  part of the color transfer function (e.g. HLG)
- delete `pl_swapchain_colors` in favor of `pl_color_space` instead (which
  contains the exact same fields now)

Fixes and performance enhancements:
- improve the quality and performance of GPU random number generation
- fix int/float compilation error on GLES in dither shader
- correctly set minimum integer precision on GLES
- allow pl_recreate_plane to create non-host-readable FBOs
- correct GLSL version requirement for 3D LUT shader
- correctly check for presence of GL_EXT_texture_integer
- correctly check for presence of GL_EXT_texture_norm16 on GLES 3.0
- correctly check for presence of GL_EXT_color_buffer_float
- replace GL_ARB_debug_output by GL_KHR_debug
- fix GLSL shader version for GLES 2.0
- add support for GL_EXt_texture_rg on GLES
- use GL_ARRAY_BUFFER instead of GL_COPY_WRITE_BUFFER (GLES compatibility)
- correctly check for GL_UNPACK_IMAGE_HEIGHT presence
- disable host readback on too-old GLES
- add support for the `bgra8` image format on gl/gles and `bgrx8` on d3d11
- remove deprecated usage of bare pointers for OpenGL index data
- fix vulkan malloc efficiency estimate calculation
- fix a memory leak in the vulkan memory allocator for small (<1K) buffers
- complete rewrite of the vulkan memory allocator to improve throughput,
  reduce code complexity and generally reduce memory waste
- allow using libplacebo as a meson subproject
- fix cyclic header dependency
- fix dithering when the FBO bit depth is higher than the content bit depth
- fix segfault if command buffer allocation fails
- fix various thread safety issues in vulkan command polling
- properly invalidate framebuffers on OpenGL
- properly disable GL_DEPTH_TEST and GL_CULL_FACE when running GL passes
- fix GL_ARB_framebuffer_object check
- fix issue with rendering transparent images on non-transparent swapchains
- try and detect presence of alpha channels on opengl framebuffers
- fix OUTPUT and NATIVE_CROPPED hook expressions for flipped files
- fix EPOXY_HAS_EGL checks
- significance increase performance of ICC 3DLUT generation
- correctly set the C level to C11 during compilation
- properly align allocated memory to `max_align_t` (instead of `intmax_t`)
- fix `pl_cond_timedwait`
- fix bug where `pl_opengl_wrap`+`pl_tex_destroy` accidentally closed FD 0
- fix pl_get_buffer2 implementation
- fix alpha blending of transparent subtitles onto transparent images
- fix issue where frame blending could sometimes crash if the only image
  in the mix was too far away from the vsync
- fix segfault when dispatching compute shader output hook while frame blending
- fix UB when using the same shader with different types of textures on vulkan
- fix possible race condition when writing to the same vulkan resource twice
- fix issue where user shaders were sometimes executed as compute shaders
  despite no //!COMPUTE pragma
- properly align texel buffers on vulkan
- properly propagate HOOKED textures between passes of a shader
- also support importing vulkan features from meta-structs like
  `VkPhysicalDeviceVulkan12Features`
- drop the use of VkEvents entirely, and instead optimize the usage of pipeline
  barriers to always emit the minimum required dependency
- fix vulkan object type enum parsing on recent vulkan versions
- fix invalid output on the first frame after enabling peak detection
- fix linking order of glslang libraries
- fix generated .pc file on windows
- fix imports of dedicated memory with plane offsets into vulkan resources
- fix major performance issue when combining debanding with bilinear scaling
- fix issue where `pl_vulkan_wrap` did not support `pl_tex_params.user_data`
- fix compatibility with MoltenVK by adding VK_KHR_portability_subset
- various compatibility fixes for OpenGL version 2.1
- fix UB in `pl_test_pixfmt`
- fix issue where rendering to partial crops of vulkan textures untentionally
  invalidated the image contents outside of the rendering area
- reduce the rate of false negatives in the renderer mixing cache
- fix strided OpenGL texture uploads
- fix crash in the frame mixer when the image color space changes mid-stream
- fix check for EGL DMA buffer modifiers
- fix division by zero in tone mapping shader
- make `pl_mpv_user_shader_destroy` properly reset the passed pointer
- fix undefined behavior passing negative values to `pl_shader_decode_color`
- fix bug where PL_QUEUE_MORE resulted in invalid frame mix outputs
- fix thread race between `pl_queue_push` and reading from a `pl_frame_mix`
- fix `pl_render_high_quality_params`
- fix parsing .cube LUTs with scientific notation floats
- inline LUTs into shader text less aggressively
- disable peak detection in `pl_render_default_params`, instead moving it to
  `pl_render_high_quality_params`
- fix edge case where HDR spaces didn't properly disable linearization
- fix various issues involving the allocation of per-pass identifiers on d3d11
- fix issue where the d3d11 swapchain unnecessarily held on to the framebuffer
- make `pl_swapchain_start/stop_frame` more robust against threading issues or
  API misuse
- fix the application of `pl_color_adjustment.gamma` in `pl_shader_decode_color`
- add support for `pl_pass_params.cached_program` on d3d11

v4.192.0-rc1

This is a minor release that focuses mainly on improvements to color space
handling - including support for Dolby Vision Profile 5/8 content, completely
rewritten HDR tone/gamut mapping, and bringing `pl_color_space` more in line
with HDR10 metadata. Libplaceb now generally respects things like mastering
color space metadata, especially for PL_INTENT_SATURATION. This technology is
not yet perfect, and will be iterated upon in future versions of libplacebo.
This release serves mainly to lay the API groundwork.

Other notable changes include support for H.274 film grain synthesis, as well
as improvements to the AVFrame<->libplacebo interop (in particular, support for
hardware accelerated frames), and various fixes related to alpha transparency.

As usual, also includes a number of bug fixes, performance improvements, and
miscellaneous improvements to the API and debug messages - such as the
inclusion of a brand-new Vulkan memory allocator, and a complete overhaul of
the Vulkan synchronization infrastructure to use timeline semaphores.

Additions:
- add support for H.274 film grain synthesis
- add preprocessor macros for all params structs, allowing users to write e.g.
  `pl_render_params(.foo = bar)` to construct a `pl_render_params` pointer
  which implicitly includes any default fields, without the need for explicitly
  reading from pl_render_default_params
- add support for video/display rotation in the renderer
- add `pl_frame_copy_stream_props`
- add support for blending transparency against a checkerboard pattern
- add `pl_fmt.signature`, for render pass compatibility
- add `pl_pass_params.index_fmt` to allow 32-bit index buffers
- add `pl_dispatch_reset_frame`, to allow explicitly advancing the state
  of the PRNG and/or triggering garbage collection
- add the possibility of adding extra debug tags to GPU resources, which
  the default params helper macros set to the current source location
- add `pl_gpu_limits.max_variable_comps`, correctly specifying the upper
  bound on the number of uniform variable floats
- add `pl_vulkan_get`, `pl_opengl_get` and `pl_d3d11_get`
- add `pl_shader_set_alpha`
- add `pl_map_avframe_ex` and `pl_unmap_avframe`, which allow mapping extra
  AVFrame resources, and also support the use of hardware frames such as vaapi,
  dmabuf or vulkan
- add support for Dolby Vision color reshaping, via PL_COLOR_SYSTEM_DOLBYVISION
  and `pl_dovi_metadata` - including automatic mapping from AVFrames
- add <libplacebo/tone_mapping.h>, defining a collection of tone mapping
  primitives, and mechanisms for constructing LUTs, and including new
  functions such as BT.2446a and `spline`, as well as improvements to old
  curves such as `hable` and `linear` to make them more perceptually linear
- add a variety of new tone mapping modes (see `pl_tone_map_mode`), including
  auto-selection based on heuristics of the source characteristics
- add a variety of new gamut mapping modes (see `pl_gamut_mode`)
- add support for `NAME_gather` macros for use in user shaders

Changes:
- replace <libplacebo/shaders/av1.h> by the more general
  <libplacebo/shaders/film_grain.h>
- remove API members deprecated for libplacebo v3
- PL_ALPHA_UNKNOWN tagging on files is now assumed to be PL_ALPHA_INDEPENDENT,
  rather than PL_ALPHA_PREMULTIPLIED, and `pl_shader_decode_color` now also
  outputs independent alpha by default
- the `box` filter was removed entirely, due to a number of issues preventing
  it from being effectively useful in practice
- replace `pl_tex_transfer.stride_w/h` (specified in texels) by
  `row/depth_pitch` (specified in bytes)
- replace `pl_pass_params.target_dummy` by `target_format`, and
  requiring that rendered textures are compatible with this format
- allow calling `pl_queue_update` on NULL
- <libplacebo/vulkan.h> now requires support for the timeline semaphores
  feature, included automatically in Vulkan 1.2 and available via
  VK_KHR_timeline_semaphore in previous versions
- change pl_vulkan_hold/release API: removing VkAccessFlags, and replacing the
  VkSemaphore by pl_vulkan_sem (for timeline semaphore support)
- `pl_queue_push` may now be used to push frames out-of-order
- `pl_render_image_mix` may now be used on single frames, in which case
  libplacebo will still go through the mixer cache, potentially speeding up
  single-frame redraws (see: `pl_render_params.skip_caching_single_frames`)
- remove `pl_vulkan_params.disable_events`
- `pl_shared_mem.size` no longer needs to be set for DMABUFs and D3D11 textures
- remove support for 64-bit integer texture formats, since these are very
  poorly supported on most platforms and also extremely rarely needed
- completely refactor all of the tone mapping settings in `pl_color_map_params`,
  replacing the old `desaturation_*` and `tone_mapping_algo` by the new
  `tone_mapping_mode` and `tone_mapping_function`, and the old `gamut_warning`
  and `gamut_clipping` by the new `gamut_mode`
- completely refactor `pl_color_space`: deprecate the old `sig_peak`,
  `sig_scale` etc. fields in favor of merging `pl_hdr_metadata` into this
  struct, and update the API of several functions that previusly took
  `pl_color_space` struct values, to instead take pointers
- remove `pl_color_light` entirely, instead treating the OOTF as an inseparable
  part of the color transfer function (e.g. HLG)
- delete `pl_swapchain_colors` in favor of `pl_color_space` instead (which
  contains the exact same fields now)

Fixes and performance enhancements:
- improve the quality and performance of GPU random number generation
- fix int/float compilation error on GLES in dither shader
- correctly set minimum integer precision on GLES
- allow pl_recreate_plane to create non-host-readable FBOs
- correct GLSL version requirement for 3D LUT shader
- correctly check for presence of GL_EXT_texture_integer
- correctly check for presence of GL_EXT_texture_norm16 on GLES 3.0
- correctly check for presence of GL_EXT_color_buffer_float
- replace GL_ARB_debug_output by GL_KHR_debug
- fix GLSL shader version for GLES 2.0
- add support for GL_EXt_texture_rg on GLES
- use GL_ARRAY_BUFFER instead of GL_COPY_WRITE_BUFFER (GLES compatibility)
- correctly check for GL_UNPACK_IMAGE_HEIGHT presence
- disable host readback on too-old GLES
- add support for the `bgra8` image format on gl/gles and `bgrx8` on d3d11
- remove deprecated usage of bare pointers for OpenGL index data
- fix vulkan malloc efficiency estimate calculation
- fix a memory leak in the vulkan memory allocator for small (<1K) buffers
- complete rewrite of the vulkan memory allocator to improve throughput,
  reduce code complexity and generally reduce memory waste
- allow using libplacebo as a meson subproject
- fix cyclic header dependency
- fix dithering when the FBO bit depth is higher than the content bit depth
- fix segfault if command buffer allocation fails
- fix various thread safety issues in vulkan command polling
- properly invalidate framebuffers on OpenGL
- properly disable GL_DEPTH_TEST and GL_CULL_FACE when running GL passes
- fix GL_ARB_framebuffer_object check
- fix issue with rendering transparent images on non-transparent swapchains
- try and detect presence of alpha channels on opengl framebuffers
- fix OUTPUT and NATIVE_CROPPED hook expressions for flipped files
- fix EPOXY_HAS_EGL checks
- significance increase performance of ICC 3DLUT generation
- correctly set the C level to C11 during compilation
- properly align allocated memory to `max_align_t` (instead of `intmax_t`)
- fix `pl_cond_timedwait`
- fix bug where `pl_opengl_wrap`+`pl_tex_destroy` accidentally closed FD 0
- fix pl_get_buffer2 implementation
- fix alpha blending of transparent subtitles onto transparent images
- fix issue where frame blending could sometimes crash if the only image
  in the mix was too far away from the vsync
- fix segfault when dispatching compute shader output hook while frame blending
- fix UB when using the same shader with different types of textures on vulkan
- fix possible race condition when writing to the same vulkan resource twice
- fix issue where user shaders were sometimes executed as compute shaders
  despite no //!COMPUTE pragma
- properly align texel buffers on vulkan
- properly propagate HOOKED textures between passes of a shader
- also support importing vulkan features from meta-structs like
  `VkPhysicalDeviceVulkan12Features`
- drop the use of VkEvents entirely, and instead optimize the usage of pipeline
  barriers to always emit the minimum required dependency
- fix vulkan object type enum parsing on recent vulkan versions
- fix invalid output on the first frame after enabling peak detection
- fix linking order of glslang libraries
- fix generated .pc file on windows
- fix imports of dedicated memory with plane offsets into vulkan resources
- fix major performance issue when combining debanding with bilinear scaling
- fix issue where `pl_vulkan_wrap` did not support `pl_tex_params.user_data`
- fix compatibility with MoltenVK by adding VK_KHR_portability_subset
- various compatibility fixes for OpenGL version 2.1
- fix UB in `pl_test_pixfmt`
- fix issue where rendering to partial crops of vulkan textures untentionally
  invalidated the image contents outside of the rendering area
- reduce the rate of false negatives in the renderer mixing cache
- fix strided OpenGL texture uploads
- fix crash in the frame mixer when the image color space changes mid-stream
- fix check for EGL DMA buffer modifiers
- fix division by zero in tone mapping shader
- make `pl_mpv_user_shader_destroy` properly reset the passed pointer
- fix undefined behavior passing negative values to `pl_shader_decode_color`
- fix bug where PL_QUEUE_MORE resulted in invalid frame mix outputs
- fix thread race between `pl_queue_push` and reading from a `pl_frame_mix`
- fix `pl_render_high_quality_params`
- fix parsing .cube LUTs with scientific notation floats
- inline LUTs into shader text less aggressively
- disable peak detection in `pl_render_default_params`, instead moving it to
  `pl_render_high_quality_params`
- fix edge case where HDR spaces didn't properly disable linearization
- fix various issues involving the allocation of per-pass identifiers on d3d11
- fix issue where the d3d11 swapchain unnecessarily held on to the framebuffer
- make `pl_swapchain_start/stop_frame` more robust against threading issues or
  API misuse
- fix the application of `pl_color_adjustment.gamma` in `pl_shader_decode_color`
- add support for `pl_pass_params.cached_program` on d3d11

v4.157.0

This is a major new release involving a significant overhaul of the
public API, full thread safety, support for Direct3D 11 / Win32 /
MSVC, native HDR output, and more.

The primary way of accessing most libplacebo objects has been revamped.
Rather than writing e.g. `const struct pl_tex *image`, users now simply
write `pl_tex image`. In addition, the `struct pl_context *ctx` was
universally refactored and replaced by `pl_log log`, with no concern
besides logging.

Direct3D 11 is now natively supported by libplacebo, and compiling on
Windows in general has been made more straightforward.

The entire API was revamped to be thread safe by default, even when
using OpenGL (assuming the user provides the appropriate context binding
callbacks). Accompanying this change, the `pl_queue` has been rewritten
with multi-threaded decoding loops in mind. See the accompanying
`plplay` demo for an illustration.

Finally, this release brings with it a lot of features for feature
parity with mpv, such as the ability to get pass stats / timings,
oversample scaling, and more.

Additions:
- add a `void *user_data` field to `pl_frame`, with no further
  interpretation by libplacebo
- add `pl_queue_push_block`, useful for multi-threaded decoding loops
- add a `uint64_t timeout` to `pl_queue_update`, allowing it to
  block until frames are available even when not using a `get_frame`
  callback
- make `pl_queue_update` also return valid data when failing with
  PL_QUEUE_MORE, allowing access to partial/incomplete mix outputs
- allow calling `pl_render_image` on `image == NULL`, to render overlays
  only
- add `pl_get_buffer2`, API-compatible with AVCodecContext.get_buffer2
- add support for blitting from/to several obscure formats such as
  a1rgb5 or 64-bit integer formats
- add `pl_tex_clear_ex` to support clearing integer textures
- add `pl_render_params.ignore_icc_profiles`, for debugging
- add `pl_queue_params.interpolation_threshold`, to allow disabling
  frame mixing when the source FPS approximately matches the display FPS
- always accept DRM_FORMAT_MOD_INVALID for texture imports
- add extra windowing functions to <libplacebo/filters.h>
- add the `pl_fmt.gatherable` capability
- add `pl_shader_sample_oversample`, a variant of nearest-neighbour
  that preserves pixel aspect ratios - good for pixel art
- add `pl_scale_filters` alongside `pl_frame_mixers`
- add support for compile-time specialization constants (`pl_constant`),
  and use them to speed up recompilation of shaders with hard-coded
  constants
- add `pl_render_params.dynamic_constants`, which lifts hard-coded
  constants to dynamic variables - useful for scenarios in which render
  parameters are expected to change very frequently
- add more PL_COLOR_TRC_GAMMAxx definitions
- implement full black point adaptation, even when not using ICC
  profiles, and infer this black-point-adapted BT.1886 instead of gamma
  2.2 as the default gamma curve for SDR files.
- add `pl_shader_res.description` and `pl_shader_res.steps`, containing
  more friendly names for shaders plus a detailed list of operations
  that shader is performing
- add callbacks to `pl_dispatch` and `pl_renderer` for informing users
  of executed passes and their execution times
- add support for the Direct3D 11 graphics API
- add `pl_swapchain_colorspace_hint`, replacing
  `pl_swapchain_hdr_metadata` as the new way to update swapchain
  colorspace metadata at runtime. This can be used to e.g. switch
  between HDR and SDR mode, for supported swapchains
- add `pl_peak_detect_params.minimum_peak`, allowing users to constrain
  the detected peak values to only be sensible (e.g. above 1.0)

Changes:
- simplify the `shaderc` pkg-config check - rather than querying for
  `shaderc_shared.pc`, `shaderc_combined.pc` etc, simply check for
  `shaderc.pc`, matching upstream
- make almost everything thread-safe, and document the parts that
  aren't. In particular, almost all GPU state access is now thread safe,
  freeing up users to access `pl_gpu` instances from multiple threads,
  even when the underlying API is OpenGL
- deprecate `disable_overlay_sampling`, now effectively always true
- `struct pl_overlay` has been refactored completely to allow for
  overlays with more than one part per texture. The only way of using
  this struct is deprecated
- prefix `enum pl_queue_status` members by `PL_`, fixing an oversight in
  the previous version of this API
- make `pl_renderer` automatically clear the target image, freeing users
  from the responsibility of calling `pl_frame_clear` themselves. This
  can be controlled via three new fields in `pl_render_params`:
  `background_color`, `background_transparency` and `skip_target_clearing`
- rename `pl_context` to `pl_log`, and make its use optional. The old
  names have been deprecated. It now lives inside <libplacebo/log.h>
- add `typedefs` to all public-facing object types, o make them shorter
  to reference. For example, `const struct pl_tex *tex` is now simply
  `pl_tex tex`. This change affects almost every type of object in
  libplacebo. The old way of referencing these objects is still
  possible, but considered deprecated. Note that due to C++-specific
  reasons, C++ users *must* upgrade their codeto the new API style
- remove PL_PRIM_TRIANGLE_FAN
- remove support for 64-bit float formats, which probably don't work on
  any Vulkan implementation
- stop contrast-limiting ICC profiles, instead assuming perceptual
  profiles have infinite contrast
- remove `pl_shader_signature` for being necessarily unsafe
- require Vulkan 1.1 as the minimum vulkan version
- rename `pl_oversample_frame_mixer` to `pl_filter_oversample`, and
  allow using it for image scaling as well
- change `pl_color_space_monitor` from PL_COLOR_TRC_GAMMA22 to UNKNOWN
- change the signature of `pl_shader_(de)linearize` slightly
- significantly increase the default strengths of the desaturation
  settings in`pl_color_map_params`, to mimic the hollywood feel
- refactor `pl_glsl_desc` and `pl_gpu_caps` completely, in favor of the
  new structs `pl_glsl_version` and `pl_gpu_limits`, with new members.
  The old API is still available for the time being, but deprecated

Fixes and performance improvements:
- fix possible use-after-free in `plplay`
- don't explode `pl_queue` on NaN/Infinity/weird PTS values
- fix edge case involving plane merging for cropped images
- improve `plplay` by using threaded libplacebo APIs
- several fixes for edge cases in <libplacebo/utils/libav.h> helpers
- several fixes for 32-bit platforms (e.g. integer overflows)
- fix blending edge cases involving overlays and alpha channels
- skip some unnecessary matrix multiplications for RGB content
- allow for some small backwards PTS jumps in `pl_queue_update`
- fix drawing overlays to subsampled targets
- `pl_dispatch` now garbage collects old, unused passes to free up RAM
- various improvements to debug/diagnonstic printouts
- allow blitting from e.g. 2D to 3D textures
- slightly improve small texture transfers in some emulated edge cases
- fix several possible hash collisions for generated shaders, making the
  shader dispatch mechanism significantly more robust
- properly allow building against vulkan headers without linking to the
  vulkan loader
- C++ compatibility for public headers
- improve performance of textureGather-based polar sampling, especially
  for radius 2 and 4
- fix vulkan texture handle capabilities check, again
- don't include superfluous pNext chains, fixes undefined behavior
- fix crash on edge case when shader compilation fails
- infer unsampled alpha channels as 1.0, rather than 0.0
- properly infer `target->color` in `pl_render_image`
- properly tag the OpenGL swapchain as pl_color_space_monitor
- fix possible crash in pl_get_detected_peak
- fix several edge cases in pl_render_image_mix relating to LUTs,
  3DLUTs, HDR peak detection and so on
- fix sig_peak inferral for HLG content
- several compatibility fixes for older GLSL, and GLES 2.0
- fix possible use-after-free in pl_shader_custom
- fix `pl_color_map_params.gamut_clipping` for HDR targets
- reduce the number of redundant color space transformations required
  for frame mixing
- fix edge case in pl_dispatch_save for some ancient GL drivers
- several fixes for LLVM/MinGW/MSVC
- fix bug where pl_pass_run incorrectly invalidated/accessed
  `params->target` even for compute shaders
- add windows compatibility to several demo programs
- fix the pl_fmt <-> DRM fourcc format mapping table
- fix inappropriate texture access function for generated samplers with
  the sampler2D API
- avoid generating spurious EGL errors when probing for EGL format
  modifiers
- fix various typis in the documentation