erhe-quest-shader-failure

Diagnose Quest shader creation and linking errors using SPIR-V and GLSLang analysis.

896|86|Updated May 1, 2021
One-click install
npx skills add https://github.com/tksuoran/erhe --skill erhe-quest-shader-failure
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: erhe-quest-shader-failure
Source: https://github.com/tksuoran/erhe/tree/main/.claude/skills/erhe-quest-shader-failure
Command: npx skills add https://github.com/tksuoran/erhe --skill erhe-quest-shader-failure

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill aids in diagnosing and resolving shader failures on the Quest editor, particularly those related to SPIR-V validation errors and shader compile/link errors.

Core Features & Use Cases

  • Shader Module Creation Error Identification: Pinpoints the shader module causing the error by reading the immediate preceding "Creating shader module" log.
  • VUID Mapping: Maps known VUID errors to potential fixes, providing guidance for shader module creation issues.
  • GLSLang DebugInfo Fix: Recommends the correct application of patches for glslang when encountering specific GLSLang issues.
  • Shader Disassembly: Offers instructions to disassemble SPIR-V to identify problematic areas.
  • GLSLang Bug Reporting: Directs users to documentation for understanding the root cause of glslang bugs.

Quick Start

Run the following command to retrieve logs and identify the failing shader on Quest: logcat -d -v time | grep -E "Creating shader module|VALIDATION ERROR|Abort message|spirv-val produced"

Frequently Asked Questions about erhe-quest-shader-failure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot SPIR-V shader validation errors on Quest VR?

Troubleshoot SPIR-V shader validation errors on Quest VR by retrieving device logs with logcat to pinpoint the failing shader module creation and map the specific VUID errors to potential fixes.

Why does shader module creation fail in the Vulkan OpenXR backend?

Shader module creation fails in the Vulkan OpenXR backend due to SPIR-V validation or linking errors. Identify the problematic shader by reading the immediate preceding 'Creating shader module' log entry.

How do I disassemble SPIR-V to find shader compile errors?

Disassemble SPIR-V to inspect the shader code and identify problematic areas causing compile errors. This process helps pinpoint the exact instructions triggering validation or linking failures.

How do I fix glslang bugs causing shader compilation failures?

Fix glslang bugs causing shader compilation failures by applying the correct patches for glslang and consulting the documentation to understand the root cause of the specific GLSLang issue.

Can I use Quest device logs to diagnose shader linking issues?

Use Quest device logs to diagnose shader linking issues by filtering for 'Creating shader module', 'VALIDATION ERROR', and 'spirv-val produced' entries to isolate the failing shader component.