- Update to version 3.104.0
This is a major release, introducing many new features and
modifications. Most importantly, libplacebo now interoperates well
with FFmpeg's libav* abstractions. This is primarily exposed via a
new set of helpers, <libplacebo/utils/libav.h>, implemented as a
single header library. In addition to this, a number of other
supporting changes have been made to the API, most notably the
unification of `pl_image` and `pl_render_target` into a single
`pl_frame` concept, similar in spirit to AVFrame. As such,
libplacebo now supports **rendering to planar targets**, including
subsampled YCbCr.
Besides the libav* compatibility changes, this release also brings
with it a new feature for custom shaders: buffer blocks, and
persistent storage. This can be used by third parties to implement
stateful shaders (e.g. motion interpolation or temporal
deinterlacing), or be leveraged to speed up some shaders by
combining multiple passes into one.
Finally, various import/export procedures have been expanded,
including the ability to import host pointers and real-world
DMABUFs.
Additions:
  * add `pl_memory_qualifiers`, plus a corresponding
    `pl_shader_desc.memory`, to allow attaching GLSL memory
    qualifiers (coherent, volatile etc.) to shader descriptors
  * add functions `pl_dispatch_save` and `pl_dispatch_load` to
    allow saving/restoring the contents of an entire
    `pl_dispatch`'s cache
  * add functions `pl_renderer_save` and `pl_renderer_load` to
    allow saving/restoring the contents of an entire
    `pl_renderer`'s cache
  * add `pl_vulkan_swapchain_params.prefer_hdr`, which will cause
    the surface format selection logic to try HDR output formats
    first
  * add `pl_buf_copy` to copy from one buffer to another
  * add `pl_get_detected_peak`, to read back the result of peak
    detection
  * add `pl_primaries_superset` to test if one set of primaries is
    fully enclosed by another
  * add `pl_color_map_params.gamut_clipping`, which will
    colorimetrically clip any out-of-gamut colors by desaturating
    them towards neutral gray until they're in-gamut, rather than
    clipping per channel as before
  * add `PL_GPU_CAP_SUBGROUPS` and `pl_gpu_limits.subgroup_size`,
    to expose GLSL subgroup functionality via the `pl_gpu`
    interface
  * add `pl_gpu_is_failed`, to query at a high level whether the
    `pl_gpu` is in some internal failure state. GPUs in this state
    should be recreated, using the appropriate mechanism
  * add `pl_shader_custom`, to allow injecting arbitrary custom
    GLSL code into a `pl_shader`.
  * add `pl_buf_params.import_handle` to allow importing buffers
  * add `PL_HANDLE_HOST_POTR`, to allow importing arbitrary host
    pointers
  * add `pl_pass_run_params.vertex_buf`, to allow drawing vertex
    data directly from a `pl_buf`, guarded by
    `pl_gpu_limits.max_vbo_size`
  * add `_COUNT` members to all public enums, for consistency
  * add `pl_shared_mem.drm_format_mod`, to allow communicating
    DRM format modifiers when importing/exporting textures
  * add support for importing DMABUFs via EGL, via the new fields
    `pl_opengl_params.egl_display/context`
  * add `pl_fmt.fourcc` to facilitate mapping between `pl_fmt` and
    DRM
  * add the missing `pl_var_*` helpers, for consistency
  * add `pl_plane_data_align` to help with aligning
    `pl_plane_data` structs to byte boundaries
  * add support for STORAGE textures in user shaders, which can be
    used to persist data across separate invocations of the shader
  * add support for BUFFER blocks in user shaders, which can be
    used to create UBOs or SSBOs for use inside shaders, the latter
    of which can also persist across frames and be used to store
    persistent state
  * add PL_COLOR_PRIM_EBU_3213 and PL_COLOR_PRIM_FILM_C
  * add a new header <libplacebo/utils/libav.h>, containing a
    variety of helper functions for interoperating between libav*
    and libplacebo
  * add `demos/plplay.c` to serve as a demonstration of how to make
    a trivial playback loop with libavcodec and libplacebo
  * add `pl_sample_src.component_mask` to allow sampling an
    arbitrary subset of the available components from a plane
  * add `pl_frame_is_cropped` and `pl_frame_clear` to assist in
    properly clearing frames before rendering to them
  * add `pl_tex_poll` to assist in interoperating with some
    external APIs
  * add `pl_render_params.blend_params` to allow blending the final
    output
