General operations, lookup, etc. for blender objects. More...

#include <optional>
#include "BLI_bounds_types.hh"
#include "BLI_compiler_attrs.h"
#include "BLI_function_ref.hh"
#include "BLI_math_matrix_types.hh"
#include "BLI_math_vector_types.hh"
#include "BLI_sys_types.h"
#include "BLI_vector.hh"
#include "DNA_object_enums.h"
#include "DNA_userdef_enums.h"

Classes
struct	ObjectTfmProtectedChannels

Macros
#define	OBJECT_MODIFIER_UPDATE_SUBFRAME_RECURSION_DEFAULT 5

Enumerations
enum	eObjectVisibilityResult { OB_VISIBLE_SELF = 1 , OB_VISIBLE_PARTICLES = 2 , OB_VISIBLE_INSTANCES = 4 , OB_VISIBLE_ALL = (OB_VISIBLE_SELF \| OB_VISIBLE_PARTICLES \| OB_VISIBLE_INSTANCES) }
enum	eObRelationTypes { OB_REL_NONE = 0 , OB_REL_PARENT = (1 << 0) , OB_REL_PARENT_RECURSIVE = (1 << 1) , OB_REL_CHILDREN = (1 << 2) , OB_REL_CHILDREN_RECURSIVE = (1 << 3) , OB_REL_MOD_ARMATURE = (1 << 4) }
enum	eObjectSet { OB_SET_SELECTED , OB_SET_VISIBLE , OB_SET_ALL }

