MeshOptimizers
Go to the documentation of this file.
/* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield
*
* This library is open source and may be redistributed and/or modified under
* the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
* (at your option) any later version. The full license is in LICENSE file
* included with this distribution, and on the openscenegraph.org website.
*
* 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
* OpenSceneGraph Public License for more details.
*/
#ifndef OSGUTIL_MESHOPTIMIZERS
#define OSGUTIL_MESHOPTIMIZERS 1
#include <set>
#include <vector>
#include <osg/Geode>
#include <osg/Geometry>
#include <osg/NodeVisitor>
#include <osgUtil/Optimizer>
namespace osgUtil
{
// Helper that collects all the unique Geometry objects in a subgraph.
class OSGUTIL_EXPORT GeometryCollector : public BaseOptimizerVisitor
{
public:
GeometryCollector(Optimizer* optimizer,
Optimizer::OptimizationOptions options)
: BaseOptimizerVisitor(optimizer, options) {}
void reset();
void apply(osg::Geometry& geom);
typedef std::set<osg::Geometry*> GeometryList;
GeometryList& getGeometryList() { return _geometryList; };
protected:
GeometryList _geometryList;
};
// Convert geometry that uses DrawArrays to DrawElements i.e.,
// construct a real mesh. This removes duplicate vertices.
class OSGUTIL_EXPORT IndexMeshVisitor : public GeometryCollector
{
public:
IndexMeshVisitor(Optimizer* optimizer = 0)
: GeometryCollector(optimizer, Optimizer::INDEX_MESH), _generateNewIndicesOnAllGeometries(false)
{
}
inline void setGenerateNewIndicesOnAllGeometries(bool b) { _generateNewIndicesOnAllGeometries = b; }
inline bool getGenerateNewIndicesOnAllGeometries() const { return _generateNewIndicesOnAllGeometries; }
void makeMesh(osg::Geometry& geom);
void makeMesh();
protected:
bool _generateNewIndicesOnAllGeometries;
};
// Optimize the triangle order in a mesh for best use of the GPU's
// post-transform cache. This uses Tom Forsyth's algorithm described
// at http://home.comcast.net/~tom_forsyth/papers/fast_vert_cache_opt.html
class OSGUTIL_EXPORT VertexCacheVisitor : public GeometryCollector
{
public:
VertexCacheVisitor(Optimizer* optimizer = 0)
: GeometryCollector(optimizer, Optimizer::VERTEX_POSTTRANSFORM)
{
}
void optimizeVertices(osg::Geometry& geom);
void optimizeVertices();
private:
void doVertexOptimization(osg::Geometry& geom,
std::vector<unsigned>& vertDrawList);
};
// Gather statistics on post-transform cache misses for geometry
class OSGUTIL_EXPORT VertexCacheMissVisitor : public osg::NodeVisitor
{
public:
VertexCacheMissVisitor(unsigned cacheSize = 16);
void reset();
virtual void apply(osg::Geometry& geom);
void doGeometry(osg::Geometry& geom);
unsigned misses;
unsigned triangles;
protected:
const unsigned _cacheSize;
};
// Optimize the use of the GPU pre-transform cache by arranging vertex
// attributes in the order they are used.
class OSGUTIL_EXPORT VertexAccessOrderVisitor : public GeometryCollector
{
struct OrderByPrimitiveMode
{
inline bool operator() (const osg::ref_ptr<osg::PrimitiveSet>& prim1, const osg::ref_ptr<osg::PrimitiveSet>& prim2)
{
if(prim1 && prim2) {
return prim1->getMode() > prim2->getMode();
}
else if(prim1) {
return true;
}
return false;
}
} order_by_primitive_mode;
public:
VertexAccessOrderVisitor(Optimizer* optimizer = 0)
: GeometryCollector(optimizer, Optimizer::VERTEX_PRETRANSFORM)
{
}
void optimizeOrder();
void optimizeOrder(osg::Geometry& geom);
};
class OSGUTIL_EXPORT SharedArrayOptimizer
{
public:
void findDuplicatedUVs(const osg::Geometry& geometry);
void deduplicateUVs(osg::Geometry& geometry);
protected:
std::map<unsigned int, unsigned int> _deduplicateUvs;
}; // SharedArrayOptimizer
inline void optimizeMesh(osg::Node* node)
{
IndexMeshVisitor imv;
node->accept(imv);
imv.makeMesh();
VertexCacheVisitor vcv;
node->accept(vcv);
vcv.optimizeVertices();
VertexAccessOrderVisitor vaov;
node->accept(vaov);
vaov.optimizeOrder();
}
}
#endif
Geode
Geometry
NodeVisitor
Optimizer
osgUtil::BaseOptimizerVisitor::BaseOptimizerVisitor
BaseOptimizerVisitor(Optimizer *optimizer, unsigned int operation)
Definition Optimizer:37
osgUtil::GeometryCollector::_geometryList
GeometryList _geometryList
Definition MeshOptimizers:40
osgUtil::GeometryCollector::reset
void reset()
osgUtil::GeometryCollector::GeometryCollector
GeometryCollector(Optimizer *optimizer, Optimizer::OptimizationOptions options)
Definition MeshOptimizers:32
osgUtil::GeometryCollector::apply
void apply(osg::Geometry &geom)
osgUtil::GeometryCollector::GeometryList
std::set< osg::Geometry * > GeometryList
Definition MeshOptimizers:37
osgUtil::GeometryCollector::getGeometryList
GeometryList & getGeometryList()
Definition MeshOptimizers:38
osgUtil::IndexMeshVisitor
Definition MeshOptimizers:46
osgUtil::IndexMeshVisitor::setGenerateNewIndicesOnAllGeometries
void setGenerateNewIndicesOnAllGeometries(bool b)
Definition MeshOptimizers:52
osgUtil::IndexMeshVisitor::IndexMeshVisitor
IndexMeshVisitor(Optimizer *optimizer=0)
Definition MeshOptimizers:48
osgUtil::IndexMeshVisitor::_generateNewIndicesOnAllGeometries
bool _generateNewIndicesOnAllGeometries
Definition MeshOptimizers:58
osgUtil::IndexMeshVisitor::getGenerateNewIndicesOnAllGeometries
bool getGenerateNewIndicesOnAllGeometries() const
Definition MeshOptimizers:53
osgUtil::IndexMeshVisitor::makeMesh
void makeMesh()
osgUtil::IndexMeshVisitor::makeMesh
void makeMesh(osg::Geometry &geom)
osgUtil::Optimizer
Definition Optimizer:61
osgUtil::Optimizer::OptimizationOptions
OptimizationOptions
Definition Optimizer:69
osgUtil::SharedArrayOptimizer
Definition MeshOptimizers:121
osgUtil::SharedArrayOptimizer::deduplicateUVs
void deduplicateUVs(osg::Geometry &geometry)
osgUtil::SharedArrayOptimizer::findDuplicatedUVs
void findDuplicatedUVs(const osg::Geometry &geometry)
osgUtil::SharedArrayOptimizer::_deduplicateUvs
std::map< unsigned int, unsigned int > _deduplicateUvs
Definition MeshOptimizers:126
osgUtil::VertexAccessOrderVisitor
Definition MeshOptimizers:96
osgUtil::VertexAccessOrderVisitor::VertexAccessOrderVisitor
VertexAccessOrderVisitor(Optimizer *optimizer=0)
Definition MeshOptimizers:112
osgUtil::VertexAccessOrderVisitor::optimizeOrder
void optimizeOrder(osg::Geometry &geom)
osgUtil::VertexAccessOrderVisitor::optimizeOrder
void optimizeOrder()
osgUtil::VertexCacheMissVisitor::reset
void reset()
osgUtil::VertexCacheMissVisitor::doGeometry
void doGeometry(osg::Geometry &geom)
osgUtil::VertexCacheMissVisitor::apply
virtual void apply(osg::Geometry &geom)
osgUtil::VertexCacheMissVisitor::triangles
unsigned triangles
Definition MeshOptimizers:88
osgUtil::VertexCacheMissVisitor::misses
unsigned misses
Definition MeshOptimizers:87
osgUtil::VertexCacheMissVisitor::VertexCacheMissVisitor
VertexCacheMissVisitor(unsigned cacheSize=16)
osgUtil::VertexCacheMissVisitor::_cacheSize
const unsigned _cacheSize
Definition MeshOptimizers:90
osgUtil::VertexCacheVisitor
Definition MeshOptimizers:65
osgUtil::VertexCacheVisitor::optimizeVertices
void optimizeVertices(osg::Geometry &geom)
osgUtil::VertexCacheVisitor::optimizeVertices
void optimizeVertices()
osgUtil::VertexCacheVisitor::VertexCacheVisitor
VertexCacheVisitor(Optimizer *optimizer=0)
Definition MeshOptimizers:67
osg::Geometry
Definition Geometry:31
osg::NodeVisitor
Definition NodeVisitor:82
osg::Node
Definition Node:72
osg::Node::accept
virtual void accept(NodeVisitor &nv)
osg::ref_ptr
Definition ref_ptr:32
osgUtil
Definition NodeVisitor:25
osgUtil::optimizeMesh
void optimizeMesh(osg::Node *node)
Definition MeshOptimizers:130
OSGUTIL_EXPORT
#define OSGUTIL_EXPORT
Definition osgUtil/Export:40