Class WgpuRenderDevice

java.lang.Object

dev.engine.graphics.webgpu.WgpuRenderDevice

All Implemented Interfaces:

RenderDevice, AutoCloseable

public class WgpuRenderDevice
extends Object
implements RenderDevice

WebGPU render device backed by WgpuBindings.

Takes a WindowHandle (from GLFW toolkit) and creates an offscreen rendering context. All rendering goes to an offscreen render target, which supports readback via readFramebuffer(int, int).

Architecture

• Setup: Instance -> Adapter -> Device -> Queue (no surface)
• Per-frame: CommandEncoder -> RenderPassEncoder -> CommandBuffer -> Queue.submit()
• Bind groups created on-demand per draw call with currently bound resources
• Pipeline layout created explicitly from WGSL binding reflection

Constructor Summary

Constructors

Constructor	Description
WgpuRenderDevice(WindowHandle window, WgpuBindings gpu)
WgpuRenderDevice(WindowHandle window, WgpuBindings gpu, boolean presentToSurface)
WgpuRenderDevice(WindowHandle window, WgpuBindings gpu, boolean presentToSurface, GraphicsConfig config)

Method Summary

Modifier and Type	Method	Description
void	beginFrame()
void	close()
Handle<BufferResource>	createBuffer(BufferDescriptor descriptor)
GpuFence	createFence()
Handle<PipelineResource>	createPipeline(PipelineDescriptor descriptor)
Handle<RenderTargetResource>	createRenderTarget(RenderTargetDescriptor descriptor)
Handle<SamplerResource>	createSampler(SamplerDescriptor descriptor)
StreamingBuffer	createStreamingBuffer(long frameSize, int frameCount, BufferUsage usage)
Handle<TextureResource>	createTexture(TextureDescriptor descriptor)
Handle<VertexInputResource>	createVertexInput(VertexFormat format)
void	destroyBuffer(Handle<BufferResource> buffer)
void	destroyPipeline(Handle<PipelineResource> pipeline)
void	destroyRenderTarget(Handle<RenderTargetResource> renderTarget)
void	destroySampler(Handle<SamplerResource> sampler)
void	destroyTexture(Handle<TextureResource> texture)
void	destroyVertexInput(Handle<VertexInputResource> vertexInput)
void	endFrame()
long	getBindlessTextureHandle(Handle<TextureResource> texture)
Handle<TextureResource>	getRenderTargetColorTexture(Handle<RenderTargetResource> renderTarget, int index)
boolean	isValidBuffer(Handle<BufferResource> buffer)
boolean	isValidPipeline(Handle<PipelineResource> pipeline)
boolean	isValidTexture(Handle<TextureResource> texture)
<T> T	queryCapability(DeviceCapability<T> capability)
byte[]	readFramebuffer(int width, int height)	Reads back the current framebuffer as RGBA8 byte array.
void	setCanvasTextureView(long textureView)	Sets a canvas texture view to use as the color attachment for the default render target.
void	submit(CommandList commands)
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

Methods inherited from interface RenderDevice

createComputePipeline, getTextureIndex, supports

Constructor Details

WgpuRenderDevice

public WgpuRenderDevice(WindowHandle window,
 WgpuBindings gpu)

WgpuRenderDevice

public WgpuRenderDevice(WindowHandle window,
 WgpuBindings gpu,
 boolean presentToSurface)

WgpuRenderDevice

public WgpuRenderDevice(WindowHandle window,
 WgpuBindings gpu,
 boolean presentToSurface,
 GraphicsConfig config)

Method Details

createBuffer

public Handle<BufferResource> createBuffer(BufferDescriptor descriptor)

Specified by:

createBuffer in interface RenderDevice

destroyBuffer

public void destroyBuffer(Handle<BufferResource> buffer)

Specified by:

destroyBuffer in interface RenderDevice

isValidBuffer

public boolean isValidBuffer(Handle<BufferResource> buffer)

Specified by:

isValidBuffer in interface RenderDevice

writeBuffer

public BufferWriter writeBuffer(Handle<BufferResource> buffer)

Specified by:

writeBuffer in interface RenderDevice

writeBuffer

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

Specified by:

writeBuffer in interface RenderDevice

createTexture

public Handle<TextureResource> createTexture(TextureDescriptor descriptor)

Specified by:

createTexture in interface RenderDevice

uploadTexture

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

Specified by:

uploadTexture in interface RenderDevice

destroyTexture

public void destroyTexture(Handle<TextureResource> texture)

Specified by:

destroyTexture in interface RenderDevice

isValidTexture

public boolean isValidTexture(Handle<TextureResource> texture)

Specified by:

isValidTexture in interface RenderDevice

getBindlessTextureHandle

public long getBindlessTextureHandle(Handle<TextureResource> texture)

Specified by:

getBindlessTextureHandle in interface RenderDevice

createRenderTarget

public Handle<RenderTargetResource> createRenderTarget(RenderTargetDescriptor descriptor)

Specified by:

createRenderTarget in interface RenderDevice

getRenderTargetColorTexture

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

Specified by:

getRenderTargetColorTexture in interface RenderDevice

destroyRenderTarget

public void destroyRenderTarget(Handle<RenderTargetResource> renderTarget)

Specified by:

destroyRenderTarget in interface RenderDevice

createVertexInput

public Handle<VertexInputResource> createVertexInput(VertexFormat format)

Specified by:

createVertexInput in interface RenderDevice

destroyVertexInput

public void destroyVertexInput(Handle<VertexInputResource> vertexInput)

Specified by:

destroyVertexInput in interface RenderDevice

createSampler

public Handle<SamplerResource> createSampler(SamplerDescriptor descriptor)

Specified by:

createSampler in interface RenderDevice

destroySampler

public void destroySampler(Handle<SamplerResource> sampler)

Specified by:

destroySampler in interface RenderDevice

createPipeline

public Handle<PipelineResource> createPipeline(PipelineDescriptor descriptor)

Specified by:

createPipeline in interface RenderDevice

destroyPipeline

public void destroyPipeline(Handle<PipelineResource> pipeline)

Specified by:

destroyPipeline in interface RenderDevice

isValidPipeline

public boolean isValidPipeline(Handle<PipelineResource> pipeline)

Specified by:

isValidPipeline in interface RenderDevice

createStreamingBuffer

public StreamingBuffer createStreamingBuffer(long frameSize,
 int frameCount,
 BufferUsage usage)

Specified by:

createStreamingBuffer in interface RenderDevice

createFence

public GpuFence createFence()

Specified by:

createFence in interface RenderDevice

beginFrame

public void beginFrame()

Specified by:

beginFrame in interface RenderDevice

endFrame

public void endFrame()

Specified by:

endFrame in interface RenderDevice

submit

public void submit(CommandList commands)

Specified by:

submit in interface RenderDevice

readFramebuffer

public byte[] readFramebuffer(int width,
 int height)

Description copied from interface: RenderDevice

Reads back the current framebuffer as RGBA8 byte array. Must be called after endFrame(). May wait for GPU idle. Returns null if readback is not supported.

Specified by:

readFramebuffer in interface RenderDevice

queryCapability

public <T> T queryCapability(DeviceCapability<T> capability)

Specified by:

queryCapability in interface RenderDevice

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface RenderDevice

setCanvasTextureView

public void setCanvasTextureView(long textureView)

Sets a canvas texture view to use as the color attachment for the default render target. Call before renderFrame() each frame. Set to 0 to use the internal offscreen RT.