General operations, lookup, etc. for materials. More...

#include <optional>

Functions
Module
void	BKE_materials_init ()
void	BKE_materials_exit ()
Materials
void	BKE_object_materials_sync_length (Main bmain, Object ob, ID *id)
void	BKE_objects_materials_sync_length_all (Main bmain, ID id)
void	BKE_object_material_resize (Main bmain, Object ob, short totcol, bool do_id_user)
void	BKE_object_material_remap (Object ob, const unsigned int remap)
void	BKE_object_material_remap_calc (Object ob_dst, Object ob_src, short *remap_src_to_dst)
void	BKE_object_material_from_eval_data (Main bmain, Object ob_orig, const ID *data_eval)
Material *	BKE_material_add (Main bmain, const char name)
Material *	BKE_gpencil_material_add (Main bmain, const char name)
void	BKE_gpencil_material_attr_init (Material *ma)
void	BKE_material_make_node_previews_dirty (Material *ma)
RNA API
void	BKE_id_materials_copy (Main bmain, ID id_src, ID *id_dst)
void	BKE_id_material_resize (Main bmain, ID id, short totcol, bool do_id_user)
void	BKE_id_material_append (Main bmain, ID id, Material *ma)
Material *	BKE_id_material_pop (Main bmain, ID id, int index)
void	BKE_id_material_clear (Main bmain, ID id)
Evaluation API
Material *	BKE_object_material_get_eval (Object *ob, short act)
const Material *	BKE_object_material_get_eval (const Object &ob, const ID &data, short act)
int	BKE_object_material_count_eval (const Object *ob)
int	BKE_object_material_count_eval (const Object &ob, const ID &data)
std::optional< int >	BKE_id_material_index_max_eval (const ID &id)
int	BKE_id_material_used_eval (const ID &id)
int	BKE_id_material_used_with_fallback_eval (const ID &id)
int	BKE_object_material_used_with_fallback_eval (const Object &ob)
void	BKE_id_material_eval_assign (ID id, int slot, Material material)
void	BKE_id_material_eval_ensure_default_slot (ID *id)
Rendering
void	ramp_blend (int type, float r_col[3], float fac, const float col[3])
Default Materials
TODO: Explain expected usages? Seems to be primarily defined for GPU/viewport code? Warning NEVER use these materials as fallback data for regular ID data. They should only be used as template/copy source, or in some very specific, local and short-lived contexts.
Material *	BKE_material_default_empty ()
Material *	BKE_material_default_holdout ()
Material *	BKE_material_default_surface ()
Material *	BKE_material_default_volume ()
Material *	BKE_material_default_gpencil ()
void	BKE_material_defaults_free_gpu ()
Dependency graph evaluation
void	BKE_material_eval (Depsgraph depsgraph, Material material)

Material Slots
enum	{ BKE_MAT_ASSIGN_EXISTING , BKE_MAT_ASSIGN_USERPREF , BKE_MAT_ASSIGN_OBDATA , BKE_MAT_ASSIGN_OBJECT }
Material ***	BKE_object_material_array_p (Object *ob)
short *	BKE_object_material_len_p (Object *ob)
Material ***	BKE_id_material_array_p (ID *id)
short *	BKE_id_material_len_p (ID *id)
Material **	BKE_object_material_get_p (Object *ob, short act)
Material *	BKE_object_material_get (Object *ob, short act)
void	BKE_id_material_assign (Main bmain, ID id, Material *ma, short act)
void	BKE_object_material_assign (Main bmain, Object ob, Material *ma, short act, int assign_type)
void	BKE_object_material_assign_single_obdata (Main bmain, Object ob, Material *ma, short act)
void	BKE_object_material_array_assign (Main bmain, Object ob, Material ***matar, int totcol, bool to_object_only)
short	BKE_object_material_slot_find_index (Object ob, Material ma)
bool	BKE_object_material_slot_add (Main bmain, Object ob, bool set_active=true)
bool	BKE_object_material_slot_remove (Main bmain, Object ob)
bool	BKE_object_material_slot_used (Object *object, short actcol)
int	BKE_object_material_index_get (Object ob, const Material ma)
int	BKE_object_material_index_get_with_hint (Object ob, const Material ma, int hint_index)
int	BKE_object_material_ensure (Main bmain, Object ob, Material *material)
Material *	BKE_gpencil_material (Object *ob, short act)
MaterialGPencilStyle *	BKE_gpencil_material_settings (Object *ob, short act)
void	BKE_texpaint_slot_refresh_cache (Scene scene, Material ma, const Object *ob)
void	BKE_texpaint_slots_refresh_object (Scene scene, Object ob)
bNode *	BKE_texpaint_slot_material_find_node (Material *ma, short texpaint_slot)