Functions
void	BKE_object_workob_clear (Object *workob)
blender::float4x4	BKE_object_calc_parent (Depsgraph depsgraph, Scene scene, Object *ob)
void	BKE_object_transform_copy (Object ob_tar, const Object ob_src)
void	BKE_object_copy_softbody (Object ob_dst, const Object ob_src, int flag)
ParticleSystem *	BKE_object_copy_particlesystem (ParticleSystem *psys, int flag)
void	BKE_object_copy_particlesystems (Object ob_dst, const Object ob_src, int flag)
void	BKE_object_free_particlesystems (Object *ob)
void	BKE_object_free_softbody (Object *ob)
void	BKE_object_free_curve_cache (Object *ob)
void	BKE_object_free_derived_caches (Object *ob)
void	BKE_object_free_caches (Object *object)
void	BKE_object_modifier_hook_reset (Object ob, HookModifierData hmd)
void	BKE_object_modifier_gpencil_hook_reset (Object ob, HookGpencilModifierData hmd)
bool	BKE_object_supports_modifiers (const Object *ob)
bool	BKE_object_support_modifier_type_check (const Object *ob, int modifier_type)
void	BKE_object_modifier_set_active (Object ob, ModifierData md)
ModifierData *	BKE_object_active_modifier (const Object *ob)
bool	BKE_object_copy_modifier (Main bmain, const Scene scene, Object ob_dst, const Object ob_src, const ModifierData *md)
bool	BKE_object_modifier_stack_copy (Object ob_dst, const Object ob_src, bool do_copy_all, int flag_subdata)
void	BKE_object_link_modifiers (Object ob_dst, const Object ob_src)
void	BKE_object_free_modifiers (Object *ob, int flag)
void	BKE_object_free_shaderfx (Object *ob, int flag)
bool	BKE_object_exists_check (Main bmain, const Object obtest)
bool	BKE_object_is_in_editmode (const Object *ob)
bool	BKE_object_is_in_editmode_vgroup (const Object *ob)
bool	BKE_object_is_in_wpaint_select_vert (const Object *ob)
bool	BKE_object_has_mode_data (const Object *ob, eObjectMode object_mode)
bool	BKE_object_is_mode_compat (const Object *ob, eObjectMode object_mode)
bool	BKE_object_data_is_in_editmode (const Object ob, const ID id)
char *	BKE_object_data_editmode_flush_ptr_get (ID *id)
void	BKE_object_update_select_id (Main *bmain)
int	BKE_object_visibility (const Object *ob, int dag_eval_mode)
Object *	BKE_object_add_only_object (Main bmain, int type, const char name) ATTR_RETURNS_NONNULL
Object *	BKE_object_add (Main bmain, Scene scene, ViewLayer view_layer, int type, const char name) ATTR_NONNULL(1
Object *	BKE_object_add_from (Main bmain, Scene scene, ViewLayer view_layer, int type, const char name, Object *ob_src) ATTR_NONNULL(1
Object *	BKE_object_add_for_data (Main bmain, const Scene scene, ViewLayer view_layer, int type, const char name, ID *data, bool do_id_user) ATTR_RETURNS_NONNULL
void *	BKE_object_obdata_add_from_type (Main bmain, int type, const char name) ATTR_NONNULL(1)
int	BKE_object_obdata_to_type (const ID *id) ATTR_NONNULL(1)
bool	BKE_object_is_libdata (const Object *ob)
bool	BKE_object_obdata_is_libdata (const Object *ob)
Object *	BKE_object_duplicate (Main bmain, Object ob, eDupli_ID_Flags dupflag, uint duplicate_options)
void	BKE_object_obdata_size_init (Object *ob, float size)
void	BKE_object_scale_to_mat3 (const Object *ob, float r_mat[3][3])
void	BKE_object_rot_to_mat3 (const Object *ob, float r_mat[3][3], bool use_drot)
void	BKE_object_mat3_to_rot (Object *ob, float r_mat[3][3], bool use_compat)
void	BKE_object_to_mat3 (const Object *ob, float r_mat[3][3])
void	BKE_object_to_mat4 (const Object *ob, float r_mat[4][4])
void	BKE_object_apply_mat4_ex (Object ob, const float mat[4][4], Object parent, const float parentinv[4][4], bool use_compat)
void	BKE_object_apply_mat4 (Object *ob, const float mat[4][4], bool use_compat, bool use_parent)
void	BKE_object_apply_parent_inverse (Object *ob)
void	BKE_object_matrix_local_get (Object *ob, float r_mat[4][4])
bool	BKE_object_pose_context_check (const Object *ob)
Object *	BKE_object_pose_armature_get (Object *ob)
Object *	BKE_object_pose_armature_get_with_wpaint_check (Object *ob)
Object *	BKE_object_pose_armature_get_visible (Object ob, const Scene scene, ViewLayer view_layer, View3D v3d)
blender::Vector< Object * >	BKE_object_pose_array_get_ex (const Scene scene, ViewLayer view_layer, View3D *v3d, bool unique)
blender::Vector< Object * >	BKE_object_pose_array_get_unique (const Scene scene, ViewLayer view_layer, View3D *v3d)
blender::Vector< Object * >	BKE_object_pose_array_get (const Scene scene, ViewLayer view_layer, View3D *v3d)
blender::Vector< Base * >	BKE_object_pose_base_array_get_ex (const Scene scene, ViewLayer view_layer, View3D *v3d, bool unique)
blender::Vector< Base * >	BKE_object_pose_base_array_get_unique (const Scene scene, ViewLayer view_layer, View3D *v3d)
blender::Vector< Base * >	BKE_object_pose_base_array_get (const Scene scene, ViewLayer view_layer, View3D *v3d)
void	BKE_object_get_parent_matrix (const Object ob, Object par, float r_parentmat[4][4])
void	BKE_object_where_is_calc (Depsgraph depsgraph, Scene scene, Object *ob)
void	BKE_object_where_is_calc_ex (Depsgraph depsgraph, Scene scene, RigidBodyWorld rbw, Object ob, float r_originmat[3][3])
void	BKE_object_where_is_calc_time (Depsgraph depsgraph, Scene scene, Object *ob, float ctime)
void	BKE_object_where_is_calc_mat4 (const Object *ob, float r_obmat[4][4])
std::optional< blender::Bounds< blender::float3 > >	BKE_object_evaluated_geometry_bounds (const Object *ob)
std::optional< blender::Bounds< blender::float3 > >	BKE_object_boundbox_get (const Object *ob)
void	BKE_object_dimensions_get (const Object *ob, float r_vec[3])
std::optional< blender::Bounds< blender::float3 > >	BKE_object_boundbox_eval_cached_get (const Object *ob)
void	BKE_object_dimensions_eval_cached_get (const Object *ob, float r_vec[3])
void	BKE_object_dimensions_set_ex (Object *ob, const float value[3], int axis_mask, const float ob_scale_orig[3], const float ob_obmat_orig[4][4])
void	BKE_object_dimensions_set (Object *ob, const float value[3], int axis_mask)
void	BKE_object_empty_draw_type_set (Object *ob, int value)
void	BKE_object_minmax (Object *ob, blender::float3 &r_min, blender::float3 &r_max)
bool	BKE_object_minmax_dupli (Depsgraph depsgraph, Scene scene, Object *ob, blender::float3 &r_min, blender::float3 &r_max, bool use_hidden)
bool	BKE_object_minmax_empty_drawtype (const Object *ob, float r_min[3], float r_max[3])
void	BKE_object_foreach_display_point (Object ob, const float obmat[4][4], void(func_cb)(const float[3], void ), void user_data)
void	BKE_scene_foreach_display_point (Depsgraph depsgraph, void(func_cb)(const float[3], void ), void user_data)
bool	BKE_object_parent_loop_check (const Object parent, const Object ob)
void *	BKE_object_tfm_backup (Object *ob)
void	BKE_object_tfm_restore (Object ob, void obtfm_pt)
void	BKE_object_tfm_protected_backup (const Object ob, ObjectTfmProtectedChannels obtfm)
void	BKE_object_tfm_protected_restore (Object ob, const ObjectTfmProtectedChannels obtfm, short protectflag)
void	BKE_object_tfm_copy (Object object_dst, const Object object_src)
void	BKE_object_eval_reset (Object *ob_eval)
void	BKE_object_eval_local_transform (Depsgraph depsgraph, Object ob)
void	BKE_object_eval_parent (Depsgraph depsgraph, Object ob)
void	BKE_object_eval_constraints (Depsgraph depsgraph, Scene scene, Object *ob)
void	BKE_object_eval_transform_final (Depsgraph depsgraph, Object ob)
void	BKE_object_eval_uber_transform (Depsgraph depsgraph, Object object)
void	BKE_object_eval_uber_data (Depsgraph depsgraph, Scene scene, Object *ob)
void	BKE_object_eval_shading (Depsgraph depsgraph, Object object)
void	BKE_object_eval_light_linking (Depsgraph depsgraph, Object object)
void	BKE_object_eval_assign_data (Object object, ID data, bool is_owned)
void	BKE_object_sync_to_original (Depsgraph depsgraph, Object object)
void	BKE_object_eval_ptcache_reset (Depsgraph depsgraph, Scene scene, Object *object)
void	BKE_object_eval_transform_all (Depsgraph depsgraph, Scene scene, Object *object)
void	BKE_object_data_select_update (Depsgraph depsgraph, ID object_data)
void	BKE_object_select_update (Depsgraph depsgraph, Object object)
void	BKE_object_eval_eval_base_flags (Depsgraph depsgraph, Scene scene, int view_layer_index, Object *object, int base_index, bool is_from_set)
void	BKE_object_handle_data_update (Depsgraph depsgraph, Scene scene, Object *ob)
void	BKE_object_handle_update (Depsgraph depsgraph, Scene scene, Object *ob)
void	BKE_object_handle_update_ex (Depsgraph depsgraph, Scene scene, Object ob, RigidBodyWorld rbw)
void	BKE_object_sculpt_data_create (Object *ob)
bool	BKE_object_obdata_texspace_get (Object ob, char r_texspace_flag, float r_texspace_location, float *r_texspace_size)
Mesh *	BKE_object_get_evaluated_mesh_no_subsurf (const Object *object_eval)
Mesh *	BKE_object_get_evaluated_mesh (const Object *object_eval)
Mesh *	BKE_object_get_evaluated_mesh_no_subsurf_unchecked (const Object *object)
Mesh *	BKE_object_get_evaluated_mesh_unchecked (const Object *object)
const Mesh *	BKE_object_get_pre_modified_mesh (const Object *object)
Mesh *	BKE_object_get_original_mesh (const Object *object)
const Mesh *	BKE_object_get_editmesh_eval_final (const Object *object)
const Mesh *	BKE_object_get_editmesh_eval_cage (const Object *object)
const Mesh *	BKE_object_get_mesh_deform_eval (const Object *object)
Lattice *	BKE_object_get_lattice (const Object *object)
Lattice *	BKE_object_get_evaluated_lattice (const Object *object)
int	BKE_object_insert_ptcache (Object *ob)
void	BKE_object_delete_ptcache (Object *ob, int index)
KeyBlock *	BKE_object_shapekey_insert (Main bmain, Object ob, const char *name, bool from_mix)
bool	BKE_object_shapekey_remove (Main bmain, Object ob, KeyBlock *kb)
bool	BKE_object_shapekey_free (Main bmain, Object ob)
bool	BKE_object_flag_test_recursive (const Object *ob, short flag)
bool	BKE_object_is_child_recursive (const Object ob_parent, const Object ob_child)
int	BKE_object_is_modified (Scene scene, Object ob)
int	BKE_object_is_deform_modified (Scene scene, Object ob)
bool	BKE_object_moves_in_time (const Object *object, bool recurse_parent)
int	BKE_object_scenes_users_get (Main bmain, Object ob)
MovieClip *	BKE_object_movieclip_get (Scene scene, const Object ob, bool use_default)
void	BKE_object_runtime_reset (Object *object)
void	BKE_object_runtime_reset_on_copy (Object *object, int flag)
void	BKE_object_runtime_free_data (Object *object)
void	BKE_object_batch_cache_dirty_tag (Object *ob)
LinkNode *	BKE_object_relational_superset (const Scene scene, ViewLayer view_layer, eObjectSet objectSet, eObRelationTypes includeFilter)
LinkNode *	BKE_object_groups (Main bmain, Scene scene, Object *ob)
void	BKE_object_groups_clear (Main bmain, Scene scene, Object *object)
KDTree_3d *	BKE_object_as_kdtree (Object ob, int r_tot)
void	BKE_object_modifier_update_subframe (Depsgraph depsgraph, Scene scene, Object *ob, bool update_mesh, int parent_recursion_limit, float frame, int modifier_type)
void	BKE_object_modifier_update_subframe_only_callback (Object ob, bool update_mesh, int parent_recursion_limit, int modifier_type, blender::FunctionRef< void(Object object, bool update_mesh)> update_or_tag_fn)
bool	BKE_object_empty_image_frame_is_visible_in_view3d (const Object ob, const RegionView3D rv3d)
bool	BKE_object_empty_image_data_is_visible_in_view3d (const Object ob, const RegionView3D rv3d)
Mesh *	BKE_object_to_mesh (Depsgraph depsgraph, Object object, bool preserve_all_data_layers)
void	BKE_object_to_mesh_clear (Object *object)
Curve *	BKE_object_to_curve (Object object, Depsgraph depsgraph, bool apply_modifiers)
void	BKE_object_to_curve_clear (Object *object)
void	BKE_object_check_uids_unique_and_report (const Object *object)
SubsurfModifierData *	BKE_object_get_last_subsurf_modifier (const Object *ob)
void	BKE_object_replace_data_on_shallow_copy (Object ob, ID new_data)
PartEff *	BKE_object_do_version_give_parteff_245 (Object *ob)
bool	BKE_object_supports_material_slots (Object *ob)
void	BKE_object_protected_location_set (Object *ob, const float location[3])
void	BKE_object_protected_scale_set (Object *ob, const float scale[3])
void	BKE_object_protected_rotation_quaternion_set (Object *ob, const float quat[4])
void	BKE_object_protected_rotation_euler_set (Object *ob, const float euler[3])
void	BKE_object_protected_rotation_axisangle_set (Object *ob, const float axis[3], float angle)

Variables
Object	ATTR_RETURNS_NONNULL

Detailed Description

General operations, lookup, etc. for blender objects.

Definition in file BKE_object.hh.

Macro Definition Documentation

◆ OBJECT_MODIFIER_UPDATE_SUBFRAME_RECURSION_DEFAULT

#define OBJECT_MODIFIER_UPDATE_SUBFRAME_RECURSION_DEFAULT 5

The number of times to recurse parents for evaluation.

NOTE(@ideasman42): This value was picked to avoid infinite recursion. 5 is arbitrary but changing it would change behavior in some corner cases. See code comments in BKE_object_modifier_update_subframe_only_callback for details.

Definition at line 661 of file BKE_object.hh.

Referenced by DEG_add_collision_relations().

Enumeration Type Documentation

◆ eObjectSet

enum eObjectSet

Enumerator
OB_SET_SELECTED
OB_SET_VISIBLE
OB_SET_ALL

Definition at line 620 of file BKE_object.hh.

◆ eObjectVisibilityResult

enum eObjectVisibilityResult

Enumerator
OB_VISIBLE_SELF
OB_VISIBLE_PARTICLES
OB_VISIBLE_INSTANCES
OB_VISIBLE_ALL

Definition at line 147 of file BKE_object.hh.

◆ eObRelationTypes

enum eObRelationTypes

Enumerator
OB_REL_NONE
OB_REL_PARENT
OB_REL_PARENT_RECURSIVE
OB_REL_CHILDREN
OB_REL_CHILDREN_RECURSIVE
OB_REL_MOD_ARMATURE

Definition at line 610 of file BKE_object.hh.

Function Documentation

◆ BKE_object_active_modifier()

ModifierData * BKE_object_active_modifier ( const Object * ob )

Definition at line 1231 of file blenkernel/intern/object.cc.

References BLI_assert, ELEM, eModifierFlag_Active, LISTBASE_FOREACH, and Object::modifiers.

Referenced by buttons_context_path_modifier(), blender::ed::object::edit_modifier_poll_generic(), blender::nodes::gizmos::foreach_active_gizmo(), blender::ed::object::geometry_node_tree_copy_assign_exec(), geometry_node_tree_get_from_context(), blender::ed::space_node::get_context_path_node_geometry(), and blender::ed::outliner::tree_element_modifier_state_get().

◆ BKE_object_add()

Object * BKE_object_add	(	Main *	bmain,
		Scene *	scene,
		ViewLayer *	view_layer,
		int	type,
		const char *	name )

General add: to scene, with layer from area and default name.

Object is added to the active Collection. If there is no linked collection to the active ViewLayer we create a new one.

Note: Creates minimum required data, but without vertices etc.

Referenced by blender::ed::object::add_hook_object_new(), blender::ed::object::add_type_with_obdata(), Freestyle::BlenderStrokeRenderer::BlenderStrokeRenderer(), blender::ed::object::convert_psys_to_mesh(), blender::ed::curves::convert_from_particle_system::curves_convert_from_particle_system_exec(), Freestyle::BlenderStrokeRenderer::GenerateStrokeMesh(), blender::ed::object::get_new_constraint_target(), blender::ed::object::modifier_skin_armature_create(), object_preview_camera_create(), and txt_add_object().

◆ BKE_object_add_for_data()

Object * BKE_object_add_for_data	(	Main *	bmain,
		const Scene *	scene,
		ViewLayer *	view_layer,
		int	type,
		const char *	name,
		ID *	data,
		bool	do_id_user )

Add a new object, but assign the given data-block as the ob->data for the newly created object.

Parameters

data	The data-block to assign as ob->data for the new object. This is assumed to be of the correct type.
do_id_user	If true, id_us_plus() will be called on data when assigning it to the object.

Definition at line 2142 of file blenkernel/intern/object.cc.

References BKE_collection_object_add(), BKE_layer_collection_get_active(), BKE_object_add_only_object(), BKE_view_layer_base_deselect_all(), BKE_view_layer_base_find(), BKE_view_layer_base_select_and_set_active(), BKE_view_layer_synced_ensure(), LayerCollection::collection, data, Object::data, DEG_id_tag_update_ex(), Object::id, ID_RECALC_ANIMATION, ID_RECALC_GEOMETRY, ID_RECALC_TRANSFORM, id_us_plus(), and name.

Referenced by blender::ed::object::add_type_with_obdata(), and BKE_object_add_from().

◆ BKE_object_add_from()

Object * BKE_object_add_from	(	Main *	bmain,
		Scene *	scene,
		ViewLayer *	view_layer,
		int	type,
		const char *	name,
		Object *	ob_src )

Add a new object, using another one as a reference

Parameters

ob_src object to use to determine the collections of the new object.

References ATTR_NONNULL, ATTR_RETURNS_NONNULL, BKE_object_add_for_data(), BKE_object_add_from(), BKE_object_apply_mat4(), BKE_object_apply_mat4_ex(), BKE_object_apply_parent_inverse(), BKE_object_boundbox_eval_cached_get(), BKE_object_boundbox_get(), BKE_object_dimensions_eval_cached_get(), BKE_object_dimensions_get(), BKE_object_dimensions_set(), BKE_object_dimensions_set_ex(), BKE_object_duplicate(), BKE_object_empty_draw_type_set(), BKE_object_evaluated_geometry_bounds(), BKE_object_get_parent_matrix(), BKE_object_is_libdata(), BKE_object_mat3_to_rot(), BKE_object_matrix_local_get(), BKE_object_obdata_add_from_type(), BKE_object_obdata_is_libdata(), BKE_object_obdata_size_init(), BKE_object_obdata_to_type(), BKE_object_pose_armature_get(), BKE_object_pose_armature_get_visible(), BKE_object_pose_armature_get_with_wpaint_check(), BKE_object_pose_array_get(), BKE_object_pose_array_get_ex(), BKE_object_pose_array_get_unique(), BKE_object_pose_base_array_get(), BKE_object_pose_base_array_get_ex(), BKE_object_pose_base_array_get_unique(), BKE_object_pose_context_check(), BKE_object_rot_to_mat3(), BKE_object_scale_to_mat3(), BKE_object_to_mat3(), BKE_object_to_mat4(), BKE_object_where_is_calc(), BKE_object_where_is_calc_ex(), BKE_object_where_is_calc_mat4(), BKE_object_where_is_calc_time(), data, depsgraph, name, and size().

Referenced by BKE_object_add_from().

◆ BKE_object_add_only_object()

Object * BKE_object_add_only_object	(	Main *	bmain,
		int	type,
		const char *	name )

More general add: creates minimum required data, but without vertices etc.

Parameters

bmain The main to add the object to. May be null for LIB_ID_CREATE_NO_MAIN behavior.

Definition at line 2080 of file blenkernel/intern/object.cc.

References BKE_libblock_alloc(), get_obdata_defname(), Object::id, ID_OB, id_us_min(), LIB_ID_CREATE_NO_MAIN, name, and object_init().

◆ BKE_object_apply_mat4()

void BKE_object_apply_mat4	(	Object *	ob,
		const float	mat[4][4],
		bool	use_compat,
		bool	use_parent )

See BKE_object_apply_mat4_ex

Definition at line 3445 of file blenkernel/intern/object.cc.

References BKE_object_apply_mat4_ex(), Object::parent, and Object::parentinv.

◆ BKE_object_apply_mat4_ex()

void BKE_object_apply_mat4_ex	(	Object *	ob,
		const float	mat[4][4],
		Object *	parent,
		const float	parentinv[4][4],
		bool	use_compat )

Applies the global transformation mat to the ob using a relative parent space if supplied.

Parameters

mat	the global transformation mat that the object should be set object to.
parent	the parent space in which this object will be set relative to (should probably always be parent_eval).
use_compat	true to ensure that rotations are set using the min difference between the old and new orientation.

Definition at line 3402 of file blenkernel/intern/object.cc.

References BKE_object_get_parent_matrix(), BKE_object_mat3_to_rot(), Object::dloc, Object::dscale, invert_m4_m4(), Object::loc, mat4_to_loc_rot_size(), mul_m4_m4m4(), rot, Object::scale, and sub_v3_v3().

Referenced by BKE_object_add_from(), BKE_object_apply_mat4(), ED_view3d_to_object(), and blender::ed::mesh::join_objects_exec().

◆ BKE_object_apply_parent_inverse()

void BKE_object_apply_parent_inverse ( Object * ob )

Use parent's world location and rotation as the child's origin. The parent inverse will become identity when the parent has no shearing. Otherwise, it is non-identity and contains the object's local matrix data that cannot be decomposed into location, rotation and scale.

Assumes the object's world matrix has no shear. Assumes parent exists.

Definition at line 3453 of file blenkernel/intern/object.cc.

References BKE_object_apply_mat4(), BKE_object_get_parent_matrix(), copy_m4_m4(), invert_m4(), invert_m4_m4(), mul_m4_m4_post(), mul_m4_m4m4(), orthogonalize_m4_stable(), Object::parent, and Object::parentinv.

Referenced by BKE_object_add_from(), blender::ed::object::object_parent_inverse_apply_exec(), and blender::ed::object::parent_noinv_set_exec().

◆ BKE_object_as_kdtree()

KDTree_3d * BKE_object_as_kdtree	(	Object *	ob,
		int *	r_tot )

Return a KDTree_3d from the deformed object (in world-space).

Note: Only mesh objects currently support deforming, others are TODO.

Parameters

ob
r_tot

Returns: The KD-tree or nullptr if it can't be created.

Definition at line 5058 of file blenkernel/intern/object.cc.

References Nurb::bezt, BKE_nurbList_verts_count_without_handles(), BKE_object_get_evaluated_mesh(), BKE_object_get_mesh_deform_eval(), Nurb::bp, CD_ORIGINDEX, CustomData_get_layer(), Object::data, Lattice::def, ListBase::first, i, mul_v3_m4v3(), Nurb::next, Curve::nurb, OB_CURVES_LEGACY, OB_LATTICE, OB_MESH, OB_SURF, ORIGINDEX_NONE, Lattice::pntsu, Nurb::pntsu, Lattice::pntsv, Nurb::pntsv, Lattice::pntsw, blender::Span< T >::size(), tree, Object::type, BezTriple::vec, BPoint::vec, and Mesh::vert_data.

Referenced by blender::ed::object::parent_set_vertex_parent().

◆ BKE_object_batch_cache_dirty_tag()

void BKE_object_batch_cache_dirty_tag ( Object * ob )

Definition at line 254 of file object_update.cc.

References BKE_curve_batch_cache_dirty_tag(), BKE_CURVE_BATCH_DIRTY_ALL, BKE_curves_batch_cache_dirty_tag(), BKE_CURVES_BATCH_DIRTY_ALL, BKE_grease_pencil_batch_cache_dirty_tag(), BKE_GREASEPENCIL_BATCH_DIRTY_ALL, BKE_lattice_batch_cache_dirty_tag(), BKE_LATTICE_BATCH_DIRTY_ALL, BKE_mesh_batch_cache_dirty_tag(), BKE_MESH_BATCH_DIRTY_ALL, BKE_object_get_evaluated_mesh_no_subsurf(), BKE_pointcloud_batch_cache_dirty_tag(), BKE_POINTCLOUD_BATCH_DIRTY_ALL, BKE_volume_batch_cache_dirty_tag(), BKE_VOLUME_BATCH_DIRTY_ALL, Object::data, OB_CURVES, OB_CURVES_LEGACY, OB_FONT, OB_GREASE_PENCIL, OB_LATTICE, OB_MBALL, OB_MESH, OB_POINTCLOUD, OB_SURF, OB_VOLUME, and Object::type.

Referenced by BKE_object_defgroup_new(), BKE_object_defgroup_remove(), BKE_object_eval_uber_data(), and blender::ed::object::object_origin_set_exec().

◆ BKE_object_boundbox_eval_cached_get()

std::optional< blender::Bounds< blender::float3 > > BKE_object_boundbox_eval_cached_get ( const Object * ob )

Retrieve the bounds of the evaluated object's geometry, stored on the original object as part of the latest evaluation of the active dependency graph. If no such cache exists, fall back to the current bounds of the object's data. For evaluated objects this indirection is unnecessary, and BKE_object_boundbox_get or BKE_object_evaluated_geometry_bounds should be used instead.

Definition at line 3535 of file blenkernel/intern/object.cc.

References BKE_object_boundbox_get(), and Object::runtime.

Referenced by BKE_object_add_from(), BKE_object_dimensions_eval_cached_get(), BKE_object_dimensions_set_ex(), and blender::ed::transform::snap_source_closest_fn().

◆ BKE_object_boundbox_get()

std::optional< blender::Bounds< blender::float3 > > BKE_object_boundbox_get ( const Object * ob )

Retrieve the bounds of the object's data, in the object's local space (i.e. not accounting for the object's transform). This does not include the bounds of all evaluated geometry, only Object::data.

Definition at line 3508 of file blenkernel/intern/object.cc.

References BKE_armature_min_max(), BKE_curve_minmax(), BKE_lattice_minmax(), BKE_object_evaluated_geometry_bounds(), BKE_volume_min_max(), Object::data, OB_ARMATURE, OB_CURVES, OB_CURVES_LEGACY, OB_FONT, OB_GREASE_PENCIL, OB_LATTICE, OB_MBALL, OB_MESH, OB_POINTCLOUD, OB_SURF, OB_VOLUME, and Object::type.

Referenced by BKE_object_add_from(), BKE_object_boundbox_eval_cached_get(), BKE_object_dimensions_get(), BKE_object_minmax(), BKE_object_minmax_dupli(), BKE_pchan_minmax(), blender::ed::sculpt_paint::trim::calc_expand_factor(), clampto_evaluate(), blender::ed::sculpt_paint::do_tiled(), blender::draw::overlay::GreasePencil::draw_grease_pencil(), blender::io::obj::geometry_to_blender_objects(), blender::ed::transform::gizmo_3d_foreach_selected(), blender::ed::object::lattice_add_to_selected_collect_targets_and_calc_bounds(), blender::draw::overlay::Bounds::object_sync(), ObjectBounds::sync(), blender::io::alembic::ABCAbstractWriter::update_bounding_box(), view3d_ob_drop_matrix_from_snap(), view3d_orbit_calc_center(), and blender::eevee::VolumeObjectBounds::VolumeObjectBounds().

◆ BKE_object_calc_parent()

blender::float4x4 BKE_object_calc_parent	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob )

For calculation of the inverse parent transform, only used for editor.

It assumes the object parent is already in the depsgraph. Otherwise, after changing ob->parent you need to call:

#DEG_relations_tag_update(bmain);
#BKE_scene_graph_update_tagged(depsgraph, bmain);

Returns: calculated object_to_world.

Definition at line 3366 of file blenkernel/intern/object.cc.

References BKE_object_where_is_calc(), BKE_object_workob_clear(), Object::constinv, DEG_get_evaluated(), depsgraph, Object::par1, Object::par2, Object::par3, Object::parent, Object::parentinv, Object::parsubstr, Object::partype, Object::runtime, STRNCPY_UTF8, Object::trackflag, unit_m4(), and Object::upflag.

Referenced by blender::ed::object::apply_objects_internal(), applyarmature_fix_boneparents(), blender::ed::object::ignore_parent_tx(), blender::ed::object::parent_set_with_depsgraph(), and blender::ed::object::vertex_parent_set_exec().

◆ BKE_object_check_uids_unique_and_report()

void BKE_object_check_uids_unique_and_report ( const Object * object )

Definition at line 5407 of file blenkernel/intern/object.cc.

References BKE_pose_check_uids_unique_and_report().

◆ BKE_object_copy_modifier()

bool BKE_object_copy_modifier	(	Main *	bmain,
		const Scene *	scene,
		Object *	ob_dst,
		const Object *	ob_src,
		const ModifierData *	md )

Copy a single modifier.

Note: Do not use this function to copy a whole modifier stack (see note below too). Use BKE_object_modifier_stack_copy instead.; Complex modifiers relaying on other data (like e.g. dynamic paint or fluid using particle systems) are not always 100% 'correctly' copied here, since we have to use heuristics to decide which particle system to use or add in ob_dst, and it's placement in the stack, etc. If used more than once, this function should preferably be called in stack order.

Definition at line 1341 of file blenkernel/intern/object.cc.

References BKE_mesh_ensure_skin_customdata(), BKE_modifier_copydata(), BKE_modifier_get_info(), BKE_modifier_new(), BKE_modifier_unique_name(), BKE_modifiers_findby_type(), BKE_modifiers_persistent_uid_init(), BKE_object_copy_softbody(), BKE_object_modifier_set_active(), BKE_object_support_modifier_type_check(), BLI_assert, BLI_insertlinkbefore(), DynamicPaintModifierData::brush, Object::data, eModifierFlag_PinLast, eModifierType_DynamicPaint, eModifierType_Fluid, eModifierType_Multires, eModifierType_ParticleSystem, eModifierType_Skin, eModifierType_Softbody, eModifierTypeFlag_Single, ModifierTypeInfo::flags, FluidModifierData::flow, LISTBASE_FOREACH_BACKWARD, MOD_FLUID_TYPE_FLOW, Object::modifiers, multiresModifier_sync_levels_ex(), ModifierData::name, object_copy_modifier_particle_system_ensure(), object_copy_particle_system(), object_modifier_type_copy_check(), DynamicPaintBrushSettings::psys, FluidFlowSettings::psys, STRNCPY_UTF8, FluidModifierData::type, and ModifierData::type.

Referenced by blender::ed::object::modifier_copy_to_object().

◆ BKE_object_copy_particlesystem()

ParticleSystem * BKE_object_copy_particlesystem	(	ParticleSystem *	psys,
		int	flag )

Definition at line 2228 of file blenkernel/intern/object.cc.

References ParticleSystem::batch_cache, BKE_modifier_copydata_ex(), BKE_modifier_new(), BKE_ptcache_copy_list(), BLI_assert, BLI_duplicatelist(), BLI_listbase_clear(), ParticleSystem::bvhtree, ParticleSystem::childcache, ParticleSystem::childcachebufs, ParticleSystem::clmd, ParticleSystem::edit, ParticleSystem::effectors, eModifierType_Cloth, flag, ParticleSystem::flag, ParticleSystem::hair_in_mesh, ParticleSystem::hair_out_mesh, id_us_plus(), LIB_ID_COPY_SET_COPIED_ON_WRITE, LIB_ID_CREATE_NO_USER_REFCOUNT, MEM_dupallocN(), ParticleSystem::part, ParticleSystem::pathcache, ParticleSystem::pathcachebufs, ParticleSystem::pdd, ClothModifierData::point_cache, ParticleSystem::pointcache, psys_copy_particles(), PSYS_SHARED_CACHES, ParticleSystem::ptcaches, ParticleSystem::targets, and ParticleSystem::tree.

Referenced by BKE_object_copy_particlesystems(), and copy_particle_systems_to_object().

◆ BKE_object_copy_particlesystems()

void BKE_object_copy_particlesystems	(	Object *	ob_dst,
		const Object *	ob_src,
		int	flag )

◆ BKE_object_copy_softbody()

void BKE_object_copy_softbody	(	Object *	ob_dst,
		const Object *	ob_src,
		int	flag )

◆ BKE_object_data_editmode_flush_ptr_get()

char * BKE_object_data_editmode_flush_ptr_get ( ID * id )

Definition at line 1781 of file blenkernel/intern/object.cc.

References BLI_assert_unreachable, GS, ID_AR, ID_CU_LEGACY, ID_CV, ID_GP, ID_LT, ID_MB, ID_ME, ID_PT, bArmature::needs_flush_to_id, EditFont::needs_flush_to_id, EditLatt::needs_flush_to_id, EditNurb::needs_flush_to_id, MetaBall::needs_flush_to_id, and OB_FONT.

Referenced by ED_editors_flush_edits_for_object_ex(), and blender::ed::object::editmode_load_free_ex().

◆ BKE_object_data_is_in_editmode()

bool BKE_object_data_is_in_editmode	(	const Object *	ob,
		const ID *	id )

Definition at line 1752 of file blenkernel/intern/object.cc.

References BKE_object_is_in_editmode(), BLI_assert, BLI_assert_unreachable, GS, ID_AR, ID_CU_LEGACY, ID_CV, ID_GP, ID_LT, ID_MB, ID_ME, ID_PT, and OB_DATA_SUPPORT_EDITMODE.

Referenced by blender::deg::deg_update_eval_copy_datablock(), and blender::ed::outliner::is_object_data_in_editmode().

◆ BKE_object_data_select_update()

void BKE_object_data_select_update	(	Depsgraph *	depsgraph,
		ID *	object_data )

Definition at line 325 of file object_update.cc.

References BKE_curve_batch_cache_dirty_tag(), BKE_CURVE_BATCH_DIRTY_SELECT, BKE_lattice_batch_cache_dirty_tag(), BKE_LATTICE_BATCH_DIRTY_SELECT, BKE_mesh_batch_cache_dirty_tag(), BKE_MESH_BATCH_DIRTY_SELECT, DEG_debug_print_eval(), depsgraph, GS, ID_CU_LEGACY, ID_LT, ID_ME, and ID::name.

Referenced by BKE_object_select_update(), and blender::deg::DepsgraphNodeBuilder::build_object_data_geometry_datablock().

◆ BKE_object_delete_ptcache()

void BKE_object_delete_ptcache	(	Object *	ob,
		int	index )

Definition at line 4354 of file blenkernel/intern/object.cc.

References BLI_findlink(), BLI_freelinkN(), pc_findindex(), and Object::pc_ids.

Referenced by BKE_ptcache_toggle_disk_cache().

◆ BKE_object_dimensions_eval_cached_get()

void BKE_object_dimensions_eval_cached_get	(	const Object *	ob,
		float	r_vec[3] )

Similar to BKE_object_dimensions_get but uses the cached evaluated bounds instead.

Definition at line 3582 of file blenkernel/intern/object.cc.

References BKE_object_boundbox_eval_cached_get(), boundbox_to_dimensions(), and copy_v3_v3().

Referenced by BKE_object_add_from(), v3d_object_dimension_buts(), and view3d_ob_drop_on_enter().

◆ BKE_object_dimensions_get()

void BKE_object_dimensions_get	(	const Object *	ob,
		float	r_vec[3] )

The dimensions based on BKE_object_boundbox_get, scaled by the object's scale.

Definition at line 3577 of file blenkernel/intern/object.cc.

References BKE_object_boundbox_get(), boundbox_to_dimensions(), and copy_v3_v3().

Referenced by BKE_object_add_from(), blender::draw::overlay::FlatObjectRef::flat_axis_index_get(), object_asset_dimensions_property(), and blender::workbench::VolumePass::object_sync_modifier().

◆ BKE_object_dimensions_set()

void BKE_object_dimensions_set	(	Object *	ob,
		const float	value[3],
		int	axis_mask )

Definition at line 3615 of file blenkernel/intern/object.cc.

References BKE_object_dimensions_set_ex().

Referenced by BKE_object_add_from().

◆ BKE_object_dimensions_set_ex()

void BKE_object_dimensions_set_ex	(	Object *	ob,
		const float	value[3],
		int	axis_mask,
		const float	ob_scale_orig[3],
		const float	ob_obmat_orig[4][4] )

The original scale and object matrix can be passed in so any difference of the objects matrix and the final matrix can be accounted for, typically this caused by parenting, constraints or delta-scale.

Re-using these values from the object causes a feedback loop when multiple values are modified at once in some situations. see: #69536.

Definition at line 3587 of file blenkernel/intern/object.cc.

References BKE_object_boundbox_eval_cached_get(), bounds(), copysignf, i, len, len_v3(), and Object::scale.

Referenced by BKE_object_add_from(), BKE_object_dimensions_set(), and v3d_object_dimension_buts().

◆ BKE_object_do_version_give_parteff_245()

PartEff * BKE_object_do_version_give_parteff_245 ( Object * ob )

Definition at line 966 of file blenkernel/intern/object.cc.

References EFF_PARTICLE, PartEff::next, and PartEff::type.

Referenced by blo_do_versions_pre250(), and object_foreach_id().

◆ BKE_object_duplicate()

Object * BKE_object_duplicate	(	Main *	bmain,
		Object *	ob,
		eDupli_ID_Flags	dupflag,
		uint	duplicate_options )

Perform deep-copy of object and its 'children' data-blocks (obdata, materials, actions, etc.).

Parameters

dupflag	Controls which sub-data are also duplicated (see eDupli_ID_Flags in DNA_userdef_types.h).
duplicate_options	Additional context information about current duplicate call (e.g. if it's part of a higher-level duplication or not, etc.). (see eLibIDDuplicateFlags in BKE_lib_id.hh).

Warning: By default, this functions will clear all bmain #ID.idnew pointers (BKE_main_id_newptr_and_tag_clear), and take care of post-duplication updates like remapping to new IDs (BKE_libblock_relink_to_newid). If LIB_ID_DUPLICATE_IS_SUBPROCESS duplicate option is passed on (typically when duplication is called recursively from another parent duplication operation), the caller is responsible to handle all of these operations.

Note: Caller MUST handle updates of the depsgraph (#DAG_relations_tag_update).

Definition at line 2508 of file blenkernel/intern/object.cc.

References BKE_id_copy_for_duplicate(), BKE_libblock_relink_to_newid(), BKE_main_id_newptr_and_tag_clear(), BKE_object_material_array_p(), BKE_pose_tag_recalc(), BLI_assert, Object::data, DEG_id_tag_update(), DEG_id_tag_update_ex(), ELEM, FOREACH_MAIN_ID_BEGIN, FOREACH_MAIN_ID_END, i, Object::id, ID_IS_LINKED, ID_RECALC_EDITORS, ID_RECALC_GEOMETRY, ID_REMAP_FORCE_OBDATA_IN_EDITMODE, ID_REMAP_SKIP_USER_CLEAR, ID_TAG_NEW, LIB_ID_COPY_DEFAULT, LIB_ID_COPY_RIGID_BODY_NO_COLLECTION_HANDLING, LIB_ID_DUPLICATE_IS_ROOT_ID, LIB_ID_DUPLICATE_IS_SUBPROCESS, LISTBASE_FOREACH, Object::mat, ID::newid, OB_ARMATURE, OB_CAMERA, OB_CURVES, OB_CURVES_LEGACY, OB_FONT, OB_GREASE_PENCIL, OB_LAMP, OB_LATTICE, OB_LIGHTPROBE, OB_MBALL, OB_MESH, OB_POINTCLOUD, OB_SPEAKER, OB_SURF, OB_VOLUME, Object::particlesystem, Object::pose, ID::tag, Object::totcol, Object::type, USER_DUP_ARM, USER_DUP_CAMERA, USER_DUP_CURVE, USER_DUP_CURVES, USER_DUP_FONT, USER_DUP_GPENCIL, USER_DUP_LAMP, USER_DUP_LATTICE, USER_DUP_LIGHTPROBE, USER_DUP_LINKED_ID, USER_DUP_MAT, USER_DUP_MBALL, USER_DUP_MESH, USER_DUP_POINTCLOUD, USER_DUP_PSYS, USER_DUP_SPEAKER, USER_DUP_SURF, and USER_DUP_VOLUME.

Referenced by BKE_object_add_from(), collection_duplicate_recursive(), and blender::ed::object::object_add_duplicate_internal().

◆ BKE_object_empty_draw_type_set()

void BKE_object_empty_draw_type_set	(	Object *	ob,
		int	value )

Definition at line 3639 of file blenkernel/intern/object.cc.

References Object::empty_drawtype, ImageUser::flag, ImageUser::frames, IMA_ANIM_ALWAYS, Object::iuser, MEM_callocN(), MEM_SAFE_FREE, OB_EMPTY, OB_EMPTY_IMAGE, ImageUser::sfra, and Object::type.

Referenced by BKE_object_add_from(), object_blend_read_data(), blender::ed::object::object_empty_add_exec(), blender::ed::object::object_image_add_exec(), and blender::ed::object::object_image_add_invoke().

◆ BKE_object_empty_image_data_is_visible_in_view3d()

bool BKE_object_empty_image_data_is_visible_in_view3d	(	const Object *	ob,
		const RegionView3D *	rv3d )

Definition at line 3666 of file blenkernel/intern/object.cc.

References BKE_object_empty_image_frame_is_visible_in_view3d(), BLI_assert, dot(), dot_v3v3(), Object::empty_image_visibility_flag, eps, RegionView3D::is_persp, len_squared_v3(), normalize_v3_v3(), OB_EMPTY_IMAGE_HIDE_BACK, OB_EMPTY_IMAGE_HIDE_FRONT, OB_EMPTY_IMAGE_HIDE_NON_AXIS_ALIGNED, project_plane_v3_v3v3(), sub_v3_v3v3(), and RegionView3D::viewinv.

◆ BKE_object_empty_image_frame_is_visible_in_view3d()

bool BKE_object_empty_image_frame_is_visible_in_view3d	(	const Object *	ob,
		const RegionView3D *	rv3d )

Definition at line 3656 of file blenkernel/intern/object.cc.

References Object::empty_image_visibility_flag, RegionView3D::is_persp, OB_EMPTY_IMAGE_HIDE_ORTHOGRAPHIC, and OB_EMPTY_IMAGE_HIDE_PERSPECTIVE.

Referenced by BKE_object_empty_image_data_is_visible_in_view3d(), view3d_object_skip_minmax(), and WIDGETGROUP_empty_image_poll().

◆ BKE_object_eval_assign_data()

void BKE_object_eval_assign_data	(	Object *	object,
		ID *	data,
		bool	is_owned )

Assign Object.data after modifier stack evaluation.

Definition at line 1590 of file blenkernel/intern/object.cc.

References BLI_assert, data, Object::data, GS, Object::id, ID_TAG_COPIED_ON_EVAL, ID_TAG_COPIED_ON_EVAL_FINAL_RESULT, ID_TAG_NO_MAIN, ID::name, Object::runtime, and ID::tag.

Referenced by BKE_curves_data_update(), BKE_displist_make_curveTypes(), BKE_lattice_modifiers_calc(), BKE_object_eval_grease_pencil(), BKE_pointcloud_data_update(), BKE_volume_data_update(), blender::bke::editbmesh_build_data(), and blender::bke::mesh_build_data().

◆ BKE_object_eval_constraints()

void BKE_object_eval_constraints	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob )

Definition at line 91 of file object_update.cc.

References BKE_constraints_clear_evalob(), BKE_constraints_make_evalob(), BKE_constraints_solve(), BKE_scene_ctime_get(), CONSTRAINT_OBTYPE_OBJECT, Object::constraints, DEG_debug_print_eval(), depsgraph, Object::id, and ID::name.

Referenced by BKE_object_eval_transform_all(), and blender::ed::object::force_evaluation_if_constraint_disabled().

◆ BKE_object_eval_eval_base_flags()

void BKE_object_eval_eval_base_flags	(	Depsgraph *	depsgraph,
		Scene *	scene,
		int	view_layer_index,
		Object *	object,
		int	base_index,
		bool	is_from_set )

◆ BKE_object_eval_light_linking()

void BKE_object_eval_light_linking	(	Depsgraph *	depsgraph,
		Object *	object )

Definition at line 417 of file object_update.cc.

References DEG_debug_print_eval(), depsgraph, blender::deg::light_linking::eval_runtime_data(), Object::id, and ID::name.

◆ BKE_object_eval_local_transform()

void BKE_object_eval_local_transform	(	Depsgraph *	depsgraph,
		Object *	ob )

Definition at line 51 of file object_update.cc.

References BKE_object_to_mat4(), DEG_debug_print_eval(), depsgraph, Object::id, ID::name, and Object::runtime.

Referenced by BKE_object_eval_transform_all().

◆ BKE_object_eval_parent()

void BKE_object_eval_parent	(	Depsgraph *	depsgraph,
		Object *	ob )

Definition at line 59 of file object_update.cc.

References BKE_object_get_parent_matrix(), copy_m4_m4(), copy_v3_v3(), DEG_debug_print_eval(), depsgraph, Object::id, mul_m4_m4m4(), ID::name, Object::parent, Object::parentinv, PARSKEL, PARTYPE, Object::partype, and Object::runtime.

Referenced by BKE_object_eval_transform_all().

◆ BKE_object_eval_ptcache_reset()

void BKE_object_eval_ptcache_reset	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	object )

Definition at line 305 of file object_update.cc.

References BKE_ptcache_object_reset(), DEG_debug_print_eval(), depsgraph, Object::id, ID::name, and PTCACHE_RESET_DEPSGRAPH.

◆ BKE_object_eval_reset()

void BKE_object_eval_reset ( Object * ob_eval )

Restore the object->data to a non-modifier evaluated state.

Some changes done directly in evaluated object require them to be reset before being re-evaluated. For example, we need to call this before BKE_mesh_new_from_object(), in case we removed/added modifiers in the evaluated object.

Definition at line 46 of file object_update.cc.

References BKE_object_free_derived_caches().

Referenced by blender::ed::object::bake(), and blender::ed::object::object_force_modifier_update_for_bind().

◆ BKE_object_eval_shading()

void BKE_object_eval_shading	(	Depsgraph *	depsgraph,
		Object *	object )

Definition at line 423 of file object_update.cc.

References DEG_debug_print_eval(), DEG_get_update_count(), depsgraph, Object::id, and ID::name.

◆ BKE_object_eval_transform_all()

void BKE_object_eval_transform_all	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	object )

Definition at line 311 of file object_update.cc.

References BKE_object_eval_constraints(), BKE_object_eval_local_transform(), BKE_object_eval_parent(), BKE_object_eval_transform_final(), BKE_object_eval_uber_transform(), BLI_listbase_is_empty(), Object::constraints, depsgraph, and Object::parent.

Referenced by blender::ed::transform::applyFaceNearest(), blender::ed::transform::applyFaceProject(), and blender::ed::object::ignore_parent_tx().

◆ BKE_object_eval_transform_final()

void BKE_object_eval_transform_final	(	Depsgraph *	depsgraph,
		Object *	ob )

Definition at line 111 of file object_update.cc.

References DEG_debug_print_eval(), DEG_get_update_count(), depsgraph, Object::id, invert_m4_m4_safe(), is_negative_m4(), ID::name, OB_NEG_SCALE, Object::runtime, and Object::transflag.

Referenced by BKE_object_eval_transform_all().

◆ BKE_object_eval_uber_data()

void BKE_object_eval_uber_data	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob )

