LLGL::RenderSystemFlags Struct Reference

Render system flags enumeration. More...

#include <RenderSystemFlags.h>

Public Types
enum	{   DebugDevice = (1 << 0) , PreferNVIDIA = (1 << 1) , PreferAMD = (1 << 2) , PreferIntel = (1 << 3) ,   SoftwareDevice = (1 << 4) , DebugBreakOnError = (1 << 5) }

Detailed Description

Render system flags enumeration.

See also

RenderSystemDescriptor::flags

Member Enumeration Documentation

anonymous enum

anonymous enum

Enumerator
DebugDevice	Specifies that a debug device is requested for the render system backend. Remarks This is only a hint to LLGL since not every backend supports native debug layers. Here is an overview of what impact this flag has to the respective renderer: Direct3D 12: A debug controller of type ID3D12Debug will be created and GPU validation via EnableDebugLayer and SetEnableGPUBasedValidation (D3D12.1) will be enabled. See https://learn.microsoft.com/en-us/windows/win32/direct3d12/using-d3d12-debug-layer-gpu-based-validation Direct3D 11: D3D11_CREATE_DEVICE_DEBUG will be added to the Direct3D device instance. See https://learn.microsoft.com/en-us/windows/win32/direct3d11/overviews-direct3d-11-devices-layers#debug-layer Vulkan: A debug callback will be registered via vkCreateDebugReportCallbackEXT if the Vulkan extension "VK_EXT_debug_report" is available. See https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/VK_EXT_debug_report.html OpenGL: A debug callback will be registered via glDebugMessageCallback if the OpenGL extension "GL_KHR_debug" is available. See https://www.khronos.org/opengl/wiki/Debug_Output Metal: Not supported.
PreferNVIDIA	Hints the render system to prefer a video adapter from NVIDIA. Remarks This can be used on multi-GPU systems to select a specific video adapter when more than one is available. If multiple preferred device vendors are specified, the order of preference is undefined. This is merely a hint to the render system because not all rendering APIs support selecting a specific video adapter (such as OpenGL). Note Only supported with: Direct3D 11, Direct3D 12, Vulkan.
PreferAMD	Hints the render system to prefer a video adapter from AMD. See also PreferNVIDIA
PreferIntel	Hints the render system to prefer a video adapter from Intel. See also PreferNVIDIA
SoftwareDevice	Specifies that a software device is requested such as "Microsoft Basic Render Driver" as a reference device for Direct3D. Remarks This can be used for debugging or if the hardware does not support the respective API. Note Only supported with: Direct3D 11.
DebugBreakOnError	Specifies that the debugger should break when an error in the debug validation was detected. Remarks This helps to identify wrong parameters with a full callstack right where it occurs. This applies to both the native debug layer from the rendering API as well as LLGL's own debug layer. Note Only supported with: Direct3D 12, Vulkan, OpenGL. See also DebugDevice

---

The documentation for this struct was generated from the following file:

• RenderSystemFlags.h