[Feat] (Frontend): add GL_EXT_fragment_shading_rate state, entry points and getters

This commit is contained in:
2026-10-12 08:03:27 -04:00
parent ba6db60c09
commit 7e544c2b78
22 changed files with 567 additions and 9 deletions
@@ -2035,6 +2035,9 @@ DECLARE_GL_FUNCTION_STUB_HEAD(void, GetPixelTransformParameterivEXT, GLenum targ
DECLARE_GL_FUNCTION_STUB_HEAD(void, GetPixelTransformParameterfvEXT, GLenum target, GLenum pname, GLfloat* params) DECLARE_GL_FUNCTION_STUB_END_NO_RETURN(void, GetPixelTransformParameterfvEXT, target, pname, params)
DECLARE_GL_FUNCTION_STUB_HEAD(void, PointParameterfEXT, GLenum pname, GLfloat param) DECLARE_GL_FUNCTION_STUB_END_NO_RETURN(void, PointParameterfEXT, pname, param)
DECLARE_GL_FUNCTION_STUB_HEAD(void, PointParameterfvEXT, GLenum pname, const GLfloat* params) DECLARE_GL_FUNCTION_STUB_END_NO_RETURN(void, PointParameterfvEXT, pname, params)
DECLARE_GL_FUNCTION_HEAD(void, GetFragmentShadingRatesEXT, GLsizei samples, GLsizei maxCount, GLsizei* count, GLenum* shadingRates) DECLARE_GL_FUNCTION_END_NO_RETURN(void, GetFragmentShadingRatesEXT, samples, maxCount, count, shadingRates)
DECLARE_GL_FUNCTION_HEAD(void, ShadingRateEXT, GLenum rate) DECLARE_GL_FUNCTION_END_NO_RETURN(void, ShadingRateEXT, rate)
DECLARE_GL_FUNCTION_HEAD(void, ShadingRateCombinerOpsEXT, GLenum combinerOp0, GLenum combinerOp1) DECLARE_GL_FUNCTION_END_NO_RETURN(void, ShadingRateCombinerOpsEXT, combinerOp0, combinerOp1)
DECLARE_GL_FUNCTION_HEAD(void, PolygonOffsetClampEXT, GLfloat factor, GLfloat units, GLfloat clamp) DECLARE_GL_FUNCTION_END_NO_RETURN(void, PolygonOffsetClamp, factor, units, clamp)
DECLARE_GL_FUNCTION_HEAD(void, ProvokingVertexEXT, GLenum mode) DECLARE_GL_FUNCTION_END_NO_RETURN(void, ProvokingVertex, mode)
DECLARE_GL_FUNCTION_STUB_HEAD(void, RasterSamplesEXT, GLuint samples, GLboolean fixedsamplelocations) DECLARE_GL_FUNCTION_STUB_END_NO_RETURN(void, RasterSamplesEXT, samples, fixedsamplelocations)
@@ -1632,6 +1632,121 @@ namespace MobileGL::MG_Impl::GLImpl {
}
}
// GL_EXT_fragment_shading_rate's state and limits (tables 23.9 / 23.53 of the extension).
// Returns false for any other pname. The tokens belong to the extension, so a context whose
// backend cannot back it answers them like any unknown pname, and the attachment limits the
// same way unless the attachment extension is advertised too.
static Bool TryGetFragmentShadingRateInteger(GLenum pname, GLint* params) {
Bool attachmentToken = false;
switch (pname) {
case GL_SHADING_RATE_EXT:
case GL_FRAGMENT_SHADING_RATE_NON_TRIVIAL_COMBINERS_SUPPORTED_EXT:
case GL_FRAGMENT_SHADING_RATE_WITH_SHADER_DEPTH_STENCIL_WRITES_SUPPORTED_EXT:
case GL_FRAGMENT_SHADING_RATE_WITH_SAMPLE_MASK_SUPPORTED_EXT:
case GL_FRAGMENT_SHADING_RATE_PRIMITIVE_RATE_WITH_MULTI_VIEWPORT_SUPPORTED_EXT:
break;
case GL_MIN_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_WIDTH_EXT:
case GL_MIN_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_HEIGHT_EXT:
case GL_MAX_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_WIDTH_EXT:
case GL_MAX_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_HEIGHT_EXT:
case GL_MAX_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_ASPECT_RATIO_EXT:
case GL_MAX_FRAGMENT_SHADING_RATE_ATTACHMENT_LAYERS_EXT:
case GL_FRAGMENT_SHADING_RATE_ATTACHMENT_WITH_DEFAULT_FRAMEBUFFER_SUPPORTED_EXT:
attachmentToken = true;
break;
default:
return false;
}
const auto& caps = MG_Backend::pActiveBackendObject->GetDynamicParameters();
if (!caps.SupportsFragmentShadingRate || (attachmentToken && !caps.SupportsAttachmentFragmentShadingRate)) {
MG_State::pGLContext->RecordError(
ErrorCode::InvalidEnum,
MakeUnique<GenericErrorInfo>("MG_Impl/GLImpl", "GetIntegerv",
std::format("Invalid enum: 0x{:X} (its fragment shading rate extension "
"is not supported)",
pname)));
return true;
}
switch (pname) {
case GL_SHADING_RATE_EXT:
*params = static_cast<GLint>(MGUnpackShadingRate(MG_State::pGLContext->GetShadingRate()));
return true;
case GL_FRAGMENT_SHADING_RATE_NON_TRIVIAL_COMBINERS_SUPPORTED_EXT:
*params = caps.FragmentShadingRateNonTrivialCombiners ? GL_TRUE : GL_FALSE;
return true;
case GL_FRAGMENT_SHADING_RATE_WITH_SHADER_DEPTH_STENCIL_WRITES_SUPPORTED_EXT:
*params = caps.FragmentShadingRateWithShaderDepthStencilWrites ? GL_TRUE : GL_FALSE;
return true;
case GL_FRAGMENT_SHADING_RATE_WITH_SAMPLE_MASK_SUPPORTED_EXT:
*params = caps.FragmentShadingRateWithSampleMask ? GL_TRUE : GL_FALSE;
return true;
case GL_FRAGMENT_SHADING_RATE_PRIMITIVE_RATE_WITH_MULTI_VIEWPORT_SUPPORTED_EXT:
*params = caps.FragmentShadingRatePrimitiveWithMultiViewport ? GL_TRUE : GL_FALSE;
return true;
case GL_MIN_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_WIDTH_EXT:
*params = caps.MinFragmentShadingRateAttachmentTexelWidth;
return true;
case GL_MIN_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_HEIGHT_EXT:
*params = caps.MinFragmentShadingRateAttachmentTexelHeight;
return true;
case GL_MAX_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_WIDTH_EXT:
*params = caps.MaxFragmentShadingRateAttachmentTexelWidth;
return true;
case GL_MAX_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_HEIGHT_EXT:
*params = caps.MaxFragmentShadingRateAttachmentTexelHeight;
return true;
case GL_MAX_FRAGMENT_SHADING_RATE_ATTACHMENT_TEXEL_ASPECT_RATIO_EXT:
*params = caps.MaxFragmentShadingRateAttachmentTexelAspectRatio;
return true;
case GL_MAX_FRAGMENT_SHADING_RATE_ATTACHMENT_LAYERS_EXT:
*params = caps.MaxFragmentShadingRateAttachmentLayers;
return true;
case GL_FRAGMENT_SHADING_RATE_ATTACHMENT_WITH_DEFAULT_FRAMEBUFFER_SUPPORTED_EXT:
*params = caps.FragmentShadingRateAttachmentWithDefaultFramebuffer ? GL_TRUE : GL_FALSE;
return true;
default:
return false;
}
}
// GL_EXT_fragment_shading_rate 14.X.1. The rates come from the backend's per-sample-count
// mask, largest area first (the order the Vulkan query uses; the extension leaves it open).
// A sample count the device does not list - including any that is not a power of two -
// answers zero rates rather than an error: the only error the extension gives is a negative
// maxCount.
void GetFragmentShadingRatesEXT(GLsizei samples, GLsizei maxCount, GLsizei* count, GLenum* shadingRates) {
if (maxCount < 0) {
MG_State::pGLContext->RecordError(
ErrorCode::InvalidValue,
MakeUnique<GenericErrorInfo>("MG_Impl/GLImpl", __func__, "maxCount must not be negative"));
return;
}
const auto& caps = MG_Backend::pActiveBackendObject->GetDynamicParameters();
Uint16 mask = 0;
if (caps.SupportsFragmentShadingRate) {
// GL counts a non-multisampled framebuffer as samples = 0 or 1; both are the 1x mask.
const GLsizei effectiveSamples = samples <= 1 ? 1 : samples;
for (SizeT i = 0; i < std::size(caps.FragmentShadingRateMasks); ++i) {
if (effectiveSamples == (GLsizei{1} << i)) {
mask = caps.FragmentShadingRateMasks[i];
break;
}
}
}
// Largest area first, then the wider rate of an equal area.
static constexpr Uint8 kOrder[] = {0xa, 0x9, 0x6, 0x8, 0x5, 0x2, 0x4, 0x1, 0x0};
GLsizei written = 0;
for (Uint8 packed : kOrder) {
if ((mask & (1u << packed)) == 0) continue;
if (written >= maxCount) break;
if (shadingRates != nullptr) shadingRates[written] = MGUnpackShadingRate(packed);
++written;
}
if (count != nullptr) *count = written;
}
void GetIntegerv(GLenum pname, GLint* params) {
MGLOG_D("glGetIntegerv, pname: %s", MG_Util::ConvertGLEnumToString(pname).c_str());
if (!params) {
@@ -1648,6 +1763,8 @@ namespace MobileGL::MG_Impl::GLImpl {
return;
}
if (TryGetFragmentShadingRateInteger(pname, params)) return;
switch (pname) {
case GL_ACTIVE_TEXTURE:
*params = MG_State::pGLContext->GetActiveTextureUnit() + GL_TEXTURE0;
@@ -17,6 +17,8 @@ namespace MobileGL::MG_Impl::GLImpl {
void GetFloatv(GLenum pname, GLfloat* params);
void GetDoublev(GLenum pname, GLdouble* params);
void GetIntegerv(GLenum pname, GLint* params);
// GL_EXT_fragment_shading_rate
void GetFragmentShadingRatesEXT(GLsizei samples, GLsizei maxCount, GLsizei* count, GLenum* shadingRates);
void GetInteger64v(GLenum pname, GLint64* params);
void GetIntegeri_v(GLenum target, GLuint index, GLint* data);
void GetFloati_v(GLenum target, GLuint index, GLfloat* data);
@@ -9,6 +9,7 @@
#include "GL_RenderState.h"
#include <cmath>
#include <MG_Impl/GLImpl/Getter/GL_Getter.h>
#include <MG_Backend/BackendObjects.h>
#include <MG_State/GLState/Core.h>
#include <MG_Util/Converters/GLToStr/GLEnumConverter.h>
#include <MG_Util/Converters/GLToMG/RenderStateEnumConverter.h>
@@ -372,6 +373,61 @@ namespace MobileGL::MG_Impl::GLImpl {
MG_State::pGLContext->SetClipControl(origin, depth);
}
// GL_EXT_fragment_shading_rate 14.X.1: the only error is a rate outside table X.1, and the
// state is left untouched by it. Whether the device can honour the rate is not an error -
// an unsupported rate is clamped at rasterization, which the backends leave to the driver.
void ShadingRateEXT_State(GLenum rate) {
const Uint8 packed = MGPackShadingRate(rate);
if (packed == kMGInvalidShadingRateEncoding) {
MG_State::pGLContext->RecordError(
ErrorCode::InvalidEnum,
MakeUnique<GenericErrorInfo>("MG_Impl/GLImpl", __func__,
"glShadingRateEXT rate is not a GL_SHADING_RATE_*_PIXELS_EXT value; got " +
MG_Util::ConvertGLEnumToString(rate) + "."));
return;
}
MG_State::pGLContext->SetShadingRate(packed);
}
// GL_EXT_fragment_shading_rate 14.X.4, in the spec's order: an op outside the five combiner
// enums is INVALID_ENUM; a non-trivial op (MIN, MAX, MUL) without
// FRAGMENT_SHADING_RATE_NON_TRIVIAL_COMBINERS_SUPPORTED_EXT, or a non-KEEP op whose input
// extension (_primitive for op 0, _attachment for op 1) is absent, is INVALID_OPERATION.
void ShadingRateCombinerOpsEXT_State(GLenum combinerOp0, GLenum combinerOp1) {
const Uint8 op0 = MGShadingRateCombinerOpIndex(combinerOp0);
const Uint8 op1 = MGShadingRateCombinerOpIndex(combinerOp1);
if (op0 == kMGInvalidShadingRateEncoding || op1 == kMGInvalidShadingRateEncoding) {
MG_State::pGLContext->RecordError(
ErrorCode::InvalidEnum,
MakeUnique<GenericErrorInfo>(
"MG_Impl/GLImpl", __func__,
"glShadingRateCombinerOpsEXT ops must be GL_FRAGMENT_SHADING_RATE_COMBINER_OP_*_EXT; got " +
MG_Util::ConvertGLEnumToString(combinerOp0) + ", " +
MG_Util::ConvertGLEnumToString(combinerOp1) + "."));
return;
}
const auto& caps = MG_Backend::pActiveBackendObject->GetDynamicParameters();
constexpr Uint8 kKeep = 0;
constexpr Uint8 kReplace = 1;
const auto isTrivial = [](Uint8 op) { return op == kKeep || op == kReplace; };
const char* refusal = nullptr;
if (!caps.FragmentShadingRateNonTrivialCombiners && (!isTrivial(op0) || !isTrivial(op1))) {
refusal = "MIN, MAX and MUL need GL_FRAGMENT_SHADING_RATE_NON_TRIVIAL_COMBINERS_SUPPORTED_EXT";
} else if (!caps.SupportsPrimitiveFragmentShadingRate && op0 != kKeep) {
refusal = "combinerOp0 must be KEEP without GL_EXT_fragment_shading_rate_primitive";
} else if (!caps.SupportsAttachmentFragmentShadingRate && op1 != kKeep) {
refusal = "combinerOp1 must be KEEP without GL_EXT_fragment_shading_rate_attachment";
}
if (refusal != nullptr) {
MG_State::pGLContext->RecordError(
ErrorCode::InvalidOperation,
MakeUnique<GenericErrorInfo>("MG_Impl/GLImpl", __func__,
String("glShadingRateCombinerOpsEXT: ") + refusal + "."));
return;
}
MG_State::pGLContext->SetShadingRateCombinerOps(op0, op1);
}
void PolygonMode_State(GLenum face, GLenum mode) {
// GL 3.3 core: separate front/back polygon modes were removed in 3.1, so the only legal
// face is GL_FRONT_AND_BACK. GL_FRONT / GL_BACK must be rejected (some desktop drivers
@@ -1069,6 +1125,14 @@ namespace MobileGL::MG_Impl::GLImpl {
ClipControl_State(origin, depth);
}
void ShadingRateEXT(GLenum rate) {
ShadingRateEXT_State(rate);
}
void ShadingRateCombinerOpsEXT(GLenum combinerOp0, GLenum combinerOp1) {
ShadingRateCombinerOpsEXT_State(combinerOp0, combinerOp1);
}
void PolygonMode(GLenum face, GLenum mode) {
PolygonMode_State(face, mode);
}
@@ -42,6 +42,9 @@ namespace MobileGL::MG_Impl::GLImpl {
void PolygonOffset(GLfloat factor, GLfloat units);
void PolygonOffsetClamp(GLfloat factor, GLfloat units, GLfloat clamp);
void ClipControl(GLenum origin, GLenum depth);
// GL_EXT_fragment_shading_rate
void ShadingRateEXT(GLenum rate);
void ShadingRateCombinerOpsEXT(GLenum combinerOp0, GLenum combinerOp1);
void PolygonMode(GLenum face, GLenum mode);
void PointSize(GLfloat size);
void PointParameterf(GLenum pname, GLfloat param);
+3 -3
View File
@@ -1298,9 +1298,9 @@ namespace MobileGL::MG_Impl {
GETPROC(glVertexArrayVertexAttribDivisorEXT, name);
GETPROC(glDrawArraysInstancedEXT, name);
GETPROC(glDrawElementsInstancedEXT, name);
// GETPROC(glGetFragmentShadingRatesEXT, name);
// GETPROC(glShadingRateEXT, name);
// GETPROC(glShadingRateCombinerOpsEXT, name);
GETPROC(glGetFragmentShadingRatesEXT, name);
GETPROC(glShadingRateEXT, name);
GETPROC(glShadingRateCombinerOpsEXT, name);
// GETPROC(glFramebufferShadingRateEXT, name);
// GETPROC(glDrawMeshTasksEXT, name);
// GETPROC(glDrawMeshTasksIndirectEXT, name);