libigl/include/igl/embree/ambient_occlusion.h

// This file is part of libigl, a simple c++ geometry processing library.
// 
// Copyright (C) 2013 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_EMBREE_AMBIENT_OCCLUSION_H
#define IGL_EMBREE_AMBIENT_OCCLUSION_H
#include "../igl_inline.h"
#include <Eigen/Core>
namespace igl
{
  namespace embree
  {
    /// Compute ambient occlusion per given point
    ///
    /// @param[in] V  #V by 3 list of mesh vertex positiosn
    /// @param[in] F  #F by 3 list of mesh triangle indices into rows of V
    /// @param[in] P  #P by 3 list of origin points
    /// @param[in] N  #P by 3 list of origin normals
    /// @param[out] S  #P list of ambient occlusion values between 1 (fully occluded) and
    ///      0 (not occluded)
    template <
      typename DerivedV,
      typename DerivedF,
      typename DerivedP,
      typename DerivedN,
      typename DerivedS >
    IGL_INLINE void ambient_occlusion(
      const Eigen::MatrixBase<DerivedV> & V,
      const Eigen::MatrixBase<DerivedF> & F,
      const Eigen::MatrixBase<DerivedP> & P,
      const Eigen::MatrixBase<DerivedN> & N,
      const int num_samples,
      Eigen::PlainObjectBase<DerivedS> & S);
    /// \overload 
    /// \brief Wrapper which builds new EmbreeIntersector for (V,F). That's expensive so
    /// avoid this if repeatedly calling.
    ///
    /// @param[in] ei  EmbreeIntersector containing (V,F)
    ///
    // Forward define
    class EmbreeIntersector;
    template <
      typename DerivedP,
      typename DerivedN,
      typename DerivedS >
    IGL_INLINE void ambient_occlusion(
      const EmbreeIntersector & ei,
      const Eigen::MatrixBase<DerivedP> & P,
      const Eigen::MatrixBase<DerivedN> & N,
      const int num_samples,
      Eigen::PlainObjectBase<DerivedS> & S);
  }
};
#ifndef IGL_STATIC_LIBRARY
#  include "ambient_occlusion.cpp"
#endif

#endif