3996aade01
git-svn-id: http://www.openmesh.org/svnrepo/OpenMesh/trunk@83 fdac6126-5c0c-442c-9429-916003d36597
267 lines
8.4 KiB
C++
267 lines
8.4 KiB
C++
//=============================================================================
|
|
//
|
|
// OpenMesh
|
|
// Copyright (C) 2003 by Computer Graphics Group, RWTH Aachen
|
|
// www.openmesh.org
|
|
//
|
|
//-----------------------------------------------------------------------------
|
|
//
|
|
// License
|
|
//
|
|
// This library is free software; you can redistribute it and/or modify it
|
|
// under the terms of the GNU Lesser General Public License as published
|
|
// by the Free Software Foundation, version 2.1.
|
|
//
|
|
// This library is distributed in the hope that it will be useful, but
|
|
// WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
// Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public
|
|
// License along with this library; if not, write to the Free Software
|
|
// Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
//
|
|
//-----------------------------------------------------------------------------
|
|
//
|
|
// $Revision$
|
|
// $Date$
|
|
//
|
|
//=============================================================================
|
|
|
|
/** \file ModBaseT.hh
|
|
Base class for all decimation modules.
|
|
*/
|
|
|
|
//=============================================================================
|
|
//
|
|
// CLASS ModBaseT
|
|
//
|
|
//=============================================================================
|
|
|
|
#ifndef OPENMESH_DECIMATER_MODBASET_HH
|
|
#define OPENMESH_DECIMATER_MODBASET_HH
|
|
|
|
|
|
//== INCLUDES =================================================================
|
|
|
|
#include <OpenMesh/Core/Utils/Noncopyable.hh>
|
|
#include <OpenMesh/Tools/Decimater/CollapseInfoT.hh>
|
|
#include <string>
|
|
|
|
|
|
//== NAMESPACE ================================================================
|
|
|
|
namespace OpenMesh {
|
|
namespace Decimater {
|
|
|
|
|
|
//== FORWARD DECLARATIONS =====================================================
|
|
|
|
template <typename Mesh> class DecimaterT;
|
|
|
|
|
|
//== CLASS DEFINITION =========================================================
|
|
|
|
/** Handle for mesh decimation modules
|
|
\internal
|
|
*/
|
|
template <typename Module>
|
|
class ModHandleT : private Utils::Noncopyable
|
|
{
|
|
public:
|
|
|
|
typedef ModHandleT<Module> Self;
|
|
typedef Module module_type;
|
|
|
|
public:
|
|
|
|
/// Default constructor
|
|
ModHandleT() : mod_(NULL) {}
|
|
|
|
/// Destructor
|
|
~ModHandleT() { /* don't delete mod_, since handle is not owner! */ }
|
|
|
|
/// Check handle status
|
|
/// \return \c true, if handle is valid, else \c false.
|
|
bool is_valid() const { return mod_ != NULL; }
|
|
|
|
private:
|
|
|
|
#if defined(OM_CC_MSVC)
|
|
friend class DecimaterT;
|
|
#else
|
|
template <typename Mesh> friend class DecimaterT;
|
|
#endif
|
|
|
|
void clear() { mod_ = NULL; }
|
|
void init(Module* _m) { mod_ = _m; }
|
|
Module* module() { return mod_; }
|
|
|
|
|
|
private:
|
|
|
|
Module* mod_;
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
//== CLASS DEFINITION =========================================================
|
|
|
|
|
|
|
|
/// Macro that sets up the name() function
|
|
/// \internal
|
|
#define DECIMATER_MODNAME(_mod_name) \
|
|
virtual const std::string& name() const { \
|
|
static std::string _s_modname_(#_mod_name); return _s_modname_; \
|
|
}
|
|
|
|
|
|
/** Convenience macro, to be used in derived modules
|
|
* The macro defines the types
|
|
* - \c Handle, type of the module's handle.
|
|
* - \c Base, type of ModBaseT<>.
|
|
* - \c Mesh, type of the associated mesh passed by the decimater type.
|
|
* - \c CollapseInfo, to your convenience
|
|
* and uses DECIMATER_MODNAME() to define the name of the module.
|
|
*
|
|
* \param Classname The name of the derived class.
|
|
* \param DecimaterT Pass here the decimater type, which is the
|
|
* template parameter passed to ModBaseT.
|
|
* \param Name Give the module a name.
|
|
*/
|
|
#define DECIMATING_MODULE(Classname, DecimaterT, Name) \
|
|
typedef Classname < DecimaterT > Self; \
|
|
typedef OpenMesh::Decimater::ModHandleT< Self > Handle; \
|
|
typedef OpenMesh::Decimater::ModBaseT< DecimaterT > Base; \
|
|
typedef typename Base::Mesh Mesh; \
|
|
typedef typename Base::CollapseInfo CollapseInfo; \
|
|
DECIMATER_MODNAME( Name )
|
|
|
|
|
|
|
|
//== CLASS DEFINITION =========================================================
|
|
|
|
|
|
/** Base class for all decimation modules.
|
|
|
|
Each module has to implement this interface.
|
|
To build your own module you have to
|
|
-# derive from this class.
|
|
-# create the basic settings with DECIMATING_MODULE().
|
|
-# override collapse_priority(), if necessary.
|
|
-# override initialize(), if necessary.
|
|
-# override postprocess_collapse(), if necessary.
|
|
|
|
A module has two major working modes:
|
|
-# binary mode
|
|
-# non-binary mode
|
|
|
|
In the binary mode collapse_priority() checks a constraint and
|
|
returns LEGAL_COLLAPSE or ILLEGAL_COLLAPSE.
|
|
|
|
In the non-binary mode the module computes a float error value in
|
|
the range [0, inf) and returns it. In the case a constraint has
|
|
been set, e.g. the error must be lower than a upper bound, and the
|
|
constraint is violated, collapse_priority() must return
|
|
ILLEGAL_COLLAPSE.
|
|
|
|
\see collapse_priority()
|
|
|
|
\todo "Tutorial on building a custom decimation module."
|
|
|
|
*/
|
|
template <typename DecimaterType>
|
|
class ModBaseT
|
|
{
|
|
public:
|
|
|
|
typedef typename DecimaterType::Mesh Mesh;
|
|
typedef CollapseInfoT<Mesh> CollapseInfo;
|
|
|
|
enum {
|
|
ILLEGAL_COLLAPSE = -1, ///< indicates an illegal collapse
|
|
LEGAL_COLLAPSE = 0 ///< indicates a legal collapse
|
|
};
|
|
|
|
protected:
|
|
|
|
/// Default constructor
|
|
/// \see \ref decimater_docu
|
|
ModBaseT(DecimaterType& _dec, bool _is_binary)
|
|
: dec_(_dec), is_binary_(_is_binary) {}
|
|
|
|
public:
|
|
|
|
/// Virtual desctructor
|
|
virtual ~ModBaseT() { }
|
|
|
|
/// Set module's name (using DECIMATER_MODNAME macro)
|
|
DECIMATER_MODNAME(ModBase);
|
|
|
|
|
|
/// Returns true if criteria returns a binary value.
|
|
bool is_binary(void) const { return is_binary_; }
|
|
|
|
/// Set whether module is binary or not.
|
|
void set_binary(bool _b) { is_binary_ = _b; }
|
|
|
|
|
|
public: // common interface
|
|
|
|
/// Initialize module-internal stuff
|
|
virtual void initialize() { }
|
|
|
|
/** Return collapse priority.
|
|
*
|
|
* In the binary mode collapse_priority() checks a constraint and
|
|
* returns LEGAL_COLLAPSE or ILLEGAL_COLLAPSE.
|
|
*
|
|
* In the non-binary mode the module computes a float error value in
|
|
* the range [0, inf) and returns it. In the case a constraint has
|
|
* been set, e.g. the error must be lower than a upper bound, and the
|
|
* constraint is violated, collapse_priority() must return
|
|
* ILLEGAL_COLLAPSE.
|
|
*
|
|
* \return Collapse priority in the range [0,inf),
|
|
* \c LEGAL_COLLAPSE or \c ILLEGAL_COLLAPSE.
|
|
*/
|
|
virtual float collapse_priority(const CollapseInfoT<Mesh>& /* _ci */)
|
|
{ return LEGAL_COLLAPSE; }
|
|
|
|
/** After _from_vh has been collapsed into _to_vh, this method
|
|
will be called.
|
|
*/
|
|
virtual void postprocess_collapse(const CollapseInfoT<Mesh>& /* _ci */)
|
|
{}
|
|
|
|
|
|
|
|
protected:
|
|
|
|
/// Access the mesh associated with the decimater.
|
|
Mesh& mesh() { return dec_.mesh(); }
|
|
|
|
private:
|
|
|
|
// hide copy constructor & assignemnt
|
|
ModBaseT(const ModBaseT& _cpy);
|
|
ModBaseT& operator=(const ModBaseT& );
|
|
|
|
// reference to decimater
|
|
DecimaterType &dec_;
|
|
|
|
bool is_binary_;
|
|
};
|
|
|
|
|
|
//=============================================================================
|
|
} // namespace Decimater
|
|
} // namespace OpenMesh
|
|
//=============================================================================
|
|
#endif // OPENMESH_DECIMATER_MODBASE_HH defined
|
|
//=============================================================================
|
|
|