Loading...
Searching...
No Matches
ModNormalDeviationT.hh
Go to the documentation of this file.
/* ========================================================================= *
* *
* OpenMesh *
* Copyright (c) 2001-2025, RWTH-Aachen University *
* Department of Computer Graphics and Multimedia *
* All rights reserved. *
* www.openmesh.org *
* *
*---------------------------------------------------------------------------*
* This file is part of OpenMesh. *
*---------------------------------------------------------------------------*
* *
* Redistribution and use in source and binary forms, with or without *
* modification, are permitted provided that the following conditions *
* are met: *
* *
* 1. Redistributions of source code must retain the above copyright notice, *
* this list of conditions and the following disclaimer. *
* *
* 2. Redistributions in binary form must reproduce the above copyright *
* notice, this list of conditions and the following disclaimer in the *
* documentation and/or other materials provided with the distribution. *
* *
* 3. Neither the name of the copyright holder nor the names of its *
* contributors may be used to endorse or promote products derived from *
* this software without specific prior written permission. *
* *
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS *
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED *
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A *
* PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER *
* OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, *
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, *
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR *
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF *
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING *
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS *
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. *
* *
* ========================================================================= */
//=============================================================================
//
// CLASS ModNormalDeviationT
//
//=============================================================================
#ifndef OPENMESH_DECIMATER_MODNORMALDEVIATIONT_HH
#define OPENMESH_DECIMATER_MODNORMALDEVIATIONT_HH
//== INCLUDES =================================================================
#include <OpenMesh/Tools/Decimater/ModBaseT.hh>
#include <OpenMesh/Core/Utils/Property.hh>
#include <OpenMesh/Core/Geometry/NormalConeT.hh>
//== NAMESPACES ===============================================================
namespace OpenMesh {
namespace Decimater {
//== CLASS DEFINITION =========================================================
template <class MeshT>
class ModNormalDeviationT : public ModBaseT< MeshT >
{
public:
DECIMATING_MODULE( ModNormalDeviationT, MeshT, NormalDeviation );
typedef typename Mesh::Scalar Scalar;
typedef typename Mesh::Point Point;
typedef typename Mesh::Normal Normal;
typedef typename Mesh::VertexHandle VertexHandle;
typedef typename Mesh::FaceHandle FaceHandle;
typedef typename Mesh::EdgeHandle EdgeHandle;
typedef NormalConeT<Normal> NormalCone;
public:
explicit ModNormalDeviationT(MeshT& _mesh, float _max_dev = 180.0)
: Base(_mesh, true), mesh_(Base::mesh())
{
set_normal_deviation(_max_dev);
mesh_.add_property(normal_cones_);
const bool mesh_has_normals = _mesh.has_face_normals();
_mesh.request_face_normals();
if (!mesh_has_normals)
{
omerr() << "Mesh has no face normals. Compute them automatically." << std::endl;
_mesh.update_face_normals();
}
}
~ModNormalDeviationT() {
mesh_.remove_property(normal_cones_);
mesh_.release_face_normals();
}
Scalar normal_deviation() const {
return normal_deviation_ / M_PI * 180.0;
}
void set_normal_deviation(Scalar _s) {
normal_deviation_ = _s / static_cast<Scalar>(180.0) * static_cast<Scalar>(M_PI);
}
void initialize() override {
if (!normal_cones_.is_valid())
mesh_.add_property(normal_cones_);
typename Mesh::FaceIter f_it = mesh_.faces_begin(),
f_end = mesh_.faces_end();
for (; f_it != f_end; ++f_it)
mesh_.property(normal_cones_, *f_it) = NormalCone(mesh_.normal(*f_it));
}
float collapse_priority(const CollapseInfo& _ci) override {
// simulate collapse
mesh_.set_point(_ci.v0, _ci.p1);
typename Mesh::Scalar max_angle(0.0);
typename Mesh::ConstVertexFaceIter vf_it(mesh_, _ci.v0);
typename Mesh::FaceHandle fh, fhl, fhr;
if (_ci.v0vl.is_valid()) fhl = mesh_.face_handle(_ci.v0vl);
if (_ci.vrv0.is_valid()) fhr = mesh_.face_handle(_ci.vrv0);
for (; vf_it.is_valid(); ++vf_it) {
fh = *vf_it;
if (fh != _ci.fl && fh != _ci.fr) {
NormalCone nc = mesh_.property(normal_cones_, fh);
nc.merge(NormalCone(mesh_.calc_face_normal(fh)));
if (fh == fhl) nc.merge(mesh_.property(normal_cones_, _ci.fl));
if (fh == fhr) nc.merge(mesh_.property(normal_cones_, _ci.fr));
if (nc.angle() > max_angle) {
max_angle = nc.angle();
if (max_angle > 0.5 * normal_deviation_)
break;
}
}
}
// undo simulation changes
mesh_.set_point(_ci.v0, _ci.p0);
return (max_angle < 0.5 * normal_deviation_ ? max_angle : float( Base::ILLEGAL_COLLAPSE ));
}
void set_error_tolerance_factor(double _factor) override {
if (_factor >= 0.0 && _factor <= 1.0) {
// the smaller the factor, the smaller normal_deviation_ gets
// thus creating a stricter constraint
// division by error_tolerance_factor_ is for normalization
Scalar normal_deviation_value = normal_deviation_ * static_cast<Scalar>( 180.0 / M_PI * _factor / this->error_tolerance_factor_);
set_normal_deviation(normal_deviation_value);
this->error_tolerance_factor_ = _factor;
}
}
void postprocess_collapse(const CollapseInfo& _ci) override {
// account for changed normals
typename Mesh::VertexFaceIter vf_it(mesh_, _ci.v1);
for (; vf_it.is_valid(); ++vf_it)
mesh_.property(normal_cones_, *vf_it).
merge(NormalCone(mesh_.normal(*vf_it)));
// normal cones of deleted triangles
typename Mesh::FaceHandle fh;
if (_ci.vlv1.is_valid()) {
fh = mesh_.face_handle(mesh_.opposite_halfedge_handle(_ci.vlv1));
if (fh.is_valid())
mesh_.property(normal_cones_, fh).
merge(mesh_.property(normal_cones_, _ci.fl));
}
if (_ci.v1vr.is_valid()) {
fh = mesh_.face_handle(mesh_.opposite_halfedge_handle(_ci.v1vr));
if (fh.is_valid())
mesh_.property(normal_cones_, fh).
merge(mesh_.property(normal_cones_, _ci.fr));
}
}
private:
Mesh& mesh_;
Scalar normal_deviation_;
OpenMesh::FPropHandleT<NormalCone> normal_cones_;
};
//=============================================================================
} // END_NS_DECIMATER
} // END_NS_OPENMESH
//=============================================================================
#endif // OPENMESH_DECIMATER_MODNORMALDEVIATIONT_HH defined
//=============================================================================
ModBaseT.hh
Base class for all decimation modules.
DECIMATING_MODULE
#define DECIMATING_MODULE(Classname, MeshT, Name)
Convenience macro, to be used in derived modules The macro defines the types.
Definition ModBaseT.hh:149
OpenMesh
Contains all the mesh ingredients like the polygonal mesh, the triangle mesh, different mesh kernels ...
Definition MeshItems.hh:59
OpenMesh::NormalConeT
/class NormalCone NormalCone.hh <OpenMesh/Core/Geometry/NormalConeT.hh>
Definition NormalConeT.hh:78
OpenMesh::NormalConeT::merge
void merge(const NormalConeT &)
merge _cone; this instance will then enclose both former cones
Definition NormalConeT_impl.hh:118
OpenMesh::NormalConeT::angle
Scalar angle() const
returns size of cone (radius in radians)
Definition NormalConeT.hh:105
OpenMesh::PolyMeshT::VertexHandle
Kernel::VertexHandle VertexHandle
Handle for referencing the corresponding item.
Definition PolyMeshT.hh:136
OpenMesh::PolyMeshT::Scalar
Kernel::Scalar Scalar
Scalar type.
Definition PolyMeshT.hh:110
OpenMesh::PolyMeshT::EdgeHandle
Kernel::EdgeHandle EdgeHandle
Scalar type.
Definition PolyMeshT.hh:138
OpenMesh::PolyMeshT::VertexFaceIter
Kernel::VertexFaceIter VertexFaceIter
Circulator.
Definition PolyMeshT.hh:166
OpenMesh::PolyMeshT::FaceIter
Kernel::FaceIter FaceIter
Scalar type.
Definition PolyMeshT.hh:146
OpenMesh::PolyMeshT::Normal
Kernel::Normal Normal
Normal type.
Definition PolyMeshT.hh:114
OpenMesh::PolyMeshT::ConstVertexFaceIter
Kernel::ConstVertexFaceIter ConstVertexFaceIter
Circulator.
Definition PolyMeshT.hh:176
OpenMesh::PolyMeshT::FaceHandle
Kernel::FaceHandle FaceHandle
Scalar type.
Definition PolyMeshT.hh:139
OpenMesh::PolyMeshT::Point
Kernel::Point Point
Coordinate type.
Definition PolyMeshT.hh:112
OpenMesh::FPropHandleT
Handle representing a face property.
Definition Property.hh:462
OpenMesh::Decimater::ModBaseT
Base class for all decimation modules.
Definition ModBaseT.hh:193
OpenMesh::Decimater::ModBaseT::mesh
MeshT & mesh()
Access the mesh associated with the decimater.
Definition ModBaseT.hh:277
OpenMesh::Decimater::ModNormalDeviationT
Use Normal deviation to control decimation.
Definition ModNormalDeviationT.hh:89
OpenMesh::Decimater::ModNormalDeviationT::set_normal_deviation
void set_normal_deviation(Scalar _s)
Set normal deviation ( 0 .. 360 )
Definition ModNormalDeviationT.hh:137
OpenMesh::Decimater::ModNormalDeviationT::normal_deviation
Scalar normal_deviation() const
Get normal deviation ( 0 .. 360 )
Definition ModNormalDeviationT.hh:132
OpenMesh::Decimater::ModNormalDeviationT::set_error_tolerance_factor
void set_error_tolerance_factor(double _factor) override
set the percentage of normal deviation
Definition ModNormalDeviationT.hh:206
OpenMesh::Decimater::ModNormalDeviationT::initialize
void initialize() override
Allocate and init normal cones.
Definition ModNormalDeviationT.hh:143
OpenMesh::Decimater::ModNormalDeviationT::~ModNormalDeviationT
~ModNormalDeviationT()
Destructor.
Definition ModNormalDeviationT.hh:125
OpenMesh::Decimater::ModNormalDeviationT::ModNormalDeviationT
ModNormalDeviationT(MeshT &_mesh, float _max_dev=180.0)
Constructor.
Definition ModNormalDeviationT.hh:107
OpenMesh::Decimater::ModNormalDeviationT::collapse_priority
float collapse_priority(const CollapseInfo &_ci) override
Control normals when Decimating.
Definition ModNormalDeviationT.hh:168