+1

doc/changes/compositor/mr.2380.md

reviewed

··· 1 1 + Add: Expose a `comp_render_gfx_layers` (formerly called `do_layers`) to match the `comp_render_cs_layers` function, which squashes layers.

+33

src/xrt/compositor/util/comp_render.h

reviewed

··· 317 317 } 318 318 319 319 /*! 320 320 + * Dispatch the (graphics pipeline) layer squasher, on any number of views. 321 321 + * 322 322 + * All source layer images needs to be in the correct image layout, no barrier 323 323 + * is inserted for them. The target images are barriered from undefined to general 324 324 + * so they can be written to, then to the layout defined by @p transition_to. 325 325 + * 326 326 + * Expected layouts: 327 327 + * 328 328 + * - Layer images: `VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL` 329 329 + * - Target images: Any 330 330 + * 331 331 + * After call layouts: 332 332 + * 333 333 + * - Layer images: `VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL` 334 334 + * - Target images: @p transition_to 335 335 + * 336 336 + * @note Swapchains in the @p layers must implement @ref comp_swapchain in 337 337 + * addition to just @ref xrt_swapchain, as this function downcasts to @ref comp_swapchain ! 338 338 + * 339 339 + * @param render Graphics renderer object 340 340 + * @param[in] layers Layers to render, see note. 341 341 + * @param[in] layer_count Number of elements in @p layers array. 342 342 + * @param[in] d Common render dispatch data 343 343 + * @param[in] transition_to Desired image layout for target images 344 344 + */ 345 345 + void 346 346 + comp_render_gfx_layers(struct render_gfx *render, 347 347 + const struct comp_layer *layers, 348 348 + uint32_t layer_count, 349 349 + const struct comp_render_dispatch_data *d, 350 350 + VkImageLayout transition_to); 351 351 + 352 352 + /*! 320 353 * Writes the needed commands to the @ref render_gfx to do a full composition with distortion. 321 354 * 322 355 * Takes a set of layers, new device poses, scratch