Class VkRenderDevice

java.lang.Object

dev.engine.graphics.vulkan.VkRenderDevice

All Implemented Interfaces:

RenderDevice, AutoCloseable

public class VkRenderDevice
extends Object
implements RenderDevice

Constructor Summary

Constructors

Constructor	Description
VkRenderDevice(VkBindings vk, String[] requiredExtensions, LongUnaryOperator surfaceFactory, int initialWidth, int initialHeight)	Creates a Vulkan render device.
VkRenderDevice(VkBindings vk, String[] requiredExtensions, LongUnaryOperator surfaceFactory, int initialWidth, int initialHeight, int preferredFormat, int preferredPresentMode, GraphicsConfig config)

Method Summary

Modifier and Type	Method	Description
void	beginFrame()
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> handle)
void	destroyPipeline(Handle<PipelineResource> handle)
void	destroyRenderTarget(Handle<RenderTargetResource> handle)
void	destroySampler(Handle<SamplerResource> handle)
void	destroyTexture(Handle<TextureResource> handle)
void	destroyVertexInput(Handle<VertexInputResource> handle)
void	endFrame()
long	getBindlessTextureHandle(Handle<TextureResource> texture)
Handle<TextureResource>	getRenderTargetColorTexture(Handle<RenderTargetResource> renderTarget, int index)
boolean	isValidBuffer(Handle<BufferResource> handle)
boolean	isValidPipeline(Handle<PipelineResource> handle)
boolean	isValidTexture(Handle<TextureResource> handle)
<T> T	queryCapability(DeviceCapability<T> capability)
byte[]	readFramebuffer(int width, int height)	Reads back the entire framebuffer as RGBA8 byte array.
int[]	readPixel(int x, int y)	Reads back pixels from the current swapchain image after rendering.
void	submit(CommandList commands)
int	swapchainHeight()	Swapchain height.
int	swapchainWidth()	Swapchain width.
void	uploadTexture(Handle<TextureResource> texture, ByteBuffer pixels)
BufferWriter	writeBuffer(Handle<BufferResource> handle)
BufferWriter	writeBuffer(Handle<BufferResource> handle, 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

VkRenderDevice

public VkRenderDevice(VkBindings vk,
 String[] requiredExtensions,
 LongUnaryOperator surfaceFactory,
 int initialWidth,
 int initialHeight)

Creates a Vulkan render device.

Parameters:

vk - the Vulkan bindings implementation

requiredExtensions - instance extensions needed for surface support

surfaceFactory - given the VkInstance handle, creates and returns a VkSurfaceKHR handle

VkRenderDevice

public VkRenderDevice(VkBindings vk,
 String[] requiredExtensions,
 LongUnaryOperator surfaceFactory,
 int initialWidth,
 int initialHeight,
 int preferredFormat,
 int preferredPresentMode,
 GraphicsConfig config)

Method Details

createBuffer

public Handle<BufferResource> createBuffer(BufferDescriptor descriptor)

Specified by:

createBuffer in interface RenderDevice

destroyBuffer

public void destroyBuffer(Handle<BufferResource> handle)

Specified by:

destroyBuffer in interface RenderDevice

isValidBuffer

public boolean isValidBuffer(Handle<BufferResource> handle)

Specified by:

isValidBuffer in interface RenderDevice

writeBuffer

public BufferWriter writeBuffer(Handle<BufferResource> handle)

Specified by:

writeBuffer in interface RenderDevice

writeBuffer

public BufferWriter writeBuffer(Handle<BufferResource> handle,
 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> handle)

Specified by:

destroyTexture in interface RenderDevice

isValidTexture

public boolean isValidTexture(Handle<TextureResource> handle)

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> handle)

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> handle)

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> handle)

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> handle)

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> handle)

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

readPixel

public int[] readPixel(int x,
 int y)

Reads back pixels from the current swapchain image after rendering. Must be called between endFrame() submissions — waits for GPU idle. Returns RGBA8 pixel data as int[] {R, G, B, A} for 0-255 values.

readFramebuffer

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

Reads back the entire framebuffer as RGBA8 byte array. Must be called after endFrame(). Waits for GPU idle.

Specified by:

readFramebuffer in interface RenderDevice

swapchainWidth

public int swapchainWidth()

Swapchain width.

swapchainHeight

public int swapchainHeight()

Swapchain height.

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

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface RenderDevice