Atlas-based rendering system for efficient graphics operations. More...

#include <atlas_renderer.h>

Collaboration diagram for yaze::gfx::AtlasRenderer:

Classes
struct	Atlas

struct	AtlasEntry

Public Member Functions
void	Initialize (IRenderer *renderer, int initial_size=1024)
	Initialize the atlas renderer.

int	AddBitmap (const Bitmap &bitmap)
	Add a bitmap to the atlas.

int	AddBitmapWithBppOptimization (const Bitmap &bitmap, BppFormat target_bpp)
	Add a bitmap to the atlas with BPP format optimization.

void	RemoveBitmap (int atlas_id)
	Remove a bitmap from the atlas.

void	UpdateBitmap (int atlas_id, const Bitmap &bitmap)
	Update a bitmap in the atlas.

void	RenderBatch (const std::vector< RenderCommand > &render_commands)
	Render multiple bitmaps in a single draw call.

void	RenderBatchWithBppOptimization (const std::vector< RenderCommand > &render_commands, const std::unordered_map< BppFormat, std::vector< int > > &bpp_groups)
	Render multiple bitmaps with BPP-aware batching.

AtlasStats	GetStats () const
	Get atlas statistics.

void	Defragment ()
	Defragment the atlas to reclaim space.

void	Clear ()
	Clear all atlases.

void	RenderBitmap (int atlas_id, float x, float y, float scale_x=1.0f, float scale_y=1.0f)
	Render a single bitmap using atlas (convenience method)

SDL_Rect	GetUVCoordinates (int atlas_id) const
	Get UV coordinates for a bitmap in the atlas.

Static Public Member Functions
static AtlasRenderer &	Get ()

Private Member Functions
	AtlasRenderer ()=default

	~AtlasRenderer ()

bool	PackBitmap (Atlas &atlas, const Bitmap &bitmap, SDL_Rect &uv_rect)

void	CreateNewAtlas ()

void	RebuildAtlas (Atlas &atlas)

SDL_Rect	FindFreeRegion (Atlas &atlas, int width, int height)

void	MarkRegionUsed (Atlas &atlas, const SDL_Rect &rect, bool used)

Private Attributes
IRenderer *	renderer_

std::vector< std::unique_ptr< Atlas > >	atlases_

std::unordered_map< int, AtlasEntry * >	atlas_lookup_

int	next_atlas_id_

int	current_atlas_

Detailed Description

Atlas-based rendering system for efficient graphics operations.

The AtlasRenderer class provides efficient rendering by combining multiple graphics elements into a single texture atlas, reducing draw calls and improving performance for ROM hacking workflows.

Key Features:

Single draw call for multiple tiles/graphics
Automatic atlas management and packing
Dynamic atlas resizing and reorganization
UV coordinate mapping for efficient rendering
Memory-efficient texture management

Performance Optimizations:

Reduces draw calls from N to 1 for multiple elements
Minimizes GPU state changes
Efficient texture packing algorithm
Automatic atlas defragmentation

ROM Hacking Specific:

Optimized for SNES tile rendering (8x8, 16x16)
Support for graphics sheet atlasing
Efficient palette management across atlas
Tile-based UV coordinate system

Definition at line 74 of file atlas_renderer.h.

Constructor & Destructor Documentation

◆ AtlasRenderer()

yaze::gfx::AtlasRenderer::AtlasRenderer ( )

privatedefault

◆ ~AtlasRenderer()

yaze::gfx::AtlasRenderer::~AtlasRenderer ( )

private

Definition at line 314 of file atlas_renderer.cc.

References Clear().

Here is the call graph for this function:

Member Function Documentation

◆ Get()

AtlasRenderer & yaze::gfx::AtlasRenderer::Get ( )

static

Definition at line 10 of file atlas_renderer.cc.

Referenced by yaze::gfx::PerformanceDashboard::RenderMemoryUsage(), yaze::gfx::RenderTilesBatch(), yaze::gfx::TEST_F(), and yaze::gfx::TEST_F().

◆ Initialize()

void yaze::gfx::AtlasRenderer::Initialize	(	IRenderer *	renderer,
		int	initial_size = `1024`
	)

Initialize the atlas renderer.

Parameters

renderer	The renderer to use for texture operations
initial_size	Initial atlas size (power of 2 recommended)

