/src/assimp/code/PostProcessing/JoinVerticesProcess.h
Line | Count | Source |
1 | | /* |
2 | | Open Asset Import Library (assimp) |
3 | | ---------------------------------------------------------------------- |
4 | | |
5 | | Copyright (c) 2006-2025, assimp team |
6 | | |
7 | | All rights reserved. |
8 | | |
9 | | Redistribution and use of this software in source and binary forms, |
10 | | with or without modification, are permitted provided that the |
11 | | following conditions are met: |
12 | | |
13 | | * Redistributions of source code must retain the above |
14 | | copyright notice, this list of conditions and the |
15 | | following disclaimer. |
16 | | |
17 | | * Redistributions in binary form must reproduce the above |
18 | | copyright notice, this list of conditions and the |
19 | | following disclaimer in the documentation and/or other |
20 | | materials provided with the distribution. |
21 | | |
22 | | * Neither the name of the assimp team, nor the names of its |
23 | | contributors may be used to endorse or promote products |
24 | | derived from this software without specific prior |
25 | | written permission of the assimp team. |
26 | | |
27 | | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
28 | | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
29 | | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
30 | | A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
31 | | OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
32 | | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
33 | | LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
34 | | DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
35 | | THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
36 | | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
37 | | OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
38 | | |
39 | | ---------------------------------------------------------------------- |
40 | | */ |
41 | | |
42 | | /** @file Defines a post processing step to join identical vertices |
43 | | on all imported meshes.*/ |
44 | | #ifndef AI_JOINVERTICESPROCESS_H_INC |
45 | | #define AI_JOINVERTICESPROCESS_H_INC |
46 | | |
47 | | #include "Common/BaseProcess.h" |
48 | | |
49 | | #include <assimp/types.h> |
50 | | |
51 | | struct aiMesh; |
52 | | |
53 | | namespace Assimp { |
54 | | |
55 | | // --------------------------------------------------------------------------- |
56 | | /** The JoinVerticesProcess unites identical vertices in all imported meshes. |
57 | | * By default the importer returns meshes where each face addressed its own |
58 | | * set of vertices even if that means that identical vertices are stored multiple |
59 | | * times. The JoinVerticesProcess finds these identical vertices and |
60 | | * erases all but one of the copies. This usually reduces the number of vertices |
61 | | * in a mesh by a serious amount and is the standard form to render a mesh. |
62 | | */ |
63 | | class ASSIMP_API JoinVerticesProcess : public BaseProcess { |
64 | | public: |
65 | | // ------------------------------------------------------------------- |
66 | | /// The default class constructor / destructor. |
67 | 502 | JoinVerticesProcess() = default; |
68 | | ~JoinVerticesProcess() override = default; |
69 | | |
70 | | // ------------------------------------------------------------------- |
71 | | /** Returns whether the processing step is present in the given flag field. |
72 | | * @param pFlags The processing flags the importer was called with. A bitwise |
73 | | * combination of #aiPostProcessSteps. |
74 | | * @return true if the process is present in this flag fields, false if not. |
75 | | */ |
76 | | bool IsActive( unsigned int pFlags) const override; |
77 | | |
78 | | // ------------------------------------------------------------------- |
79 | | /** Executes the post processing step on the given imported data. |
80 | | * At the moment a process is not supposed to fail. |
81 | | * @param pScene The imported data to work at. |
82 | | */ |
83 | | void Execute( aiScene* pScene) override; |
84 | | |
85 | | // ------------------------------------------------------------------- |
86 | | /** Unites identical vertices in the given mesh. |
87 | | * @param pMesh The mesh to process. |
88 | | * @param meshIndex Index of the mesh to process |
89 | | */ |
90 | | int ProcessMesh( aiMesh* pMesh, unsigned int meshIndex); |
91 | | }; |
92 | | |
93 | | } // end of namespace Assimp |
94 | | |
95 | | #endif // AI_CALCTANGENTSPROCESS_H_INC |