mia-2ddeform(1)

💖 mia-2ddeform — the glow-up your 2D images have been waiting for 💖

okay bestie, sit down, hydrate, because this is the little tool that literally warps your 2D images by pushing every pixel around with a vector field. it's in the General Commands Manual section, and yes it absolutely ate. 🦋

---

✨ NAME ✨

mia-2ddeform — Transform a 2D image by means of a vector field. that's it, that's the whole job, and she does it flawlessly. 💅

---

🌸 SYNOPSIS 🌸

mia-2ddeform -i <in-file> -o <out-file> -t <transformation> [options]

---

👑 DESCRIPTION 👑

So here's the tea 🍓: this program deforms a 2D image using a deformation vector field. That's the whole vibe.

Important, no cap: the input image and the deformation field must be of the same size. If they're not matching, that's a whole situation and it will not work out.

The transformation formula is, and I quote, 'x -> x - v(x)' — so every point gets nudged by minus the vector sitting at it. Iconic math behavior honestly. ✨

---

🎀 OPTIONS 🎀

• -i, --in-file=(required, input); io — your input image, the one we're about to serve a whole new look. For supported file types see PLUGINS:2dimage/io
• -o, --out-file=(required, output); io — the transformed image, aka the after photo 📸. For supported file types see PLUGINS:2dimage/io
• -t, --transformation=(required, input); io — the transformation vector field, i.e. the blueprint of the chaos. For supported file types see PLUGINS:2dvf/io
• -p, --interpolator=bspline:d=3 — the image interpolator kernel, so the pixels know how to behave in between. For supported plugins see PLUGINS:1d/splinekernel

🧚 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 the manpage really does spell it "Maxiumum" and yes there's a missing space after the comma — we keep the facts exactly as they are around here, no editing the source, bestie 🙈)

---

🌈 PLUGINS: 1d/splinekernel 🌈

• bspline — B-spline kernel creation , supported parameters are:

d = 3; int in [0, 5]
  Spline degree.

• omoms — OMoms-spline kernel creation, supported parameters are:

d = 3; int in [3, 3]
  Spline degree.

---

🦋 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

---

💫 PLUGINS: 2dvf/io 💫

• datapool — Virtual IO to and from the internal data pool
  • Recognized file extensions: .@
• exr — a 2dvf io plugin for OpenEXR vfs
  • Recognized file extensions: .EXR, .exr
  • Supported element types: unsigned 32 bit, floating point 32 bit
• vista — a 2d vector field io plugin for vista
  • Recognized file extensions: .V, .VF, .v, .vf
  • Supported element types: floating point 32 bit

---

⭐ EXAMPLE ⭐

Deform image input.png by using the transformation given in transform.v and store the result in deformed.png using linear interpolation

mia-2ddeform -i input.png -t transform.v -o deformed.png -p bspline:d=1

(see how bspline:d=1 gives you the linear interpolation? that's the whole point, bestie — the spline degree is the interpolation vibe 🔥)

---

🫶 AUTHOR(s) 🫶

Gert Wollny — the icon, the legend, 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'.

fr fr, no warranty at all — if it breaks, it's not their problem, and that's on periodt. 💅

---

and that's the whole page, bestie! this manual ships as part of the User Commands collection, version v2.4.7, and it lives under the name mia-2ddeform(1) — go deform something iconic. 🎀✨🦋