/*
 * Copyright (C) 2004-2009 Andrew Mihal
 * Copyright (C) 2009-2016 Christoph Spiel
 *
 * This file is part of Enblend.
 *
 * Enblend is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * Enblend is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Enblend; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */
#ifndef MASK_H_INCLUDED_
#define MASK_H_INCLUDED_

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#include <iostream>
#include <functional>
#include <numeric>

#include <vigra/contourcirculator.hxx>
#include <vigra/error.hxx>
#include <vigra/functorexpression.hxx>
#include <vigra/impex.hxx>
#include <vigra/impexalpha.hxx>
#include <vigra/initimage.hxx>
#include <vigra/numerictraits.hxx>
#include <vigra/pixelneighborhood.hxx>
#include <vigra/transformimage.hxx>

#include "fillpolygon.hxx"
#include "rect2d.hxx"
#include "stride.hxx"

#include "common.h"
#include "anneal.h"
#include "muopt.h"
#include "nearest.h"
#include "parameter.h"
#include "path.h"
#include "postoptimizer.h"
#include "graphcut.h"
#include "maskcommon.h"
#include "masktypedefs.h"


using vigra::functor::Arg1;
using vigra::functor::Arg2;
using vigra::functor::Arg3;
using vigra::functor::ifThenElse;
using vigra::functor::Param;
using vigra::functor::UnaryFunctor;


std::string
stringOfPixelDifferenceFunctor(difference_functor_t aFunctor)
{
    switch (aFunctor)
    {
    case HueLuminanceMaxDifference: return "maximum-hue-luminance";
    case DeltaEDifference: return "delta-e";
    default: NEVER_REACHED("switch control expression \"aFunctor\" out of range");
    }

    return "unknown";
}


namespace enblend {
void
dump_segment(const Segment& segment,
             const std::string& prefix = std::string(), std::ostream& out = std::cout)
{
    const unsigned points_per_line = 5U;
    unsigned n = 1U;
    const size_t size = segment.size();

    out <<
        prefix << "{segment with " << size <<
        " point(s): // suffix 'f' means frozen point\n" << prefix;
    for (Segment::const_iterator i = segment.begin(); i != segment.end(); ++i, ++n)
    {
        // Append an 'f' to non-movable ("frozen") segment points.
        out << ' ' << i->second << (i->first ? ' ' : 'f');
        if (n % points_per_line == 0U && n != size)
        {
            out << '\n' << prefix;
        }
    }
    out << "\n" << prefix << "}\n";
}


void
dump_contour(const Contour& contour,
             const std::string& prefix = std::string(), std::ostream& out = std::cout)
{
    out << prefix << "{contour with " << contour.size() << " segment(s):\n";
    for (Contour::const_iterator i = contour.begin(); i != contour.end(); ++i)
    {
        dump_segment(**i, prefix + "    ", out);
    }
    out << prefix << "}\n";
}


void
dump_contourvector(const ContourVector& contourvector,
                   const std::string& prefix = std::string(), std::ostream& out = std::cout)
{
    out << prefix << "{contourvector with " << contourvector.size() << " contour(s):\n";
    for (ContourVector::const_iterator i = contourvector.begin(); i != contourvector.end(); ++i)
    {
        dump_contour(**i, prefix + "    ", out);
    }
    out << prefix << "}\n";
}


template <typename ImageType>
void
visualizePoint(ImageType& image,
               const vigra::Point2D& location,
               typename ImageType::PixelType value)
{
    typedef typename ImageType::Iterator Iterator;

    Iterator point(image.upperLeft() + location);

    if (point.x >= image.upperLeft().x && point.x < image.lowerRight().x &&
        point.y >= image.upperLeft().y && point.y < image.lowerRight().y) {
        image.accessor().set(value, point);
    }
}


template <typename T>
inline T
round_to(double x)
{
    return static_cast<T>(x >= 0.0 ? x + 0.5 : x - 0.5);
}


template <typename ImageType>
void
visualizePoint(ImageType& image,
               const vigra::Point2D& location,
               typename ImageType::PixelType value,
               marker_t marker,
               int radius)
{
    if (radius <= 0)
    {
        return;
    }

    const int r_sqrt2 = round_to<int>(static_cast<double>(radius) / 1.414213562373095);

    switch (marker)
    {
    case NO_MARKER: return;

    case DOT_MARKER:
        visualizePoint(image, location, value);
        break;

    case PLUS_MARKER:
        for (int i = -radius; i <= radius; ++i)
        {
            visualizePoint(image, location + vigra::Point2D(i, 0), value);
            visualizePoint(image, location + vigra::Point2D(0, i), value);
        }
        break;

    case CROSS_MARKER:
        for (int i = -r_sqrt2; i <= r_sqrt2; ++i)
        {
            visualizePoint(image, location + vigra::Point2D(i, i), value);
            visualizePoint(image, location + vigra::Point2D(-i, i), value);
        }
        break;

    case HOLLOW_SQUARE_MARKER:
        for (int i = -r_sqrt2; i <= r_sqrt2; ++i)
        {
            visualizePoint(image, location + vigra::Point2D(-r_sqrt2, i), value);
            visualizePoint(image, location + vigra::Point2D(r_sqrt2, i), value);
            visualizePoint(image, location + vigra::Point2D(i, -r_sqrt2), value);
            visualizePoint(image, location + vigra::Point2D(i, r_sqrt2), value);
        }
        break;

    case HOLLOW_DIAMOND_MARKER:
        for (int i = 0; i <= radius; ++i)
        {
            visualizePoint(image, location + vigra::Point2D(i - radius, i), value);
            visualizePoint(image, location + vigra::Point2D(i, i - radius), value);
            visualizePoint(image, location + vigra::Point2D(-i + radius, i), value);
            visualizePoint(image, location + vigra::Point2D(-i, i - radius), value);
        }
        break;

    default:
        visualizePoint(image, location, value);
    }
}


// Draw a line from begin to end in image.  Use value as pixel color.
//
// The algorithm is not implemented efficiently.  However, the
// function is only called to visualize the initial seam line, which
// we do not consider a performance-critical job.
template <typename ImageType>
void
visualizeLine(ImageType& image,
              const vigra::Point2D& begin, const vigra::Point2D& end,
              typename ImageType::PixelType value)
{
    typedef typename ImageType::Iterator Iterator;

    const vigra::Diff2D difference(end - begin);
    const int stepX = sign(difference.x);
    const int stepY = sign(difference.y);
    Iterator point(image.upperLeft() + begin);
    const Iterator stop(image.upperLeft() + end);
    double error = 0.0;

    //std::cout << "+ [" << begin << " .. " << end << "]\n";

    const vigra::Size2D size(image.size());
    // Exit immediately if both start point and end point are outside of the image.
    if (!(begin.x >= 0 && begin.x < size.x && begin.y >= 0 && begin.y < size.y &&
          end.x >= 0 && end.x < size.x && end.y >= 0 && end.y < size.y)) {
        return;
    }

    if (abs(difference.x) >= abs(difference.y)) {
        const double delta_error =
            difference.x == 0 ?
            0.0 :
            fabs(static_cast<double>(difference.y) / static_cast<double>(difference.x));
        while (true) {
            if (point.x >= image.upperLeft().x && point.x < image.lowerRight().x &&
                point.y >= image.upperLeft().y && point.y < image.lowerRight().y) {
                image.accessor().set(value, point);
            }
            if (point.x == stop.x) {
                break;
            }
            error += delta_error;
            if (fabs(error) >= 0.5) {
                point.y += stepY;
                error -= 1.0;
            }
            point.x += stepX;
        }
    } else {
        const double delta_error =
            difference.y == 0 ?
            0.0 :
            fabs(static_cast<double>(difference.x) / static_cast<double>(difference.y));
        while (true) {
            if (point.x >= image.upperLeft().x && point.x < image.lowerRight().x &&
                point.y >= image.upperLeft().y && point.y < image.lowerRight().y) {
                image.accessor().set(value, point);
            }
            if (point.y == stop.y) {
                break;
            }
            error += delta_error;
            if (fabs(error) >= 0.5) {
                point.x += stepX;
                error -= 1.0;
            }
            point.y += stepY;
        }
    }
}


template <typename vertex_function>
vertex_function
for_each_vertex(ContourVector::iterator first, ContourVector::iterator last, vertex_function f)
{
    for (ContourVector::iterator contour = first; contour != last; ++contour) {
        for (Contour::iterator segment = (*contour)->begin(); segment != (*contour)->end(); ++segment) {
            Segment* const snake = *segment;
            for (Segment::iterator vertex = snake->begin(); vertex != snake->end(); ++vertex) {
                f(vertex);
            }
        }
    }

    return f;
}


template <typename value, typename predicate>
class FindAverageAndVarianceIf
{
public:
    typedef value argument_type;
    typedef value first_argument_type;
    typedef double second_argument_type;
    typedef typename vigra::NumericTraits<value>::RealPromote result_type;
    typedef typename vigra::NumericTraits<value>::RealPromote value_type;

