material.c File Reference

#include <math.h>
#include <stddef.h>
#include <string.h>
#include "CLG_log.h"
#include "MEM_guardedalloc.h"
#include "DNA_ID.h"
#include "DNA_anim_types.h"
#include "DNA_collection_types.h"
#include "DNA_curve_types.h"
#include "DNA_customdata_types.h"
#include "DNA_defaults.h"
#include "DNA_gpencil_types.h"
#include "DNA_hair_types.h"
#include "DNA_material_types.h"
#include "DNA_mesh_types.h"
#include "DNA_meshdata_types.h"
#include "DNA_meta_types.h"
#include "DNA_node_types.h"
#include "DNA_object_types.h"
#include "DNA_pointcloud_types.h"
#include "DNA_scene_types.h"
#include "DNA_volume_types.h"
#include "BLI_array_utils.h"
#include "BLI_listbase.h"
#include "BLI_math.h"
#include "BLI_utildefines.h"
#include "BLT_translation.h"
#include "BKE_anim_data.h"
#include "BKE_brush.h"
#include "BKE_curve.h"
#include "BKE_displist.h"
#include "BKE_editmesh.h"
#include "BKE_font.h"
#include "BKE_gpencil.h"
#include "BKE_icons.h"
#include "BKE_idtype.h"
#include "BKE_image.h"
#include "BKE_lib_id.h"
#include "BKE_lib_query.h"
#include "BKE_main.h"
#include "BKE_material.h"
#include "BKE_mesh.h"
#include "BKE_node.h"
#include "BKE_scene.h"
#include "DEG_depsgraph.h"
#include "DEG_depsgraph_build.h"
#include "GPU_material.h"
#include "NOD_shader.h"
#include "BLO_read_write.h"

Go to the source code of this file.

Classes
struct	FillTexPaintSlotsData
struct	FindTexPaintNodeData

Macros
#define	DNA_DEPRECATED_ALLOW

Typedefs
typedef bool(*	ForEachTexNodeCallback) (bNode *node, void *userdata)

