mia-raw2image(1)

💖 mia-raw2image(1) 💖

okay bestie, welcome to the General Commands Manual glow-up edition — this is mia-raw2image, and she is literally here to take your raw data and turn it into a 2D image. no cap. 🦋

---

✨ NAME ✨

mia-raw2image — Convert raw data into a 2D image 💅

---

🌸 SYNOPSIS 🌸

mia-raw2image -i <in-file> -o <out-file> -s <size> [options]

---

🎀 DESCRIPTION 🎀

mia-raw2image — this program is used to convert raw data to a 2D file format. that's the whole vibe, that's the whole job. she eats raw bytes and serves 2D image. ✨

---

👑 OPTIONS 👑

• -i, --in-file=(input, required); string — input file name. yeah, you gotta tell her what to read. required, bestie. 😭
• -o, --out-file=(output, required); io — output file name. For supported file types see PLUGINS:2dimage/io 👀
• -r, --repn=ubyte — input pixel type. pick your fighter:
  • bit — binary data
  • sbyte — signed 8 bit
  • ubyte — unsigned 8 bit
  • sshort — signed 16 bit
  • ushort — unsigned 16 bit
  • sint — signed 32 bit
  • uint — unsigned 32 bit
  • slong — signed 64 bit
  • ulong — unsigned 64 bit
  • float — floating point 32 bit
  • double — floating point 64 bit
  • none — no pixel type defined
• -b, --big-endian — input data is big endian 🫶
• -f, --scale=[1,1] — scale of input pixels <FX,FY>
• -s, --size=(required); 2dbounds — size of input <NX,NY>. required, so don't skip her 💀
• -k, --skip=0 — skip number of bytes from beginning of file

---

🧚 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).

(yes, "Maxiumum" — we keep the typo, we don't fix her, we love her as she is 💖)

---

🌈 PLUGINS: 2dimage/io 🌈

• 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 🍓

Convert a data set data.raw of size <10,20> of short integer data with a pixel size of <1.2, 2.3> to a PNG file image.png

mia-raw2image -i data.raw -o image.png -s '<10,20>' -k '<1.2,2.3>' -r
       ushort

(she wrote it exactly like that, we are not touching it, we are just admiring 🫶)

---

💜 AUTHOR(s) 💜

Gert Wollny — iconic, legendary, we stan 👑

---

⭐ 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'.

---

and that's the whole page, bestie 💖 this came from the USER COMMANDS crew, version v2.4.7, under the mia-raw2image(1) title — go forth and convert your raw data, no cap 🌸✨