backend_sdl3gpu.c File Reference

#include "backend_sdl3gpu_private.h"
#include "graphics_private.h"
#include <dttr_log.h>
#include <dttr_config.h>
#include <math.h>
#include <stdlib.h>
#include <string.h>

Go to the source code of this file.

Data Structures
struct	graphics_pending_upload
struct	graphics_replay_stats
struct	graphics_replay_state

Macros
#define	DRIVER_DISPLAY_VULKAN   "Vulkan"
#define	DRIVER_DISPLAY_DIRECT3D12   "Direct3D 12"

Functions
static void	cleanup (DTTR_BackendState *state)
static SDL_GPUSampleCount	msaa_sample_count_from_config (int value)
static int	msaa_sample_count_to_int (SDL_GPUSampleCount value)
static SDL_GPUSampleCount	select_msaa_sample_count (DTTR_BackendState *state)
static void	destroy_device (DTTR_BackendState *state)
static void	release_window_device (DTTR_BackendState *state)
static bool	try_create_device_for_driver (DTTR_BackendState *state, const SDL_GPUShaderFormat requested_formats, const char *driver)
static const char *	graphics_api_driver_name (DTTR_GraphicsApi api)
static bool	create_device (DTTR_BackendState *state)
bool	dttr_graphics_sdl3gpu_init (DTTR_BackendState *state)
static bool	msaa_enabled (const DTTR_BackendState *state)
static SDL_GPUTransferBuffer *	create_upload_buffer (DTTR_BackendState *state, uint32_t bytes)
static void	release_upload_pool_slot (DTTR_BackendState *state, int pool_slot)
static int	acquire_upload_pool_slot (DTTR_BackendState *state, uint32_t bytes)
static void	bind_frame_vertex_buffer (const DTTR_BackendState *state, SDL_GPURenderPass *render_pass)
static void	end_render_pass_if_active (DTTR_BackendState *state)
static void	release_deferred_texture_destroys (DTTR_BackendState *state)
static void	defer_texture_destroy (DTTR_BackendState *state, int texture_index)
static bool	upload_texture_data (DTTR_BackendState *state, SDL_GPUCopyPass *copy, SDL_GPUTexture *tex, void *pixels, int width, int height, uint32_t bytes)
static int	collect_and_upload_pending (DTTR_BackendState *state, SDL_GPUCopyPass *copy, graphics_pending_upload *pending_uploads, int max_uploads)
static void	generate_pending_mipmaps (DTTR_BackendState *state, SDL_GPUCommandBuffer *cmd, const graphics_pending_upload *pending, int pending_count, uint32_t *uploaded_texture_count, uint64_t *uploaded_bytes)
static void	upload_pending_textures (DTTR_BackendState *state, SDL_GPUCommandBuffer *cmd)
static void	set_default_viewport (const DTTR_BackendState *state)
static bool	begin_draw_pass_if_needed (DTTR_BackendState *state)
static void	reset_replay_state (graphics_replay_state *replay_state)
static void	begin_clear_pass (DTTR_BackendState *state, const DTTR_BatchRecord *rec, graphics_replay_state *replay_state)
static void	draw_batch_record (DTTR_BackendState *state, const DTTR_BatchRecord *rec, graphics_replay_state *replay_state, graphics_replay_stats *replay_stats)
static graphics_replay_stats	replay_batch_records (DTTR_BackendState *state)
static void	begin_frame (DTTR_BackendState *state)
static void	end_frame (DTTR_BackendState *state)
static bool	ensure_video_texture (DTTR_BackendState *state, int width, int height)
static bool	present_video_frame_bgra (DTTR_BackendState *state, const uint8_t *pixels, int width, int height, int stride)
static bool	resize (DTTR_BackendState *state, int width, int height)
static const char *	driver_display_name (const char *driver)
static const char *	get_driver_name (const DTTR_BackendState *state)

Variables
static const DTTR_RendererVtbl	renderer

Macro Definition Documentation

DRIVER_DISPLAY_DIRECT3D12

#define DRIVER_DISPLAY_DIRECT3D12   "Direct3D 12"

Definition at line 9 of file backend_sdl3gpu.c.

Referenced by driver_display_name().

DRIVER_DISPLAY_VULKAN

#define DRIVER_DISPLAY_VULKAN   "Vulkan"

Definition at line 8 of file backend_sdl3gpu.c.

Referenced by driver_display_name().

Function Documentation

acquire_upload_pool_slot()

int acquire_upload_pool_slot ( DTTR_BackendState * state, uint32_t bytes )

static

Definition at line 368 of file backend_sdl3gpu.c.

References DTTR_UploadPoolSlot::capacity, create_upload_buffer(), DTTR_UPLOAD_POOL_SIZE, DTTR_UploadPoolSlot::in_use, NULL, state, and DTTR_UploadPoolSlot::transfer_buffer.

