mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-17 15:03:25 +09:00
[Docs] (.claude/skills, .github/workflows, CMakeLists.txt, docs/archive, docs/Disaggregated, docs/MobileVA, docs/Performance, MG_Backend, MG_Backend/DirectGLES, MG_Backend/DirectVulkan, MG_Backend/Record, MG_Gbm, MG_Impl, MG_Impl/EGLImpl, MG_Impl/GLImpl, MG_Impl/GLXImpl, MG_Impl/Pipe, MG_IntegrationTest, MG_IntegrationTest/Harness, MG_IntegrationTest/Scenarios, MG_Pipe, MG_Pipe/generated, MG_Remote, MG_Remote/Client, MG_Remote/Server, MG_Remote/Transport, MG_Remote/Wire, MG_State/GLState, MG_Test/Pipe, MG_Test/Util, MG_Test/Wire, MobileGL, scripts, scripts/data, tools/device_bench, userguide): archive the planning notes and agent contracts under docs/archive
- DEBTS.md and OPEN-QUESTIONS.md stay maintained, now in docs/Disaggregated.
This commit is contained in:
@@ -2525,7 +2525,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
mgl_itest_register_split_arms("TextureUnitSamplingScenario.*" "")
|
||||
mgl_itest_register_split_arms("TriangleScenario.*" "")
|
||||
mgl_itest_register_split_arms("PersistentCoherentMapScenario.*" "")
|
||||
# P11 A2 (MG_Remote/CONTRACT-P11.md §2): the >= 16 MiB arena on all three arms. Its tier case
|
||||
# P11 A2 (docs/archive/contracts/CONTRACT-P11.md §2): the >= 16 MiB arena on all three arms. Its tier case
|
||||
# is declared emulated per entry by SplitLogPaths (T2: every acquisition declines); the mpr and
|
||||
# adopt-tier assertions are registered only in their configured controls. The Magma arms are the
|
||||
# gated `Arena.` block beside `Pbo.` / `Fence.` below, plus the Buffers lane.
|
||||
@@ -2670,14 +2670,14 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
# buffer, depth and packed depth/stencil, and glGetTexImage's windowed twin. The Magma arms of
|
||||
# the same cases are the `Band.` block after the Fm lane below.
|
||||
mgl_itest_register_split_arms("BandedReadbackScenario.*" "")
|
||||
# P9 (W1, MG_Remote/CONTRACT-P9.md §1): the pack-buffer readback crosses as
|
||||
# P9 (W1, docs/archive/contracts/CONTRACT-P9.md §1): the pack-buffer readback crosses as
|
||||
# read_pixels_to_buffer / get_texture_image_to_buffer and is answered by nothing. Six parity
|
||||
# cases (every pack parameter, the map reader, a byte swap, a layered glGetTexImage, an upload
|
||||
# FROM the buffer the read filled, a later write over part of it) and the wire case (no
|
||||
# reply-slot record, one mark per read). The Magma arms are the `Pbo.` block after the Band
|
||||
# block below.
|
||||
mgl_itest_register_split_arms("PackBufferReadbackScenario.*" "")
|
||||
# P10 (A, MG_Remote/CONTRACT-P10.md §1): fence polls answered from kEventFenceSignaled - the
|
||||
# P10 (A, docs/archive/contracts/CONTRACT-P10.md §1): fence polls answered from kEventFenceSignaled - the
|
||||
# idiom's poll loops end (with and without the flush bit), a signaled fence's polls cross
|
||||
# nothing, and an idle server still reports a fence that finishes. The Magma arms are the
|
||||
# `Fence.` block beside the `Pbo.` block below.
|
||||
@@ -2920,7 +2920,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
)
|
||||
endforeach()
|
||||
|
||||
# ---- P5b package i1 (MG_Remote/CONTRACT-P5B.md §2 i1) --------------------------------
|
||||
# ---- P5b package i1 (docs/archive/contracts/CONTRACT-P5B.md §2 i1) --------------------------------
|
||||
#
|
||||
# THE LANE CASE THAT PROVES THE RECORDS CROSSED, and it is a RESULT and not a probe (R-16:
|
||||
# a probe may not arm against a stub). Each of these four scenarios asserts a value that
|
||||
@@ -2980,7 +2980,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
#
|
||||
# The ROADMAP's `TextureRemintPullScenario`, and it proves the opposite of its name: the
|
||||
# server re-mints from the GPU level and its own staged store, so no pull protocol exists
|
||||
# (notes/p9/W2-REMINT.md). Espryt's three arms here; the Magma arms are laid by hand in the
|
||||
# (docs/archive/notes/p9/W2-REMINT.md). Espryt's three arms here; the Magma arms are laid by hand in the
|
||||
# `DirectVulkan.<arm>.Remint.` block, where the gated Magma flavour lives; both backends' monolith
|
||||
# entries come from the whole-binary discovery.
|
||||
mgl_itest_register_split_arms("TextureRemintPullScenario.*" "")
|
||||
@@ -3039,7 +3039,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
|
||||
# ---- P5b t2: the transform-feedback spans, the XFB object bind, the patch parameter -------
|
||||
#
|
||||
# MG_Remote/CONTRACT-P5B.md §2 t2. The three P5 lanes above are the REDUCED PATH's targets
|
||||
# docs/archive/contracts/CONTRACT-P5B.md §2 t2. The three P5 lanes above are the REDUCED PATH's targets
|
||||
# (a clear, a triangle, a persistent map); these two are the first lane entries whose GREEN
|
||||
# DEPENDS ON A t2 RECORD HAVING CROSSED AND BEEN APPLIED BY THE BACKEND, which is the only
|
||||
# statement a package flipping a verb can make that a unit case cannot:
|
||||
@@ -3084,7 +3084,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
# block as the XfbQuery. ones.
|
||||
mgl_itest_register_split_arms("XfbPrimitiveQueryScenario.*" "")
|
||||
|
||||
# ---- P5e package vi (MG_Remote/CONTRACT-P5E.md §5.1, ID-82 / ruling 2) --------------------
|
||||
# ---- P5e package vi (docs/archive/contracts/CONTRACT-P5E.md §5.1, ID-82 / ruling 2) --------------------
|
||||
#
|
||||
# Client-memory vertices and indices now cross as owned ordinary buffers.
|
||||
# Keep the original names and private logs; all six scenarios join the full
|
||||
@@ -3253,7 +3253,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
#
|
||||
# PLAN-PH-P34B-P7.md 1.2, "门:纹理 / program 场景 split 覆盖". Each candidate was run once
|
||||
# under MOBILEGL_TRANSPORT=inproc on build-split and its FIRST BLOCKER recorded; the row per
|
||||
# scenario x backend x blocker is in notes/p34b/split-scenario-census.md. What follows is the
|
||||
# scenario x backend x blocker is in docs/archive/notes/p34b/split-scenario-census.md. What follows is the
|
||||
# result of that census, not a guess: every scenario listed here passed, and every case that
|
||||
# did not is excluded BY NAME below with its blocker.
|
||||
#
|
||||
@@ -3301,7 +3301,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
# case that produced no record RED for having nothing to say - which is the rule working, not
|
||||
# a defect. They stay unregistered for that reason and are listed in the census note.
|
||||
|
||||
# P8-E (docs/Disaggregated/notes/p8/E.md): glCopyImageSubData into a level the driver will not
|
||||
# P8-E (docs/archive/notes/p8/E.md): glCopyImageSubData into a level the driver will not
|
||||
# read back, then glGetTexImage. The knob-free cases on Espryt's three arms; Magma's gated arms
|
||||
# are the `DirectVulkan.<arm>.CopyStore.` entries just below; both monolith entries come from
|
||||
# the whole-binary discovery.
|
||||
@@ -3483,7 +3483,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
ENVIRONMENT "${MGL_ITEST_GLES_SPLIT_STRICT_ENVIRONMENT}"
|
||||
)
|
||||
|
||||
# P8-B: glGenerateMipmap ON ESPRYT'S SERVER (notes/p8/B.md). The window a record names (B1) and
|
||||
# P8-B: glGenerateMipmap ON ESPRYT'S SERVER (docs/archive/notes/p8/B.md). The window a record names (B1) and
|
||||
# RGB16F / RGB32F (B2) on the three Espryt arms; the Magma control is the gated
|
||||
# `DirectVulkan.<arm>.Mip.` block beside `Remint.`, and both monoliths come from the ambient
|
||||
# discovery. The FORCED-CPU entries run the three-channel cases with
|
||||
@@ -3713,7 +3713,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
#
|
||||
# Making the tcp lane able to carry these would need the fixture to take a per-case
|
||||
# server environment - a supervisor control, not a ctest property - and that is a debt,
|
||||
# recorded in notes/p7/magma-b2.md §6.
|
||||
# recorded in docs/archive/notes/p7/magma-b2.md §6.
|
||||
set(mglItestServerEnvKnobArm TRUE)
|
||||
if(mglItestArm STREQUAL "Tcp")
|
||||
set(mglItestServerEnvKnobArm FALSE)
|
||||
@@ -4158,7 +4158,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
${mglItestArmProperties}
|
||||
ENVIRONMENT "${mglItestMagmaBandEnvironment}\;MOBILEGL_LOG_FILE_PATH=${CMAKE_CURRENT_BINARY_DIR}/p10-fence${mglItestArmLogTag}-${fenceCase}.log")
|
||||
endforeach()
|
||||
# P11 A2 (MG_Remote/CONTRACT-P11.md §2): the >= 16 MiB arena on Magma's three arms, in the
|
||||
# P11 A2 (docs/archive/contracts/CONTRACT-P11.md §2): the >= 16 MiB arena on Magma's three arms, in the
|
||||
# same flavour, declared per arm (mglItestArenaArm above); DirectVulkan.ArenaArm. is its
|
||||
# monolith (adopted) half.
|
||||
foreach(arenaCase IN LISTS MGL_ITEST_ARENA_CASES)
|
||||
@@ -4231,7 +4231,7 @@ endif()
|
||||
|
||||
# P9 W2: THE TEXTURE RE-MINT ON MAGMA, all three arms, GATED. A storage-usage upgrade recreates
|
||||
# the VkImage and copies the old one into it GPU to GPU (PreserveTextureContentsOnRecreate), so
|
||||
# no byte comes from the client here either (notes/p9/W2-REMINT.md). The gated band flavour
|
||||
# no byte comes from the client here either (docs/archive/notes/p9/W2-REMINT.md). The gated band flavour
|
||||
# (role-split state, strict errors, run-ahead), one entry per case for a private log each.
|
||||
if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
foreach(mglItestArm IN LISTS MGL_ITEST_MAGMA_ARMS)
|
||||
@@ -4493,7 +4493,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
PersistentCoherentMapScenario.AWriteAfterAFrameBoundaryReachesTheNextFramesDraw
|
||||
StorageBufferRegrowScenario.AGrownStoreIsVisibleThroughItsExistingIndexedBinding
|
||||
# P11 A2: the >= 16 MiB arena, the flavour's MGITEST_PERSISTENT_MAP_ARM=emulated
|
||||
# asserted by its tier case (MG_Remote/CONTRACT-P11.md §2).
|
||||
# asserted by its tier case (docs/archive/contracts/CONTRACT-P11.md §2).
|
||||
LargeArenaAdoptionScenario.SubDataAfterAnInFlightDrawReachesTheNextDraw
|
||||
LargeArenaAdoptionScenario.RespecifiedVertexArenaKeepsVaoBindings
|
||||
LargeArenaAdoptionScenario.RespecifiedIndexArenaKeepsVaoBinding
|
||||
@@ -4698,7 +4698,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
endforeach()
|
||||
endif()
|
||||
|
||||
# P5c ct (MG_Remote/CONTRACT-P5C.md §5): the two control records, split-only source for the
|
||||
# P5c ct (docs/archive/contracts/CONTRACT-P5C.md §5): the two control records, split-only source for the
|
||||
# same reason as f1's - the scenario reads the SERVER sink's tallies, which a monolith build
|
||||
# has no symbol for. One block per case with a LOG PATH OF ITS OWN, the F1 pattern:
|
||||
# SplitLogPaths.PrivateAndDistinct fails a lane whose cases share one file, and the death
|
||||
@@ -4920,7 +4920,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
include(${CMAKE_CURRENT_SOURCE_DIR}/P8Coverage.cmake)
|
||||
endif()
|
||||
|
||||
# P8-D: the Magma wire arm issues indirect draws natively (docs/Disaggregated/notes/p8/D.md).
|
||||
# P8-D: the Magma wire arm issues indirect draws natively (docs/archive/notes/p8/D.md).
|
||||
# Public GL, so the source joins the binary unguarded and the ambient `DirectGLES.` /
|
||||
# `DirectVulkan.` monolith discovery runs it too. Split arms: DirectGLES through the registration
|
||||
# macro (which also replays it on Magma's informational tier), Magma's gated tier by hand, all
|
||||
@@ -4955,7 +4955,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
endforeach()
|
||||
endif()
|
||||
|
||||
# P8-SE (docs/Disaggregated/notes/p8/SE.md): Espryt split residuals.
|
||||
# P8-SE (docs/archive/notes/p8/SE.md): Espryt split residuals.
|
||||
if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
# The default framebuffer's depth/stencil format reaches a spawn / tcp client now (the server
|
||||
# process has no frontend placeholder, and the publish used to return on it before posting),
|
||||
@@ -4993,7 +4993,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED)
|
||||
PipeCatalogue.UnmigratedEmulationSitesMatchTheList PROPERTIES LABELS unit TIMEOUT 60)
|
||||
endif()
|
||||
|
||||
# P8-SV: Magma split residuals (docs/Disaggregated/notes/p8/SV.md) - the 3D native mip blit's layer
|
||||
# P8-SV: Magma split residuals (docs/archive/notes/p8/SV.md) - the 3D native mip blit's layer
|
||||
# count, the 1D depth mip decline, the depth/stencil mip decline's tally row (asserted inside
|
||||
# F1WireScenario) and the wire arm's native glDispatchComputeIndirect. Public GL, so the sources join
|
||||
# the binary unguarded and the ambient `DirectGLES.` / `DirectVulkan.` monolith discovery runs them
|
||||
@@ -5193,7 +5193,7 @@ endif()
|
||||
# THIS IS WHERE THE @P7 REFUSALS LIVE. None of tier 2's scenarios reaches one; the readback
|
||||
# matrices, the same-texture copy shapes and the odd-offset uniform ranges do, and they are in
|
||||
# this set and nowhere else in the disaggregated registry. THE FIRST RUN'S RED LIST IS WHAT
|
||||
# WAVE 2's CLUSTERS ARE SCHEDULED FROM - see notes/p7/magma-two-process-first-run.md.
|
||||
# WAVE 2's CLUSTERS ARE SCHEDULED FROM - see docs/archive/notes/p7/magma-two-process-first-run.md.
|
||||
#
|
||||
# IN NO CI GATING STEP, and that is the whole design: a lane that must be green cannot carry a
|
||||
# census. A case leaves this tier for a gated one with the commit that retires its blocker.
|
||||
@@ -5346,7 +5346,7 @@ if (MOBILEGL_BUILD_DISAGGREGATED AND MOBILEGL_PIPE_VERIFY)
|
||||
# (GL error 0x0502 where the decline promises none, or none where it promises one; the
|
||||
# overlap copy writes the level the decline leaves alone) - because Espryt does not decline
|
||||
# those shapes at all. That is a finding about the DirectGLES whole-binary set on split, not
|
||||
# about verify, and it is recorded in notes/p7/verify-split.md rather than hidden in a green.
|
||||
# about verify, and it is recorded in docs/archive/notes/p7/verify-split.md rather than hidden in a green.
|
||||
# This lane was NOT the only DirectGLES split lane to reach them: the primary integration job
|
||||
# runs every integration-gpu entry under MOBILEGL_TRANSPORT=inproc, and there the same four
|
||||
# were red in CI (the depth-stencil and overlap pair from run 35781886930, the two blits from
|
||||
|
||||
@@ -31,7 +31,7 @@
|
||||
# are the monolith-arm and the no-pulled-read scenarios, 4 skips are the two PersistentMapArm-
|
||||
# and two StrictArming-only cases skipping outside their own lanes, all by design).
|
||||
# Entry counts are first-blocker counts: an entry aborts on its FIRST pulled read, so retiring
|
||||
# a row advances those entries to their next one. See docs/Disaggregated/notes/p5f/f1-report.md.
|
||||
# a row advances those entries to their next one. See docs/archive/notes/p5f/f1-report.md.
|
||||
# ---------------------------------------------------------------------------------------------
|
||||
#
|
||||
# P5f wave 2: the expected set is empty after fc -> fe -> fm integration.
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
# monolith DirectGLES. / DirectVulkan. case is on a gated split arm or is named, with a reason
|
||||
# class, in scripts/data/split_coverage_exemptions.txt. Deleting a line below reds it BY NAME.
|
||||
# The per-case census this list was cut from (inproc / spawn / tcp, junit per arm) is
|
||||
# docs/Disaggregated/notes/p8/A.md.
|
||||
# docs/archive/notes/p8/A.md.
|
||||
|
||||
# ---- (a) THE AMBIENT CASES -----------------------------------------------------------------
|
||||
#
|
||||
@@ -190,7 +190,7 @@ set(MGL_P8A_KNOB_FILTER_WidenedPacked16 "CopyImagePacked16Scenario.*")
|
||||
set(MGL_P8A_KNOB_ENV_WidenedPacked16 "MOBILEGL_ESPRYT_WIDEN_PACKED16_STORAGE=1")
|
||||
# ForcedDs keeps the spelling the existing Split/Spawn DepthStencilReadbackMatrix block uses. The
|
||||
# default-framebuffer case was left out here while it was red on spawn and tcp; P8-SE fixed it
|
||||
# (notes/p8/SE.md) and it runs under the knob on every arm like the rest.
|
||||
# (docs/archive/notes/p8/SE.md) and it runs under the knob on every arm like the rest.
|
||||
set(MGL_P8A_KNOB_FILTER_ForcedDs
|
||||
"DepthStencilReadbackScenario.*:DepthStencilReadbackAttachmentShapeScenario.*")
|
||||
set(MGL_P8A_KNOB_ENV_ForcedDs "MOBILEGL_ESPRYT_FORCE_DS_READBACK_EMULATION=1")
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
// End of Source File Header
|
||||
//
|
||||
// Scenario - glCopyImageSubData INTO A LEVEL THE DRIVER WILL NOT READ BACK (P8-E,
|
||||
// docs/Disaggregated/notes/p8/E.md).
|
||||
// docs/archive/notes/p8/E.md).
|
||||
//
|
||||
// The formats are the ones an ES driver keeps as texture-only storage: GL_RGB16 (EXT_texture_norm16
|
||||
// makes the three-channel spelling sampleable, never colour-renderable) and the 16-bit SNORM family
|
||||
@@ -28,13 +28,13 @@
|
||||
// (WireTextureReadback.inc, ReadTextureImageWire): a colour level of exactly that extent is
|
||||
// treated as a level the driver refused to attach - what a driver without EXT_texture_norm16 /
|
||||
// EXT_render_snorm does for these formats (an Adreno 750, which has both, reads them all back
|
||||
// through the GPU; measured in P13), and what llvmpipe can be made to do no other way. The `DirectGLES.<arm>.StoreRead.`
|
||||
// entries set it, and this scenario then builds its textures at THAT extent instead of the default
|
||||
// one - so the knob is scoped by the extent, and the tcp lane's shared supervisor can carry it
|
||||
// (the TcpServer.Start fixture's ENVIRONMENT) without touching any other entry, this scenario's
|
||||
// own knob-free tcp entries included. Under the knob every read must still be right, and the
|
||||
// server log must name the store route - otherwise the entry would be pinning the GPU route a
|
||||
// second time under a name that claims otherwise.
|
||||
// through the GPU; measured in P13), and what llvmpipe can be made to do no other way. The
|
||||
// `DirectGLES.<arm>.StoreRead.` entries set it, and this scenario then builds its textures at
|
||||
// THAT extent instead of the default one - so the knob is scoped by the extent, and the tcp
|
||||
// lane's shared supervisor can carry it (the TcpServer.Start fixture's ENVIRONMENT) without
|
||||
// touching any other entry, this scenario's own knob-free tcp entries included. Under the knob
|
||||
// every read must still be right, and the server log must name the store route - otherwise the
|
||||
// entry would be pinning the GPU route a second time under a name that claims otherwise.
|
||||
|
||||
#include <cstdint>
|
||||
#include <cstdio>
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
// SPDX-License-Identifier: LGPL-3.0-only
|
||||
// End of Source File Header
|
||||
|
||||
// P5c ct (MG_Remote/CONTRACT-P5C.md §5): the two control records, end to end over inproc.
|
||||
// P5c ct (docs/archive/contracts/CONTRACT-P5C.md §5): the two control records, end to end over inproc.
|
||||
//
|
||||
// applier_reset (§5.1): this process's first validate primes the pipe tracker, and the
|
||||
// FreshlyPrimed edge is the record's producer (MG_Impl/Pipe/PipeFill.cpp). What the scenario
|
||||
@@ -155,7 +155,7 @@ namespace {
|
||||
// (DirectVulkan.cpp, CONTRACT-P7 §5.5) and emits the same `object_death`. Package L
|
||||
// measured that the SPAWN arm already passed once the WireTables install condition
|
||||
// went backend-agnostic and that the INPROC arm failed here with `deaths` 0 vs 0
|
||||
// (notes/p7/magma-two-process-first-run.md §6); the table is what closes the inproc
|
||||
// (docs/archive/notes/p7/magma-two-process-first-run.md §6); the table is what closes the inproc
|
||||
// half, and this case is the gate on it. It is also the RED-ONCE for that table: with
|
||||
// the install site short-circuited, both cases red on the two EXPECT_GT below.
|
||||
const GLubyte red[4] = {255, 0, 0, 255};
|
||||
@@ -259,7 +259,7 @@ namespace {
|
||||
// "A SPLIT BUILD RUNS AT TIER T2 AND DECLINES EVERY ACQUISITION, ALWAYS"; T0/T1 are
|
||||
// unimplemented, refused by name at the handshake since P11 A1). So the capability is wired
|
||||
// AHEAD of its consumer on purpose, and `rsd=` on the PipeStats line is the counter that
|
||||
// will show the records the day P11 lands a tier that adopts. See notes/p7/magma-c.md.
|
||||
// will show the records the day P11 lands a tier that adopts. See docs/archive/notes/p7/magma-c.md.
|
||||
TEST_F(CtWireScenario, TheServerPublishesTheResidentSubDataCapabilityFromItsOwnTable) {
|
||||
if (!Ready()) return;
|
||||
// A REAL WORKLOAD FIRST, and it is not decoration: ScenarioFixture's arming rule
|
||||
|
||||
@@ -534,7 +534,7 @@ namespace MGITest {
|
||||
// THE CASE IS ARMED ON THE MAGMA WIRE ARM ONLY, and the two gates below say which of the
|
||||
// other arms that discover it (the suite is registered whole on the monolith DirectVulkan
|
||||
// arm and on every DirectGLES arm) owe this picture and do not yet produce it. Both are
|
||||
// recorded debts (notes/p7/magma-b2.md §6), not agreements with the wrong answer:
|
||||
// recorded debts (docs/archive/notes/p7/magma-b2.md §6), not agreements with the wrong answer:
|
||||
// - Espryt (DirectGLES, monolith and split alike): the flipped resolve writes nothing and
|
||||
// raises no error, and the scaled one raises no error either. P3b/P4b.
|
||||
// - the monolith DirectVulkan arm: `VulkanRenderer.cpp` refuses a depth blit with a
|
||||
@@ -560,17 +560,19 @@ namespace MGITest {
|
||||
TEST_F(DepthStencilReadbackMatrixScenario, AFlippedMultisampleResolveMirrorsTheBandsAndAScaleDeclines) {
|
||||
if (!Ready()) return;
|
||||
if (Gl().BackendName() != "DirectVulkan") {
|
||||
GTEST_SKIP() << "Espryt (" << Gl().BackendName() << ") does not produce this picture yet: a "
|
||||
GTEST_SKIP() << "Espryt (" << Gl().BackendName()
|
||||
<< ") does not produce this picture yet: a "
|
||||
"flipped multisample depth resolve writes nothing with no error and a scaled "
|
||||
"one raises no INVALID_OPERATION - a P3b/P4b debt (notes/p7/magma-b2.md §6)";
|
||||
"one raises no INVALID_OPERATION - a P3b/P4b debt (docs/archive/notes/p7/magma-b2.md §6)";
|
||||
}
|
||||
if (!PeekSplitRuntime().transportResolved) {
|
||||
GTEST_SKIP() << "the monolith DirectVulkan transport (this process resolved no split "
|
||||
"transport, so BlitFramebuffer takes the monolith arm) refuses a flipped "
|
||||
"depth blit (\"depth blits with flipped rectangles are not supported yet\", "
|
||||
"destination untouched, no error) and scales a multisample depth blit GL "
|
||||
"calls INVALID_OPERATION - a wire-vs-monolith divergence where the wire arm "
|
||||
"is the correct one; the monolith fix is P13/G1-bound (notes/p7/magma-b2.md §6)";
|
||||
GTEST_SKIP()
|
||||
<< "the monolith DirectVulkan transport (this process resolved no split "
|
||||
"transport, so BlitFramebuffer takes the monolith arm) refuses a flipped "
|
||||
"depth blit (\"depth blits with flipped rectangles are not supported yet\", "
|
||||
"destination untouched, no error) and scales a multisample depth blit GL "
|
||||
"calls INVALID_OPERATION - a wire-vs-monolith divergence where the wire arm "
|
||||
"is the correct one; the monolith fix is P13/G1-bound (docs/archive/notes/p7/magma-b2.md §6)";
|
||||
}
|
||||
DepthSource multisampled = MakeRenderbufferSource(GL_DEPTH24_STENCIL8, 4);
|
||||
if (!SourceIsUsable()) {
|
||||
|
||||
@@ -1175,7 +1175,7 @@ TEST_F(F1WireScenario, SubWordUniformBufferRangePadsMissingBytes) {
|
||||
// The sibling of ShortUniformBufferRangePadsMissingBytes whose bound range does NOT
|
||||
// end on a four-byte boundary. That window is what `uniform-buffer-byte-tail`
|
||||
// used to refuse (a named Fatal that took the whole session with it), and it is the
|
||||
// live boundary the Redmi Minecraft run reported (notes/p5f/magma-inproc-fix.md #5).
|
||||
// live boundary the Redmi Minecraft run reported (docs/archive/notes/p5f/magma-inproc-fix.md #5).
|
||||
//
|
||||
// Only the SIZE can land off a word here. glBindBufferRange constrains the offset to
|
||||
// GL_UNIFORM_BUFFER_OFFSET_ALIGNMENT and records GL_INVALID_VALUE otherwise
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
// SPDX-License-Identifier: LGPL-3.0-only
|
||||
// End of Source File Header
|
||||
//
|
||||
// P10 (A, MG_Remote/CONTRACT-P10.md §1): FENCE POLLS ANSWERED FROM THE REVERSE CHANNEL.
|
||||
// P10 (A, docs/archive/contracts/CONTRACT-P10.md §1): FENCE POLLS ANSWERED FROM THE REVERSE CHANNEL.
|
||||
//
|
||||
// A glClientWaitSync / glGetSynciv(GL_SYNC_STATUS) used to be a kWaitReply record: its answer
|
||||
// came back only after the server had applied every record before it, so a poll was a full
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
// End of Source File Header
|
||||
//
|
||||
// Scenario - glGenerateMipmap ON THE FORMATS ESPRYT DOES NOT HAND STRAIGHT TO THE DRIVER
|
||||
// (P8-B, docs/Disaggregated/notes/p8/B.md).
|
||||
// (P8-B, docs/archive/notes/p8/B.md).
|
||||
//
|
||||
// Espryt generates R11F_G11F_B10F and depth chains with per-level blits, and RGB16F / RGB32F
|
||||
// chains outside glGenerateMipmap because ES refuses a three-channel float format there. Until
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
// SPDX-License-Identifier: LGPL-3.0-only
|
||||
// End of Source File Header
|
||||
//
|
||||
// Scenario - THE DRAW FAMILY P5b's d1 PUTS ON THE WIRE (MG_Remote/CONTRACT-P5B.md §2 d1): one
|
||||
// Scenario - THE DRAW FAMILY P5b's d1 PUTS ON THE WIRE (docs/archive/contracts/CONTRACT-P5B.md §2 d1): one
|
||||
// VBO, one EBO, one program, one VAO, and one picture per draw entry point whose correctness
|
||||
// DEPENDS on the fields that entry point adds to draw_vbo. Two quads live in the vertex buffer,
|
||||
// a left one and a right one, and every case draws exactly one of them or both through a
|
||||
|
||||
@@ -611,7 +611,7 @@ void main() { word = 0xC0FFEEu; }
|
||||
<< window.line;
|
||||
}
|
||||
|
||||
// P11 A2 (MG_Remote/CONTRACT-P11.md §2): WHICH TIER THE ARENA REALLY LANDED IN. The cases above
|
||||
// P11 A2 (docs/archive/contracts/CONTRACT-P11.md §2): WHICH TIER THE ARENA REALLY LANDED IN. The cases above
|
||||
// are green whether the arena adopted or stayed emulated, so the lane declares the arm
|
||||
// (MGITEST_PERSISTENT_MAP_ARM) and this case asserts it, the way
|
||||
// PersistentCoherentMapScenario.TheMapLandsInTheArmItsLaneDeclares does for a sub-16-MiB map.
|
||||
@@ -665,7 +665,7 @@ void main() { word = 0xC0FFEEu; }
|
||||
ExpectDeclaredArm(declared, "after a frame of draws, an SSBO binding and a dispatch");
|
||||
}
|
||||
|
||||
// P11 A1 (MG_Remote/CONTRACT-P11.md §1): THE TCP LANE WITH MOBILEGL_IPC_ADOPT_TIER=0. A stream
|
||||
// P11 A1 (docs/archive/contracts/CONTRACT-P11.md §1): THE TCP LANE WITH MOBILEGL_IPC_ADOPT_TIER=0. A stream
|
||||
// data plane has no memory the two sides share, so the client refuses the knob by name at its
|
||||
// handshake - exactly one `Refuse{AdoptTierOnStream, "T0"}` line in its log - and the session
|
||||
// runs T2: the other cases in the same `.AdoptTier0.` lane are green and the arena is emulated.
|
||||
@@ -699,7 +699,7 @@ void main() { word = 0xC0FFEEu; }
|
||||
EXPECT_EQ(log.find("Fatal{UnimplementedAdoptTier"), std::string::npos) << log;
|
||||
}
|
||||
|
||||
// P11 B2 (MG_Remote/CONTRACT-P11.md B2): A SHARED-SEGMENT SESSION THAT ASKS T0 AND CANNOT RUN IT.
|
||||
// P11 B2 (docs/archive/contracts/CONTRACT-P11.md B2): A SHARED-SEGMENT SESSION THAT ASKS T0 AND CANNOT RUN IT.
|
||||
// MOBILEGL_IPC_ADOPT_TIER=0 over shared segments asks T0 in the Hello (A1 made it die at the
|
||||
// handshake; ruling ID-P11-14 made it this). The lane's server cannot grant it - a host has no
|
||||
// AHardwareBuffer, or `.AdoptT0Disallowed.` turned its allow switch off - so it refuses by name
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
// SPDX-License-Identifier: LGPL-3.0-only
|
||||
// End of Source File Header
|
||||
//
|
||||
// P9 (W1, MG_Remote/CONTRACT-P9.md §1): READS INTO A PIXEL PACK BUFFER ARE ANSWERED BY NOTHING.
|
||||
// P9 (W1, docs/archive/contracts/CONTRACT-P9.md §1): READS INTO A PIXEL PACK BUFFER ARE ANSWERED BY NOTHING.
|
||||
//
|
||||
// Under a transport a glReadPixels / glGetTexImage whose destination is a bound
|
||||
// GL_PIXEL_PACK_BUFFER no longer waits for its pixels: it crosses as read_pixels_to_buffer /
|
||||
@@ -418,7 +418,7 @@ namespace MGITest {
|
||||
// under a transport a pack-buffer read posts NO reply-slot record and marks the buffer
|
||||
// GPU-written, once per read. MOBILEGL_IPC_PBO_READBACK_SYNC=1 puts the reply form back,
|
||||
// and this case must then fail on both counters - that is its red-once, recorded in
|
||||
// docs/Disaggregated/notes/p9/.
|
||||
// docs/archive/notes/p9/.
|
||||
TEST_F(PackBufferReadbackScenario, APackBufferReadPostsNoReplyAndMarksTheBuffer) {
|
||||
if (!Ready()) return;
|
||||
const std::string split = SplitRuntimeSkipReason();
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
// SPDX-License-Identifier: LGPL-3.0-only
|
||||
// End of Source File Header
|
||||
//
|
||||
// Scenario - A TEXTURE RE-MINT NEEDS NO BYTE FROM THE CLIENT (P9 W2, notes/p9/W2-REMINT.md).
|
||||
// Scenario - A TEXTURE RE-MINT NEEDS NO BYTE FROM THE CLIENT (P9 W2, docs/archive/notes/p9/W2-REMINT.md).
|
||||
//
|
||||
// The name is the ROADMAP's: P4a named `texture-remint-pull` the one new stall class of the
|
||||
// split - a texture first bound to an image unit AFTER the backend allocated it has to be
|
||||
|
||||
@@ -33,7 +33,7 @@
|
||||
// table below.
|
||||
//
|
||||
// THE CLIENT EMITTER LANDED TOO, and three places in the tree said otherwise until this commit:
|
||||
// this header, the CMake probe's comment, and notes/p4a/p4a-results/gates-v1.md's re-run table.
|
||||
// this header, the CMake probe's comment, and docs/archive/notes/p4a/p4a-results/gates-v1.md's re-run table.
|
||||
// MG_Impl/Pipe/TextureEmit.h's EmitOneLevel increments CallClass::ClientTextureUploadEmissions on
|
||||
// every piece it emits, so `ctu=` is a live reading and `ctu == emit` is a live assertion. The
|
||||
// CMake probe's `else()` arm is kept - it is what makes the arming decision falsifiable - but it
|
||||
|
||||
@@ -30,7 +30,7 @@
|
||||
// That is exactly the shape SSIM and every ordinary pixel case go green over.
|
||||
//
|
||||
// SO THE CLAIM IS ASSERTED ON BOTH CHANNELS AT ONCE, and neither alone is the gate
|
||||
// (notes/recovered/wf2/final/part3.md 7.3, "门:新增场景,通过 view 上传、经属主采样(以及反
|
||||
// (docs/archive/notes/recovered/wf2/final/part3.md 7.3, "门:新增场景,通过 view 上传、经属主采样(以及反
|
||||
// 向),跨 draw 边界各一次"):
|
||||
//
|
||||
// PIXELS an upload through one name must be visible through the other name, in the SAME
|
||||
@@ -51,7 +51,7 @@
|
||||
// MarkStorageDirtyRegion call PipeNoteLevelDirty on ITSELF instead of forwarding to the owner -
|
||||
// i.e. build the two-cursor shape the design rejects. Case (a) then goes red on stale OWNER
|
||||
// texels AND on a SubDataCount that did not move, which is the pair this file exists to make
|
||||
// simultaneous. Recorded in docs/Disaggregated/notes/p34b/espryt-d2.md.
|
||||
// simultaneous. Recorded in docs/archive/notes/p34b/espryt-d2.md.
|
||||
//
|
||||
// VIEWS ARE OPT-IN ON ESPRYT. DirectGLES withholds GL_ARB_texture_view unless
|
||||
// MOBILEGL_ESPRYT_ENABLE_TEXTURE_VIEW=1 (ConfigLoader.cpp:213, Config.h:72), so every lane that
|
||||
|
||||
@@ -13,7 +13,7 @@
|
||||
// in every lane; the DirectGLES.Split. entries run the same two cases with
|
||||
// MOBILEGL_TRANSPORT=inproc, where the same body is the smallest workload that crosses a real
|
||||
// ring. Four things about its shape are decisions rather than defaults, and all four come from
|
||||
// the measured verb census (~/w7/notes/p5/verb-census.md):
|
||||
// the measured verb census (docs/archive/notes/p5/verb-census.md):
|
||||
//
|
||||
// 1. THE DRAW IS VBO-BACKED AND HAS NO CLIENT-ARRAY INDICES. glDrawArrays against a buffer
|
||||
// bound to GL_ARRAY_BUFFER, never glDrawElements with a client pointer. That keeps
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
// End of Source File Header
|
||||
//
|
||||
// P8-SV: THE MAGMA WIRE ARM ISSUES glDispatchComputeIndirect FROM THE WIRE STORE, AS THE MONOLITH
|
||||
// ARM DOES (docs/Disaggregated/notes/p8/SV.md).
|
||||
// ARM DOES (docs/archive/notes/p8/SV.md).
|
||||
//
|
||||
// Before P8-SV the wire arm read the three group counts through ReadWireBuffer and dispatched them
|
||||
// from the CPU, so a dispatch buffer a shader had written cost a whole-GPU wait per call - the
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
// SPDX-License-Identifier: LGPL-3.0-only
|
||||
// End of Source File Header
|
||||
//
|
||||
// P8-SV: TWO glGenerateMipmap SHAPES THE MAGMA WIRE ARM GOT WRONG (docs/Disaggregated/notes/p8/SV.md).
|
||||
// P8-SV: TWO glGenerateMipmap SHAPES THE MAGMA WIRE ARM GOT WRONG (docs/archive/notes/p8/SV.md).
|
||||
//
|
||||
// * A 3D chain through the NATIVE blit. The wire arm passed the level's depth as the blit's
|
||||
// subresource layerCount on an image with one array layer (VUID-vkCmdBlitImage-srcImage-00240,
|
||||
|
||||
Reference in New Issue
Block a user