Functions
static void	material_init_data (ID *id)
static void	material_copy_data (Main *bmain, ID *id_dst, const ID *id_src, const int flag)
static void	material_free_data (ID *id)
static void	material_foreach_id (ID *id, LibraryForeachIDData *data)
static void	material_blend_write (BlendWriter *writer, ID *id, const void *id_address)
static void	material_blend_read_data (BlendDataReader *reader, ID *id)
static void	material_blend_read_lib (BlendLibReader *reader, ID *id)
static void	material_blend_read_expand (BlendExpander *expander, ID *id)
void	BKE_gpencil_material_attr_init (Material *ma)
Material *	BKE_material_add (Main *bmain, const char *name)
Material *	BKE_gpencil_material_add (Main *bmain, const char *name)
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)
static void	material_data_index_remove_id (ID *id, short index)
bool	BKE_object_material_slot_used (ID *id, short actcol)
static void	material_data_index_clear_id (ID *id)
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_i)
void	BKE_id_material_clear (Main *bmain, ID *id)
Material **	BKE_object_material_get_p (Object *ob, short act)
Material *	BKE_object_material_get (Object *ob, short act)
Material *	BKE_gpencil_material (Object *ob, short act)
MaterialGPencilStyle *	BKE_gpencil_material_settings (Object *ob, short act)
void	BKE_object_material_resize (Main *bmain, Object *ob, const short totcol, bool do_id_user)
void	BKE_object_materials_test (Main *bmain, Object *ob, ID *id)
void	BKE_objects_materials_test_all (Main *bmain, ID *id)
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_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_array_assign (Main *bmain, struct Object *ob, struct Material ***matar, int totcol, const 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	BKE_object_material_slot_remove (Main *bmain, Object *ob)
static bNode *	nodetree_uv_node_recursive (bNode *node)
static bool	ntree_foreach_texnode_recursive (bNodeTree *nodetree, ForEachTexNodeCallback callback, void *userdata)
static bool	count_texture_nodes_cb (bNode *UNUSED(node), void *userdata)
static int	count_texture_nodes_recursive (bNodeTree *nodetree)
static bool	fill_texpaint_slots_cb (bNode *node, void *userdata)
static void	fill_texpaint_slots_recursive (bNodeTree *nodetree, bNode *active_node, Material *ma, int slot_len)
void	BKE_texpaint_slot_refresh_cache (Scene *scene, Material *ma)
void	BKE_texpaint_slots_refresh_object (Scene *scene, struct Object *ob)
static bool	texpaint_slot_node_find_cb (bNode *node, void *userdata)
bNode *	BKE_texpaint_slot_material_find_node (Material *ma, short texpaint_slot)
void	ramp_blend (int type, float r_col[3], const float fac, const float col[3])
void	BKE_material_copybuf_clear (void)
void	BKE_material_copybuf_free (void)
void	BKE_material_copybuf_copy (Main *bmain, Material *ma)
void	BKE_material_copybuf_paste (Main *bmain, Material *ma)
void	BKE_material_eval (struct Depsgraph *depsgraph, Material *material)
static void	material_default_gpencil_init (Material *ma)
static void	material_default_surface_init (Material *ma)
static void	material_default_volume_init (Material *ma)
static void	material_default_holdout_init (Material *ma)
Material *	BKE_material_default_empty (void)
Material *	BKE_material_default_holdout (void)
Material *	BKE_material_default_surface (void)
Material *	BKE_material_default_volume (void)
Material *	BKE_material_default_gpencil (void)
void	BKE_material_defaults_free_gpu (void)
void	BKE_materials_init (void)
void	BKE_materials_exit (void)

Variables
static CLG_LogRef	LOG = {"bke.material"}
IDTypeInfo	IDType_ID_MA
static Material	matcopybuf
	copy/paste buffer, if we had a proper py api that would be better More...
static short	matcopied = 0
static Material	default_material_empty
static Material	default_material_holdout
static Material	default_material_surface
static Material	default_material_volume
static Material	default_material_gpencil
static Material *	default_materials []

Macro Definition Documentation

DNA_DEPRECATED_ALLOW

#define DNA_DEPRECATED_ALLOW

Definition at line 33 of file material.c.

Typedef Documentation

ForEachTexNodeCallback

typedef bool(* ForEachTexNodeCallback) (bNode *node, void *userdata)

Definition at line 1223 of file material.c.

Function Documentation

BKE_gpencil_material()

Material* BKE_gpencil_material	(	Object *	ob,
		short	act
	)

Definition at line 703 of file material.c.

References BKE_material_default_gpencil(), BKE_object_material_get(), and NULL.

Referenced by BKE_gpencil_merge_materials_table_get(), ED_gpencil_join_objects_exec(), ED_gpencil_update_color_uv(), gpencil_lock_layer_exec(), gpencil_material_hide_exec(), gpencil_material_isolate_exec(), gpencil_material_lock_all_exec(), gpencil_material_reveal_exec(), gpencil_material_unlock_all_exec(), gpencil_stroke_change_color_exec(), gpencil_stroke_separate_exec(), gpencil_strokes_merge_poll(), is_stroke_affected_by_modifier(), and object_gpencil_add_exec().

BKE_gpencil_material_add()

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

Definition at line 310 of file material.c.

References BKE_gpencil_material_attr_init(), BKE_material_add(), and NULL.

Referenced by BKE_gpencil_brush_preset_set(), BKE_gpencil_object_material_new(), BLO_update_defaults_startup_blend(), gpencil_material_to_vertex_exec(), and new_material_exec().

BKE_gpencil_material_attr_init()

void BKE_gpencil_material_attr_init

(

Material *

ma

)

Definition at line 282 of file material.c.

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

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

BKE_gpencil_material_settings()

MaterialGPencilStyle* BKE_gpencil_material_settings	(	Object *	ob,
		short	act
	)

Definition at line 713 of file material.c.

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

Referenced by BKE_gpencil_merge_materials(), deformStroke(), ED_gpencil_stroke_material_editable(), ED_gpencil_stroke_material_visible(), gpencil_create_extensions(), gpencil_draw_datablock(), gpencil_extract_palette_from_vertex(), gpencil_generic_curve_select(), gpencil_generic_stroke_select(), gpencil_material_hide_exec(), gpencil_material_isolate_exec(), gpencil_material_pool_create(), gpencil_material_select_exec(), gpencil_material_to_vertex_exec(), gpencil_object_cache_add(), gpencil_sculpt_brush_do_frame(), gpencil_stroke_cache_populate(), gpencil_stroke_caps_set_exec(), gpencil_stroke_cyclical_set_exec(), gpencil_vertexpaint_select_stroke(), gpencil_zoom_level_set(), and blender::io::gpencil::GpencilIO::prepare_stroke_export_colors().

BKE_id_material_append()

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

Definition at line 560 of file material.c.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_objects_materials_test_all(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_COPY_ON_WRITE, id_us_plus(), MEM_callocN, and MEM_freeN.

BKE_id_material_array_p()

Material*** BKE_id_material_array_p

(

ID *

id

)

Definition at line 390 of file material.c.

References BLI_assert, GS, id, ID_CU, ID_GD, ID_HA, ID_MB, ID_ME, ID_PT, ID_VO, ID::name, NULL, and OB_DATA_SUPPORT_ID.

Referenced by BKE_id_material_append(), BKE_id_material_assign(), BKE_id_material_clear(), BKE_id_material_pop(), BKE_id_material_resize(), BKE_id_materials_copy(), and mesh_separate_material_assign_mat_nr().

BKE_id_material_assign()

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

Definition at line 803 of file material.c.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_objects_materials_test_all(), Material::id, id_us_min(), id_us_plus(), MAXMAT, MEM_callocN, MEM_freeN, and NULL.

BKE_id_material_clear()

void BKE_id_material_clear	(	Main *	bmain,
		ID *	id
	)

Definition at line 622 of file material.c.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_objects_materials_test_all(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_COPY_ON_WRITE, id_us_min(), material_data_index_clear_id(), MEM_freeN, and NULL.

Referenced by mesh_separate_material_assign_mat_nr().

BKE_id_material_len_p()

short* BKE_id_material_len_p

(

ID *

id

)

Definition at line 416 of file material.c.

References BLI_assert, GS, id, ID_CU, ID_GD, ID_HA, ID_MB, ID_ME, ID_PT, ID_VO, ID::name, NULL, and OB_DATA_SUPPORT_ID.

Referenced by BKE_id_material_append(), BKE_id_material_assign(), BKE_id_material_clear(), BKE_id_material_pop(), BKE_id_material_resize(), BKE_id_materials_copy(), BKE_object_materials_test(), BKE_objects_materials_test_all(), ED_object_add_type_with_obdata(), and mesh_separate_material_assign_mat_nr().

BKE_id_material_pop()

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

Definition at line 584 of file material.c.

References BKE_id_material_array_p(), BKE_id_material_len_p(), BKE_objects_materials_test_all(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_COPY_ON_WRITE, id_us_min(), material_data_index_remove_id(), MEM_freeN, MEM_reallocN, NULL, and ret.

BKE_id_material_resize()

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

Definition at line 529 of file material.c.

References BKE_id_material_array_p(), BKE_id_material_len_p(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_COPY_ON_WRITE, id_us_min(), MEM_freeN, MEM_recallocN, and NULL.

Referenced by mesh_separate_material_assign_mat_nr().

BKE_id_materials_copy()

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

Definition at line 508 of file material.c.

References Freestyle::a, BKE_id_material_array_p(), BKE_id_material_len_p(), DEG_id_tag_update(), DEG_relations_tag_update(), ID_RECALC_COPY_ON_WRITE, id_us_plus(), and MEM_dupallocN.

Referenced by BKE_mesh_to_pointcloud(), and BKE_pointcloud_to_mesh().

BKE_material_add()

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

Definition at line 301 of file material.c.

References BKE_id_new(), and ID_MA.

Referenced by blender::io::alembic::utils::assign_materials(), BKE_gpencil_material_add(), get_or_create_current_material(), Freestyle::BlenderStrokeRenderer::GetStrokeShader(), new_material_exec(), and DocumentImporter::writeMaterial().

BKE_material_copybuf_clear()

void BKE_material_copybuf_clear

(

void

)

Definition at line 1655 of file material.c.

References matcopied, and matcopybuf.

Referenced by WM_init().

BKE_material_copybuf_copy()

void BKE_material_copybuf_copy	(	Main *	bmain,
		Material *	ma
	)

Definition at line 1673 of file material.c.

References BKE_material_copybuf_free(), BLI_listbase_clear(), Material::gpumaterial, matcopied, matcopybuf, Material::nodetree, ntreeCopyTree_ex(), NULL, and Material::preview.

Referenced by copy_material_exec().

BKE_material_copybuf_free()

void BKE_material_copybuf_free

(

void

)

Definition at line 1661 of file material.c.

References BLI_assert, bNodeTree::id, matcopied, matcopybuf, MEM_freeN, Material::nodetree, ntreeFreeLocalTree, NULL, and ID::py_instance.

Referenced by BKE_material_copybuf_copy().

BKE_material_copybuf_paste()

void BKE_material_copybuf_paste	(	Main *	bmain,
		Material *	ma
	)

Definition at line 1691 of file material.c.

References GPU_material_free(), Material::gpumaterial, id, Material::id, matcopied, matcopybuf, MEM_freeN, Material::nodetree, ntreeCopyTree_ex(), ntreeFreeEmbeddedTree(), and NULL.

Referenced by paste_material_exec().

BKE_material_default_empty()

Material* BKE_material_default_empty

(

void

)

Definition at line 1819 of file material.c.

References default_material_empty.

Referenced by workbench_object_material_get().

BKE_material_default_gpencil()

Material* BKE_material_default_gpencil

(

void

)

Definition at line 1839 of file material.c.

References default_material_gpencil.

Referenced by BKE_gpencil_material(), BKE_gpencil_material_settings(), BKE_gpencil_object_material_ensure_from_active_input_material(), and gpencil_draw_strokes().

BKE_material_default_holdout()

Material* BKE_material_default_holdout

(

void

)

Definition at line 1824 of file material.c.

References default_material_holdout.

Referenced by eevee_object_material_get().

BKE_material_default_surface()

Material* BKE_material_default_surface

(

void

)

Definition at line 1829 of file material.c.

References default_material_surface.

Referenced by ED_node_shader_default(), EEVEE_material_default_get(), and eevee_object_material_get().

BKE_material_default_volume()

Material* BKE_material_default_volume

(

void

)

Definition at line 1834 of file material.c.

References default_material_volume.

Referenced by ED_node_shader_default(), EEVEE_material_default_get(), eevee_object_material_get(), and EEVEE_volumes_cache_object_add().

BKE_material_defaults_free_gpu()

void BKE_material_defaults_free_gpu

(

void

)

Definition at line 1844 of file material.c.

BKE_material_eval()

void BKE_material_eval	(	struct Depsgraph *	depsgraph,
		Material *	material
	)

Definition at line 1716 of file material.c.

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

BKE_materials_exit()

void BKE_materials_exit

(

void

)

Definition at line 1868 of file material.c.

References default_materials, and material_free_data().

Referenced by WM_exit_ex().

BKE_materials_init()

void BKE_materials_init

(

void

)

Definition at line 1856 of file material.c.

References default_material_gpencil, default_material_holdout, default_material_surface, default_material_volume, default_materials, material_default_gpencil_init(), material_default_holdout_init(), material_default_surface_init(), material_default_volume_init(), and material_init_data().

Referenced by main().

BKE_object_material_array_assign()

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

Definition at line 1032 of file material.c.

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

Referenced by 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 323 of file material.c.

References Object::data, ELEM, Curve::mat, bGPdata::mat, Hair::mat, Mesh::mat, MetaBall::mat, PointCloud::mat, Volume::mat, NULL, OB_CURVE, OB_FONT, OB_GPENCIL, OB_HAIR, OB_MBALL, OB_MESH, OB_POINTCLOUD, OB_SURF, OB_VOLUME, and Object::type.

Referenced by BKE_object_duplicate(), BKE_object_material_assign(), BKE_object_material_get_p(), BKE_object_material_remap(), BKE_object_material_slot_find_index(), BKE_object_material_slot_remove(), blender::deg::DepsgraphRelationBuilder::build_object_data(), blender::deg::DepsgraphNodeBuilder::build_object_data(), make_local_exec(), material_slot_copy_exec(), mesh_separate_arrays(), mesh_separate_tagged(), 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 850 of file material.c.

References Object::actcol, BKE_MAT_ASSIGN_EXISTING, BKE_MAT_ASSIGN_OBDATA, BKE_MAT_ASSIGN_OBJECT, BKE_MAT_ASSIGN_USERPREF, BKE_object_material_array_p(), BKE_object_material_len_p(), BKE_object_materials_test(), BKE_objects_materials_test_all(), BLI_assert, Object::data, Material::id, ID_IS_LINKED, id_us_min(), id_us_plus(), Object::mat, Object::matbits, MAXMAT, MEM_callocN, MEM_freeN, MEM_recallocN_id, NULL, Object::totcol, and USER_MAT_ON_OB.

Referenced by MeshImporter::assign_material_to_geom(), blender::io::alembic::utils::assign_materials(), BKE_gpencil_object_material_ensure(), BKE_gpencil_object_material_ensure_from_brush(), BKE_gpencil_object_material_new(), BKE_object_material_array_assign(), BKE_object_material_slot_add(), drop_named_material_invoke(), get_or_create_current_material(), gpencil_material_to_vertex_exec(), make_links_data_exec(), material_drop_invoke(), and single_mat_users().

BKE_object_material_get()

Material* BKE_object_material_get	(	Object *	ob,
		short	act
	)

Definition at line 697 of file material.c.

References BKE_object_material_get_p(), and NULL.

Referenced by InstanceWriter::add_material_bindings(), animdata_filter_ds_materials(), bake_object_check(), bc_has_animations(), BKE_gpencil_convert_mesh(), BKE_gpencil_material(), BKE_gpencil_material_find_index_by_name_prefix(), BKE_gpencil_material_settings(), BKE_gpencil_object_material_ensure_by_name(), BKE_gpencil_object_material_ensure_from_active_input_material(), BKE_gpencil_object_material_ensure_from_brush(), BKE_gpencil_object_material_from_brush_get(), BKE_gpencil_object_material_index_get(), BKE_gpencil_object_material_index_get_by_name(), BKE_object_material_remap_calc(), BKE_texpaint_slots_refresh_object(), buttons_context_path_material(), GeometryExporter::create_mesh_primitive_list(), ED_gpencil_material_enum_itemf(), ED_mesh_join_objects_exec(), ED_object_assign_active_image(), ED_object_get_active_image(), ED_object_texture_paint_mode_enter_ex(), ED_paint_proj_mesh_data_check(), EEVEE_cryptomatte_cache_populate(), eevee_object_material_get(), EEVEE_volumes_cache_object_add(), AnimationExporter::export_curve_animation(), eyedropper_add_material(), BCAnimationCurve::get_animation_name(), get_default_texture_layer_name_for_object(), get_or_create_current_material(), gpencil_check_same_material_color(), gpencil_fill_invoke(), gpencil_layer_duplicate_object_exec(), gpencil_material_find_index_by_name(), gpencil_material_lock_unsused_exec(), gpencil_modifier_masking_panel_draw(), gpencil_strokes_copy_exec(), imapaint_face_image(), imapaint_pick_uv(), Freestyle::BlenderFileLoader::insertShapeNode(), join_mesh_single(), lineart_geometry_object_load(), make_links_data_exec(), material_slot_assign_exec(), material_slot_de_select(), mesh_new_from_mball_object(), object_frame_has_keyframe(), object_select_all_by_material(), object_select_linked_exec(), ForEachMaterialFunctor< Functor >::operator()(), overlay_gpencil_draw_stroke_color_name(), OVERLAY_particle_cache_populate(), proj_paint_add_slot(), proj_paint_state_mesh_eval_init(), psys_get_particle_on_path(), psys_thread_context_init(), shader_get_from_context(), single_mat_users(), AnimationImporter::translate_Animations(), workbench_object_material_get(), and workbench_volume_material_color().

BKE_object_material_get_p()

Material** BKE_object_material_get_p	(	Object *	ob,
		short	act
	)

Definition at line 645 of file material.c.

References BKE_object_material_array_p(), BKE_object_material_len_p(), CLOG_ERROR, LOG, Object::mat, Object::matbits, NULL, and Object::totcol.

Referenced by BKE_object_material_get(), and new_material_exec().

BKE_object_material_len_p()

short* BKE_object_material_len_p

(

Object *

ob

)

Definition at line 356 of file material.c.

References Object::data, ELEM, NULL, OB_CURVE, OB_FONT, OB_GPENCIL, OB_HAIR, OB_MBALL, OB_MESH, OB_POINTCLOUD, OB_SURF, OB_VOLUME, Curve::totcol, bGPdata::totcol, Hair::totcol, Mesh::totcol, MetaBall::totcol, PointCloud::totcol, Volume::totcol, and Object::type.

Referenced by BKE_gpencil_merge_materials(), BKE_gpencil_merge_materials_table_get(), BKE_gpencil_object_material_index_get(), BKE_gpencil_object_material_index_get_by_name(), BKE_object_material_assign(), BKE_object_material_get_p(), BKE_object_material_remap(), BKE_object_material_slot_find_index(), BKE_object_material_slot_remove(), blender::deg::DepsgraphRelationBuilder::build_object_data(), blender::deg::DepsgraphNodeBuilder::build_object_data(), ED_gpencil_join_objects_exec(), eyedropper_add_material(), gpencil_active_material_poll(), gpencil_lock_layer_exec(), gpencil_material_hide_exec(), gpencil_material_isolate_exec(), gpencil_material_lock_all_exec(), gpencil_material_lock_unsused_exec(), gpencil_material_reveal_exec(), gpencil_material_to_vertex_exec(), gpencil_material_unlock_all_exec(), gpencil_stroke_merge_material_exec(), material_slot_copy_exec(), mesh_separate_arrays(), mesh_separate_tagged(), and object_blend_read_lib().

BKE_object_material_remap()

void BKE_object_material_remap	(	Object *	ob,
		const unsigned int *	remap
	)

Definition at line 947 of file material.c.

References BKE_curve_material_remap(), BKE_gpencil_material_remap(), BKE_mesh_material_remap(), BKE_object_material_array_p(), BKE_object_material_len_p(), BLI_array_permute, BLI_assert, Object::data, ELEM, Object::mat, Object::matbits, NULL, OB_CURVE, OB_FONT, OB_GPENCIL, OB_MESH, OB_SURF, Object::totcol, and Object::type.

Referenced by material_slot_move_exec().

BKE_object_material_remap_calc()

void BKE_object_material_remap_calc	(	Object *	ob_dst,
		Object *	ob_src,
		short *	remap_src_to_dst
	)

Calculate a material remapping from ob_src to ob_dst.

Parameters

remap_src_to_dst

An array the size of ob_src->totcol where index values are filled in which map to ob_dst materials.

Definition at line 983 of file material.c.

References BKE_object_material_get(), BLI_ghash_free(), BLI_ghash_lookup_p(), BLI_ghash_ptr_new_ex(), BLI_ghash_reinsert(), NULL, POINTER_AS_INT, POINTER_FROM_INT, and Object::totcol.

Referenced by BMD_mesh_intersection().

BKE_object_material_resize()

void BKE_object_material_resize	(	Main *	bmain,
		Object *	ob,
		const short	totcol,
		bool	do_id_user
	)

Definition at line 727 of file material.c.

References Object::actcol, DEG_id_tag_update(), DEG_relations_tag_update(), Object::id, ID_RECALC_COPY_ON_WRITE, ID_RECALC_GEOMETRY, id_us_min(), Object::mat, Object::matbits, MEM_callocN, MEM_freeN, NULL, and Object::totcol.

Referenced by BKE_object_materials_test(), BKE_objects_materials_test_all(), mesh_separate_material_assign_mat_nr(), and object_blend_read_lib().

BKE_object_material_slot_add()

bool BKE_object_material_slot_add	(	Main *	bmain,
		Object *	ob
	)

Definition at line 1091 of file material.c.

References Object::actcol, BKE_MAT_ASSIGN_USERPREF, BKE_object_material_assign(), MAXMAT, NULL, and Object::totcol.

Referenced by blender::io::alembic::utils::assign_materials(), BKE_gpencil_object_material_ensure(), BKE_gpencil_object_material_ensure_from_brush(), BKE_gpencil_object_material_new(), gpencil_material_to_vertex_exec(), material_slot_add_exec(), and new_material_exec().

BKE_object_material_slot_find_index()

short BKE_object_material_slot_find_index	(	Object *	ob,
		Material *	ma
	)

Definition at line 1064 of file material.c.

References Freestyle::a, BKE_object_material_array_p(), BKE_object_material_len_p(), and NULL.

Referenced by gpencil_init_colors().

BKE_object_material_slot_remove()

bool BKE_object_material_slot_remove	(	Main *	bmain,
		Object *	ob
	)

Definition at line 1107 of file material.c.

References Freestyle::a, Object::actcol, BKE_displist_free(), BKE_gpencil_material_index_reassign(), BKE_object_material_array_p(), BKE_object_material_len_p(), BLI_assert, CLOG_ERROR, Object_Runtime::curve_cache, Object::data, CurveCache::disp, ELEM, ListBase::first, Material::id, id_us_min(), LOG, material_data_index_remove_id(), MEM_freeN, NULL, OB_CURVE, OB_FONT, OB_GPENCIL, OB_MESH, OB_SURF, Main::objects, Object::runtime, Object::totcol, and Object::type.

Referenced by BKE_gpencil_convert_curve(), BKE_object_material_array_assign(), gpencil_stroke_separate_exec(), material_slot_remove_exec(), material_slot_remove_unused_exec(), and object_convert_exec().

BKE_object_material_slot_used()

bool BKE_object_material_slot_used	(	ID *	id,
		short	actcol
	)

Definition at line 465 of file material.c.

References BKE_curve_material_index_used(), BKE_gpencil_material_index_used(), BKE_mesh_material_index_used(), BLI_assert, GS, id, ID_CU, ID_GD, ID_MB, ID_ME, ID::name, and OB_DATA_SUPPORT_ID.

Referenced by BKE_gpencil_convert_curve(), gpencil_stroke_separate_exec(), material_slot_remove_unused_exec(), and object_convert_exec().

BKE_object_materials_test()

void BKE_object_materials_test	(	Main *	bmain,
		Object *	ob,
		ID *	id
	)

Definition at line 772 of file material.c.

References BKE_id_material_len_p(), BKE_object_material_resize(), and NULL.

Referenced by add_loose_object_data_to_scene(), BKE_mesh_assign_object(), BKE_object_material_assign(), ED_object_add_type_with_obdata(), Freestyle::BlenderStrokeRenderer::GenerateStrokeMesh(), libblock_remap_data_postprocess_obdata_relink(), make_links_data_exec(), object_convert_exec(), and placeholders_ensure_valid().

BKE_objects_materials_test_all()

void BKE_objects_materials_test_all	(	Main *	bmain,
		ID *	id
	)

Definition at line 784 of file material.c.

References BKE_id_material_len_p(), BKE_main_lock(), BKE_main_unlock(), BKE_object_material_resize(), Object::data, ListBase::first, Object::id, ID::next, NULL, and Main::objects.

Referenced by BKE_id_material_append(), BKE_id_material_assign(), BKE_id_material_clear(), BKE_id_material_pop(), BKE_object_material_assign(), and ED_mesh_join_objects_exec().

BKE_texpaint_slot_material_find_node()

bNode* BKE_texpaint_slot_material_find_node	(	Material *	ma,
		short	texpaint_slot
	)

Definition at line 1386 of file material.c.

References TexPaintSlot::ima, Material::nodetree, ntree_foreach_texnode_recursive(), NULL, FindTexPaintNodeData::r_node, texpaint_slot_node_find_cb(), and Material::texpaintslot.

BKE_texpaint_slot_refresh_cache()

void BKE_texpaint_slot_refresh_cache	(	Scene *	scene,
		Material *	ma
	)

Definition at line 1307 of file material.c.

References FillTexPaintSlotsData::active_node, count, count_texture_nodes_recursive(), DEG_id_tag_update(), fill_texpaint_slots_recursive(), Material::id, ID_RECALC_COPY_ON_WRITE, ID_RECALC_SHADING, IMAGEPAINT_MODE_IMAGE, ToolSettings::imapaint, FillTexPaintSlotsData::ma, MEM_callocN, MEM_freeN, ImagePaintSettings::mode, nodeGetActiveTexture(), Material::nodetree, NULL, Material::paint_active_slot, Material::paint_clone_slot, scene, Material::texpaintslot, Scene::toolsettings, and Material::tot_slots.

Referenced by BKE_texpaint_slots_refresh_object(), ED_paint_proj_mesh_data_check(), and proj_paint_add_slot().

BKE_texpaint_slots_refresh_object()

void BKE_texpaint_slots_refresh_object	(	Scene *	scene,
		struct Object *	ob
	)

Definition at line 1361 of file material.c.

References BKE_object_material_get(), BKE_texpaint_slot_refresh_cache(), FillTexPaintSlotsData::ma, scene, and Object::totcol.

Referenced by ED_editors_init_for_undo(), ED_object_texture_paint_mode_enter_ex(), and scene_changed().

count_texture_nodes_cb()

static bool count_texture_nodes_cb ( bNode *  UNUSEDnode, void *  userdata  )

static

Definition at line 1245 of file material.c.

Referenced by count_texture_nodes_recursive().

count_texture_nodes_recursive()

static int count_texture_nodes_recursive ( bNodeTree *  nodetree )

static

Definition at line 1251 of file material.c.

References count_texture_nodes_cb(), and ntree_foreach_texnode_recursive().

Referenced by BKE_texpaint_slot_refresh_cache().

fill_texpaint_slots_cb()

static bool fill_texpaint_slots_cb ( bNode *  node, void *  userdata  )

static

Definition at line 1266 of file material.c.

References FillTexPaintSlotsData::active_node, TexPaintSlot::ima, FillTexPaintSlotsData::index, TexPaintSlot::interp, FillTexPaintSlotsData::ma, node, nodetree_uv_node_recursive(), Material::paint_active_slot, FillTexPaintSlotsData::slot_len, bNode::storage, Material::texpaintslot, NodeShaderUVMap::uv_map, TexPaintSlot::uvname, and TexPaintSlot::valid.

Referenced by fill_texpaint_slots_recursive().

fill_texpaint_slots_recursive()

static void fill_texpaint_slots_recursive ( bNodeTree *  nodetree, bNode *  active_node, Material *  ma, int  slot_len  )

static

Definition at line 1298 of file material.c.

References FillTexPaintSlotsData::active_node, fill_texpaint_slots_cb(), FillTexPaintSlotsData::ma, ntree_foreach_texnode_recursive(), and FillTexPaintSlotsData::slot_len.

Referenced by BKE_texpaint_slot_refresh_cache().

material_blend_read_data()

static void material_blend_read_data ( BlendDataReader *  reader, ID *  id  )

static

Definition at line 209 of file material.c.

References Material::adt, BKE_animdata_blend_read_data(), BKE_previewimg_blend_read(), BLI_listbase_clear(), BLO_read_data_address, Material::gp_style, Material::gpumaterial, NULL, Material::preview, and Material::texpaintslot.

material_blend_read_expand()

static void material_blend_read_expand ( BlendExpander *  expander, ID *  id  )

static

Definition at line 242 of file material.c.

References BLO_expand, Material::gp_style, MaterialGPencilStyle::ima, and MaterialGPencilStyle::sima.

material_blend_read_lib()

static void material_blend_read_lib ( BlendLibReader *  reader, ID *  id  )

static

Definition at line 225 of file material.c.

References BLO_read_id_address, Material::gp_style, Material::id, MaterialGPencilStyle::ima, ID::lib, NULL, and MaterialGPencilStyle::sima.

material_blend_write()

static void material_blend_write ( BlendWriter *  writer, ID *  id, const void *  id_address  )

static

Definition at line 178 of file material.c.

References Material::adt, BKE_animdata_blend_write(), BKE_id_blend_write(), BKE_previewimg_blend_write(), BLI_listbase_clear(), BLO_write_id_struct, BLO_write_is_undo(), BLO_write_struct, Material::gp_style, Material::gpumaterial, Material::id, Material::nodetree, ntreeBlendWrite(), NULL, Material::preview, Material::texpaintslot, and ID::us.

material_copy_data()

static void material_copy_data ( Main *  bmain, ID *  id_dst, const ID *  id_src, const int  flag  )

static

Definition at line 98 of file material.c.

References BKE_id_copy_ex(), BKE_previewimg_id_copy(), BLI_listbase_clear(), Material::gp_style, Material::gpumaterial, Material::id, LIB_ID_COPY_NO_PREVIEW, LIB_ID_CREATE_LOCAL, LIB_ID_CREATE_NO_ALLOCATE, MEM_dupallocN, Material::nodetree, ntreeLocalize, NULL, Material::preview, and Material::texpaintslot.

material_data_index_clear_id()

static void material_data_index_clear_id ( ID *  id )

static

Definition at line 485 of file material.c.

References BKE_curve_material_index_clear(), BKE_mesh_material_index_clear(), BLI_assert, GS, id, ID_CU, ID_HA, ID_MB, ID_ME, ID_PT, ID_VO, ID::name, and OB_DATA_SUPPORT_ID.

Referenced by BKE_id_material_clear().

material_data_index_remove_id()

static void material_data_index_remove_id ( ID *  id, short  index  )

static

Definition at line 442 of file material.c.

References BKE_curve_material_index_remove(), BKE_mesh_material_index_remove(), BLI_assert, GS, id, ID_CU, ID_HA, ID_MB, ID_ME, ID_PT, ID_VO, ID::name, and OB_DATA_SUPPORT_ID.

Referenced by BKE_id_material_pop(), and BKE_object_material_slot_remove().

material_default_gpencil_init()

static void material_default_gpencil_init ( Material *  ma )

static

Definition at line 1740 of file material.c.

References add_v3_fl(), BKE_gpencil_material_attr_init(), Material::gp_style, Material::id, ID::name, and MaterialGPencilStyle::stroke_rgba.

Referenced by BKE_materials_init().

material_default_holdout_init()

static void material_default_holdout_init ( Material *  ma )

static

Definition at line 1796 of file material.c.

References bNodeTreeType::idname, bNode::locx, bNode::locy, nodeAddLink(), nodeAddStaticNode(), nodeFindSocket(), nodeSetActive(), Material::nodetree, ntree, ntreeAddTree(), ntreeType_Shader, NULL, output, SH_NODE_HOLDOUT, SH_NODE_OUTPUT_MATERIAL, SOCK_IN, SOCK_OUT, and Material::use_nodes.

Referenced by BKE_materials_init().

material_default_surface_init()

static void material_default_surface_init ( Material *  ma )

static

Definition at line 1747 of file material.c.

References copy_v3_v3(), bNodeSocket::default_value, bNodeTreeType::idname, bNode::locx, bNode::locy, nodeAddLink(), nodeAddStaticNode(), nodeFindSocket(), nodeSetActive(), Material::nodetree, ntree, ntreeAddTree(), ntreeType_Shader, NULL, output, Material::r, SH_NODE_BSDF_PRINCIPLED, SH_NODE_OUTPUT_MATERIAL, SOCK_IN, SOCK_OUT, and Material::use_nodes.

Referenced by BKE_materials_init().

material_default_volume_init()

static void material_default_volume_init ( Material *  ma )

static

Definition at line 1773 of file material.c.

References bNodeTreeType::idname, bNode::locx, bNode::locy, nodeAddLink(), nodeAddStaticNode(), nodeFindSocket(), nodeSetActive(), Material::nodetree, ntree, ntreeAddTree(), ntreeType_Shader, NULL, output, SH_NODE_OUTPUT_MATERIAL, SH_NODE_VOLUME_PRINCIPLED, SOCK_IN, SOCK_OUT, and Material::use_nodes.

Referenced by BKE_materials_init().

material_foreach_id()

static void material_foreach_id ( ID *  id, LibraryForeachIDData *  data  )

static

Definition at line 162 of file material.c.

References BKE_LIB_FOREACHID_PROCESS, BKE_library_foreach_ID_embedded(), data, Material::gp_style, IDWALK_CB_NOP, IDWALK_CB_USER, TexPaintSlot::ima, MaterialGPencilStyle::ima, material, Material::nodetree, NULL, MaterialGPencilStyle::sima, and Material::texpaintslot.

material_free_data()

static void material_free_data ( ID *  id )

static

Definition at line 140 of file material.c.

References BKE_icon_id_delete(), BKE_previewimg_free(), Material::gp_style, GPU_material_free(), Material::gpumaterial, material, MEM_freeN, MEM_SAFE_FREE, Material::nodetree, ntreeFreeEmbeddedTree(), NULL, Material::preview, and Material::texpaintslot.

Referenced by BKE_materials_exit().

material_init_data()

static void material_init_data ( ID *  id )

static

Definition at line 89 of file material.c.

References BLI_assert, DNA_struct_default_get, material, MEMCMP_STRUCT_AFTER_IS_ZERO, and MEMCPY_STRUCT_AFTER.

Referenced by BKE_materials_init().

nodetree_uv_node_recursive()

static bNode* nodetree_uv_node_recursive ( bNode *  node )

static

Definition at line 1204 of file material.c.

References bNodeLink::fromnode, bNodeSocket::link, bNodeType::nclass, bNodeSocket::next, node, NODE_CLASS_INPUT, NULL, SH_NODE_UVMAP, bNodeType::type, and bNode::typeinfo.

Referenced by fill_texpaint_slots_cb().

ntree_foreach_texnode_recursive()

static bool ntree_foreach_texnode_recursive ( bNodeTree *  nodetree, ForEachTexNodeCallback  callback, void *  userdata  )

static

Definition at line 1224 of file material.c.

References callback, ELEM, LISTBASE_FOREACH, node, NODE_CLASS_TEXTURE, NODE_CUSTOM_GROUP, NODE_GROUP, bNodeTree::nodes, and SH_NODE_TEX_IMAGE.

Referenced by BKE_texpaint_slot_material_find_node(), count_texture_nodes_recursive(), and fill_texpaint_slots_recursive().

ramp_blend()

void ramp_blend	(	int	type,
		float	r_col[3],
		const float	fac,
		const float	col[3]
	)

Definition at line 1395 of file material.c.

References col, fabsf, hsv_to_rgb(), MA_RAMP_ADD, MA_RAMP_BLEND, MA_RAMP_BURN, MA_RAMP_COLOR, MA_RAMP_DARK, MA_RAMP_DIFF, MA_RAMP_DIV, MA_RAMP_DODGE, MA_RAMP_HUE, MA_RAMP_LIGHT, MA_RAMP_LINEAR, MA_RAMP_MULT, MA_RAMP_OVERLAY, MA_RAMP_SAT, MA_RAMP_SCREEN, MA_RAMP_SOFT, MA_RAMP_SUB, MA_RAMP_VAL, min_ff(), rgb_to_hsv(), and type.

Referenced by colorfn(), blender::nodes::do_mix_operation_color4f(), blender::nodes::do_mix_operation_float(), blender::nodes::do_mix_operation_float3(), do_proc(), Freestyle_blendRamp(), node_shader_exec_mix_rgb(), and texture_rgb_blend().

texpaint_slot_node_find_cb()

static bool texpaint_slot_node_find_cb ( bNode *  node, void *  userdata  )

static

Definition at line 1374 of file material.c.

References if(), FindTexPaintNodeData::ima, node, and FindTexPaintNodeData::r_node.

Referenced by BKE_texpaint_slot_material_find_node().

Variable Documentation

default_material_empty

Material default_material_empty

static

Definition at line 1727 of file material.c.

Referenced by BKE_material_default_empty().

default_material_gpencil

Material default_material_gpencil

static

Definition at line 1731 of file material.c.

Referenced by BKE_material_default_gpencil(), and BKE_materials_init().

default_material_holdout

Material default_material_holdout

static

Definition at line 1728 of file material.c.

Referenced by BKE_material_default_holdout(), and BKE_materials_init().

default_material_surface

Material default_material_surface

static

Definition at line 1729 of file material.c.

Referenced by BKE_material_default_surface(), and BKE_materials_init().

default_material_volume

Material default_material_volume

static

Definition at line 1730 of file material.c.

Referenced by BKE_material_default_volume(), and BKE_materials_init().

default_materials

Material* default_materials[]

static

Initial value:

= {&default_material_empty,
                                        &default_material_holdout,
                                        &default_material_surface,
                                        &default_material_volume,
                                        &default_material_gpencil,
                                        NULL}

Definition at line 1733 of file material.c.

Referenced by BKE_material_defaults_free_gpu(), BKE_materials_exit(), and BKE_materials_init().

IDType_ID_MA

IDTypeInfo IDType_ID_MA

Initial value:

= {
    .id_code = ID_MA,
    .id_filter = FILTER_ID_MA,
    .main_listbase_index = INDEX_ID_MA,
    .struct_size = sizeof(Material),
    .name = "Material",
    .name_plural = "materials",
    .translation_context = BLT_I18NCONTEXT_ID_MATERIAL,
    .flags = 0,
 
    .init_data = material_init_data,
    .copy_data = material_copy_data,
    .free_data = material_free_data,
    .make_local = NULL,
    .foreach_id = material_foreach_id,
    .foreach_cache = NULL,
    .owner_get = NULL,
 
    .blend_write = material_blend_write,
    .blend_read_data = material_blend_read_data,
    .blend_read_lib = material_blend_read_lib,
    .blend_read_expand = material_blend_read_expand,
 
    .blend_read_undo_preserve = NULL,
 
    .lib_override_apply_post = NULL,
}

Definition at line 254 of file material.c.

LOG

CLG_LogRef LOG = {"bke.material"}

static

Definition at line 87 of file material.c.

Referenced by BKE_object_material_get_p(), and BKE_object_material_slot_remove().

matcopied

short matcopied = 0

static

Definition at line 1653 of file material.c.

Referenced by BKE_material_copybuf_clear(), BKE_material_copybuf_copy(), BKE_material_copybuf_free(), and BKE_material_copybuf_paste().

matcopybuf

Material matcopybuf

static

copy/paste buffer, if we had a proper py api that would be better

Note

matcopybuf.nodetree does NOT use ID's

Todo:

matcopybuf.nodetree's node->id's are NOT validated, this will crash!

Definition at line 1652 of file material.c.

Referenced by BKE_material_copybuf_clear(), BKE_material_copybuf_copy(), BKE_material_copybuf_free(), and BKE_material_copybuf_paste().