DecimaterT.hh 8.63 KB
 Jan Möbius committed Apr 28, 2015 1 /* ========================================================================= *  Jan Möbius committed Jun 04, 2009 2 3  * * * OpenMesh *  Jan Möbius committed Apr 28, 2015 4  * Copyright (c) 2001-2015, RWTH-Aachen University *  Jan Möbius committed Apr 28, 2015 5  * Department of Computer Graphics and Multimedia *  Jan Möbius committed Apr 28, 2015 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38  * 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. *  Jan Möbius committed Apr 28, 2015 39 40  * * * ========================================================================= */  Jan Möbius committed Jun 04, 2009 41   Jan Möbius committed Jan 15, 2019 42   Jan Möbius committed Feb 06, 2009 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62  /** \file DecimaterT.hh */ //============================================================================= // // CLASS DecimaterT // //============================================================================= #ifndef OPENMESH_DECIMATER_DECIMATERT_HH #define OPENMESH_DECIMATER_DECIMATERT_HH //== INCLUDES ================================================================= #include #include #include  Matthias Möller committed Aug 08, 2012 63 #include  Jan Möbius committed Feb 06, 2009 64 65 66 67 68 69 70 71 72 73 74 75 76 77  //== NAMESPACE ================================================================ namespace OpenMesh { namespace Decimater { //== CLASS DEFINITION ========================================================= /** Decimater framework. \see BaseModT, \ref decimater_docu */ template < typename MeshT >  Matthias Möller committed Aug 22, 2012 78 class DecimaterT : virtual public BaseDecimaterT //virtual especially for the mixed decimater  Jan Möbius committed Feb 06, 2009 79 80 81 { public: //-------------------------------------------------------- public types  Matthias Möller committed Aug 08, 2012 82 83 84 85 86  typedef DecimaterT< MeshT > Self; typedef MeshT Mesh; typedef CollapseInfoT CollapseInfo; typedef ModBaseT Module; typedef std::vector< Module* > ModuleList;  Jan Möbius committed May 20, 2009 87  typedef typename ModuleList::iterator ModuleListIterator;  Jan Möbius committed Feb 06, 2009 88 89 90 91 92 93 94 95 96 97 98  public: //------------------------------------------------------ public methods /// Constructor DecimaterT( Mesh& _mesh ); /// Destructor ~DecimaterT(); public:  Janis Born committed Jul 22, 2016 99 100 101 102 103 104 105 106 107  /** * @brief Perform a number of collapses on the mesh. * @param _n_collapses Desired number of collapses. If zero (default), attempt * to do as many collapses as possible. * @return Number of collapses that were actually performed. * @note This operation only marks the removed mesh elements for deletion. In * order to actually remove the decimated elements from the mesh, a * subsequent call to ArrayKernel::garbage_collection() is required. */  Jan Möbius committed Feb 06, 2009 108 109  size_t decimate( size_t _n_collapses = 0 );  Janis Born committed Jul 22, 2016 110 111 112 113 114 115 116 117 118  /** * @brief Decimate the mesh to a desired target vertex complexity. * @param _n_vertices Target complexity, i.e. desired number of remaining * vertices after decimation. * @return Number of collapses that were actually performed. * @note This operation only marks the removed mesh elements for deletion. In * order to actually remove the decimated elements from the mesh, a * subsequent call to ArrayKernel::garbage_collection() is required. */  Jan Möbius committed Feb 06, 2009 119 120  size_t decimate_to( size_t _n_vertices ) {  Matthias Möller committed Aug 08, 2012 121 122  return ( (_n_vertices < this->mesh().n_vertices()) ? decimate( this->mesh().n_vertices() - _n_vertices ) : 0 );  Jan Möbius committed Feb 06, 2009 123 124  }  Janis Born committed Jul 22, 2016 125 126 127 128 129 130 131 132 133 134 135  /** * @brief Attempts to decimate the mesh until a desired vertex or face * complexity is achieved. * @param _n_vertices Target vertex complexity. * @param _n_faces Target face complexity. * @return Number of collapses that were actually performed. * @note Decimation stops as soon as either one of the two complexity bounds * is satisfied. * @note This operation only marks the removed mesh elements for deletion. In * order to actually remove the decimated elements from the mesh, a * subsequent call to ArrayKernel::garbage_collection() is required.  Jan Möbius committed Nov 04, 2011 136 137  */ size_t decimate_to_faces( size_t _n_vertices=0, size_t _n_faces=0 );  Jan Möbius committed Feb 06, 2009 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192  public: typedef typename Mesh::VertexHandle VertexHandle; typedef typename Mesh::HalfedgeHandle HalfedgeHandle; /// Heap interface class HeapInterface { public: HeapInterface(Mesh& _mesh, VPropHandleT _prio, VPropHandleT _pos) : mesh_(_mesh), prio_(_prio), pos_(_pos) { } inline bool less( VertexHandle _vh0, VertexHandle _vh1 ) { return mesh_.property(prio_, _vh0) < mesh_.property(prio_, _vh1); } inline bool greater( VertexHandle _vh0, VertexHandle _vh1 ) { return mesh_.property(prio_, _vh0) > mesh_.property(prio_, _vh1); } inline int get_heap_position(VertexHandle _vh) { return mesh_.property(pos_, _vh); } inline void set_heap_position(VertexHandle _vh, int _pos) { mesh_.property(pos_, _vh) = _pos; } private: Mesh& mesh_; VPropHandleT prio_; VPropHandleT pos_; }; typedef Utils::HeapT DeciHeap; private: //---------------------------------------------------- private methods /// Insert vertex in heap void heap_vertex(VertexHandle _vh); private: //------------------------------------------------------- private data // reference to mesh Mesh& mesh_; // heap  Max Lyon committed Apr 25, 2017 193  #if (defined(_MSC_VER) && (_MSC_VER >= 1800)) || __cplusplus > 199711L || defined( __GXX_EXPERIMENTAL_CXX0X__ )  Jan Möbius committed Jan 26, 2015 194 195 196 197  std::unique_ptr heap_; #else std::auto_ptr heap_; #endif  Jan Möbius committed Feb 06, 2009 198 199 200 201 202 203 204 205 206 207 208 209 210 211  // vertex properties VPropHandleT collapse_target_; VPropHandleT priority_; VPropHandleT heap_position_; }; //============================================================================= } // END_NS_DECIMATER } // END_NS_OPENMESH //============================================================================= #if defined(OM_INCLUDE_TEMPLATES) && !defined(OPENMESH_DECIMATER_DECIMATERT_CC) #define OPENMESH_DECIMATER_TEMPLATES  Jan Möbius committed Feb 20, 2019 212 #include "DecimaterT_impl.hh"  Jan Möbius committed Feb 06, 2009 213 214 215 216 217 #endif //============================================================================= #endif // OPENMESH_DECIMATER_DECIMATERT_HH defined //=============================================================================