Definition at line 295 of file object_update.cc.

References BKE_object_batch_cache_dirty_tag(), BKE_object_handle_data_update(), BLI_assert, DEG_debug_print_eval(), DEG_get_update_count(), depsgraph, Object::id, ID::name, OB_ARMATURE, Object::runtime, and Object::type.

◆ BKE_object_eval_uber_transform()

void BKE_object_eval_uber_transform	(	Depsgraph *	depsgraph,
		Object *	object )

Definition at line 252 of file object_update.cc.

Referenced by BKE_object_eval_transform_all().

◆ BKE_object_evaluated_geometry_bounds()

std::optional< blender::Bounds< blender::float3 > > BKE_object_evaluated_geometry_bounds ( const Object * ob )

Retrieve the bounds of the object's evaluated geometry. This is important because it includes all geometry component types created during evaluation rather than just Object::data. This should only be called on evaluated objects, since otherwise the evaluated geometry set won't be available.

Note: This only includes the bounds of data stored in GeometrySet, so it won't include the bounds of other object types that aren't considered "geometry", like armatures.

Definition at line 3543 of file blenkernel/intern/object.cc.

References BKE_displist_minmax(), max, min, OB_CURVES_LEGACY, Object::runtime, and Object::type.

Referenced by BKE_object_add_from(), BKE_object_boundbox_get(), BKE_object_handle_data_update(), and blender::draw::overlay::Bounds::object_sync().

