Package com.mojang.blaze3d.opengl

Class GlDevice

java.lang.Object

com.mojang.blaze3d.opengl.GlDevice

All Implemented Interfaces:

GpuDevice, GpuDeviceExtension

public class GlDevice
extends Object
implements GpuDevice

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static final record	GlDevice.ShaderCompilationKey

Field Summary

Fields

Modifier and Type	Field	Description
private final BufferStorage	bufferStorage
private final GlDebugLabel	debugLabels
private final GlDebug	debugLog
private final BiFunction<ResourceLocation,ShaderType,String>	defaultShaderSource
private final GpuDeviceProperties	deviceProperties
private final DirectStateAccess	directStateAccess
private final Set<String>	enabledExtensions
private final GpuDeviceFeatures	enabledFeatures
private final CommandEncoder	encoder
private static final org.slf4j.Logger	LOGGER
private final int	maxSupportedTextureSize
private final Map<RenderPipeline,GlRenderPipeline>	pipelineCache
private final Map<GlDevice.ShaderCompilationKey,GlShaderModule>	shaderCache
private final int	uniformOffsetAlignment
protected static boolean	USE_GL_ARB_buffer_storage
protected static boolean	USE_GL_ARB_debug_output
protected static boolean	USE_GL_ARB_direct_state_access
protected static boolean	USE_GL_ARB_vertex_attrib_binding
protected static boolean	USE_GL_EXT_debug_label
protected static boolean	USE_GL_KHR_debug
private final VertexArrayCache	vertexArrayCache

Constructor Summary

Constructors

Constructor	Description
GlDevice(long pWindow, int pDebugVerbosity, boolean pSynchronous, BiFunction<ResourceLocation,ShaderType,String> pDefaultShaderSource, boolean pRenderDebugLabels)

Method Summary

Modifier and Type	Method	Description
private static void	amdDummyShaderWorkaround()
void	clearPipelineCache()
void	close()
private GlRenderPipeline	compilePipeline(RenderPipeline pPipeline, BiFunction<ResourceLocation,ShaderType,String> pShaderSource)
private GlShaderModule	compileShader(GlDevice.ShaderCompilationKey pKey, BiFunction<ResourceLocation,ShaderType,String> pShaderSource)
GpuBuffer	createBuffer(Supplier<String> pLabel, int pUsage, int pSize)
GpuBuffer	createBuffer(Supplier<String> pLabel, int pUsage, ByteBuffer pData)
CommandEncoder	createCommandEncoder()
GpuTexture	createExternalTexture(int usage, String label, TextureFormat format, int width, int height, int depthOrLayers, int mipLevels, int nativeId)	Create a new GPU texture from an existing texture whose lifecycle is externally managed.
GpuTexture	createExternalTexture(String label, int usage, int nativeId)	Adopt an external OpenGL texture into a GpuTexture.
GpuTexture	createTexture(String pLabel, int pUsage, TextureFormat pFormat, int pWidth, int pHeight, int pDepthOrLayers, int pMipLevels)
GpuTexture	createTexture(Supplier<String> pLabel, int pUsage, TextureFormat pFormat, int pWidth, int pHeight, int pDepthOrLayers, int pMipLevels)
GpuTextureView	createTextureView(GpuTexture pTexture)
GpuTextureView	createTextureView(GpuTexture pTexture, int pBaseMipLevel, int pMipLevels)
GlDebugLabel	debugLabels()
GpuDeviceProperties	deviceProperties()
DirectStateAccess	directStateAccess()
GpuDeviceFeatures	enabledFeatures()	GpuDeviceFeatures enabled during device configuration.
String	getBackendName()
BufferStorage	getBufferStorage()
List<String>	getEnabledExtensions()
String	getImplementationInformation()
List<String>	getLastDebugMessages()
private static int	getMaxSupportedTextureSize()
int	getMaxTextureSize()
protected GlRenderPipeline	getOrCompilePipeline(RenderPipeline pPipeline)
protected GlShaderModule	getOrCompileShader(ResourceLocation pShader, ShaderType pType, ShaderDefines pDefines, BiFunction<ResourceLocation,ShaderType,String> pShaderSource)
String	getRenderer()
int	getUniformOffsetAlignment()
String	getVendor()
String	getVersion()
boolean	isDebuggingEnabled()
GlRenderPipeline	precompilePipeline(RenderPipeline pRenderPipeline, BiFunction<ResourceLocation,ShaderType,String> pShaderSource)
VertexArrayCache	vertexArrayCache()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.mojang.blaze3d.systems.GpuDevice

