libigl_Martin/include/igl/cgal/propagate_winding_numbers.h

// This file is part of libigl, a simple c++ geometry processing library.
// 
// Copyright (C) 2015 Qingnan Zhou <qnzhou@gmail.com>
// 
// This Source Code Form is subject to the terms of the Mozilla Public License 
// v. 2.0. If a copy of the MPL was not distributed with this file, You can 
// obtain one at http://mozilla.org/MPL/2.0/.
//
#ifndef IGL_CGAL_PROPAGATE_WINDING_NUMBERS_H
#define IGL_CGAL_PROPAGATE_WINDING_NUMBERS_H
#include "../igl_inline.h"
#include <Eigen/Core>
#include <vector>

// The following methods compute the winding number on each side of each facet
// or patch of a 3D mesh.  The input mesh is valid if it splits the ambient
// space, R^3, into subspaces with constant integer winding numbers.  That is
// the input mesh should be closed and for each directed edge the number of
// clockwise facing facets should equal the number of counterclockwise facing
// facets.

namespace igl {
    namespace cgal {

        // Compute winding number on each side of the face.  The input mesh
        // could contain multiple connected components.  The input mesh must
        // represent the boundary of a valid 3D volume, which means it is
        // closed, consistently oriented and induces integer winding numbers.
        //
        // Inputs:
        //   V  #V by 3 list of vertex positions.
        //   F  #F by 3 list of triangle indices into V.
        //   labels  #F list of facet labels ranging from 0 to k-1.
        //
        // Output:
        //   W  #F by k*2 list of winding numbers.  ``W(i,j*2)`` is the winding
        //      number on the positive side of facet ``i`` with respect to the
        //      facets labeled ``j``.  Similarly, ``W(i,j*2+1)`` is the winding
        //      number on the negative side of facet ``i`` with respect to the
        //      facets labeled ``j``.
        template<
            typename DerivedV,
            typename DerivedF,
            typename DerivedL,
            typename DerivedW>
        IGL_INLINE void propagate_winding_numbers(
                const Eigen::PlainObjectBase<DerivedV>& V,
                const Eigen::PlainObjectBase<DerivedF>& F,
                const Eigen::PlainObjectBase<DerivedL>& labels,
                Eigen::PlainObjectBase<DerivedW>& W);
    }
}

#ifndef IGL_STATIC_LIBRARY
#  include "propagate_winding_numbers.cpp"
#endif
#endif