◆ BKE_object_exists_check()

bool BKE_object_exists_check	(	Main *	bmain,
		const Object *	obtest )

Definition at line 1916 of file blenkernel/intern/object.cc.

References LISTBASE_FOREACH, and Main::objects.

Referenced by blender::ed::object::test_constraint().

◆ BKE_object_flag_test_recursive()

bool BKE_object_flag_test_recursive	(	const Object *	ob,
		short	flag )

Definition at line 4621 of file blenkernel/intern/object.cc.

References BKE_object_flag_test_recursive(), flag, Object::flag, and Object::parent.

Referenced by BKE_object_flag_test_recursive(), and snap_selected_to_location_rotation().

◆ BKE_object_foreach_display_point()

void BKE_object_foreach_display_point	(	Object *	ob,
		const float	obmat[4][4],
		void(*	func_cb )(const float[3], void *),
		void *	user_data )

Sometimes min-max isn't enough, we need to loop over each point.

Definition at line 3817 of file blenkernel/intern/object.cc.

References BKE_mesh_wrapper_vert_coords(), BKE_object_get_evaluated_mesh(), Object::data, i, blender::Span< T >::index_range(), mul_v3_m4v3(), OB_GREASE_PENCIL, blender::threading::parallel_for(), GreasePencil::runtime, and Object::type.

Referenced by BKE_object_minmax_dupli(), and BKE_scene_foreach_display_point().

◆ BKE_object_free_caches()

void BKE_object_free_caches ( Object * object )

Definition at line 1671 of file blenkernel/intern/object.cc.

References BASE_FROM_DUPLI, BKE_id_free(), BKE_object_free_derived_caches(), DEG_id_tag_update(), eModifierType_ParticleSystem, eParticleSystemFlag_file_loaded, ParticleSystemModifierData::flag, ID_RECALC_GEOMETRY, ID_RECALC_PSYS_REDO, LISTBASE_FOREACH, ParticleSystemModifierData::mesh_final, ParticleSystemModifierData::mesh_original, and psys_free_path_cache().

◆ BKE_object_free_curve_cache()

void BKE_object_free_curve_cache ( Object * ob )

Definition at line 1127 of file blenkernel/intern/object.cc.

References BKE_curve_bevelList_free(), BKE_displist_free(), BKE_nurbList_free(), MEM_freeN(), and Object::runtime.

Referenced by BKE_object_free_derived_caches().

◆ BKE_object_free_derived_caches()

void BKE_object_free_derived_caches ( Object * ob )

Free data derived from mesh, called when mesh changes or is freed.

Definition at line 1619 of file blenkernel/intern/object.cc.

References BKE_crazyspace_api_eval_clear(), BKE_id_free(), BKE_libblock_free_data(), BKE_libblock_free_datablock(), BKE_object_free_curve_cache(), BKE_object_to_curve_clear(), BKE_object_to_mesh_clear(), BKE_pose_backup_clear(), Object::data, GS, ID_ME, MEM_freeN(), ID::name, object_update_from_subsurf_ccg(), and Object::runtime.

◆ BKE_object_free_modifiers()

void BKE_object_free_modifiers	(	Object *	ob,
		int	flag )

Definition at line 1141 of file blenkernel/intern/object.cc.

References BKE_gpencil_modifier_free_ex(), BKE_modifier_free_ex(), BKE_object_free_derived_caches(), BKE_object_free_particlesystems(), BKE_object_free_softbody(), BLI_pophead(), flag, Object::greasepencil_modifiers, and Object::modifiers.

◆ BKE_object_free_particlesystems()

void BKE_object_free_particlesystems ( Object * ob )

Definition at line 1115 of file blenkernel/intern/object.cc.

References BLI_pophead(), Object::particlesystem, and psys_free().

Referenced by BKE_object_free_modifiers(), and remove_particle_systems_from_object().

◆ BKE_object_free_shaderfx()

void BKE_object_free_shaderfx	(	Object *	ob,
		int	flag )

Definition at line 1162 of file blenkernel/intern/object.cc.

References BKE_shaderfx_free_ex(), BLI_pophead(), flag, and Object::shader_fx.

Referenced by object_free_data().

◆ BKE_object_free_softbody()

void BKE_object_free_softbody ( Object * ob )

Definition at line 1122 of file blenkernel/intern/object.cc.

References sbFree().

Referenced by BKE_object_free_modifiers().

◆ BKE_object_get_editmesh_eval_cage()

const Mesh * BKE_object_get_editmesh_eval_cage ( const Object * object )

Definition at line 4244 of file blenkernel/intern/object.cc.

References BLI_assert, DEG_is_original(), and OB_MESH.

Referenced by BKE_editmesh_vert_coords_when_deformed(), blender::ed::transform::data_for_snap(), DRW_object_get_editmesh_cage_for_drawing(), DRW_text_edit_mesh_measure_stats(), ED_transverts_create_from_obedit(), EDBM_unified_findnearest_from_raycast(), blender::ed::transform::get_mesh_ref(), gizmo_preselect_elem_test_select(), mesh_data_from_duplicator_object(), and blender::draw::overlay::Meshes::mesh_has_edit_cage().

◆ BKE_object_get_editmesh_eval_final()

const Mesh * BKE_object_get_editmesh_eval_final ( const Object * object )

Definition at line 4229 of file blenkernel/intern/object.cc.

References BLI_assert, DEG_is_original(), and OB_MESH.

Referenced by BKE_editmesh_vert_coords_when_deformed(), BKE_modifier_get_evaluated_mesh_from_evaluated_object(), blender::ed::transform::data_for_snap(), blender::draw::draw_subdiv_create_requested_buffers(), blender::draw::DRW_mesh_batch_cache_create_requested(), blender::draw::editmesh_final_or_this(), get_evaluated_object_data_with_materials(), blender::ed::transform::get_mesh_ref(), give_parvert(), blender::draw::overlay::Meshes::mesh_has_edit_cage(), and mesh_new_from_mesh_object().

◆ BKE_object_get_evaluated_lattice()

Lattice * BKE_object_get_evaluated_lattice ( const Object * object )

Definition at line 4274 of file blenkernel/intern/object.cc.

References Lattice::editlatt, GS, ID_LT, EditLatt::latt, ID::name, and ID::runtime.

Referenced by BKE_lattice_modifiers_calc().

◆ BKE_object_get_evaluated_mesh()

Mesh * BKE_object_get_evaluated_mesh ( const Object * object_eval )

Get evaluated mesh for given object.

Definition at line 4187 of file blenkernel/intern/object.cc.

References BKE_object_get_evaluated_mesh_unchecked(), and DEG_object_geometry_is_evaluated().

Referenced by add_verts_to_dgroups(), BKE_effectors_create(), BKE_mesh_to_pointcloud(), BKE_modifier_get_evaluated_mesh_from_evaluated_object(), BKE_object_as_kdtree(), BKE_object_data_transfer_ex(), BKE_object_data_transfer_layout(), BKE_object_foreach_display_point(), bpy_bmesh_from_object(), bvh_get_mesh(), contarget_get_mesh_mat(), blender::ed::object::convert_mesh_to_grease_pencil(), blender::ed::object::convert_mesh_to_mesh(), blender::ed::transform::data_for_snap(), blender::io::alembic::ABCHairWriter::do_write(), ED_mesh_pick_face_vert(), ED_mesh_pick_vert(), ED_mesh_shapes_join_objects_exec(), blender::ed::sculpt_paint::AddOperationExecutor::execute(), blender::ed::sculpt_paint::DensityAddOperationExecutor::execute(), blender::ed::sculpt_paint::DensitySubtractOperationExecutor::execute(), blender::ed::sculpt_paint::SlideOperationExecutor::execute(), blender::io::stl::export_frame(), followtrack_project_to_depth_object_if_needed(), get_effector_data(), get_effector_tot(), blender::io::alembic::ABCCurveMeshWriter::get_export_mesh(), blender::io::alembic::ABCMeshWriter::get_export_mesh(), blender::io::alembic::ABCMetaballWriter::get_export_mesh(), blender::io::usd::USDMeshWriter::get_export_mesh(), blender::io::usd::USDMetaballWriter::get_export_mesh(), blender::io::usd::USDTextWriter::get_export_mesh(), give_parvert(), knifeproject_poly_from_object(), lineart_object_load_single_instance(), blender::io::ply::load_plydata(), mesh_data_from_duplicator_object(), mesh_new_from_evaluated_curve_type_object(), mesh_new_from_mball_object(), meshobject_foreachScreenVert(), blender::ed::sculpt_paint::min_distance_edit::min_distance_edit_invoke(), MOD_lineart_gpencil_generate_v3(), multiresModifier_reshapeFromObject(), blender::io::obj::OBJMesh::OBJMesh(), paint_init_pivot_mesh(), paint_sample_color(), paint_weight_gradient_exec(), paintvert_flush_flags(), particle_intersect_mesh(), PE_create_shape_tree(), proj_paint_state_mesh_eval_init(), blender::ed::sculpt_paint::sample_curves_3d_brush(), shrinkwrap_get_tarmat(), blender::ed::sculpt_paint::use_add_density_mode(), vpaint_proj_dm_map_cosnos_init(), and vpaint_proj_dm_map_cosnos_update().

◆ BKE_object_get_evaluated_mesh_no_subsurf()

Mesh * BKE_object_get_evaluated_mesh_no_subsurf ( const Object * object_eval )

Definition at line 4170 of file blenkernel/intern/object.cc.

References BKE_object_get_evaluated_mesh_no_subsurf_unchecked(), and DEG_object_geometry_is_evaluated().