precompilePipeline

Field Details

LOGGER

private static final org.slf4j.Logger LOGGER

USE_GL_ARB_vertex_attrib_binding

protected static boolean USE_GL_ARB_vertex_attrib_binding

USE_GL_KHR_debug

protected static boolean USE_GL_KHR_debug

USE_GL_EXT_debug_label

protected static boolean USE_GL_EXT_debug_label

USE_GL_ARB_debug_output

protected static boolean USE_GL_ARB_debug_output

USE_GL_ARB_direct_state_access

protected static boolean USE_GL_ARB_direct_state_access

USE_GL_ARB_buffer_storage

protected static boolean USE_GL_ARB_buffer_storage

encoder

private final CommandEncoder encoder

debugLog

@Nullable
private final GlDebug debugLog

debugLabels

private final GlDebugLabel debugLabels

maxSupportedTextureSize

private final int maxSupportedTextureSize

directStateAccess

private final DirectStateAccess directStateAccess

defaultShaderSource

private final BiFunction<ResourceLocation,ShaderType,String> defaultShaderSource

pipelineCache

private final Map<RenderPipeline,GlRenderPipeline> pipelineCache

shaderCache

private final Map<GlDevice.ShaderCompilationKey,GlShaderModule> shaderCache

vertexArrayCache

private final VertexArrayCache vertexArrayCache

bufferStorage

private final BufferStorage bufferStorage

enabledExtensions

private final Set<String> enabledExtensions

uniformOffsetAlignment

private final int uniformOffsetAlignment

deviceProperties

private final GpuDeviceProperties deviceProperties

enabledFeatures

private final GpuDeviceFeatures enabledFeatures

Constructor Details

GlDevice

public GlDevice(long pWindow,
 int pDebugVerbosity,
 boolean pSynchronous,
 BiFunction<ResourceLocation,ShaderType,String> pDefaultShaderSource,
 boolean pRenderDebugLabels)

Method Details

debugLabels

public GlDebugLabel debugLabels()

createCommandEncoder

public CommandEncoder createCommandEncoder()

Specified by:

createCommandEncoder in interface GpuDevice

createTexture

public GpuTexture createTexture(@Nullable
 Supplier<String> pLabel,
 int pUsage,
 TextureFormat pFormat,
 int pWidth,
 int pHeight,
 int pDepthOrLayers,
 int pMipLevels)

Specified by:

createTexture in interface GpuDevice

createTexture

public GpuTexture createTexture(@Nullable
 String pLabel,
 int pUsage,
 TextureFormat pFormat,
 int pWidth,
 int pHeight,
 int pDepthOrLayers,
 int pMipLevels)

Specified by:

createTexture in interface GpuDevice

createExternalTexture

public GpuTexture createExternalTexture(@Nullable
 String label,
 int usage,
 int nativeId)

Adopt an external OpenGL texture into a GpuTexture. The lifecycle of the OpenGL texture will not be tied to this GpuTexture and the external system is responsible for cleaning up the OpenGL texture. Calling this is a relatively expensive operation since we introspect the texture using OpenGL getters.

createExternalTexture

public GpuTexture createExternalTexture(int usage,
 @Nullable
 String label,
 TextureFormat format,
 int width,
 int height,
 int depthOrLayers,
 int mipLevels,
 int nativeId)

