You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
79 lines
3.3 KiB
79 lines
3.3 KiB
// This file is part of libigl, a simple c++ geometry processing library.
|
|
//
|
|
// Copyright (C) 2013 Alec Jacobson <alecjacobson@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_PER_FACE_NORMALS_H
|
|
#define IGL_PER_FACE_NORMALS_H
|
|
#include "igl_inline.h"
|
|
#include <Eigen/Core>
|
|
namespace igl
|
|
{
|
|
/// Compute face normals via vertex position list, face list
|
|
///
|
|
/// @param[in] V #V by 3 eigen Matrix of mesh vertex 3D positions
|
|
/// @param[in] F #F by 3 eigen Matrix of face (triangle) indices
|
|
/// @param[in] Z 3 vector normal given to faces with degenerate normal.
|
|
/// @param[out] N #F by 3 eigen Matrix of mesh face (triangle) 3D normals
|
|
///
|
|
/// #### Example
|
|
/// // Give degenerate faces (1/3,1/3,1/3)^0.5
|
|
/// per_face_normals(V,F,Vector3d(1,1,1).normalized(),N);
|
|
template <typename DerivedV, typename DerivedF, typename DerivedZ, typename DerivedN>
|
|
IGL_INLINE void per_face_normals(
|
|
const Eigen::MatrixBase<DerivedV>& V,
|
|
const Eigen::MatrixBase<DerivedF>& F,
|
|
const Eigen::MatrixBase<DerivedZ> & Z,
|
|
Eigen::PlainObjectBase<DerivedN> & N);
|
|
/// \overload
|
|
/// \brief Wrapper with Z = (0,0,0). Note that this means that row norms will be zero
|
|
/// (i.e. not 1) for degenerate normals.
|
|
template <typename DerivedV, typename DerivedF, typename DerivedN>
|
|
IGL_INLINE void per_face_normals(
|
|
const Eigen::MatrixBase<DerivedV>& V,
|
|
const Eigen::MatrixBase<DerivedF>& F,
|
|
Eigen::PlainObjectBase<DerivedN> & N);
|
|
/// \overload
|
|
/// \brief Special version where order of face indices is guaranteed not to effect
|
|
/// output.
|
|
template <typename DerivedV, typename DerivedF, typename DerivedN>
|
|
IGL_INLINE void per_face_normals_stable(
|
|
const Eigen::MatrixBase<DerivedV>& V,
|
|
const Eigen::MatrixBase<DerivedF>& F,
|
|
Eigen::PlainObjectBase<DerivedN> & N);
|
|
/// Per face normals for a general polygon mesh
|
|
/// @param[in] V #V by 3 list of mesh vertex positions
|
|
/// @param[in] I #I vectorized list of polygon corner indices into rows of some matrix V
|
|
/// @param[in] C #polygons+1 list of cumulative polygon sizes so that C(i+1)-C(i) = size of
|
|
/// the ith polygon, and so I(C(i)) through I(C(i+1)-1) are the indices of
|
|
/// the ith polygon
|
|
/// @param[in] corner_threshold threshold in degrees on sharp angles
|
|
/// @param[out] N #polygons by 3 list of per face normals
|
|
/// @param[out] VV #I+#polygons by 3 list of auxiliary triangle mesh vertex positions
|
|
/// @param[out] FF #I by 3 list of triangle indices into rows of VV
|
|
/// @param[out] J #I list of indices into original polygons
|
|
template <
|
|
typename DerivedV,
|
|
typename DerivedI,
|
|
typename DerivedC,
|
|
typename DerivedN,
|
|
typename DerivedVV,
|
|
typename DerivedFF,
|
|
typename DerivedJ>
|
|
IGL_INLINE void per_face_normals(
|
|
const Eigen::MatrixBase<DerivedV> & V,
|
|
const Eigen::MatrixBase<DerivedI> & I,
|
|
const Eigen::MatrixBase<DerivedC> & C,
|
|
Eigen::PlainObjectBase<DerivedN> & N,
|
|
Eigen::PlainObjectBase<DerivedVV> & VV,
|
|
Eigen::PlainObjectBase<DerivedFF> & FF,
|
|
Eigen::PlainObjectBase<DerivedJ> & J);
|
|
}
|
|
|
|
#ifndef IGL_STATIC_LIBRARY
|
|
# include "per_face_normals.cpp"
|
|
#endif
|
|
|
|
#endif
|
|
|