Detailed Description

General operations, lookup, etc. for materials.

Definition in file BKE_material.hh.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Enumerator
BKE_MAT_ASSIGN_EXISTING
BKE_MAT_ASSIGN_USERPREF
BKE_MAT_ASSIGN_OBDATA
BKE_MAT_ASSIGN_OBJECT

Definition at line 77 of file BKE_material.hh.

Function Documentation

◆ BKE_gpencil_material()

Material * BKE_gpencil_material	(	Object *	ob,
		short	act )

Definition at line 931 of file blenkernel/intern/material.cc.

References BKE_material_default_gpencil(), and BKE_object_material_get().

Referenced by blender::ed::greasepencil::grease_pencil_material_reveal_exec(), and blender::ed::greasepencil::material_isolate_exec().

◆ BKE_gpencil_material_add()

Material * BKE_gpencil_material_add	(	Main *	bmain,
		const char *	name )

Definition at line 312 of file blenkernel/intern/material.cc.

References BKE_gpencil_material_attr_init(), and BKE_material_add().

Referenced by BKE_grease_pencil_object_material_new(), BLO_update_defaults_startup_blend(), and new_material_exec().

◆ BKE_gpencil_material_attr_init()

void BKE_gpencil_material_attr_init ( Material * ma )

Definition at line 263 of file blenkernel/intern/material.cc.

References ARRAY_SET_ITEMS, MaterialGPencilStyle::fill_rgba, MaterialGPencilStyle::flag, GP_MATERIAL_STROKE_SHOW, Material::gp_style, MEM_callocN(), MaterialGPencilStyle::mix_factor, MaterialGPencilStyle::mix_rgba, MaterialGPencilStyle::stroke_rgba, MaterialGPencilStyle::texture_offset, MaterialGPencilStyle::texture_pixsize, and MaterialGPencilStyle::texture_scale.

Referenced by BKE_gpencil_material_add(), BKE_gpencil_material_settings(), and material_default_gpencil_init().

◆ BKE_gpencil_material_settings()

MaterialGPencilStyle * BKE_gpencil_material_settings	(	Object *	ob,
		short	act )

Definition at line 943 of file blenkernel/intern/material.cc.

References BKE_gpencil_material_attr_init(), BKE_material_default_gpencil(), BKE_object_material_get(), and Material::gp_style.

Referenced by blender::draw::overlay::GreasePencil::draw_grease_pencil(), blender::draw::gpencil::gpencil_material_pool_create(), blender::draw::gpencil::gpencil_object_cache_add(), blender::ed::greasepencil::grease_pencil_texture_gradient_exec(), blender::ed::greasepencil::material_isolate_exec(), blender::ed::sculpt_paint::greasepencil::EraseOperationExecutor::skip_strokes_with_locked_material(), and blender::ed::sculpt_paint::greasepencil::EraseOperationExecutor::stroke_eraser().

◆ BKE_id_material_append()

void BKE_id_material_append	(	Main *	bmain,
		ID *	id,
		Material *	ma )

