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