GlTextureCache.h File Reference

#include <cstdint>
#include <deque>
#include <memory>
#include <optional>
#include <string>
#include <unordered_map>
#include <unordered_set>
#include <vector>
#include "glad/glad.h"
#include "donner/base/Box.h"
#include "donner/base/Transform.h"
#include "donner/base/Vector2.h"
#include "donner/editor/AsyncRenderer.h"
#include "donner/editor/FrameCostBreakdown.h"
#include "donner/editor/ImGuiIncludes.h"

Include dependency graph for GlTextureCache.h:

This graph shows which files directly or indirectly include this file:

Classes
struct	donner::editor::CompositedTileTextureIdentity
	Stable identity for deciding whether a metadata-only composited tile can reuse an existing presentation texture. More...
struct	donner::editor::PresentationResourceStats
	Approximate resource footprint retained by the editor presentation texture cache. More...
struct	donner::editor::PresentationCoverageDiagnostics
	Presentation coverage state for composited tile fallback diagnostics. More...
class	donner::editor::GlTextureCache
	Owns the GL textures the advanced editor uses for overlay and composited presentation. More...
struct	donner::editor::GlTextureCache::TileView
	One composite-tile entry as the presenter sees it: the GL texture handle (resolved from the upload cache) plus the geometry fields the presenter needs to blit in paint order. More...

Namespaces
namespace	donner
	Top-level Donner namespace, which is split into different sub-namespaces such as donner::svg and donner::css.

Functions
CompositedTileTextureIdentity	donner::editor::TextureIdentityForCompositedTile (const RenderResult::CompositedTile &tile)
	Return the presentation texture identity carried by tile.
bool	donner::editor::TextureIdentityMatchesCompositedTile (const CompositedTileTextureIdentity &cachedIdentity, const RenderResult::CompositedTile &tile)
	Return true when a metadata-only tile can reuse cachedIdentity.
Vector2i	donner::editor::PowerOfTwoTextureDimensionsForPayload (const Vector2i &payloadDimensions)
	Return the power-of-two backing texture dimensions for a payload.
Vector2d	donner::editor::TextureUvBottomRightForPayload (const Vector2i &payloadDimensions, const Vector2i &allocationDimensions)
	Return the max UV that samples only the payload inside a backing texture.
std::uint64_t	donner::editor::BitmapPayloadBytes (const svg::RendererBitmap &bitmap)
	Return the byte size of a CPU bitmap payload as submitted to the presentation cache.
std::uint64_t	donner::editor::TexturePayloadBytes (const Vector2i &dimensions)
	Return the approximate byte size of a backend texture payload, assuming RGBA8 storage.
FrameCostBreakdown::CompositedUpload	donner::editor::CostForCompositedPreviewUpload (const RenderResult::CompositedPreview &preview)
	Compute upload-cost counters for a composited preview without touching GL/WGPU state.

---

Class Documentation

donner::editor::GlTextureCache::TileView

struct donner::editor::GlTextureCache::TileView

One composite-tile entry as the presenter sees it: the GL texture handle (resolved from the upload cache) plus the geometry fields the presenter needs to blit in paint order.

Collaboration diagram for donner::editor::GlTextureCache::TileView:

Class Members
Vector2d	bitmapDimsDoc = Vector2d::Zero()
Vector2i	bitmapDimsPx = Vector2i::Zero()
Vector2d	canvasOffsetDoc = Vector2d::Zero()
Transform2d	documentFromCachedDocument = Transform2d()
Vector2d	dragTranslationDoc = Vector2d::Zero()
uint64_t	generation = 0
string	id
bool	isDragTarget = false
Kind	kind = RenderResult::CompositedTile::Kind::Segment
Entity	layerEntity = entt::null
bool	metadataOnly = false
Vector2i	rasterCanvasSize = Vector2i::Zero()
ImTextureID	texture = 0
Vector2d	uvBottomRight = Vector2d(1.0, 1.0)

Function Documentation

BitmapPayloadBytes()

std::uint64_t donner::editor::BitmapPayloadBytes ( const svg::RendererBitmap & bitmap )

nodiscard

Return the byte size of a CPU bitmap payload as submitted to the presentation cache.

Parameters

bitmap

CPU renderer bitmap.

CostForCompositedPreviewUpload()

FrameCostBreakdown::CompositedUpload donner::editor::CostForCompositedPreviewUpload ( const RenderResult::CompositedPreview & preview )

nodiscard

Compute upload-cost counters for a composited preview without touching GL/WGPU state.

Parameters

preview

Composited preview to inspect.

PowerOfTwoTextureDimensionsForPayload()

Vector2i donner::editor::PowerOfTwoTextureDimensionsForPayload ( const Vector2i & payloadDimensions )

nodiscard

Return the power-of-two backing texture dimensions for a payload.

Parameters

payloadDimensions

Valid content dimensions in pixels.

TextureIdentityForCompositedTile()

CompositedTileTextureIdentity donner::editor::TextureIdentityForCompositedTile ( const RenderResult::CompositedTile & tile )

nodiscard

Return the presentation texture identity carried by tile.

Parameters

tile	Composited tile whose payload or metadata should be identified.

TextureIdentityMatchesCompositedTile()

bool donner::editor::TextureIdentityMatchesCompositedTile ( const CompositedTileTextureIdentity & cachedIdentity, const RenderResult::CompositedTile & tile )

nodiscard

Return true when a metadata-only tile can reuse cachedIdentity.

Parameters

cachedIdentity	Identity recorded for the currently cached texture.
tile	Incoming composited tile metadata.

TexturePayloadBytes()

std::uint64_t donner::editor::TexturePayloadBytes ( const Vector2i & dimensions )

nodiscard

Return the approximate byte size of a backend texture payload, assuming RGBA8 storage.

Parameters

dimensions

Texture dimensions in pixels.

TextureUvBottomRightForPayload()

Vector2d donner::editor::TextureUvBottomRightForPayload ( const Vector2i & payloadDimensions, const Vector2i & allocationDimensions )

nodiscard

Return the max UV that samples only the payload inside a backing texture.

Parameters

payloadDimensions	Valid content dimensions in pixels.
allocationDimensions	Backing texture allocation dimensions in pixels.