    explicit FindAverageAndVarianceIf(predicate aPredicate) :
        sum_(0.0), sum_of_squares_(0.0), count_(0.0), pred_(aPredicate) {}

    void reset() {
        count_ = 0.0;
        sum_of_squares_ = 0.0;
        count_ = 0.0;
    }

    void operator()(const argument_type& v) {
        if (pred_(v)) {
            count_ += 1.0;
            sum_ += static_cast<double>(v);
            sum_of_squares_ += square(static_cast<double>(v));
        }
    }

    unsigned count() const {return static_cast<unsigned>(count_);}

    result_type average() const {
        assert(count_ != 0.0);
        return static_cast<result_type>(sum_ / count_);
    }

    result_type variance() const {
        assert(count_ != 0.0);
        return static_cast<result_type>((sum_of_squares_ - square(sum_) / count_) / count_);
    }

private:
    double sum_;
    double sum_of_squares_;
    double count_;
    predicate pred_;
};


template <typename ValueType, typename AccessorType>
class XorAccessor
{
public:
    typedef ValueType value_type;
    typedef AccessorType accessor_type;

    explicit XorAccessor(AccessorType a) : acc(a) {}

    template <class Iterator>
    ValueType operator()(const Iterator& i) const {return acc(i);}

    ValueType operator()(const ValueType* i) const {return acc(i);}

    template <class Iterator, class Difference>
    ValueType operator()(const Iterator& i, Difference d) const {return acc(i, d);}

    template <class Value, class Iterator>
    void set(const Value& v, const Iterator& i) const {acc.set(v ^ acc(i), i);}

    template <class Value, class Iterator>
    void set(const Value& v, Iterator& i) const {acc.set(v ^ acc(i), i);}

