ENFUSE(1)

📦
version 4.2.r1546+hb66125418f7d · 9 versions
, in arch rolling

🌸 ENFUSE 💅

okay so bestie, this is enfuse from the User Commands manual section — yes, the whole page lives in section 1 of the man pages, we love a system-documentation moment ✨

✨ NAME ✨

enfuse — the manual page for enfuse 4.2.1-0bcfaaf743e7 🎀

🦋 SYNOPSIS 🦋

enfuse [options] [--output=IMAGE] INPUT...

💖 DESCRIPTION 💖

Fuse INPUT images into a single IMAGE. That's the whole gig, and it eats. 🔥

INPUT... are image filenames or response filenames. Response filenames start with an @ character. iykyk 🫶

👑 OPTIONS 👑

🌈 Common options:

  • -l, --levels=LEVELS — limits the number of blending LEVELS to use (1 to 29); a negative number of LEVELS decreases the maximum; "auto" restores the default automatic maximization. it's giving "let me pick my own level" ✨
  • -o, --output=FILE — writes the output to FILE; default: "a.tif" 💾
  • -v, --verbose[=LEVEL] — verbosely reports progress; repeat it to increase verbosity or directly set it to LEVEL. say it louder for the people in the back 📢
  • --compression=COMPRESSION — sets the compression of the output image to COMPRESSION, where COMPRESSION is: "deflate", "jpeg", "lzw", "none", "packbits", for TIFF files and 0 to 100, or "jpeg", "jpeg-arith" for JPEG files, where "jpeg" and "jpeg-arith" accept a compression level. so many choices, main character energy fr 💅

🧚 Advanced options:

  • --blend-colorspace=COLORSPACE — forces COLORSPACE for blending operations; Enfuse uses "CIELUV" for images with ICC-profile and "IDENTITY" for those without and also for all floating-point images; other available blend color spaces are "CIELAB" and "CIECAM" 🌈
  • -c, --ciecam — use CIECAM02 to blend colors; disable it with "--no-ciecam". note that this option will be withdrawn in favor of "--blend-colorspace" ⚠️ (like, it's on its way out, don't get too attached)
  • -d, --depth=DEPTH — sets the number of bits per channel of the output image, where DEPTH is "8", "16", "32", "r32", or "r64" 🎚️
  • -f WIDTHxHEIGHT[+xXOFFSET+yYOFFSET] — manually sets the size and position of the output image; useful for cropped and shifted input TIFF images, such as those produced by Nona. lowkey essential for the crop girlies 🎀
  • -g — associated-alpha hack for Gimp (before version 2) and Cinepaint. vintage behaviour, honestly iconic 💀
  • -w, --wrap[=MODE] — wrap around the image boundary, where MODE is "none", "horizontal", "vertical", or "both"; default: none; without an argument the option selects horizontal wrapping 🌀

🍓 Fusion options:

  • --exposure-weight=WEIGHT — the weight given to well-exposed pixels (0 <= WEIGHT <= 1); default: 1 ☀️
  • --saturation-weight=WEIGHT — the weight given to highly-saturated pixels (0 <= WEIGHT <= 1); default: 0.2 🎨
  • --contrast-weight=WEIGHT — the weight given to pixels in high-contrast neighborhoods (0 <= WEIGHT <= 1); default: 0 🔲
  • --entropy-weight=WEIGHT — the weight given to pixels in high entropy neighborhoods (0 <= WEIGHT <= 1); default: 0 🌪️
  • --exposure-optimum=OPTIMUM — the optimum exposure value, usually the maximum of the weighting function (0 <= OPTIMUM <= 1); default: 0.5 ⭐
  • --exposure-width=WIDTH — the characteristic width of the weighting function (WIDTH > 0); default: 0.2 📏
  • --soft-mask — averages over all masks; this is the default 🫧
  • --hard-mask — forces hard blend masks and no averaging on the finest scale; this is especially useful for focus stacks with thin and high contrast features, but leads to increased noise. so like, sharper but noisier, choose your fighter 😭

🧠 Expert options:

  • --save-masks[=SOFT-TEMPLATE[:HARD-TEMPLATE]] — saves weight masks in SOFT-TEMPLATE and HARD-TEMPLATE; the conversion chars are: "%i": mask index, "%n": mask number, "%p": full path, "%d": dirname, "%b": basename, "%f": filename, "%e": extension; lowercase characters refer to input images, uppercase to the output image; default: "softmask-%n.tif":"hardmask-%n.tif" 💾✨
  • --load-masks[=SOFT-TEMPLATE[:HARD-TEMPLATE]] — skips calculation of weight maps and uses the ones in the files matching the templates instead. these can be either hard or soft masks. for template syntax see "--save-masks"; default: "softmask-%n.tif":"hardmask-%n.tif" 📥
  • --fallback-profile=PROFILE-FILE — uses the ICC profile from PROFILE-FILE instead of sRGB 🖼️
  • --layer-selector=ALGORITHM — sets the layer selector ALGORITHM; default: "all-layers"; the available algorithms are: "all-layers": select all layers in any image; "first-layer": select only the first layer in each (multi-)layer image; "last-layer": select only the last layer in each (multi-)layer image; "largest-layer": select the largest layer in each (multi-)layer image; "no-layer": do not select any layer from any image; 👑
  • --parameter=KEY1[=VALUE1][:KEY2[=VALUE2][:...]] — sets one or more KEY-VALUE pairs 🔑

