2.5
[blender.git] / source / blender / editors / animation / anim_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., 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, Joshua Leung
25  *
26  * ***** END GPL LICENSE BLOCK *****
27  */
28
29 #include <stdlib.h>
30 #include <math.h>
31
32 #include "MEM_guardedalloc.h"
33
34 #include "DNA_action_types.h"
35 #include "DNA_scene_types.h"
36 #include "DNA_screen_types.h"
37 #include "DNA_space_types.h"
38 #include "DNA_windowmanager_types.h"
39
40 #include "BLI_blenlib.h"
41
42 #include "BKE_context.h"
43 #include "BKE_utildefines.h"
44
45 #include "UI_interface.h"
46 #include "UI_view2d.h"
47
48 #include "RNA_access.h"
49 #include "RNA_define.h"
50
51 #include "WM_api.h"
52 #include "WM_types.h"
53
54 #include "ED_anim_api.h"
55 #include "ED_keyframing.h" // XXX remove?
56 #include "ED_markers.h"
57 #include "ED_screen.h"
58
59 /* ********************** frame change operator ***************************/
60
61 /* Set any flags that are necessary to indicate modal time-changing operation */
62 static int change_frame_init(bContext *C, wmOperator *op)
63 {
64         ScrArea *curarea= CTX_wm_area(C);
65         
66         if (curarea == NULL)
67                 return 0;
68         
69         if (curarea->spacetype == SPACE_TIME) {
70                 SpaceTime *stime= (SpaceTime*)CTX_wm_space_data(C);
71                 
72                 /* timeline displays frame number only when dragging indicator */
73                 // XXX make this more in line with other anim editors?
74                 stime->flag |= TIME_CFRA_NUM;
75         }
76         
77         return 1;
78 }
79
80 /* Set the new frame number */
81 static void change_frame_apply(bContext *C, wmOperator *op)
82 {
83         Scene *scene= CTX_data_scene(C);
84         int cfra;
85         
86         /* get frame, and clamp to MINFRAME */
87         cfra= RNA_int_get(op->ptr, "frame");
88         
89         if (cfra < MINFRAME) cfra= MINFRAME;
90         CFRA= cfra;
91         
92         WM_event_add_notifier(C, NC_SCENE|ND_FRAME, scene);
93 }
94
95 /* Clear any temp flags */
96 static void change_frame_exit(bContext *C, wmOperator *op)
97 {
98         ScrArea *curarea= CTX_wm_area(C);
99         
100         if (curarea == NULL)
101                 return;
102         
103         if (curarea->spacetype == SPACE_TIME) {
104                 SpaceTime *stime= (SpaceTime*)CTX_wm_space_data(C);
105                 
106                 /* timeline displays frame number only when dragging indicator */
107                 // XXX make this more in line with other anim editors?
108                 stime->flag &= ~TIME_CFRA_NUM;
109         }
110 }
111
112 /* ---- */
113
114 /* Non-modal callback for running operator without user input */
115 static int change_frame_exec(bContext *C, wmOperator *op)
116 {
117         if (!change_frame_init(C, op))
118                 return OPERATOR_CANCELLED;
119         
120         change_frame_apply(C, op);
121         change_frame_exit(C, op);
122         return OPERATOR_FINISHED;
123 }
124
125 /* ---- */
126
127 /* Get frame from mouse coordinates */
128 static int frame_from_event(bContext *C, wmEvent *event)
129 {
130         ARegion *region= CTX_wm_region(C);
131         float viewx;
132         int x, y;
133         
134         /* convert screen coordinates to region coordinates */
135         x= event->x - region->winrct.xmin;
136         y= event->y - region->winrct.ymin;
137         
138         /* convert from region coordinates to View2D 'tot' space */
139         UI_view2d_region_to_view(&region->v2d, x, y, &viewx, NULL);
140         
141         /* round result to nearest int (frames are ints!) */
142         return (int)floor(viewx+0.5f);
143 }
144
145 /* Modal Operator init */
146 static int change_frame_invoke(bContext *C, wmOperator *op, wmEvent *event)
147 {
148         /* Change to frame that mouse is over before adding modal handler,
149          * as user could click on a single frame (jump to frame) as well as
150          * click-dragging over a range (modal scrubbing).
151          */
152         RNA_int_set(op->ptr, "frame", frame_from_event(C, event));
153         
154         change_frame_init(C, op);
155         change_frame_apply(C, op);
156         
157         /* add temp handler */
158         WM_event_add_modal_handler(C, &CTX_wm_window(C)->handlers, op);
159
160         return OPERATOR_RUNNING_MODAL;
161 }
162
163 /* In case modal operator is cancelled */
164 static int change_frame_cancel(bContext *C, wmOperator *op)
165 {
166         change_frame_exit(C, op);
167         return OPERATOR_CANCELLED;
168 }
169
170 /* Modal event handling of frame changing */
171 static int change_frame_modal(bContext *C, wmOperator *op, wmEvent *event)
172 {
173         /* execute the events */
174         switch (event->type) {
175                 case MOUSEMOVE:
176                         RNA_int_set(op->ptr, "frame", frame_from_event(C, event));
177                         change_frame_apply(C, op);
178                         break;
179                         
180                 case LEFTMOUSE:
181                         if (event->val==0) {
182                                 change_frame_exit(C, op);
183                                 return OPERATOR_FINISHED;
184                         }
185                         break;
186         }
187
188         return OPERATOR_RUNNING_MODAL;
189 }
190
191 void ANIM_OT_change_frame(wmOperatorType *ot)
192 {
193         /* identifiers */
194         ot->name= "Change frame";
195         ot->idname= "ANIM_OT_change_frame";
196         
197         /* api callbacks */
198         ot->exec= change_frame_exec;
199         ot->invoke= change_frame_invoke;
200         ot->cancel= change_frame_cancel;
201         ot->modal= change_frame_modal;
202
203         /* rna */
204         RNA_def_int(ot->srna, "frame", 0, 1, MAXFRAME, "Frame", "", 1, MAXFRAME);
205 }
206
207 /* ****************** set preview range operator ****************************/
208
209 static int previewrange_define_exec(bContext *C, wmOperator *op)
210 {
211         Scene *scene= CTX_data_scene(C);
212         ARegion *ar= CTX_wm_region(C);
213         float sfra, efra;
214         int xmin, xmax;
215         
216         /* get min/max values from border select rect (already in region coordinates, not screen) */
217         xmin= RNA_int_get(op->ptr, "xmin");
218         xmax= RNA_int_get(op->ptr, "xmax");
219         
220         /* convert min/max values to frames (i.e. region to 'tot' rect) */
221         UI_view2d_region_to_view(&ar->v2d, xmin, 0, &sfra, NULL);
222         UI_view2d_region_to_view(&ar->v2d, xmax, 0, &efra, NULL);
223         
224         /* set start/end frames for preview-range 
225          *      - must clamp within allowable limits
226          *      - end must not be before start (though this won't occur most of the time)
227          */
228         if (sfra < 1) sfra = 1.0f;
229         if (efra < 1) efra = 1.0f;
230         if (efra < sfra) efra= sfra;
231         
232         scene->r.psfra= (int)floor(sfra + 0.5f);
233         scene->r.pefra= (int)floor(efra + 0.5f);
234         
235         return OPERATOR_FINISHED;
236
237
238 void ANIM_OT_previewrange_define(wmOperatorType *ot)
239 {
240         /* identifiers */
241         ot->name= "Set Preview Range";
242         ot->idname= "ANIM_OT_previewrange_define";
243         
244         /* api callbacks */
245         ot->invoke= WM_border_select_invoke;
246         ot->exec= previewrange_define_exec;
247         ot->modal= WM_border_select_modal;
248         
249         ot->poll= ED_operator_areaactive;
250         
251         /* flags */
252         ot->flag= OPTYPE_REGISTER|OPTYPE_UNDO;
253         
254         /* rna */
255                 /* used to define frame range */
256         RNA_def_int(ot->srna, "xmin", 0, INT_MIN, INT_MAX, "X Min", "", INT_MIN, INT_MAX);
257         RNA_def_int(ot->srna, "xmax", 0, INT_MIN, INT_MAX, "X Max", "", INT_MIN, INT_MAX);
258                 /* these are not used, but are needed by borderselect gesture operator stuff */
259         RNA_def_int(ot->srna, "ymin", 0, INT_MIN, INT_MAX, "Y Min", "", INT_MIN, INT_MAX);
260         RNA_def_int(ot->srna, "ymax", 0, INT_MIN, INT_MAX, "Y Max", "", INT_MIN, INT_MAX);
261 }
262
263 /* ****************** clear preview range operator ****************************/
264
265 static int previewrange_clear_exec(bContext *C, wmOperator *op)
266 {
267         Scene *scene= CTX_data_scene(C);
268         ScrArea *curarea= CTX_wm_area(C);
269         
270         /* sanity checks */
271         if (ELEM(NULL, scene, curarea))
272                 return OPERATOR_CANCELLED;
273         
274         /* simply clear values */
275         scene->r.psfra= 0;
276         scene->r.pefra= 0;
277         
278         ED_area_tag_redraw(curarea);
279         
280         return OPERATOR_FINISHED;
281
282
283 void ANIM_OT_previewrange_clear(wmOperatorType *ot)
284 {
285         /* identifiers */
286         ot->name= "Clear Preview Range";
287         ot->idname= "ANIM_OT_previewrange_clear";
288         
289         /* api callbacks */
290         ot->exec= previewrange_clear_exec;
291         
292         ot->poll= ED_operator_areaactive;
293         
294         /* flags */
295         ot->flag= OPTYPE_REGISTER|OPTYPE_UNDO;
296 }
297
298 /* ****************** time display toggle operator ****************************/
299
300 static int toggle_time_exec(bContext *C, wmOperator *op)
301 {
302         ScrArea *curarea= CTX_wm_area(C);
303         
304         if (curarea == NULL)
305                 return OPERATOR_CANCELLED;
306         
307         /* simply toggle draw frames flag in applicable spaces */
308         // XXX or should relevant spaces define their own version of this?
309         switch (curarea->spacetype) {
310                 case SPACE_TIME: /* TimeLine */
311                 {
312                         SpaceTime *stime= (SpaceTime *)CTX_wm_space_data(C);
313                         stime->flag ^= TIME_DRAWFRAMES;
314                 }
315                         break;
316                 case SPACE_ACTION: /* Action Editor */
317                 {
318                         SpaceAction *saction= (SpaceAction *)CTX_wm_space_data(C);
319                         saction->flag ^= SACTION_DRAWTIME;
320                 }
321                         break;
322                 case SPACE_IPO: /* IPO Editor */
323                 {
324                         SpaceIpo *sipo= (SpaceIpo *)CTX_wm_space_data(C);
325                         sipo->flag ^= SIPO_DRAWTIME;
326                 }
327                         break;
328                 case SPACE_NLA: /* NLA Editor */
329                 {
330                         SpaceNla *snla= (SpaceNla *)CTX_wm_space_data(C);
331                         snla->flag ^= SNLA_DRAWTIME;
332                 }
333                         break;
334                 case SPACE_SEQ: /* Sequencer */
335                 {
336                         SpaceSeq *sseq= (SpaceSeq *)CTX_wm_space_data(C);
337                         sseq->flag ^= SEQ_DRAWFRAMES;
338                 }
339                         break;
340                         
341                 default: /* editor doesn't show frames */
342                         return OPERATOR_CANCELLED; // XXX or should we pass through instead?
343         }
344         
345         ED_area_tag_redraw(curarea);
346         
347         return OPERATOR_FINISHED;
348 }
349
350 void ANIM_OT_time_toggle(wmOperatorType *ot)
351 {
352         /* identifiers */
353         ot->name= "Toggle Frames/Seconds";
354         ot->idname= "ANIM_OT_time_toggle";
355         
356         /* api callbacks */
357         ot->exec= toggle_time_exec;
358         
359         ot->poll= ED_operator_areaactive;
360 }
361
362 /* ************************** registration **********************************/
363
364 void ED_operatortypes_anim(void)
365 {
366         WM_operatortype_append(ANIM_OT_change_frame);
367         WM_operatortype_append(ANIM_OT_time_toggle);
368         
369         WM_operatortype_append(ANIM_OT_previewrange_define);
370         WM_operatortype_append(ANIM_OT_previewrange_clear);
371         
372                 // XXX this is used all over... maybe for screen instead?
373         WM_operatortype_append(ANIM_OT_insert_keyframe);
374         WM_operatortype_append(ANIM_OT_delete_keyframe);
375 }
376
377 void ED_keymap_anim(wmWindowManager *wm)
378 {
379         ListBase *keymap= WM_keymap_listbase(wm, "Animation", 0, 0);
380         
381                 /* frame management */
382         WM_keymap_verify_item(keymap, "ANIM_OT_change_frame", LEFTMOUSE, KM_PRESS, 0, 0);
383         WM_keymap_verify_item(keymap, "ANIM_OT_time_toggle", TKEY, KM_PRESS, KM_CTRL, 0);
384         
385                 /* preview range */
386         WM_keymap_verify_item(keymap, "ANIM_OT_previewrange_define", PKEY, KM_PRESS, KM_CTRL, 0);
387         WM_keymap_verify_item(keymap, "ANIM_OT_previewrange_clear", PKEY, KM_PRESS, KM_ALT, 0);
388 }