(MTL S02E09) Manual Diagnostics: pt.1 Value-level
Zusammenfassung
Kurz
Der Bericht erklärt, wie Shaderwerte als Farben in der erzeugten Textur sichtbar gemacht werden können, etwa mit Assertions, Heatmaps, Debug-Modi, ID-Farben, Rastern oder Ableitungsansichten. Der Autor empfiehlt die Normalisierung auf den Bereich 0 bis 1 und weist unter anderem darauf hin, dass indizierte Modelle Baryzentrikdaten mit den Vertices übergeben müssen; die Beispiele decken nicht alle Fälle ab.
Mittel
Der Bericht stellt eine Methode vor, Metal-Shader direkt in der laufenden App zu untersuchen, wenn GPU-Frame-Capture nicht verfügbar ist oder zu lange dauert. Da Shader Ergebnisse wie Texturen erzeugen, können interne Werte als Farben ausgegeben und so visuell geprüft werden. Der Autor empfiehlt visuelle Assertions für bedingte Warnfarben, Heatmaps für kontinuierliche Werte und einen CPU-seitig steuerbaren Debug-Modus zum Umschalten der Ansichten.
Skalare sollen in den Bereich 0 bis 1 normalisiert und nicht im Alphakanal dargestellt werden. Farbkanäle zeigen bis zu drei Vektorkomponenten; höhere Dimensionen müssen teilweise betrachtet oder projiziert werden. Weitere Beispiele umfassen feste Farben für Verzweigungen, Farbcodierungen für IDs, Raster und Schachbrettmuster für UV-Probleme sowie Ableitungs- und Isolinienansichten für Shader-, Textur- und SDF-Diagnosen. Baryzentrische Koordinaten können Geometrie und Topologie sichtbar machen. Bei indizierten Modellen müssen sie laut Autor mit den Vertices übergeben werden. Die Beispiele sind ausdrücklich nicht vollständig, sondern sollen Grundideen vermitteln.
Ausführlich lesen
Der Bericht beschreibt, wie sich Metal-Shader ohne GPU-Frame-Capture interaktiv untersuchen lassen. Der Autor nennt Situationen, in denen Xcode beim Frame-Capture abstürzen kann oder die Aufnahme zu lange dauert, und weist darauf hin, dass Shaderwerte normalerweise nicht direkt auf der CPU verfügbar sind. Da ein Shader jedoch ein Ergebnis wie eine Textur erzeugt – und Rechenkerne auch in Puffer oder Texturen schreiben können –, schlägt er vor, interne Werte als Farben auszugeben. So lassen sie sich während der Ausführung in der App sichtbar machen.
Als Grundwerkzeuge stellt der Autor visuelle Assertions und einen Debug-Parameter vor. Eine Assertion beendet die Fragmentfunktion bei erfüllter oder verletzter Bedingung mit einer festgelegten Farbe. Über einen vom CPU-seitigen Code übergebenen Debug-Modus kann die App zwischen verschiedenen Diagnoseausgaben wechseln, ohne für jede Änderung neu gebaut zu werden. Für kontinuierliche Werte empfiehlt der Bericht einen Farbverlauf beziehungsweise eine Heatmap, die laut Autor leichter zu erkennen sei als eine einfache Graustufe.
Skalare sollen in den darstellbaren Bereich von 0 bis 1 normalisiert und möglichst nicht im Alphakanal ausgegeben werden, da dies die Lesbarkeit beeinträchtigen könne. Vektoren lassen sich mit den drei Farbkanälen bis zu drei Komponenten darstellen; höherdimensionale Werte müssen laut Bericht teilweise oder auf drei Dimensionen projiziert betrachtet werden. Vorzeichen können durch Verläufe oder feste Farben gekennzeichnet werden. Ungültige Werte wie NaN und unendlich sollen früh erkannt und beispielsweise mit einer farbigen Assertion sichtbar gemacht werden.
Für weitere Diagnosen empfiehlt der Autor, Verzweigungen durch unterschiedliche feste Farben zu markieren und IDs je nach Wertebereich über eine Farbtabelle, einen normalisierten Verlauf oder gehashte Farben darzustellen. Raster und Schachbrettmuster können laut Bericht Probleme wie fehlerhafte UV-Koordinaten aufdecken, wenn kontinuierliche Darstellungen nicht genügen. Ableitungen über benachbarte Pixel sollen unter anderem Hinweise auf UV-Nähte, falsche Mip-Stufen, divergierende Kontrollflüsse, Normal-Maps und Interpolationsprobleme geben. Signed-Distance-Felder können mit Isolinien und Vorzeichen visualisiert werden, um etwa Verzerrungen zu erkennen.
Baryzentrische Koordinaten können Geometrie, Topologie, Dreiecke und falsche Winding-Richtungen sichtbar machen. Für indizierte Modelle nennt der Autor eine konkrete Einschränkung: Die Koordinaten müssen mit den Vertices übergeben werden; eine Berechnung im Vertex-Shader anhand des Vertex-Index führt laut Bericht zu einer ungeeigneten Darstellung. Der Autor betont, dass die Beispiele nicht alle Fälle abdecken, sondern Grundideen zeigen. Als allgemeine Empfehlung nennt er eine eigene Bibliothek interaktiver Diagnoseansichten und die Normalisierung der auszugebenden Werte.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Einordnung bleibt leer, weil Luna keine Sammel- oder Teilfragen angegeben hat. Bewertet wurde die mittlere Zusammenfassung. Die kurze Fassung ist ebenfalls inhaltlich treu, lässt aber den NaN- und inf-Abschnitt aus und ist deutlich knapper. Die Formulierung 'wenn GPU-Frame-Capture nicht verfügbar ist' geht etwas über den Bericht hinaus, der nur sagt, dass Capture nicht funktionieren oder zu lange dauern kann.
Im Bericht, aber nicht in der Zusammenfassung
- Ungültige Werte (NaN und inf) sollen früh mit einem DEBUG_INVALID-artigen Makro abgefangen werden
- Ableitungsansichten (fwidth) zeigen Fehlerquellen wie UV-Nähte, falsche Mip-Level und Probleme bei Normal Maps
- Der Autor empfiehlt, eine eigene Bibliothek für schnelle interaktive visuelle Diagnosen aufzubauen
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.