2008-05-09 17:24:28 +00:00
|
|
|
/*
|
2008-05-22 10:20:31 +00:00
|
|
|
Open Asset Import Library (ASSIMP)
|
2008-05-09 17:24:28 +00:00
|
|
|
----------------------------------------------------------------------
|
|
|
|
|
|
|
|
Copyright (c) 2006-2008, ASSIMP Development Team
|
|
|
|
All rights reserved.
|
|
|
|
|
|
|
|
Redistribution and use of this software in source and binary forms,
|
|
|
|
with or without modification, are permitted provided that the
|
|
|
|
following conditions are met:
|
|
|
|
|
|
|
|
* Redistributions of source code must retain the above
|
|
|
|
copyright notice, this list of conditions and the
|
|
|
|
following disclaimer.
|
|
|
|
|
|
|
|
* 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.
|
|
|
|
|
|
|
|
* Neither the name of the ASSIMP team, nor the names of its
|
|
|
|
contributors may be used to endorse or promote products
|
|
|
|
derived from this software without specific prior
|
|
|
|
written permission of the ASSIMP Development Team.
|
|
|
|
|
|
|
|
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
|
|
|
|
OWNER 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.
|
|
|
|
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
|
|
|
|
/** @file Defines a post processing step to split large meshes into submeshes
|
|
|
|
*/
|
2008-05-05 12:36:31 +00:00
|
|
|
#ifndef AI_SPLITLARGEMESHES_H_INC
|
|
|
|
#define AI_SPLITLARGEMESHES_H_INC
|
|
|
|
|
|
|
|
#include <vector>
|
|
|
|
#include "BaseProcess.h"
|
2008-07-24 11:19:24 +00:00
|
|
|
|
2008-05-05 12:36:31 +00:00
|
|
|
#include "../include/aiMesh.h"
|
|
|
|
#include "../include/aiScene.h"
|
|
|
|
|
2008-07-29 20:36:27 +00:00
|
|
|
class SplitLargeMeshesTest;
|
2008-05-05 12:36:31 +00:00
|
|
|
namespace Assimp
|
|
|
|
{
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
class SplitLargeMeshesProcess_Triangle;
|
|
|
|
class SplitLargeMeshesProcess_Vertex;
|
|
|
|
|
2008-06-22 10:09:26 +00:00
|
|
|
// NOTE: If you change these limits, don't forget to change the
|
|
|
|
// corresponding values in all Assimp ports
|
2008-05-22 22:47:20 +00:00
|
|
|
|
|
|
|
// **********************************************************
|
2008-07-24 11:19:24 +00:00
|
|
|
// Java: ConfigProperty.java,
|
|
|
|
// ConfigProperty.DEFAULT_VERTEX_SPLIT_LIMIT
|
|
|
|
// ConfigProperty.DEFAULT_TRIANGLE_SPLIT_LIMIT
|
2008-05-22 22:47:20 +00:00
|
|
|
// **********************************************************
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
// default limit for vertices
|
2008-06-22 10:09:26 +00:00
|
|
|
#if (!defined AI_SLM_DEFAULT_MAX_VERTICES)
|
|
|
|
# define AI_SLM_DEFAULT_MAX_VERTICES 1000000
|
|
|
|
#endif
|
2008-05-09 17:24:28 +00:00
|
|
|
|
|
|
|
// default limit for triangles
|
2008-06-22 10:09:26 +00:00
|
|
|
#if (!defined AI_SLM_DEFAULT_MAX_TRIANGLES)
|
|
|
|
# define AI_SLM_DEFAULT_MAX_TRIANGLES 1000000
|
|
|
|
#endif
|
2008-05-05 12:36:31 +00:00
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
/** Postprocessing filter to split large meshes into submeshes
|
2008-05-09 17:24:28 +00:00
|
|
|
*
|
|
|
|
* Applied BEFORE the JoinVertices-Step occurs.
|
|
|
|
* Returns NON-UNIQUE vertices, splits by triangle number.
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
2008-07-24 11:19:24 +00:00
|
|
|
class ASSIMP_API SplitLargeMeshesProcess_Triangle : public BaseProcess
|
2008-05-05 12:36:31 +00:00
|
|
|
{
|
|
|
|
friend class Importer;
|
2008-05-09 17:24:28 +00:00
|
|
|
friend class SplitLargeMeshesProcess_Vertex;
|
2008-07-29 20:36:27 +00:00
|
|
|
friend class ::SplitLargeMeshesTest;
|
2008-05-05 12:36:31 +00:00
|
|
|
|
|
|
|
protected:
|
|
|
|
/** Constructor to be privately used by Importer */
|
2008-05-09 17:24:28 +00:00
|
|
|
SplitLargeMeshesProcess_Triangle();
|
2008-05-05 12:36:31 +00:00
|
|
|
|
|
|
|
/** Destructor, private as well */
|
2008-05-09 17:24:28 +00:00
|
|
|
~SplitLargeMeshesProcess_Triangle();
|
2008-05-05 12:36:31 +00:00
|
|
|
|
|
|
|
public:
|
|
|
|
// -------------------------------------------------------------------
|
2008-08-08 18:34:14 +00:00
|
|
|
/** Returns whether the processing step is present in the given flag.
|
|
|
|
* @param pFlags The processing flags the importer was called with. A
|
|
|
|
* bitwise combination of #aiPostProcessSteps.
|
|
|
|
* @return true if the process is present in this flag fields,
|
|
|
|
* false if not.
|
2008-05-05 12:36:31 +00:00
|
|
|
*/
|
|
|
|
bool IsActive( unsigned int pFlags) const;
|
|
|
|
|
2008-08-08 18:34:14 +00:00
|
|
|
|
|
|
|
// -------------------------------------------------------------------
|
|
|
|
/** Called prior to ExecuteOnScene().
|
|
|
|
* The function is a request to the process to update its configuration
|
|
|
|
* basing on the Importer's configuration property list.
|
|
|
|
*/
|
|
|
|
virtual void SetupProperties(const Importer* pImp);
|
|
|
|
|
|
|
|
|
2008-08-13 23:46:46 +00:00
|
|
|
//! Set the split limit - needed for unit testing
|
|
|
|
inline void SetLimit(unsigned int l)
|
|
|
|
{LIMIT = l;}
|
|
|
|
|
|
|
|
//! Get the split limit
|
|
|
|
inline unsigned int GetLimit() const
|
|
|
|
{return LIMIT;}
|
|
|
|
|
2008-08-08 18:34:14 +00:00
|
|
|
protected:
|
|
|
|
|
2008-05-05 12:36:31 +00:00
|
|
|
// -------------------------------------------------------------------
|
|
|
|
/** Executes the post processing step on the given imported data.
|
|
|
|
* At the moment a process is not supposed to fail.
|
|
|
|
* @param pScene The imported data to work at.
|
|
|
|
*/
|
|
|
|
void Execute( aiScene* pScene);
|
|
|
|
|
2008-08-08 18:34:14 +00:00
|
|
|
// -------------------------------------------------------------------
|
2008-05-05 12:36:31 +00:00
|
|
|
//! Apply the algorithm to a given mesh
|
|
|
|
void SplitMesh (unsigned int a, aiMesh* pcMesh,
|
|
|
|
std::vector<std::pair<aiMesh*, unsigned int> >& avList);
|
|
|
|
|
2008-08-08 18:34:14 +00:00
|
|
|
// -------------------------------------------------------------------
|
|
|
|
//! Update a node in the asset after a few of its meshes
|
|
|
|
//! have been split
|
2008-05-09 17:24:28 +00:00
|
|
|
static void UpdateNode(aiNode* pcNode,
|
2008-05-05 12:36:31 +00:00
|
|
|
const std::vector<std::pair<aiMesh*, unsigned int> >& avList);
|
2008-05-09 17:24:28 +00:00
|
|
|
|
|
|
|
public:
|
2008-08-08 18:34:14 +00:00
|
|
|
//! Triangle limit
|
|
|
|
unsigned int LIMIT;
|
2008-05-09 17:24:28 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
/** Postprocessing filter to split large meshes into submeshes
|
|
|
|
*
|
|
|
|
* Applied AFTER the JoinVertices-Step occurs.
|
|
|
|
* Returns UNIQUE vertices, splits by vertex number.
|
|
|
|
*/
|
2008-07-24 11:19:24 +00:00
|
|
|
class ASSIMP_API SplitLargeMeshesProcess_Vertex : public BaseProcess
|
2008-05-09 17:24:28 +00:00
|
|
|
{
|
|
|
|
friend class Importer;
|
2008-07-29 20:36:27 +00:00
|
|
|
friend class ::SplitLargeMeshesTest;
|
2008-05-09 17:24:28 +00:00
|
|
|
|
|
|
|
protected:
|
|
|
|
/** Constructor to be privately used by Importer */
|
|
|
|
SplitLargeMeshesProcess_Vertex();
|
|
|
|
|
|
|
|
/** Destructor, private as well */
|
|
|
|
~SplitLargeMeshesProcess_Vertex();
|
|
|
|
|
|
|
|
public:
|
|
|
|
// -------------------------------------------------------------------
|
|
|
|
/** Returns whether the processing step is present in the given flag field.
|
|
|
|
* @param pFlags The processing flags the importer was called with. A bitwise
|
|
|
|
* combination of #aiPostProcessSteps.
|
|
|
|
* @return true if the process is present in this flag fields, false if not.
|
|
|
|
*/
|
|
|
|
bool IsActive( unsigned int pFlags) const;
|
|
|
|
|
2008-08-08 18:34:14 +00:00
|
|
|
// -------------------------------------------------------------------
|
|
|
|
/** Called prior to ExecuteOnScene().
|
|
|
|
* The function is a request to the process to update its configuration
|
|
|
|
* basing on the Importer's configuration property list.
|
|
|
|
*/
|
|
|
|
virtual void SetupProperties(const Importer* pImp);
|
|
|
|
|
2008-08-13 23:46:46 +00:00
|
|
|
|
|
|
|
//! Set the split limit - needed for unit testing
|
|
|
|
inline void SetLimit(unsigned int l)
|
|
|
|
{LIMIT = l;}
|
|
|
|
|
|
|
|
//! Get the split limit
|
|
|
|
inline unsigned int GetLimit() const
|
|
|
|
{return LIMIT;}
|
|
|
|
|
2008-08-08 18:34:14 +00:00
|
|
|
protected:
|
|
|
|
|
2008-05-09 17:24:28 +00:00
|
|
|
// -------------------------------------------------------------------
|
|
|
|
/** Executes the post processing step on the given imported data.
|
|
|
|
* At the moment a process is not supposed to fail.
|
|
|
|
* @param pScene The imported data to work at.
|
|
|
|
*/
|
|
|
|
void Execute( aiScene* pScene);
|
|
|
|
|
2008-08-08 18:34:14 +00:00
|
|
|
// -------------------------------------------------------------------
|
2008-05-09 17:24:28 +00:00
|
|
|
//! Apply the algorithm to a given mesh
|
|
|
|
void SplitMesh (unsigned int a, aiMesh* pcMesh,
|
|
|
|
std::vector<std::pair<aiMesh*, unsigned int> >& avList);
|
|
|
|
|
|
|
|
// NOTE: Reuse SplitLargeMeshesProcess_Triangle::UpdateNode()
|
|
|
|
|
|
|
|
public:
|
2008-08-08 18:34:14 +00:00
|
|
|
//! Triangle limit
|
|
|
|
unsigned int LIMIT;
|
2008-05-05 12:36:31 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
} // end of namespace Assimp
|
|
|
|
|
|
|
|
#endif // !!AI_SPLITLARGEMESHES_H_INC
|