GPU: Add Texture Usage Parameter to GPUOffscreen. #106899

Currently the Textures used for offscreen rendering don't have
the GPU_TEXTURE_USAGE_HOST_READ flag. But some cases it is
needed. This PR adds a parameter when creating an offscreen
buffer.

Other solution could be to add this flag to all textures, but
we chose not to do this as that reduces the amount of fine-tuning
options for Metal/Vulkan backends. GPU can store textures
differently based on its actual usage.

This option isn't available in the python API as we don't expect
add-on developers to fine-tune texture usages to this extent.

For convenience GPU_TEXTURE_USAGE_ATTACHMENT is by default
always added.

Currently the Textures used for offscreen rendering don't have the `GPU_TEXTURE_USAGE_HOST_READ` flag. But some cases it is needed. This PR adds a parameter when creating an offscreen buffer. Other solution could be to add this flag to all textures, but we chose not to do this as that reduces the amount of fine-tuning options for Metal/Vulkan backends. GPU can store textures differently based on its actual usage. This option isn't available in the python API as we don't expect add-on developers to fine-tune texture usages to this extent. For convenience `GPU_TEXTURE_USAGE_ATTACHMENT` is by default always added.

I checked the actual usages around the areas where the offscreen buffers where created and updated them accordingly. There were some areas already that needed
the host visibility flags.

Depending on the actual platform this could have been an issue. I came across this issue during development of the Vulkan graphics pipeline. Where Vulkan mentioned incorrect usage flags.

I checked the actual usages around the areas where the offscreen buffers where created and updated them accordingly. There were some areas already that needed the host visibility flags. Depending on the actual platform this could have been an issue. I came across this issue during development of the Vulkan graphics pipeline. Where Vulkan mentioned incorrect usage flags.

I think the flag GPU_TEXTURE_USAGE_ATTACHMENT should be added inside GPU_offscreen_create to avoid forgetting it. Also this should be mentioned on the header documentation of the function.

I think the flag `GPU_TEXTURE_USAGE_ATTACHMENT` should be added inside `GPU_offscreen_create` to avoid forgetting it. Also this should be mentioned on the header documentation of the function.

Download

What's New

Blender Studio

Manual

Developers Blog

Documentation

Benchmark

Blender Conference

Development Fund

One-time Donations

GPU: Add Texture Usage Parameter to GPUOffscreen. #106899

Reviewers