| /* | |
| Simple DirectMedia Layer | |
| Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org> | |
| This software is provided 'as-is', without any express or implied | |
| warranty. In no event will the authors be held liable for any damages | |
| arising from the use of this software. | |
| Permission is granted to anyone to use this software for any purpose, | |
| including commercial applications, and to alter it and redistribute it | |
| freely, subject to the following restrictions: | |
| 1. The origin of this software must not be misrepresented; you must not | |
| claim that you wrote the original software. If you use this software | |
| in a product, an acknowledgment in the product documentation would be | |
| appreciated but is not required. | |
| 2. Altered source versions must be plainly marked as such, and must not be | |
| misrepresented as being the original software. | |
| 3. This notice may not be removed or altered from any source distribution. | |
| */ | |
| #include "../video/SDL_sysvideo.h" | |
| #include "SDL_internal.h" | |
| #ifndef SDL_GPU_DRIVER_H | |
| #define SDL_GPU_DRIVER_H | |
| #include <SDL3/SDL_openxr.h> | |
| // GraphicsDevice Limits | |
| #define MAX_TEXTURE_SAMPLERS_PER_STAGE 16 | |
| #define MAX_STORAGE_TEXTURES_PER_STAGE 8 | |
| #define MAX_STORAGE_BUFFERS_PER_STAGE 8 | |
| #define MAX_UNIFORM_BUFFERS_PER_STAGE 4 | |
| #define MAX_COMPUTE_WRITE_TEXTURES 8 | |
| #define MAX_COMPUTE_WRITE_BUFFERS 8 | |
| #define UNIFORM_BUFFER_SIZE 32768 | |
| #define MAX_VERTEX_BUFFERS 16 | |
| #define MAX_VERTEX_ATTRIBUTES 16 | |
| #define MAX_COLOR_TARGET_BINDINGS 8 | |
| #define MAX_PRESENT_COUNT 16 | |
| #define MAX_FRAMES_IN_FLIGHT 3 | |
| // Common Structs | |
| typedef struct Pass | |
| { | |
| SDL_GPUCommandBuffer *command_buffer; | |
| bool in_progress; | |
| } Pass; | |
| typedef struct ComputePass | |
| { | |
| SDL_GPUCommandBuffer *command_buffer; | |
| bool in_progress; | |
| SDL_GPUComputePipeline *compute_pipeline; | |
| bool sampler_bound[MAX_TEXTURE_SAMPLERS_PER_STAGE]; | |
| bool read_only_storage_texture_bound[MAX_STORAGE_TEXTURES_PER_STAGE]; | |
| bool read_only_storage_buffer_bound[MAX_STORAGE_BUFFERS_PER_STAGE]; | |
| bool read_write_storage_texture_bound[MAX_COMPUTE_WRITE_TEXTURES]; | |
| bool read_write_storage_buffer_bound[MAX_COMPUTE_WRITE_BUFFERS]; | |
| } ComputePass; | |
| typedef struct RenderPass | |
| { | |
| SDL_GPUCommandBuffer *command_buffer; | |
| bool in_progress; | |
| SDL_GPUTexture *color_targets[MAX_COLOR_TARGET_BINDINGS]; | |
| Uint32 num_color_targets; | |
| SDL_GPUTexture *depth_stencil_target; | |
| SDL_GPUGraphicsPipeline *graphics_pipeline; | |
| bool vertex_sampler_bound[MAX_TEXTURE_SAMPLERS_PER_STAGE]; | |
| bool vertex_storage_texture_bound[MAX_STORAGE_TEXTURES_PER_STAGE]; | |
| bool vertex_storage_buffer_bound[MAX_STORAGE_BUFFERS_PER_STAGE]; | |
| bool fragment_sampler_bound[MAX_TEXTURE_SAMPLERS_PER_STAGE]; | |
| bool fragment_storage_texture_bound[MAX_STORAGE_TEXTURES_PER_STAGE]; | |
| bool fragment_storage_buffer_bound[MAX_STORAGE_BUFFERS_PER_STAGE]; | |
| } RenderPass; | |
| typedef struct CommandBufferCommonHeader | |
| { | |
| SDL_GPUDevice *device; | |
| RenderPass render_pass; | |
| ComputePass compute_pass; | |
| Pass copy_pass; | |
| bool swapchain_texture_acquired; | |
| bool submitted; | |
| // used to avoid tripping assert on GenerateMipmaps | |
| bool ignore_render_pass_texture_validation; | |
| } CommandBufferCommonHeader; | |
| typedef struct TextureCommonHeader | |
| { | |
| SDL_GPUTextureCreateInfo info; | |
| } TextureCommonHeader; | |
| typedef struct GraphicsPipelineCommonHeader | |
| { | |
| Uint32 num_vertex_samplers; | |
| Uint32 num_vertex_storage_textures; | |
| Uint32 num_vertex_storage_buffers; | |
| Uint32 num_vertex_uniform_buffers; | |
| Uint32 num_fragment_samplers; | |
| Uint32 num_fragment_storage_textures; | |
| Uint32 num_fragment_storage_buffers; | |
| Uint32 num_fragment_uniform_buffers; | |
| } GraphicsPipelineCommonHeader; | |
| typedef struct ComputePipelineCommonHeader | |
| { | |
| Uint32 numSamplers; | |
| Uint32 numReadonlyStorageTextures; | |
| Uint32 numReadonlyStorageBuffers; | |
| Uint32 numReadWriteStorageTextures; | |
| Uint32 numReadWriteStorageBuffers; | |
| Uint32 numUniformBuffers; | |
| } ComputePipelineCommonHeader; | |
| typedef struct BlitFragmentUniforms | |
| { | |
| // texcoord space | |
| float left; | |
| float top; | |
| float width; | |
| float height; | |
| Uint32 mip_level; | |
| float layer_or_depth; | |
| } BlitFragmentUniforms; | |
| typedef struct BlitPipelineCacheEntry | |
| { | |
| SDL_GPUTextureType type; | |
| SDL_GPUTextureFormat format; | |
| SDL_GPUGraphicsPipeline *pipeline; | |
| } BlitPipelineCacheEntry; | |
| // Internal Helper Utilities | |
| #define SDL_GPU_TEXTUREFORMAT_MAX_ENUM_VALUE (SDL_GPU_TEXTUREFORMAT_ASTC_12x12_FLOAT + 1) | |
| #define SDL_GPU_VERTEXELEMENTFORMAT_MAX_ENUM_VALUE (SDL_GPU_VERTEXELEMENTFORMAT_R10G10B10A2_UNORM + 1) | |
| #define SDL_GPU_COMPAREOP_MAX_ENUM_VALUE (SDL_GPU_COMPAREOP_ALWAYS + 1) | |
| #define SDL_GPU_STENCILOP_MAX_ENUM_VALUE (SDL_GPU_STENCILOP_DECREMENT_AND_WRAP + 1) | |
| #define SDL_GPU_BLENDOP_MAX_ENUM_VALUE (SDL_GPU_BLENDOP_MAX + 1) | |
| #define SDL_GPU_BLENDFACTOR_MAX_ENUM_VALUE (SDL_GPU_BLENDFACTOR_SRC_ALPHA_SATURATE + 1) | |
| #define SDL_GPU_SWAPCHAINCOMPOSITION_MAX_ENUM_VALUE (SDL_GPU_SWAPCHAINCOMPOSITION_HDR10_ST2084 + 1) | |
| #define SDL_GPU_PRESENTMODE_MAX_ENUM_VALUE (SDL_GPU_PRESENTMODE_MAILBOX + 1) | |
| static inline Sint32 Texture_GetBlockWidth( | |
| SDL_GPUTextureFormat format) | |
| { | |
| switch (format) { | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_FLOAT: | |
| return 12; | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_FLOAT: | |
| return 10; | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_FLOAT: | |
| return 8; | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_FLOAT: | |
| return 6; | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_FLOAT: | |
| return 5; | |
| case SDL_GPU_TEXTUREFORMAT_BC1_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC2_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC3_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC4_R_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC5_RG_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC7_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC6H_RGB_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_BC6H_RGB_UFLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_BC1_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC2_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC3_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC7_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_FLOAT: | |
| return 4; | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B8G8R8A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B5G6R5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B5G5R5A1_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B4G4R4A4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R10G10B10A2_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R11G11B10_UFLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R32_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R32_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_B8G8R8A8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_D16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_D24_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_D32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_D24_UNORM_S8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_D32_FLOAT_S8_UINT: | |
| return 1; | |
| default: | |
| SDL_assert_release(!"Unrecognized TextureFormat!"); | |
| return 0; | |
| } | |
| } | |
| static inline Sint32 Texture_GetBlockHeight( | |
| SDL_GPUTextureFormat format) | |
| { | |
| switch (format) { | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_FLOAT: | |
| return 12; | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_FLOAT: | |
| return 10; | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_FLOAT: | |
| return 8; | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_FLOAT: | |
| return 6; | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_FLOAT: | |
| return 5; | |
| case SDL_GPU_TEXTUREFORMAT_BC1_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC2_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC3_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC4_R_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC5_RG_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC7_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC6H_RGB_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_BC6H_RGB_UFLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_BC1_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC2_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC3_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC7_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_FLOAT: | |
| return 4; | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B8G8R8A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B5G6R5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B5G5R5A1_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B4G4R4A4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R10G10B10A2_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R11G11B10_UFLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R32_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R32_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_B8G8R8A8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_D16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_D24_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_D32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_D24_UNORM_S8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_D32_FLOAT_S8_UINT: | |
| return 1; | |
| default: | |
| SDL_assert_release(!"Unrecognized TextureFormat!"); | |
| return 0; | |
| } | |
| } | |
| static inline bool IsDepthFormat( | |
| SDL_GPUTextureFormat format) | |
| { | |
| switch (format) { | |
| case SDL_GPU_TEXTUREFORMAT_D16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_D24_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_D32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_D24_UNORM_S8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_D32_FLOAT_S8_UINT: | |
| return true; | |
| default: | |
| return false; | |
| } | |
| } | |
| static inline bool IsStencilFormat( | |
| SDL_GPUTextureFormat format) | |
| { | |
| switch (format) { | |
| case SDL_GPU_TEXTUREFORMAT_D24_UNORM_S8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_D32_FLOAT_S8_UINT: | |
| return true; | |
| default: | |
| return false; | |
| } | |
| } | |
| static inline bool IsIntegerFormat( | |
| SDL_GPUTextureFormat format) | |
| { | |
| switch (format) { | |
| case SDL_GPU_TEXTUREFORMAT_R8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_INT: | |
| return true; | |
| default: | |
| return false; | |
| } | |
| } | |
| static inline bool IsCompressedFormat( | |
| SDL_GPUTextureFormat format) | |
| { | |
| switch (format) { | |
| case SDL_GPU_TEXTUREFORMAT_BC1_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC1_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC2_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC2_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC3_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC3_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC4_R_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC5_RG_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC6H_RGB_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_BC6H_RGB_UFLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_BC7_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC7_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_FLOAT: | |
| return true; | |
| default: | |
| return false; | |
| } | |
| } | |
| static inline bool FormatHasAlpha( | |
| SDL_GPUTextureFormat format) | |
| { | |
| switch (format) { | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x10_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_12x12_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x8_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_10x10_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_8x8_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_6x6_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x4_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_5x5_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_ASTC_4x4_FLOAT: | |
| // ASTC textures may or may not have alpha; return true as this is mainly intended for validation | |
| return true; | |
| case SDL_GPU_TEXTUREFORMAT_BC1_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC2_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC3_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC7_RGBA_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_BC1_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC2_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC3_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_BC7_RGBA_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B8G8R8A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B5G5R5A1_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_B4G4R4A4_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R10G10B10A2_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_A8_UNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_SNORM: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_FLOAT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_UINT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R16G16B16A16_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R32G32B32A32_INT: | |
| case SDL_GPU_TEXTUREFORMAT_R8G8B8A8_UNORM_SRGB: | |
| case SDL_GPU_TEXTUREFORMAT_B8G8R8A8_UNORM_SRGB: | |
| return true; | |
| default: | |
| return false; | |
| } | |
| } | |
| static inline Uint32 IndexSize(SDL_GPUIndexElementSize size) | |
| { | |
| return (size == SDL_GPU_INDEXELEMENTSIZE_16BIT) ? 2 : 4; | |
| } | |
| static inline Uint32 BytesPerRow( | |
| Sint32 width, | |
| SDL_GPUTextureFormat format) | |
| { | |
| Uint32 blockWidth = Texture_GetBlockWidth(format); | |
| Uint32 blocksPerRow = (width + blockWidth - 1) / blockWidth; | |
| return blocksPerRow * SDL_GPUTextureFormatTexelBlockSize(format); | |
| } | |
| // Internal Macros | |
| #define EXPAND_ARRAY_IF_NEEDED(arr, elementType, newCount, capacity, newCapacity) \ | |
| do { \ | |
| if ((newCount) >= (capacity)) { \ | |
| (capacity) = (newCapacity); \ | |
| (arr) = (elementType *)SDL_realloc( \ | |
| (arr), \ | |
| sizeof(elementType) * (capacity)); \ | |
| } \ | |
| } while (0) | |
| // Internal Declarations | |
| #ifdef __cplusplus | |
| extern "C" { | |
| #endif // __cplusplus | |
| SDL_GPUGraphicsPipeline *SDL_GPU_FetchBlitPipeline( | |
| SDL_GPUDevice *device, | |
| SDL_GPUTextureType sourceTextureType, | |
| SDL_GPUTextureFormat destinationFormat, | |
| SDL_GPUShader *blitVertexShader, | |
| SDL_GPUShader *blitFrom2DShader, | |
| SDL_GPUShader *blitFrom2DArrayShader, | |
| SDL_GPUShader *blitFrom3DShader, | |
| SDL_GPUShader *blitFromCubeShader, | |
| SDL_GPUShader *blitFromCubeArrayShader, | |
| BlitPipelineCacheEntry **blitPipelines, | |
| Uint32 *blitPipelineCount, | |
| Uint32 *blitPipelineCapacity); | |
| void SDL_GPU_BlitCommon( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUBlitInfo *info, | |
| SDL_GPUSampler *blitLinearSampler, | |
| SDL_GPUSampler *blitNearestSampler, | |
| SDL_GPUShader *blitVertexShader, | |
| SDL_GPUShader *blitFrom2DShader, | |
| SDL_GPUShader *blitFrom2DArrayShader, | |
| SDL_GPUShader *blitFrom3DShader, | |
| SDL_GPUShader *blitFromCubeShader, | |
| SDL_GPUShader *blitFromCubeArrayShader, | |
| BlitPipelineCacheEntry **blitPipelines, | |
| Uint32 *blitPipelineCount, | |
| Uint32 *blitPipelineCapacity); | |
| #ifdef __cplusplus | |
| } | |
| #endif // __cplusplus | |
| // SDL_GPUDevice Definition | |
| typedef struct SDL_GPURenderer SDL_GPURenderer; | |
| struct SDL_GPUDevice | |
| { | |
| // Device | |
| void (*DestroyDevice)(SDL_GPUDevice *device); | |
| XrResult (*DestroyXRSwapchain)( | |
| SDL_GPURenderer *device, | |
| XrSwapchain swapchain, | |
| SDL_GPUTexture **swapchainImages); | |
| SDL_PropertiesID (*GetDeviceProperties)(SDL_GPUDevice *device); | |
| // State Creation | |
| SDL_GPUComputePipeline *(*CreateComputePipeline)( | |
| SDL_GPURenderer *driverData, | |
| const SDL_GPUComputePipelineCreateInfo *createinfo); | |
| SDL_GPUGraphicsPipeline *(*CreateGraphicsPipeline)( | |
| SDL_GPURenderer *driverData, | |
| const SDL_GPUGraphicsPipelineCreateInfo *createinfo); | |
| SDL_GPUSampler *(*CreateSampler)( | |
| SDL_GPURenderer *driverData, | |
| const SDL_GPUSamplerCreateInfo *createinfo); | |
| SDL_GPUShader *(*CreateShader)( | |
| SDL_GPURenderer *driverData, | |
| const SDL_GPUShaderCreateInfo *createinfo); | |
| SDL_GPUTexture *(*CreateTexture)( | |
| SDL_GPURenderer *driverData, | |
| const SDL_GPUTextureCreateInfo *createinfo); | |
| SDL_GPUBuffer *(*CreateBuffer)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUBufferUsageFlags usageFlags, | |
| Uint32 size, | |
| const char *debugName); | |
| SDL_GPUTransferBuffer *(*CreateTransferBuffer)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUTransferBufferUsage usage, | |
| Uint32 size, | |
| const char *debugName); | |
| XrResult (*CreateXRSession)( | |
| SDL_GPURenderer *driverData, | |
| const XrSessionCreateInfo *createinfo, | |
| XrSession *session); | |
| SDL_GPUTextureFormat* (*GetXRSwapchainFormats)( | |
| SDL_GPURenderer *driverData, | |
| XrSession session, | |
| int *num_formats); | |
| XrResult (*CreateXRSwapchain)( | |
| SDL_GPURenderer *driverData, | |
| XrSession session, | |
| const XrSwapchainCreateInfo *createinfo, | |
| SDL_GPUTextureFormat format, | |
| XrSwapchain *swapchain, | |
| SDL_GPUTexture ***textures); | |
| // Debug Naming | |
| void (*SetBufferName)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUBuffer *buffer, | |
| const char *text); | |
| void (*SetTextureName)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUTexture *texture, | |
| const char *text); | |
| void (*InsertDebugLabel)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const char *text); | |
| void (*PushDebugGroup)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const char *name); | |
| void (*PopDebugGroup)( | |
| SDL_GPUCommandBuffer *commandBuffer); | |
| // Disposal | |
| void (*ReleaseTexture)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUTexture *texture); | |
| void (*ReleaseSampler)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUSampler *sampler); | |
| void (*ReleaseBuffer)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUBuffer *buffer); | |
| void (*ReleaseTransferBuffer)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUTransferBuffer *transferBuffer); | |
| void (*ReleaseShader)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUShader *shader); | |
| void (*ReleaseComputePipeline)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUComputePipeline *computePipeline); | |
| void (*ReleaseGraphicsPipeline)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUGraphicsPipeline *graphicsPipeline); | |
| // Render Pass | |
| void (*BeginRenderPass)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUColorTargetInfo *colorTargetInfos, | |
| Uint32 numColorTargets, | |
| const SDL_GPUDepthStencilTargetInfo *depthStencilTargetInfo); | |
| void (*BindGraphicsPipeline)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_GPUGraphicsPipeline *graphicsPipeline); | |
| void (*SetViewport)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUViewport *viewport); | |
| void (*SetScissor)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_Rect *scissor); | |
| void (*SetBlendConstants)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_FColor blendConstants); | |
| void (*SetStencilReference)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint8 reference); | |
| void (*BindVertexBuffers)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| const SDL_GPUBufferBinding *bindings, | |
| Uint32 numBindings); | |
| void (*BindIndexBuffer)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUBufferBinding *binding, | |
| SDL_GPUIndexElementSize indexElementSize); | |
| void (*BindVertexSamplers)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| const SDL_GPUTextureSamplerBinding *textureSamplerBindings, | |
| Uint32 numBindings); | |
| void (*BindVertexStorageTextures)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| SDL_GPUTexture *const *storageTextures, | |
| Uint32 numBindings); | |
| void (*BindVertexStorageBuffers)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| SDL_GPUBuffer *const *storageBuffers, | |
| Uint32 numBindings); | |
| void (*BindFragmentSamplers)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| const SDL_GPUTextureSamplerBinding *textureSamplerBindings, | |
| Uint32 numBindings); | |
| void (*BindFragmentStorageTextures)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| SDL_GPUTexture *const *storageTextures, | |
| Uint32 numBindings); | |
| void (*BindFragmentStorageBuffers)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| SDL_GPUBuffer *const *storageBuffers, | |
| Uint32 numBindings); | |
| void (*PushVertexUniformData)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 slotIndex, | |
| const void *data, | |
| Uint32 length); | |
| void (*PushFragmentUniformData)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 slotIndex, | |
| const void *data, | |
| Uint32 length); | |
| void (*DrawIndexedPrimitives)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 numIndices, | |
| Uint32 numInstances, | |
| Uint32 firstIndex, | |
| Sint32 vertexOffset, | |
| Uint32 firstInstance); | |
| void (*DrawPrimitives)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 numVertices, | |
| Uint32 numInstances, | |
| Uint32 firstVertex, | |
| Uint32 firstInstance); | |
| void (*DrawPrimitivesIndirect)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_GPUBuffer *buffer, | |
| Uint32 offset, | |
| Uint32 drawCount); | |
| void (*DrawIndexedPrimitivesIndirect)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_GPUBuffer *buffer, | |
| Uint32 offset, | |
| Uint32 drawCount); | |
| void (*EndRenderPass)( | |
| SDL_GPUCommandBuffer *commandBuffer); | |
| // Compute Pass | |
| void (*BeginComputePass)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUStorageTextureReadWriteBinding *storageTextureBindings, | |
| Uint32 numStorageTextureBindings, | |
| const SDL_GPUStorageBufferReadWriteBinding *storageBufferBindings, | |
| Uint32 numStorageBufferBindings); | |
| void (*BindComputePipeline)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_GPUComputePipeline *computePipeline); | |
| void (*BindComputeSamplers)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| const SDL_GPUTextureSamplerBinding *textureSamplerBindings, | |
| Uint32 numBindings); | |
| void (*BindComputeStorageTextures)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| SDL_GPUTexture *const *storageTextures, | |
| Uint32 numBindings); | |
| void (*BindComputeStorageBuffers)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 firstSlot, | |
| SDL_GPUBuffer *const *storageBuffers, | |
| Uint32 numBindings); | |
| void (*PushComputeUniformData)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 slotIndex, | |
| const void *data, | |
| Uint32 length); | |
| void (*DispatchCompute)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| Uint32 groupcountX, | |
| Uint32 groupcountY, | |
| Uint32 groupcountZ); | |
| void (*DispatchComputeIndirect)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_GPUBuffer *buffer, | |
| Uint32 offset); | |
| void (*EndComputePass)( | |
| SDL_GPUCommandBuffer *commandBuffer); | |
| // TransferBuffer Data | |
| void *(*MapTransferBuffer)( | |
| SDL_GPURenderer *device, | |
| SDL_GPUTransferBuffer *transferBuffer, | |
| bool cycle); | |
| void (*UnmapTransferBuffer)( | |
| SDL_GPURenderer *device, | |
| SDL_GPUTransferBuffer *transferBuffer); | |
| // Copy Pass | |
| void (*BeginCopyPass)( | |
| SDL_GPUCommandBuffer *commandBuffer); | |
| void (*UploadToTexture)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUTextureTransferInfo *source, | |
| const SDL_GPUTextureRegion *destination, | |
| bool cycle); | |
| void (*UploadToBuffer)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUTransferBufferLocation *source, | |
| const SDL_GPUBufferRegion *destination, | |
| bool cycle); | |
| void (*CopyTextureToTexture)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUTextureLocation *source, | |
| const SDL_GPUTextureLocation *destination, | |
| Uint32 w, | |
| Uint32 h, | |
| Uint32 d, | |
| bool cycle); | |
| void (*CopyBufferToBuffer)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUBufferLocation *source, | |
| const SDL_GPUBufferLocation *destination, | |
| Uint32 size, | |
| bool cycle); | |
| void (*GenerateMipmaps)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_GPUTexture *texture); | |
| void (*DownloadFromTexture)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUTextureRegion *source, | |
| const SDL_GPUTextureTransferInfo *destination); | |
| void (*DownloadFromBuffer)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUBufferRegion *source, | |
| const SDL_GPUTransferBufferLocation *destination); | |
| void (*EndCopyPass)( | |
| SDL_GPUCommandBuffer *commandBuffer); | |
| void (*Blit)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| const SDL_GPUBlitInfo *info); | |
| // Submission/Presentation | |
| bool (*SupportsSwapchainComposition)( | |
| SDL_GPURenderer *driverData, | |
| SDL_Window *window, | |
| SDL_GPUSwapchainComposition swapchainComposition); | |
| bool (*SupportsPresentMode)( | |
| SDL_GPURenderer *driverData, | |
| SDL_Window *window, | |
| SDL_GPUPresentMode presentMode); | |
| bool (*ClaimWindow)( | |
| SDL_GPURenderer *driverData, | |
| SDL_Window *window); | |
| void (*ReleaseWindow)( | |
| SDL_GPURenderer *driverData, | |
| SDL_Window *window); | |
| bool (*SetSwapchainParameters)( | |
| SDL_GPURenderer *driverData, | |
| SDL_Window *window, | |
| SDL_GPUSwapchainComposition swapchainComposition, | |
| SDL_GPUPresentMode presentMode); | |
| bool (*SetAllowedFramesInFlight)( | |
| SDL_GPURenderer *driverData, | |
| Uint32 allowedFramesInFlight); | |
| SDL_GPUTextureFormat (*GetSwapchainTextureFormat)( | |
| SDL_GPURenderer *driverData, | |
| SDL_Window *window); | |
| SDL_GPUCommandBuffer *(*AcquireCommandBuffer)( | |
| SDL_GPURenderer *driverData); | |
| bool (*AcquireSwapchainTexture)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_Window *window, | |
| SDL_GPUTexture **swapchainTexture, | |
| Uint32 *swapchainTextureWidth, | |
| Uint32 *swapchainTextureHeight); | |
| bool (*WaitForSwapchain)( | |
| SDL_GPURenderer *driverData, | |
| SDL_Window *window); | |
| bool (*WaitAndAcquireSwapchainTexture)( | |
| SDL_GPUCommandBuffer *commandBuffer, | |
| SDL_Window *window, | |
| SDL_GPUTexture **swapchainTexture, | |
| Uint32 *swapchainTextureWidth, | |
| Uint32 *swapchainTextureHeight); | |
| bool (*Submit)( | |
| SDL_GPUCommandBuffer *commandBuffer); | |
| SDL_GPUFence *(*SubmitAndAcquireFence)( | |
| SDL_GPUCommandBuffer *commandBuffer); | |
| bool (*Cancel)( | |
| SDL_GPUCommandBuffer *commandBuffer); | |
| bool (*Wait)( | |
| SDL_GPURenderer *driverData); | |
| bool (*WaitForFences)( | |
| SDL_GPURenderer *driverData, | |
| bool waitAll, | |
| SDL_GPUFence *const *fences, | |
| Uint32 numFences); | |
| bool (*QueryFence)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUFence *fence); | |
| void (*ReleaseFence)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUFence *fence); | |
| // Feature Queries | |
| bool (*SupportsTextureFormat)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUTextureFormat format, | |
| SDL_GPUTextureType type, | |
| SDL_GPUTextureUsageFlags usage); | |
| bool (*SupportsSampleCount)( | |
| SDL_GPURenderer *driverData, | |
| SDL_GPUTextureFormat format, | |
| SDL_GPUSampleCount desiredSampleCount); | |
| // Opaque pointer for the Driver | |
| SDL_GPURenderer *driverData; | |
| // Store this for SDL_GetGPUDeviceDriver() | |
| const char *backend; | |
| // Store this for SDL_GetGPUShaderFormats() | |
| SDL_GPUShaderFormat shader_formats; | |
| // Store this for SDL_gpu.c's debug layer | |
| bool debug_mode; | |
| bool default_enable_depth_clip; | |
| bool validate_feature_depth_clamp_disabled; | |
| bool validate_feature_anisotropy_disabled; | |
| Uint32 max_viewport_width; | |
| Uint32 max_viewport_height; | |
| }; | |
| #define ASSIGN_DRIVER_FUNC(func, name) \ | |
| result->func = name##_##func; | |
| #define ASSIGN_DRIVER(name) \ | |
| ASSIGN_DRIVER_FUNC(DestroyDevice, name) \ | |
| ASSIGN_DRIVER_FUNC(DestroyXRSwapchain, name) \ | |
| ASSIGN_DRIVER_FUNC(GetDeviceProperties, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateComputePipeline, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateGraphicsPipeline, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateSampler, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateShader, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateTexture, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateTransferBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateXRSession, name) \ | |
| ASSIGN_DRIVER_FUNC(GetXRSwapchainFormats, name) \ | |
| ASSIGN_DRIVER_FUNC(CreateXRSwapchain, name) \ | |
| ASSIGN_DRIVER_FUNC(SetBufferName, name) \ | |
| ASSIGN_DRIVER_FUNC(SetTextureName, name) \ | |
| ASSIGN_DRIVER_FUNC(InsertDebugLabel, name) \ | |
| ASSIGN_DRIVER_FUNC(PushDebugGroup, name) \ | |
| ASSIGN_DRIVER_FUNC(PopDebugGroup, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseTexture, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseSampler, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseTransferBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseShader, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseComputePipeline, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseGraphicsPipeline, name) \ | |
| ASSIGN_DRIVER_FUNC(BeginRenderPass, name) \ | |
| ASSIGN_DRIVER_FUNC(BindGraphicsPipeline, name) \ | |
| ASSIGN_DRIVER_FUNC(SetViewport, name) \ | |
| ASSIGN_DRIVER_FUNC(SetScissor, name) \ | |
| ASSIGN_DRIVER_FUNC(SetBlendConstants, name) \ | |
| ASSIGN_DRIVER_FUNC(SetStencilReference, name) \ | |
| ASSIGN_DRIVER_FUNC(BindVertexBuffers, name) \ | |
| ASSIGN_DRIVER_FUNC(BindIndexBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(BindVertexSamplers, name) \ | |
| ASSIGN_DRIVER_FUNC(BindVertexStorageTextures, name) \ | |
| ASSIGN_DRIVER_FUNC(BindVertexStorageBuffers, name) \ | |
| ASSIGN_DRIVER_FUNC(BindFragmentSamplers, name) \ | |
| ASSIGN_DRIVER_FUNC(BindFragmentStorageTextures, name) \ | |
| ASSIGN_DRIVER_FUNC(BindFragmentStorageBuffers, name) \ | |
| ASSIGN_DRIVER_FUNC(PushVertexUniformData, name) \ | |
| ASSIGN_DRIVER_FUNC(PushFragmentUniformData, name) \ | |
| ASSIGN_DRIVER_FUNC(DrawIndexedPrimitives, name) \ | |
| ASSIGN_DRIVER_FUNC(DrawPrimitives, name) \ | |
| ASSIGN_DRIVER_FUNC(DrawPrimitivesIndirect, name) \ | |
| ASSIGN_DRIVER_FUNC(DrawIndexedPrimitivesIndirect, name) \ | |
| ASSIGN_DRIVER_FUNC(EndRenderPass, name) \ | |
| ASSIGN_DRIVER_FUNC(BeginComputePass, name) \ | |
| ASSIGN_DRIVER_FUNC(BindComputePipeline, name) \ | |
| ASSIGN_DRIVER_FUNC(BindComputeSamplers, name) \ | |
| ASSIGN_DRIVER_FUNC(BindComputeStorageTextures, name) \ | |
| ASSIGN_DRIVER_FUNC(BindComputeStorageBuffers, name) \ | |
| ASSIGN_DRIVER_FUNC(PushComputeUniformData, name) \ | |
| ASSIGN_DRIVER_FUNC(DispatchCompute, name) \ | |
| ASSIGN_DRIVER_FUNC(DispatchComputeIndirect, name) \ | |
| ASSIGN_DRIVER_FUNC(EndComputePass, name) \ | |
| ASSIGN_DRIVER_FUNC(MapTransferBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(UnmapTransferBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(BeginCopyPass, name) \ | |
| ASSIGN_DRIVER_FUNC(UploadToTexture, name) \ | |
| ASSIGN_DRIVER_FUNC(UploadToBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(DownloadFromTexture, name) \ | |
| ASSIGN_DRIVER_FUNC(DownloadFromBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(CopyTextureToTexture, name) \ | |
| ASSIGN_DRIVER_FUNC(CopyBufferToBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(GenerateMipmaps, name) \ | |
| ASSIGN_DRIVER_FUNC(EndCopyPass, name) \ | |
| ASSIGN_DRIVER_FUNC(Blit, name) \ | |
| ASSIGN_DRIVER_FUNC(SupportsSwapchainComposition, name) \ | |
| ASSIGN_DRIVER_FUNC(SupportsPresentMode, name) \ | |
| ASSIGN_DRIVER_FUNC(ClaimWindow, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseWindow, name) \ | |
| ASSIGN_DRIVER_FUNC(SetSwapchainParameters, name) \ | |
| ASSIGN_DRIVER_FUNC(SetAllowedFramesInFlight, name) \ | |
| ASSIGN_DRIVER_FUNC(GetSwapchainTextureFormat, name) \ | |
| ASSIGN_DRIVER_FUNC(AcquireCommandBuffer, name) \ | |
| ASSIGN_DRIVER_FUNC(AcquireSwapchainTexture, name) \ | |
| ASSIGN_DRIVER_FUNC(WaitForSwapchain, name) \ | |
| ASSIGN_DRIVER_FUNC(WaitAndAcquireSwapchainTexture, name)\ | |
| ASSIGN_DRIVER_FUNC(Submit, name) \ | |
| ASSIGN_DRIVER_FUNC(SubmitAndAcquireFence, name) \ | |
| ASSIGN_DRIVER_FUNC(Cancel, name) \ | |
| ASSIGN_DRIVER_FUNC(Wait, name) \ | |
| ASSIGN_DRIVER_FUNC(WaitForFences, name) \ | |
| ASSIGN_DRIVER_FUNC(QueryFence, name) \ | |
| ASSIGN_DRIVER_FUNC(ReleaseFence, name) \ | |
| ASSIGN_DRIVER_FUNC(SupportsTextureFormat, name) \ | |
| ASSIGN_DRIVER_FUNC(SupportsSampleCount, name) | |
| typedef struct SDL_GPUBootstrap | |
| { | |
| const char *name; | |
| bool (*PrepareDriver)(SDL_VideoDevice *_this, SDL_PropertiesID props); | |
| SDL_GPUDevice *(*CreateDevice)(bool debug_mode, bool prefer_low_power, SDL_PropertiesID props); | |
| } SDL_GPUBootstrap; | |
| #ifdef __cplusplus | |
| extern "C" { | |
| #endif | |
| extern SDL_GPUBootstrap VulkanDriver; | |
| extern SDL_GPUBootstrap D3D12Driver; | |
| extern SDL_GPUBootstrap MetalDriver; | |
| extern SDL_GPUBootstrap PrivateGPUDriver; | |
| #ifdef __cplusplus | |
| } | |
| #endif | |
| #endif // SDL_GPU_DRIVER_H |