merge with 2.5 (not trunk, last merge message said that on accident) at r22252
[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);
59
60 void unlink_mesh(struct Mesh *me);
61 void free_mesh(struct Mesh *me);
62 struct Mesh *add_mesh(char *name);
63 struct Mesh *copy_mesh(struct Mesh *me);
64 void mesh_update_customdata_pointers(struct Mesh *me);
65 void make_local_tface(struct Mesh *me);
66 void make_local_mesh(struct Mesh *me);
67 void boundbox_mesh(struct Mesh *me, float *loc, float *size);
68 void tex_space_mesh(struct Mesh *me);
69 float *get_mesh_orco_verts(struct Object *ob);
70 void transform_mesh_orco_verts(struct Mesh *me, float (*orco)[3], int totvert, int invert);
71 int test_index_face(struct MFace *mface, struct CustomData *mfdata, int mfindex, int nr);
72 struct Mesh *get_mesh(struct Object *ob);
73 void set_mesh(struct Object *ob, struct Mesh *me);
74 void mball_to_mesh(struct ListBase *lb, struct Mesh *me);
75 void nurbs_to_mesh(struct Object *ob);
76 void free_dverts(struct MDeformVert *dvert, int totvert);
77 void copy_dverts(struct MDeformVert *dst, struct MDeformVert *src, int totvert); /* __NLA */
78 void mesh_delete_material_index(struct Mesh *me, int index);
79 void mesh_set_smooth_flag(struct Object *meshOb, int enableSmooth);
80
81 struct BoundBox *mesh_get_bb(struct Object *ob);
82 void mesh_get_texspace(struct Mesh *me, float *loc_r, float *rot_r, float *size_r);
83
84 /* if old, it converts mface->edcode to edge drawflags */
85 void make_edges(struct Mesh *me, int old);
86 void mesh_strip_loose_faces(struct Mesh *me);
87
88         /* Calculate vertex and face normals, face normals are returned in *faceNors_r if non-NULL
89          * and vertex normals are stored in actual mverts.
90          */
91 void mesh_calc_normals(struct MVert *mverts, int numVerts, struct MFace *mfaces, int numFaces, float **faceNors_r);
92
93         /* Return a newly MEM_malloc'd array of all the mesh vertex locations
94          * (_numVerts_r_ may be NULL) */
95 float (*mesh_getVertexCos(struct Mesh *me, int *numVerts_r))[3];
96 float (*mesh_getRefKeyCos(struct Mesh *me, int *numVerts_r))[3];
97
98 /* map from uv vertex to face (for select linked, stitch, uv suburf) */
99
100 /* UvVertMap */
101
102 #define STD_UV_CONNECT_LIMIT    0.0001f
103
104 typedef struct UvVertMap {
105         struct UvMapVert **vert;
106         struct UvMapVert *buf;
107 } UvVertMap;
108
109 typedef struct UvMapVert {
110         struct UvMapVert *next;
111         unsigned int f;
112         unsigned char tfindex, separate, flag;
113 } UvMapVert;
114
115 UvVertMap *make_uv_vert_map(struct MFace *mface, struct MTFace *tface, unsigned int totface, unsigned int totvert, int selected, float *limit);
116 UvMapVert *get_uv_map_vert(UvVertMap *vmap, unsigned int v);
117 void free_uv_vert_map(UvVertMap *vmap);
118
119 /* Connectivity data */
120 typedef struct IndexNode {
121         struct IndexNode *next, *prev;
122         int index;
123 } IndexNode;
124 void create_vert_face_map(ListBase **map, IndexNode **mem, const struct MFace *mface,
125                           const int totvert, const int totface);
126 void create_vert_edge_map(ListBase **map, IndexNode **mem, const struct MEdge *medge,
127                           const int totvert, const int totedge);
128
129 /* Partial Mesh Visibility */
130 struct PartialVisibility *mesh_pmv_copy(struct PartialVisibility *);
131 void mesh_pmv_free(struct PartialVisibility *);
132 void mesh_pmv_revert(struct Object *ob, struct Mesh *me);
133 void mesh_pmv_off(struct Object *ob, struct Mesh *me);
134
135 /* functions for making menu's from customdata layers */
136 int mesh_layers_menu_charlen(struct CustomData *data, int type); /* use this to work out how many chars to allocate */
137 void mesh_layers_menu_concat(struct CustomData *data, int type, char *str);
138 int mesh_layers_menu(struct CustomData *data, int type);
139
140 #ifdef __cplusplus
141 }
142 #endif
143
144 #endif
145