mia-2dlerp(1)

📦
version 2.4.7 · 3 versions
, in ubuntu jammy, ubuntu resolute, ubuntu stonking

💖 mia-2dlerp — the 2D image blend bestie 💖

okay so like, real talk? this is mia-2dlerp(1) from the General Commands Manual section, and she's a tiny little tool with main character energy: she takes two 2D images and blends them together, pixel by pixel, all linear and cute. ✨

🌸 NAME 🌸

mia-2dlerp — Linearly combine two 2D images.

no cap, that's the whole vibe. two pics in, one blended pic out. 💅

🎀 SYNOPSIS 🎀

mia-2dlerp -1 <first> -2 <second> -o <out-file> -p <positions> [options]

like, that's the shape of it, bestie. two inputs, an output, and your positions. the rest is just garnish. 🦋

✨ DESCRIPTION ✨

mia-2dlerp merges two images by pixel-wise linearly combining their intensities.

that's it. that's the whole personality. she goes pixel by pixel like a little fairy 🧚 and does a weighted mix of the two intensities. not me being obsessed with how simple that is 😭

👑 OPTIONS 👑

💖 The Big Four (the actual required ones)

  • -1, --first=(input, required); io — your first input image. required, so don't forget her. 💜 For supported file types see PLUGINS:2dimage/io
  • -2, --second=(input, required); io — your second input image. also required, also important, no favoritism here. For supported file types see PLUGINS:2dimage/io
  • -o, --out-file=(output, required); io — the output vector field. yes bestie, that's what the manpage says it is, we don't question it. For supported file types see PLUGINS:2dimage/io
  • -p, --positions=(required); vfloat — the image series positions, and the order is (first, target, second). remember that order, it's giving choreography. 🌈

🫶 Help & Info

the "wait, what does this do again" corner. she's here for you.

  • -V, --verbose=warning — verbosity of output, print messages of given level and higher priorities. the default vibe is warning. Supported priorities starting at lowest level are:
    1. trace ‐ Function call trace
    2. debug ‐ Debug output
    3. info ‐ Low level messages
    4. message ‐ Normal messages
    5. warning ‐ Warnings
    6. fail ‐ Report test failures
    7. error ‐ Report errors
    8. fatal ‐ Report only fatal errors
  • --copyright — print copyright information. legal girlie pop behavior. 📜
  • -h, --help — print this help
  • -?, --usage — print a short help. yes, literally a question mark, she's quirky like that. 🙈
  • --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" is spelled like that in the original and I am NOT fixing it, that's a historical artifact and we respect her 💀

like, don't ask for more threads than your machine actually has cores, that's just rude to your CPU bestie. leaving it at -1 lets her estimate automatically and she'll handle it. 🍓

🧪 Test

  • --selftest=(); None — run a self test of the program

she checks herself before she wrecks herself. self care queen. 💅

🌈 PLUGINS: 2dimage/io 🌈

this is the whole roster of file types she can read and write, and what she can actually hold in each one. slay.

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

okay so picture this: you wanna combine inputA.v and inputB.v by using position coordinates 4, 7, and 9. This means the output pixel values will be evaluated according to

(9-7)/(9-4) * A + (7-4)/(9-4) * B

The result image will be written to output.v

mia-2dlerp -1 inputA.v -2 inputB.v -p 4,7,9 -o output.v

like look at that math, she's doing weighted blending with the positions as anchors. the way that 7 sits between 4 and 9 and the weights are literally the distances… it's giving interpolation. it's giving math girlie. it's giving slay. 🔥

💜 AUTHOR(s) 💜

Gert Wollny

thank you for your service king 🫶

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.

read that warranty part again bestie. ABSOLUTELY NO WARRANTY. caps lock levels of serious. it's free software, it's licensed, and it's very clear about the no-promises part. 💀

and that's the whole page!! 🌸 written for the USER COMMANDS section, version v2.4.7, and yeah the page id is mia-2dlerp(1) because of course it is. go blend something iconic. mwah. 💅✨

📦 where this page comes from