Merge branch 'master' into blender2.8
[blender.git] / source / blender / blenkernel / BKE_scene.h
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) 2001-2002 by NaN Holding BV.
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): none yet.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27 #ifndef __BKE_SCENE_H__
28 #define __BKE_SCENE_H__
29
30 /** \file BKE_scene.h
31  *  \ingroup bke
32  *  \since March 2001
33  *  \author nzc
34  */
35
36 #ifdef __cplusplus
37 extern "C" {
38 #endif
39
40 struct AviCodecData;
41 struct Depsgraph;
42 struct EvaluationContext;
43 struct Main;
44 struct Object;
45 struct RenderData;
46 struct Scene;
47 struct SceneCollection;
48 struct ViewLayer;
49 struct UnitSettings;
50 struct ViewRender;
51 struct WorkSpace;
52
53 typedef enum eSceneCopyMethod {
54         SCE_COPY_NEW       = 0,
55         SCE_COPY_EMPTY     = 1,
56         SCE_COPY_LINK_OB   = 2,
57         SCE_COPY_LINK_DATA = 3,
58         SCE_COPY_FULL      = 4,
59 } eSceneCopyMethod;
60
61 /* Use as the contents of a 'for' loop: for (SETLOOPER(...)) { ... */
62 #define SETLOOPER(_sce_basis, _sce_iter, _base)                               \
63         _sce_iter = _sce_basis, _base = _setlooper_base_step(&_sce_iter, BKE_view_layer_from_scene_get(_sce_basis), NULL); \
64         _base;                                                                    \
65         _base = _setlooper_base_step(&_sce_iter, NULL, _base)
66
67 #define SETLOOPER_VIEW_LAYER(_sce_basis, _view_layer, _sce_iter, _base)     \
68         _sce_iter = _sce_basis, _base = _setlooper_base_step(&_sce_iter, _view_layer, NULL);   \
69         _base;                                                                    \
70         _base = _setlooper_base_step(&_sce_iter, NULL, _base)
71
72 #define SETLOOPER_SET_ONLY(_sce_basis, _sce_iter, _base)     \
73         _sce_iter = _sce_basis, _base = _setlooper_base_step(&_sce_iter, NULL, NULL);   \
74         _base;                                                                    \
75         _base = _setlooper_base_step(&_sce_iter, NULL, _base)
76
77 struct Base *_setlooper_base_step(struct Scene **sce_iter, struct ViewLayer *view_layer, struct Base *base);
78
79 void free_avicodecdata(struct AviCodecData *acd);
80
81 void BKE_scene_free_ex(struct Scene *sce, const bool do_id_user);
82 void BKE_scene_free(struct Scene *sce);
83 void BKE_scene_init(struct Scene *sce);
84 struct Scene *BKE_scene_add(struct Main *bmain, const char *name);
85
86 void BKE_scene_remove_rigidbody_object(struct Scene *scene, struct Object *ob);
87
88 bool BKE_scene_object_find(struct Scene *scene, struct Object *ob);
89 struct Object *BKE_scene_object_find_by_name(struct Scene *scene, const char *name);
90
91 /* Scene base iteration function.
92  * Define struct here, so no need to bother with alloc/free it.
93  */
94 typedef struct SceneBaseIter {
95         struct ListBase *duplilist;
96         struct DupliObject *dupob;
97         float omat[4][4];
98         struct Object *dupli_refob;
99         int phase;
100 } SceneBaseIter;
101
102 int BKE_scene_base_iter_next(
103         const struct EvaluationContext *eval_ctx, struct SceneBaseIter *iter,
104         struct Scene **scene, int val, struct Base **base, struct Object **ob);
105
106 void BKE_scene_base_flag_to_objects(struct ViewLayer *view_layer);
107 void BKE_scene_base_flag_from_objects(struct Scene *scene);
108 void BKE_scene_object_base_flag_sync_from_base(struct Base *base);
109 void BKE_scene_object_base_flag_sync_from_object(struct Base *base);
110
111 void BKE_scene_set_background(struct Main *bmain, struct Scene *sce);
112 struct Scene *BKE_scene_set_name(struct Main *bmain, const char *name);
113
114 struct ToolSettings *BKE_toolsettings_copy(struct ToolSettings *toolsettings, const int flag);
115 void BKE_toolsettings_free(struct ToolSettings *toolsettings);
116
117 void BKE_scene_copy_data(struct Main *bmain, struct Scene *sce_dst, const struct Scene *sce_src, const int flag);
118 struct Scene *BKE_scene_copy(struct Main *bmain, struct Scene *sce, int type);
119 void BKE_scene_groups_relink(struct Scene *sce);
120
121 void BKE_scene_make_local(struct Main *bmain, struct Scene *sce, const bool lib_local);
122
123 struct Scene *BKE_scene_find_from_collection(const struct Main *bmain, const struct SceneCollection *scene_collection);
124
125 #ifdef DURIAN_CAMERA_SWITCH
126 struct Object *BKE_scene_camera_switch_find(struct Scene *scene); // DURIAN_CAMERA_SWITCH
127 #endif
128 int BKE_scene_camera_switch_update(struct Scene *scene);
129
130 char *BKE_scene_find_marker_name(struct Scene *scene, int frame);
131 char *BKE_scene_find_last_marker_name(struct Scene *scene, int frame);
132
133 /* checks for cycle, returns 1 if it's all OK */
134 bool BKE_scene_validate_setscene(struct Main *bmain, struct Scene *sce);
135
136 float BKE_scene_frame_get(const struct Scene *scene);
137 float BKE_scene_frame_get_from_ctime(const struct Scene *scene, const float frame);
138 void  BKE_scene_frame_set(struct Scene *scene, double cfra);
139
140 /* **  Scene evaluation ** */
141
142 void BKE_scene_graph_update_tagged(struct EvaluationContext *eval_ctx,
143                                    struct Depsgraph *depsgraph,
144                                    struct Main *bmain,
145                                    struct Scene *scene,
146                                    struct ViewLayer *view_layer);
147
148 void BKE_scene_graph_update_for_newframe(struct EvaluationContext *eval_ctx,
149                                          struct Depsgraph *depsgraph,
150                                          struct Main *bmain,
151                                          struct Scene *scene,
152                                          struct ViewLayer *view_layer);
153
154 struct SceneRenderView *BKE_scene_add_render_view(struct Scene *sce, const char *name);
155 bool BKE_scene_remove_render_view(struct Scene *scene, struct SceneRenderView *srv);
156
157 /* render profile */
158 int get_render_subsurf_level(const struct RenderData *r, int level, bool for_render);
159 int get_render_child_particle_number(const struct RenderData *r, int num, bool for_render);
160 int get_render_shadow_samples(const struct RenderData *r, int samples);
161 float get_render_aosss_error(const struct RenderData *r, float error);
162
163 bool BKE_scene_use_new_shading_nodes(const struct Scene *scene);
164 bool BKE_scene_use_shading_nodes_custom(struct Scene *scene);
165 bool BKE_scene_use_world_space_shading(struct Scene *scene);
166 bool BKE_scene_use_spherical_stereo(struct Scene *scene);
167
168 bool BKE_scene_uses_blender_internal(const struct Scene *scene);
169 bool BKE_scene_uses_blender_game(const struct Scene *scene);
170 bool BKE_scene_uses_blender_eevee(const struct Scene *scene);
171
172 void BKE_scene_disable_color_management(struct Scene *scene);
173 bool BKE_scene_check_color_management_enabled(const struct Scene *scene);
174 bool BKE_scene_check_rigidbody_active(const struct Scene *scene);
175
176 int BKE_scene_num_threads(const struct Scene *scene);
177 int BKE_render_num_threads(const struct RenderData *r);
178
179 int BKE_render_preview_pixel_size(const struct RenderData *r);
180
181 /**********************************/
182
183 struct ViewRender *BKE_viewrender_get(struct Scene *scene, struct WorkSpace *workspace);
184 void BKE_viewrender_init(struct ViewRender *view_render);
185 void BKE_viewrender_free(struct ViewRender *view_render);
186 void BKE_viewrender_copy(struct ViewRender *view_render_dst, const struct ViewRender *view_render_src);
187 bool BKE_viewrender_use_new_shading_nodes(const struct ViewRender *view_render);
188 bool BKE_viewrender_use_shading_nodes_custom(const struct ViewRender *view_render);
189 bool BKE_viewrender_use_world_space_shading(const struct ViewRender *view_render);
190 bool BKE_viewrender_use_spherical_stereo(const struct ViewRender *view_render);
191 bool BKE_viewrender_uses_blender_internal(const struct ViewRender *view_render);
192 bool BKE_viewrender_uses_blender_game(const struct ViewRender *view_render);
193 bool BKE_viewrender_uses_blender_eevee(const struct ViewRender *view_render);
194
195 /**********************************/
196
197 double BKE_scene_unit_scale(const struct UnitSettings *unit, const int unit_type, double value);
198
199 /* multiview */
200 bool        BKE_scene_multiview_is_stereo3d(const struct RenderData *rd);
201 bool        BKE_scene_multiview_is_render_view_active(const struct RenderData *rd, const struct SceneRenderView *srv);
202 bool        BKE_scene_multiview_is_render_view_first(const struct RenderData *rd, const char *viewname);
203 bool        BKE_scene_multiview_is_render_view_last(const struct RenderData *rd, const char *viewname);
204 int         BKE_scene_multiview_num_views_get(const struct RenderData *rd);
205 struct SceneRenderView *BKE_scene_multiview_render_view_findindex(const struct RenderData *rd, const int view_id);
206 const char *BKE_scene_multiview_render_view_name_get(const struct RenderData *rd, const int view_id);
207 int         BKE_scene_multiview_view_id_get(const struct RenderData *rd, const char *viewname);
208 void        BKE_scene_multiview_filepath_get(struct SceneRenderView *srv, const char *filepath, char *r_filepath);
209 void        BKE_scene_multiview_view_filepath_get(const struct RenderData *rd, const char *filepath, const char *view, char *r_filepath);
210 const char *BKE_scene_multiview_view_suffix_get(const struct RenderData *rd, const char *viewname);
211 const char *BKE_scene_multiview_view_id_suffix_get(const struct RenderData *rd, const int view_id);
212 void        BKE_scene_multiview_view_prefix_get(struct Scene *scene, const char *name, char *rprefix, const char **rext);
213 void        BKE_scene_multiview_videos_dimensions_get(const struct RenderData *rd, const size_t width, const size_t height, size_t *r_width, size_t *r_height);
214 int         BKE_scene_multiview_num_videos_get(const struct RenderData *rd);
215
216 /* depsgraph */
217 void BKE_scene_allocate_depsgraph_hash(struct Scene *scene);
218 void BKE_scene_ensure_depsgraph_hash(struct Scene *scene);
219 void BKE_scene_free_depsgraph_hash(struct Scene *scene);
220
221 struct Depsgraph *BKE_scene_get_depsgraph(struct Scene *scene, struct ViewLayer *view_layer, bool allocate);
222
223 #ifdef __cplusplus
224 }
225 #endif
226
227 #endif