---
name: "enblend-mp"
section: "1"
platform: "linux"
package: "enblend"
version: "4.1.3+dfsg-2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/enblend"
---

# enblend-mp(1)

combine images using a multiresolution spline

Part of [enblend(1)](/enblend/1.md).

## NAME

enblend - combine images using a multiresolution spline

## SYNOPSIS

**enblend** \[*options*\] \[*--output=IMAGE*\] *INPUT*...

## DESCRIPTION

Blend INPUT images into a single IMAGE.

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

### Common options:

- **-V**, **--version**

  output version information and exit

- **-a**

  pre-assemble non-overlapping images

- **-h**, **--help**

  print this help message and exit

- **-l**, **--levels**=*LEVELS*

  limit number of blending LEVELS to use (1 to 29); negative number of LEVELS decreases maximum; "auto" restores the default automatic maximization

- **-o**, **--output**=*FILE*

  write output to FILE; default: "a.tif"

- **-v**, **--verbose**\[=*LEVEL*\]

  verbosely report progress; repeat to increase verbosity or directly set to LEVEL

- **-w**, **--wrap**\[=*MODE*\]

  wrap around image boundary, where MODE is "none", "horizontal", "vertical", or "both"; default: none; without argument the option selects horizontal wrapping

- **-x**

  checkpoint partial results

- **--compression**=*COMPRESSION*

  set compression of 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

- **--layer-selector**=*ALGORITHM*

  set the layer selector ALGORITHM; default: "all-layers"; available algorithms are: "all-layers": select all layers in all images; "first-layer": select only first layer in each multi-layer image; "largest-layer": select largest layer in each multi-layer image; "no-layer": do not select any layer from any image;

- **--parameter**=*KEY1\[=VALUE1\]\[*:KEY2\[=VALUE2\]\[:...\]\]

  set one or more KEY-VALUE pairs

### Extended options:

- **-b** BLOCKSIZE

  image cache BLOCKSIZE in kilobytes; default: 2048KB

- **-c**, **--ciecam**

  use CIECAM02 to blend colors; disable with "--no-ciecam"

- **--fallback-profile**=*PROFILE-FILE*

  use the ICC profile from PROFILE-FILE instead of sRGB

- **-d**, **--depth**=*DEPTH*

  set the number of bits per channel of the output image, where DEPTH is "8", "16", "32", "r32", or "r64"

- **-g**

  associated-alpha hack for Gimp (before version 2) and Cinepaint

- **--gpu**

  use graphics card to accelerate seam-line optimization

- **-f** WIDTHxHEIGHT\[+xXOFFSET+yYOFFSET\]

  manually set the size and position of the output image; useful for cropped and shifted input TIFF images, such as those produced by Nona

- **-m** CACHESIZE

  set image CACHESIZE in megabytes; default: 1024MB

### Mask generation options:

- **--primary-seam-generator**=*ALGORITHM*

  use main seam finder ALGORITHM, where ALGORITHM is "nearest-feature-transform" or "graph-cut"; default: "nearest-feature-transform"

- **--image-difference**=*ALGORITHM\[*:LUMINANCE-WEIGHT\[:CHROMINANCE-WEIGHT\]\]

  use ALGORITHM for calculation of the difference image, where ALGORITHM is "max-hue-luminance" or "delta-e"; LUMINANCE-WEIGHT and CHROMINANCE-WEIGHT define the weights of lightness and color; default: delta-e:1: 1

- **--coarse-mask**\[=*FACTOR*\] shrink overlap regions by FACTOR to speedup mask

  generation; this is the default; if omitted FACTOR defaults to 8

- **--fine-mask**

  generate mask at full image resolution; use e.g. if overlap regions are very narrow

- **--smooth-difference**=*RADIUS*

  (deprecated) smooth the difference image prior to seam-line optimization with a Gaussian blur of RADIUS; default: 0 pixels

- **--optimize**

  turn on mask optimization; this is the default

- **--no-optimize**

  turn off mask optimization

- **--optimizer-weights**=*DISTANCE-WEIGHT\[*:MISMATCH-WEIGHT\]

  set the optimizer's weigths for distance and mismatch; default: 8:1

- **--mask-vectorize**=*LENGTH*

  set LENGTH of single seam segment; append "%" for relative value; defaults: 4 for coarse masks and 20 for fine masks

- **--anneal**=*TAU\[*:DELTAE-MAX\[:DELTAE-MIN\[:K-MAX\]\]\]

  set annealing parameters of optimizer strategy 1; defaults: 0.75:7000:5:32

- **--dijkstra**=*RADIUS*

  set search RADIUS of optimizer strategy 2; default: 25 pixels

- **--save-masks**\[=*TEMPLATE*\]

  save generated masks in TEMPLATE; default: "mask-%n.tif"; conversion chars: "%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

- **--load-masks**\[=*TEMPLATE*\]

  use existing masks in TEMPLATE instead of generating them; same template characters as "--save-masks"; default: "mask-%n.tif"

- **--visualize**\[=*TEMPLATE*\] save results of optimizer in TEMPLATE; same template

  characters as "--save-masks"; default: "vis-%n.tif"

Enblend accepts arguments to any option in uppercase as well as in lowercase letters.

## AUTHOR

Written by Andrew Mihal and others.

## REPORTING BUGS

Report bugs at \<https://bugs.launchpad.net/enblend\>.

## COPYRIGHT

Copyright © 2004-2014 Andrew Mihal. 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.

## SEE ALSO

The full documentation for **enblend** is maintained as a Texinfo manual.  If the **info** and **enblend** programs are properly installed at your site, the command

-

  **info enblend**

should give you access to the complete manual.