mia-2dgray...ine-to-rgb(1)

💖 mia-2dgrayimage-combine-to-rgb — the combine-gray-into-RGB bestie guide 💖

okay so. you know how this is a General Commands Manual page? yes bestie, it's a real command, it lives in the mia-2dgrayimage-combine-to-rgb neighbourhood, and it's about to become your new favourite thing. sit down, grab a boba, we're doing image channel math. 🧋✨

---

🌸 NAME 🌸

mia-2dgrayimage-combine-to-rgb — combine gray scale images to an rgb image. that's it, that's the whole vibe. three gray besties walk in, one RGB icon walks out. 👑

---

✨ SYNOPSIS ✨

mia-2dgrayimage-combine-to-rgb -o <out-file> [options]

literally just give it an output and it will serve. 💅

---

🦋 DESCRIPTION 🦋

okay so <hotpink>mia-2dgrayimage-combine-to-rgb</hotpink> — this program combines up to three gray scale images into a three channel RGB image with eight bit per color channel. no cap.

the input images must be gray scale of eight bit colordepth. that's the rule, that's the requirement, don't fight it. 🙈

and here's the cute part: if at input one channel is not given, it will be set to zero. so if you're like "bestie I only have red" the green and blue channels just… become zero. they're not mad about it.

but listen: at least one input channel must be given. you cannot give it nothing. giving it nothing is not a slay, it's an error. 😭

---

💜 OPTIONS 💜

• -b --blue=(input); io — input image for blue channel 🫐 For supported file types see PLUGINS:2dimage/io
• -g --green=(input); io — input image for green channel 🍀 For supported file types see PLUGINS:2dimage/io
• -r --red=(input); io — input image for red channel 🍓 For supported file types see PLUGINS:2dimage/io
• -o --out-file=(output, required); io — combined output image. yes it's required, it's the main character, it doesn't do optional. 💖 For supported file types see PLUGINS:2dimage/io

🎀 Help & Info 🎀

• -V --verbose=warning — verbosity of output, print messages of given level and higher priorities. Supported priorities starting at lowest level are:
  • trace ‐ Function call trace
  • debug ‐ Debug output
  • info ‐ Low level messages
  • message ‐ Normal messages
  • warning ‐ Warnings
  • fail ‐ Report test failures
  • error ‐ Report errors
  • fatal ‐ Report only fatal errors
• --copyright — print copyright information 📜
• -h --help — print this help 🆘
• -? --usage — print a short help 🫶
• --version — print the version number and exit 🔢

🌈 Processing 🌈

• --threads=-1 — Maxiumum number of threads to use for processing, This number should be lower or equal to the number of logical processor cores in the machine. (-1: automatic estimation). 🧵✨

---

🌟 PLUGINS: 2dimage/io 🌟

okay so these are all the file types that will actually talk to you. vibe check each one:

• bmp — BMP 2D-image input/output support. The plug-in supports reading and writing of binary images and 8-bit gray scale images. read-only support is provided for 4-bit gray scale images. The color table is ignored and the pixel values are taken as literal gray scale values.
  • Recognized file extensions: .BMP, .bmp
  • Supported element types:
    • binary data, unsigned 8 bit
• datapool — Virtual IO to and from the internal data pool
  • Recognized file extensions: .@
• dicom — 2D image io for DICOM
  • Recognized file extensions: .DCM, .dcm
  • Supported element types:
    • signed 16 bit, unsigned 16 bit
• exr — a 2dimage io plugin for OpenEXR images
  • Recognized file extensions: .EXR, .exr
  • Supported element types:
    • unsigned 32 bit, floating point 32 bit
• jpg — a 2dimage io plugin for jpeg gray scale images
  • Recognized file extensions: .JPEG, .JPG, .jpeg, .jpg
  • Supported element types:
    • unsigned 8 bit
• png — a 2dimage io plugin for png images
  • Recognized file extensions: .PNG, .png
  • Supported element types:
    • binary data, unsigned 8 bit, unsigned 16 bit
• raw — RAW 2D-image output support
  • Recognized file extensions: .RAW, .raw
  • Supported element types:
    • binary data, signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit
• tif — TIFF 2D-image input/output support
  • Recognized file extensions: .TIF, .TIFF, .tif, .tiff
  • Supported element types:
    • binary data, unsigned 8 bit, unsigned 16 bit, unsigned 32 bit
• vista — a 2dimage io plugin for vista images
  • Recognized file extensions: .-, .V, .VISTA, .v, .vista
  • Supported element types:
    • binary data, signed 8 bit, unsigned 8 bit, signed 16 bit, unsigned 16 bit, signed 32 bit, unsigned 32 bit, floating point 32 bit, floating point 64 bit

---

🍓 EXAMPLE 🍓

Combine the images red.png, blue.tiff, and green.bmp to the output image rgb.jpg.

mia-2dgrayimage-combine-to-rgb -r red.png -b blue.tiff -g green.bmp -o
       rgb.jpg

see? red, blue, green, out. absolutely ate. 🔥 (and yes, the line break in the middle is literally how it's written, don't @ me)

---

👑 AUTHOR(s) 👑

Gert Wollny — the legend, the icon, the moment. 🫶

---

💌 COPYRIGHT 💌

This software is Copyright (c) 1999‐2015 Leipzig, Germany and Madrid, Spain. It comes with ABSOLUTELY NO WARRANTY and you may redistribute it under the terms of the GNU GENERAL PUBLIC LICENSE Version 3 (or later). For more information run the program with the option '--copyright'.

bestie the NO WARRANTY is in all caps for a reason. it means it. 💀

---

aaaand that's the whole page!! 🎀 this came to you from the USER COMMANDS section, version v2.4.7, and it's still called mia-2dgrayimage-combine-to-rgb in case you forgot (you didn't, you're doing amazing). go make some RGB, ily, periodt. 💖✨🦋