2024-02-10 19:16:25 +01:00
|
|
|
/* SPDX-FileCopyrightText: 2001-2002 NaN Holding BV. All rights reserved.
|
|
|
|
*
|
|
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
/** \file
|
|
|
|
* \ingroup bke
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include "BLI_sys_types.h"
|
|
|
|
|
|
|
|
struct Base;
|
|
|
|
struct Collection;
|
|
|
|
struct Depsgraph;
|
|
|
|
struct DupliObject;
|
|
|
|
struct GHash;
|
|
|
|
struct Main;
|
|
|
|
struct ListBase;
|
|
|
|
struct Object;
|
|
|
|
struct RenderData;
|
|
|
|
struct Scene;
|
|
|
|
struct SceneRenderView;
|
|
|
|
struct ToolSettings;
|
|
|
|
struct TransformOrientation;
|
|
|
|
struct TransformOrientationSlot;
|
|
|
|
struct UnitSettings;
|
|
|
|
struct View3DCursor;
|
|
|
|
struct ViewLayer;
|
|
|
|
|
|
|
|
enum eSceneCopyMethod {
|
|
|
|
SCE_COPY_NEW = 0,
|
|
|
|
SCE_COPY_EMPTY = 1,
|
|
|
|
SCE_COPY_LINK_COLLECTION = 2,
|
|
|
|
SCE_COPY_FULL = 3,
|
|
|
|
};
|
|
|
|
|
|
|
|
/** Use as the contents of a 'for' loop: `for (SETLOOPER(...)) { ... }`. */
|
|
|
|
#define SETLOOPER(_sce_basis, _sce_iter, _base) \
|
|
|
|
_sce_iter = _sce_basis, \
|
|
|
|
_base = _setlooper_base_step( \
|
|
|
|
&_sce_iter, BKE_view_layer_context_active_PLACEHOLDER(_sce_basis), NULL); \
|
|
|
|
_base; \
|
|
|
|
_base = _setlooper_base_step(&_sce_iter, NULL, _base)
|
|
|
|
|
|
|
|
#define SETLOOPER_VIEW_LAYER(_sce_basis, _view_layer, _sce_iter, _base) \
|
|
|
|
_sce_iter = _sce_basis, _base = _setlooper_base_step(&_sce_iter, _view_layer, NULL); \
|
|
|
|
_base; \
|
|
|
|
_base = _setlooper_base_step(&_sce_iter, NULL, _base)
|
|
|
|
|
|
|
|
#define SETLOOPER_SET_ONLY(_sce_basis, _sce_iter, _base) \
|
|
|
|
_sce_iter = _sce_basis, _base = _setlooper_base_step(&_sce_iter, NULL, NULL); \
|
|
|
|
_base; \
|
|
|
|
_base = _setlooper_base_step(&_sce_iter, NULL, _base)
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Helper function for the #SETLOOPER and #SETLOOPER_VIEW_LAYER macros
|
|
|
|
*
|
|
|
|
* It iterates over the bases of the active layer and then the bases
|
|
|
|
* of the active layer of the background (set) scenes recursively.
|
|
|
|
*/
|
|
|
|
Base *_setlooper_base_step(Scene **sce_iter, ViewLayer *view_layer, Base *base);
|
|
|
|
|
|
|
|
Scene *BKE_scene_add(Main *bmain, const char *name);
|
|
|
|
|
|
|
|
void BKE_scene_remove_rigidbody_object(Main *bmain, Scene *scene, Object *ob, bool free_us);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Check if there is any instance of the object in the scene.
|
|
|
|
*/
|
|
|
|
bool BKE_scene_object_find(Scene *scene, Object *ob);
|
|
|
|
Object *BKE_scene_object_find_by_name(const Scene *scene, const char *name);
|
|
|
|
|
|
|
|
/* Scene base iteration function.
|
|
|
|
* Define struct here, so no need to bother with alloc/free it.
|
|
|
|
*/
|
|
|
|
struct SceneBaseIter {
|
|
|
|
ListBase *duplilist;
|
|
|
|
DupliObject *dupob;
|
|
|
|
float omat[4][4];
|
|
|
|
Object *dupli_refob;
|
|
|
|
int phase;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Used by meta-balls, return *all* objects (including duplis)
|
|
|
|
* existing in the scene (including scene's sets).
|
|
|
|
*/
|
|
|
|
int BKE_scene_base_iter_next(
|
|
|
|
Depsgraph *depsgraph, SceneBaseIter *iter, Scene **scene, int val, Base **base, Object **ob);
|
|
|
|
|
|
|
|
void BKE_scene_base_flag_to_objects(const Scene *scene, ViewLayer *view_layer);
|
|
|
|
/**
|
|
|
|
* Synchronize object base flags
|
|
|
|
*
|
|
|
|
* This is usually handled by the depsgraph.
|
|
|
|
* However, in rare occasions we need to use the latest object flags
|
|
|
|
* before depsgraph is fully updated.
|
|
|
|
*
|
|
|
|
* It should (ideally) only run for copy-on-written objects since this is
|
|
|
|
* runtime data generated per-view-layer.
|
|
|
|
*/
|
|
|
|
void BKE_scene_object_base_flag_sync_from_base(Base *base);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets the active scene, mainly used when running in background mode
|
|
|
|
* (`--scene` command line argument).
|
|
|
|
* This is also called to set the scene directly, bypassing windowing code.
|
|
|
|
* Otherwise #WM_window_set_active_scene is used when changing scenes by the user.
|
|
|
|
*/
|
|
|
|
void BKE_scene_set_background(Main *bmain, Scene *sce);
|
|
|
|
/**
|
2024-03-20 23:49:19 +01:00
|
|
|
* Called from `creator_args.cc`.
|
2024-02-10 19:16:25 +01:00
|
|
|
*/
|
|
|
|
Scene *BKE_scene_set_name(Main *bmain, const char *name);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* \param flag: copying options (see BKE_lib_id.hh's `LIB_ID_COPY_...` flags for more).
|
|
|
|
*/
|
|
|
|
ToolSettings *BKE_toolsettings_copy(ToolSettings *toolsettings, int flag);
|
|
|
|
void BKE_toolsettings_free(ToolSettings *toolsettings);
|
|
|
|
|
|
|
|
Scene *BKE_scene_duplicate(Main *bmain, Scene *sce, eSceneCopyMethod type);
|
|
|
|
void BKE_scene_groups_relink(Scene *sce);
|
|
|
|
|
|
|
|
bool BKE_scene_can_be_removed(const Main *bmain, const Scene *scene);
|
|
|
|
|
|
|
|
bool BKE_scene_has_view_layer(const Scene *scene, const ViewLayer *layer);
|
|
|
|
Scene *BKE_scene_find_from_collection(const Main *bmain, const Collection *collection);
|
|
|
|
|
|
|
|
#ifdef DURIAN_CAMERA_SWITCH
|
|
|
|
Object *BKE_scene_camera_switch_find(Scene *scene); /* DURIAN_CAMERA_SWITCH */
|
|
|
|
#endif
|
|
|
|
bool BKE_scene_camera_switch_update(Scene *scene);
|
|
|
|
|
|
|
|
const char *BKE_scene_find_marker_name(const Scene *scene, int frame);
|
|
|
|
/**
|
|
|
|
* Return the current marker for this frame,
|
|
|
|
* we can have more than 1 marker per frame, this just returns the first (unfortunately).
|
|
|
|
*/
|
|
|
|
const char *BKE_scene_find_last_marker_name(const Scene *scene, int frame);
|
|
|
|
|
|
|
|
int BKE_scene_frame_snap_by_seconds(Scene *scene, double interval_in_seconds, int frame);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Checks for cycle, returns true if it's all OK.
|
|
|
|
*/
|
|
|
|
bool BKE_scene_validate_setscene(Main *bmain, Scene *sce);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return fractional frame number taking into account sub-frames and time
|
|
|
|
* remapping. This the time value used by animation, modifiers and physics
|
|
|
|
* evaluation. */
|
|
|
|
float BKE_scene_ctime_get(const Scene *scene);
|
|
|
|
/**
|
|
|
|
* Convert integer frame number to fractional frame number taking into account
|
|
|
|
* sub-frames and time remapping.
|
|
|
|
*/
|
|
|
|
float BKE_scene_frame_to_ctime(const Scene *scene, int frame);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get current fractional frame based on frame and sub-frame.
|
|
|
|
*/
|
|
|
|
float BKE_scene_frame_get(const Scene *scene);
|
|
|
|
/**
|
|
|
|
* Set current frame and sub-frame based on a fractional frame.
|
|
|
|
*/
|
|
|
|
void BKE_scene_frame_set(Scene *scene, float frame);
|
|
|
|
|
|
|
|
TransformOrientationSlot *BKE_scene_orientation_slot_get_from_flag(Scene *scene, int flag);
|
|
|
|
TransformOrientationSlot *BKE_scene_orientation_slot_get(Scene *scene, int slot_index);
|
|
|
|
/**
|
|
|
|
* Activate a transform orientation in a 3D view based on an enum value.
|
|
|
|
*
|
|
|
|
* \param orientation: If this is #V3D_ORIENT_CUSTOM or greater, the custom transform orientation
|
|
|
|
* with index \a orientation - #V3D_ORIENT_CUSTOM gets activated.
|
|
|
|
*/
|
|
|
|
void BKE_scene_orientation_slot_set_index(TransformOrientationSlot *orient_slot, int orientation);
|
|
|
|
int BKE_scene_orientation_slot_get_index(const TransformOrientationSlot *orient_slot);
|
|
|
|
int BKE_scene_orientation_get_index(Scene *scene, int slot_index);
|
|
|
|
int BKE_scene_orientation_get_index_from_flag(Scene *scene, int flag);
|
|
|
|
|
|
|
|
/* ** Scene evaluation ** */
|
|
|
|
|
|
|
|
void BKE_scene_update_sound(Depsgraph *depsgraph, Main *bmain);
|
|
|
|
void BKE_scene_update_tag_audio_volume(Depsgraph *, Scene *scene);
|
|
|
|
|
|
|
|
void BKE_scene_graph_update_tagged(Depsgraph *depsgraph, Main *bmain);
|
|
|
|
void BKE_scene_graph_evaluated_ensure(Depsgraph *depsgraph, Main *bmain);
|
|
|
|
|
|
|
|
void BKE_scene_graph_update_for_newframe(Depsgraph *depsgraph);
|
|
|
|
/**
|
|
|
|
* Applies changes right away, does all sets too.
|
|
|
|
*/
|
|
|
|
void BKE_scene_graph_update_for_newframe_ex(Depsgraph *depsgraph, bool clear_recalc);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Ensures given scene/view_layer pair has a valid, up-to-date depsgraph.
|
|
|
|
*
|
|
|
|
* \warning Sets matching depsgraph as active,
|
|
|
|
* so should only be called from the active editing context (usually, from operators).
|
|
|
|
*/
|
|
|
|
void BKE_scene_view_layer_graph_evaluated_ensure(Main *bmain, Scene *scene, ViewLayer *view_layer);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return default view.
|
|
|
|
*/
|
|
|
|
SceneRenderView *BKE_scene_add_render_view(Scene *sce, const char *name);
|
|
|
|
bool BKE_scene_remove_render_view(Scene *scene, SceneRenderView *srv);
|
|
|
|
|
|
|
|
/* Render profile. */
|
|
|
|
|
|
|
|
int get_render_subsurf_level(const RenderData *r, int lvl, bool for_render);
|
|
|
|
int get_render_child_particle_number(const RenderData *r, int child_num, bool for_render);
|
|
|
|
|
|
|
|
bool BKE_scene_use_shading_nodes_custom(Scene *scene);
|
|
|
|
bool BKE_scene_use_spherical_stereo(Scene *scene);
|
|
|
|
|
|
|
|
bool BKE_scene_uses_blender_eevee(const Scene *scene);
|
|
|
|
bool BKE_scene_uses_blender_workbench(const Scene *scene);
|
|
|
|
bool BKE_scene_uses_cycles(const Scene *scene);
|
|
|
|
|
|
|
|
bool BKE_scene_uses_shader_previews(const Scene *scene);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return whether the Cycles experimental feature is enabled. It is invalid to call without first
|
|
|
|
* ensuring that Cycles is the active render engine (e.g. with #BKE_scene_uses_cycles).
|
|
|
|
*
|
|
|
|
* \note We cannot use `const` as RNA_id_pointer_create is not using a const ID.
|
|
|
|
*/
|
|
|
|
bool BKE_scene_uses_cycles_experimental_features(Scene *scene);
|
|
|
|
|
|
|
|
void BKE_scene_copy_data_eevee(Scene *sce_dst, const Scene *sce_src);
|
|
|
|
|
|
|
|
void BKE_scene_disable_color_management(Scene *scene);
|
|
|
|
bool BKE_scene_check_rigidbody_active(const Scene *scene);
|
|
|
|
|
|
|
|
int BKE_scene_num_threads(const Scene *scene);
|
|
|
|
int BKE_render_num_threads(const RenderData *r);
|
|
|
|
|
|
|
|
void BKE_render_resolution(const RenderData *r, const bool use_crop, int *r_width, int *r_height);
|
|
|
|
int BKE_render_preview_pixel_size(const RenderData *r);
|
|
|
|
|
|
|
|
/**********************************/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Apply the needed correction factor to value, based on unit_type
|
|
|
|
* (only length-related are affected currently) and `unit->scale_length`.
|
|
|
|
*/
|
|
|
|
double BKE_scene_unit_scale(const UnitSettings *unit, int unit_type, double value);
|
|
|
|
|
|
|
|
/* Multi-view. */
|
|
|
|
|
|
|
|
bool BKE_scene_multiview_is_stereo3d(const RenderData *rd);
|
|
|
|
/**
|
|
|
|
* Return whether to render this #SceneRenderView.
|
|
|
|
*/
|
|
|
|
bool BKE_scene_multiview_is_render_view_active(const RenderData *rd, const SceneRenderView *srv);
|
|
|
|
/**
|
|
|
|
* \return true if `viewname` is the first or if the name is NULL or not found.
|
|
|
|
*/
|
|
|
|
bool BKE_scene_multiview_is_render_view_first(const RenderData *rd, const char *viewname);
|
|
|
|
/**
|
|
|
|
* \return true if `viewname` is the last or if the name is NULL or not found.
|
|
|
|
*/
|
|
|
|
bool BKE_scene_multiview_is_render_view_last(const RenderData *rd, const char *viewname);
|
|
|
|
int BKE_scene_multiview_num_views_get(const RenderData *rd);
|
|
|
|
SceneRenderView *BKE_scene_multiview_render_view_findindex(const RenderData *rd, int view_id);
|
|
|
|
const char *BKE_scene_multiview_render_view_name_get(const RenderData *rd, int view_id);
|
|
|
|
int BKE_scene_multiview_view_id_get(const RenderData *rd, const char *viewname);
|
|
|
|
void BKE_scene_multiview_filepath_get(const SceneRenderView *srv,
|
|
|
|
const char *filepath,
|
|
|
|
char *r_filepath);
|
|
|
|
/**
|
|
|
|
* When multi-view is not used the `filepath` is as usual (e.g., `Image.jpg`).
|
|
|
|
* When multi-view is on, even if only one view is enabled the view is incorporated
|
|
|
|
* into the file name (e.g., `Image_L.jpg`). That allows for the user to re-render
|
|
|
|
* individual views.
|
|
|
|
*/
|
|
|
|
void BKE_scene_multiview_view_filepath_get(const RenderData *rd,
|
|
|
|
const char *filepath,
|
|
|
|
const char *view,
|
|
|
|
char *r_filepath);
|
|
|
|
const char *BKE_scene_multiview_view_suffix_get(const RenderData *rd, const char *viewname);
|
|
|
|
const char *BKE_scene_multiview_view_id_suffix_get(const RenderData *rd, int view_id);
|
|
|
|
void BKE_scene_multiview_view_prefix_get(Scene *scene,
|
2024-03-28 10:57:46 +01:00
|
|
|
const char *filepath,
|
2024-02-10 19:16:25 +01:00
|
|
|
char *r_prefix,
|
|
|
|
const char **r_ext);
|
|
|
|
void BKE_scene_multiview_videos_dimensions_get(
|
|
|
|
const RenderData *rd, size_t width, size_t height, size_t *r_width, size_t *r_height);
|
|
|
|
int BKE_scene_multiview_num_videos_get(const RenderData *rd);
|
|
|
|
|
|
|
|
/* depsgraph */
|
|
|
|
void BKE_scene_allocate_depsgraph_hash(Scene *scene);
|
|
|
|
void BKE_scene_ensure_depsgraph_hash(Scene *scene);
|
|
|
|
void BKE_scene_free_depsgraph_hash(Scene *scene);
|
|
|
|
void BKE_scene_free_view_layer_depsgraph(Scene *scene, ViewLayer *view_layer);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* \note Do not allocate new depsgraph.
|
|
|
|
*/
|
|
|
|
Depsgraph *BKE_scene_get_depsgraph(const Scene *scene, const ViewLayer *view_layer);
|
|
|
|
/**
|
|
|
|
* \note Allocate new depsgraph if necessary.
|
|
|
|
*/
|
|
|
|
Depsgraph *BKE_scene_ensure_depsgraph(Main *bmain, Scene *scene, ViewLayer *view_layer);
|
|
|
|
|
|
|
|
GHash *BKE_scene_undo_depsgraphs_extract(Main *bmain);
|
|
|
|
void BKE_scene_undo_depsgraphs_restore(Main *bmain, GHash *depsgraph_extract);
|
|
|
|
|
|
|
|
void BKE_scene_transform_orientation_remove(Scene *scene, TransformOrientation *orientation);
|
|
|
|
TransformOrientation *BKE_scene_transform_orientation_find(const Scene *scene, int index);
|
|
|
|
/**
|
|
|
|
* \return the index that \a orientation has within \a scene's transform-orientation list
|
|
|
|
* or -1 if not found.
|
|
|
|
*/
|
|
|
|
int BKE_scene_transform_orientation_get_index(const Scene *scene,
|
|
|
|
const TransformOrientation *orientation);
|
|
|
|
|
|
|
|
void BKE_scene_cursor_rot_to_mat3(const View3DCursor *cursor, float mat[3][3]);
|
|
|
|
void BKE_scene_cursor_mat3_to_rot(View3DCursor *cursor, const float mat[3][3], bool use_compat);
|
|
|
|
|
|
|
|
void BKE_scene_cursor_rot_to_quat(const View3DCursor *cursor, float quat[4]);
|
|
|
|
void BKE_scene_cursor_quat_to_rot(View3DCursor *cursor, const float quat[4], bool use_compat);
|
|
|
|
|
|
|
|
void BKE_scene_cursor_to_mat4(const View3DCursor *cursor, float mat[4][4]);
|
|
|
|
void BKE_scene_cursor_from_mat4(View3DCursor *cursor, const float mat[4][4], bool use_compat);
|