    template <class Value, class Iterator, class Difference>
    void set(const Value& v, const Iterator& i, const Difference& d) const {acc.set(v ^ acc(i, d), i, d);}

private:
    AccessorType acc;
};


template <class BackInsertionIterator>
void
closedPolygonsOfContourSegments(const vigra::Size2D& mask_size, const Contour& contour,
                                BackInsertionIterator result)
{
#ifdef DEBUG_POLYGON_FILL
    const vigra::Diff2D border(10, 10);
    vigra::BRGBImage polygon_image(mask_size + border + border);

    visualizeLine(polygon_image,
                  vigra::Point2D(0, 0) + border, vigra::Point2D(mask_size.x, 0) + border,
                  VISUALIZE_RGB_COLOR_GREEN3);
    visualizeLine(polygon_image,
                  vigra::Point2D(mask_size.x, 0) + border, vigra::Point2D(mask_size.x, mask_size.y) + border,
                  VISUALIZE_RGB_COLOR_GREEN3);
    visualizeLine(polygon_image,
                  vigra::Point2D(mask_size.x, mask_size.y) + border, vigra::Point2D(0, mask_size.y) + border,
                  VISUALIZE_RGB_COLOR_GREEN3);
    visualizeLine(polygon_image,
                  vigra::Point2D(0, mask_size.y) + border, vigra::Point2D(0, 0) + border,
                  VISUALIZE_RGB_COLOR_GREEN3);

    std::cout << "+ closedPolygonsOfContourSegments: #segments = " << contour.size() << "\n";
#endif

    vigra::Point2D last_point;

    for (Contour::const_iterator segment = contour.begin(); segment != contour.end(); ++segment) {
        const Segment::iterator vertex_begin((*segment)->begin());
        const Segment::iterator vertex_end((*segment)->end());

        for (Segment::iterator vertex = vertex_begin; vertex != vertex_end; ++vertex) {
            last_point = vigra::Point2D(vertex->second.x, vertex->second.y);
            *result++ = last_point;
        }

#ifdef DEBUG_POLYGON_FILL
        std::cout << "+ closedPolygonsOfContourSegments: #vertices = " << (*segment)->size() << "\n";

        Segment::iterator previous_vertex;
        for (Segment::iterator vertex = vertex_begin; vertex != vertex_end; ++vertex) {
            const vigra::Point2D p(vertex->second.x, vertex->second.y);

            if (vertex != vertex_begin) {
                const vigra::Point2D q(previous_vertex->second.x, previous_vertex->second.y);
                visualizeLine(polygon_image,
                              q + border, p + border,
                              VISUALIZE_RGB_COLOR_MAGENTA2);
            }
            previous_vertex = vertex;

            visualizePoint(polygon_image, p + border, VISUALIZE_RGB_COLOR_RED1);
        }
#endif
    }

    const Segment::iterator firstVertex((*(contour.begin()))->begin());
    const vigra::Point2D first_point(firstVertex->second.x, firstVertex->second.y);
    if (first_point != last_point) {
        *result++ = first_point;
    }
    *result++ = END_OF_SEGMENT_MARKER;

#ifdef DEBUG_POLYGON_FILL
    vigra::exportImage(srcImageRange(polygon_image), vigra::ImageExportInfo(",polygon.tif"));
#endif
}


template <typename MaskType>
void
fillContourScanLine(MaskType* mask, const Contour& contour, const vigra::Diff2D& offset)
{
    typedef typename MaskType::PixelType MaskPixelType;
    typedef typename MaskType::Accessor MaskAccessor;

    const vigra::Size2D mask_size(mask->lowerRight() - mask->upperLeft());
    std::vector<vigra::Point2D> polygon;

    closedPolygonsOfContourSegments(mask_size, contour, std::back_inserter(polygon));

    vigra_ext::fill_polygon(mask->upperLeft() + offset, mask->lowerRight() + offset,
                            XorAccessor<MaskPixelType, MaskAccessor>(mask->accessor()),
                            polygon.begin(), polygon.end(),
                            ~MaskPixelType());
}


template <typename MaskType>
void
fillContourScanLineActive(MaskType* mask, const Contour& contour, const vigra::Diff2D& offset)
{
    typedef typename MaskType::PixelType MaskPixelType;
    typedef typename MaskType::Accessor MaskAccessor;

    const vigra::Size2D mask_size(mask->lowerRight() - mask->upperLeft());
    std::vector<vigra::Point2D> polygon;

    closedPolygonsOfContourSegments(mask_size, contour, std::back_inserter(polygon));

    vigra_ext::fill_polygon_active(mask->upperLeft() + offset, mask->lowerRight() + offset,
                                   XorAccessor<MaskPixelType, MaskAccessor>(mask->accessor()),
                                   polygon.begin(), polygon.end(),
                                   ~MaskPixelType());
}


template <typename MaskType>
void
fillContour(MaskType* mask, const Contour& contour, const vigra::Diff2D& offset)
{
    const std::string routine_name(parameter::as_string("polygon-filler", "new-active"));

#ifdef DEBUG_POLYGON_FILL
    std::cout << "+ fillContour: mask offset = " << offset << "\n";
#endif

    if (routine_name == "new") {
#ifdef DEBUG_POLYGON_FILL
        std::cout << "+ fillContour: use fillContourScanLine polygon filler\n";
#endif
        fillContourScanLine(mask, contour, offset);
    } else {
#ifdef DEBUG_POLYGON_FILL
        std::cout << "+ fillContour: use fillContourScanLineActive polygon filler\n";
#endif
        fillContourScanLineActive(mask, contour, offset);
    }
}


template <typename MaskType>
void
maskBounds(MaskType* mask, const vigra::Rect2D& uBB, vigra::Rect2D& mBB)
{
    typedef typename MaskType::PixelType MaskPixelType;
    typedef typename MaskType::traverser MaskIteratorType;

    // Find the bounding box of the mask transition line and put it in mBB.
    // mBB starts out as empty rectangle.
    mBB = vigra::Rect2D(vigra::Point2D(mask->size()), vigra::Point2D(0, 0));

    MaskIteratorType myPrev = mask->upperLeft();
    MaskIteratorType my = mask->upperLeft() + vigra::Diff2D(0, 1);
    MaskIteratorType mend = mask->lowerRight();
    MaskIteratorType mxLeft = myPrev;
    MaskIteratorType mx = myPrev + vigra::Diff2D(1, 0);

    for (int x = 1; mx.x < mend.x; ++x, ++mx.x, ++mxLeft.x) {
        if (*mxLeft != *mx) {
            mBB |= vigra::Rect2D(x - 1, 0, x + 1, 1);
        }
    }
    for (int y = 1; my.y < mend.y; ++y, ++my.y, ++myPrev.y) {
        mxLeft = my;
        mx = my + vigra::Diff2D(1, 0);
        MaskIteratorType mxUpLeft = myPrev;
        MaskIteratorType mxUp = myPrev + vigra::Diff2D(1, 0);

        if (*mxUpLeft != *mxLeft) {
            // Transition line is between mxUpLeft and mxLeft.
            mBB |= vigra::Rect2D(0, y - 1, 1, y + 1);
        }

        for (int x = 1; mx.x < mend.x; ++x, ++mx.x, ++mxLeft.x, ++mxUp.x) {
            if (*mxLeft != *mx) {
                mBB |= vigra::Rect2D(x - 1, y, x + 1, y + 1);
            }
            if (*mxUp != *mx) {
                mBB |= vigra::Rect2D(x, y - 1, x + 1, y + 1);
            }
        }
    }

    // Check that mBB is well-defined.
    if (mBB.isEmpty()) {
        // No transition pixels were found in the mask at all.  This
        // means that one image has no contribution.
        if (*(mask->upperLeft()) == vigra::NumericTraits<MaskPixelType>::zero()) {
            // If the mask is entirely black, then inspectOverlap
            // should have caught this.  It should have said that the
            // white image is redundant.
            std::cerr << command <<
                ": mask is entirely black, but white image was not identified as redundant" <<
                std::endl;
            exit(1);
        } else {
            // If the mask is entirely white, then the black image
            // would have been identified as redundant if black and
            // white were swapped.  Set mBB to the full size of the
            // mask.
            mBB = uBB;
            // Explain why the black image disappears completely.
            std::cerr << command <<
                ": warning: previous images are completely overlapped by the current images" <<
                std::endl;
        }
    } else {
        // mBB is defined relative to inputUnion origin
        //std::cerr << command << ": info: mBB relative to mask: " << mBB << std::endl;
        mBB.moveBy(uBB.upperLeft());
    }

    if (Verbose >= VERBOSE_ROIBB_SIZE_MESSAGES) {
        std::cerr << command << ": info: mask transition line bounding box: " << mBB << std::endl;
    }
}


// Answer whether a_point sits on the boundary of a_rectangle.
inline static
bool
is_on_boundary(const vigra::Point2D& a_point, const vigra::Rect2D& a_rectangle)
{
    return
        a_point.px() == a_rectangle.left() || a_point.px() == a_rectangle.right() ||
        a_point.py() == a_rectangle.top() || a_point.py() == a_rectangle.bottom();
}


// Answer whether a_point sits in one of the corners of a_rectangle.
inline static
bool
is_in_corner(const vigra::Point2D& a_point, const vigra::Rect2D& a_rectangle)
{
    return
        (a_point.px() == a_rectangle.left() || a_point.px() == a_rectangle.right()) &&
        (a_point.py() == a_rectangle.top() || a_point.py() == a_rectangle.bottom());
}


// Vectorize the seam line defined in nftOutputImage into the contour rawSegments.
template <typename MaskType, typename AlphaType>
void
vectorizeSeamLine(Contour& rawSegments,
                  const AlphaType* const whiteAlpha, const AlphaType* const blackAlpha,
                  const vigra::Rect2D& uBB,
                  int nftStride, MaskType* nftOutputImage, int vectorizeDistance = 0)
{
    typedef typename MaskType::PixelType MaskPixelType;
    typedef typename MaskType::traverser MaskIteratorType;

    const double diagonalLength = hypot(static_cast<double>(nftOutputImage->width()),
                                        static_cast<double>(nftOutputImage->height()));
    if (vectorizeDistance == 0) {
        vectorizeDistance =
            MaskVectorizeDistance.is_percentage() ?
            static_cast<int>(ceil(MaskVectorizeDistance.value() / 100.0 * diagonalLength)) :
            MaskVectorizeDistance.value();
    }

    if (vectorizeDistance < minimumVectorizeDistance) {
        std::cerr << command <<
            ": warning: mask vectorization distance " <<
            vectorizeDistance <<
            " (" <<
            100.0 * vectorizeDistance / diagonalLength <<
            "% of diagonal) is smaller\n" <<
            command <<
            ": warning: than minimum of " << minimumVectorizeDistance <<
            "; will use " << minimumVectorizeDistance << " (" <<
            100.0 * minimumVectorizeDistance / diagonalLength <<
            "% of diagonal)" <<
            std::endl;
        vectorizeDistance = minimumVectorizeDistance;
    }

    const MaskPixelType zero(vigra::NumericTraits<MaskPixelType>::zero());
    const MaskPixelType one(vigra::NumericTraits<MaskPixelType>::one());

    const vigra::Rect2D border(1, 1, nftOutputImage->width() - 1, nftOutputImage->height() - 1);
    MaskIteratorType my = nftOutputImage->upperLeft() + vigra::Diff2D(1, 1);
    MaskIteratorType mend = nftOutputImage->lowerRight() + vigra::Diff2D(-1, -1);

    for (int y = 1; my.y < mend.y; ++y, ++my.y) {
        MaskIteratorType mx = my;
        MaskPixelType lastColor = zero;
        for (int x = 1; mx.x < mend.x; ++x, ++mx.x) {
            if (*mx == vigra::NumericTraits<MaskPixelType>::max() && lastColor == zero) {
                // Found the corner of a previously unvisited white region.
                // Create a Segment to hold the border of this region.
                Segment* snake = new Segment();
                rawSegments.push_back(snake);

                std::vector<vigra::Point2D> excessPoints;

                // Walk around border of white region.
                vigra::CrackContourCirculator<MaskIteratorType> crack(mx);
                const vigra::CrackContourCirculator<MaskIteratorType> crackEnd(crack);
                bool lastPointFrozen = false;
                int distanceLastPoint = 0;
                do {
                    const vigra::Point2D currentPoint = *crack + vigra::Diff2D(x, y);
                    crack++;
                    const vigra::Point2D nextPoint = *crack + vigra::Diff2D(x, y);

                    // See if currentPoint lies on border.
                    if (is_on_boundary(currentPoint, border)) {
                        // See if currentPoint is in a corner.
                        if (is_in_corner(currentPoint, border)) {
                            snake->push_front(std::make_pair(false, currentPoint));
                            distanceLastPoint = 0;
                        } else if (!lastPointFrozen || !is_on_boundary(nextPoint, border)) {
                            snake->push_front(std::make_pair(false, currentPoint));
                            distanceLastPoint = 0;
                        } else {
                            excessPoints.push_back(currentPoint);
                        }
                        lastPointFrozen = true;
                    } else {
                        // Current point is not frozen.
                        if (distanceLastPoint % vectorizeDistance == 0) {
                            snake->push_front(std::make_pair(true, currentPoint));
                            distanceLastPoint = 0;
                        } else {
                            excessPoints.push_back(currentPoint);
                        }
                        lastPointFrozen = false;
                    }
                    distanceLastPoint++;
                } while (crack != crackEnd);

                // Paint the border so this region will not be found again.
                for (Segment::iterator vertexIterator = snake->begin();
                     vertexIterator != snake->end(); ++vertexIterator) {
                    (*nftOutputImage)[vertexIterator->second] = one;

                    // While we're at it, convert vertices to uBB-relative coordinates.
                    vertexIterator->second = nftStride * (vertexIterator->second + vigra::Diff2D(-1, -1));

                    // While we're at it, mark vertices outside the union region as not moveable.
                    if (vertexIterator->first &&
                        (*whiteAlpha)[vertexIterator->second + uBB.upperLeft()] == zero &&
                        (*blackAlpha)[vertexIterator->second + uBB.upperLeft()] == zero) {
                        vertexIterator->first = false;
                    }
                }

                // These are points on the border of the white region
                // that are not in the snake.  Recolor them so that
                // this (white) region will not be found again.
                for (std::vector<vigra::Point2D>::iterator vertexIterator = excessPoints.begin();
                     vertexIterator != excessPoints.end(); ++vertexIterator) {
                    (*nftOutputImage)[*vertexIterator] = one;
                }

                // Kill empty or single-point snakes right away.
                if (snake->size() <= 1U) {
                    rawSegments.pop_back();
                    delete snake;
                }
            }

            lastColor = *mx;
        }
    }
}


/** Convert rawContours snakes into segments with unbroken runs of
 *  moveable vertices. */
void
reorderSnakesToMovableRuns(ContourVector& contours, const Contour& rawSegments)
{
    for (Contour::const_iterator segments = rawSegments.begin();
         segments != rawSegments.end();
         ++segments) {
        Segment* snake = *segments;

        // Snake becomes multiple separate segments in one contour
        Contour* currentContour = new Contour();
        contours.push_back(currentContour);

        // Check if snake is a closed contour
        bool closedContour = true;
        for (Segment::iterator vertexIterator = snake->begin();
             vertexIterator != snake->end();
             ++vertexIterator) {
            if (!vertexIterator->first) {
                closedContour = false;
                break;
            }
        }

        // Closed contours consist of only moveable vertices.
        if (closedContour) {
            currentContour->push_back(snake);
            continue;
        }

        if (snake->front().first) {
            // First vertex is moveable.  Rotate list so that first
            // vertex is nonmoveable.
            Segment::iterator firstNonmoveableVertex = snake->begin();
            while (firstNonmoveableVertex->first) {
                ++firstNonmoveableVertex;
            }

            // Copy initial run on moveable vertices and first
            // non-moveable vertex to end of list.
            Segment::iterator firstNonmoveableSuccessor = firstNonmoveableVertex;
            ++firstNonmoveableSuccessor;
            if (EXPECT_RESULT(firstNonmoveableSuccessor == snake->end(), false)) {
                snake->insert(std::next(firstNonmoveableVertex), snake->begin(), firstNonmoveableVertex);
            } else {
                snake->insert(snake->end(), // append at the end
                              snake->begin(), firstNonmoveableSuccessor);
            }

            // Erase initial run of moveable vertices.
            snake->erase(snake->begin(), firstNonmoveableVertex);
        }

        // Find last moveable vertex.
        Segment::iterator lastMoveableVertex = snake->begin();
        for (Segment::iterator vertexIterator = snake->begin();
             vertexIterator != snake->end();
             ++vertexIterator) {
            if (vertexIterator->first) {
                lastMoveableVertex = vertexIterator;
            }
        }

        Segment* currentSegment = nullptr;
        bool insideMoveableSegment = false;
        bool passedLastMoveableVertex = false;
        Segment::iterator lastNonmoveableVertex = snake->begin();
        for (Segment::iterator vertexIterator = snake->begin();
             vertexIterator != snake->end();
             ++vertexIterator) {
            // Create a new segment if necessary.
            if (currentSegment == nullptr) {
                currentSegment = new Segment();
                currentContour->push_back(currentSegment);
            }

            // Keep track of when we visit the last moveable vertex.
            // Don't create new segments after this point.
            // Add all remaining nonmoveable vertices to current segment.
            if (vertexIterator == lastMoveableVertex) {
                passedLastMoveableVertex = true;
            }

            // Keep track of last nonmoveable vertex.
            if (!vertexIterator->first) {
                lastNonmoveableVertex = vertexIterator;
            }

            // All segments must begin with a nonmoveable vertex.
            // If only one nonmoveable vertex separates two runs of moveable vertices,
            // that vertex is copied into the beginning of the current segment.
            // It was previously added at the end of the last segment.
            if (vertexIterator->first && currentSegment->empty()) {
                currentSegment->push_front(*lastNonmoveableVertex);
            }

            // Add the current vertex to the current segment.
            currentSegment->push_front(*vertexIterator);

            if (!insideMoveableSegment && vertexIterator->first) {
                // Beginning a new moveable segment.
                insideMoveableSegment = true;
            } else if (insideMoveableSegment && !vertexIterator->first && !passedLastMoveableVertex) {
                // End of currentSegment.
                insideMoveableSegment = false;
                // Correct for the push_fronts we've been doing
                currentSegment->reverse();
                // Cause a new segment to be generated on next vertex.
                currentSegment = nullptr;
            }
        }

        // Reverse the final segment.
        if (currentSegment != nullptr) {
            currentSegment->reverse();
        }

        delete snake;
    }
}


/** Find extent of moveable snake vertices, and vertices bordering
 *  moveable vertices vertex bounding box. */
vigra::Rect2D
vertexBoundingBox(ContourVector& contours)
{
    vigra::Rect2D box;
    bool initializedVBB = false;

    for (ContourVector::iterator currentContour = contours.begin();
         currentContour != contours.end();
         ++currentContour) {
        for (Contour::iterator currentSegment = (*currentContour)->begin();
             currentSegment != (*currentContour)->end();
             ++currentSegment) {
            Segment::iterator lastVertex = (*currentSegment)->begin();
            bool foundFirstMoveableVertex = false;
            for (Segment::iterator vertexIterator = (*currentSegment)->begin();
                 vertexIterator != (*currentSegment)->end();
                 ++vertexIterator) {
                if (vertexIterator->first) {
                    if (!initializedVBB) {
                        box = vigra::Rect2D(vertexIterator->second, vigra::Size2D(1, 1));
                        initializedVBB = true;
                    } else {
                        box |= vertexIterator->second;
                    }

                    if (!foundFirstMoveableVertex) {
                        box |= lastVertex->second;
                    }

                    foundFirstMoveableVertex = true;
                } else if (foundFirstMoveableVertex) {
                    // First nonmoveable vertex at end of run.
                    box |= vertexIterator->second;
                    break;
                }

                lastVertex = vertexIterator;
            }
        }
    }

    return box;
}


inline static int
round_to_nearest_div(int a_numerator, int a_denominator)
{
    const std::div_t result(std::div(a_numerator, a_denominator));
    const int rem2 = 2 * result.rem;

    return rem2 >= a_denominator ? result.quot + 1 : (-rem2 >= a_denominator ? result.quot - 1 : result.quot);
}


template <typename AlphaType>
void
search_for_isolated_points(const AlphaType* const alpha)
{
    // ANTICIPATED CHANGE: We only take care of the inner part of the
    // image `alpha' because `vigra::NeighborhoodCirculator' does not
    // work on along the edges.  If necessary the test can be extended
    // to the edges using `vigra::RestrictedNeighborhoodCirculator'.

    typedef typename AlphaType::const_traverser alpha_traverser;
    typedef vigra::NeighborhoodCirculator<alpha_traverser, vigra::EightNeighborCode> circulator;

    const alpha_traverser t_end(alpha->lowerRight() - vigra::Diff2D(1, 1));
    const vigra::Size2D size(alpha->size());

    unsigned number_of_isolated_points(0U);

#ifdef OPENMP
#pragma omp parallel for reduction(+: number_of_isolated_points) schedule(guided)
#endif
    for (int row = 1; row < size.y - 1; ++row) {
        alpha_traverser t(alpha->upperLeft() + vigra::Diff2D(1, row));
        for (t.x = 1; t.x != t_end.x; ++t.x) {
            if (*t == 0) {
                circulator c(t);
                const circulator c_end(c);

                while (true) {
                    if (*c == 0) {
                        break;
                    }
                    ++c;
                    if (c == c_end) {
                        ++number_of_isolated_points;
                        break;
                    }
                }
            }
        }
    }

    if (number_of_isolated_points >=
        std::max(1U, parameter::as_unsigned("black-alpha-mask-check-isolated-points-threshold", 2U))) {
        std::cerr <<
            command << ": encountered degenerate image/mask geometry; too high risk of defective seam line" <<
            std::endl;
#ifdef DEBUG
        std::cerr <<
            command << ": note: found " << number_of_isolated_points <<
            " isolated points in black alpha mask" << std::endl;
#endif
        exit(1);
    }
}


/** Calculate a blending mask between whiteImage and blackImage.
 */
template <typename ImageType, typename AlphaType, typename MaskType>
MaskType*
createMask(const ImageType* const white,
           const ImageType* const black,
           const AlphaType* const whiteAlpha,
           const AlphaType* const blackAlpha,
           const vigra::Rect2D& uBB,
           const vigra::Rect2D& iBB,
           bool wraparound,
           unsigned numberOfImages,
           FileNameList::const_iterator inputFileNameIterator,
           unsigned m)
{
    typedef typename ImageType::PixelType ImagePixelType;
    typedef typename MaskType::PixelType MaskPixelType;

    if (LoadMasks) {
        // Read mask from a file instead of calculating it.
        MaskType* mask = new MaskType(uBB.size());
        const std::string maskFilename =
            enblend::expandFilenameTemplate(LoadMaskTemplate,
                                            numberOfImages,
                                            *inputFileNameIterator,
                                            OutputFileName,
                                            m);
        if (can_open_file(maskFilename)) {
            vigra::ImageImportInfo maskInfo(maskFilename.c_str());
            if (Verbose >= VERBOSE_MASK_MESSAGES) {
                std::cerr << command << ": info: loading mask \"" << maskFilename << "\"" << std::endl;
            }
            if (!maskInfo.isGrayscale()) {
                std::cerr << command <<
                    ": mask image \"" << maskFilename << "\" is not grayscale" << std::endl;
                exit(1);
            }
            if (maskInfo.numExtraBands() != 0) {
                std::cerr << command <<
                    ": mask image \"" << maskFilename << "\" must not have an alpha channel" <<
                    std::endl;
                exit(1);
            }
            if (std::string(maskInfo.getPixelType()) != vigra::TypeAsString<MaskPixelType>::result()) {
                std::cerr << command <<
                    ": mask image \"" << maskFilename << "\" has pixel type " << maskInfo.getPixelType() << ";\n" <<
                    command <<
                    ": note: expecting pixel type " << vigra::TypeAsString<MaskPixelType>::result() <<
                    std::endl;
                exit(1);
            }
            if (maskInfo.width() != uBB.width() || maskInfo.height() != uBB.height()) {
                const bool too_small = maskInfo.width() < uBB.width() || maskInfo.height() < uBB.height();

                std::string category;
                if (too_small) {
                    category = "warning: ";
                }

                std::cerr << command <<
                    ": " << category << "mask in \"" << maskFilename << "\" has size " <<
                    "(" << maskInfo.width() << "x" << maskInfo.height() << "),\n" <<
                    command <<
                    ": " << category << "    but image union has size " << uBB.size() << ";\n" <<
                    command <<
                    ": " << category << "    make sure this is the right mask for the given images" <<
                    std::endl;

                if (!too_small) {
                    // Mask is too large, loading it would cause a segmentation fault.
                    exit(1);
                }
            }
            importImage(maskInfo, destImage(*mask));
        } else {
            // Cannot read mask file.  We already issued an error
            // message through can_open_file().
            exit(1);
        }

        return mask;
    }

    // Start by using the nearest feature transform to generate a mask.
    vigra::Size2D mainInputSize, mainInputBBSize;
    vigra::Rect2D mainInputBB;
    int mainStride;

    if (CoarseMask) {
        // Do MainAlgorithm at 1/CoarsenessFactor scale.
        // uBB rounded up to multiple of CoarsenessFactor pixels in each direction
        mainInputSize = vigra::Size2D((uBB.width() + CoarsenessFactor - 1) / CoarsenessFactor,
                                      (uBB.height() + CoarsenessFactor - 1) / CoarsenessFactor);
        mainInputBBSize = vigra::Size2D((iBB.width() + CoarsenessFactor - 1) / CoarsenessFactor,
                                        (iBB.height() + CoarsenessFactor - 1) / CoarsenessFactor);

        mainInputBB = vigra::Rect2D(vigra::Point2D(std::floor(double(iBB.upperLeft().x - uBB.upperLeft().x) / CoarsenessFactor),
                             std::floor(double(iBB.upperLeft().y - uBB.upperLeft().y) / CoarsenessFactor)),
                             mainInputBBSize);

        mainStride = CoarsenessFactor;
    } else {
        // Do MainAlgorithm at 1/1 scale.
        mainInputSize = uBB.size();
        mainInputBB = vigra::Rect2D(iBB);
        if (mainInputBB.upperLeft().x >= uBB.upperLeft().x) {
            mainInputBB.moveBy(-uBB.upperLeft());
        } else {
            mainInputBB.moveBy(uBB.upperLeft());
        }
        mainStride = 1;
    }

    vigra::Size2D mainOutputSize;
    vigra::Diff2D mainOutputOffset;

    // GraphCut supports seam visualization without optimizers
    if (!CoarseMask && !OptimizeMask && !VisualizeSeam) {
        // We are not going to vectorize the mask.
        mainOutputSize = mainInputSize;
        mainOutputOffset = vigra::Diff2D(0, 0);
    } else {
        // Add 1-pixel border all around the image for the vectorization algorithm.
        mainOutputSize = mainInputSize + vigra::Diff2D(2, 2);
        mainOutputOffset = vigra::Diff2D(1, 1);
    }

    // mem usage before: 0
    // mem usage after: CoarseMask: 1/8 * uBB * MaskType
    //                  !CoarseMask: uBB * MaskType
    MaskType* mainOutputImage = new MaskType(mainOutputSize);

    const unsigned default_norm_value =
        std::min(static_cast<unsigned>(EuclideanDistance),
                 parameter::as_unsigned("distance-transform-norm", static_cast<unsigned>(EuclideanDistance)));
    const nearest_neighbor_metric_t norm = static_cast<nearest_neighbor_metric_t>(default_norm_value);

    if (MainAlgorithm == GraphCut) {
        graphCut(vigra_ext::stride(mainStride, mainStride, vigra_ext::apply(iBB, srcImageRange(*white))),
                 vigra_ext::stride(mainStride, mainStride, vigra_ext::apply(iBB, srcImage(*black))),
                 vigra::destIter(mainOutputImage->upperLeft() + mainOutputOffset),
                 vigra_ext::stride(mainStride, mainStride, vigra_ext::apply(uBB, srcImageRange(*whiteAlpha))),
                 vigra_ext::stride(mainStride, mainStride, vigra_ext::apply(uBB, srcImage(*blackAlpha))),
                 norm,
                 wraparound ? HorizontalStrip : OpenBoundaries,
                 mainInputBB);
    } else if (MainAlgorithm == NFT) {
        nearestFeatureTransform(vigra_ext::stride(mainStride, mainStride, vigra_ext::apply(uBB, srcImageRange(*whiteAlpha))),
                                vigra_ext::stride(mainStride, mainStride, vigra_ext::apply(uBB, srcImage(*blackAlpha))),
                                vigra::destIter(mainOutputImage->upperLeft() + mainOutputOffset),
                                norm,
                                wraparound ? HorizontalStrip : OpenBoundaries);
    } else {
        NEVER_REACHED("unexpected value of \"MainAlgorithm\"");
    }

    search_for_isolated_points(blackAlpha);

#ifdef DEBUG_NEAREST_FEATURE_TRANSFORM
    {
        typedef std::pair<const char*, const MaskType*> ImagePair;

        const std::array<ImagePair, 3> nft {
            std::make_pair("blackmask", blackAlpha),
            std::make_pair("whitemask", whiteAlpha),
            std::make_pair("nft-output", mainOutputImage)
        };

        for (const auto& x : nft) {
            const std::string nftMaskTemplate(command + "-" + x.first + "-%n.tif");
            const std::string nftMaskFilename =
                enblend::expandFilenameTemplate(nftMaskTemplate,
                                                numberOfImages,
                                                *inputFileNameIterator,
                                                OutputFileName,
                                                m);
            if (Verbose >= VERBOSE_NFT_MESSAGES) {
                std::cerr << command <<
                    ": info: saving nearest-feature-transform image \"" <<
                    nftMaskFilename << "\"" << std::endl;
            }
            vigra::ImageExportInfo nftMaskInfo(nftMaskFilename.c_str());
            nftMaskInfo.setCompression(MASK_COMPRESSION);
            vigra::exportImage(srcImageRange(*x.second), nftMaskInfo);
        }
    }
#endif

    // mem usage before: CoarseMask: 2/8 * uBB * MaskType
    //                   !CoarseMask: 2 * uBB * MaskType
    // mem usage after: CoarseMask: 1/8 * uBB * MaskType
    //                  !CoarseMask: uBB * MaskType

    if (!VisualizeSeam && !CoarseMask && !OptimizeMask) {
        // nftOutputImage is the final mask in this case.
        return mainOutputImage;
    }

    // Vectorize the seam lines found in nftOutputImage.
    Contour rawSegments;
    if (MainAlgorithm == GraphCut) {
        vectorizeSeamLine(rawSegments,
                          whiteAlpha, blackAlpha,
                          uBB,
                          mainStride, mainOutputImage, 4);
    } else {
        vectorizeSeamLine(rawSegments,
                          whiteAlpha, blackAlpha,
                          uBB,
                          mainStride, mainOutputImage);
    }
    delete mainOutputImage;

    if (parameter::as_boolean("debug-seam-line", false)) {
        std::cout << "+ createMask: rawSegments\n";
        dump_contour(rawSegments, "+ createMask: ");
    }

    // mem usage after: 0

    if (!OptimizeMask && !VisualizeSeam) {
        // Simply fill contours to get final unoptimized mask.
        MaskType* mask = new MaskType(uBB.size());
        fillContour(mask, rawSegments, vigra::Diff2D(0, 0));
        // delete all segments in rawSegments
        std::for_each(rawSegments.begin(), rawSegments.end(), [](Segment* x) {delete x;});
        return mask;
    }

    ContourVector contours;
    reorderSnakesToMovableRuns(contours, rawSegments);
    rawSegments.clear();

    if (parameter::as_boolean("debug-seam-line", false)) {
        std::cout << "+ createMask: contours\n";
        dump_contourvector(contours, "+ createMask: ");
    }

    {
        const size_t totalSegments =
            std::accumulate(contours.begin(),
                            contours.end(),
                            0U,
                            [](size_t a, const Contour* x) -> size_t {return a + x->size();});

        if (Verbose >= VERBOSE_MASK_MESSAGES) {
            std::cerr << command << ": info: optimizing ";
            if (totalSegments == 1U) {
                std::cerr << "1 distinct seam";
            } else {
                std::cerr << totalSegments << " distinct seams";
            }
            std::cerr << std::endl;
        }
        if (totalSegments == 0U) {
            std::cerr << command << ": warning: failed to detect any seam" << std::endl;
        }
    }

    vigra::Rect2D vBB = vertexBoundingBox(contours);
    vBB.moveBy(uBB.upperLeft()); // move vBB to be root-relative

    // Make sure that vBB is bigger than iBB by one pixel in each
    // direction.  This will create a max-cost border to keep the seam
    // line from leaving the intersection region.
    vigra::Rect2D iBBPlus = iBB;
    iBBPlus.addBorder(1);
    vBB |= iBBPlus;

    // Vertex-Union bounding box: portion of uBB inside vBB
    const vigra::Rect2D uvBB = vBB & uBB;

    // Offset between vBB and uvBB
    const vigra::Diff2D uvBBOffset = uvBB.upperLeft() - vBB.upperLeft();

    vigra::Size2D mismatchImageSize;
    int mismatchImageStride;
    vigra::Diff2D uvBBStrideOffset;

    if (CoarseMask) {
        // Prepare to stride by two over uvBB to create cost image.
        // Push ul corner of vBB so that there is an even number of
        // pixels between vBB and uvBB.
        if (uvBBOffset.x % 2) {
            vBB.setUpperLeft(vBB.upperLeft() + vigra::Diff2D(-1, 0));
        }
        if (uvBBOffset.y % 2) {
            vBB.setUpperLeft(vBB.upperLeft() + vigra::Diff2D(0, -1));
        }
        uvBBStrideOffset = (uvBB.upperLeft() - vBB.upperLeft()) / 2;
        mismatchImageStride = 2;
        mismatchImageSize = (vBB.size() + vigra::Diff2D(1, 1)) / 2;
    } else {
        uvBBStrideOffset = uvBBOffset;
        mismatchImageStride = 1;
        mismatchImageSize = vBB.size();
    }

    typedef vigra::UInt8 MismatchImagePixelType;
    typedef vigra::BasicImage<MismatchImagePixelType> MismatchImageType;
    typedef vigra::BasicImage<vigra::RGBValue<MismatchImagePixelType> > VisualizeImageType;
    MismatchImageType mismatchImage(mismatchImageSize, vigra::NumericTraits<MismatchImagePixelType>::max());

    // Visualization of optimization output
    VisualizeImageType* visualizeImage = nullptr;
    if (VisualizeSeam) {
        visualizeImage = new VisualizeImageType(mismatchImageSize);
    }

    // mem usage after: Visualize && CoarseMask: iBB * UInt8
    //                  Visualize && !CoarseMask: 2 * iBB * UInt8
    //                  !Visualize && CoarseMask: 1/2 * iBB * UInt8
    //                  !Visualize && !CoarseMask: iBB * UInt8

    // Calculate mismatch image
    switch (PixelDifferenceFunctor)
    {
    case HueLuminanceMaxDifference:
        vigra::omp::combineTwoImages(vigra_ext::stride(mismatchImageStride, mismatchImageStride, vigra_ext::apply(uvBB, srcImageRange(*white))),
                                     vigra_ext::stride(mismatchImageStride, mismatchImageStride, vigra_ext::apply(uvBB, srcImage(*black))),
                                     vigra::destIter(mismatchImage.upperLeft() + uvBBStrideOffset),
                                     MaxHueLuminanceDifferenceFunctor<ImagePixelType, MismatchImagePixelType>
                                     (LuminanceDifferenceWeight, ChrominanceDifferenceWeight));
        break;
    case DeltaEDifference:
        vigra::omp::combineTwoImages(vigra_ext::stride(mismatchImageStride, mismatchImageStride, vigra_ext::apply(uvBB, srcImageRange(*white))),
                                     vigra_ext::stride(mismatchImageStride, mismatchImageStride, vigra_ext::apply(uvBB, srcImage(*black))),
                                     vigra::destIter(mismatchImage.upperLeft() + uvBBStrideOffset),
                                     DeltaEPixelDifferenceFunctor<ImagePixelType, MismatchImagePixelType>
                                     (LuminanceDifferenceWeight, ChrominanceDifferenceWeight));
        break;
    default:
        NEVER_REACHED("switch control expression \"PixelDifferenceFunctor\" out of range");
    }

    if (Verbose >= VERBOSE_DIFFERENCE_STATISTICS) {
        auto non_maximum(std::bind(std::not_equal_to<MismatchImagePixelType>(),
                                   std::placeholders::_1,
                                   vigra::NumericTraits<MismatchImagePixelType>::max()));
        enblend::FindAverageAndVarianceIf<MismatchImagePixelType, decltype(non_maximum)>
            statistics(non_maximum);
        const double range = static_cast<double>(vigra::NumericTraits<MismatchImagePixelType>::max() -
                                                 vigra::NumericTraits<MismatchImagePixelType>::min());

        vigra::inspectImage(srcImageRange(mismatchImage), statistics);
        std::cerr << command << ": info: difference statistics: overlap size = " <<
            std::count_if(mismatchImage.begin(), mismatchImage.end(), non_maximum) << " pixels\n" <<
            command << ": info: difference statistics: mismatch average = " <<
            statistics.average() / range << " [" <<
            stringOfPixelDifferenceFunctor(PixelDifferenceFunctor) << "]\n" <<
            command << ": info: difference statistics: standard deviation = " <<
            sqrt(statistics.variance()) / range << " [" <<
            stringOfPixelDifferenceFunctor(PixelDifferenceFunctor) << "]" << std::endl;
    }

    if (visualizeImage) {
        // Dump cost image into visualize image.
        vigra::omp::copyImage(srcImageRange(mismatchImage), destImage(*visualizeImage));

        // Color the parts of the visualize image where the two images
        // to be blended do not overlap.
        vigra::omp::combineThreeImages(vigra_ext::stride(mismatchImageStride, mismatchImageStride, vigra_ext::apply(uvBB, srcImageRange(*whiteAlpha))),
                                       vigra_ext::stride(mismatchImageStride, mismatchImageStride, vigra_ext::apply(uvBB, srcImage(*blackAlpha))),
                                       vigra::srcIter(visualizeImage->upperLeft() + uvBBStrideOffset),
                                       vigra::destIter(visualizeImage->upperLeft() + uvBBStrideOffset),
                                       ifThenElse(Arg1() & Arg2(),
                                                  Arg3(),
                                                  Param(VISUALIZE_NO_OVERLAP_VALUE)));

        const vigra::Diff2D offset = vigra::Diff2D(vBB.upperLeft()) - vigra::Diff2D(uBB.upperLeft());
        // Draw the initial seam line as a reference.
        for (ContourVector::const_iterator v = contours.begin(); v != contours.end(); ++v) {
            for (Contour::const_iterator c = (*v)->begin(); c != (*v)->end(); ++c) {
                for (Segment::const_iterator s = (*c)->begin(); s != (*c)->end(); ++s) {
                    Segment::const_iterator next = s;
                    ++next;
                    if (next != (*c)->end()) {
                        visualizeLine(*visualizeImage,
                                      (s->second - offset) / mismatchImageStride,
                                      (next->second - offset) / mismatchImageStride,
                                      VISUALIZE_INITIAL_PATH);
                    }
                    if (OptimizeMask)
                        visualizePoint(*visualizeImage,
                                   (s->second - offset) / mismatchImageStride,
                                   s->first ? VISUALIZE_MOVABLE_POINT : VISUALIZE_FROZEN_POINT,
                                   s->first ? MARK_MOVABLE_POINT : MARK_FROZEN_POINT,
                                   2);
                }
            }
        }
    }

    if (OptimizeMask && !parameter::as_boolean("skip-optimizer", false)) {
        // Move snake points to mismatchImage-relative coordinates
        if (parameter::as_boolean("adya-snake-points", false)) {
            for_each_vertex(contours.begin(), contours.end(),
                            [&](Segment::iterator vertex)
                            {
                                vertex->second =
                                    (vertex->second + uBB.upperLeft() - vBB.upperLeft()) / mismatchImageStride;
                            });
        } else {
            for_each_vertex(contours.begin(), contours.end(),
                            [&](Segment::iterator vertex)
                            {
                                const vigra::Point2D
                                    shifted(vertex->second + uBB.upperLeft() - vBB.upperLeft());
                                vertex->second =
                                    vigra::Point2D(round_to_nearest_div(shifted.px(), mismatchImageStride),
                                                   round_to_nearest_div(shifted.py(), mismatchImageStride));
                            });
        }

        std::unique_ptr<std::vector<double> > params(new std::vector<double>);
        std::unique_ptr<OptimizerChain<MismatchImagePixelType, MismatchImageType,
                                       VisualizeImageType, AlphaType> >
            defaultOptimizerChain(new OptimizerChain<MismatchImagePixelType, MismatchImageType,
                                                     VisualizeImageType, AlphaType>
                                  (&mismatchImage, visualizeImage,
                                   &mismatchImageSize, &mismatchImageStride,
                                   &uvBBStrideOffset, &contours, &uBB, &vBB, params.get(),
                                   whiteAlpha, blackAlpha, &uvBB));

        // Add Strategy 1: Use GDA to optimize placement of snake vertices
        defaultOptimizerChain->addOptimizer("anneal");

        // Add Strategy 2: Use Dijkstra shortest path algorithm between snake vertices
        defaultOptimizerChain->addOptimizer("dijkstra");

        // Fire optimizer chain (runs every optimizer on the list in sequence)
        if (!parameter::as_boolean("skip-optimizer-chain", false)) {
            defaultOptimizerChain->runOptimizerChain();
        }

        // Move snake vertices from mismatchImage-relative
        // coordinates to uBB-relative coordinates.
        for_each_vertex(contours.begin(), contours.end(),
                        [&](Segment::iterator vertex)
                        {vertex->second =
                                vertex->second * mismatchImageStride + vBB.upperLeft() - uBB.upperLeft();});
    }

    if (visualizeImage) {
        const std::string visualizeFilename =
            enblend::expandFilenameTemplate(VisualizeTemplate,
                                            numberOfImages,
                                            *inputFileNameIterator,
                                            OutputFileName,
                                            m);
        if (visualizeFilename == *inputFileNameIterator) {
            std::cerr << command <<
                ": will not overwrite input image \"" <<
                *inputFileNameIterator <<
                "\" with seam-visualization image" <<
                std::endl;
            exit(1);
        } else if (visualizeFilename == OutputFileName) {
            std::cerr << command <<
                ": will not overwrite output image \"" <<
                OutputFileName <<
                "\" with seam-visualization image" <<
                std::endl;
            exit(1);
        } else {
            if (Verbose >= VERBOSE_MASK_MESSAGES) {
                std::cerr << command <<
                    ": info: saving seam visualization \"" <<
                    visualizeFilename << "\"" << std::endl;
            }
            vigra::ImageExportInfo visualizeInfo(visualizeFilename.c_str());
            visualizeInfo.setCompression(MASK_COMPRESSION);
            vigra::exportImage(srcImageRange(*visualizeImage), visualizeInfo);
        }

        delete visualizeImage;
    }

    if (parameter::as_boolean("debug-seam-line", false)) {
        std::cout << "+ createMask: contours of final optimized mask\n";
        dump_contourvector(contours, "+ createMask: ");
    }

    // Fill contours to get final optimized mask.
    MaskType* mask = new MaskType(uBB.size());
    std::for_each(contours.begin(),
                  contours.end(),
                  [mask](const Contour* x) {fillContour<MaskType>(mask, *x, vigra::Diff2D(0, 0));});

    // Clean up contours
    std::for_each(contours.begin(),
                  contours.end(),
                  [](const Contour* x)
                  {
                      std::for_each(x->begin(),
                                    x->end(),
                                    [](Segment* y) {delete y;});
                  });

    std::for_each(contours.begin(), contours.end(), [](const Contour* x) {delete x;});

    return mask;
}
} // namespace enblend

#endif // MASK_H_INCLUDED_

// Local Variables:
// mode: c++
// End:
