Audaspace Py API documentation fixes.
[blender.git] / source / blender / blenkernel / intern / scene.c
1 /*  scene.c
2  *  
3  * 
4  * $Id$
5  *
6  * ***** BEGIN GPL LICENSE BLOCK *****
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * as published by the Free Software Foundation; either version 2
11  * of the License, or (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software Foundation,
20  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21  *
22  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
23  * All rights reserved.
24  *
25  * The Original Code is: all of this file.
26  *
27  * Contributor(s): none yet.
28  *
29  * ***** END GPL LICENSE BLOCK *****
30  */
31
32 #include <stddef.h>
33 #include <stdio.h>
34 #include <string.h>
35
36 #ifndef WIN32 
37 #include <unistd.h>
38 #else
39 #include <io.h>
40 #endif
41 #include "MEM_guardedalloc.h"
42
43 #include "DNA_anim_types.h"
44 #include "DNA_group_types.h"
45 #include "DNA_scene_types.h"
46 #include "DNA_screen_types.h"
47 #include "DNA_sequence_types.h"
48
49 #include "BKE_anim.h"
50 #include "BKE_animsys.h"
51 #include "BKE_depsgraph.h"
52 #include "BKE_global.h"
53 #include "BKE_group.h"
54 #include "BKE_idprop.h"
55 #include "BKE_library.h"
56 #include "BKE_main.h"
57 #include "BKE_node.h"
58 #include "BKE_object.h"
59 #include "BKE_paint.h"
60 #include "BKE_pointcache.h"
61 #include "BKE_scene.h"
62 #include "BKE_sequencer.h"
63 #include "BKE_world.h"
64 #include "BKE_utildefines.h"
65 #include "BKE_sound.h"
66
67 //XXX #include "BIF_previewrender.h"
68 //XXX #include "BIF_editseq.h"
69
70 #ifndef DISABLE_PYTHON
71 #include "BPY_extern.h"
72 #endif
73
74 #include "BLI_math.h"
75 #include "BLI_blenlib.h"
76
77 //XXX #include "nla.h"
78
79 #ifdef WIN32
80 #else
81 #include <sys/time.h>
82 #endif
83
84 void free_avicodecdata(AviCodecData *acd)
85 {
86         if (acd) {
87                 if (acd->lpFormat){
88                         MEM_freeN(acd->lpFormat);
89                         acd->lpFormat = NULL;
90                         acd->cbFormat = 0;
91                 }
92                 if (acd->lpParms){
93                         MEM_freeN(acd->lpParms);
94                         acd->lpParms = NULL;
95                         acd->cbParms = 0;
96                 }
97         }
98 }
99
100 void free_qtcodecdata(QuicktimeCodecData *qcd)
101 {
102         if (qcd) {
103                 if (qcd->cdParms){
104                         MEM_freeN(qcd->cdParms);
105                         qcd->cdParms = NULL;
106                         qcd->cdSize = 0;
107                 }
108         }
109 }
110
111 Scene *copy_scene(Main *bmain, Scene *sce, int type)
112 {
113         Scene *scen;
114         ToolSettings *ts;
115         Base *base, *obase;
116         
117         if(type == SCE_COPY_EMPTY) {
118                 ListBase lb;
119                 scen= add_scene(sce->id.name+2);
120                 
121                 lb= scen->r.layers;
122                 scen->r= sce->r;
123                 scen->r.layers= lb;
124         }
125         else {
126                 scen= copy_libblock(sce);
127                 BLI_duplicatelist(&(scen->base), &(sce->base));
128                 
129                 clear_id_newpoins();
130                 
131                 id_us_plus((ID *)scen->world);
132                 id_us_plus((ID *)scen->set);
133                 id_us_plus((ID *)scen->ima);
134                 id_us_plus((ID *)scen->gm.dome.warptext);
135
136                 scen->ed= NULL;
137                 scen->theDag= NULL;
138                 scen->obedit= NULL;
139                 scen->toolsettings= MEM_dupallocN(sce->toolsettings);
140                 scen->stats= NULL;
141                 scen->fps_info= NULL;
142
143                 ts= scen->toolsettings;
144                 if(ts) {
145                         if(ts->vpaint) {
146                                 ts->vpaint= MEM_dupallocN(ts->vpaint);
147                                 ts->vpaint->paintcursor= NULL;
148                                 ts->vpaint->vpaint_prev= NULL;
149                                 ts->vpaint->wpaint_prev= NULL;
150                                 copy_paint(&ts->vpaint->paint, &ts->vpaint->paint);
151                         }
152                         if(ts->wpaint) {
153                                 ts->wpaint= MEM_dupallocN(ts->wpaint);
154                                 ts->wpaint->paintcursor= NULL;
155                                 ts->wpaint->vpaint_prev= NULL;
156                                 ts->wpaint->wpaint_prev= NULL;
157                                 copy_paint(&ts->wpaint->paint, &ts->wpaint->paint);
158                         }
159                         if(ts->sculpt) {
160                                 ts->sculpt= MEM_dupallocN(ts->sculpt);
161                                 copy_paint(&ts->sculpt->paint, &ts->sculpt->paint);
162                         }
163
164                         copy_paint(&ts->imapaint.paint, &ts->imapaint.paint);
165                         ts->imapaint.paintcursor= NULL;
166
167                         ts->particle.paintcursor= NULL;
168                 }
169                 
170                 BLI_duplicatelist(&(scen->markers), &(sce->markers));
171                 BLI_duplicatelist(&(scen->transform_spaces), &(sce->transform_spaces));
172                 BLI_duplicatelist(&(scen->r.layers), &(sce->r.layers));
173                 BKE_keyingsets_copy(&(scen->keyingsets), &(sce->keyingsets));
174                 
175                 scen->nodetree= ntreeCopyTree(sce->nodetree, 0);
176                 
177                 obase= sce->base.first;
178                 base= scen->base.first;
179                 while(base) {
180                         id_us_plus(&base->object->id);
181                         if(obase==sce->basact) scen->basact= base;
182         
183                         obase= obase->next;
184                         base= base->next;
185                 }
186         }
187         
188         /* make a private copy of the avicodecdata */
189         if(sce->r.avicodecdata) {
190                 scen->r.avicodecdata = MEM_dupallocN(sce->r.avicodecdata);
191                 scen->r.avicodecdata->lpFormat = MEM_dupallocN(scen->r.avicodecdata->lpFormat);
192                 scen->r.avicodecdata->lpParms = MEM_dupallocN(scen->r.avicodecdata->lpParms);
193         }
194         
195         /* make a private copy of the qtcodecdata */
196         if(sce->r.qtcodecdata) {
197                 scen->r.qtcodecdata = MEM_dupallocN(sce->r.qtcodecdata);
198                 scen->r.qtcodecdata->cdParms = MEM_dupallocN(scen->r.qtcodecdata->cdParms);
199         }
200         
201         if(sce->r.ffcodecdata.properties) { /* intentionally check scen not sce. */
202                 scen->r.ffcodecdata.properties= IDP_CopyProperty(sce->r.ffcodecdata.properties);
203         }
204
205         /* NOTE: part of SCE_COPY_LINK_DATA and SCE_COPY_FULL operations
206          * are done outside of blenkernel with ED_objects_single_users! */
207
208         /*  camera */
209         if(type == SCE_COPY_LINK_DATA || type == SCE_COPY_FULL) {
210                 ID_NEW(scen->camera);
211         }
212
213         /* world */
214         if(type == SCE_COPY_FULL) {
215                 if(scen->world) {
216                         id_us_plus((ID *)scen->world);
217                         scen->world= copy_world(scen->world);
218                 }
219
220                 if(sce->ed) {
221                         scen->ed= MEM_callocN( sizeof(Editing), "addseq");
222                         scen->ed->seqbasep= &scen->ed->seqbase;
223                         seqbase_dupli_recursive(sce, &scen->ed->seqbase, &sce->ed->seqbase, SEQ_DUPE_ALL);
224                 }
225         }
226
227         sound_create_scene(scen);
228
229         return scen;
230 }
231
232 /* do not free scene itself */
233 void free_scene(Scene *sce)
234 {
235         Base *base;
236
237         base= sce->base.first;
238         while(base) {
239                 base->object->id.us--;
240                 base= base->next;
241         }
242         /* do not free objects! */
243         
244         if(sce->gpd) {
245 #if 0   // removed since this can be invalid memory when freeing everything
246                 // since the grease pencil data is free'd before the scene.
247                 // since grease pencil data is not (yet?), shared between objects
248                 // its probably safe not to do this, some save and reload will free this.
249                 sce->gpd->id.us--;
250 #endif
251                 sce->gpd= NULL;
252         }
253
254         BLI_freelistN(&sce->base);
255         seq_free_editing(sce);
256
257         BKE_free_animdata((ID *)sce);
258         BKE_keyingsets_free(&sce->keyingsets);
259         
260         if (sce->r.avicodecdata) {
261                 free_avicodecdata(sce->r.avicodecdata);
262                 MEM_freeN(sce->r.avicodecdata);
263                 sce->r.avicodecdata = NULL;
264         }
265         if (sce->r.qtcodecdata) {
266                 free_qtcodecdata(sce->r.qtcodecdata);
267                 MEM_freeN(sce->r.qtcodecdata);
268                 sce->r.qtcodecdata = NULL;
269         }
270         if (sce->r.ffcodecdata.properties) {
271                 IDP_FreeProperty(sce->r.ffcodecdata.properties);
272                 MEM_freeN(sce->r.ffcodecdata.properties);
273                 sce->r.ffcodecdata.properties = NULL;
274         }
275         
276         BLI_freelistN(&sce->markers);
277         BLI_freelistN(&sce->transform_spaces);
278         BLI_freelistN(&sce->r.layers);
279         
280         if(sce->toolsettings) {
281                 if(sce->toolsettings->vpaint) {
282                         free_paint(&sce->toolsettings->vpaint->paint);
283                         MEM_freeN(sce->toolsettings->vpaint);
284                 }
285                 if(sce->toolsettings->wpaint) {
286                         free_paint(&sce->toolsettings->wpaint->paint);
287                         MEM_freeN(sce->toolsettings->wpaint);
288                 }
289                 if(sce->toolsettings->sculpt) {
290                         free_paint(&sce->toolsettings->sculpt->paint);
291                         MEM_freeN(sce->toolsettings->sculpt);
292                 }
293                 free_paint(&sce->toolsettings->imapaint.paint);
294
295                 MEM_freeN(sce->toolsettings);
296                 sce->toolsettings = NULL;       
297         }
298         
299         if (sce->theDag) {
300                 free_forest(sce->theDag);
301                 MEM_freeN(sce->theDag);
302         }
303         
304         if(sce->nodetree) {
305                 ntreeFreeTree(sce->nodetree);
306                 MEM_freeN(sce->nodetree);
307         }
308
309         if(sce->stats)
310                 MEM_freeN(sce->stats);
311         if(sce->fps_info)
312                 MEM_freeN(sce->fps_info);
313
314         sound_destroy_scene(sce);
315 }
316
317 Scene *add_scene(char *name)
318 {
319         Scene *sce;
320         ParticleEditSettings *pset;
321         int a;
322
323         sce= alloc_libblock(&G.main->scene, ID_SCE, name);
324         sce->lay= sce->layact= 1;
325         
326         sce->r.mode= R_GAMMA|R_OSA|R_SHADOW|R_SSS|R_ENVMAP|R_RAYTRACE;
327         sce->r.cfra= 1;
328         sce->r.sfra= 1;
329         sce->r.efra= 250;
330         sce->r.frame_step= 1;
331         sce->r.xsch= 1920;
332         sce->r.ysch= 1080;
333         sce->r.xasp= 1;
334         sce->r.yasp= 1;
335         sce->r.xparts= 8;
336         sce->r.yparts= 8;
337         sce->r.size= 25;
338         sce->r.planes= 24;
339         sce->r.quality= 90;
340         sce->r.framapto= 100;
341         sce->r.images= 100;
342         sce->r.framelen= 1.0;
343         sce->r.frs_sec= 25;
344         sce->r.frs_sec_base= 1;
345         sce->r.ocres = 128;
346         sce->r.color_mgt_flag |= R_COLOR_MANAGEMENT;
347         
348         sce->r.bake_mode= 1;    /* prevent to include render stuff here */
349         sce->r.bake_filter= 8;
350         sce->r.bake_osa= 5;
351         sce->r.bake_flag= R_BAKE_CLEAR;
352         sce->r.bake_normal_space= R_BAKE_SPACE_TANGENT;
353
354         sce->r.scemode= R_DOCOMP|R_DOSEQ|R_EXTENSION;
355         sce->r.stamp= R_STAMP_TIME|R_STAMP_FRAME|R_STAMP_DATE|R_STAMP_SCENE|R_STAMP_CAMERA|R_STAMP_RENDERTIME;
356         sce->r.stamp_font_id= 12;
357
358         sce->r.seq_prev_type= OB_SOLID;
359         sce->r.seq_rend_type= OB_SOLID;
360         sce->r.seq_flag= R_SEQ_GL_PREV;
361
362         sce->r.threads= 1;
363
364         sce->r.simplify_subsurf= 6;
365         sce->r.simplify_particles= 1.0f;
366         sce->r.simplify_shadowsamples= 16;
367         sce->r.simplify_aosss= 1.0f;
368
369         sce->r.cineonblack= 95;
370         sce->r.cineonwhite= 685;
371         sce->r.cineongamma= 1.7f;
372
373         sce->r.border.xmin= 0.0f;
374         sce->r.border.ymin= 0.0f;
375         sce->r.border.xmax= 1.0f;
376         sce->r.border.ymax= 1.0f;
377         
378         sce->toolsettings = MEM_callocN(sizeof(struct ToolSettings),"Tool Settings Struct");
379         sce->toolsettings->cornertype=1;
380         sce->toolsettings->degr = 90; 
381         sce->toolsettings->step = 9;
382         sce->toolsettings->turn = 1;                            
383         sce->toolsettings->extr_offs = 1; 
384         sce->toolsettings->doublimit = 0.001;
385         sce->toolsettings->segments = 32;
386         sce->toolsettings->rings = 32;
387         sce->toolsettings->vertices = 32;
388         sce->toolsettings->editbutflag = 1;
389         sce->toolsettings->uvcalc_radius = 1.0f;
390         sce->toolsettings->uvcalc_cubesize = 1.0f;
391         sce->toolsettings->uvcalc_mapdir = 1;
392         sce->toolsettings->uvcalc_mapalign = 1;
393         sce->toolsettings->unwrapper = 1;
394         sce->toolsettings->select_thresh= 0.01f;
395         sce->toolsettings->jointrilimit = 0.8f;
396
397         sce->toolsettings->selectmode= SCE_SELECT_VERTEX;
398         sce->toolsettings->normalsize= 0.1;
399         sce->toolsettings->autokey_mode= U.autokey_mode;
400
401         sce->toolsettings->skgen_resolution = 100;
402         sce->toolsettings->skgen_threshold_internal     = 0.01f;
403         sce->toolsettings->skgen_threshold_external     = 0.01f;
404         sce->toolsettings->skgen_angle_limit                    = 45.0f;
405         sce->toolsettings->skgen_length_ratio                   = 1.3f;
406         sce->toolsettings->skgen_length_limit                   = 1.5f;
407         sce->toolsettings->skgen_correlation_limit              = 0.98f;
408         sce->toolsettings->skgen_symmetry_limit                 = 0.1f;
409         sce->toolsettings->skgen_postpro = SKGEN_SMOOTH;
410         sce->toolsettings->skgen_postpro_passes = 1;
411         sce->toolsettings->skgen_options = SKGEN_FILTER_INTERNAL|SKGEN_FILTER_EXTERNAL|SKGEN_FILTER_SMART|SKGEN_HARMONIC|SKGEN_SUB_CORRELATION|SKGEN_STICK_TO_EMBEDDING;
412         sce->toolsettings->skgen_subdivisions[0] = SKGEN_SUB_CORRELATION;
413         sce->toolsettings->skgen_subdivisions[1] = SKGEN_SUB_LENGTH;
414         sce->toolsettings->skgen_subdivisions[2] = SKGEN_SUB_ANGLE;
415
416         sce->toolsettings->proportional_size = 1.0f;
417
418         sce->physics_settings.gravity[0] = 0.0f;
419         sce->physics_settings.gravity[1] = 0.0f;
420         sce->physics_settings.gravity[2] = -9.81f;
421         sce->physics_settings.flag = PHYS_GLOBAL_GRAVITY;
422
423         sce->unit.scale_length = 1.0f;
424
425         pset= &sce->toolsettings->particle;
426         pset->flag= PE_KEEP_LENGTHS|PE_LOCK_FIRST|PE_DEFLECT_EMITTER|PE_AUTO_VELOCITY;
427         pset->emitterdist= 0.25f;
428         pset->totrekey= 5;
429         pset->totaddkey= 5;
430         pset->brushtype= PE_BRUSH_NONE;
431         pset->draw_step= 2;
432         pset->fade_frames= 2;
433         pset->selectmode= SCE_SELECT_PATH;
434         for(a=0; a<PE_TOT_BRUSH; a++) {
435                 pset->brush[a].strength= 0.5;
436                 pset->brush[a].size= 50;
437                 pset->brush[a].step= 10;
438                 pset->brush[a].count= 10;
439         }
440         pset->brush[PE_BRUSH_CUT].strength= 100;
441         
442         sce->jumpframe = 10;
443         sce->r.ffcodecdata.audio_mixrate = 44100;
444
445         sce->audio.distance_model = 2.0;
446         sce->audio.doppler_factor = 1.0;
447         sce->audio.speed_of_sound = 343.3;
448
449         strcpy(sce->r.backbuf, "//backbuf");
450         strcpy(sce->r.pic, U.renderdir);
451
452         BLI_init_rctf(&sce->r.safety, 0.1f, 0.9f, 0.1f, 0.9f);
453         sce->r.osa= 8;
454
455         /* note; in header_info.c the scene copy happens..., if you add more to renderdata it has to be checked there */
456         scene_add_render_layer(sce);
457         
458         /* game data */
459         sce->gm.stereoflag = STEREO_NOSTEREO;
460         sce->gm.stereomode = STEREO_ANAGLYPH;
461         sce->gm.eyeseparation = 0.10;
462
463         sce->gm.dome.angle = 180;
464         sce->gm.dome.mode = DOME_FISHEYE;
465         sce->gm.dome.res = 4;
466         sce->gm.dome.resbuf = 1.0f;
467         sce->gm.dome.tilt = 0;
468
469         sce->gm.xplay= 800;
470         sce->gm.yplay= 600;
471         sce->gm.freqplay= 60;
472         sce->gm.depth= 32;
473
474         sce->gm.gravity= 9.8f;
475         sce->gm.physicsEngine= WOPHY_BULLET;
476         sce->gm.mode = 32; //XXX ugly harcoding, still not sure we should drop mode. 32 == 1 << 5 == use_occlusion_culling 
477         sce->gm.occlusionRes = 128;
478         sce->gm.ticrate = 60;
479         sce->gm.maxlogicstep = 5;
480         sce->gm.physubstep = 1;
481         sce->gm.maxphystep = 5;
482
483         sce->gm.flag = GAME_DISPLAY_LISTS;
484         sce->gm.matmode = GAME_MAT_MULTITEX;
485
486         sound_create_scene(sce);
487
488         return sce;
489 }
490
491 Base *object_in_scene(Object *ob, Scene *sce)
492 {
493         Base *base;
494         
495         base= sce->base.first;
496         while(base) {
497                 if(base->object == ob) return base;
498                 base= base->next;
499         }
500         return NULL;
501 }
502
503 void set_scene_bg(Scene *scene)
504 {
505         Scene *sce;
506         Base *base;
507         Object *ob;
508         Group *group;
509         GroupObject *go;
510         int flag;
511         
512         /* check for cyclic sets, for reading old files but also for definite security (py?) */
513         scene_check_setscene(scene);
514         
515         /* deselect objects (for dataselect) */
516         for(ob= G.main->object.first; ob; ob= ob->id.next)
517                 ob->flag &= ~(SELECT|OB_FROMGROUP);
518
519         /* group flags again */
520         for(group= G.main->group.first; group; group= group->id.next) {
521                 go= group->gobject.first;
522                 while(go) {
523                         if(go->ob) go->ob->flag |= OB_FROMGROUP;
524                         go= go->next;
525                 }
526         }
527
528         /* sort baselist */
529         DAG_scene_sort(scene);
530         
531         /* ensure dags are built for sets */
532         for(sce= scene->set; sce; sce= sce->set)
533                 if(sce->theDag==NULL)
534                         DAG_scene_sort(sce);
535
536         /* copy layers and flags from bases to objects */
537         for(base= scene->base.first; base; base= base->next) {
538                 ob= base->object;
539                 ob->lay= base->lay;
540                 
541                 /* group patch... */
542                 base->flag &= ~(OB_FROMGROUP);
543                 flag= ob->flag & (OB_FROMGROUP);
544                 base->flag |= flag;
545                 
546                 /* not too nice... for recovering objects with lost data */
547                 //if(ob->pose==NULL) base->flag &= ~OB_POSEMODE;
548                 ob->flag= base->flag;
549                 
550                 ob->ctime= -1234567.0;  /* force ipo to be calculated later */
551         }
552         /* no full animation update, this to enable render code to work (render code calls own animation updates) */
553 }
554
555 /* called from creator.c */
556 Scene *set_scene_name(char *name)
557 {
558         Scene *sce= (Scene *)find_id("SC", name);
559         if(sce) {
560                 set_scene_bg(sce);
561                 printf("Scene switch: '%s' in file: '%s'\n", name, G.sce);
562                 return sce;
563         }
564
565         printf("Can't find scene: '%s' in file: '%s'\n", name, G.sce);
566         return NULL;
567 }
568
569 void unlink_scene(Main *bmain, Scene *sce, Scene *newsce)
570 {
571         Scene *sce1;
572         bScreen *sc;
573
574         /* check all sets */
575         for(sce1= bmain->scene.first; sce1; sce1= sce1->id.next)
576                 if(sce1->set == sce)
577                         sce1->set= NULL;
578         
579         /* check all sequences */
580         clear_scene_in_allseqs(sce);
581
582         /* check render layer nodes in other scenes */
583         clear_scene_in_nodes(bmain, sce);
584         
585         /* al screens */
586         for(sc= bmain->screen.first; sc; sc= sc->id.next)
587                 if(sc->scene == sce)
588                         sc->scene= newsce;
589
590         free_libblock(&bmain->scene, sce);
591 }
592
593 /* used by metaballs
594  * doesnt return the original duplicated object, only dupli's
595  */
596 int next_object(Scene **scene, int val, Base **base, Object **ob)
597 {
598         static ListBase *duplilist= NULL;
599         static DupliObject *dupob;
600         static int fase= F_START, in_next_object= 0;
601         int run_again=1;
602         
603         /* init */
604         if(val==0) {
605                 fase= F_START;
606                 dupob= NULL;
607                 
608                 /* XXX particle systems with metas+dupligroups call this recursively */
609                 /* see bug #18725 */
610                 if(in_next_object) {
611                         printf("ERROR: MetaBall generation called recursively, not supported\n");
612                         
613                         return F_ERROR;
614                 }
615         }
616         else {
617                 in_next_object= 1;
618                 
619                 /* run_again is set when a duplilist has been ended */
620                 while(run_again) {
621                         run_again= 0;
622
623                         /* the first base */
624                         if(fase==F_START) {
625                                 *base= (*scene)->base.first;
626                                 if(*base) {
627                                         *ob= (*base)->object;
628                                         fase= F_SCENE;
629                                 }
630                                 else {
631                                         /* exception: empty scene */
632                                         while((*scene)->set) {
633                                                 (*scene)= (*scene)->set;
634                                                 if((*scene)->base.first) {
635                                                         *base= (*scene)->base.first;
636                                                         *ob= (*base)->object;
637                                                         fase= F_SCENE;
638                                                         break;
639                                                 }
640                                         }
641                                 }
642                         }
643                         else {
644                                 if(*base && fase!=F_DUPLI) {
645                                         *base= (*base)->next;
646                                         if(*base) *ob= (*base)->object;
647                                         else {
648                                                 if(fase==F_SCENE) {
649                                                         /* (*scene) is finished, now do the set */
650                                                         while((*scene)->set) {
651                                                                 (*scene)= (*scene)->set;
652                                                                 if((*scene)->base.first) {
653                                                                         *base= (*scene)->base.first;
654                                                                         *ob= (*base)->object;
655                                                                         break;
656                                                                 }
657                                                         }
658                                                 }
659                                         }
660                                 }
661                         }
662                         
663                         if(*base == NULL) fase= F_START;
664                         else {
665                                 if(fase!=F_DUPLI) {
666                                         if( (*base)->object->transflag & OB_DUPLI) {
667                                                 /* groups cannot be duplicated for mballs yet, 
668                                                 this enters eternal loop because of 
669                                                 makeDispListMBall getting called inside of group_duplilist */
670                                                 if((*base)->object->dup_group == NULL) {
671                                                         duplilist= object_duplilist((*scene), (*base)->object);
672                                                         
673                                                         dupob= duplilist->first;
674
675                                                         if(!dupob)
676                                                                 free_object_duplilist(duplilist);
677                                                 }
678                                         }
679                                 }
680                                 /* handle dupli's */
681                                 if(dupob) {
682                                         
683                                         copy_m4_m4(dupob->ob->obmat, dupob->mat);
684                                         
685                                         (*base)->flag |= OB_FROMDUPLI;
686                                         *ob= dupob->ob;
687                                         fase= F_DUPLI;
688                                         
689                                         dupob= dupob->next;
690                                 }
691                                 else if(fase==F_DUPLI) {
692                                         fase= F_SCENE;
693                                         (*base)->flag &= ~OB_FROMDUPLI;
694                                         
695                                         for(dupob= duplilist->first; dupob; dupob= dupob->next) {
696                                                 copy_m4_m4(dupob->ob->obmat, dupob->omat);
697                                         }
698                                         
699                                         free_object_duplilist(duplilist);
700                                         duplilist= NULL;
701                                         run_again= 1;
702                                 }
703                         }
704                 }
705         }
706         
707         /* if(ob && *ob) {
708                 printf("Scene: '%s', '%s'\n", (*scene)->id.name+2, (*ob)->id.name+2);
709         } */
710
711         /* reset recursion test */
712         in_next_object= 0;
713         
714         return fase;
715 }
716
717 Object *scene_find_camera(Scene *sc)
718 {
719         Base *base;
720         
721         for (base= sc->base.first; base; base= base->next)
722                 if (base->object->type==OB_CAMERA)
723                         return base->object;
724
725         return NULL;
726 }
727
728 #ifdef DURIAN_CAMERA_SWITCH
729 Object *scene_camera_switch_find(Scene *scene)
730 {
731         TimeMarker *m;
732         int cfra = scene->r.cfra;
733         int frame = -(MAXFRAME + 1);
734         Object *camera= NULL;
735
736         for (m= scene->markers.first; m; m= m->next) {
737                 if(m->camera && (m->camera->restrictflag & OB_RESTRICT_RENDER)==0 && (m->frame <= cfra) && (m->frame > frame)) {
738                         camera= m->camera;
739                         frame= m->frame;
740
741                         if(frame == cfra)
742                                 break;
743
744                 }
745         }
746         return camera;
747 }
748 #endif
749
750 int scene_camera_switch_update(Scene *scene)
751 {
752 #ifdef DURIAN_CAMERA_SWITCH
753         Object *camera= scene_camera_switch_find(scene);
754         if(camera) {
755                 scene->camera= camera;
756                 return 1;
757         }
758 #endif
759         return 0;
760 }
761
762 char *scene_find_marker_name(Scene *scene, int frame)
763 {
764         ListBase *markers= &scene->markers;
765         TimeMarker *m1, *m2;
766
767         /* search through markers for match */
768         for (m1=markers->first, m2=markers->last; m1 && m2; m1=m1->next, m2=m2->prev) {
769                 if (m1->frame==frame)
770                         return m1->name;
771
772                 if (m1 == m2)
773                         break;
774
775                 if (m2->frame==frame)
776                         return m2->name;
777         }
778
779         return NULL;
780 }
781
782 /* return the current marker for this frame,
783 we can have more then 1 marker per frame, this just returns the first :/ */
784 char *scene_find_last_marker_name(Scene *scene, int frame)
785 {
786         TimeMarker *marker, *best_marker = NULL;
787         int best_frame = -MAXFRAME*2;
788         for (marker= scene->markers.first; marker; marker= marker->next) {
789                 if (marker->frame==frame) {
790                         return marker->name;
791                 }
792
793                 if ( marker->frame > best_frame && marker->frame < frame) {
794                         best_marker = marker;
795                         best_frame = marker->frame;
796                 }
797         }
798
799         return best_marker ? best_marker->name : NULL;
800 }
801
802 /* markers need transforming from different parts of the code so have
803  * a generic function to do this */
804 int scene_marker_tfm_translate(Scene *scene, int delta, int flag)
805 {
806         TimeMarker *marker;
807         int tot= 0;
808
809         for (marker= scene->markers.first; marker; marker= marker->next) {
810                 if ((marker->flag & flag) == flag) {
811                         marker->frame += delta;
812                         tot++;
813                 }
814         }
815
816         return tot;
817 }
818
819 int scene_marker_tfm_extend(Scene *scene, int delta, int flag, int frame, char side)
820 {
821         TimeMarker *marker;
822         int tot= 0;
823
824         for (marker= scene->markers.first; marker; marker= marker->next) {
825                 if ((marker->flag & flag) == flag) {
826                         if((side=='L' && marker->frame < frame) || (side=='R' && marker->frame >= frame)) {
827                                 marker->frame += delta;
828                                 tot++;
829                         }
830                 }
831         }
832
833         return tot;
834 }
835
836 Base *scene_add_base(Scene *sce, Object *ob)
837 {
838         Base *b= MEM_callocN(sizeof(*b), "scene_add_base");
839         BLI_addhead(&sce->base, b);
840
841         b->object= ob;
842         b->flag= ob->flag;
843         b->lay= ob->lay;
844
845         return b;
846 }
847
848 void scene_deselect_all(Scene *sce)
849 {
850         Base *b;
851
852         for (b= sce->base.first; b; b= b->next) {
853                 b->flag&= ~SELECT;
854                 b->object->flag= b->flag;
855         }
856 }
857
858 void scene_select_base(Scene *sce, Base *selbase)
859 {
860         scene_deselect_all(sce);
861
862         selbase->flag |= SELECT;
863         selbase->object->flag= selbase->flag;
864
865         sce->basact= selbase;
866 }
867
868 /* checks for cycle, returns 1 if it's all OK */
869 int scene_check_setscene(Scene *sce)
870 {
871         Scene *scene;
872         int a, totscene;
873         
874         if(sce->set==NULL) return 1;
875         
876         totscene= 0;
877         for(scene= G.main->scene.first; scene; scene= scene->id.next)
878                 totscene++;
879         
880         for(a=0, scene=sce; scene->set; scene=scene->set, a++) {
881                 /* more iterations than scenes means we have a cycle */
882                 if(a > totscene) {
883                         /* the tested scene gets zero'ed, that's typically current scene */
884                         sce->set= NULL;
885                         return 0;
886                 }
887         }
888
889         return 1;
890 }
891
892 /* This function is needed to cope with fractional frames - including two Blender rendering features
893 * mblur (motion blur that renders 'subframes' and blurs them together), and fields rendering. */
894
895 /* see also bsystem_time in object.c */
896 float BKE_curframe(Scene *scene)
897 {
898         float ctime = scene->r.cfra;
899         ctime+= scene->r.subframe;
900         ctime*= scene->r.framelen;      
901
902         return ctime;
903 }
904
905 static void scene_update_tagged_recursive(Scene *scene, Scene *scene_parent)
906 {
907         Base *base;
908
909         /* sets first, we allow per definition current scene to have
910            dependencies on sets, but not the other way around. */
911         if(scene->set)
912                 scene_update_tagged_recursive(scene->set, scene_parent);
913
914         for(base= scene->base.first; base; base= base->next) {
915                 Object *ob= base->object;
916
917                 object_handle_update(scene_parent, ob);
918
919                 if(ob->dup_group && (ob->transflag & OB_DUPLIGROUP))
920                         group_handle_recalc_and_update(scene_parent, ob, ob->dup_group);
921                         
922                 /* always update layer, so that animating layers works */
923                 base->lay= ob->lay;
924         }
925 }
926
927 /* this is called in main loop, doing tagged updates before redraw */
928 void scene_update_tagged(Scene *scene)
929 {
930         scene->physics_settings.quick_cache_step= 0;
931
932         /* update all objects: drivers, matrices, displists, etc. flags set
933            by depgraph or manual, no layer check here, gets correct flushed */
934
935         scene_update_tagged_recursive(scene, scene);
936
937         /* recalc scene animation data here (for sequencer) */
938         {
939                 float ctime = BKE_curframe(scene); 
940                 AnimData *adt= BKE_animdata_from_id(&scene->id);
941
942                 if(adt && (adt->recalc & ADT_RECALC_ANIM))
943                         BKE_animsys_evaluate_animdata(&scene->id, adt, ctime, 0);
944         }
945
946         if(scene->physics_settings.quick_cache_step)
947                 BKE_ptcache_quick_cache_all(scene);
948
949         /* in the future this should handle updates for all datablocks, not
950            only objects and scenes. - brecht */
951 }
952
953 /* applies changes right away, does all sets too */
954 void scene_update_for_newframe(Scene *sce, unsigned int lay)
955 {
956         float ctime = BKE_curframe(sce);
957         Scene *sce_iter;
958         
959         /* clear animation overrides */
960         // XXX TODO...
961
962         for(sce_iter= sce; sce_iter; sce_iter= sce_iter->set) {
963                 if(sce_iter->theDag==NULL)
964                         DAG_scene_sort(sce_iter);
965         }
966
967
968         /* Following 2 functions are recursive
969          * so dont call within 'scene_update_tagged_recursive' */
970         DAG_scene_update_flags(sce, lay);   // only stuff that moves or needs display still
971
972         /* All 'standard' (i.e. without any dependencies) animation is handled here,
973          * with an 'local' to 'macro' order of evaluation. This should ensure that
974          * settings stored nestled within a hierarchy (i.e. settings in a Texture block
975          * can be overridden by settings from Scene, which owns the Texture through a hierarchy
976          * such as Scene->World->MTex/Texture) can still get correctly overridden.
977          */
978         BKE_animsys_evaluate_all_animation(G.main, ctime);
979         /*...done with recusrive funcs */
980
981         /* object_handle_update() on all objects, groups and sets */
982         scene_update_tagged_recursive(sce, sce);
983 }
984
985 /* return default layer, also used to patch old files */
986 void scene_add_render_layer(Scene *sce)
987 {
988         SceneRenderLayer *srl;
989 //      int tot= 1 + BLI_countlist(&sce->r.layers);
990         
991         srl= MEM_callocN(sizeof(SceneRenderLayer), "new render layer");
992         strcpy(srl->name, "RenderLayer");
993         BLI_uniquename(&sce->r.layers, srl, "RenderLayer", '.', offsetof(SceneRenderLayer, name), sizeof(srl->name));
994         BLI_addtail(&sce->r.layers, srl);
995
996         /* note, this is also in render, pipeline.c, to make layer when scenedata doesnt have it */
997         srl->lay= (1<<20) -1;
998         srl->layflag= 0x7FFF;   /* solid ztra halo edge strand */
999         srl->passflag= SCE_PASS_COMBINED|SCE_PASS_Z;
1000 }
1001
1002 /* render simplification */
1003
1004 int get_render_subsurf_level(RenderData *r, int lvl)
1005 {
1006         if(r->mode & R_SIMPLIFY)
1007                 return MIN2(r->simplify_subsurf, lvl);
1008         else
1009                 return lvl;
1010 }
1011
1012 int get_render_child_particle_number(RenderData *r, int num)
1013 {
1014         if(r->mode & R_SIMPLIFY)
1015                 return (int)(r->simplify_particles*num);
1016         else
1017                 return num;
1018 }
1019
1020 int get_render_shadow_samples(RenderData *r, int samples)
1021 {
1022         if((r->mode & R_SIMPLIFY) && samples > 0)
1023                 return MIN2(r->simplify_shadowsamples, samples);
1024         else
1025                 return samples;
1026 }
1027
1028 float get_render_aosss_error(RenderData *r, float error)
1029 {
1030         if(r->mode & R_SIMPLIFY)
1031                 return ((1.0f-r->simplify_aosss)*10.0f + 1.0f)*error;
1032         else
1033                 return error;
1034 }
1035
1036 /* helper function for the SETLOOPER macro */
1037 Base *_setlooper_base_step(Scene **sce, Base *base)
1038 {
1039     if(base && base->next) {
1040         /* common case, step to the next */
1041         return base->next;
1042     }
1043     else if(base==NULL && (*sce)->base.first) {
1044         /* first time looping, return the scenes first base */
1045         return (Base *)(*sce)->base.first;
1046     }
1047     else {
1048         /* reached the end, get the next base in the set */
1049         while((*sce= (*sce)->set)) {
1050             base= (Base *)(*sce)->base.first;
1051             if(base) {
1052                 return base;
1053             }
1054         }
1055     }
1056
1057     return NULL;
1058 }