NMLC(1)

💖 NAME 💖

NMLC — bestie, it's a compiler that takes your NML code and turns it into NFO and/or GRF files. That's the whole vibe. ✨

🌈 SYNOPSIS 🌈

nmlc [options] [file]

Like, options first, file last, standard queen behaviour. 💅

✨ OPTIONS ✨

Okay so here's every single flag, no skips, we're being thorough because that's the energy:

• -c — Crops the extraneous transparent blue out of your real sprites. bye bye blue 🫶
• -u — Saves real sprites uncompressed into GRF files. It's a huge time-saver during encoding, ngl, but do NOT do this when you're making a file to distribute — it makes the output file substantially bigger. Not the serve you think it is. 😭
• --grf=file — Writes the output in GRF format to <file>.
• --nfo=file — Writes the output in NFO format to <file>.
• --nml=file — Writes the output in NML format to <file>.
• --output=file | -o file — Writes output to <file>. The output type gets detected from the filename extension, and it must be one of nfo, nml or grf. No improvising. 👑
• --md5=file — Writes an md5sum of the resulting grf to <file>.
• --debug | -d — Prints a dump of the AST to stdout. Look at your tree. 🌳
• --version — Prints the programme's version number and then exits. quick lil mic drop 🎤
• --help | -h — Prints usage information. your bestie when you're lost fr fr
• --stack | -s — Dumps the stack whenever an error occurs. for the detective girlies 🔍
• -M — Outputs a rule suitable for make, describing the graphics dependencies of the main grf file (requires an input file or --grf).
• --MF=file — When you use it with -M, it specifies a file to write the dependencies to.
• --MT=file — Sets the target of the rule emitted by dependency generation (requires -M).
• --custom-tags=file | -t file — Loads custom tags from <file> [default: custom_tags.txt].
• --lang-dir=dir | -l dir — Loads language files from directory <dir> [default: lang].
• --default-lang=file — The default language is stored in <file> [default: english.lng].
• --sprites-dir=dir | -a dir — Stores 32bpp sprites in directory <dir> [default: sprites].
• --start-sprite=num — Sets the first sprite number to write. > Honestly bestie, do not use this except when you're outputting nfo that you want to include in other files. It's giving "I know what I'm doing" and nothing else.
• --palette=palette | -p palette — Forces nml to use the palette <pal> [default: ANY]. Valid values are 'DOS', 'WIN', 'ANY'. pick your fighter 🎀
• --quiet — Disables all warnings. Errors will still be printed normally, so it's not total silence, just the quiet luxury version. 💜
• --cache-dir=dir — Cache files are stored in directory <dir> [default: .nmlcache].
• --clear-orphaned — Removes unused / orphaned items from cache files. spring cleaning energy 🧹
• --verbosity=level — Sets the verbosity level for informational output [default: 3, max: 4].

🦋 SEE ALSO 🦋

The language reference, living its life at http://newgrf-specs.tt-wiki.net/wiki/NML:Main — go read it, it's iconic. 📖

🌸 AUTHOR 🌸

NML was written by Albert Hofkamp, Christoph Elsenhans, Jasper Reichardt, Ingo von Borstel, José Soler and Thijs Marinussen. absolute legends, all of them. 👑

This manual page was originally written by Thijs Marinussen.

okay that's the whole page bestie!! This one's dated January 07, 2016 and it belongs to NMLC(1) — mwah, go compile something gorgeous 💖✨🎀🦋