BlendDataMaterials(bpy_struct)#

base class — bpy_struct

class bpy.types.BlendDataMaterials(bpy_struct)#

Collection of materials

new(name)#

Add a new material to the main database

Parameters:

name (string, (never None)) – New name for the data-block

Returns:

New material data-block

Return type:

Material

create_gpencil_data(material)#

Add Grease Pencil material settings

Parameters:

material (Material, (never None)) – Material

remove_gpencil_data(material)#

Remove Grease Pencil material settings

Parameters:

material (Material, (never None)) – Material

remove(material, *, do_unlink=True, do_id_user=True, do_ui_user=True)#

Remove a material from the current blendfile

Parameters:

  • material (Material, (never None)) – Material to remove

  • do_unlink (boolean, (optional)) – Unlink all usages of this material before deleting it

  • do_id_user (boolean, (optional)) – Decrement user counter of all datablocks used by this material

  • do_ui_user (boolean, (optional)) – Make sure interface does not reference this material

tag(value)#

tag

Parameters:

value (boolean) – Value

classmethod bl_rna_get_subclass(id, default=None)#
Parameters:

id (str) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)#
Parameters:

id (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties#

Inherited Functions#

References#