MATC(1)

🌸 MATC(1) — the user command manual, bestie edition 🌸

okay so you opened the manual for matc, section 1 (that's "user commands" for the uninitiated ✨). this is your girl's full glow-up of the page, every single flag intact, no cap. let's get into it 💅

✨ NAME ✨

matc — filament material tools 🎀

💖 DESCRIPTION 💖

okay so matc is a command-line tool that compiles material definitions. that's the whole vibe. the way you call it:

matc [options] <input-file>

🦋 Supported input formats:

• Filament material definition — the .mat file 🍓

👑 OPTIONS 👑

the moment you've all been waiting for. every flag, every letter, nothing skipped, periodt ✨

• --help, -h — prints this message 💬 (yes, the one you're reading, iconic)
• --license — prints the copyright and license info, the legal slay 📜
• --output, -o — tells it where to put the output file, specify the path bestie 🎀
• --platform, -p — which shader family to generate: desktop, mobile, or all (that's the default 👑)
• --optimize-size, -S — optimizes the generated shader code for size instead of just performance. tiny and cute 🧚
• --api, -a — which target API you want: opengl (default ✨), vulkan, metal, or all. you can repeat this flag to hand-pick APIs one by one for inclusion, like so:

matc --api opengl --api metal ...

• --define, -D — adds a preprocessor define macro using <macro>=<value>. if you omit <value> it just defaults to 1 🫶. repeat it as many times as you want for multiple definitions:

matc -Dfoo=1 -Dbar -Dbuzz=100 ...

• --reflect, -r — reflects the specified metadata as JSON: parameters 🪞
• --variant-filter=<filter>, -V <filter> — filters out the comma-separated variants you name, and the list of them is: directionalLighting, dynamicLighting, shadowReceiver, skinning, vsm, fog. heads up: this variant filter gets merged with the filter from the material, if the material has one 🤝
• --version, -v — prints the material version number 🔢

🙈 Internal use and debugging only:

these are the backstage passes, bestie. internal + debugging only, so don't come for me if you break something 💀

• --optimize-none, -g — disables all shader optimizations, purely for debugging 🛑
• --preprocessor-only, -E — optimizes shaders by running only the preprocessor, nothing else 💫
• --raw, -w — compiles a raw GLSL shader into a SPIRV binary chunk 🧊
• --output-format, -f — picks the output format: blob (the default 💜) or header
• --debug, -d — generates extra data for debugging 🔍
• --print, -t — prints the generated shaders so you can peek at them, debugging vibes only 👀

and that's the whole page, no notes. this was matc version 10, dated October 2021 🎀 — mwah, go compile something gorgeous, ily bestie 💖✨