Debugging Rendering Issues

---
name: Debugging Rendering Issues
description: ALWAYS use when a user porting a game to Metal reports a rendering issue — blank screen, wrong output, or anything that looks incorrect on Metal vs. the source platform. Covers black screen, missing geometry, wrong…
---

# Debugging Rendering Issues

Part of the **Apple Game Porting Skills** pack by Apple (`apple/game-porting-toolkit`).

ALWAYS use when a user porting a game to Metal reports a rendering issue — blank screen, wrong output, or anything that looks incorrect on Metal vs. the source platform. Covers black screen, missing geometry, wrong…

This catalog entry summarizes the skill for discovery. Get the full skill — including any bundled scripts and resources — from the source:

Full skill & source: https://github.com/apple/game-porting-toolkit/tree/main/game-porting-skills/skills/debugging-rendering-issues