Referenced by upload_texture_data().

begin_clear_pass()

void begin_clear_pass ( DTTR_BackendState * state, const DTTR_BatchRecord * rec, graphics_replay_state * replay_state )

static

Definition at line 803 of file backend_sdl3gpu.c.

References bind_frame_vertex_buffer(), DTTR_BatchRecord::clear, DTTR_BatchRecord::color, DTTR_BatchRecord::depth, DTTR_CLEAR_COLOR, DTTR_CLEAR_DEPTH, end_render_pass_if_active(), DTTR_BatchRecord::flags, msaa_enabled(), NULL, reset_replay_state(), set_default_viewport(), and state.

Referenced by replay_batch_records().

begin_draw_pass_if_needed()

bool begin_draw_pass_if_needed ( DTTR_BackendState * state )

static

Definition at line 753 of file backend_sdl3gpu.c.

References bind_frame_vertex_buffer(), DTTR_LOG_WARN, msaa_enabled(), NULL, set_default_viewport(), and state.

Referenced by draw_batch_record().

begin_frame()

void begin_frame ( DTTR_BackendState * state )

static

Definition at line 950 of file backend_sdl3gpu.c.

References dttr_graphics_is_gpu_thread(), dttr_graphics_mod_frame_begin(), DTTR_LOG_ERROR, DTTR_LOG_WARN, NULL, release_deferred_texture_destroys(), state, and upload_pending_textures().

bind_frame_vertex_buffer()

void bind_frame_vertex_buffer ( const DTTR_BackendState * state, SDL_GPURenderPass * render_pass )

static

Definition at line 423 of file backend_sdl3gpu.c.

References state.

Referenced by begin_clear_pass(), and begin_draw_pass_if_needed().

cleanup()

void cleanup ( DTTR_BackendState * state )

static

Definition at line 264 of file backend_sdl3gpu.c.

References DTTR_UploadPoolSlot::capacity, DTTR_PIPELINE_COUNT, DTTR_SAMPLER_COUNT, DTTR_UPLOAD_POOL_SIZE, free, DTTR_UploadPoolSlot::in_use, NULL, release_window_device(), state, and DTTR_UploadPoolSlot::transfer_buffer.

Referenced by dttr_graphics_sdl3gpu_init().

collect_and_upload_pending()

int collect_and_upload_pending ( DTTR_BackendState * state, SDL_GPUCopyPass * copy, graphics_pending_upload * pending_uploads, int max_uploads )

static

Definition at line 556 of file backend_sdl3gpu.c.

References dttr_config, dttr_graphics_ensure_staged_texture(), DTTR_MAX_STAGED_TEXTURES, free, NULL, st, state, and upload_texture_data().

Referenced by upload_pending_textures().

create_device()

bool create_device ( DTTR_BackendState * state )

static

Definition at line 187 of file backend_sdl3gpu.c.

References dttr_config, DTTR_DRIVER_DIRECT3D12, DTTR_DRIVER_VULKAN, dttr_graphics_requested_shader_formats(), DTTR_LOG_ERROR, graphics_api_driver_name(), NULL, state, and try_create_device_for_driver().

Referenced by dttr_graphics_sdl3gpu_init().

create_upload_buffer()

SDL_GPUTransferBuffer * create_upload_buffer ( DTTR_BackendState * state, uint32_t bytes )

static

Definition at line 347 of file backend_sdl3gpu.c.

References state.

Referenced by acquire_upload_pool_slot(), present_video_frame_bgra(), and upload_texture_data().

defer_texture_destroy()

void defer_texture_destroy ( DTTR_BackendState * state, int texture_index )

static

Definition at line 465 of file backend_sdl3gpu.c.

References sdl3_gpu_backend_data::deferred_destroy_count, sdl3_gpu_backend_data::deferred_destroys, DTTR_MAX_STAGED_TEXTURES, st, and state.

destroy_device()

void destroy_device ( DTTR_BackendState * state )

static

Definition at line 85 of file backend_sdl3gpu.c.

References NULL, and state.

Referenced by release_window_device(), and try_create_device_for_driver().

draw_batch_record()

void draw_batch_record ( DTTR_BackendState * state, const DTTR_BatchRecord * rec, graphics_replay_state * replay_state, graphics_replay_stats * replay_stats )

static

Definition at line 842 of file backend_sdl3gpu.c.