Definition at line 585 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_objects_materials_sync_length_all(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_SYNC_TO_EVAL, id_us_plus(), MEM_calloc_arrayN(), and MEM_freeN().

◆ BKE_id_material_array_p()

Material *** BKE_id_material_array_p ( ID * id )

◆ BKE_id_material_assign()

void BKE_id_material_assign	(	Main *	bmain,
		ID *	id,
		Material *	ma,
		short	act )

Definition at line 1063 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_objects_materials_sync_length_all(), DEG_id_tag_update(), DEG_relations_tag_update(), Material::id, ID_RECALC_GEOMETRY, ID_RECALC_SYNC_TO_EVAL, id_us_min(), id_us_plus(), MAXMAT, MEM_calloc_arrayN(), and MEM_freeN().

◆ BKE_id_material_clear()

void BKE_id_material_clear	(	Main *	bmain,
		ID *	id )

Definition at line 647 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_objects_materials_sync_length_all(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_SYNC_TO_EVAL, id_us_min(), material_data_index_clear_id(), and MEM_freeN().

Referenced by mesh_separate_material_assign_mat_nr().

◆ BKE_id_material_eval_assign()

void BKE_id_material_eval_assign	(	ID *	id,
		int	slot,
		Material *	material )

Definition at line 855 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BLI_assert, BLI_assert_unreachable, ELEM, i, and MEM_reallocN.

Referenced by blender::nodes::node_geo_set_material_cc::assign_material_to_id_geometry(), BKE_id_material_eval_ensure_default_slot(), blender::geometry::execute_realize_mesh_tasks(), and blender::nodes::node_geo_set_material_cc::node_geo_exec().

◆ BKE_id_material_eval_ensure_default_slot()

void BKE_id_material_eval_ensure_default_slot ( ID * id )

Add an empty material slot if the id has no material slots. This material slot allows the material to be overwritten by object-linked materials.

Definition at line 882 of file blenkernel/intern/material.cc.

References BKE_id_material_eval_assign(), and BKE_id_material_len_p().

◆ BKE_id_material_index_max_eval()

std::optional< int > BKE_id_material_index_max_eval ( const ID & id )

Returns the maximum material index used by the geometry. This returns zero if the geometry is empty or if all material indices are negative.

Definition at line 808 of file blenkernel/intern/material.cc.

References BLI_assert_unreachable, GS, ID_CU_LEGACY, ID_CV, ID_GD_LEGACY, ID_GP, ID_MB, ID_ME, ID_PT, and ID_VO.

Referenced by BKE_id_material_used_eval(), and BKE_id_material_used_with_fallback_eval().

◆ BKE_id_material_len_p()

short * BKE_id_material_len_p ( ID * id )

Definition at line 419 of file blenkernel/intern/material.cc.

References BLI_assert, GS, ID_CU_LEGACY, ID_CV, ID_GD_LEGACY, ID_GP, ID_MB, ID_ME, ID_PT, ID_VO, ID::name, and OB_DATA_SUPPORT_ID.

Referenced by blender::ed::object::add_grease_pencil_materials_for_conversion(), blender::ed::object::add_type_with_obdata(), blender::nodes::node_geo_set_material_cc::assign_material_to_id_geometry(), BKE_id_material_append(), BKE_id_material_assign(), BKE_id_material_clear(), BKE_id_material_eval_assign(), BKE_id_material_eval_ensure_default_slot(), BKE_id_material_pop(), BKE_id_material_resize(), BKE_id_materials_copy(), BKE_object_material_count_eval(), BKE_object_material_count_eval(), BKE_object_material_from_eval_data(), BKE_object_material_get_eval(), BKE_object_materials_sync_length(), BKE_objects_materials_sync_length_all(), blender::ed::object::copy_materials_to_new_geometry_object(), and mesh_separate_material_assign_mat_nr().

◆ BKE_id_material_pop()

Material * BKE_id_material_pop	(	Main *	bmain,
		ID *	id,
		int	index )

Definition at line 609 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_objects_materials_sync_length_all(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_SYNC_TO_EVAL, id_us_min(), material_data_index_remove_id(), MEM_freeN(), MEM_reallocN, and ret.

◆ BKE_id_material_resize()

void BKE_id_material_resize	(	Main *	bmain,
		ID *	id,
		short	totcol,
		bool	do_id_user )

Definition at line 550 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), DEG_id_tag_update(), DEG_relations_tag_update(), i, ID_RECALC_SYNC_TO_EVAL, id_us_min(), MEM_freeN(), and MEM_recallocN.

Referenced by BKE_object_materials_sync_length(), and mesh_separate_material_assign_mat_nr().

◆ BKE_id_material_used_eval()

int BKE_id_material_used_eval ( const ID & id )

Returns how many material slots the geometry may use (based on the maximum material index).

Definition at line 835 of file blenkernel/intern/material.cc.

References BKE_id_material_index_max_eval().

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

◆ BKE_id_material_used_with_fallback_eval()

int BKE_id_material_used_with_fallback_eval ( const ID & id )

Gets the number of material slots used by the geometry. The corresponding material for each slot can be retrieved with BKE_object_material_get_eval.

These two functions give the same result when the mesh is provided itself, or an object that uses the mesh.

NOTE: This may be higher or lower than the number of material slots on the object or object-data. However, it is always at least 1 (the fallback).

Definition at line 843 of file blenkernel/intern/material.cc.

References BKE_id_material_index_max_eval().

Referenced by BKE_object_material_used_with_fallback_eval(), blender::draw::mesh_batch_cache_init(), blender::draw::mesh_batch_cache_valid(), blender::draw::pointcloud_batch_cache_init(), and blender::draw::pointcloud_batch_cache_valid().

◆ BKE_id_materials_copy()

void BKE_id_materials_copy	(	Main *	bmain,
		ID *	id_src,
		ID *	id_dst )

Definition at line 529 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_SYNC_TO_EVAL, id_us_plus(), and MEM_dupallocN().

Referenced by BKE_mesh_to_pointcloud(), BKE_pointcloud_to_mesh(), and blender::bke::greasepencil::convert::legacy_gpencil_to_grease_pencil().

◆ BKE_material_add()

Material * BKE_material_add	(	Main *	bmain,
		const char *	name )

Definition at line 303 of file blenkernel/intern/material.cc.

References BKE_id_new().

Referenced by blender::io::usd::USDMaterialReader::add_material(), blender::io::alembic::utils::assign_materials(), BKE_gpencil_material_add(), get_or_create_current_material(), blender::io::obj::get_or_create_material(), Freestyle::BlenderStrokeRenderer::GetStrokeShader(), blender::bke::tests::IDSubDataTestData::IDSubDataTestData(), blender::io::fbx::import_material(), blender::bke::tests::MaterialTestData::MaterialTestData(), new_material_exec(), blender::animrig::tests::KeyframingTest::SetUp(), blender::nodes::tests::TEST_F(), blender::nodes::tests::TEST_F(), blender::nodes::tests::TEST_F(), blender::nodes::tests::TEST_F(), and DocumentImporter::writeMaterial().

◆ BKE_material_default_empty()

Material * BKE_material_default_empty ( )

Definition at line 2136 of file blenkernel/intern/material.cc.

References default_material_empty.

Referenced by blender::workbench::Instance::get_material().

◆ BKE_material_default_gpencil()

Material * BKE_material_default_gpencil ( )

Definition at line 2156 of file blenkernel/intern/material.cc.

References default_material_gpencil.

Referenced by BKE_gpencil_material(), BKE_gpencil_material_settings(), and BKE_grease_pencil_object_material_ensure_from_brush().

◆ BKE_material_default_holdout()

Material * BKE_material_default_holdout ( )

Definition at line 2141 of file blenkernel/intern/material.cc.

References default_material_holdout.

◆ BKE_material_default_surface()

Material * BKE_material_default_surface ( )

Definition at line 2146 of file blenkernel/intern/material.cc.

References default_material_surface.

Referenced by ED_node_shader_default(), and blender::eevee::MaterialModule::MaterialModule().

◆ BKE_material_default_volume()

Material * BKE_material_default_volume ( )

Definition at line 2151 of file blenkernel/intern/material.cc.

References default_material_volume.

Referenced by ED_node_shader_default(), and blender::eevee::MaterialModule::MaterialModule().

◆ BKE_material_defaults_free_gpu()

void BKE_material_defaults_free_gpu ( )

Definition at line 2161 of file blenkernel/intern/material.cc.

References default_materials, ListBase::first, GPU_material_free(), Material::gpumaterial, and i.

Referenced by GPU_exit(), and GPU_materials_free().

◆ BKE_material_eval()

void BKE_material_eval	(	Depsgraph *	depsgraph,
		Material *	material )

Definition at line 2019 of file blenkernel/intern/material.cc.

References DEG_debug_print_eval(), depsgraph, GPU_material_free(), Material::gpumaterial, Material::id, and ID::name.

◆ BKE_material_make_node_previews_dirty()

void BKE_material_make_node_previews_dirty ( Material * ma )

Definition at line 296 of file blenkernel/intern/material.cc.

References Material::nodetree, and nodetree_mark_previews_dirty_reccursive().

Referenced by ED_render_engine_changed().

◆ BKE_materials_exit()

void BKE_materials_exit ( )

Definition at line 2188 of file blenkernel/intern/material.cc.

References BKE_id_free(), default_materials, i, and Material::id.

Referenced by blender::bke::tests::LibQueryTest::TearDownTestSuite(), blender::bke::tests::LibRemapTest::TearDownTestSuite(), blender::nodes::tests::NodeTest::TearDownTestSuite(), and WM_exit_ex().

◆ BKE_materials_init()

void BKE_materials_init ( )

Definition at line 2173 of file blenkernel/intern/material.cc.

References BLI_assert_msg, default_material_empty, default_material_gpencil, default_material_holdout, default_material_surface, default_material_volume, default_materials, i, material_default_create(), material_default_gpencil_init(), material_default_holdout_init(), material_default_surface_init(), and material_default_volume_init().

Referenced by main(), blender::bke::tests::LibQueryTest::SetUpTestSuite(), blender::bke::tests::LibRemapTest::SetUpTestSuite(), and blender::nodes::tests::NodeTest::SetUpTestSuite().

◆ BKE_object_material_array_assign()

void BKE_object_material_array_assign	(	Main *	bmain,
		Object *	ob,
		Material ***	matar,
		int	totcol,
		bool	to_object_only )

Warning: this calls many more update calls per object then are needed, could be optimized.

Definition at line 1331 of file blenkernel/intern/material.cc.

References Object::actcol, BKE_MAT_ASSIGN_OBJECT, BKE_MAT_ASSIGN_USERPREF, BKE_object_material_assign(), BKE_object_material_slot_remove(), i, Object::matbits, and Object::totcol.

Referenced by ED_grease_pencil_join_objects_exec(), blender::ed::greasepencil::grease_pencil_separate_layer(), blender::ed::greasepencil::grease_pencil_separate_material(), blender::ed::greasepencil::grease_pencil_separate_selected(), material_slot_copy_exec(), mesh_separate_arrays(), and mesh_separate_tagged().

◆ BKE_object_material_array_p()

Material *** BKE_object_material_array_p ( Object * ob )

Definition at line 325 of file blenkernel/intern/material.cc.

References Object::data, ELEM, Curve::mat, Curves::mat, Mesh::mat, MetaBall::mat, PointCloud::mat, Volume::mat, GreasePencil::material_array, 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_duplicate(), BKE_object_material_get_p(), BKE_object_material_remap(), BKE_object_material_slot_find_index(), BKE_object_material_slot_remove(), blender::deg::DepsgraphNodeBuilder::build_object_data(), blender::deg::DepsgraphRelationBuilder::build_object_data(), blender::ed::greasepencil::grease_pencil_separate_layer(), blender::ed::greasepencil::grease_pencil_separate_material(), blender::ed::greasepencil::grease_pencil_separate_selected(), blender::ed::object::make_local_exec(), material_slot_copy_exec(), mesh_separate_arrays(), mesh_separate_tagged(), object_material_assign(), blender::ed::space_node::preview_prepare_scene(), preview_prepare_scene(), and similar_face_select_exec().

◆ BKE_object_material_assign()

void BKE_object_material_assign	(	Main *	bmain,
		Object *	ob,
		Material *	ma,
		short	act,
		int	assign_type )

Definition at line 1208 of file blenkernel/intern/material.cc.

References object_material_assign().

Referenced by MeshImporter::assign_material_to_geom(), blender::ed::greasepencil::bake_grease_pencil_animation_exec(), BKE_grease_pencil_object_material_new(), BKE_object_material_array_assign(), BKE_object_material_ensure(), BKE_object_material_slot_add(), blender::ed::object::drop_named_material_invoke(), get_or_create_current_material(), grease_pencil_object_material_ensure_from_brush_pinned(), blender::bke::tests::IDSubDataTestData::IDSubDataTestData(), blender::ed::object::make_links_data_exec(), blender::ed::outliner::material_drop_invoke(), blender::animrig::tests::KeyframingTest::SetUp(), blender::ed::object::single_mat_users(), and ui_drop_material_exec().

◆ BKE_object_material_assign_single_obdata()

void BKE_object_material_assign_single_obdata	(	Main *	bmain,
		Object *	ob,
		Material *	ma,
		short	act )

Similar to BKE_object_material_assign with BKE_MAT_ASSIGN_OBDATA type, but does not scan whole Main for other usages of the same obdata. Only use in cases where you know that the object's obdata is only used by this one object.

Definition at line 1213 of file blenkernel/intern/material.cc.

References BKE_MAT_ASSIGN_OBDATA, and object_material_assign().

Referenced by blender::io::alembic::utils::assign_materials(), and blender::io::usd::utils::assign_materials().

◆ BKE_object_material_count_eval() [1/2]

int BKE_object_material_count_eval	(	const Object &	ob,
		const ID &	data )

Same as above but allows using a custom ID as data instead of Object.data.

Definition at line 797 of file blenkernel/intern/material.cc.

References BKE_id_material_len_p(), BLI_assert, data, Object::data, DEG_is_evaluated(), OB_EMPTY, Object::totcol, and Object::type.

◆ BKE_object_material_count_eval() [2/2]

int BKE_object_material_count_eval ( const Object * ob )

Gets the number of material slots on the evaluated object. This is the maximum of the number of material slots on the object and geometry.

Definition at line 785 of file blenkernel/intern/material.cc.

References BKE_id_material_len_p(), BLI_assert, Object::data, DEG_is_evaluated(), get_evaluated_object_data_with_materials(), OB_EMPTY, Object::totcol, and Object::type.

Referenced by BKE_object_material_get_eval(), blender::draw::sculpt_batches_get_ex(), blender::io::hydra::CurvesData::write_materials(), and blender::io::hydra::VolumeData::write_materials().

◆ BKE_object_material_ensure()

int BKE_object_material_ensure	(	Main *	bmain,
		Object *	ob,
		Material *	material )

Definition at line 917 of file blenkernel/intern/material.cc.

References BKE_MAT_ASSIGN_USERPREF, BKE_object_material_assign(), BKE_object_material_index_get(), BKE_object_material_slot_add(), and Object::totcol.

Referenced by blender::ed::greasepencil::clipboard_materials_remap(), and blender::ed::greasepencil::grease_pencil_material_copy_to_object_exec().

◆ BKE_object_material_from_eval_data()

void BKE_object_material_from_eval_data	(	Main *	bmain,
		Object *	ob_orig,
		const ID *	data_eval )

Copy materials from evaluated geometry to the original geometry of an object.

Definition at line 1296 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_object_materials_sync_length(), Object::data, DEG_get_original(), ELEM, i, Material::id, id_us_min(), id_us_plus(), MEM_calloc_arrayN(), and MEM_SAFE_FREE.

◆ BKE_object_material_get()

Material * BKE_object_material_get	(	Object *	ob,
		short	act )

Definition at line 711 of file blenkernel/intern/material.cc.

References BKE_object_material_get_p(), Material::gp_style, OB_GREASE_PENCIL, and Object::type.

◆ BKE_object_material_get_eval() [1/2]

const Material * BKE_object_material_get_eval	(	const Object &	ob,
		const ID &	data,
		short	act )

Same as above, but uses the given geometry data instead of ob.data. This is useful for instances. The alternative is to use BKE_object_replace_data_on_shallow_copy which is more hacky.

Definition at line 745 of file blenkernel/intern/material.cc.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_object_material_count_eval(), BLI_assert, clamp_i(), data, DEG_is_evaluated(), Object::mat, Object::matbits, and Object::totcol.

◆ BKE_object_material_get_eval() [2/2]

Material * BKE_object_material_get_eval	(	Object *	ob,
		short	act )

On evaluated objects the number of materials on an object and its data might go out of sync. This is because during evaluation materials can be added/removed on the object data.

For rendering or exporting we generally use the materials on the object data. However, some material indices might be overwritten by the object.

Definition at line 739 of file blenkernel/intern/material.cc.

References BKE_object_material_get_eval(), data, and get_evaluated_object_data_with_materials().

Referenced by BKE_object_material_get_eval(), blender::ed::object::copy_materials_to_new_geometry_object(), ED_object_get_active_image(), blender::workbench::Instance::get_material(), lineart_identify_corner_tri_feature_edges(), blender::draw::overlay::Particles::object_sync(), blender::io::obj::OBJMesh::OBJMesh(), blender::io::hydra::CurvesData::write_materials(), blender::io::hydra::MeshData::write_materials(), and blender::io::hydra::VolumeData::write_materials().