BlendDataMaterials(bpy_prop_collection)

base classes — bpy_prop, bpy_prop_collection

class bpy.types.BlendDataMaterials(bpy_prop_collection)

Collection of materials

new(name)

Add a new material to the main database

Parameters:

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

Returns:

New material data-block

Return type:

Material

create_gpencil_data(material)

Add Grease Pencil material settings

Parameters:

material (Material) – Material (never None)

remove_gpencil_data(material)

Remove Grease Pencil material settings

Parameters:

material (Material) – Material (never None)

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

Remove a material from the current blendfile

Parameters:

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

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

  • do_id_user (bool) – Decrement user counter of all data-blocks used by this material (optional)

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

tag(value)

tag

Parameters:

value (bool) – Value

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

  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

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

  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References