bin2obj(1)

💖 bin2obj — the Free Pascal binary-to-pascal include file converter 💖

okay so bestie, welcome to bin2obj(1) — yes, that's section 1 of the manual, and yes, this is the Free Pascal binary to pascal include file converter. it's giving "I turn your mysterious little blob of bytes into actual Pascal code" and honestly? iconic. 🦋

✨ SYNOPSIS ✨

bin2obj [-aeouUz] -c constname infile

that's it. that's the whole vibe check. infile goes in, Pascal constant comes out. 💅

🌸 DESCRIPTION 🌸

okay so here's the tea: bin2obj reads a binary file and converts it to a pascal typed constant declaration. periodt.

the constant it makes is an array of bytes (zero based, no cap), and each byte in that array has the value of the byte at the offset index in the file. and like, to be clear — index is the index in the array. iykyk. 🎀

🫶 USAGE 🫶

so bin2obj accepts a filename of a binary file, and it needs the name of a constant (use the -c option for that one, bestie, don't forget).

the output goes to standard output by default. and if no unitname is given, the output will be in the form of code which can be written to an include file. cute, right? ✨

👑 OPTIONS 👑

bin2obj has a small number of options to control its behaviour. small but mighty, fr fr:

• -a — write ASCII data instead of bytes. the constant array will be an array of char instead of an array of bytes, and the bytes will be written as ASCII constants. glow-up moment. 🌈
• -e key — if this option is given, the data will be encrypted with key, which is a string of 8 characters long. yes, exactly 8. count them. 💀
• -h — emit a small helptext. tiny. adorable. helpful. 🎀
• -o filename — by default, the output goes to standard output (the screen, bestie). if this option is given, bin2obj will write the output to a file with name filename instead.

⚠️ heads up: this option is mandatory if the -U option is specified. no -o, no -U. rules are rules. 💅

• -u [unitname] — this option tells bin2obj to generate a unit. by default the output is just the declaration of the constant. if the unitname is not specified, bin2obj tries to determine it from the input filename. main character energy, figuring it out on its own. ✨
• -U [unitname] — the same as the -u option, only bin2obj will also call the compiler and compile the unit. it's not just making the unit, it's making it happen. 🔥
• -z — compress the data before creating the unit. zlib compression is used. squeeze it, bestie. 🍓

🌟 SEE ALSO 🌟

• ppc386(1)
• data2inc(1)

go read those too, bestie, they're part of the friend group. 🫶

and that's the whole page!! this little legend is brought to you by Free Pascal, dated 12 November 2004, and it lives at bin2obj(1) in section 1 of the manual. mwah. 💜✨