Class GlRenderDevice

java.lang.Object

dev.engine.graphics.opengl.GlRenderDevice

All Implemented Interfaces:

RenderDevice, AutoCloseable

public class GlRenderDevice
extends Object
implements RenderDevice

Constructor Summary

Constructors

Constructor	Description
GlRenderDevice(WindowHandle window, GlBindings gl)
GlRenderDevice(WindowHandle window, GlBindings gl, GraphicsConfig config)

Method Summary

Modifier and Type	Method	Description
void	beginFrame()
CapabilityRegistry	capabilities()	Returns the capability registry for this device.
void	close()
Handle<BufferResource>	createBuffer(BufferDescriptor descriptor)
Handle<PipelineResource>	createComputePipeline(ComputePipelineDescriptor 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)
int	getGlBufferName(Handle<BufferResource> buffer)
int	getGlTextureName(Handle<TextureResource> texture)
Handle<TextureResource>	getRenderTargetColorTexture(Handle<RenderTargetResource> renderTarget, int index)
GlBindings	glBindings()	Returns the GlBindings instance used by this device.
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	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

getTextureIndex, supports

Constructor Details

GlRenderDevice

public GlRenderDevice(WindowHandle window,
 GlBindings gl)

GlRenderDevice

public GlRenderDevice(WindowHandle window,
 GlBindings gl,
 GraphicsConfig config)

Method Details

glBindings

public GlBindings glBindings()

Returns the GlBindings instance used by this device.

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

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

createComputePipeline

public Handle<PipelineResource> createComputePipeline(ComputePipelineDescriptor descriptor)

Specified by:

createComputePipeline in interface RenderDevice

isValidPipeline

public boolean isValidPipeline(Handle<PipelineResource> pipeline)

Specified by:

isValidPipeline in interface RenderDevice

getGlTextureName

public int getGlTextureName(Handle<TextureResource> texture)

getGlBufferName

public int getGlBufferName(Handle<BufferResource> buffer)

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

queryCapability

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

Specified by:

queryCapability in interface RenderDevice

capabilities

public CapabilityRegistry capabilities()

Returns the capability registry for this device. Users can register custom capabilities without modifying engine code:

  var MY_CAP = DeviceCapability.intCap("MY_CUSTOM_LIMIT");
  device.capabilities().register(MY_CAP, () -> gl.glGetInteger(MY_GL_CONSTANT));

getBindlessTextureHandle

public long getBindlessTextureHandle(Handle<TextureResource> texture)

Specified by:

getBindlessTextureHandle 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

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

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface RenderDevice