decimation.h 4.68 KB
Newer Older
Pierre Kraemer's avatar
Pierre Kraemer committed
1 2 3
/*******************************************************************************
* CGoGN: Combinatorial and Geometric modeling with Generic N-dimensional Maps  *
* version 0.1                                                                  *
4
* Copyright (C) 2009-2013, IGG Team, ICube, University of Strasbourg           *
Pierre Kraemer's avatar
Pierre Kraemer committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
*                                                                              *
* 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; either version 2.1 of the License, or (at your     *
* option) any later version.                                                   *
*                                                                              *
* 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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA.           *
*                                                                              *
20
* Web site: http://cgogn.unistra.fr/                                           *
Pierre Kraemer's avatar
Pierre Kraemer committed
21 22 23 24 25 26 27
* Contact information: cgogn@unistra.fr                                        *
*                                                                              *
*******************************************************************************/

#ifndef __DECIMATION_H__
#define __DECIMATION_H__

28 29
#include "Algo/Decimation/edgeSelector.h"
#include "Algo/Decimation/halfEdgeSelector.h"
Pierre Kraemer's avatar
Pierre Kraemer committed
30
#include "Algo/Decimation/geometryApproximator.h"
31
#include "Algo/Decimation/colorPerVertexApproximator.h"
Pierre Kraemer's avatar
Pierre Kraemer committed
32 33 34 35 36 37 38

namespace CGoGN
{

namespace Algo
{

39 40 41
namespace Surface
{

Pierre Kraemer's avatar
Pierre Kraemer committed
42 43 44
namespace Decimation
{

45
/**
46 47
 * \fn decimate
 * Function that decimates the provided mesh through successive edge collapses
48
 * by using a declared selector and approximator type (see \file approximator.h and \file selector.h).
49 50 51 52 53 54 55 56 57
 *
 * \param map the map to decimate
 * \param s the SelectorType
 * \param a the ApproximatorType
 * \param position the vertex position embeddings
 * \param nbWantedVertices the aimed amount of vertices after decimation
 * \param edgeErrors will (if not null) contain the edge errors computed by the approximator/selector (default NULL)
 * \param callback_wrapper a callback function for progress monitoring (default NULL)
 * \param callback_object the object to call the callback on (default NULL)
58 59
 *
 * \return >= 0 if finished correctly : 1 if no more edges are collapsible, 0 is nbWantedVertices achieved, -1 if the initialisation of the selector failed
60
 */
61
template <typename PFP, typename T>
62
int decimate(
Pierre Kraemer's avatar
Pierre Kraemer committed
63 64 65
	typename PFP::MAP& map,
	SelectorType s,
	ApproximatorType a,
66
	std::vector<VertexAttribute<T, typename PFP::MAP> >& attribs,
Pierre Kraemer's avatar
Pierre Kraemer committed
67
	unsigned int nbWantedVertices,
Sylvain Thery's avatar
Sylvain Thery committed
68
	EdgeAttribute<typename PFP::REAL, typename PFP::MAP>* edgeErrors = NULL,
69 70
	void (*callback_wrapper)(void*, const void*) = NULL,
	void* callback_object = NULL
Pierre Kraemer's avatar
Pierre Kraemer committed
71 72
) ;

73
/**
74 75
 *\fn decimate
 * Function that decimates the provided mesh through successive edge collapses
76 77 78 79 80 81
 * by providing the selector and the approximators
 *
 * \param map the map to decimate
 * \param s the selector
 * \param a a vector containing the approximators
 * \param nbWantedVertices the aimed amount of vertices after decimation
82
 * \param recomputePriorityList if false and a priority list exists, it is not recomputed
83 84 85 86 87 88 89 90 91
 * \param edgeErrors will (if not null) contain the edge errors computed by the approximator/selector (default NULL)
 * \param callback_wrapper a callback function for progress monitoring (default NULL)
 * \param callback_object the object to call the callback on (default NULL)
 *
 * \return >= 0 if finished correctly : 1 if no more edges are collapsible, 0 is nbWantedVertices achieved, -1 if the initialisation of the selector failed
 */
template <typename PFP>
int decimate(
	typename PFP::MAP& map,
92
	Selector<PFP>* s,
93 94
	std::vector<ApproximatorGen<PFP>*>& a,
	unsigned int nbWantedVertices,
95
	bool recomputePriorityList = true,
96 97 98 99
	EdgeAttribute<typename PFP::REAL,
	typename PFP::MAP>* edgeErrors = NULL,
	void (*callback_wrapper)(void*, const void*) = NULL,
	void* callback_object = NULL
100 101
) ;

102
} // namespace Decimation
Pierre Kraemer's avatar
Pierre Kraemer committed
103

104
} // namespace Surface
105

106
} // namespace Algo
Pierre Kraemer's avatar
Pierre Kraemer committed
107

108
} // namespace CGoGN
Pierre Kraemer's avatar
Pierre Kraemer committed
109 110 111 112

#include "Algo/Decimation/decimation.hpp"

#endif