MATINFO(1)

okay bestie, sit down, hydrate, and let me tell you about matinfo — it lives in section 1 of the User Commands manual, so it's a user-facing command, not some dusty kernel thing. 💅

🌸 NAME 🌸

matinfo — filament material tools 🧵✨

💖 DESCRIPTION 💖

matinfo prints information about material files compiled with matc. that's the whole vibe. it peeks inside your compiled material and tells you what's in there. 🫶

Usage:

matinfo [options] <material file>

✨ OPTIONS ✨

• --help, -h — prints this message. classic. the "help me bestie" button. 🙈
• --print-glsl=[index], -g — prints GLSL for the nth shader. and listen: 0 is the first OpenGL shader, so we count from zero around here, no cap. 🔥
• --print-spirv=[index], -s — validates and prints disasm for the nth shader. 0 is the first Vulkan shader. it checks it AND spills the tea in disasm form. 💀
• --print-metal=[index], -m — prints Metal Shading Language for the nth shader, and yep, 0 is the first Metal shader. 🍓
• --print-vkglsl=[index], -v — prints the nth Vulkan shader, but transpiled into GLSL. it's giving translator era. 🌈
• --print-dic-glsl — prints the GLSL dictionary. yes it's spelled "dic", we don't make the rules. 📖
• --print-dic-metal — prints the Metal dictionary. 📖
• --print-dic-vk — prints the Vulkan dictionary. 📖
• --web-server=[port], -w — serves a web page at the given port (e.g. 8080). main character energy, honestly. 👑
• --dump-binary=[index], -b — dumps binary SPIRV for the nth Vulkan shader to out.spv. it literally writes that file, watch for it. 💾
• --license — prints copyright and license information. respect the elders. 🎀
• --analyze-spirv=[index], -a — prints annotated GLSL for the nth shader, and again, 0 is the first Vulkan shader. annotated!! it's like sparknotes but for shaders. ⭐

🌀 Usage: 🌀

okay so. and THEN the page goes and says the entire thing over again, and I am not skipping it, because everything on this page matters. here we go, round two, same energy:

matinfo [options] <material file>

• --help, -h — prints this message. yes, again. consistency queen. 💅
• --print-glsl=[index], -g — prints GLSL for the nth shader, 0 is the first OpenGL shader. 🔥
• --print-spirv=[index], -s — validates and prints disasm for the nth shader, 0 is the first Vulkan shader. 💀
• --print-metal=[index], -m — prints Metal Shading Language for the nth shader, 0 is the first Metal shader. 🍓
• --print-vkglsl=[index], -v — prints the nth Vulkan shader transpiled into GLSL. 🌈
• --print-dic-glsl — prints the GLSL dictionary. 📖
• --print-dic-metal — prints the Metal dictionary. 📖
• --print-dic-vk — prints the Vulkan dictionary. 📖
• --web-server=[port], -w — serves a web page at the given port (e.g. 8080). 👑
• --dump-binary=[index], -b — dumps binary SPIRV for the nth Vulkan shader to out.spv. 💾
• --license — prints copyright and license information. 🎀
• --analyze-spirv=[index], -a — prints annotated GLSL for the nth shader, 0 is the first Vulkan shader. ⭐

ngl bestie, every single index in this page is zero-based. if you pass 0 you get the first shader, and that is not a vibe check you want to fail. 🫶

and that's the whole page, periodt. 🦋 this one's dated October 2021, and it signs off as MATINFO(1) — so if you remember nothing else, remember the name and the manual section. mwah. 💖🎀✨