commit before doing some hefty shapekey change, will break compilation
[blender-staging.git] / source / blender / blenkernel / BKE_mesh.h
1 /**
2  * blenlib/BKE_mesh.h (mar-2001 nzc)
3  *      
4  * $Id$ 
5  *
6  * ***** BEGIN GPL LICENSE BLOCK *****
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * as published by the Free Software Foundation; either version 2
11  * of the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software Foundation,
20  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
21  *
22  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
23  * All rights reserved.
24  *
25  * The Original Code is: all of this file.
26  *
27  * Contributor(s): none yet.
28  *
29  * ***** END GPL LICENSE BLOCK *****
30  */
31 #ifndef BKE_MESH_H
32 #define BKE_MESH_H
33
34 /***/
35
36 struct BoundBox;
37 struct DispList;
38 struct ListBase;
39 struct EditMesh;
40 struct MDeformVert;
41 struct Mesh;
42 struct MFace;
43 struct MEdge;
44 struct MVert;
45 struct MCol;
46 struct BMesh;
47 struct Object;
48 struct MTFace;
49 struct VecNor;
50 struct CustomData;
51
52 #ifdef __cplusplus
53 extern "C" {
54 #endif
55
56 struct EditMesh *BKE_mesh_get_editmesh(struct Mesh *me);
57 void BKE_mesh_end_editmesh(struct Mesh *me, struct EditMesh *em);
58 struct BMesh *BKE_mesh_to_bmesh(struct Mesh *me, struct Object *ob);
59
60 /*
61   this function recreates a tesselation.
62   returns number of tesselation faces.
63  */
64 int mesh_recalcTesselation(struct CustomData *fdata, struct CustomData *ldata, 
65         struct CustomData *pdata, struct MVert *mvert, int totface, 
66         int totloop, int totpoly);
67
68 /*calculates a face normal.*/
69 void mesh_calc_poly_normal(struct MPoly *mpoly, struct MLoop *loopstart, 
70                            struct MVert *mvarray, float *no);
71
72 void unlink_mesh(struct Mesh *me);
73 void free_mesh(struct Mesh *me, int unlink);
74 struct Mesh *add_mesh(char *name);
75 struct Mesh *copy_mesh(struct Mesh *me);
76 void mesh_update_customdata_pointers(struct Mesh *me);
77
78 /*this ensures grouped customdata (e.g. mtexpoly and mloopuv and mtface, or
79   mloopcol and mcol) have the same relative active/render/clone/mask indices.*/
80 void mesh_update_linked_customdata(struct Mesh *me);
81
82 void make_local_tface(struct Mesh *me);
83 void make_local_mesh(struct Mesh *me);
84 void boundbox_mesh(struct Mesh *me, float *loc, float *size);
85 void tex_space_mesh(struct Mesh *me);
86 float *get_mesh_orco_verts(struct Object *ob);
87 void transform_mesh_orco_verts(struct Mesh *me, float (*orco)[3], int totvert, int invert);
88 int test_index_face(struct MFace *mface, struct CustomData *mfdata, int mfindex, int nr);
89 struct Mesh *get_mesh(struct Object *ob);
90 void set_mesh(struct Object *ob, struct Mesh *me);
91 void mball_to_mesh(struct ListBase *lb, struct Mesh *me);
92 void nurbs_to_mesh(struct Object *ob);
93 void mesh_to_curve(struct Scene *scene, struct Object *ob);
94 void free_dverts(struct MDeformVert *dvert, int totvert);
95 void copy_dverts(struct MDeformVert *dst, struct MDeformVert *src, int totvert); /* __NLA */
96 void mesh_delete_material_index(struct Mesh *me, int index);
97 void mesh_set_smooth_flag(struct Object *meshOb, int enableSmooth);
98
99 struct BoundBox *mesh_get_bb(struct Object *ob);
100 void mesh_get_texspace(struct Mesh *me, float *loc_r, float *rot_r, float *size_r);
101
102 /* if old, it converts mface->edcode to edge drawflags */
103 void make_edges(struct Mesh *me, int old);
104 void mesh_strip_loose_faces(struct Mesh *me);
105
106         /* Calculate vertex and face normals, face normals are returned in *faceNors_r if non-NULL
107          * and vertex normals are stored in actual mverts.
108          */
109 void mesh_calc_normals(struct MVert *mverts, int numVerts, struct MFace *mfaces, int numFaces, float **faceNors_r);
110
111         /* Return a newly MEM_malloc'd array of all the mesh vertex locations
112          * (_numVerts_r_ may be NULL) */
113 float (*mesh_getVertexCos(struct Mesh *me, int *numVerts_r))[3];
114
115 /* map from uv vertex to face (for select linked, stitch, uv suburf) */
116
117 /* UvVertMap */
118
119 #define STD_UV_CONNECT_LIMIT    0.0001f
120
121 typedef struct UvVertMap {
122         struct UvMapVert **vert;
123         struct UvMapVert *buf;
124 } UvVertMap;
125
126 typedef struct UvMapVert {
127         struct UvMapVert *next;
128         unsigned int f;
129         unsigned char tfindex, separate, flag;
130 } UvMapVert;
131
132 UvVertMap *make_uv_vert_map(struct MFace *mface, struct MTFace *tface, unsigned int totface, unsigned int totvert, int selected, float *limit);
133 UvMapVert *get_uv_map_vert(UvVertMap *vmap, unsigned int v);
134 void free_uv_vert_map(UvVertMap *vmap);
135
136 /* Connectivity data */
137 typedef struct IndexNode {
138         struct IndexNode *next, *prev;
139         int index;
140 } IndexNode;
141 void create_vert_face_map(ListBase **map, IndexNode **mem, const struct MFace *mface,
142                           const int totvert, const int totface);
143 void create_vert_edge_map(ListBase **map, IndexNode **mem, const struct MEdge *medge,
144                           const int totvert, const int totedge);
145
146 /* Partial Mesh Visibility */
147 struct PartialVisibility *mesh_pmv_copy(struct PartialVisibility *);
148 void mesh_pmv_free(struct PartialVisibility *);
149 void mesh_pmv_revert(struct Object *ob, struct Mesh *me);
150 void mesh_pmv_off(struct Object *ob, struct Mesh *me);
151
152 /* functions for making menu's from customdata layers */
153 int mesh_layers_menu_charlen(struct CustomData *data, int type); /* use this to work out how many chars to allocate */
154 void mesh_layers_menu_concat(struct CustomData *data, int type, char *str);
155 int mesh_layers_menu(struct CustomData *data, int type);
156
157 #ifdef __cplusplus
158 }
159 #endif
160
161 #endif
162