HLSL Checker

HLSL Checker es una herramienta de análisis estático diseñada para validar el código shader antes de que llegue al compilador. Se centra en modos de fallo comunes en modelos de shader de DirectX, mostrando errores de sintaxis, identificadores indefinidos, desajustes de tipos y semánticas incorrectas o ausentes. La herramienta admite un fragmento de código, un modelo de shader objetivo (por ejemplo, vs_5_0 o ps_5_0), un punto de entrada y rutas de inclusión opcionales, y devuelve una lista estructurada de problemas. Conceptualmente, tokeniza y analiza el código fuente con una sub-muestra segura de la gramática HLSL, construye una tabla de símbolos, resuelve referencias a través del código y verifica bindings de recursos como cbuffers, texturas y samplers. Señala desajustes entre entradas/salidas entre etapas, tipos de campo incorrectos y constantes incompatibles. Controles opcionales abarcan consistencia de binding entre archivos, conocimiento básico de divergencia y consideraciones de padding en buffers constantes, con recomendaciones concretas para cumplir con el modelo de shader. Público y valor: ingenieros gráficos, equipos de motor y autores de shaders se benefician de ubicaciones precisas de línea y columna, etiquetas de severidad e indicaciones de corrección. El valor único proviene de la combinación de validación semántica y verificación de binding con guías claras centradas en el código, reduciendo tiempo de depuración y fallos de build. Casos de uso: comprobaciones ad hoc de shader en editores, validación CI previa a merges y pipelines nocturnas para proyectos DX. Funciones clave: validación de sintaxis, controles semánticos, análisis de binding y una lista de problemas con códigos, mensajes y ubicaciones. La herramienta no ejecuta el shader ni es un compilador completo; se enfoca en la corrección estática y la calidad del shader a través de modelos shader de DirectX.