References begin_draw_pass_if_needed(), DTTR_BatchRecord::blend_mode, DTTR_BatchRecord::depth_test, DTTR_BatchRecord::depth_write, DTTR_BatchRecord::draw, graphics_replay_stats::draw_count, DTTR_PIPELINE_INDEX, DTTR_BatchRecord::first_vertex, graphics_replay_state::last_pipeline_idx, graphics_replay_state::last_sampler, graphics_replay_state::last_texture, graphics_replay_stats::pipeline_bind_count, reset_replay_state(), DTTR_BatchRecord::sampler, graphics_replay_stats::sampler_bind_count, state, DTTR_BatchRecord::texture, DTTR_BatchRecord::uniforms, and DTTR_BatchRecord::vertex_count.

Referenced by replay_batch_records().

driver_display_name()

const char * driver_display_name ( const char * driver )

static

Definition at line 1298 of file backend_sdl3gpu.c.

References DRIVER_DISPLAY_DIRECT3D12, DRIVER_DISPLAY_VULKAN, DTTR_DRIVER_DIRECT3D12, and DTTR_DRIVER_VULKAN.

Referenced by get_driver_name().

dttr_graphics_sdl3gpu_init()

bool dttr_graphics_sdl3gpu_init

(

DTTR_BackendState *

state

)

Definition at line 224 of file backend_sdl3gpu.c.

References cleanup(), create_device(), DTTR_BACKEND_SDL_GPU, dttr_config, dttr_graphics_sdl3gpu_create_pipelines(), dttr_graphics_sdl3gpu_create_resources(), dttr_graphics_shader_format_name(), DTTR_LOG_ERROR, DTTR_LOG_INFO, msaa_sample_count_to_int(), NULL, release_window_device(), renderer, select_msaa_sample_count(), and state.

end_frame()

void end_frame ( DTTR_BackendState * state )

static

Definition at line 1006 of file backend_sdl3gpu.c.

References graphics_replay_stats::clear_count, graphics_replay_stats::draw_count, dst, dttr_config, dttr_graphics_compute_present_rect(), dttr_graphics_mod_after_game_frame(), dttr_graphics_mod_before_game_frame(), dttr_graphics_mod_frame_end(), dttr_graphics_mod_present_rect_after(), dttr_graphics_mod_present_rect_before(), dttr_imgui_render_game_sdl3gpu(), dttr_imgui_render_sdl3gpu(), DTTR_SCALING_METHOD_LOGICAL, DTTR_SCALING_MODE_INTEGER, DTTR_SCALING_MODE_STRETCH, DTTR_VERTEX_SIZE, DTTR_PresentRect::h, NULL, graphics_replay_stats::pipeline_bind_count, replay_batch_records(), graphics_replay_stats::sampler_bind_count, src, state, DTTR_PresentRect::w, DTTR_PresentRect::x, and DTTR_PresentRect::y.

end_render_pass_if_active()

void end_render_pass_if_active ( DTTR_BackendState * state )

static

Definition at line 438 of file backend_sdl3gpu.c.

References NULL, and state.

Referenced by begin_clear_pass(), and replay_batch_records().

ensure_video_texture()

bool ensure_video_texture ( DTTR_BackendState * state, int width, int height )

static

Definition at line 1130 of file backend_sdl3gpu.c.

References NULL, and state.

Referenced by present_video_frame_bgra().

generate_pending_mipmaps()

void generate_pending_mipmaps ( DTTR_BackendState * state, SDL_GPUCommandBuffer * cmd, const graphics_pending_upload * pending, int pending_count, uint32_t * uploaded_texture_count, uint64_t * uploaded_bytes )

static

Definition at line 661 of file backend_sdl3gpu.c.

References graphics_pending_upload::bytes, and state.

Referenced by upload_pending_textures().

get_driver_name()

const char * get_driver_name ( const DTTR_BackendState * state )

static

Definition at line 1310 of file backend_sdl3gpu.c.

References driver_display_name(), and state.

graphics_api_driver_name()

const char * graphics_api_driver_name ( DTTR_GraphicsApi api )

static

Definition at line 175 of file backend_sdl3gpu.c.

References DTTR_DRIVER_DIRECT3D12, DTTR_DRIVER_VULKAN, DTTR_GRAPHICS_API_DIRECT3D12, DTTR_GRAPHICS_API_VULKAN, and NULL.

Referenced by create_device().

msaa_enabled()

bool msaa_enabled ( const DTTR_BackendState * state )

static

Definition at line 342 of file backend_sdl3gpu.c.

References NULL, and state.

Referenced by begin_clear_pass(), and begin_draw_pass_if_needed().

msaa_sample_count_from_config()

SDL_GPUSampleCount msaa_sample_count_from_config ( int value )

static

Definition at line 23 of file backend_sdl3gpu.c.

Referenced by select_msaa_sample_count().

msaa_sample_count_to_int()

int msaa_sample_count_to_int ( SDL_GPUSampleCount value )

static

Definition at line 36 of file backend_sdl3gpu.c.

Referenced by dttr_graphics_sdl3gpu_init(), and select_msaa_sample_count().

