Merge branch 'blender2.7' into master.
[blender.git] / source / blender / blenkernel / BKE_editmesh.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * Contributor(s): Joseph Eagar.
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 #ifndef __BKE_EDITMESH_H__
24 #define __BKE_EDITMESH_H__
25
26 /** \file BKE_editmesh.h
27  *  \ingroup bke
28  *
29  * The \link edmesh EDBM module\endlink is for editmode bmesh stuff.
30  * In contrast, this module is for code shared with blenkernel that's
31  * only concerned with low level operations on the #BMEditMesh structure.
32  */
33
34 #include "BKE_customdata.h"
35 #include "bmesh.h"
36
37 struct BMesh;
38 struct BMLoop;
39 struct Mesh;
40 struct Scene;
41 struct DerivedMesh;
42 struct MeshStatVis;
43 struct Depsgraph;
44 struct EditMeshData;
45
46 /**
47  * This structure is used for mesh edit-mode.
48  *
49  * through this, you get access to both the edit #BMesh,
50  * it's tessellation, and various stuff that doesn't belong in the BMesh
51  * struct itself.
52  *
53  * the entire derivedmesh and modifier system works with this structure,
54  * and not BMesh.  Mesh->edit_bmesh stores a pointer to this structure. */
55 typedef struct BMEditMesh {
56         struct BMesh *bm;
57
58         /*this is for undoing failed operations*/
59         struct BMEditMesh *emcopy;
60         int emcopyusers;
61
62         /* we store tessellations as triplets of three loops,
63          * which each define a triangle.*/
64         struct BMLoop *(*looptris)[3];
65         int tottri;
66
67         struct Mesh *mesh_eval_final, *mesh_eval_cage;
68
69         /*derivedmesh stuff*/
70         CustomDataMask lastDataMask;
71         unsigned char (*derivedVertColor)[4];
72         int derivedVertColorLen;
73         unsigned char (*derivedFaceColor)[4];
74         int derivedFaceColorLen;
75
76         /*selection mode*/
77         short selectmode;
78         short mat_nr;
79
80         /* Object this editmesh came from (if it came from one) */
81         struct Object *ob;
82
83         /*temp variables for x-mirror editing*/
84         int mirror_cdlayer; /* -1 is invalid */
85 } BMEditMesh;
86
87 /* editmesh.c */
88 void        BKE_editmesh_tessface_calc(BMEditMesh *em);
89 BMEditMesh *BKE_editmesh_create(BMesh *bm, const bool do_tessellate);
90 BMEditMesh *BKE_editmesh_copy(BMEditMesh *em);
91 BMEditMesh *BKE_editmesh_from_object(struct Object *ob);
92 void        BKE_editmesh_free_derivedmesh(BMEditMesh *em);
93 void        BKE_editmesh_free(BMEditMesh *em);
94
95 void        BKE_editmesh_color_free(BMEditMesh *em);
96 void        BKE_editmesh_color_ensure(BMEditMesh *em, const char htype);
97 float     (*BKE_editmesh_vertexCos_get_orco(BMEditMesh *em, int *r_numVerts))[3];
98 void        BKE_editmesh_lnorspace_update(BMEditMesh *em);
99
100 /* editderivedmesh.c */
101 /* should really be defined in editmesh.c, but they use 'EditDerivedBMesh' */
102 void BKE_editmesh_statvis_calc(
103         BMEditMesh *em, struct EditMeshData *emd, const struct MeshStatVis *statvis);
104
105 float (*BKE_editmesh_vertexCos_get(
106            struct Depsgraph *depsgraph, struct BMEditMesh *em, struct Scene *scene, int *r_numVerts))[3];
107
108 #endif /* __BKE_EDITMESH_H__ */