// This file is part of libigl, a simple c++ geometry processing library. // // Copyright (C) 2013 Alec Jacobson // // 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 namespace igl { // Compute face normals via vertex position list, face list // Inputs: // V #V by 3 eigen Matrix of mesh vertex 3D positions // F #F by 3 eigen Matrix of face (triangle) indices // Z 3 vector normal given to faces with degenerate normal. // Output: // 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 IGL_INLINE void per_face_normals( const Eigen::MatrixBase& V, const Eigen::MatrixBase& F, const Eigen::MatrixBase & Z, Eigen::PlainObjectBase & N); // Wrapper with Z = (0,0,0). Note that this means that row norms will be zero // (i.e. not 1) for degenerate normals. template IGL_INLINE void per_face_normals( const Eigen::MatrixBase& V, const Eigen::MatrixBase& F, Eigen::PlainObjectBase & N); // Special version where order of face indices is guaranteed not to effect // output. template IGL_INLINE void per_face_normals_stable( const Eigen::MatrixBase& V, const Eigen::MatrixBase& F, Eigen::PlainObjectBase & N); // Inputs: // V #V by 3 list of mesh vertex positions // I #I vectorized list of polygon corner indices into rows of some matrix V // 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 // corner_threshold threshold in degrees on sharp angles // Outputs: // N #polygons by 3 list of per face normals // VV #I+#polygons by 3 list of auxiliary triangle mesh vertex positions // FF #I by 3 list of triangle indices into rows of VV // 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 & V, const Eigen::MatrixBase & I, const Eigen::MatrixBase & C, Eigen::PlainObjectBase & N, Eigen::PlainObjectBase & VV, Eigen::PlainObjectBase & FF, Eigen::PlainObjectBase & J); } #ifndef IGL_STATIC_LIBRARY # include "per_face_normals.cpp" #endif #endif