present_video_frame_bgra()

bool present_video_frame_bgra ( DTTR_BackendState * state, const uint8_t * pixels, int width, int height, int stride )

static

Definition at line 1165 of file backend_sdl3gpu.c.

References create_upload_buffer(), dst, dttr_config, dttr_graphics_compute_present_rect(), dttr_graphics_is_gpu_thread(), ensure_video_texture(), DTTR_PresentRect::h, h, NULL, src, state, stride, DTTR_PresentRect::w, DTTR_PresentRect::x, and DTTR_PresentRect::y.

release_deferred_texture_destroys()

void release_deferred_texture_destroys ( DTTR_BackendState * state )

static

Definition at line 448 of file backend_sdl3gpu.c.

References sdl3_gpu_backend_data::deferred_destroy_count, sdl3_gpu_backend_data::deferred_destroys, and state.

Referenced by begin_frame().

release_upload_pool_slot()

void release_upload_pool_slot ( DTTR_BackendState * state, int pool_slot )

static

Definition at line 359 of file backend_sdl3gpu.c.

References DTTR_UPLOAD_POOL_SIZE, and state.

Referenced by upload_texture_data().

release_window_device()

void release_window_device ( DTTR_BackendState * state )

static

Definition at line 94 of file backend_sdl3gpu.c.

References destroy_device(), and state.

Referenced by cleanup(), dttr_graphics_sdl3gpu_init(), and try_create_device_for_driver().

replay_batch_records()

graphics_replay_stats replay_batch_records ( DTTR_BackendState * state )

static

Definition at line 922 of file backend_sdl3gpu.c.

References begin_clear_pass(), graphics_replay_stats::clear_count, draw_batch_record(), DTTR_BATCH_CLEAR, end_render_pass_if_active(), NULL, reset_replay_state(), state, and DTTR_BatchRecord::type.

Referenced by end_frame().

reset_replay_state()

void reset_replay_state ( graphics_replay_state * replay_state )

static

Definition at line 791 of file backend_sdl3gpu.c.

References graphics_replay_state::last_pipeline_idx, graphics_replay_state::last_sampler, graphics_replay_state::last_texture, and NULL.

Referenced by begin_clear_pass(), draw_batch_record(), and replay_batch_records().

resize()

bool resize ( DTTR_BackendState * state, int width, int height )

static

Definition at line 1293 of file backend_sdl3gpu.c.

References dttr_graphics_sdl3gpu_resize_render_textures(), and state.

select_msaa_sample_count()

SDL_GPUSampleCount select_msaa_sample_count ( DTTR_BackendState * state )

static

Definition at line 50 of file backend_sdl3gpu.c.

References dttr_config, DTTR_LOG_WARN, msaa_sample_count_from_config(), msaa_sample_count_to_int(), and state.

Referenced by dttr_graphics_sdl3gpu_init().

set_default_viewport()

void set_default_viewport ( const DTTR_BackendState * state )

static

Definition at line 725 of file backend_sdl3gpu.c.

References float, and state.

Referenced by begin_clear_pass(), and begin_draw_pass_if_needed().

try_create_device_for_driver()

bool try_create_device_for_driver ( DTTR_BackendState * state, const SDL_GPUShaderFormat requested_formats, const char * driver )

static

Definition at line 104 of file backend_sdl3gpu.c.

References destroy_device(), dttr_graphics_select_shader_format_for_driver(), DTTR_LOG_ERROR, DTTR_LOG_WARN, release_window_device(), and state.

Referenced by create_device().

upload_pending_textures()

void upload_pending_textures ( DTTR_BackendState * state, SDL_GPUCommandBuffer * cmd )

static

Definition at line 692 of file backend_sdl3gpu.c.

References collect_and_upload_pending(), DTTR_MAX_STAGED_TEXTURES, generate_pending_mipmaps(), and state.

Referenced by begin_frame().

upload_texture_data()

bool upload_texture_data ( DTTR_BackendState * state, SDL_GPUCopyPass * copy, SDL_GPUTexture * tex, void * pixels, int width, int height, uint32_t bytes )

static

Definition at line 480 of file backend_sdl3gpu.c.

References acquire_upload_pool_slot(), create_upload_buffer(), dst, dttr_config, free, h, NULL, release_upload_pool_slot(), src, and state.

Referenced by collect_and_upload_pending().

Variable Documentation

renderer

const DTTR_RendererVtbl renderer

static

Initial value:

                                        = {
    .begin_frame = begin_frame,
    .end_frame = end_frame,
    .present_video_frame_bgra = present_video_frame_bgra,
    .resize = resize,
    .cleanup = cleanup,
    .get_driver_name = get_driver_name,
    .defer_texture_destroy = defer_texture_destroy,
}

Definition at line 20 of file backend_sdl3gpu.c.