cf0e6eb01c3aa92f6e00f2d5c2af82d72e42d290
[blender.git] / source / blender / editors / include / ED_mesh.h
1 /**
2  * $Id:
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version. 
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  *
20  * The Original Code is Copyright (C) 2008 Blender Foundation.
21  * All rights reserved.
22  *
23  * 
24  * Contributor(s): Blender Foundation
25  *
26  * ***** END GPL LICENSE BLOCK *****
27  */
28 #ifndef ED_MESH_H
29 #define ED_MESH_H
30
31 struct ID;
32 struct View3D;
33 struct ARegion;
34 struct EditMesh;
35 struct EditVert;
36 struct EditEdge;
37 struct EditFace;
38 struct bContext;
39 struct wmOperator;
40 struct wmWindowManager;
41 struct wmKeyConfig;
42 struct ReportList;
43 struct EditSelection;
44 struct ViewContext;
45 struct bDeformGroup;
46 struct MDeformWeight;
47 struct MDeformVert;
48 struct Scene;
49 struct Mesh;
50 struct MCol;
51 struct UvVertMap;
52 struct UvMapVert;
53 struct CustomData;
54 struct Material;
55 struct Object;
56
57 #define EM_FGON_DRAW    1 // face flag
58 #define EM_FGON                 2 // edge and face flag both
59
60 /* editbutflag */
61 #define B_CLOCKWISE                     1
62 #define B_KEEPORIG                      2
63 #define B_BEAUTY                        4
64 #define B_SMOOTH                        8
65 #define B_BEAUTY_SHORT          0x10
66 #define B_AUTOFGON                      0x20
67 #define B_KNIFE                         0x80
68 #define B_PERCENTSUBD           0x40
69 #define B_MESH_X_MIRROR         0x100
70 #define B_JOINTRIA_UV           0x200
71 #define B_JOINTRIA_VCOL         0X400
72 #define B_JOINTRIA_SHARP        0X800
73 #define B_JOINTRIA_MAT          0X1000
74 #define B_FRACTAL                       0x2000
75 #define B_SPHERE                        0x4000
76
77 /* meshtools.c */
78
79 intptr_t        mesh_octree_table(struct Object *ob, struct EditMesh *em, float *co, char mode);
80 struct EditVert   *editmesh_get_x_mirror_vert(struct Object *ob, struct EditMesh *em, float *co);
81 int                     mesh_get_x_mirror_vert(struct Object *ob, int index);
82 int                     *mesh_get_x_mirror_faces(struct Object *ob, struct EditMesh *em);
83
84 int                     join_mesh_exec(struct bContext *C, struct wmOperator *op);
85
86 /* mesh_ops.c */
87 void            ED_operatortypes_mesh(void);
88 void            ED_keymap_mesh(struct wmKeyConfig *keyconf);
89
90
91 /* editmesh.c */
92
93 void            ED_spacetypes_init(void);
94 void            ED_keymap_mesh(struct wmKeyConfig *keyconf);
95
96 void            make_editMesh(struct Scene *scene, struct Object *ob);
97 void            load_editMesh(struct Scene *scene, struct Object *ob);
98 void            remake_editMesh(struct Scene *scene, struct Object *ob);
99 void            free_editMesh(struct EditMesh *em);
100
101 void            recalc_editnormals(struct EditMesh *em);
102
103 void            EM_init_index_arrays(struct EditMesh *em, int forVert, int forEdge, int forFace);
104 void            EM_free_index_arrays(void);
105 struct EditVert *EM_get_vert_for_index(int index);
106 struct EditEdge *EM_get_edge_for_index(int index);
107 struct EditFace *EM_get_face_for_index(int index);
108 int                     EM_texFaceCheck(struct EditMesh *em);
109 int                     EM_vertColorCheck(struct EditMesh *em);
110
111 void            undo_push_mesh(struct bContext *C, char *name);
112
113
114 /* editmesh_lib.c */
115
116 struct EditFace *EM_get_actFace(struct EditMesh *em, int sloppy);
117 void             EM_set_actFace(struct EditMesh *em, struct EditFace *efa);
118 float            EM_face_area(struct EditFace *efa);
119
120 void            EM_select_edge(struct EditEdge *eed, int sel);
121 void            EM_select_face(struct EditFace *efa, int sel);
122 void            EM_select_face_fgon(struct EditMesh *em, struct EditFace *efa, int val);
123 void            EM_select_swap(struct EditMesh *em);
124 void            EM_toggle_select_all(struct EditMesh *em);
125 void            EM_select_all(struct EditMesh *em);
126 void            EM_selectmode_flush(struct EditMesh *em);
127 void            EM_deselect_flush(struct EditMesh *em);
128 void            EM_selectmode_set(struct EditMesh *em);
129 void            EM_select_flush(struct EditMesh *em);
130 void            EM_convertsel(struct EditMesh *em, short oldmode, short selectmode);
131 void            EM_validate_selections(struct EditMesh *em);
132
133                         /* exported to transform */
134 int                     EM_get_actSelection(struct EditMesh *em, struct EditSelection *ese);
135 void            EM_editselection_normal(float *normal, struct EditSelection *ese);
136 void            EM_editselection_plane(float *plane, struct EditSelection *ese);
137 void            EM_editselection_center(float *center, struct EditSelection *ese);                      
138
139 struct UvVertMap *EM_make_uv_vert_map(struct EditMesh *em, int selected, int do_face_idx_array, float *limit);
140 struct UvMapVert *EM_get_uv_map_vert(struct UvVertMap *vmap, unsigned int v);
141 void              EM_free_uv_vert_map(struct UvVertMap *vmap);
142
143 void            EM_add_data_layer(struct EditMesh *em, struct CustomData *data, int type);
144 void            EM_free_data_layer(struct EditMesh *em, struct CustomData *data, int type);
145
146 /* editmesh_mods.c */
147 extern unsigned int em_vertoffs, em_solidoffs, em_wireoffs;
148
149 void            mouse_mesh(struct bContext *C, short mval[2], short extend);
150 int                     EM_check_backbuf(unsigned int index);
151 int                     EM_mask_init_backbuf_border(struct ViewContext *vc, short mcords[][2], short tot, short xmin, short ymin, short xmax, short ymax);
152 void            EM_free_backbuf(void);
153 int                     EM_init_backbuf_border(struct ViewContext *vc, short xmin, short ymin, short xmax, short ymax);
154 int                     EM_init_backbuf_circle(struct ViewContext *vc, short xs, short ys, short rads);
155
156 void            EM_hide_mesh(struct EditMesh *em, int swap);
157 void            EM_reveal_mesh(struct EditMesh *em);
158
159 void            EM_select_by_material(struct EditMesh *em, int index);
160 void            EM_deselect_by_material(struct EditMesh *em, int index); 
161
162 /* editface.c */
163 struct MTFace   *EM_get_active_mtface(struct EditMesh *em, struct EditFace **act_efa, struct MCol **mcol, int sloppy);
164
165 /* object_vgroup.c */
166
167 #define WEIGHT_REPLACE 1
168 #define WEIGHT_ADD 2
169 #define WEIGHT_SUBTRACT 3
170
171 struct bDeformGroup             *ED_vgroup_add(struct Object *ob);
172 struct bDeformGroup             *ED_vgroup_add_name(struct Object *ob, char *name);
173 void                                    ED_vgroup_select_by_name(struct Object *ob, char *name);
174 void                                    ED_vgroup_data_create(struct ID *id);
175
176 void            ED_vgroup_vert_add(struct Object *ob, struct bDeformGroup *dg, int vertnum,  float weight, int assignmode);
177 void            ED_vgroup_vert_remove(struct Object *ob, struct bDeformGroup *dg, int vertnum);
178 float           ED_vgroup_vert_weight(struct Object *ob, struct bDeformGroup *dg, int vertnum);
179
180 struct MDeformWeight    *ED_vgroup_weight_verify(struct MDeformVert *dv, int defgroup);
181 struct MDeformWeight    *ED_vgroup_weight_get(struct MDeformVert *dv, int defgroup);
182
183 /*needed by edge slide*/
184 struct EditVert *editedge_getOtherVert(struct EditEdge *eed, struct EditVert *eve);
185 struct EditVert *editedge_getSharedVert(struct EditEdge *eed, struct EditEdge *eed2);
186 int editedge_containsVert(struct EditEdge *eed, struct EditVert *eve);
187 int editface_containsVert(struct EditFace *efa, struct EditVert *eve);
188 int editface_containsEdge(struct EditFace *efa, struct EditEdge *eed);
189 short sharesFace(struct EditMesh *em, struct EditEdge *e1, struct EditEdge *e2);
190
191 /* mesh_data.c */
192
193 void ED_mesh_geometry_add(struct Mesh *mesh, struct ReportList *reports, int verts, int edges, int faces);
194 void ED_mesh_transform(struct Mesh *me, float *mat);
195 void ED_mesh_calc_normals(struct Mesh *me);
196 void ED_mesh_material_add(struct Mesh *me, struct Material *ma);
197 void ED_mesh_update(struct Mesh *mesh, struct bContext *C);
198
199 int ED_mesh_uv_texture_add(struct bContext *C, struct Scene *scene, struct Object *ob, struct Mesh *me);
200 int ED_mesh_uv_texture_remove(struct bContext *C, struct Object *ob, struct Mesh *me);
201 int ED_mesh_color_add(struct bContext *C, struct Scene *scene, struct Object *ob, struct Mesh *me);
202 int ED_mesh_color_remove(struct bContext *C, struct Object *ob, struct Mesh *me);
203
204 #endif /* ED_MESH_H */
205