Referenced by blender::bke::add_final_mesh_as_geometry_component(), BKE_mesh_to_curve(), BKE_object_batch_cache_dirty_tag(), blender::bke::pbvh::cache_source_get(), blender::ed::sculpt_paint::cursor_draw_tiling_preview(), blender::ed::object::dt_layers_select_src_itemf(), and stats_object().

◆ BKE_object_get_evaluated_mesh_no_subsurf_unchecked()

Mesh * BKE_object_get_evaluated_mesh_no_subsurf_unchecked ( const Object * object )

Same as BKE_object_get_evaluated_mesh, but does not check if the object's geometry is fully evaluated already. This should barely ever be used.

Definition at line 4143 of file blenkernel/intern/object.cc.

References blender::bke::GeometrySet::get_mesh(), GS, ID_ME, ID::name, and ID::runtime.

Referenced by BKE_object_get_evaluated_mesh_no_subsurf(), BKE_object_get_evaluated_mesh_unchecked(), blender::draw::drw_batch_cache_generate_requested_evaluated_mesh_or_curve(), drw_shgroup_bone_custom_solid(), drw_shgroup_bone_custom_wire(), and object_update_from_subsurf_ccg().

◆ BKE_object_get_evaluated_mesh_unchecked()

Mesh * BKE_object_get_evaluated_mesh_unchecked ( const Object * object )

Definition at line 4178 of file blenkernel/intern/object.cc.

References BKE_mesh_wrapper_ensure_subdivision(), and BKE_object_get_evaluated_mesh_no_subsurf_unchecked().

Referenced by BKE_object_get_evaluated_mesh(), and sculpt_update_object().

◆ BKE_object_get_last_subsurf_modifier()

SubsurfModifierData * BKE_object_get_last_subsurf_modifier ( const Object * ob )

Return the last subsurf modifier of an object, this does not check whether modifiers on top of it are disabled. Return NULL if no such modifier is found.

This does not check if the modifier is enabled as it is assumed that the caller verified that it is enabled for its evaluation mode.

Definition at line 5412 of file blenkernel/intern/object.cc.

References eModifierType_Subsurf, ListBase::last, Object::modifiers, ModifierData::prev, and ModifierData::type.

◆ BKE_object_get_lattice()

Lattice * BKE_object_get_lattice ( const Object * object )

Definition at line 4259 of file blenkernel/intern/object.cc.

References data, Lattice::editlatt, GS, ID_LT, and EditLatt::latt.

Referenced by BKE_lattice_deform_data_create(), BKE_lattice_deform_verts_get(), and BKE_lattice_modifiers_calc().

◆ BKE_object_get_mesh_deform_eval()

const Mesh * BKE_object_get_mesh_deform_eval ( const Object * object )

Definition at line 4252 of file blenkernel/intern/object.cc.

References BLI_assert, DEG_is_original(), and OB_MESH.

Referenced by BKE_object_as_kdtree(), blender::bke::pbvh::cache_source_get(), blender::bke::object::pbvh_ensure(), and sculpt_update_object().

◆ BKE_object_get_original_mesh()

Mesh * BKE_object_get_original_mesh ( const Object * object )

Get a mesh which corresponds to the very original mesh from Main.

For original objects it will be object->data.
For evaluated objects it will be same mesh as corresponding original object uses as data.

Definition at line 4213 of file blenkernel/intern/object.cc.

References BLI_assert, ID_TAG_COPIED_ON_EVAL, ID_TAG_COPIED_ON_EVAL_FINAL_RESULT, and result.

Referenced by BKE_sculpt_color_layer_create_if_needed(), blender::bke::build_pbvh_from_regular_mesh(), blender::ed::sculpt_paint::face_set::change_visibility_exec(), edbm_reverse_colors_exec(), edbm_rotate_colors_exec(), blender::ed::sculpt_paint::undo::restore_mask_mesh(), blender::ed::sculpt_paint::undo::save_active_attribute(), blender::draw::sculpt_batches_get(), sculpt_update_object(), and blender::ed::sculpt_paint::undo::set_active_layer().

◆ BKE_object_get_parent_matrix()

void BKE_object_get_parent_matrix	(	const Object *	ob,
		Object *	par,
		float	r_parentmat[4][4] )

◆ BKE_object_get_pre_modified_mesh()

const Mesh * BKE_object_get_pre_modified_mesh ( const Object * object )

Get mesh which is not affected by modifiers:

For original objects, return Object::data: the mesh in the original Main database.
For evaluated objects, return the evaluated mesh which corresponds to the original mesh, if the original object was a mesh object (otherwise null).

Definition at line 4195 of file blenkernel/intern/object.cc.

References BLI_assert, GS, ID_ME, ID_TAG_COPIED_ON_EVAL, ID_TAG_COPIED_ON_EVAL_FINAL_RESULT, and OB_MESH.

Referenced by blender::draw::DRW_mesh_batch_cache_create_requested(), DRW_text_edit_mesh_measure_stats(), blender::io::stl::export_frame(), blender::io::usd::USDMeshWriter::get_export_mesh(), blender::io::usd::get_shape_key_basis_mesh(), blender::io::ply::load_plydata(), blender::draw::mesh_render_data_create(), blender::draw::edit_select::Instance::object_sync(), and blender::io::obj::OBJMesh::OBJMesh().

◆ BKE_object_groups()

LinkNode * BKE_object_groups	(	Main *	bmain,
		Scene *	scene,
		Object *	ob )

Returns: All groups this object is a part of, caller must free.

Definition at line 5032 of file blenkernel/intern/object.cc.

References BKE_collection_object_find(), and BLI_linklist_prepend().

Referenced by blender::ed::object::make_links_data_exec().

◆ BKE_object_groups_clear()

void BKE_object_groups_clear	(	Main *	bmain,
		Scene *	scene,
		Object *	object )

Definition at line 5043 of file blenkernel/intern/object.cc.

References BKE_collection_object_find(), BKE_collection_object_remove(), DEG_id_tag_update(), Collection::id, and ID_RECALC_SYNC_TO_EVAL.

Referenced by blender::ed::object::collection_objects_remove_all_exec(), and blender::ed::object::make_links_data_exec().

◆ BKE_object_handle_data_update()

void BKE_object_handle_data_update	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob )

Definition at line 128 of file object_update.cc.

References BKE_curves_data_update(), BKE_displist_make_curveTypes(), BKE_lattice_modifiers_calc(), BKE_mball_data_update(), BKE_object_eval_grease_pencil(), BKE_object_evaluated_geometry_bounds(), BKE_pointcloud_data_update(), BKE_pose_where_is(), BKE_volume_data_update(), BLI_remlink(), CD_MASK_BAREMESH, CD_MASK_MDEFORMVERT, CD_MASK_ORCO, CD_MASK_PROP_ALL, Scene::customdata_mask, CustomData_MeshMasks_update(), DAG_EVAL_RENDER, DEG_debug_print_eval(), DEG_get_mode(), DEG_get_original(), DEG_is_active(), depsgraph, ParticleSettings::draw_as, CustomData_MeshMasks::emask, ListBase::first, ParticleSystem::flag, CustomData_MeshMasks::fmask, Object::id, ParticleSettings::instance_collection, ParticleSettings::instance_object, CustomData_MeshMasks::lmask, blender::bke::mesh_data_update(), Object::mode, ID::name, ParticleSystem::next, OB_ARMATURE, OB_CURVES, OB_CURVES_LEGACY, OB_DUPLIPARTS, OB_FONT, OB_GREASE_PENCIL, OB_LATTICE, OB_MBALL, OB_MESH, OB_MODE_EDIT, OB_POINTCLOUD, OB_SURF, OB_VOLUME, ParticleSystem::part, PART_DRAW_GR, PART_DRAW_OB, PART_DRAW_REND, particle_system_update(), Object::particlesystem, CustomData_MeshMasks::pmask, psys_check_enabled(), PSYS_DELETE, psys_free(), ParticleSettings::ren_as, Object::runtime, Object::transflag, Object::type, and CustomData_MeshMasks::vmask.

Referenced by blender::ed::object::bake(), BKE_object_eval_uber_data(), and BKE_object_handle_update_ex().

◆ BKE_object_handle_update()

void BKE_object_handle_update	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob )

Warning: "scene" here may not be the scene object actually resides in. When dealing with background-sets, "scene" is actually the active scene. e.g. "scene" <– set 1 <– set 2 ("ob" lives here) <– set 3 <– ... <– set n rigid bodies depend on their world so use BKE_object_handle_update_ex() to also pass along the current rigid body world.

Definition at line 4083 of file blenkernel/intern/object.cc.

References BKE_object_handle_update_ex(), and depsgraph.

Referenced by BKE_object_modifier_update_subframe().

◆ BKE_object_handle_update_ex()

void BKE_object_handle_update_ex	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob,
		RigidBodyWorld *	rbw )

The main object update call, for object matrix, constraints, keys and modifiers. Requires flags to be set!

Ideally we shouldn't have to pass the rigid body world, but need bigger restructuring to avoid id.

Definition at line 4036 of file blenkernel/intern/object.cc.

References BKE_object_handle_data_update(), BKE_object_where_is_calc_ex(), BKE_pose_channels_hash_ensure(), BKE_pose_rebuild(), BKE_pose_update_constraint_flags(), Object::data, depsgraph, bPose::flag, G, G_DEBUG_DEPSGRAPH_EVAL, Object::id, ID_RECALC_ALL, ID::name, OB_ARMATURE, Object::pose, POSE_CONSTRAINTS_NEED_UPDATE_FLAGS, POSE_RECALC, printf, ID::recalc, and Object::type.

Referenced by BKE_object_handle_update().

◆ BKE_object_has_mode_data()

bool BKE_object_has_mode_data	(	const Object *	ob,
		eObjectMode	object_mode )

Definition at line 1843 of file blenkernel/intern/object.cc.

References BKE_object_is_in_editmode(), SculptSession::mode_type, OB_MODE_EDIT, OB_MODE_POSE, OB_MODE_SCULPT, OB_MODE_VERTEX_PAINT, OB_MODE_WEIGHT_PAINT, Object::pose, and Object::sculpt.

Referenced by ED_editors_init().

◆ BKE_object_insert_ptcache()

int BKE_object_insert_ptcache ( Object * ob )

Definition at line 4306 of file blenkernel/intern/object.cc.

References BLI_addtail(), BLI_listbase_sort(), LinkData::data, ListBase::first, i, MEM_callocN(), LinkData::next, pc_cmp(), Object::pc_ids, POINTER_AS_INT, and POINTER_FROM_INT.

Referenced by ptcache_filepath_ext_append().

◆ BKE_object_is_child_recursive()

bool BKE_object_is_child_recursive	(	const Object *	ob_parent,
		const Object *	ob_child )

Definition at line 4633 of file blenkernel/intern/object.cc.

References Object::parent.

Referenced by BKE_object_relational_superset(), blender::ed::outliner::do_outliner_object_select_recursive(), blender::ed::outliner::outliner_object_set_flag_recursive_fn(), and blender::ed::outliner::parent_drop_allowed().

◆ BKE_object_is_deform_modified()

int BKE_object_is_deform_modified	(	Scene *	scene,
		Object *	ob )

Test if object is affected by deforming modifiers (for motion blur). again most important is to avoid false positives, this is to skip computations and we can still if there was actual deformation afterwards.

Definition at line 4774 of file blenkernel/intern/object.cc.

References BKE_key_from_object(), BKE_modifier_get_info(), BKE_modifier_is_enabled(), BKE_modifiers_get_virtual_modifierlist(), constructive_modifier_is_deform_modified(), Object::data, DEG_get_original(), eModifierMode_Realtime, eModifierMode_Render, flag, modifiers_has_animation_check(), ModifierData::next, OB_CURVES_LEGACY, object_deforms_in_time(), OnlyDeform, Curve::taperobj, ModifierData::type, ModifierTypeInfo::type, and Object::type.

◆ BKE_object_is_in_editmode()

bool BKE_object_is_in_editmode ( const Object * ob )

Actual check for internal data, not context or flags.

Definition at line 1718 of file blenkernel/intern/object.cc.

References Object::data, Object::mode, OB_ARMATURE, OB_CURVES, OB_CURVES_LEGACY, OB_FONT, OB_GREASE_PENCIL, OB_LATTICE, OB_MBALL, OB_MESH, OB_MODE_EDIT, OB_POINTCLOUD, OB_SURF, and Object::type.

Referenced by blender::ed::object::add_duplicate(), armature_undosys_step_decode(), BKE_object_data_is_in_editmode(), BKE_object_has_mode_data(), BKE_object_is_in_editmode_vgroup(), blender::ed::transform::createTransObject(), curve_undosys_step_decode(), curves_evaluate_modifiers(), blender::ed::transform::data_for_snap(), blender::ed::outliner::do_outliner_item_editmode_toggle(), DRW_object_is_in_edit_mode(), ED_armature_edit_select_pick_bone(), ED_armature_origin_set(), blender::ed::object::ed_object_mode_generic_exit_ex(), ED_view3d_viewcontext_init_object(), ED_wpaint_ensure_data(), blender::ed::object::editmode_enter_ex(), foreach_libblock_remap_callback(), grease_pencil_evaluate_modifiers(), knifeproject_exec(), lattice_undosys_step_decode(), material_slot_remove_poll(), mball_undosys_step_decode(), mesh_undosys_step_decode(), blender::ed::object::modifier_apply(), blender::ed::transform::nearest_world_object_fn(), object_array_for_shading_edit_mode_disabled_filter(), object_array_for_shading_edit_mode_enabled_filter(), blender::ed::object::object_remesh_poll(), blender::ed::outliner::outliner_draw_mode_column_toggle(), blender::ed::outliner::outliner_object_delete_fn(), blender::ed::transform::raycast_obj_fn(), blender::ed::transform::setSnappingCallback(), blender::ed::transform::snap_obj_fn(), blender::ed::transform::snapCurve(), blender::ed::curves::undo::step_decode(), blender::ed::greasepencil::undo::step_decode(), blender::ed::pointcloud::undo::step_decode(), and view3d_panel_curve_data_poll().

◆ BKE_object_is_in_editmode_vgroup()

bool BKE_object_is_in_editmode_vgroup ( const Object * ob )

Definition at line 1747 of file blenkernel/intern/object.cc.

References BKE_object_is_in_editmode(), OB_TYPE_SUPPORT_VGROUP, and Object::type.

Referenced by BKE_object_defgroup_remove(), BKE_object_defgroup_remove_all_ex(), blender::ed::object::vertex_group_poll_edit(), blender::ed::object::vertex_group_vert_poll_ex(), blender::ed::object::vertex_group_vert_select_mesh_poll(), blender::ed::object::vertex_group_vert_select_unlocked_poll(), and view3d_panel_vgroup_poll().

◆ BKE_object_is_in_wpaint_select_vert()

bool BKE_object_is_in_wpaint_select_vert ( const Object * ob )

Definition at line 1832 of file blenkernel/intern/object.cc.

References Object::data, ME_EDIT_PAINT_SEL_MODE, Object::mode, OB_MESH, OB_MODE_WEIGHT_PAINT, SCE_SELECT_VERTEX, and Object::type.

Referenced by blender::ed::object::vertex_group_vert_poll_ex(), blender::ed::object::vertex_group_vert_select_mesh_poll(), blender::ed::object::vertex_group_vert_select_unlocked_poll(), and view3d_panel_vgroup_poll().

