// MobileGL - MobileGL/MG_Util/BackendLoaders/Vulkan/Loader.h // Copyright (c) 2025-2026 MobileGL-Dev // Licensed under the GNU Lesser General Public License v3.0: // https://www.gnu.org/licenses/gpl-3.0.txt // https://www.gnu.org/licenses/lgpl-3.0.txt // SPDX-License-Identifier: LGPL-3.0-only // End of Source File Header #pragma once #include namespace MobileGL { namespace MG_External { struct VulkanCapabilities { Version VulkanAPIVersion{1, 0, 0}; String DeviceName; String DriverVersionString; // VkPhysicalDeviceProperties::vendorID, for device-quirk vendor gating. Uint32 VendorId = 0; Int UniformBufferOffsetAlignment = 256; // VkPhysicalDeviceLimits::minStorageBufferOffsetAlignment. A separate limit from // the uniform one on Vulkan too, and the one GL_SHADER_STORAGE_BUFFER_OFFSET_ALIGNMENT // has to answer with. Int ShaderStorageBufferOffsetAlignment = 256; Float AliasedLineWidthRangeMin = 1.0f; Float AliasedLineWidthRangeMax = 1.0f; // VkPhysicalDeviceLimits::maxSamplerAnisotropy. Whether it can be used at all depends on // the samplerAnisotropy feature, which the renderer decides at device creation. Float MaxSamplerAnisotropy = 1.0f; Float SmoothLineWidthRangeMin = 1.0f; Float SmoothLineWidthRangeMax = 1.0f; Float SmoothLineWidthGranularity = 1.0f; Float PointSizeRangeMin = 1.0f; Float PointSizeRangeMax = 1.0f; Float PointSizeGranularity = 1.0f; Int Max3DTextureSize = 16384; Int MaxArrayTextureLayers = 2048; Int MaxCubeMapTextureSize = 16384; Int MaxFramebufferWidth = 16384; Int MaxFramebufferHeight = 16384; Int MaxFramebufferLayers = 2048; Int MaxRenderbufferSize = 16384; Int MaxTextureSize = 16384; Int MaxColorTextureSamples = 1; Int MaxDepthTextureSamples = 1; Int MaxFramebufferSamples = 1; Int MaxIntegerSamples = 1; Int MaxSamples = 1; Int MaxSampleMaskWords = 1; Int MaxTextureImageUnits = 32; Int MaxVertexTextureImageUnits = 32; Int MaxComputeTextureImageUnits = 32; Int MaxCombinedTextureImageUnits = 192; Int MaxVertexAttribs = 16; Int MaxComputeShaderStorageBlocks = 8; Int MaxCombinedShaderStorageBlocks = 32; Int MaxComputeUniformBlocks = 12; Int MaxComputeWorkGroupInvocations = 128; // VkPhysicalDeviceLimits::maxComputeWorkGroupCount / maxComputeWorkGroupSize per // axis, saturated to Int like every other limit here. Raw: the frontend floors them // at the GL minimums itself. Int MaxComputeWorkGroupCount[3] = {65535, 65535, 65535}; Int MaxComputeWorkGroupSize[3] = {1024, 1024, 64}; Int MaxShaderStorageBufferBindings = 8; Int MaxTextureBufferSize = 65536; // GL_TEXTURE_BUFFER_OFFSET_ALIGNMENT; 1 means the offset is unconstrained. Int TextureBufferOffsetAlignment = 1; Int MaxUniformBufferBindings = 24; Int MaxUniformBlockSize = 16384; Int MaxImageUnits = 8; Int MaxCombinedImageUniforms = 8; Int MaxComputeImageUniforms = 8; Int MaxDrawBuffers = 8; Int MaxColorAttachments = 8; Int MaxClipDistances = 8; // VkPhysicalDeviceLimits::maxCullDistances / maxCombinedClipAndCullDistances, gated // by SupportsShaderCullDistance exactly as the clip pair is gated by // SupportsShaderClipDistance. Int MaxCullDistances = 8; Int MaxCombinedClipAndCullDistances = 8; Int MaxViewports = 16; Int MaxViewportWidth = 16384; Int MaxViewportHeight = 16384; Float ViewportBoundsRangeMin = 0.0f; Float ViewportBoundsRangeMax = 0.0f; Int ViewportSubpixelBits = 0; Float MinFragmentInterpolationOffset = -0.5f; Float MaxFragmentInterpolationOffset = 0.4375f; Int FragmentInterpolationOffsetBits = 4; Bool SupportsWideLines = false; // VkPhysicalDeviceFeatures::shaderFloat64. Any module declaring OpCapability Float64 // needs it, which includes every 64-bit vertex attribute: the attribute itself arrives // as 32-bit words, but the bitcast result and everything computed from it is Float64. Bool SupportsShaderFloat64 = false; // VkPhysicalDeviceFeatures::shaderTessellationAndGeometryPointSize. Any // tessellation/geometry module declaring OpCapability TessellationPointSize / // GeometryPointSize needs it (VUID-VkShaderModuleCreateInfo-pCode-08740's // capability table); without it the shared phase-B chain demotes the built-in // to an ordinary varying. One feature for both stage families, unlike the ES // loader's two extension tiers. Bool SupportsTessellationAndGeometryPointSize = false; // VkPhysicalDeviceFeatures::imageCubeArray. Required before a // VK_IMAGE_VIEW_TYPE_CUBE_ARRAY view may be created at all // (VUID-VkImageViewCreateInfo-viewType-01004), which is every cube map array texture - // both its sampled view and its full view. Bool SupportsImageCubeArray = false; // VK_IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT on a 3D colour image, i.e. whether one z slice // of a GL_TEXTURE_3D texture can be named by a 2D view and attached to a framebuffer. // Vulkan 1.1 core, but per format+usage - this is an OPTIMISTIC summary probed over the // common colour attachment formats. The authoritative answer is taken per format at // image creation in VkTextureManager, which withdraws the flag and remembers the verdict // when a driver refuses it. Bool Supports2DArrayCompatible3DImages = false; // Storage-image descriptors are limited per stage by // maxPerStageDescriptorStorageImages, but writes/atomics outside compute additionally // require these core Vulkan features to be enabled on the logical device. Bool SupportsVertexPipelineStoresAndAtomics = false; Bool SupportsFragmentStoresAndAtomics = false; Bool SupportsGeometryShader = false; // VkPhysicalDeviceFeatures::tessellationShader, which VulkanRenderer enables wherever // the physical device has it. Bool SupportsTessellationShader = false; // VkPhysicalDeviceFeatures::shaderClipDistance. maxClipDistances is a LIMIT and is // reported whatever the feature says, so the limit alone does not mean a module may // declare ClipDistance - VulkanRenderer enables the feature only where the physical // device has it, and without it a shader writing gl_ClipDistance is invalid. Very // widely supported, hence read from the device features and never assumed false. Bool SupportsShaderClipDistance = false; // VkPhysicalDeviceFeatures::shaderCullDistance, the same story one field down: // VulkanRenderer already ENABLES this feature where the device has it, but nobody // ever read the limits it unlocks, so the frontend advertised eight cull distances // from a literal instead of from the device. Bool SupportsShaderCullDistance = false; SizeT MaxShaderStorageBlockSize = 128 * 1024 * 1024; Bool SupportsShaderSubgroup = false; Uint32 SubgroupSize = 0; Uint32 SubgroupSupportedStages = 0; Uint32 SubgroupSupportedOperations = 0; Bool SubgroupQuadOperationsInAllStages = false; }; } // namespace MG_External namespace MG_Util::BackendLoader { Bool QueryVulkanCapabilities(MobileGL::MG_External::VulkanCapabilities& caps, VkInstance instance, VkPhysicalDevice physicalDevice); void FillInVulkanCapabilities(MobileGL::MG_External::VulkanCapabilities& caps, VkPhysicalDeviceProperties properties); } // namespace MG_Util::BackendLoader } // namespace MobileGL