CGFXCAT(1)

✨ CGFXCAT(1) — the Cg Commands era ✨

okay so bestie, welcome to CGFXCAT(1) 💖 this is a little tool from the Cg Commands corner of the universe and it is literally just here to spill the tea about your shader files. sit down, grab a strawberry 🍓, we're doing this.

🌸 NAME 🌸

cgfxcat — dump a Cg effect or program file to standard out 🫶

✨ SYNOPSIS ✨

cgfxcat.exe [-gl] [-effect] [-program] [-object] [-profile profile]
[-entry entry] file

💅 DESCRIPTION 💅

so cgfxcat loads up an effect file or a program file, and then it goes absolutely feral calling every single query operation available in the core runtime on the resulting Cg object 👑 and all those returned values? straight to standard out. no filter, no edit, just vibes.

and if you're the kind of girl who needs to see the source (iconic behaviour honestly), the source code for cgfxcat lives under examples/Tools/cgfxcat 🎀

🌈 OPTIONS 🌈

• file — the effect or program file you want processed, bestie. cgfxcat can handle effect files, program files, or precompiled program files. here's the whole vibe check on how it picks:
  • files with a .cgfx or .fx extension get loaded using cgCreateEffectFromFile 💖
  • files with a .cg or .hlsl extension get loaded using cgCreateProgramFromFile ✨
  • any other extension gets passed to cgGetProfile, and if a valid CGprofile is found, the file gets loaded using cgCreateProgramFromFile with the program_type set to CG_OBJECT 🦋
  • and yes, you can override all these built-in file extension mappings with the -effect, -program, or <-object> options. your file, your rules 💅
• -effect — treat file as an effect file, ignoring its extension. we said what we said 💀
• -program — treat file as a program file, ignoring its extension.
• -object — treat file as an precompiled program file, ignoring its extension.
• -profile profile — use the CGprofile returned by cgGetProfile for profile as the profile argument of cgCreateProgramFromFile when compiling file 🧚
• -entry entry — use entry as the entry argument of cgCreateProgramFromFile when compiling file ⭐
• -gl — register states with cgGLRegisterStates rather than using the generic state code built into cgfxcat 🔥

💜 SEE ALSO 💜

cgCreateEffectFromFile, cgCreateProgramFromFile, cgGetProfile, cgGLRegisterStates

and that's the whole page, no cap 😭 every flag accounted for, every extension mapped, nothing skipped. slay.

okay bye bestie, this one was rendered with perl v5.10.0 and it's from the Cg Toolkit 3.0 era — so when you're out here dumping effects and programs, just know it's giving very much classic Cg. periodt. 💖✨🎀