Class GlStreamingBuffer

java.lang.Object

dev.engine.graphics.opengl.GlStreamingBuffer

All Implemented Interfaces:

StreamingBuffer, AutoCloseable

public class GlStreamingBuffer
extends Object
implements StreamingBuffer

OpenGL implementation of StreamingBuffer using persistent mapped buffers.

Allocates a single large buffer of size frameSize * frameCount and persistently maps it with coherent writes. Each frame writes to a different region, avoiding GPU/CPU contention when combined with fences.

Method Summary

Modifier and Type	Method	Description
void	advance()	Advances to the next frame.
NativeMemory	beginWrite()	Begins writing for the current frame.
void	close()
long	currentOffset()	Returns the byte offset into the buffer for the current frame's data.
void	endWrite()	Finishes writing.
long	frameSize()	Size of a single frame's region.
Handle<BufferResource>	handle()	The underlying GPU buffer handle.
long	size()	Total buffer size in bytes.

Methods inherited from class Object

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

Method Details

handle

public Handle<BufferResource> handle()

Description copied from interface: StreamingBuffer

The underlying GPU buffer handle.

Specified by:

handle in interface StreamingBuffer

size

public long size()

Description copied from interface: StreamingBuffer

Total buffer size in bytes.

Specified by:

size in interface StreamingBuffer

frameSize

public long frameSize()

Description copied from interface: StreamingBuffer

Size of a single frame's region.

Specified by:

frameSize in interface StreamingBuffer

beginWrite

public NativeMemory beginWrite()

Description copied from interface: StreamingBuffer

Begins writing for the current frame. Returns a NativeMemory pointing to the current frame's region. The memory is valid until StreamingBuffer.endWrite() is called.

Specified by:

beginWrite in interface StreamingBuffer

endWrite

public void endWrite()

Description copied from interface: StreamingBuffer

Finishes writing. The data becomes available to the GPU.

Specified by:

endWrite in interface StreamingBuffer

currentOffset

public long currentOffset()

Description copied from interface: StreamingBuffer

Returns the byte offset into the buffer for the current frame's data. Use this for glBindBufferRange offset.

Specified by:

currentOffset in interface StreamingBuffer

advance

public void advance()

Description copied from interface: StreamingBuffer

Advances to the next frame. Must be called once per frame.

Specified by:

advance in interface StreamingBuffer

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface StreamingBuffer