libigl/include/igl/extract_manifold_patches.h

// This file is part of libigl, a simple c++ geometry processing library.
//
// Copyright (C) 2016 Alec Jacobson <[email protected]>
//
// 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_EXTRACT_MANIFOLD_PATCHES
#define IGL_EXTRACT_MANIFOLD_PATCHES

#include "igl_inline.h"
#include <Eigen/Dense>
#include <vector>

namespace igl {
  /// Extract a set of maximal patches from a given mesh.
  /// A maximal patch is a subset of the input faces that are connected via
  /// manifold edges; a patch is as large as possible.
  ///
  /// @param[in] F  #F by 3 list representing triangles.
  /// @param[in] EMAP  #F*3 list of indices of unique undirected edges.
  /// @param[in] uEC  #uE+1 list of cumsums of directed edges sharing each unique edge
  /// @param[in] uEE  #F*3 list of indices into E (see `igl::unique_edge_map`)
  /// @param[out] P  #F list of patch incides.
  /// @return number of manifold patches.
  template <
    typename DerivedF,
    typename DerivedEMAP,
    typename DeriveduEC,
    typename DeriveduEE,
    typename DerivedP>
  IGL_INLINE size_t extract_manifold_patches(
    const Eigen::MatrixBase<DerivedF>& F,
    const Eigen::MatrixBase<DerivedEMAP>& EMAP,
    const Eigen::MatrixBase<DeriveduEC>& uEC,
    const Eigen::MatrixBase<DeriveduEE>& uEE,
    Eigen::PlainObjectBase<DerivedP>& P);
  /// \overload
  /// @param[in]  uE2E  #uE list of lists of indices into E of coexisting edges.
  template <
    typename DerivedF,
    typename DerivedEMAP,
    typename uE2EType,
    typename DerivedP>
  IGL_INLINE size_t extract_manifold_patches(
    const Eigen::MatrixBase<DerivedF>& F,
    const Eigen::MatrixBase<DerivedEMAP>& EMAP,
    const std::vector<std::vector<uE2EType> >& uE2E,
    Eigen::PlainObjectBase<DerivedP>& P);
  /// \overload
  template <
      typename DerivedF,
      typename DerivedP>
  IGL_INLINE size_t extract_manifold_patches(
      const Eigen::MatrixBase<DerivedF> &F,
      Eigen::PlainObjectBase<DerivedP> &P);
}
#ifndef IGL_STATIC_LIBRARY
#  include "extract_manifold_patches.cpp"
#endif

#endif