◆ BKE_object_is_libdata()

bool BKE_object_is_libdata ( const Object * ob )

Returns true if the Object is from an external blend file (libdata).

Definition at line 2687 of file blenkernel/intern/object.cc.

References ID_IS_LINKED.

Referenced by BKE_object_add_from(), BKE_view_layer_selected_editable_objects_iterator_begin(), and BKE_view_layer_selected_editable_objects_iterator_next().

◆ BKE_object_is_mode_compat()

bool BKE_object_is_mode_compat	(	const Object *	ob,
		eObjectMode	object_mode )

Definition at line 1873 of file blenkernel/intern/object.cc.

References Object::mode.

Referenced by drw_select_filter_object_mode_lock(), ed_object_select_pick(), blender::ed::greasepencil::select_set_mode_exec(), and blender::ed::outliner::tree_element_object_activate().

◆ BKE_object_is_modified()

int BKE_object_is_modified	(	Scene *	scene,
		Object *	ob )

Most important if this is modified it should always return true, in certain cases false positives are hard to avoid (shape keys for example).

Returns: ModifierMode flag.

Definition at line 4643 of file blenkernel/intern/object.cc.

References BKE_key_from_object(), BKE_modifier_is_enabled(), BKE_modifiers_get_virtual_modifierlist(), DEG_get_original(), eModifierMode_Realtime, eModifierMode_Render, flag, and ModifierData::next.

◆ BKE_object_link_modifiers()

void BKE_object_link_modifiers	(	Object *	ob_dst,
		const Object *	ob_src )

Definition at line 1488 of file blenkernel/intern/object.cc.

References BKE_object_free_modifiers(), and BKE_object_modifier_stack_copy().

Referenced by blender::ed::object::make_links_data_exec(), and blender::ed::object::modifier_link().

◆ BKE_object_mat3_to_rot()

void BKE_object_mat3_to_rot	(	Object *	ob,
		float	r_mat[3][3],
		bool	use_compat )

◆ BKE_object_matrix_local_get()

void BKE_object_matrix_local_get	(	Object *	ob,
		float	r_mat[4][4] )

Definition at line 2950 of file blenkernel/intern/object.cc.

References BKE_object_get_parent_matrix(), copy_m4_m4(), invert_m4(), mul_m4_m4m4(), and Object::parent.

Referenced by BKE_object_add_from().

◆ BKE_object_minmax()

void BKE_object_minmax	(	Object *	ob,
		blender::float3 &	r_min,
		blender::float3 &	r_max )

References BKE_object_minmax().

Referenced by BKE_object_minmax(), PE_minmax(), view3d_localview_init(), and view3d_object_calc_minmax().

◆ BKE_object_minmax_dupli()

bool BKE_object_minmax_dupli	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob,
		blender::float3 &	r_min,
		blender::float3 &	r_max,
		bool	use_hidden )

References BKE_object_foreach_display_point(), BKE_object_minmax_dupli(), BKE_object_minmax_empty_drawtype(), BKE_object_parent_loop_check(), BKE_object_tfm_backup(), BKE_object_tfm_restore(), BKE_scene_foreach_display_point(), and depsgraph.

Referenced by BKE_object_minmax_dupli(), blender::ed::object::object_origin_set_exec(), and view3d_object_calc_minmax().

◆ BKE_object_minmax_empty_drawtype()

bool BKE_object_minmax_empty_drawtype	(	const Object *	ob,
		float	r_min[3],
		float	r_max[3] )

Calculate visual bounds from an empty objects draw-type.

Note: This is not part of the calculation used by BKE_object_boundbox_get as these bounds represent the extents of visual guides (use for viewport culling for example)

Definition at line 3713 of file blenkernel/intern/object.cc.

References BLI_assert, CLAMP_MAX, CLAMP_MIN, copy_v3_v3(), Object::empty_drawsize, Object::empty_drawtype, i, Object::ima_ofs, max, min, OB_ARROWS, OB_CIRCLE, OB_CUBE, OB_EMPTY, OB_EMPTY_CONE, OB_EMPTY_IMAGE, OB_EMPTY_SPHERE, OB_PLAINAXES, OB_SINGLE_ARROW, and Object::type.

Referenced by BKE_object_minmax_dupli(), and BKE_pchan_minmax().

◆ BKE_object_modifier_gpencil_hook_reset()

void BKE_object_modifier_gpencil_hook_reset	(	Object *	ob,
		HookGpencilModifierData *	hmd )

Definition at line 1194 of file blenkernel/intern/object.cc.

References BKE_pose_channel_find_name(), invert_m4_m4(), mul_m4_m4m4(), HookGpencilModifierData::object, HookGpencilModifierData::parentinv, Object::pose, bPoseChannel::pose_mat, Object::runtime, and HookGpencilModifierData::subtarget.

◆ BKE_object_modifier_hook_reset()

void BKE_object_modifier_hook_reset	(	Object *	ob,
		HookModifierData *	hmd )

Definition at line 1169 of file blenkernel/intern/object.cc.

References BKE_pose_channel_find_name(), invert_m4_m4(), mul_m4_m4m4(), HookModifierData::object, HookModifierData::parentinv, Object::pose, bPoseChannel::pose_mat, Object::runtime, and HookModifierData::subtarget.

Referenced by blender::ed::object::object_hook_reset_exec().

◆ BKE_object_modifier_set_active()

void BKE_object_modifier_set_active	(	Object *	ob,
		ModifierData *	md )

Set the object's active modifier.

Parameters

md	If nullptr, only clear the active modifier, otherwise it must be in the Object.modifiers list.

Definition at line 1219 of file blenkernel/intern/object.cc.

References BLI_assert, BLI_findindex(), eModifierFlag_Active, ModifierData::flag, LISTBASE_FOREACH, and Object::modifiers.

Referenced by BKE_modifier_remove_from_list(), BKE_object_copy_modifier(), blender::ed::object::modifier_add(), blender::ed::object::modifier_copy(), blender::ed::object::modifier_set_active_exec(), object_add_or_copy_particle_system(), blender::io::usd::USDPointInstancerReader::read_object_data(), and blender::ed::outliner::tree_element_modifier_activate().

◆ BKE_object_modifier_stack_copy()

bool BKE_object_modifier_stack_copy	(	Object *	ob_dst,
		const Object *	ob_src,
		bool	do_copy_all,
		int	flag_subdata )

Copy the whole stack of modifiers from one object into another.

Warning: Does not clear modifier stack and related data (particle systems, soft-body, etc.) in ob_dst, if needed calling code must do it. The caller is also responsible for ensuring the modifier identifiers are unique.

Parameters

do_copy_all If true, even modifiers that should not support copying (like Hook one) will be duplicated.

Definition at line 1451 of file blenkernel/intern/object.cc.

References BKE_modifier_copy_ex(), BKE_object_copy_particlesystems(), BKE_object_copy_softbody(), BKE_object_support_modifier_type_check(), BLI_addtail(), BLI_assert_msg, BLI_listbase_is_empty(), Object::greasepencil_modifiers, LISTBASE_FOREACH, Object::modifiers, object_modifier_type_copy_check(), and Object::type.

Referenced by BKE_object_link_modifiers(), and object_copy_data().

◆ BKE_object_modifier_update_subframe()

void BKE_object_modifier_update_subframe	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob,
		bool	update_mesh,
		int	parent_recursion_limit,
		float	frame,
		int	modifier_type )

Note: this function should eventually be replaced by depsgraph functionality. Avoid calling this in new code unless there is a very good reason for it!

Definition at line 5303 of file blenkernel/intern/object.cc.

References bArmature::adt, Curve::adt, Object::adt, ADT_RECALC_ANIM, BKE_animsys_eval_context_construct(), BKE_animsys_evaluate_animdata(), BKE_object_handle_update(), BKE_object_modifier_update_subframe_only_callback(), BKE_object_where_is_calc_time(), BKE_pose_where_is(), Object::data, DEG_is_active(), depsgraph, bArmature::id, Curve::id, Object::id, ID_RECALC_ALL, OB_ARMATURE, OB_CURVES_LEGACY, object_cacheIgnoreClear(), ID::recalc, and Object::type.

Referenced by dynamicPaint_brushMeshCalculateVelocity(), dynamicPaint_brushObjectCalculateVelocity(), and dynamicPaint_doStep().

◆ BKE_object_modifier_update_subframe_only_callback()

void BKE_object_modifier_update_subframe_only_callback	(	Object *	ob,
		bool	update_mesh,
		int	parent_recursion_limit,
		int	modifier_type,
		blender::FunctionRef< void(Object *object, bool update_mesh)>	update_or_tag_fn )

Call update_or_tag_fn on all objects which BKE_object_modifier_update_subframe would update. Used by the depsgraph to setup relations.

Definition at line 5289 of file blenkernel/intern/object.cc.

References object_modifier_recurse_for_update_subframe().

Referenced by BKE_object_modifier_update_subframe(), and DEG_add_collision_relations().

◆ BKE_object_moves_in_time()

bool BKE_object_moves_in_time	(	const Object *	object,
		bool	recurse_parent )

Check of objects moves in time.

Note: This function is currently optimized for usage in combination with modifier deformation checks (ModifierTypeType::OnlyDeform), so modifiers can quickly check if their target objects moves (causing deformation motion blur) or not.

This makes it possible to give some degree of false-positives here, but it's currently an acceptable tradeoff between complexity and check speed. In combination with checks of modifier stack and real life usage percentage of false-positives shouldn't be that high.

Note: This function does not consider physics systems.

Definition at line 4679 of file blenkernel/intern/object.cc.

References BKE_animdata_id_is_animated(), BKE_object_moves_in_time(), and BLI_listbase_is_empty().

Referenced by BKE_object_moves_in_time(), blender::io::alembic::ABCTransformWriter::check_is_animated(), blender::io::usd::USDTransformWriter::check_is_animated(), and object_moves_in_time().

◆ BKE_object_movieclip_get()

MovieClip * BKE_object_movieclip_get	(	Scene *	scene,
		const Object *	ob,
		bool	use_default )

Definition at line 4837 of file blenkernel/intern/object.cc.

References CAMERASOLVER_ACTIVECLIP, bCameraSolverConstraint::clip, Scene::clip, CONSTRAINT_OFF, CONSTRAINT_TYPE_CAMERASOLVER, Object::constraints, ListBase::first, bCameraSolverConstraint::flag, bConstraint::next, and bConstraint::type.

Referenced by blender::ed::object::apply_objects_internal(), bundle_midpoint(), ed_object_select_pick(), get_camera_with_movieclip(), and blender::ed::transform::snapCamera().

◆ BKE_object_obdata_add_from_type()

void * BKE_object_obdata_add_from_type	(	Main *	bmain,
		int	type,
		const char *	name )

◆ BKE_object_obdata_is_libdata()

bool BKE_object_obdata_is_libdata ( const Object * ob )

Returns true if the Object data is from an external blend file (libdata).

Definition at line 2692 of file blenkernel/intern/object.cc.

References BLI_assert, Object::data, and ID_IS_LINKED.

Referenced by blender::ed::object::active_shape_key_editable_poll(), apply_armature_pose2bones_exec(), BKE_object_add_from(), blender::ed::transform::createTransTexspace(), blender::ed::object::editmode_enter_ex(), and blender::ed::object::object_join_exec().

◆ BKE_object_obdata_size_init()

void BKE_object_obdata_size_init	(	Object *	ob,
		float	size )

Use with newly created objects to set their size (used to apply scene-scale).

Definition at line 2699 of file blenkernel/intern/object.cc.

References Light::area_size, Light::area_sizey, Light::area_sizez, BKE_lattice_transform(), Object::data, Camera::drawsize, Object::empty_drawsize, Curve::fsize, OB_CAMERA, OB_EMPTY, OB_FONT, OB_LAMP, OB_LATTICE, Light::radius, scale_m4_fl(), size(), Object::type, and unit_m4().

Referenced by BKE_object_add_from(), blender::ed::object::effector_add_exec(), blender::ed::object::object_add_exec(), blender::ed::object::object_add_text_exec(), blender::ed::object::object_empty_add_exec(), and blender::ed::object::object_light_add_exec().

◆ BKE_object_obdata_texspace_get()

bool BKE_object_obdata_texspace_get	(	Object *	ob,
		char **	r_texspace_flag,
		float **	r_texspace_location,
		float **	r_texspace_size )

Definition at line 4095 of file blenkernel/intern/object.cc.

References BKE_curve_texspace_ensure(), BKE_mesh_texspace_get_reference(), Object::data, GS, ID_CU_LEGACY, ID_MB, ID_ME, Curve::texspace_flag, MetaBall::texspace_flag, Curve::texspace_location, MetaBall::texspace_location, Curve::texspace_size, and MetaBall::texspace_size.

Referenced by blender::ed::transform::createTransTexspace().

◆ BKE_object_obdata_to_type()

int BKE_object_obdata_to_type ( const ID * id )

Return -1 on failure.

Definition at line 2045 of file blenkernel/intern/object.cc.

References GS, ID_AR, ID_CA, ID_CU_LEGACY, ID_CV, ID_GP, ID_LA, ID_LP, ID_LT, ID_MB, ID_ME, ID_PT, ID_SPK, ID_VO, OB_ARMATURE, OB_CAMERA, OB_CURVES, OB_GREASE_PENCIL, OB_LAMP, OB_LATTICE, OB_LIGHTPROBE, OB_MBALL, OB_MESH, OB_POINTCLOUD, OB_SPEAKER, and OB_VOLUME.

Referenced by blender::ed::object::add_type_with_obdata(), BKE_object_add_from(), BKE_object_replace_data_on_shallow_copy(), loose_data_instantiate_obdata_process(), blender::ed::object::object_data_instance_add_exec(), and blender::draw::supports_handle_ranges().

◆ BKE_object_parent_loop_check()

bool BKE_object_parent_loop_check	(	const Object *	parent,
		const Object *	ob )

Definition at line 4609 of file blenkernel/intern/object.cc.

References BKE_object_parent_loop_check(), and Object::parent.

Referenced by BKE_object_minmax_dupli(), BKE_object_parent_loop_check(), blender::ed::object::parent_noinv_set_exec(), blender::ed::object::parent_set(), blender::ed::object::parent_set_with_depsgraph(), and blender::ed::object::vertex_parent_set_exec().

◆ BKE_object_pose_armature_get()

Object * BKE_object_pose_armature_get ( Object * ob )

Definition at line 2360 of file blenkernel/intern/object.cc.

References BKE_modifiers_is_deformed_by_armature(), and BKE_object_pose_context_check().

