Project Pampa request: option to lock frame selection to the range
[blender.git] / source / blender / editors / animation / anim_ops.c
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version. 
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2008 Blender Foundation.
19  * All rights reserved.
20  *
21  * 
22  * Contributor(s): Blender Foundation, Joshua Leung
23  *
24  * ***** END GPL LICENSE BLOCK *****
25  */
26
27 /** \file blender/editors/animation/anim_ops.c
28  *  \ingroup edanimation
29  */
30
31
32 #include <stdlib.h>
33 #include <math.h>
34
35 #include "BLI_sys_types.h"
36
37 #include "BLI_utildefines.h"
38
39 #include "DNA_anim_types.h"
40 #include "DNA_scene_types.h"
41
42 #include "BKE_context.h"
43 #include "BKE_global.h"
44 #include "BKE_main.h"
45 #include "BKE_sound.h"
46
47 #include "UI_view2d.h"
48
49 #include "RNA_access.h"
50 #include "RNA_define.h"
51
52 #include "WM_api.h"
53 #include "WM_types.h"
54
55 #include "ED_anim_api.h"
56 #include "ED_screen.h"
57
58 #include "anim_intern.h"
59
60 /* ********************** frame change operator ***************************/
61
62 /* Check if the operator can be run from the current context */
63 static int change_frame_poll(bContext *C)
64 {
65         ScrArea *sa = CTX_wm_area(C);
66         
67         /* XXX temp? prevent changes during render */
68         if (G.is_rendering) return FALSE;
69         
70         /* although it's only included in keymaps for regions using ED_KEYMAP_ANIMATION,
71          * this shouldn't show up in 3D editor (or others without 2D timeline view) via search
72          */
73         if (sa) {
74                 if (ELEM5(sa->spacetype, SPACE_TIME, SPACE_ACTION, SPACE_NLA, SPACE_SEQ, SPACE_CLIP)) {
75                         return TRUE;
76                 }
77                 else if (sa->spacetype == SPACE_IPO) {
78                         /* NOTE: Graph Editor has special version which does some extra stuff.
79                          * No need to show the generic error message for that case though!
80                          */
81                         return FALSE;
82                 }
83         }
84         
85         CTX_wm_operator_poll_msg_set(C, "Expected an timeline/animation area to be active");
86         return FALSE;
87 }
88
89 /* Set the new frame number */
90 static void change_frame_apply(bContext *C, wmOperator *op)
91 {
92         Main *bmain = CTX_data_main(C);
93         Scene *scene = CTX_data_scene(C);
94         
95         /* set the new frame number */
96         CFRA = RNA_int_get(op->ptr, "frame");
97         FRAMENUMBER_MIN_CLAMP(CFRA);
98         SUBFRA = 0.0f;
99         
100         /* do updates */
101         sound_seek_scene(bmain, scene);
102         WM_event_add_notifier(C, NC_SCENE | ND_FRAME, scene);
103 }
104
105 /* ---- */
106
107 /* Non-modal callback for running operator without user input */
108 static int change_frame_exec(bContext *C, wmOperator *op)
109 {
110         change_frame_apply(C, op);
111
112         return OPERATOR_FINISHED;
113 }
114
115 /* ---- */
116
117 /* Get frame from mouse coordinates */
118 static int frame_from_event(bContext *C, const wmEvent *event)
119 {
120         ARegion *region = CTX_wm_region(C);
121         Scene *scene = CTX_data_scene(C);
122         float viewx;
123         int frame;
124
125         /* convert from region coordinates to View2D 'tot' space */
126         UI_view2d_region_to_view(&region->v2d, event->mval[0], event->mval[1], &viewx, NULL);
127         
128         /* round result to nearest int (frames are ints!) */
129         frame = (int)floor(viewx + 0.5f);
130
131         if (scene->r.flag & SCER_LOCK_FRAME_SELECTION) {
132                 CLAMP(frame, PSFRA, PEFRA);
133         }
134
135         return frame;
136 }
137
138 /* Modal Operator init */
139 static int change_frame_invoke(bContext *C, wmOperator *op, const wmEvent *event)
140 {
141         /* Change to frame that mouse is over before adding modal handler,
142          * as user could click on a single frame (jump to frame) as well as
143          * click-dragging over a range (modal scrubbing).
144          */
145         RNA_int_set(op->ptr, "frame", frame_from_event(C, event));
146         
147         change_frame_apply(C, op);
148         
149         /* add temp handler */
150         WM_event_add_modal_handler(C, op);
151
152         return OPERATOR_RUNNING_MODAL;
153 }
154
155 /* Modal event handling of frame changing */
156 static int change_frame_modal(bContext *C, wmOperator *op, const wmEvent *event)
157 {
158         /* execute the events */
159         switch (event->type) {
160                 case ESCKEY:
161                         return OPERATOR_FINISHED;
162                 
163                 case MOUSEMOVE:
164                         RNA_int_set(op->ptr, "frame", frame_from_event(C, event));
165                         change_frame_apply(C, op);
166                         break;
167                 
168                 case LEFTMOUSE: 
169                 case RIGHTMOUSE:
170                         /* we check for either mouse-button to end, as checking for ACTIONMOUSE (which is used to init 
171                          * the modal op) doesn't work for some reason
172                          */
173                         if (event->val == KM_RELEASE)
174                                 return OPERATOR_FINISHED;
175                         break;
176         }
177
178         return OPERATOR_RUNNING_MODAL;
179 }
180
181 static void ANIM_OT_change_frame(wmOperatorType *ot)
182 {
183         /* identifiers */
184         ot->name = "Change Frame";
185         ot->idname = "ANIM_OT_change_frame";
186         ot->description = "Interactively change the current frame number";
187         
188         /* api callbacks */
189         ot->exec = change_frame_exec;
190         ot->invoke = change_frame_invoke;
191         ot->modal = change_frame_modal;
192         ot->poll = change_frame_poll;
193         
194         /* flags */
195         ot->flag = OPTYPE_BLOCKING | OPTYPE_UNDO | OPTYPE_GRAB_POINTER;
196
197         /* rna */
198         ot->prop = RNA_def_int(ot->srna, "frame", 0, MINAFRAME, MAXFRAME, "Frame", "", MINAFRAME, MAXFRAME);
199 }
200
201 /* ****************** set preview range operator ****************************/
202
203 static int previewrange_define_exec(bContext *C, wmOperator *op)
204 {
205         Scene *scene = CTX_data_scene(C);
206         ARegion *ar = CTX_wm_region(C);
207         float sfra, efra;
208         rcti rect;
209         
210         /* get min/max values from border select rect (already in region coordinates, not screen) */
211         WM_operator_properties_border_to_rcti(op, &rect);
212         
213         /* convert min/max values to frames (i.e. region to 'tot' rect) */
214         UI_view2d_region_to_view(&ar->v2d, rect.xmin, 0, &sfra, NULL);
215         UI_view2d_region_to_view(&ar->v2d, rect.xmax, 0, &efra, NULL);
216         
217         /* set start/end frames for preview-range 
218          *      - must clamp within allowable limits
219          *      - end must not be before start (though this won't occur most of the time)
220          */
221         FRAMENUMBER_MIN_CLAMP(sfra);
222         FRAMENUMBER_MIN_CLAMP(efra);
223         if (efra < sfra) efra = sfra;
224         
225         scene->r.flag |= SCER_PRV_RANGE;
226         scene->r.psfra = (int)floor(sfra + 0.5f);
227         scene->r.pefra = (int)floor(efra + 0.5f);
228         
229         /* send notifiers */
230         WM_event_add_notifier(C, NC_SCENE | ND_FRAME, scene);
231         
232         return OPERATOR_FINISHED;
233
234
235 static void ANIM_OT_previewrange_set(wmOperatorType *ot)
236 {
237         /* identifiers */
238         ot->name = "Set Preview Range";
239         ot->idname = "ANIM_OT_previewrange_set";
240         ot->description = "Interactively define frame range used for playback";
241         
242         /* api callbacks */
243         ot->invoke = WM_border_select_invoke;
244         ot->exec = previewrange_define_exec;
245         ot->modal = WM_border_select_modal;
246         ot->cancel = WM_border_select_cancel;
247         
248         ot->poll = ED_operator_animview_active;
249         
250         /* flags */
251         ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
252         
253         /* rna */
254         /* used to define frame range.
255          *
256          * note: border Y values are not used,
257          * but are needed by borderselect gesture operator stuff */
258         WM_operator_properties_border(ot);
259 }
260
261 /* ****************** clear preview range operator ****************************/
262
263 static int previewrange_clear_exec(bContext *C, wmOperator *UNUSED(op))
264 {
265         Scene *scene = CTX_data_scene(C);
266         ScrArea *curarea = CTX_wm_area(C);
267         
268         /* sanity checks */
269         if (ELEM(NULL, scene, curarea))
270                 return OPERATOR_CANCELLED;
271         
272         /* simply clear values */
273         scene->r.flag &= ~SCER_PRV_RANGE;
274         scene->r.psfra = 0;
275         scene->r.pefra = 0;
276         
277         ED_area_tag_redraw(curarea);
278         
279         return OPERATOR_FINISHED;
280
281
282 static void ANIM_OT_previewrange_clear(wmOperatorType *ot)
283 {
284         /* identifiers */
285         ot->name = "Clear Preview Range";
286         ot->idname = "ANIM_OT_previewrange_clear";
287         ot->description = "Clear Preview Range";
288         
289         /* api callbacks */
290         ot->exec = previewrange_clear_exec;
291         
292         ot->poll = ED_operator_animview_active;
293         
294         /* flags */
295         ot->flag = OPTYPE_REGISTER | OPTYPE_UNDO;
296 }
297
298 /* ************************** registration **********************************/
299
300 void ED_operatortypes_anim(void)
301 {
302         /* Animation Editors only -------------------------- */
303         WM_operatortype_append(ANIM_OT_change_frame);
304         
305         WM_operatortype_append(ANIM_OT_previewrange_set);
306         WM_operatortype_append(ANIM_OT_previewrange_clear);
307         
308         /* Entire UI --------------------------------------- */
309         WM_operatortype_append(ANIM_OT_keyframe_insert);
310         WM_operatortype_append(ANIM_OT_keyframe_delete);
311         WM_operatortype_append(ANIM_OT_keyframe_insert_menu);
312         WM_operatortype_append(ANIM_OT_keyframe_delete_v3d);
313         WM_operatortype_append(ANIM_OT_keyframe_clear_v3d);
314         WM_operatortype_append(ANIM_OT_keyframe_insert_button);
315         WM_operatortype_append(ANIM_OT_keyframe_delete_button);
316         WM_operatortype_append(ANIM_OT_keyframe_clear_button);
317         
318         
319         WM_operatortype_append(ANIM_OT_driver_button_add);
320         WM_operatortype_append(ANIM_OT_driver_button_remove);
321         WM_operatortype_append(ANIM_OT_copy_driver_button);
322         WM_operatortype_append(ANIM_OT_paste_driver_button);
323
324         
325         WM_operatortype_append(ANIM_OT_keyingset_button_add);
326         WM_operatortype_append(ANIM_OT_keyingset_button_remove);
327         
328         WM_operatortype_append(ANIM_OT_keying_set_add);
329         WM_operatortype_append(ANIM_OT_keying_set_remove);
330         WM_operatortype_append(ANIM_OT_keying_set_path_add);
331         WM_operatortype_append(ANIM_OT_keying_set_path_remove);
332         
333         WM_operatortype_append(ANIM_OT_keying_set_active_set);
334 }
335
336 void ED_keymap_anim(wmKeyConfig *keyconf)
337 {
338         wmKeyMap *keymap = WM_keymap_find(keyconf, "Animation", 0, 0);
339         wmKeyMapItem *kmi;
340         
341         /* frame management */
342         /* NOTE: 'ACTIONMOUSE' not 'LEFTMOUSE', as user may have swapped mouse-buttons */
343         WM_keymap_add_item(keymap, "ANIM_OT_change_frame", ACTIONMOUSE, KM_PRESS, 0, 0);
344
345         kmi = WM_keymap_add_item(keymap, "WM_OT_context_toggle", TKEY, KM_PRESS, KM_CTRL, 0);
346         RNA_string_set(kmi->ptr, "data_path", "space_data.show_seconds");
347         
348         /* preview range */
349         WM_keymap_verify_item(keymap, "ANIM_OT_previewrange_set", PKEY, KM_PRESS, 0, 0);
350         WM_keymap_verify_item(keymap, "ANIM_OT_previewrange_clear", PKEY, KM_PRESS, KM_ALT, 0);
351 }