doxygen: prevent GPL license block from being parsed as doxygen comment.
[blender.git] / source / blender / editors / mesh / mesh_ops.c
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19  *
20  * The Original Code is Copyright (C) 2009 Blender Foundation.
21  * All rights reserved.
22  *
23  * 
24  * Contributor(s): Blender Foundation
25  *
26  * ***** END GPL LICENSE BLOCK *****
27  */
28
29 #include <stdlib.h>
30 #include <math.h>
31
32
33 #include "DNA_object_types.h"
34 #include "DNA_scene_types.h"
35
36 #include "BLI_math.h"
37 #include "BLI_blenlib.h"
38 #include "BLI_editVert.h"
39
40 #include "BKE_context.h"
41
42 #include "RNA_access.h"
43
44 #include "WM_api.h"
45 #include "WM_types.h"
46
47 #include "ED_object.h"
48 #include "ED_mesh.h"
49 #include "ED_screen.h"
50 #include "ED_view3d.h"
51
52
53 #include "mesh_intern.h"
54
55 /**************************** registration **********************************/
56
57 void ED_operatortypes_mesh(void)
58 {
59         WM_operatortype_append(MESH_OT_select_all);
60         WM_operatortype_append(MESH_OT_select_more);
61         WM_operatortype_append(MESH_OT_select_less);
62         WM_operatortype_append(MESH_OT_select_inverse);
63         WM_operatortype_append(MESH_OT_select_non_manifold);
64         WM_operatortype_append(MESH_OT_select_linked);
65         WM_operatortype_append(MESH_OT_select_linked_pick);
66         WM_operatortype_append(MESH_OT_select_random);
67         WM_operatortype_append(MESH_OT_hide);
68         WM_operatortype_append(MESH_OT_reveal);
69         WM_operatortype_append(MESH_OT_select_by_number_vertices);
70         WM_operatortype_append(MESH_OT_select_mirror);
71         WM_operatortype_append(MESH_OT_normals_make_consistent);
72         WM_operatortype_append(MESH_OT_merge);
73         WM_operatortype_append(MESH_OT_subdivide);
74         WM_operatortype_append(MESH_OT_faces_select_linked_flat);
75         WM_operatortype_append(MESH_OT_edges_select_sharp);
76         WM_operatortype_append(MESH_OT_primitive_plane_add);
77         WM_operatortype_append(MESH_OT_primitive_cube_add);
78         WM_operatortype_append(MESH_OT_primitive_circle_add);
79         WM_operatortype_append(MESH_OT_primitive_cylinder_add);
80         WM_operatortype_append(MESH_OT_primitive_cone_add);
81         WM_operatortype_append(MESH_OT_primitive_grid_add);
82         WM_operatortype_append(MESH_OT_primitive_monkey_add);
83         WM_operatortype_append(MESH_OT_primitive_uv_sphere_add);
84         WM_operatortype_append(MESH_OT_primitive_ico_sphere_add);
85         WM_operatortype_append(MESH_OT_fgon_clear);
86         WM_operatortype_append(MESH_OT_fgon_make);
87         WM_operatortype_append(MESH_OT_duplicate);
88         WM_operatortype_append(MESH_OT_remove_doubles);
89         WM_operatortype_append(MESH_OT_vertices_sort);
90         WM_operatortype_append(MESH_OT_vertices_randomize);
91         WM_operatortype_append(MESH_OT_extrude);
92         WM_operatortype_append(MESH_OT_spin);
93         WM_operatortype_append(MESH_OT_screw);
94         
95         WM_operatortype_append(MESH_OT_split);
96         WM_operatortype_append(MESH_OT_extrude_repeat);
97         WM_operatortype_append(MESH_OT_edge_rotate);
98         WM_operatortype_append(MESH_OT_select_vertex_path);
99         WM_operatortype_append(MESH_OT_loop_to_region);
100         WM_operatortype_append(MESH_OT_region_to_loop);
101         WM_operatortype_append(MESH_OT_select_axis);
102         
103         WM_operatortype_append(MESH_OT_uvs_rotate);
104         WM_operatortype_append(MESH_OT_uvs_mirror);
105         WM_operatortype_append(MESH_OT_colors_rotate);
106         WM_operatortype_append(MESH_OT_colors_mirror);
107         
108         WM_operatortype_append(MESH_OT_fill);
109         WM_operatortype_append(MESH_OT_beautify_fill);
110         WM_operatortype_append(MESH_OT_quads_convert_to_tris);
111         WM_operatortype_append(MESH_OT_tris_convert_to_quads);
112         WM_operatortype_append(MESH_OT_edge_flip);
113         WM_operatortype_append(MESH_OT_faces_shade_smooth);
114         WM_operatortype_append(MESH_OT_faces_shade_flat);
115         WM_operatortype_append(MESH_OT_sort_faces);
116
117         WM_operatortype_append(MESH_OT_delete);
118
119         WM_operatortype_append(MESH_OT_separate);
120         WM_operatortype_append(MESH_OT_dupli_extrude_cursor);
121         WM_operatortype_append(MESH_OT_loop_select);
122         WM_operatortype_append(MESH_OT_edge_face_add);
123         WM_operatortype_append(MESH_OT_select_shortest_path);
124         WM_operatortype_append(MESH_OT_select_similar);
125         WM_operatortype_append(MESH_OT_loop_multi_select);
126         WM_operatortype_append(MESH_OT_mark_seam);
127         WM_operatortype_append(MESH_OT_mark_sharp);
128         WM_operatortype_append(MESH_OT_vertices_smooth);
129         WM_operatortype_append(MESH_OT_noise);
130         WM_operatortype_append(MESH_OT_flip_normals);
131         WM_operatortype_append(MESH_OT_knife_cut);
132         WM_operatortype_append(MESH_OT_rip);
133         WM_operatortype_append(MESH_OT_blend_from_shape);
134         WM_operatortype_append(MESH_OT_shape_propagate_to_all);
135         
136         WM_operatortype_append(MESH_OT_uv_texture_add);
137         WM_operatortype_append(MESH_OT_uv_texture_remove);
138         WM_operatortype_append(MESH_OT_vertex_color_add);
139         WM_operatortype_append(MESH_OT_vertex_color_remove);
140         WM_operatortype_append(MESH_OT_sticky_add);
141         WM_operatortype_append(MESH_OT_sticky_remove);
142         WM_operatortype_append(MESH_OT_drop_named_image);
143
144         WM_operatortype_append(MESH_OT_edgering_select);
145         WM_operatortype_append(MESH_OT_loopcut);
146
147         WM_operatortype_append(MESH_OT_solidify);
148         WM_operatortype_append(MESH_OT_select_nth);
149 }
150
151 #if 0 /* UNUSED, remove? */
152 static int ED_operator_editmesh_face_select(bContext *C)
153 {
154         Object *obedit= CTX_data_edit_object(C);
155         if(obedit && obedit->type==OB_MESH) {
156                 EditMesh *em = ((Mesh *)obedit->data)->edit_mesh;
157                 if (em && em->selectmode & SCE_SELECT_FACE) {
158                         return 1;
159                 }
160         }
161         return 0;
162 }
163 #endif
164
165 void ED_operatormacros_mesh(void)
166 {
167         wmOperatorType *ot;
168         wmOperatorTypeMacro *otmacro;
169         
170         ot= WM_operatortype_append_macro("MESH_OT_loopcut_slide", "Loop Cut and Slide", OPTYPE_UNDO|OPTYPE_REGISTER);
171         ot->description = "Cut mesh loop and slide it";
172         WM_operatortype_macro_define(ot, "MESH_OT_loopcut");
173         WM_operatortype_macro_define(ot, "TRANSFORM_OT_edge_slide");
174
175         ot= WM_operatortype_append_macro("MESH_OT_duplicate_move", "Add Duplicate", OPTYPE_UNDO|OPTYPE_REGISTER);
176         ot->description = "Duplicate mesh and move";
177         WM_operatortype_macro_define(ot, "MESH_OT_duplicate");
178         otmacro= WM_operatortype_macro_define(ot, "TRANSFORM_OT_translate");
179         RNA_enum_set(otmacro->ptr, "proportional", 0);
180         RNA_boolean_set(otmacro->ptr, "mirror", 0);
181
182         ot= WM_operatortype_append_macro("MESH_OT_rip_move", "Rip", OPTYPE_UNDO|OPTYPE_REGISTER);
183         ot->description = "Rip polygons and move the result";
184         WM_operatortype_macro_define(ot, "MESH_OT_rip");
185         otmacro= WM_operatortype_macro_define(ot, "TRANSFORM_OT_translate");
186         RNA_enum_set(otmacro->ptr, "proportional", 0);
187         RNA_boolean_set(otmacro->ptr, "mirror", 0);
188
189         ot= WM_operatortype_append_macro("MESH_OT_extrude_region_move", "Extrude Region and Move", OPTYPE_UNDO|OPTYPE_REGISTER);
190         ot->description = "Extrude region and move result";
191         otmacro= WM_operatortype_macro_define(ot, "MESH_OT_extrude");
192         RNA_enum_set(otmacro->ptr, "type", 1);
193         otmacro= WM_operatortype_macro_define(ot, "TRANSFORM_OT_translate");
194         RNA_enum_set(otmacro->ptr, "proportional", 0);
195         RNA_boolean_set(otmacro->ptr, "mirror", 0);
196
197         ot= WM_operatortype_append_macro("MESH_OT_extrude_faces_move", "Extrude Individual Faces and Move", OPTYPE_UNDO|OPTYPE_REGISTER);
198         ot->description = "Extrude faces and move result";
199         otmacro= WM_operatortype_macro_define(ot, "MESH_OT_extrude");
200         RNA_enum_set(otmacro->ptr, "type", 2);
201         otmacro= WM_operatortype_macro_define(ot, "TRANSFORM_OT_shrink_fatten");
202         RNA_enum_set(otmacro->ptr, "proportional", 0);
203         RNA_boolean_set(otmacro->ptr, "mirror", 0);
204
205         ot= WM_operatortype_append_macro("MESH_OT_extrude_edges_move", "Extrude Only Edges and Move", OPTYPE_UNDO|OPTYPE_REGISTER);
206         ot->description = "Extrude edges and move result";
207         otmacro= WM_operatortype_macro_define(ot, "MESH_OT_extrude");
208         RNA_enum_set(otmacro->ptr, "type", 3);
209         otmacro= WM_operatortype_macro_define(ot, "TRANSFORM_OT_translate");
210         RNA_enum_set(otmacro->ptr, "proportional", 0);
211         RNA_boolean_set(otmacro->ptr, "mirror", 0);
212
213         ot= WM_operatortype_append_macro("MESH_OT_extrude_vertices_move", "Extrude Only Vertices and Move", OPTYPE_UNDO|OPTYPE_REGISTER);
214         ot->description = "Extrude vertices and move result";
215         otmacro= WM_operatortype_macro_define(ot, "MESH_OT_extrude");
216         RNA_enum_set(otmacro->ptr, "type", 4);
217         otmacro= WM_operatortype_macro_define(ot, "TRANSFORM_OT_translate");
218         RNA_enum_set(otmacro->ptr, "proportional", 0);
219         RNA_boolean_set(otmacro->ptr, "mirror", 0);
220 }
221
222 /* note mesh keymap also for other space? */
223 void ED_keymap_mesh(wmKeyConfig *keyconf)
224 {       
225         wmKeyMap *keymap;
226         wmKeyMapItem *kmi;
227         
228         keymap= WM_keymap_find(keyconf, "Mesh", 0, 0);
229         keymap->poll= ED_operator_editmesh;
230         
231         WM_keymap_add_item(keymap, "MESH_OT_loopcut_slide", RKEY, KM_PRESS, KM_CTRL, 0);
232
233         /* selecting */
234         /* standard mouse selection goes via space_view3d */
235         WM_keymap_add_item(keymap, "MESH_OT_loop_select", SELECTMOUSE, KM_PRESS, KM_ALT, 0);
236         kmi= WM_keymap_add_item(keymap, "MESH_OT_loop_select", SELECTMOUSE, KM_PRESS, KM_SHIFT|KM_ALT, 0);
237         RNA_boolean_set(kmi->ptr, "extend", 1);
238
239         WM_keymap_add_item(keymap, "MESH_OT_edgering_select", SELECTMOUSE, KM_PRESS, KM_ALT|KM_CTRL, 0);
240         kmi= WM_keymap_add_item(keymap, "MESH_OT_edgering_select", SELECTMOUSE, KM_PRESS, KM_SHIFT|KM_ALT|KM_CTRL, 0);
241         RNA_boolean_set(kmi->ptr, "extend", 1);
242
243         WM_keymap_add_item(keymap, "MESH_OT_select_shortest_path", SELECTMOUSE, KM_PRESS, KM_CTRL, 0);
244
245         WM_keymap_add_item(keymap, "MESH_OT_select_all", AKEY, KM_PRESS, 0, 0);
246         WM_keymap_add_item(keymap, "MESH_OT_select_more", PADPLUSKEY, KM_PRESS, KM_CTRL, 0);
247         WM_keymap_add_item(keymap, "MESH_OT_select_less", PADMINUS, KM_PRESS, KM_CTRL, 0);
248         WM_keymap_add_item(keymap, "MESH_OT_select_inverse", IKEY, KM_PRESS, KM_CTRL, 0);
249         WM_keymap_add_item(keymap, "MESH_OT_select_non_manifold", MKEY, KM_PRESS, (KM_CTRL|KM_SHIFT|KM_ALT), 0);
250         
251         WM_keymap_add_item(keymap, "MESH_OT_select_linked", LKEY, KM_PRESS, KM_CTRL, 0);
252         WM_keymap_add_item(keymap, "MESH_OT_select_linked_pick", LKEY, KM_PRESS, 0, 0);
253         RNA_boolean_set(WM_keymap_add_item(keymap, "MESH_OT_select_linked_pick", LKEY, KM_PRESS, KM_SHIFT, 0)->ptr, "deselect", 1);
254         
255         WM_keymap_add_item(keymap, "MESH_OT_faces_select_linked_flat", FKEY, KM_PRESS, (KM_CTRL|KM_SHIFT|KM_ALT), 0);
256
257         WM_keymap_add_item(keymap, "MESH_OT_select_similar", GKEY, KM_PRESS, KM_SHIFT, 0);
258         
259         /* selection mode */
260         WM_keymap_add_menu(keymap, "VIEW3D_MT_edit_mesh_select_mode", TABKEY, KM_PRESS, KM_CTRL, 0);
261         
262         /* hide */
263         WM_keymap_add_item(keymap, "MESH_OT_hide", HKEY, KM_PRESS, 0, 0);
264         RNA_boolean_set(WM_keymap_add_item(keymap, "MESH_OT_hide", HKEY, KM_PRESS, KM_SHIFT, 0)->ptr, "unselected", 1);
265         WM_keymap_add_item(keymap, "MESH_OT_reveal", HKEY, KM_PRESS, KM_ALT, 0);
266
267         /* tools */
268         WM_keymap_add_item(keymap, "MESH_OT_normals_make_consistent", NKEY, KM_PRESS, KM_CTRL, 0);
269         RNA_boolean_set(WM_keymap_add_item(keymap, "MESH_OT_normals_make_consistent", NKEY, KM_PRESS, KM_SHIFT|KM_CTRL, 0)->ptr, "inside", 1);
270         
271         WM_keymap_add_item(keymap, "VIEW3D_OT_edit_mesh_extrude_move_normal", EKEY, KM_PRESS, 0, 0); /* python operator */
272         WM_keymap_add_menu(keymap, "VIEW3D_MT_edit_mesh_extrude", EKEY, KM_PRESS, KM_ALT, 0);
273         
274         WM_keymap_add_item(keymap, "TRANSFORM_OT_edge_crease", EKEY, KM_PRESS, KM_SHIFT, 0);
275         
276         WM_keymap_add_item(keymap, "MESH_OT_spin", RKEY, KM_PRESS, KM_ALT, 0);
277         
278         WM_keymap_add_item(keymap, "MESH_OT_fill", FKEY, KM_PRESS, KM_ALT, 0);
279         WM_keymap_add_item(keymap, "MESH_OT_beautify_fill", FKEY, KM_PRESS, KM_SHIFT|KM_ALT, 0);
280         WM_keymap_add_item(keymap, "MESH_OT_sort_faces", FKEY, KM_PRESS, KM_ALT|KM_CTRL, 0);
281         WM_keymap_add_item(keymap, "MESH_OT_quads_convert_to_tris", TKEY, KM_PRESS, KM_CTRL, 0);
282         WM_keymap_add_item(keymap, "MESH_OT_tris_convert_to_quads", JKEY, KM_PRESS, KM_ALT, 0);
283         WM_keymap_add_item(keymap, "MESH_OT_edge_flip", FKEY, KM_PRESS, KM_SHIFT|KM_CTRL, 0);
284
285         WM_keymap_add_item(keymap, "MESH_OT_rip_move",VKEY, KM_PRESS, 0, 0);
286         WM_keymap_add_item(keymap, "MESH_OT_merge", MKEY, KM_PRESS, KM_ALT, 0);
287
288         WM_keymap_add_item(keymap, "TRANSFORM_OT_shrink_fatten", SKEY, KM_PRESS, KM_ALT, 0);
289
290         /* add/remove */
291         WM_keymap_add_item(keymap, "MESH_OT_edge_face_add", FKEY, KM_PRESS, 0, 0);
292 //      WM_keymap_add_item(keymap, "MESH_OT_skin", FKEY, KM_PRESS, KM_CTRL|KM_ALT, 0); /* python, removed */
293         WM_keymap_add_item(keymap, "MESH_OT_duplicate_move", DKEY, KM_PRESS, KM_SHIFT, 0);
294         
295         WM_keymap_add_menu(keymap, "INFO_MT_mesh_add", AKEY, KM_PRESS, KM_SHIFT, 0);
296         
297         WM_keymap_add_item(keymap, "MESH_OT_separate", PKEY, KM_PRESS, 0, 0);
298         WM_keymap_add_item(keymap, "MESH_OT_split", YKEY, KM_PRESS, 0, 0);
299
300         /* use KM_CLICK because same key is used for tweaks */
301         WM_keymap_add_item(keymap, "MESH_OT_dupli_extrude_cursor", ACTIONMOUSE, KM_CLICK, KM_CTRL, 0);
302         RNA_boolean_set(WM_keymap_add_item(keymap, "MESH_OT_dupli_extrude_cursor", ACTIONMOUSE, KM_CLICK, KM_SHIFT|KM_CTRL, 0)->ptr, "rotate_source", 0);
303
304         WM_keymap_add_item(keymap, "MESH_OT_delete", XKEY, KM_PRESS, 0, 0);
305         WM_keymap_add_item(keymap, "MESH_OT_delete", DELKEY, KM_PRESS, 0, 0);
306         
307         WM_keymap_add_item(keymap, "MESH_OT_knife_cut", LEFTMOUSE, KM_PRESS, 0, KKEY);
308         RNA_enum_set(WM_keymap_add_item(keymap, "MESH_OT_knife_cut", LEFTMOUSE, KM_PRESS, KM_SHIFT, KKEY)->ptr, "type", 2/*KNIFE_MIDPOINT*/);
309         
310         WM_keymap_add_item(keymap, "OBJECT_OT_vertex_parent_set", PKEY, KM_PRESS, KM_CTRL, 0);
311
312         /* menus */
313         WM_keymap_add_menu(keymap, "VIEW3D_MT_edit_mesh_specials", WKEY, KM_PRESS, 0, 0);
314         WM_keymap_add_menu(keymap, "VIEW3D_MT_edit_mesh_faces", FKEY, KM_PRESS, KM_CTRL, 0);
315         WM_keymap_add_menu(keymap, "VIEW3D_MT_edit_mesh_edges", EKEY, KM_PRESS, KM_CTRL, 0);
316         WM_keymap_add_menu(keymap, "VIEW3D_MT_edit_mesh_vertices", VKEY, KM_PRESS, KM_CTRL, 0);
317         WM_keymap_add_menu(keymap, "VIEW3D_MT_hook", HKEY, KM_PRESS, KM_CTRL, 0);
318         WM_keymap_add_menu(keymap, "VIEW3D_MT_uv_map", UKEY, KM_PRESS, 0, 0);
319         WM_keymap_add_menu(keymap, "VIEW3D_MT_vertex_group", GKEY, KM_PRESS, KM_CTRL, 0);
320         
321         ED_object_generic_keymap(keyconf, keymap, 3);
322 }
323