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 (string) – 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 (string) – The RNA type identifier.

Returns

The class or default when not found.

Return type

type

Inherited Properties

Inherited Functions

References