1 | /* |
2 | Open Asset Import Library (assimp) |
3 | ---------------------------------------------------------------------- |
4 | |
5 | Copyright (c) 2006-2019, assimp team |
6 | |
7 | |
8 | All rights reserved. |
9 | |
10 | Redistribution and use of this software in source and binary forms, |
11 | with or without modification, are permitted provided that the |
12 | following conditions are met: |
13 | |
14 | * Redistributions of source code must retain the above |
15 | copyright notice, this list of conditions and the |
16 | following disclaimer. |
17 | |
18 | * Redistributions in binary form must reproduce the above |
19 | copyright notice, this list of conditions and the |
20 | following disclaimer in the documentation and/or other |
21 | materials provided with the distribution. |
22 | |
23 | * Neither the name of the assimp team, nor the names of its |
24 | contributors may be used to endorse or promote products |
25 | derived from this software without specific prior |
26 | written permission of the assimp team. |
27 | |
28 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
29 | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
30 | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
31 | A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
32 | OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
33 | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
34 | LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
35 | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
36 | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
37 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
38 | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
39 | |
40 | ---------------------------------------------------------------------- |
41 | */ |
42 | |
43 | /// @file SplitByBoneCountProcess.h |
44 | /// Defines a post processing step to split meshes with many bones into submeshes |
45 | #ifndef AI_SPLITBYBONECOUNTPROCESS_H_INC |
46 | #define AI_SPLITBYBONECOUNTPROCESS_H_INC |
47 | |
48 | #include <vector> |
49 | #include "BaseProcess.h" |
50 | |
51 | #include <assimp/mesh.h> |
52 | #include <assimp/scene.h> |
53 | |
54 | namespace Assimp |
55 | { |
56 | |
57 | |
58 | /** Postprocessing filter to split meshes with many bones into submeshes |
59 | * so that each submesh has a certain max bone count. |
60 | * |
61 | * Applied BEFORE the JoinVertices-Step occurs. |
62 | * Returns NON-UNIQUE vertices, splits by bone count. |
63 | */ |
64 | class SplitByBoneCountProcess : public BaseProcess |
65 | { |
66 | public: |
67 | |
68 | SplitByBoneCountProcess(); |
69 | ~SplitByBoneCountProcess(); |
70 | |
71 | public: |
72 | /** Returns whether the processing step is present in the given flag. |
73 | * @param pFlags The processing flags the importer was called with. A |
74 | * bitwise combination of #aiPostProcessSteps. |
75 | * @return true if the process is present in this flag fields, |
76 | * false if not. |
77 | */ |
78 | bool IsActive( unsigned int pFlags) const; |
79 | |
80 | /** Called prior to ExecuteOnScene(). |
81 | * The function is a request to the process to update its configuration |
82 | * basing on the Importer's configuration property list. |
83 | */ |
84 | virtual void SetupProperties(const Importer* pImp); |
85 | |
86 | protected: |
87 | /** Executes the post processing step on the given imported data. |
88 | * At the moment a process is not supposed to fail. |
89 | * @param pScene The imported data to work at. |
90 | */ |
91 | void Execute( aiScene* pScene); |
92 | |
93 | /// Splits the given mesh by bone count. |
94 | /// @param pMesh the Mesh to split. Is not changed at all, but might be superfluous in case it was split. |
95 | /// @param poNewMeshes Array of submeshes created in the process. Empty if splitting was not necessary. |
96 | void SplitMesh( const aiMesh* pMesh, std::vector<aiMesh*>& poNewMeshes) const; |
97 | |
98 | /// Recursively updates the node's mesh list to account for the changed mesh list |
99 | void UpdateNode( aiNode* pNode) const; |
100 | |
101 | public: |
102 | /// Max bone count. Splitting occurs if a mesh has more than that number of bones. |
103 | size_t mMaxBoneCount; |
104 | |
105 | /// Per mesh index: Array of indices of the new submeshes. |
106 | std::vector< std::vector<unsigned int> > mSubMeshIndices; |
107 | }; |
108 | |
109 | } // end of namespace Assimp |
110 | |
111 | #endif // !!AI_SPLITBYBONECOUNTPROCESS_H_INC |
112 | |