Definition at line 15 of file atlas_renderer.cc.

References Clear(), CreateNewAtlas(), current_atlas_, next_atlas_id_, and renderer_.

Here is the call graph for this function:

◆ AddBitmap()

int yaze::gfx::AtlasRenderer::AddBitmap ( const Bitmap & bitmap )

Add a bitmap to the atlas.

Parameters

bitmap Bitmap to add to atlas

Returns: Atlas ID for referencing this bitmap

Definition at line 27 of file atlas_renderer.cc.

References atlas_lookup_, atlases_, CreateNewAtlas(), current_atlas_, yaze::gfx::BppFormatManager::DetectFormat(), yaze::gfx::BppFormatManager::Get(), yaze::gfx::Bitmap::height(), yaze::gfx::Bitmap::is_active(), next_atlas_id_, PackBitmap(), yaze::gfx::IRenderer::RenderCopy(), renderer_, yaze::gfx::IRenderer::SetRenderTarget(), yaze::gfx::Bitmap::texture(), yaze::gfx::Bitmap::vector(), and yaze::gfx::Bitmap::width().

Referenced by AddBitmapWithBppOptimization(), and UpdateBitmap().

◆ AddBitmapWithBppOptimization()

int yaze::gfx::AtlasRenderer::AddBitmapWithBppOptimization	(	const Bitmap &	bitmap,
		BppFormat	target_bpp
	)

Add a bitmap to the atlas with BPP format optimization.

Parameters

bitmap	Bitmap to add to atlas
target_bpp	Target BPP format for optimization

Returns: Atlas ID for referencing this bitmap

Definition at line 69 of file atlas_renderer.cc.

References AddBitmap(), yaze::gfx::BppFormatManager::ConvertFormat(), yaze::gfx::Bitmap::CreateTexture(), yaze::gfx::Bitmap::depth(), yaze::gfx::BppFormatManager::DetectFormat(), yaze::gfx::BppFormatManager::Get(), yaze::gfx::Bitmap::height(), yaze::gfx::Bitmap::is_active(), yaze::gfx::Bitmap::palette(), yaze::gfx::Bitmap::texture(), yaze::gfx::Bitmap::vector(), and yaze::gfx::Bitmap::width().

◆ RemoveBitmap()

void yaze::gfx::AtlasRenderer::RemoveBitmap ( int atlas_id )

Remove a bitmap from the atlas.

Parameters

atlas_id Atlas ID of bitmap to remove

Definition at line 96 of file atlas_renderer.cc.

References atlas_lookup_, atlases_, yaze::gfx::AtlasRenderer::AtlasEntry::in_use, and MarkRegionUsed().

Referenced by UpdateBitmap().

Here is the call graph for this function:

◆ UpdateBitmap()

void yaze::gfx::AtlasRenderer::UpdateBitmap	(	int	atlas_id,
		const Bitmap &	bitmap
	)

Update a bitmap in the atlas.

Parameters

atlas_id	Atlas ID of bitmap to update
bitmap	New bitmap data

Definition at line 118 of file atlas_renderer.cc.

References AddBitmap(), atlas_lookup_, yaze::gfx::Bitmap::height(), RemoveBitmap(), yaze::gfx::AtlasRenderer::AtlasEntry::texture, yaze::gfx::Bitmap::texture(), yaze::gfx::AtlasRenderer::AtlasEntry::uv_rect, and yaze::gfx::Bitmap::width().

◆ RenderBatch()

void yaze::gfx::AtlasRenderer::RenderBatch ( const std::vector< RenderCommand > & render_commands )

Render multiple bitmaps in a single draw call.

Parameters

render_commands Vector of render commands (atlas_id, x, y, scale)

Definition at line 135 of file atlas_renderer.cc.

References atlas_lookup_, atlases_, yaze::gfx::IRenderer::RenderCopy(), renderer_, and yaze::gfx::AtlasRenderer::AtlasEntry::uv_rect.

Here is the call graph for this function:

◆ RenderBatchWithBppOptimization()

void yaze::gfx::AtlasRenderer::RenderBatchWithBppOptimization	(	const std::vector< RenderCommand > &	render_commands,
		const std::unordered_map< BppFormat, std::vector< int > > &	bpp_groups
	)