Class GpuResourceManager

java.lang.Object

dev.engine.graphics.common.GpuResourceManager

public class GpuResourceManager
extends Object

Unified GPU resource lifecycle layer.

All GPU resource creation and destruction goes through this manager. Provides:

• Unified tracking of all live resources
• Deferred destruction — resources queued mid-frame are destroyed at frame end
• Cleaner-based safety net — unreachable handles are automatically cleaned by GC
• Leak detection on shutdown
• Resource statistics

Domain managers (MeshManager, TextureManager, etc.) use this instead of RenderDevice directly.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	BUFFER	Well-known resource type keys used by this manager.
static final String	BUFFER_INDEX
static final String	BUFFER_STORAGE
static final String	BUFFER_UNIFORM
static final String	BUFFER_VERTEX
static final String	PIPELINE
static final String	RENDER_TARGET
static final String	SAMPLER
static final String	TEXTURE
static final String	VERTEX_INPUT

Constructor Summary

Constructors

Constructor	Description
GpuResourceManager(RenderDevice device)
GpuResourceManager(RenderDevice device, ResourceStats resourceStats)

Method Summary

Modifier and Type	Method	Description
String	bufferSubType(Handle<BufferResource> buffer)	Returns the resource stats sub-type key for a buffer handle, or BUFFER if unknown.
Handle<BufferResource>	createBuffer(long size, BufferUsage usage, AccessPattern access)
Handle<BufferResource>	createBuffer(BufferDescriptor descriptor)
Handle<PipelineResource>	createPipeline(PipelineDescriptor descriptor)
Handle<RenderTargetResource>	createRenderTarget(RenderTargetDescriptor descriptor)
Handle<SamplerResource>	createSampler(SamplerDescriptor descriptor)
Handle<TextureResource>	createTexture(TextureDescriptor descriptor)
Handle<VertexInputResource>	createVertexInput(VertexFormat format)
void	destroyBuffer(Handle<BufferResource> buffer)
void	destroyPipeline(Handle<PipelineResource> pipeline)
void	destroyRenderTarget(Handle<RenderTargetResource> rt)
void	destroySampler(Handle<SamplerResource> sampler)
void	destroyTexture(Handle<TextureResource> texture)
void	destroyVertexInput(Handle<VertexInputResource> vertexInput)
RenderDevice	device()	Direct device access — escape hatch for operations not covered by this manager.
Handle<TextureResource>	getRenderTargetColorTexture(Handle<RenderTargetResource> rt, int index)
int	liveBufferCount()
int	livePipelineCount()
int	liveRenderTargetCount()
int	liveSamplerCount()
int	liveTextureCount()
int	liveVertexInputCount()
void	processDeferred()	Processes the deferred deletion queue.
ResourceStats	resourceStats()	Returns the ResourceStats instance tracking all resource lifecycle operations.
void	shutdown()	Reports any leaked resources and destroys everything immediately.
int	totalLiveResources()
void	uploadTexture(Handle<TextureResource> texture, ByteBuffer pixels)
BufferWriter	writeBuffer(Handle<BufferResource> buffer)
BufferWriter	writeBuffer(Handle<BufferResource> buffer, long offset, long length)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

BUFFER

public static final String BUFFER

Well-known resource type keys used by this manager.

See Also:

• Constant Field Values

BUFFER_VERTEX

public static final String BUFFER_VERTEX

See Also:

• Constant Field Values

BUFFER_INDEX

public static final String BUFFER_INDEX

See Also:

• Constant Field Values

BUFFER_UNIFORM

public static final String BUFFER_UNIFORM

See Also:

• Constant Field Values

BUFFER_STORAGE

public static final String BUFFER_STORAGE

See Also:

• Constant Field Values

TEXTURE

public static final String TEXTURE

See Also:

• Constant Field Values

RENDER_TARGET

public static final String RENDER_TARGET

See Also:

• Constant Field Values

PIPELINE

public static final String PIPELINE

See Also:

• Constant Field Values

SAMPLER

public static final String SAMPLER

See Also:

• Constant Field Values

VERTEX_INPUT

public static final String VERTEX_INPUT

See Also:

• Constant Field Values

Constructor Details

GpuResourceManager

public GpuResourceManager(RenderDevice device)

GpuResourceManager

public GpuResourceManager(RenderDevice device,
 ResourceStats resourceStats)

Method Details

createBuffer

public Handle<BufferResource> createBuffer(BufferDescriptor descriptor)

createBuffer

public Handle<BufferResource> createBuffer(long size,
 BufferUsage usage,
 AccessPattern access)

writeBuffer

public BufferWriter writeBuffer(Handle<BufferResource> buffer)

writeBuffer

public BufferWriter writeBuffer(Handle<BufferResource> buffer,
 long offset,
 long length)

destroyBuffer

public void destroyBuffer(Handle<BufferResource> buffer)

createTexture

public Handle<TextureResource> createTexture(TextureDescriptor descriptor)

uploadTexture

public void uploadTexture(Handle<TextureResource> texture,
 ByteBuffer pixels)

destroyTexture

public void destroyTexture(Handle<TextureResource> texture)

createRenderTarget

public Handle<RenderTargetResource> createRenderTarget(RenderTargetDescriptor descriptor)

getRenderTargetColorTexture

public Handle<TextureResource> getRenderTargetColorTexture(Handle<RenderTargetResource> rt,
 int index)

destroyRenderTarget

public void destroyRenderTarget(Handle<RenderTargetResource> rt)

createPipeline

public Handle<PipelineResource> createPipeline(PipelineDescriptor descriptor)

destroyPipeline

public void destroyPipeline(Handle<PipelineResource> pipeline)

createSampler

public Handle<SamplerResource> createSampler(SamplerDescriptor descriptor)

destroySampler

public void destroySampler(Handle<SamplerResource> sampler)

createVertexInput

public Handle<VertexInputResource> createVertexInput(VertexFormat format)

destroyVertexInput

public void destroyVertexInput(Handle<VertexInputResource> vertexInput)

processDeferred

public void processDeferred()

Processes the deferred deletion queue. Call once per frame after GPU submission is complete (after endFrame).

Resources are deferred through a ring of queues sized to match the device's frames-in-flight count. A resource queued in frame N is deleted after framesInFlight + 1 calls to processDeferred(), ensuring all in-flight GPU frames have finished using it.

resourceStats

public ResourceStats resourceStats()

Returns the ResourceStats instance tracking all resource lifecycle operations.

liveBufferCount

public int liveBufferCount()

liveTextureCount

public int liveTextureCount()

liveRenderTargetCount

public int liveRenderTargetCount()

livePipelineCount

public int livePipelineCount()

liveSamplerCount

public int liveSamplerCount()

liveVertexInputCount

public int liveVertexInputCount()

totalLiveResources

public int totalLiveResources()

shutdown

public void shutdown()

Reports any leaked resources and destroys everything immediately. Call during engine shutdown.

bufferSubType

public String bufferSubType(Handle<BufferResource> buffer)

Returns the resource stats sub-type key for a buffer handle, or BUFFER if unknown.

device

public RenderDevice device()

Direct device access — escape hatch for operations not covered by this manager.