mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-20 00:11:56 +09:00
[Docs, Chore] (docs, tools, MobileGL, scripts, CONTRIBUTING.md, .gitignore): translate the documentation and use US spelling
This commit is contained in:
+1
-1
@@ -137,7 +137,7 @@ framebuffer** returns all zeros, with no GL error, both before and after
|
||||
`eglSwapBuffers`. `DirectGLES` on the identical window is correct, and readback
|
||||
from a **user FBO is correct on both backends**.
|
||||
|
||||
Verified on two SoCs and two drivers, so this is MobileGL's behaviour rather than
|
||||
Verified on two SoCs and two drivers, so this is MobileGL's behavior rather than
|
||||
a driver quirk:
|
||||
|
||||
| device | GPU | driver | default-FB | user FBO |
|
||||
|
||||
@@ -17,7 +17,7 @@
|
||||
* \file
|
||||
* \brief MobileGL platform.
|
||||
*
|
||||
* Modelled on the surfaceless platform, but adapted to MobileGL, which ships
|
||||
* Modeled on the surfaceless platform, but adapted to MobileGL, which ships
|
||||
* its own EGL implementation inside libMobileGL.so:
|
||||
*
|
||||
* - Every EGL call goes through the dynamically loaded library. The
|
||||
|
||||
@@ -338,7 +338,7 @@ int main(int argc, char** argv) {
|
||||
printf(" user-FBO incomplete status=0x%x\n", fbst);
|
||||
}
|
||||
|
||||
/* FBO with a RENDERBUFFER colour attachment. This is what dEQP's
|
||||
/* FBO with a RENDERBUFFER color attachment. This is what dEQP's
|
||||
* FboRenderContext allocates for --deqp-surface-type=fbo, so it is the path
|
||||
* that actually decides a conformance run - a texture-attached FBO working
|
||||
* says nothing about it. */
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
# SPDX-License-Identifier: LGPL-3.0-only
|
||||
# End of Source File Header
|
||||
|
||||
"""Summarise any number of GL CTS suites and MobileGL backends.
|
||||
"""Summarize any number of GL CTS suites and MobileGL backends.
|
||||
|
||||
Each repeatable suite specification consists of four values: backend, label,
|
||||
caselist, and result directory. For example::
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
# SPDX-License-Identifier: LGPL-3.0-only
|
||||
# End of Source File Header
|
||||
|
||||
"""Summarise dEQP/glcts .qpa logs into a conformance pass rate.
|
||||
"""Summarize dEQP/glcts .qpa logs into a conformance pass rate.
|
||||
|
||||
Handles the two ways a case can end in a .qpa: a normal
|
||||
``#beginTestCaseResult``/``#endTestCaseResult`` pair carrying a
|
||||
|
||||
@@ -838,7 +838,7 @@ def execute(args: argparse.Namespace) -> int:
|
||||
if empty_streak >= args.max_empty_streak:
|
||||
print(
|
||||
f"[run_cts_windows] aborting after {empty_streak} consecutive chunks made no "
|
||||
"case progress; no unobserved case was labelled Crash/Hang",
|
||||
"case progress; no unobserved case was labeled Crash/Hang",
|
||||
file=sys.stderr,
|
||||
)
|
||||
break
|
||||
|
||||
@@ -142,7 +142,7 @@ complete one.
|
||||
| Flag | Why it is not optional |
|
||||
| --- | --- |
|
||||
| `--deqp-surface-type=fbo` | On DirectVulkan, `glReadPixels` from the **default framebuffer returns all zeros** with no GL error. dEQP verifies nearly everything through `glReadPixels`, so rendering to the surface scores DirectVulkan near zero for a reason unrelated to conformance. Use it for **both** backends so the two numbers stay comparable. |
|
||||
| `MOBILEGL_CTS_FBO_COLOR_TEXTURE=1` | **`--deqp-surface-type=fbo` alone is not enough.** dEQP's `FboRenderContext` allocates a *renderbuffer* colour attachment, and DirectVulkan returns zeros from a renderbuffer-attached FBO too — only a *texture*-attached FBO reads back correctly. This env var (a patch to `framework/opengl/gluFboRenderContext.cpp`, off by default) switches the attachment to a texture and isolates that single defect. Measured effect: `KHR-GL33.shaders.loops.for_constant_iterations.*` goes 0/62 → 62/62, and the whole-suite DirectVulkan conformance rate goes 46.15% → 72.74%. DirectGLES is bit-identical either way (93.05%), which is the control proving the switch is neutral where readback works. |
|
||||
| `MOBILEGL_CTS_FBO_COLOR_TEXTURE=1` | **`--deqp-surface-type=fbo` alone is not enough.** dEQP's `FboRenderContext` allocates a *renderbuffer* color attachment, and DirectVulkan returns zeros from a renderbuffer-attached FBO too — only a *texture*-attached FBO reads back correctly. This env var (a patch to `framework/opengl/gluFboRenderContext.cpp`, off by default) switches the attachment to a texture and isolates that single defect. Measured effect: `KHR-GL33.shaders.loops.for_constant_iterations.*` goes 0/62 → 62/62, and the whole-suite DirectVulkan conformance rate goes 46.15% → 72.74%. DirectGLES is bit-identical either way (93.05%), which is the control proving the switch is neutral where readback works. |
|
||||
| `--deqp-terminate-on-device-lost=disable` | Defaults to *enable*, which calls `glGetGraphicsResetStatus()` after every case. That is GL 4.5 / `KHR_robustness`, absent from GL 3.3 core, so the pointer is null and the process segfaults on the first case. Desktop drivers expose the extension, which is why upstream never trips on it. |
|
||||
|
||||
## Cases that take the device down
|
||||
|
||||
@@ -54,7 +54,7 @@ cmake --build "$MG/build-linux" --parallel "$(nproc)"
|
||||
|
||||
Add `-DCMAKE_INTERPROCEDURAL_OPTIMIZATION_RELEASE=FALSE` when iterating. The
|
||||
Release configuration turns LTO on, which makes every relink cost minutes for no
|
||||
behavioural difference; a conformance number is identical either way.
|
||||
behavioral difference; a conformance number is identical either way.
|
||||
|
||||
## Step 2 — get VK-GL-CTS and build glcts
|
||||
|
||||
|
||||
Reference in New Issue
Block a user