Referenced by apply_armature_pose2bones_exec(), BKE_object_add_from(), BKE_object_defgroup_selected_get(), BKE_object_pose_armature_get_visible(), BKE_object_pose_armature_get_with_wpaint_check(), BKE_object_pose_array_get_ex(), BKE_object_pose_base_array_get_ex(), draw_selected_name(), blender::ed::object::dt_layers_select_src_itemf(), ED_operator_posemode(), ed_operator_posemode_exclusive_ex(), ED_operator_posemode_local(), ED_pose_object_from_context(), ED_view3d_select_filter_from_mode(), blender::ed::transform::gizmo_3d_transform_space_object_get(), blender::draw::overlay::Armatures::is_pose_mode(), blender::ed::outliner::outliner_show_active_get_element(), blender::ed::outliner::outliner_viewcontext_init(), pose_calculate_paths_exec(), pose_calculate_paths_invoke(), pose_clear_paths_exec(), blender::ed::object::pose_constraint_add_exec(), pose_copy_exec(), blender::ed::object::pose_ik_add_invoke(), pose_paste_exec(), pose_select_grouped_exec(), pose_select_hierarchy_exec(), pose_select_parent_exec(), pose_select_same_keyingset(), pose_update_paths_exec(), pose_update_paths_range_exec(), poseAnim_object_get(), screen_ctx_active_pose_bone(), screen_ctx_pose_object(), screen_ctx_selected_pose_bones(), screen_ctx_selected_pose_bones_from_active_object(), screen_ctx_visible_pose_bones(), toggle_xray_exec(), blender::ed::outliner::tree_element_posechannel_activate(), uiTemplatePaintModeSelection(), blender::ed::object::vgroup_selection_itemf_helper(), blender::ed::object::vgroup_sync_from_pose(), view3d_orbit_calc_center(), view3d_select_exec(), WIDGETGROUP_armature_spline_poll(), WIDGETGROUP_armature_spline_refresh(), and WIDGETGROUP_armature_spline_setup().

◆ BKE_object_pose_armature_get_visible()

Object * BKE_object_pose_armature_get_visible	(	Object *	ob,
		const Scene *	scene,
		ViewLayer *	view_layer,
		View3D *	v3d )

Definition at line 2402 of file blenkernel/intern/object.cc.

References BASE_VISIBLE, BKE_object_pose_armature_get(), BKE_view_layer_base_find(), and BKE_view_layer_synced_ensure().

Referenced by BKE_object_add_from().

◆ BKE_object_pose_armature_get_with_wpaint_check()

Object * BKE_object_pose_armature_get_with_wpaint_check ( Object * ob )

A version of BKE_object_pose_armature_get with an additional check. When ob isn't an armature: only return the referenced pose object when the active object is in weight paint mode.

Note: Some callers need to check that pose bones are selectable which isn't the case when the object using the armature isn't in weight-paint mode.

Definition at line 2380 of file blenkernel/intern/object.cc.

References BKE_object_pose_armature_get(), Object::mode, OB_GREASE_PENCIL, OB_MESH, OB_MODE_WEIGHT_GREASE_PENCIL, OB_MODE_WEIGHT_PAINT, and Object::type.

Referenced by BKE_object_add_from(), do_pose_tag_select_op_prepare(), ed_object_select_pick(), view3d_box_select_exec(), view3d_circle_select_exec(), view3d_lasso_select(), and view3d_selectable_data().

◆ BKE_object_pose_array_get()

blender::Vector< Object * > BKE_object_pose_array_get	(	const Scene *	scene,
		ViewLayer *	view_layer,
		View3D *	v3d )

Definition at line 2447 of file blenkernel/intern/object.cc.

References BKE_object_pose_array_get_ex().

Referenced by BKE_object_add_from(), blender::ed::transform::gizmo_3d_foreach_selected(), snap_sel_to_grid_exec(), and snap_selected_to_location_rotation().

◆ BKE_object_pose_array_get_ex()

blender::Vector< Object * > BKE_object_pose_array_get_ex	(	const Scene *	scene,
		ViewLayer *	view_layer,
		View3D *	v3d,
		bool	unique )

Access pose array with special check to get pose object when in weight paint mode.

Definition at line 2420 of file blenkernel/intern/object.cc.

References BKE_object_pose_armature_get(), BKE_view_layer_active_object_get(), BKE_view_layer_array_from_objects_in_mode_params(), BKE_view_layer_synced_ensure(), ObjectsInModeParams::no_dup_data, OB_MODE_POSE, and ObjectsInModeParams::object_mode.

Referenced by BKE_object_add_from(), BKE_object_pose_array_get(), and BKE_object_pose_array_get_unique().

◆ BKE_object_pose_array_get_unique()

blender::Vector< Object * > BKE_object_pose_array_get_unique	(	const Scene *	scene,
		ViewLayer *	view_layer,
		View3D *	v3d )

Definition at line 2441 of file blenkernel/intern/object.cc.

References BKE_object_pose_array_get_ex().

Referenced by BKE_object_add_from(), pose_hide_exec(), pose_reveal_exec(), pose_select_children(), pose_select_mirror_exec(), pose_select_parents(), pose_select_same_keyingset(), pose_select_siblings(), and blender::ed::outliner::tree_element_posechannel_activate().

◆ BKE_object_pose_base_array_get()

blender::Vector< Base * > BKE_object_pose_base_array_get	(	const Scene *	scene,
		ViewLayer *	view_layer,
		View3D *	v3d )

Definition at line 2490 of file blenkernel/intern/object.cc.

References BKE_object_pose_base_array_get_ex().

Referenced by BKE_object_add_from(), and ed_armature_pick_bone_impl().

◆ BKE_object_pose_base_array_get_ex()

blender::Vector< Base * > BKE_object_pose_base_array_get_ex	(	const Scene *	scene,
		ViewLayer *	view_layer,
		View3D *	v3d,
		bool	unique )

Definition at line 2452 of file blenkernel/intern/object.cc.

References BKE_object_pose_armature_get(), BKE_view_layer_active_base_get(), BKE_view_layer_array_from_bases_in_mode_params(), BKE_view_layer_base_find(), BKE_view_layer_synced_ensure(), ObjectsInModeParams::no_dup_data, OB_MODE_POSE, Base::object, and ObjectsInModeParams::object_mode.

Referenced by BKE_object_add_from(), BKE_object_pose_base_array_get(), and BKE_object_pose_base_array_get_unique().

◆ BKE_object_pose_base_array_get_unique()

blender::Vector< Base * > BKE_object_pose_base_array_get_unique	(	const Scene *	scene,
		ViewLayer *	view_layer,
		View3D *	v3d )

Definition at line 2484 of file blenkernel/intern/object.cc.

References BKE_object_pose_base_array_get_ex().

Referenced by BKE_object_add_from(), and ED_pose_deselect_all_multi().

◆ BKE_object_pose_context_check()

bool BKE_object_pose_context_check ( const Object * ob )

Definition at line 2351 of file blenkernel/intern/object.cc.

References Object::mode, OB_ARMATURE, OB_MODE_POSE, Object::pose, and Object::type.

Referenced by BKE_object_add_from(), BKE_object_pose_armature_get(), and ED_operator_posemode_context().

◆ BKE_object_protected_location_set()

void BKE_object_protected_location_set	(	Object *	ob,
		const float	location[3] )

Sets the location of the object, respecting Object::protectflag.

Definition at line 3957 of file blenkernel/intern/object.cc.

References Object::loc, OB_LOCK_LOCX, OB_LOCK_LOCY, OB_LOCK_LOCZ, and Object::protectflag.

Referenced by snap_sel_to_grid_exec(), and snap_selected_to_location_rotation().

◆ BKE_object_protected_rotation_axisangle_set()

void BKE_object_protected_rotation_axisangle_set	(	Object *	ob,
		const float	axis[3],
		float	angle )

Sets the quaternion rotation of the object, respecting Object::protectflag.

Definition at line 4012 of file blenkernel/intern/object.cc.

References angle(), OB_LOCK_ROTW, OB_LOCK_ROTX, OB_LOCK_ROTY, OB_LOCK_ROTZ, Object::protectflag, Object::rotAngle, and Object::rotAxis.

Referenced by snap_selected_to_location_rotation().

◆ BKE_object_protected_rotation_euler_set()

void BKE_object_protected_rotation_euler_set	(	Object *	ob,
		const float	euler[3] )

Sets the euler rotation of the object, respecting Object::protectflag.

Definition at line 3999 of file blenkernel/intern/object.cc.

References OB_LOCK_ROTX, OB_LOCK_ROTY, OB_LOCK_ROTZ, Object::protectflag, and Object::rot.

Referenced by snap_selected_to_location_rotation().

◆ BKE_object_protected_rotation_quaternion_set()

void BKE_object_protected_rotation_quaternion_set	(	Object *	ob,
		const float	quat[4] )

Sets the quaternion rotation of the object, respecting Object::protectflag.

Definition at line 3983 of file blenkernel/intern/object.cc.

References OB_LOCK_ROTW, OB_LOCK_ROTX, OB_LOCK_ROTY, OB_LOCK_ROTZ, Object::protectflag, and Object::quat.

Referenced by snap_selected_to_location_rotation().

◆ BKE_object_protected_scale_set()

void BKE_object_protected_scale_set	(	Object *	ob,
		const float	scale[3] )

Sets the scale of the object, respecting Object::protectflag.

Definition at line 3970 of file blenkernel/intern/object.cc.

References OB_LOCK_SCALEX, OB_LOCK_SCALEY, OB_LOCK_SCALEZ, Object::protectflag, and Object::scale.

◆ BKE_object_relational_superset()

LinkNode * BKE_object_relational_superset	(	const Scene *	scene,
		ViewLayer *	view_layer,
		eObjectSet	objectSet,
		eObRelationTypes	includeFilter )

Iterates over all objects of the given scene layer. Depending on the eObjectSet flag: collect either OB_SET_ALL, OB_SET_VISIBLE or OB_SET_SELECTED objects. If OB_SET_VISIBLE or#OB_SET_SELECTED are collected, then also add related objects according to the given includeFilter.

Definition at line 4951 of file blenkernel/intern/object.cc.

References BASE_EDITABLE, BASE_SELECTED_EDITABLE, BKE_object_is_child_recursive(), BKE_view_layer_object_bases_get(), BKE_view_layer_synced_ensure(), ID_TAG_DOIT, LISTBASE_FOREACH, OB_REL_CHILDREN, OB_REL_CHILDREN_RECURSIVE, OB_REL_MOD_ARMATURE, OB_REL_PARENT, OB_REL_PARENT_RECURSIVE, OB_SET_ALL, OB_SET_SELECTED, OB_SET_VISIBLE, obrel_armature_find(), obrel_list_add(), obrel_list_test(), and Object::parent.

◆ BKE_object_replace_data_on_shallow_copy()

void BKE_object_replace_data_on_shallow_copy	(	Object *	ob,
		ID *	new_data )

Definition at line 5427 of file blenkernel/intern/object.cc.

References BKE_object_obdata_to_type(), Object::data, Object::id, ID::py_instance, Object::runtime, and Object::type.

Referenced by BKE_object_minmax_dupli(), evil::DEG_iterator_temp_object_from_dupli(), and DupliCacheManager::extract_all().

◆ BKE_object_rot_to_mat3()

void BKE_object_rot_to_mat3	(	const Object *	ob,
		float	r_mat[3][3],
		bool	use_drot )

◆ BKE_object_runtime_free_data()

void BKE_object_runtime_free_data ( Object * object )

The function frees memory used by the runtime data, but not the runtime field itself.

All runtime data is cleared to ensure it's not used again, in keeping with other _free_data(..) functions.

Definition at line 4905 of file blenkernel/intern/object.cc.

References BKE_object_free_derived_caches(), and BKE_object_runtime_reset().

Referenced by curve_to_mesh_eval_ensure().

◆ BKE_object_runtime_reset()

void BKE_object_runtime_reset ( Object * object )

Definition at line 4885 of file blenkernel/intern/object.cc.

Referenced by BKE_object_runtime_free_data(), curve_to_mesh_eval_ensure(), and blender::deg::ObjectRuntimeBackup::init_from_object().

◆ BKE_object_runtime_reset_on_copy()

void BKE_object_runtime_reset_on_copy	(	Object *	object,
		int	flag )

Reset all pointers which we don't want to be shared when copying the object.

Definition at line 4890 of file blenkernel/intern/object.cc.

References blender::bke::ObjectRuntime::crazyspace_deform_cos, blender::bke::ObjectRuntime::crazyspace_deform_imats, blender::bke::ObjectRuntime::curve_cache, blender::bke::ObjectRuntime::data_eval, blender::bke::ObjectRuntime::geometry_set_eval, blender::bke::ObjectRuntime::mesh_deform_eval, blender::bke::ObjectRuntime::object_as_temp_curve, blender::bke::ObjectRuntime::object_as_temp_mesh, and blender::bke::ObjectRuntime::pose_backup.

Referenced by object_copy_data().

◆ BKE_object_scale_to_mat3()

void BKE_object_scale_to_mat3	(	const Object *	ob,
		float	r_mat[3][3] )

Definition at line 2744 of file blenkernel/intern/object.cc.

References Object::dscale, mul_v3_v3v3(), Object::scale, and size_to_mat3().

Referenced by blender::ed::object::apply_objects_internal(), BKE_object_add_from(), BKE_object_to_mat3(), mball_select_similar_type(), mball_select_similar_type_get(), multiresModifier_prepare_join(), and multiresModifier_scale_disp().

◆ BKE_object_scenes_users_get()

int BKE_object_scenes_users_get	(	Main *	bmain,
		Object *	ob )

Return the number of scenes using (instantiating) that object in their collections.

Definition at line 4826 of file blenkernel/intern/object.cc.

References BKE_collection_has_object_recursive(), LISTBASE_FOREACH, and Main::scenes.

Referenced by blender::ed::object::single_object_users_collection().

◆ BKE_object_sculpt_data_create()

void BKE_object_sculpt_data_create ( Object * ob )

Definition at line 4088 of file blenkernel/intern/object.cc.

References BLI_assert, Object::mode, SculptSession::mode_type, OB_MODE_ALL_SCULPT, and Object::sculpt.

Referenced by ED_editors_init(), and object_blend_read_data().

◆ BKE_object_select_update()

void BKE_object_select_update	(	Depsgraph *	depsgraph,
		Object *	object )

Definition at line 343 of file object_update.cc.

References BKE_object_data_select_update(), Object::data, DEG_debug_print_eval(), depsgraph, Object::id, lock, ID::name, OB_MESH, Mesh::runtime, Object::runtime, and Object::type.

◆ BKE_object_shapekey_free()

bool BKE_object_shapekey_free	(	Main *	bmain,
		Object *	ob )

Definition at line 4516 of file blenkernel/intern/object.cc.

References BKE_id_free_us(), BKE_key_from_object_p(), and ELEM.

Referenced by BKE_object_shapekey_remove(), and blender::ed::object::shape_key_remove_exec().

◆ BKE_object_shapekey_insert()

KeyBlock * BKE_object_shapekey_insert	(	Main *	bmain,
		Object *	ob,
		const char *	name,
		bool	from_mix )

Definition at line 4484 of file blenkernel/intern/object.cc.

References insert_curvekey(), insert_lattkey(), insert_meshkey(), name, OB_CURVES_LEGACY, OB_LATTICE, OB_MESH, OB_SURF, Object::shapenr, and Object::type.

Referenced by blender::ed::object::object_shape_key_add().

◆ BKE_object_shapekey_remove()

bool BKE_object_shapekey_remove	(	Main *	bmain,
		Object *	ob,
		KeyBlock *	kb )

◆ BKE_object_support_modifier_type_check()

bool BKE_object_support_modifier_type_check	(	const Object *	ob,
		int	modifier_type )

◆ BKE_object_supports_material_slots()

bool BKE_object_supports_material_slots ( Object * ob )

Definition at line 4865 of file blenkernel/intern/object.cc.

References ELEM, OB_CURVES, OB_CURVES_LEGACY, OB_FONT, OB_GREASE_PENCIL, OB_MBALL, OB_MESH, OB_POINTCLOUD, OB_SURF, OB_VOLUME, and Object::type.

