You're seeing a degraded version of this site because the site's layout requires JavaScript. Please activate JavaScript and reload this page.

User Manual

Last update: 8 September 2008

Quick Start Guide

Windows

Documentation coming soon.

Mac OS X

Documentation coming soon.

Linux

Enblend and Enfuse come together in a single package for many popular Linux distributions. Search for "enblend" in your package manager.

You can also build both programs from source:
  1. Download and unpack the source .tar.gz.
  2. ./configure
  3. make install

Command Line Options

Example:

enblend -o output.tif input1.tif input2.tif ...

Enblend blends the images in the order you specify on the command line. You should order your images according to the way that they overlap, for example from left-to-right across the panorama. If you are making a multi-row panorama, I recommend blending each horizontal row individually, and then running Enblend a final time to blend all of the rows together vertically.

Common Options

-a   Pre-assemble as many non-overlapping images as possible before each blending iteration. This overrides the default behavior which is to blend images one at a time in the order specified on the command line. Enblend will do fewer blending iterations, but it will do more work in each iteration.
-h   Print information on the available options
-l number Use exactly this many levels for pyramid blending. This trades off quality of results for faster execution time and lower memory usage. The default is to use as many levels as appropriate given the size of the overlap region. Enblend may still use a smaller number of levels if the geometry of the images demands it.
-o filename Specify the name of the output file.
-v   Verbose output.
-w   Blend around the -180/+180 boundary. Useful for full-360 panoramas. Enblend currently does not blend the zenith or nadir, so you may still see some seams in these areas.
--compression COMP Select the type of compression used for the output image. For TIFF files, the valid settings are NONE, PACKBITS, LZW, and DEFLATE. For JPEG files, the valid setting is an integer between 0 and 100.
-z   Use LZW compression for the output image.
-x Checkpoint partial results to the output file after each blending step.

Extended Options for Advanced Users

-b kilobytes Set the block size for Enblend's image cache. This is the amount of data that Enblend will move to and from the disk in one go. The default is 2 MiB which should be good for most systems.
-c   Use the CIECAM02 color appearance model  for blending colors. Your input TIFF files should have embedded ICC profiles. If no ICC profile is present, Enblend will assume that image uses the sRGB color space. The difference between using this option and Enblend's default color blending algorithm is very slight, and will be most noticeable when you need to blend areas of different primary colors together.
-f WxH+x0+y0 Set the size of the output image manually. This is useful when the input images are cropped and shifted TIFF files, such as those produced by Nona's "Multifle TIFF" stitching option. A cropped and shifted TIFF saves space and time because it is just large enough for a single input image, instead of being the size of the entire output panorama with lots of empty space all around. Nona embeds a (x,y) offset coordinate in the file so that Enblend can tell where the image belongs in the final panorama.

By default, if you give Enblend cropped and shifted TIFFs, the output will also be a cropped and shifted TIFF. Sometimes you may want to include the extra blank space anyway, for example if you are creating a 360-degree panorama and the image size must be exactly a 2:1 ratio. In this case, use the -f parameter to manually set the size of the output image.
-g   Gimp (ver. < 2) and Cinepaint exhibit unusual behaviors when loading images with unassociated alpha channels. With this flag Enblend will create the output image with the associated alpha tag set, even though the image is really unassociated alpha.
--gpu Use the graphics card to accelerate some computations. This is an experimental feature that may not work on all systems. Currently, only mask optimization strategy 1 benefits from this option.
-m megabytes Set the size of Enblend's image cache. This is the amount of memory Enblend will use for storing image data before swapping to disk. The default is 1 GiB.
--visualize filename Create an output image that visualizes the mask optimization process. This shows Enblend's view of the overlap region and how it decided to route the seam line. If you are experiencing artifacts or unexpected output, it may be useful to include this visualization image in your bug report.

Mask Generation Options

--coarse-mask Use a scaled-down version of the input images to create the seam line. This is the default.
--fine-mask Use the full-size images to create the seam line. This can be slow. Use this option if you have very narrow overlap regions.
--optimize Use a two-strategy approach to route the seam line around mismatches in the overlap region. This is the default.
--no-optimize Turn off seam line optimization. Combined with --fine-mask, this will produce the same type of mask as Enblend 2.5.
--save-mask filename Save the generated mask to an image file. Use this option if you wish to edit the location of the seam line by hand. This will give you a template of the right size that you can edit to make your changes. Then, use the --load-mask option to blend the project with your custom seam line.
--load-mask filename Instead of generating a mask, use the one in the give file.