mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-09-09 04:38:30 +09:00
swung0x48
9c773182bb
- Plan B section 4 makes the frontend/backend boundary explicit and gives the backend its
own state machine. This is the P0 deliverable of section 11: the whole catalogue exists
from day one, placeholders included, because the wire opcode is a call's position in
PipeCalls.def and record numbering must never churn.
- MG_Pipe/PipeCalls.def is the single source of truth: 68 unique calls as
X(Name, Payload, Class, Flags). Its header reconciles that number with the plan's
headline counts (section 4.4, appendix A), which double count - "CSO 15" names
bind_sampler_states and set_sampler_views that the "set_* 17" list also names, "screen
14" tabulates the query family that section 4.3 assigns to the context, and the
"transfer 12" row enumerates 11 calls. Each reconciliation is written down next to the
count rather than resolved silently.
- MGPipeHandles.h: the 8-byte {slot, gen} pair, dense per-kind slots, the reserved null
and default-framebuffer handles, and the ShaderCso composite band (sections 4.2, 5.6.3).
The two generations are documented as strictly separate, with the interface rule that no
call may require the client to know MGGen.
- MGPipeTypes.h: every payload of section 4.5 as a flat POD with explicit padding, a
trivial-copyability assertion and an exact sizeof assertion, because the wire records are
memcpy'd and a field silently changing width is a protocol break no test would see.
MGPCaps embeds DynamicBackendParameters by inclusion so a caps field added there needs no
second edit here; its assertion is stated as a composition because that struct still
carries SizeT. ResidualValueBlock is pinned at MGL_RESIDUAL_BLOCK_SIZE 1248, the ratchet
that only ever goes down and reaches static_assert(... == 0) in P13 (section 6.3).
- MGPipeHostSpan.h keeps the one shape that changes with the transport isolated behind one
predictable branch, with the kFromServerIndexMirror sentinel D-B7 needs.
- MGPipeCallbacks.h names the reverse channel as ten callbacks plus the forward terminator
in the context table, replacing 95 poke sites across 17 methods (section 7.1).
- scripts/gen_pipe.py runs G1-G7 off those .def files. G1 asserts each table is EXACTLY its
call count of function pointers; G3 pads every wire record to the stream's 8-byte
granularity and checks size >= sizeof && size <= remaining && size % 8 == 0 before
dispatch, fatally; G4 compares field by field (padding excluded, floats by bits) because
a comparator with false positives is one nobody reads - DirectGLES.cpp says the same
thing about its own memcmp of RenderStateParameters; G5 turns the accessor list into
per-verb poison generations rather than a written-once bitmap, which is the only version
that can see a field left over from the previous draw (section 6.2.2); G6 joins the 477
read points of the vendored backend_read_inventory.md against Coverage.def and reports
0 UNMAPPED (299 to a call, 167 signatures that become handle parameters, 6 reverse
channel, 5 client-resolved); G7 pins the pipeline subset BY MEMBER NAME from what
VulkanRenderer::ComputePipelineStateHash hashes today, computing no offsets in python.
- The generated files are committed so the build never depends on python; CI regenerates
and diffs them.
109 lines
5.5 KiB
PHP
109 lines
5.5 KiB
PHP
// MobileGL - MobileGL/MG_Pipe/generated/PipeCoverage.inc
|
|
// 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
|
|
|
|
// G6: backend read inventory -> MGPipe call coverage.
|
|
//
|
|
// GENERATED by scripts/gen_pipe.py from Coverage.def and scripts/data/backend_read_inventory.md - DO NOT EDIT.
|
|
// Regenerate with `python3 scripts/gen_pipe.py`; CI runs it and diffs the result.
|
|
// This file is included from MG_Pipe/MGPipe.h inside namespace MobileGL::MG_Pipe.
|
|
|
|
// The acceptance rule (plan B section 10.3-5): regenerate, `git diff --exit-code`, and
|
|
// ZERO unmapped rows. P0 permits unmapped rows and only counts them; the count below is
|
|
// the number the later gate has to drive to zero.
|
|
//
|
|
// Three pseudo-calls stand for read points that never become a forward record:
|
|
// kClientResolved (the frontend answers it), kReverseChannel (it becomes one of the ten
|
|
// MGPipeCallbacks) and kStructuralHandle (the row is a signature carrying a
|
|
// SharedPtr<MG_State...> that becomes an MGPipeHandle parameter).
|
|
|
|
struct MGPipeCoverageEntry {
|
|
const char* Accessor;
|
|
const char* Call;
|
|
Uint32 ReadPoints;
|
|
};
|
|
|
|
inline constexpr MGPipeCoverageEntry kMGPipeCoverage[] = {
|
|
{"Buffer ops delta", "ResourceRespecify", 17},
|
|
{"GetActiveTextureUnit", "SetSamplerViews", 8},
|
|
{"GetBlendColor", "SetDynamicState", 1},
|
|
{"GetBlendEquationIndexed", "CreateRenderState", 1},
|
|
{"GetBlendFuncIndexed", "CreateRenderState", 1},
|
|
{"GetBoundTransformFeedbackName", "SetStreamOutputTargets", 1},
|
|
{"GetBoundVertexArray", "BindVertexElements", 12},
|
|
{"GetBufferBindingPoint", "SetShaderBuffers", 19},
|
|
{"GetBufferBindingPointCount", "SetShaderBuffers", 3},
|
|
{"GetBufferBindingSlot", "SetIndirectBuffers", 29},
|
|
{"GetClampReadColor", "SetDynamicState", 1},
|
|
{"GetClearColor", "SetDynamicState", 1},
|
|
{"GetClearDepth", "SetDynamicState", 1},
|
|
{"GetClearStencil", "SetDynamicState", 1},
|
|
{"GetColorMaskIndexed", "CreateRenderState", 6},
|
|
{"GetCullFaceMode", "CreateRenderState", 1},
|
|
{"GetCurrentVertexAttribute", "SetVertexAttribDefaults", 2},
|
|
{"GetDepthFunc", "CreateRenderState", 1},
|
|
{"GetDepthMask", "CreateRenderState", 5},
|
|
{"GetDepthRangeIndexed", "SetDynamicState", 1},
|
|
{"GetFramebufferBindingSlot", "SetFramebufferState", 19},
|
|
{"GetImageTextureBinding", "SetShaderImages", 14},
|
|
{"GetLineWidth", "SetDynamicState", 1},
|
|
{"GetLogicOp", "CreateRenderState", 1},
|
|
{"GetMaxTouchedTextureUnit", "SetSamplerViews", 1},
|
|
{"GetMinSampleShadingValue", "CreateRenderState", 1},
|
|
{"GetPatchDefaultInnerLevel", "SetPatchState", 3},
|
|
{"GetPatchDefaultOuterLevel", "SetPatchState", 3},
|
|
{"GetPatchVertices", "SetPatchState", 3},
|
|
{"GetPipelineStateVersion", "BindRenderState", 3},
|
|
{"GetPixelStoreParameters", "SetPixelPackState", 6},
|
|
{"GetPolygonModeFront", "CreateRenderState", 1},
|
|
{"GetPolygonOffsetFactor", "SetDynamicState", 1},
|
|
{"GetPolygonOffsetUnits", "SetDynamicState", 1},
|
|
{"GetPrimitiveRestartIndex", "DrawVbo", 3},
|
|
{"GetProgramForDispatch", "SetDispatchProgram", 3},
|
|
{"GetProgramForDraw", "SetDrawProgram", 7},
|
|
{"GetProgramObject", "CreateShaderState", 3},
|
|
{"GetProvokingVertexMode", "CreateRenderState", 1},
|
|
{"GetRenderStateParameters", "CreateRenderState", 11},
|
|
{"GetRenderStateParametersVersion", "BindRenderState", 2},
|
|
{"GetSamplingResolutionGeneration", "SetSamplerViews", 9},
|
|
{"GetScissorBox", "SetDynamicState", 3},
|
|
{"GetStencilState", "CreateRenderState", 8},
|
|
{"GetTextureBindGeneration", "SetSamplerViews", 5},
|
|
{"GetTextureContextId", "SetSamplerViews", 6},
|
|
{"GetTextureObject", "SetSamplerViews", 1},
|
|
{"GetTextureUnitObject", "SetSamplerViews", 19},
|
|
{"GetTouchedBufferBindingPointCount", "SetShaderBuffers", 2},
|
|
{"GetTransformFeedbackCapturedVertices", "DrawVbo", 1},
|
|
{"GetTransformFeedbackGeneration", "SetStreamOutputTargets", 1},
|
|
{"GetTransformFeedbackPausedPrimitiveCounter", "EndStreamOutput", 2},
|
|
{"GetTransformFeedbackProgram", "SetStreamOutputTargets", 3},
|
|
{"GetViewport", "SetDynamicState", 1},
|
|
{"GetViewportIndexed", "SetDynamicState", 1},
|
|
{"InvalidateCompileEnv", "kClientResolved", 2},
|
|
{"IsCapabilityEnabled", "CreateRenderState", 29},
|
|
{"IsCapabilityEnabledIndexed", "CreateRenderState", 1},
|
|
{"IsTransformFeedbackActive", "BeginStreamOutput", 5},
|
|
{"IsTransformFeedbackPaused", "PauseStreamOutput", 2},
|
|
{"RecordError", "kReverseChannel", 6},
|
|
{"ValidateProgramName", "kClientResolved", 3},
|
|
{"handle-ify (wire handle)", "kStructuralHandle", 167},
|
|
};
|
|
|
|
inline constexpr SizeT kMGPipeCoverageEntryCount = 63;
|
|
inline constexpr Uint32 kMGPipeInventoryReadPoints = 477;
|
|
inline constexpr Uint32 kMGPipeInventoryMappedToCall = 299;
|
|
inline constexpr Uint32 kMGPipeInventoryClientResolved = 5;
|
|
inline constexpr Uint32 kMGPipeInventoryReverseChannel = 6;
|
|
inline constexpr Uint32 kMGPipeInventoryStructuralHandle = 167;
|
|
inline constexpr Uint32 kMGPipeInventoryUnmapped = 0;
|
|
static_assert(kMGPipeCoverageEntryCount == sizeof(kMGPipeCoverage) / sizeof(kMGPipeCoverage[0]));
|
|
static_assert(kMGPipeInventoryMappedToCall + kMGPipeInventoryClientResolved +
|
|
kMGPipeInventoryReverseChannel + kMGPipeInventoryStructuralHandle +
|
|
kMGPipeInventoryUnmapped ==
|
|
kMGPipeInventoryReadPoints,
|
|
"every inventory row must land in exactly one bucket");
|