Changes:
  * remove `pl_image.signature` and
    `pl_render_params.skip_redraw_caching`
  * change vulkan surface format selection to prioritize formats by
    'score', preferring higher depth integer formats
  * `pl_fmt` may now have PL_FMT_CAP_STORABLE even when
    `glsl_format` is NULL, in which case formatless image storage
    must be used
  * `pl_buf_read` no longer requires `buf_offset` be a multiple of
    4
  * `pl_buf_*` commands are now synchronized internally:
  * `pl_buf_write` and `pl_buf_read` now block while the buffer is
    in use Note: for this reason, `pl_buf_write` should not be used
    in loops
  * `pl_tex_upload/download` may now be called on in-use buffers
  * allow `pl_dispatch_compute` on shaders with outputs, including
    the ability to automatically determine the number of work
    groups based on the shader output resolution
  * remove `pl_buf_params.type`, and the concept of buffer types in
    general. `pl_buf` is now a generic catch-all for any type of
    buffer, with individual capabilities in `pl_buf_params`
    determinig what type of shader operations it can be used for
  * relax the alignment requirements on `pl_tex_transfer_params`
  * change `pl_opengl_wrap_params` to allow directly importing
    framebuffers in addition to textures
  * rename `pl_color_levels` members for clarity
  * make `pl_opengl` ignore software rasterizers by default, unless
    the new field `pl_opengl_params.allow_software` is set
  * add `pl_av1_grain_params.luma_comp` to allow drawing the luma
    component from a channel with nonzero index
  * `pl_renderer` now supports rendering to planar targets,
    including subsampled targets
  * `pl_image` and `pl_render_target` have been removed and unified
    into a single `pl_frame` concept
  * remove `pl_tex_params.sample_mode/address_mode` and move them
    to `pl_desc_binding` instead, to decouple them from texture
    creation
  * refactor the signature of `pl_tex_blit`
Fixes and performance improvements:
  * fix an oversight where `pl_buf_destroy` delayed some buffer
    destructions unnecessarily
  * fix a limitation where `pl_tex_destroy` sometimes delayed
    destroying textures unnecessarily
  * improve the performance of `pl_dispatch`'s code for assembling
    UBOs
  * improve the performance of `pl_shader_av1_grain` by switching
    from SSBOs to texture LUTs, also improving compatibility with
    older GL
  * improve the performance of `pl_shader_detect_peak` on GPUs with
    access to subgroups operations
  * fix an issue where reinitializing shader state objects with
    different settings sometimes resulted in undefined behaviour
  * fix some GLSL backwards compatibility issues
  * slightly cut down on unnecessary image layout transitions
  * add some miscellaneous debug print-outs, and improve the
    legibility of some existing log messages
  * fix an issue where freeing buffer variables from shader
    descriptors could result in use-after-free
  * add support for vulkan memory imports requiring dedication
    allocations
  * slightly improve, and fix, the vulkan memory placement logic
  * significantly improve the performance of `pl_tex_download` by
    importing the target host pointer directly
  * improve the performance of small LUTs, especially for the
    non-compute polar fallback path
  * prevent `pl_renderer` from unneccessarily applying a 3DLUT when
    both the input and output frames have the same ICC profile
  * fix the behaviour of partially specified `pl_bit_encoding`
    structs
  * fix the component ordering on some odd packed vulkan formats
  * fix an issue where `pl_plane_data_from_mask` broke for high bit
    depths
  * make `pl_renderer` consult the dither bit depth from the
    texture precision, if absent from `pl_bit_encoding`
  * fix the behaviour of `pl_renderer` when sampling from textures
    with swapped component orders
  * fix the implementation of PL_COLOR_SYSTEM_BT_2100_HLG
  * fix some issues relating to missing includes
  * enforce legality of image usage parameters on `pl_vulkan_wrap`
  * fix an undesired shader double-compilation when using
    orthogonal scalers with subsampled chroma planes
  * fix an issue where application of a 3DLUT cleared the alpha
    channel
  * add a missing extension to `pl_vulkan_recommended_extensions`
  * fix the plane alignment code for oddly sized subsampled chroma
  * fix the poor precision of `pl_shader_dither` for high bit
    depths
  * fix several possible overflows in the BT.2390 shader
  * fix a bug where using a polar sampler to draw a scaled overlay
    onto a non-storable target neglected to disable compute shaders
  * fix a bug where the renderer could sometimes alias when
    downscaling, in particular if both the upsampler and
    downsampler are set to bicubic
  * improve performance of scalers by avoiding bilinear filtering
  * reduce verbosity of memory allocations
  * fix missing PL_FMT_CAP_BLENDABLE on opengl fbos
  * significantly improve precision of float literals in shaders
  * add better error checking to gl_pass_create

• Files Changed
• Browse Source