💜 Expert fusion options:

  • --exposure-weight-function=WEIGHT-FUNCTION — (1st form) selects one of the built-in exposure WEIGHT-FUNCTIONs: "gaussian", "lorentzian", "half-sine", "full-sine", or "bi-square"; default: "gaussian" 🧮
  • --exposure-weight-function=SHARED-OBJECT:SYMBOL[:ARGUMENT[:...]] — (2nd form) loads the user-defined exposure weight function SYMBOL from SHARED-OBJECT and optionally passes ARGUMENTs. bring your own math, we love a DIY queen 🛠️
  • --exposure-cutoff=LOWERCUTOFF[:UPPERCUTOFF[:LOWERPROJECTOR[:UPPERPROJECTOR]]] — LOWERCUTOFF and UPPERCUTOFF are the values below or above which pixels are weighted with zero weight in exposure weighting; append "%" signs for relative values; default: 0%:100%:anti-value:value ✂️
  • --contrast-window-size=SIZE — sets the window SIZE for local-contrast analysis (SIZE >= 3); default: 5 🪟
  • --contrast-edge-scale=EDGESCALE[:LCESCALE[:LCEFACTOR]] — sets the scale on which to look for edges; a positive LCESCALE switches on local contrast enhancement by LCEFACTOR (EDGESCALE, LCESCALE, LCEFACTOR >= 0); append "%" to LCESCALE for values relative to EDGESCALE; append "%" to LCEFACTOR for a relative value; default: 0:0:0 🔎
  • --contrast-min-curvature=CURVATURE — the minimum CURVATURE for an edge to qualify; append "%" for relative values; default: 0 📐
  • --gray-projector=PROJECTOR — applies the gray-scale PROJECTOR in exposure or contrast weighing, where PROJECTOR is one of "anti-value", "average", "l-star", "lightness", "luminance", "pl-star", "value", or "channel-mixer:RED-WEIGHT:GREEN-WEIGHT:BLUE-WEIGHT"; default: "average" 🩶
  • --entropy-window-size=SIZE — sets the window SIZE for local entropy analysis (SIZE >= 3); default: 3 🌪️
  • --entropy-cutoff=LOWERCUTOFF[:UPPERCUTOFF] — LOWERCUTOFF is the value below which pixels are treated as black and UPPERCUTOFF is the value above which pixels are treated as white in the entropy weighting; append "%" signs for relative values; default: 0%:100% ⚫⚪

🎀 Information options:

  • -h, --help — prints this help message and exits 🙋‍♀️
  • -V, --version — outputs version information and exits 🏷️
  • --show-globbing-algorithms — shows all globbing algorithms 🧩
  • --show-image-formats — shows all recognized image formats and their filename extensions 📚
  • --show-signature — shows who compiled the binary, when, and on which machine 🕵️‍♀️
  • --show-software-components — shows the software components with which Enfuse was compiled 🧱

Enfuse accepts arguments to any option in uppercase as well as in lowercase letters. no cap, she's flexible like that 💅

🌸 ENVIRONMENT 🌸

  • OMP_NUM_THREADS — the OMP_NUM_THREADS environment variable sets the number of threads to use in OpenMP parallel regions. if unset, Enfuse uses as many threads as there are CPUs. multithreaded queen 👑
  • OMP_DYNAMIC — the OMP_DYNAMIC environment variable controls dynamic adjustment of the number of threads to use in executing OpenMP parallel regions. she's adaptable 🦋

🫶 AUTHOR 🫶

Written by Andrew Mihal, Christoph Spiel and others. legends only ✨

🐛 REPORTING BUGS 🐛

Report bugs at <https://bugs.launchpad.net/enblend>. bestie if something breaks, tell the devs, don't just suffer in silence 😭

Copyright © 2004-2009 Andrew Mihal.

Copyright © 2009-2017 Christoph Spiel.

License GPLv2+: GNU GPL version 2 or later <http://www.gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. ⚠️ like fr fr, no warranty, read it and weep (affectionately)

and that's the page, bestie 🌟 this is enfuse 4.2.1-0bcfaaf743e7, dated September 2024, from the User Commands manual — go fuse some images and slay 💅🎀🦋

📦 where this page comes from