Create a new GPU texture from an existing texture whose lifecycle is externally managed.

createTextureView

public GpuTextureView createTextureView(GpuTexture pTexture)

Specified by:

createTextureView in interface GpuDevice

createTextureView

public GpuTextureView createTextureView(GpuTexture pTexture,
 int pBaseMipLevel,
 int pMipLevels)

Specified by:

createTextureView in interface GpuDevice

createBuffer

public GpuBuffer createBuffer(@Nullable
 Supplier<String> pLabel,
 int pUsage,
 int pSize)

Specified by:

createBuffer in interface GpuDevice

createBuffer

public GpuBuffer createBuffer(@Nullable
 Supplier<String> pLabel,
 int pUsage,
 ByteBuffer pData)

Specified by:

createBuffer in interface GpuDevice

getImplementationInformation

public String getImplementationInformation()

Specified by:

getImplementationInformation in interface GpuDevice

getLastDebugMessages

public List<String> getLastDebugMessages()

Specified by:

getLastDebugMessages in interface GpuDevice

isDebuggingEnabled

public boolean isDebuggingEnabled()

Specified by:

isDebuggingEnabled in interface GpuDevice

getRenderer

public String getRenderer()

Specified by:

getRenderer in interface GpuDevice

getVendor

public String getVendor()

Specified by:

getVendor in interface GpuDevice

getBackendName

public String getBackendName()

Specified by:

getBackendName in interface GpuDevice

getVersion

public String getVersion()

Specified by:

getVersion in interface GpuDevice

getMaxSupportedTextureSize

private static int getMaxSupportedTextureSize()

getMaxTextureSize

public int getMaxTextureSize()

Specified by:

getMaxTextureSize in interface GpuDevice

getUniformOffsetAlignment

public int getUniformOffsetAlignment()

Specified by:

getUniformOffsetAlignment in interface GpuDevice

clearPipelineCache

public void clearPipelineCache()

Specified by:

clearPipelineCache in interface GpuDevice

amdDummyShaderWorkaround

private static void amdDummyShaderWorkaround()

getEnabledExtensions

public List<String> getEnabledExtensions()

Specified by:

getEnabledExtensions in interface GpuDevice

close

public void close()

Specified by:

close in interface GpuDevice

directStateAccess

public DirectStateAccess directStateAccess()

getOrCompilePipeline

protected GlRenderPipeline getOrCompilePipeline(RenderPipeline pPipeline)

getOrCompileShader

protected GlShaderModule getOrCompileShader(ResourceLocation pShader,
 ShaderType pType,
 ShaderDefines pDefines,
 BiFunction<ResourceLocation,ShaderType,String> pShaderSource)

precompilePipeline

public GlRenderPipeline precompilePipeline(RenderPipeline pRenderPipeline,
 @Nullable
 BiFunction<ResourceLocation,ShaderType,String> pShaderSource)

Specified by:

precompilePipeline in interface GpuDevice

compileShader

private GlShaderModule compileShader(GlDevice.ShaderCompilationKey pKey,
 BiFunction<ResourceLocation,ShaderType,String> pShaderSource)

compilePipeline

private GlRenderPipeline compilePipeline(RenderPipeline pPipeline,
 BiFunction<ResourceLocation,ShaderType,String> pShaderSource)

vertexArrayCache

public VertexArrayCache vertexArrayCache()

getBufferStorage

public BufferStorage getBufferStorage()

deviceProperties

public GpuDeviceProperties deviceProperties()

Specified by:

deviceProperties in interface GpuDeviceExtension

See Also:

• GpuDeviceProperties

enabledFeatures

public GpuDeviceFeatures enabledFeatures()

Description copied from interface: GpuDeviceExtension

GpuDeviceFeatures enabled during device configuration.

Specified by:

enabledFeatures in interface GpuDeviceExtension

See Also:

• GpuDeviceFeatures
• ConfigureGpuDeviceEvent