ObjectModifiers(bpy_struct)

base class — bpy_struct

class bpy.types.ObjectModifiers(bpy_struct)

Collection of object modifiers

active

The active modifier in the list

Type

Modifier

new(name, type)

Add a new modifier

Parameters
  • name (string, (never None)) – New name for the modifier

  • type (enum in ['DATA_TRANSFER', 'MESH_CACHE', 'MESH_SEQUENCE_CACHE', 'NORMAL_EDIT', 'WEIGHTED_NORMAL', 'UV_PROJECT', 'UV_WARP', 'VERTEX_WEIGHT_EDIT', 'VERTEX_WEIGHT_MIX', 'VERTEX_WEIGHT_PROXIMITY', 'ARRAY', 'BEVEL', 'BOOLEAN', 'BUILD', 'DECIMATE', 'EDGE_SPLIT', 'NODES', 'MASK', 'MIRROR', 'MESH_TO_VOLUME', 'MULTIRES', 'REMESH', 'SCREW', 'SKIN', 'SOLIDIFY', 'SUBSURF', 'TRIANGULATE', 'VOLUME_TO_MESH', 'WELD', 'WIREFRAME', 'ARMATURE', 'CAST', 'CURVE', 'DISPLACE', 'HOOK', 'LAPLACIANDEFORM', 'LATTICE', 'MESH_DEFORM', 'SHRINKWRAP', 'SIMPLE_DEFORM', 'SMOOTH', 'CORRECTIVE_SMOOTH', 'LAPLACIANSMOOTH', 'SURFACE_DEFORM', 'WARP', 'WAVE', 'VOLUME_DISPLACE', 'CLOTH', 'COLLISION', 'DYNAMIC_PAINT', 'EXPLODE', 'FLUID', 'OCEAN', 'PARTICLE_INSTANCE', 'PARTICLE_SYSTEM', 'SOFT_BODY', 'SURFACE']) –

    Modifier type to add

    • DATA_TRANSFER Data Transfer, Transfer several types of data (vertex groups, UV maps, vertex colors, custom normals) from one mesh to another.

    • MESH_CACHE Mesh Cache, Deform the mesh using an external frame-by-frame vertex transform cache.

    • MESH_SEQUENCE_CACHE Mesh Sequence Cache, Deform the mesh or curve using an external mesh cache in Alembic format.

    • NORMAL_EDIT Normal Edit, Modify the direction of the surface normals.

    • WEIGHTED_NORMAL Weighted Normal, Modify the direction of the surface normals using a weighting method.

    • UV_PROJECT UV Project, Project the UV map coordinates from the negative Z axis of another object.

    • UV_WARP UV Warp, Transform the UV map using the difference between two objects.

    • VERTEX_WEIGHT_EDIT Vertex Weight Edit, Modify of the weights of a vertex group.

    • VERTEX_WEIGHT_MIX Vertex Weight Mix, Mix the weights of two vertex groups.

    • VERTEX_WEIGHT_PROXIMITY Vertex Weight Proximity, Set the vertex group weights based on the distance to another target object.

    • ARRAY Array, Create copies of the shape with offsets.

    • BEVEL Bevel, Generate sloped corners by adding geometry to the mesh’s edges or vertices.

    • BOOLEAN Boolean, Use another shape to cut, combine or perform a difference operation.

    • BUILD Build, Cause the faces of the mesh object to appear or disappear one after the other over time.

    • DECIMATE Decimate, Reduce the geometry density.

    • EDGE_SPLIT Edge Split, Split away joined faces at the edges.

    • NODES Geometry Nodes.

    • MASK Mask, Dynamically hide vertices based on a vertex group or armature.

    • MIRROR Mirror, Mirror along the local X, Y and/or Z axes, over the object origin.

    • MESH_TO_VOLUME Mesh to Volume.

    • MULTIRES Multiresolution, Subdivide the mesh in a way that allows editing the higher subdivision levels.

    • REMESH Remesh, Generate new mesh topology based on the current shape.

    • SCREW Screw, Lathe around an axis, treating the input mesh as a profile.

    • SKIN Skin, Create a solid shape from vertices and edges, using the vertex radius to define the thickness.

    • SOLIDIFY Solidify, Make the surface thick.

    • SUBSURF Subdivision Surface, Split the faces into smaller parts, giving it a smoother appearance.

    • TRIANGULATE Triangulate, Convert all polygons to triangles.

    • VOLUME_TO_MESH Volume to Mesh.

    • WELD Weld, Find groups of vertices closer than dist and merge them together.

    • WIREFRAME Wireframe, Convert faces into thickened edges.

    • ARMATURE Armature, Deform the shape using an armature object.

    • CAST Cast, Shift the shape towards a predefined primitive.

    • CURVE Curve, Bend the mesh using a curve object.

    • DISPLACE Displace, Offset vertices based on a texture.

    • HOOK Hook, Deform specific points using another object.

    • LAPLACIANDEFORM Laplacian Deform, Deform based a series of anchor points.

    • LATTICE Lattice, Deform using the shape of a lattice object.

    • MESH_DEFORM Mesh Deform, Deform using a different mesh, which acts as a deformation cage.

    • SHRINKWRAP Shrinkwrap, Project the shape onto another object.

    • SIMPLE_DEFORM Simple Deform, Deform the shape by twisting, bending, tapering or stretching.

    • SMOOTH Smooth, Smooth the mesh by flattening the angles between adjacent faces.

    • CORRECTIVE_SMOOTH Smooth Corrective, Smooth the mesh while still preserving the volume.

    • LAPLACIANSMOOTH Smooth Laplacian, Reduce the noise on a mesh surface with minimal changes to its shape.

    • SURFACE_DEFORM Surface Deform, Transfer motion from another mesh.

    • WARP Warp, Warp parts of a mesh to a new location in a very flexible way thanks to 2 specified objects.

    • WAVE Wave, Adds a ripple-like motion to an object’s geometry.

    • VOLUME_DISPLACE Volume Displace, Deform volume based on noise or other vector fields.

    • CLOTH Cloth.

    • COLLISION Collision.

    • DYNAMIC_PAINT Dynamic Paint.

    • EXPLODE Explode, Break apart the mesh faces and let them follow particles.

    • FLUID Fluid.

    • OCEAN Ocean, Generate a moving ocean surface.

    • PARTICLE_INSTANCE Particle Instance.

    • PARTICLE_SYSTEM Particle System, Spawn particles from the shape.

    • SOFT_BODY Soft Body.

    • SURFACE Surface.

Returns

Newly created modifier

Return type

Modifier

remove(modifier)

Remove an existing modifier from the object

Parameters

modifier (Modifier, (never None)) – Modifier to remove

clear()

Remove all modifiers from the object

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