MeshConsolidator 2.44 KB
Newer Older
xuebingbing's avatar
xuebingbing committed
1 2 3 4 5 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 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
/* -*-c++-*- */
/* osgEarth - Dynamic map generation toolkit for OpenSceneGraph
 * Copyright 2015 Pelican Mapping
 * http://osgearth.org
 *
 * osgEarth 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 of the License, or
 * (at your option) any later version.
 *
 * This program 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 program.  If not, see <http://www.gnu.org/licenses/>
 */
#ifndef OSGEARTHSYMBOLOGY_MESH_CONSOLIDATOR
#define OSGEARTHSYMBOLOGY_MESH_CONSOLIDATOR

#include <osgEarthSymbology/Common>
#include <osg/Geode>
#include <osg/Geometry>

namespace osgEarth { namespace Symbology
{
    /**
     * Consolidates all the like-moded primitive sets in a geometry.
     *
     * This utility will attempt to extract all triangular primitives
     * from a geometry and regroup them into a smaller number of primitive sets. For
     * example, if you have a geometry with triangle strips, fans, and triangles, it will
     * combines them into one a minimal number of primitive sets containing GL_TRIANGLES.
     *
     * Limitations:
     *
     * - Will not operate on geometry with vertex attributes.
     * 
     * - For geometries with tex coord arrays, all geometries must have the same configuration
     * (i.e., number of texcoord arrays, and the same unit bindings).
     */
    class OSGEARTHSYMBOLOGY_EXPORT MeshConsolidator
    {
    public:
        /**
         * Converts all polygon primitive sets (tristrips, trifans, polygons, etc)
         * into GL_TRIANGLES. Similar to the IndexMeshVisitor, except that this
         * retians user data pointers on the primsets.
         */
        static void convertToTriangles( osg::Geometry& geom, bool force=false );

        /**
         * Consolidates compatible geometries in the geode. First runs the 
         * convertToTriangles method on each Geometry if applicable, them combines
         * geometies into a minimal set for performance purposes.
         */
        static void run( osg::Geode& geode );
    };

} } // namespace osgEarth::Symbology

#endif // OSGEARTHSYMBOLOGY_MESH_CONSOLIDATOR