set origin was setting surfaces as 2D curves, added dupli-group support using the...
[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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 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 Object;
47 struct MTFace;
48 struct VecNor;
49 struct CustomData;
50
51 #ifdef __cplusplus
52 extern "C" {
53 #endif
54
55 struct EditMesh *BKE_mesh_get_editmesh(struct Mesh *me);
56 void BKE_mesh_end_editmesh(struct Mesh *me, struct EditMesh *em);
57
58 void unlink_mesh(struct Mesh *me);
59 void free_mesh(struct Mesh *me);
60 struct Mesh *add_mesh(char *name);
61 struct Mesh *copy_mesh(struct Mesh *me);
62 void mesh_update_customdata_pointers(struct Mesh *me);
63 void make_local_tface(struct Mesh *me);
64 void make_local_mesh(struct Mesh *me);
65 void boundbox_mesh(struct Mesh *me, float *loc, float *size);
66 void tex_space_mesh(struct Mesh *me);
67 float *get_mesh_orco_verts(struct Object *ob);
68 void transform_mesh_orco_verts(struct Mesh *me, float (*orco)[3], int totvert, int invert);
69 int test_index_face(struct MFace *mface, struct CustomData *mfdata, int mfindex, int nr);
70 struct Mesh *get_mesh(struct Object *ob);
71 void set_mesh(struct Object *ob, struct Mesh *me);
72 void mball_to_mesh(struct ListBase *lb, struct Mesh *me);
73 int nurbs_to_mdata(struct Object *ob, struct MVert **allvert, int *_totvert,
74         struct MEdge **alledge, int *_totedge, struct MFace **allface, int *_totface);
75 int nurbs_to_mdata_customdb(struct Object *ob, struct ListBase *dispbase,
76         struct MVert **allvert, int *_totvert, struct MEdge **alledge, int *_totedge,
77         struct MFace **allface, int *_totface);
78 void nurbs_to_mesh(struct Object *ob);
79 void mesh_to_curve(struct Scene *scene, struct Object *ob);
80 void free_dverts(struct MDeformVert *dvert, int totvert);
81 void copy_dverts(struct MDeformVert *dst, struct MDeformVert *src, int totvert); /* __NLA */
82 void mesh_delete_material_index(struct Mesh *me, int index);
83 void mesh_set_smooth_flag(struct Object *meshOb, int enableSmooth);
84
85 struct BoundBox *mesh_get_bb(struct Object *ob);
86 void mesh_get_texspace(struct Mesh *me, float *loc_r, float *rot_r, float *size_r);
87
88 /* if old, it converts mface->edcode to edge drawflags */
89 void make_edges(struct Mesh *me, int old);
90 void mesh_strip_loose_faces(struct Mesh *me);
91
92         /* Calculate vertex and face normals, face normals are returned in *faceNors_r if non-NULL
93          * and vertex normals are stored in actual mverts.
94          */
95 void mesh_calc_normals(struct MVert *mverts, int numVerts, struct MFace *mfaces, int numFaces, float **faceNors_r);
96
97         /* Return a newly MEM_malloc'd array of all the mesh vertex locations
98          * (_numVerts_r_ may be NULL) */
99 float (*mesh_getVertexCos(struct Mesh *me, int *numVerts_r))[3];
100
101 /* map from uv vertex to face (for select linked, stitch, uv suburf) */
102
103 /* UvVertMap */
104
105 #define STD_UV_CONNECT_LIMIT    0.0001f
106
107 typedef struct UvVertMap {
108         struct UvMapVert **vert;
109         struct UvMapVert *buf;
110 } UvVertMap;
111
112 typedef struct UvMapVert {
113         struct UvMapVert *next;
114         unsigned int f;
115         unsigned char tfindex, separate, flag;
116 } UvMapVert;
117
118 UvVertMap *make_uv_vert_map(struct MFace *mface, struct MTFace *tface, unsigned int totface, unsigned int totvert, int selected, float *limit);
119 UvMapVert *get_uv_map_vert(UvVertMap *vmap, unsigned int v);
120 void free_uv_vert_map(UvVertMap *vmap);
121
122 /* Connectivity data */
123 typedef struct IndexNode {
124         struct IndexNode *next, *prev;
125         int index;
126 } IndexNode;
127 void create_vert_face_map(ListBase **map, IndexNode **mem, const struct MFace *mface,
128                           const int totvert, const int totface);
129 void create_vert_edge_map(ListBase **map, IndexNode **mem, const struct MEdge *medge,
130                           const int totvert, const int totedge);
131
132 /* Partial Mesh Visibility */
133 struct PartialVisibility *mesh_pmv_copy(struct PartialVisibility *);
134 void mesh_pmv_free(struct PartialVisibility *);
135 void mesh_pmv_revert(struct Object *ob, struct Mesh *me);
136 void mesh_pmv_off(struct Object *ob, struct Mesh *me);
137
138 /* functions for making menu's from customdata layers */
139 int mesh_layers_menu_charlen(struct CustomData *data, int type); /* use this to work out how many chars to allocate */
140 void mesh_layers_menu_concat(struct CustomData *data, int type, char *str);
141 int mesh_layers_menu(struct CustomData *data, int type);
142
143 /* vertex level transformations & checks (no derived mesh) */
144
145 int minmax_mesh(struct Mesh *me, float min[3], float max[3]);
146 int mesh_center_median(struct Mesh *me, float cent[3]);
147 int mesh_center_bounds(struct Mesh *me, float cent[3]);
148 void mesh_translate(struct Mesh *me, float offset[3], int do_keys);
149
150 #ifdef __cplusplus
151 }
152 #endif
153
154 #endif
155