Referenced by BKE_object_material_slot_used().

◆ BKE_object_supports_modifiers()

bool BKE_object_supports_modifiers ( const Object * ob )

Returns: True if the object's type supports regular modifiers (not grease pencil modifiers).

Definition at line 1253 of file blenkernel/intern/object.cc.

References ELEM, OB_CURVES, OB_CURVES_LEGACY, OB_FONT, OB_GREASE_PENCIL, OB_LATTICE, OB_MESH, OB_POINTCLOUD, OB_SURF, OB_VOLUME, and Object::type.

Referenced by blender::ed::object::modifier_copy_to_selected_poll(), blender::ed::object::modifiers_clear_poll(), and blender::ed::object::modifiers_copy_to_selected_poll().

◆ BKE_object_sync_to_original()

void BKE_object_sync_to_original	(	Depsgraph *	depsgraph,
		Object *	object )

Definition at line 222 of file object_update.cc.

References Object::base_flag, Object::base_local_view_bits, BLI_assert, BLI_strdup(), Object::constinv, copy_m4_m4(), DEG_get_original(), DEG_is_active(), depsgraph, ListBase::first, Object::flag, MEM_SAFE_FREE, Object::modifiers, ModifierData::next, Object::runtime, STREQ, and Object::transflag.

◆ BKE_object_tfm_backup()

void * BKE_object_tfm_backup ( Object * ob )

◆ BKE_object_tfm_copy()

void BKE_object_tfm_copy	(	Object *	object_dst,
		const Object *	object_src )

Definition at line 2902 of file blenkernel/intern/object.cc.

References rot, TFMCPY, TFMCPY3D, and TFMCPY4D.

Referenced by blender::ed::transform::ObjectToTransData().

◆ BKE_object_tfm_protected_backup()

void BKE_object_tfm_protected_backup	(	const Object *	ob,
		ObjectTfmProtectedChannels *	obtfm )

Definition at line 2839 of file blenkernel/intern/object.cc.

References rot, TFMCPY, TFMCPY3D, and TFMCPY4D.

Referenced by ED_view3d_camera_lock_sync(), object_apply_mat4_with_protect(), view3d_camera_to_view_exec(), and view3d_camera_to_view_selected_impl().

◆ BKE_object_tfm_protected_restore()

void BKE_object_tfm_protected_restore	(	Object *	ob,
		const ObjectTfmProtectedChannels *	obtfm,
		short	protectflag )

Definition at line 2864 of file blenkernel/intern/object.cc.

Referenced by ED_view3d_camera_lock_sync(), object_apply_mat4_with_protect(), view3d_camera_to_view_exec(), and view3d_camera_to_view_selected_impl().

◆ BKE_object_tfm_restore()

void BKE_object_tfm_restore	(	Object *	ob,
		void *	obtfm_pt )

◆ BKE_object_to_curve()

Curve * BKE_object_to_curve	(	Object *	object,
		Depsgraph *	depsgraph,
		bool	apply_modifiers )

This is an utility function for Python's object.to_curve(). The result is owned by the object.

The curve will be freed when object is re-evaluated or is destroyed. It is possible to force clear memory used by this curve by calling BKE_object_to_curve_clear().

If apply_modifiers is true and the object is a curve one, then spline deform modifiers are applied on the curve control points.

Definition at line 5389 of file blenkernel/intern/object.cc.

References BKE_curve_new_from_object(), BKE_object_to_curve_clear(), and depsgraph.

◆ BKE_object_to_curve_clear()

void BKE_object_to_curve_clear ( Object * object )

Definition at line 5398 of file blenkernel/intern/object.cc.

References BKE_id_free().

Referenced by BKE_object_free_derived_caches(), and BKE_object_to_curve().

◆ BKE_object_to_mat3()

void BKE_object_to_mat3	(	const Object *	ob,
		float	r_mat[3][3] )

Definition at line 2926 of file blenkernel/intern/object.cc.

References BKE_object_rot_to_mat3(), BKE_object_scale_to_mat3(), and mul_m3_m3m3().

Referenced by blender::ed::object::apply_objects_internal(), BKE_object_add_from(), BKE_object_to_mat4(), blender::ed::object::object_transform_axis_target_invoke(), and blender::ed::transform::ObjectToTransData().

◆ BKE_object_to_mat4()

void BKE_object_to_mat4	(	const Object *	ob,
		float	r_mat[4][4] )

◆ BKE_object_to_mesh()

Mesh * BKE_object_to_mesh	(	Depsgraph *	depsgraph,
		Object *	object,
		bool	preserve_all_data_layers )

This is an utility function for Python's object.to_mesh() (the naming is not very clear though). The result is owned by the object.

The mesh will be freed when object is re-evaluated or is destroyed. It is possible to force to clear memory used by this mesh by calling BKE_object_to_mesh_clear().

If preserve_all_data_layers is true then the modifier stack is re-evaluated to ensure it preserves all possible custom data layers.

NOTE: Dependency graph argument is required when preserve_all_data_layers is truth, and is ignored otherwise.

Definition at line 5371 of file blenkernel/intern/object.cc.

References BKE_mesh_new_from_object(), BKE_object_to_mesh_clear(), and depsgraph.

Referenced by blender::io::hydra::MeshData::init(), and Freestyle::BlenderFileLoader::Load().

◆ BKE_object_to_mesh_clear()

void BKE_object_to_mesh_clear ( Object * object )

Definition at line 5380 of file blenkernel/intern/object.cc.

References BKE_id_free().

Referenced by BKE_object_free_derived_caches(), BKE_object_to_mesh(), blender::io::hydra::MeshData::init(), and Freestyle::BlenderFileLoader::Load().

◆ BKE_object_transform_copy()

void BKE_object_transform_copy	(	Object *	ob_tar,
		const Object *	ob_src )

Definition at line 2497 of file blenkernel/intern/object.cc.

References copy_v3_v3(), copy_v4_v4(), Object::loc, Object::quat, Object::rot, Object::rotAngle, Object::rotAxis, Object::rotmode, and Object::scale.

Referenced by blender::ed::object::add_hook_object(), blender::ed::object::apply_objects_internal(), blender::ed::object::ignore_parent_tx(), blender::ed::object::modifier_skin_armature_create(), blender::ed::object::object_origin_set_exec(), set_plane_exec(), and blender::ed::object::visual_transform_apply_exec().

◆ BKE_object_update_select_id()

void BKE_object_update_select_id ( Main * bmain )

Updates select_id of all objects in the given bmain.

Definition at line 5355 of file blenkernel/intern/object.cc.

References ListBase::first, Object::id, ID::next, Main::objects, and Object::runtime.

Referenced by armature_select_linked_pick_invoke(), armature_shortest_path_pick_invoke(), blender::ui::bonedropper_invoke(), ed_view3d_give_base_under_cursor_ex(), view3d_box_select_exec(), view3d_circle_select_exec(), view3d_lasso_select_exec(), and view3d_select_exec().

◆ BKE_object_visibility()

int BKE_object_visibility	(	const Object *	ob,
		int	dag_eval_mode )

Return which parts of the object are visible, as evaluated by depsgraph.

Definition at line 1878 of file blenkernel/intern/object.cc.

References BASE_ENABLED_AND_MAYBE_VISIBLE_IN_VIEWPORT, Object::base_flag, DAG_EVAL_RENDER, DAG_EVAL_VIEWPORT, Object::duplicator_visibility_flag, ListBase::first, OB_DUPLI, OB_DUPLI_FLAG_RENDER, OB_DUPLI_FLAG_VIEWPORT, OB_VISIBLE_INSTANCES, OB_VISIBLE_PARTICLES, OB_VISIBLE_SELF, blender::bke::object_has_geometry_set_instances(), Object::particlesystem, and Object::transflag.

Referenced by evil::DEG_iterator_temp_object_from_dupli(), DRW_object_visibility_in_active_context(), DRW_render_check_grease_pencil(), blender::draw::foreach_obref_in_scene(), init_meta(), blender::io::HierarchyContext::is_object_visible(), blender::io::hydra::ObjectData::is_visible(), lineart_main_load_geometries(), and Freestyle::BlenderFileLoader::Load().

◆ BKE_object_where_is_calc()

void BKE_object_where_is_calc	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob )

Compute object world transform and store it in ob->object_to_world().ptr().

Definition at line 3360 of file blenkernel/intern/object.cc.

References DEG_get_ctime(), depsgraph, and object_where_is_calc_ex().

Referenced by blender::ed::object::add_hook_object(), blender::ed::object::apply_objects_internal(), BKE_object_add_from(), BKE_object_calc_parent(), ED_view3d_cameracontrol_acquire(), blender::ed::object::object_origin_set_exec(), blender::ed::transform::ObjectToTransData(), set_plane_exec(), txt_add_object(), and blender::ed::object::visual_transform_apply_exec().

◆ BKE_object_where_is_calc_ex()

void BKE_object_where_is_calc_ex	(	Depsgraph *	depsgraph,
		Scene *	scene,
		RigidBodyWorld *	rbw,
		Object *	ob,
		float	r_originmat[3][3] )

Definition at line 3354 of file blenkernel/intern/object.cc.

References DEG_get_ctime(), depsgraph, and object_where_is_calc_ex().

Referenced by BKE_object_add_from(), BKE_object_handle_update_ex(), and snap_sel_to_grid_exec().

◆ BKE_object_where_is_calc_mat4()

void BKE_object_where_is_calc_mat4	(	const Object *	ob,
		float	r_obmat[4][4] )

Calculate object transformation matrix without recalculating dependencies and constraints – assume dependencies are already solved by depsgraph. No changes to object and its parent would be done. Used for bundles orientation in 3d space relative to parented blender camera.

Definition at line 3343 of file blenkernel/intern/object.cc.

References BKE_object_to_mat4(), Object::parent, and solve_parenting().

Referenced by BKE_object_add_from(), BKE_tracking_get_camera_object_matrix(), followtrack_distance_from_viewplane_get(), and object_solver_inverted_matrix().

◆ BKE_object_where_is_calc_time()

void BKE_object_where_is_calc_time	(	Depsgraph *	depsgraph,
		Scene *	scene,
		Object *	ob,
		float	ctime )

Definition at line 3332 of file blenkernel/intern/object.cc.

References Object::adt, ADT_RECALC_ALL, BKE_animsys_eval_context_construct(), BKE_animsys_evaluate_animdata(), DEG_is_active(), depsgraph, Object::id, and object_where_is_calc_ex().

Referenced by BKE_object_add_from(), BKE_object_modifier_update_subframe(), and evaluate_emitter_anim().

◆ BKE_object_workob_clear()

void BKE_object_workob_clear ( Object * workob )

Definition at line 1106 of file blenkernel/intern/object.cc.

References Object::dscale, ROT_MODE_EUL, Object::rotmode, and Object::scale.

Referenced by BKE_object_calc_parent(), and what_does_obaction().

◆ BKE_scene_foreach_display_point()

void BKE_scene_foreach_display_point	(	Depsgraph *	depsgraph,
		void(*	func_cb )(const float[3], void *),
		void *	user_data )

Definition at line 3869 of file blenkernel/intern/object.cc.

References Object::base_flag, BASE_SELECTED, BKE_object_foreach_display_point(), DEG_ITER_OBJECT_FLAG_DUPLI, DEG_ITER_OBJECT_FLAG_LINKED_DIRECTLY, DEG_ITER_OBJECT_FLAG_VISIBLE, DEG_OBJECT_ITER_BEGIN, DEG_OBJECT_ITER_END, DEGObjectIterSettings::depsgraph, depsgraph, and DEGObjectIterSettings::flags.

Referenced by BKE_camera_view_frame_fit_to_scene(), and BKE_object_minmax_dupli().

Variable Documentation

◆ ATTR_RETURNS_NONNULL

Object ATTR_RETURNS_NONNULL

Definition at line 177 of file BKE_object.hh.

Classes

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ OBJECT_MODIFIER_UPDATE_SUBFRAME_RECURSION_DEFAULT

Enumeration Type Documentation

◆ eObjectSet

◆ eObjectVisibilityResult

◆ eObRelationTypes

Function Documentation

◆ BKE_object_active_modifier()

◆ BKE_object_add()

◆ BKE_object_add_for_data()

◆ BKE_object_add_from()

◆ BKE_object_add_only_object()

◆ BKE_object_apply_mat4()

◆ BKE_object_apply_mat4_ex()

◆ BKE_object_apply_parent_inverse()

◆ BKE_object_as_kdtree()

◆ BKE_object_batch_cache_dirty_tag()

◆ BKE_object_boundbox_eval_cached_get()

◆ BKE_object_boundbox_get()

◆ BKE_object_calc_parent()

◆ BKE_object_check_uids_unique_and_report()

◆ BKE_object_copy_modifier()

◆ BKE_object_copy_particlesystem()

◆ BKE_object_copy_particlesystems()

◆ BKE_object_copy_softbody()

◆ BKE_object_data_editmode_flush_ptr_get()

◆ BKE_object_data_is_in_editmode()

◆ BKE_object_data_select_update()

◆ BKE_object_delete_ptcache()

◆ BKE_object_dimensions_eval_cached_get()

◆ BKE_object_dimensions_get()

◆ BKE_object_dimensions_set()

◆ BKE_object_dimensions_set_ex()

◆ BKE_object_do_version_give_parteff_245()

◆ BKE_object_duplicate()

◆ BKE_object_empty_draw_type_set()

◆ BKE_object_empty_image_data_is_visible_in_view3d()

◆ BKE_object_empty_image_frame_is_visible_in_view3d()

◆ BKE_object_eval_assign_data()

◆ BKE_object_eval_constraints()

◆ BKE_object_eval_eval_base_flags()

◆ BKE_object_eval_light_linking()

◆ BKE_object_eval_local_transform()

◆ BKE_object_eval_parent()

◆ BKE_object_eval_ptcache_reset()

◆ BKE_object_eval_reset()

◆ BKE_object_eval_shading()

◆ BKE_object_eval_transform_all()

◆ BKE_object_eval_transform_final()

◆ BKE_object_eval_uber_data()

◆ BKE_object_eval_uber_transform()

◆ BKE_object_evaluated_geometry_bounds()

◆ BKE_object_exists_check()

◆ BKE_object_flag_test_recursive()

◆ BKE_object_foreach_display_point()

◆ BKE_object_free_caches()

◆ BKE_object_free_curve_cache()

◆ BKE_object_free_derived_caches()

◆ BKE_object_free_modifiers()

◆ BKE_object_free_particlesystems()

◆ BKE_object_free_shaderfx()

◆ BKE_object_free_softbody()

◆ BKE_object_get_editmesh_eval_cage()

◆ BKE_object_get_editmesh_eval_final()

◆ BKE_object_get_evaluated_lattice()

◆ BKE_object_get_evaluated_mesh()

◆ BKE_object_get_evaluated_mesh_no_subsurf()

◆ BKE_object_get_evaluated_mesh_no_subsurf_unchecked()

◆ BKE_object_get_evaluated_mesh_unchecked()

◆ BKE_object_get_last_subsurf_modifier()

◆ BKE_object_get_lattice()

◆ BKE_object_get_mesh_deform_eval()

◆ BKE_object_get_original_mesh()

◆ BKE_object_get_parent_matrix()