Mesh(ID)

base classes — bpy_struct, ID

class bpy.types.Mesh(ID)

Mesh datablock defining geometric surfaces

animation_data

Animation data for this datablock

Type :AnimData, (readonly)

auto_smooth_angle

Defines maximum angle between face normals that ‘Auto Smooth’ will operate on

Type :int in [1, 80], default 0

edges

Edges of the mesh

Type :MeshEdges bpy_prop_collection of MeshEdge, (readonly)

faces

Faces of the mesh

Type :MeshFaces bpy_prop_collection of MeshFace, (readonly)

layers_float

Type :bpy_prop_collection of MeshFloatPropertyLayer, (readonly)

layers_int

Type :bpy_prop_collection of MeshIntPropertyLayer, (readonly)

layers_string

Type :bpy_prop_collection of MeshStringPropertyLayer, (readonly)

materials

Type :IDMaterials bpy_prop_collection of Material, (readonly)

shape_keys

Type :Key, (readonly)

show_all_edges

Displays all edges for wireframe in all view modes in the 3D view

Type :boolean, default False

show_double_sided

Render/display the mesh with double or single sided lighting

Type :boolean, default False

show_edge_bevel_weight

Displays weights created for the Bevel modifier

Type :boolean, default False

show_edge_crease

Displays creases created for subsurf weighting

Type :boolean, default False

show_edge_seams

Displays UV unwrapping seams

Type :boolean, default False

show_edge_sharp

Displays sharp edges, used with the EdgeSplit modifier

Type :boolean, default False

show_edges

Displays selected edges using highlights in the 3D view and UV editor

Type :boolean, default False

show_extra_edge_length

Displays selected edge lengths, Using global values when set in the transform panel

Type :boolean, default False

show_extra_face_angle

Displays the angles in the selected edges in degrees, Using global values when set in the transform panel

Type :boolean, default False

show_extra_face_area

Displays the area of selected faces, Using global values when set in the transform panel

Type :boolean, default False

show_faces

Displays all faces as shades in the 3D view and UV editor

Type :boolean, default False

show_normal_face

Displays face normals as lines

Type :boolean, default False

show_normal_vertex

Displays vertex normals as lines

Type :boolean, default False

sticky

Sticky texture coordinates

Type :bpy_prop_collection of MeshSticky, (readonly)

texco_mesh

Derive texture coordinates from another mesh

Type :Mesh

texspace_location

Texture space location

Type :float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

texspace_size

Texture space size

Type :float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

texture_mesh

Use another mesh for texture indices (vertex indices must be aligned)

Type :Mesh

total_edge_sel

Selected edge count in editmode

Type :int in [0, inf], default 0, (readonly)

total_face_sel

Selected face count in editmode

Type :int in [0, inf], default 0, (readonly)

total_vert_sel

Selected vertex count in editmode

Type :int in [0, inf], default 0, (readonly)

use_auto_smooth

Treats all set-smoothed faces with angles less than the specified angle as ‘smooth’ during render

Type :boolean, default False

use_auto_texspace

Adjusts active object’s texture space automatically when transforming object

Type :boolean, default False

use_mirror_topology

Use topology based mirroring. For when both sides of mesh have matching, unique topology

Type :boolean, default False

use_mirror_x

X Axis mirror editing

Type :boolean, default False

use_paint_mask

Face selection masking for painting

Type :boolean, default False

uv_texture_clone

UV texture to be used as cloning source

Type :MeshTextureFaceLayer

uv_texture_clone_index

Clone UV texture index

Type :int in [0, inf], default 0

uv_texture_stencil

UV texture to mask the painted area

Type :MeshTextureFaceLayer

uv_texture_stencil_index

Mask UV texture index

Type :int in [0, inf], default 0

uv_textures

Type :UVTextures bpy_prop_collection of MeshTextureFaceLayer, (readonly)

vertex_colors

Type :VertexColors bpy_prop_collection of MeshColorLayer, (readonly)

vertices

Vertices of the mesh

Type :MeshVertices bpy_prop_collection of MeshVertex, (readonly)

edge_keys

(readonly)

transform(matrix)

Transform mesh vertices by a matrix.

Parameters:

• matrix (float array of 16 items in [-inf, inf]) – Matrix.

calc_normals()

Calculate vertex normals.

update(calc_edges=False)

update

Parameters:

• calc_edges (boolean, (optional)) – Calculate Edges, Force recalculation of edges.

validate(verbose=False)

validate geometry, return True when the mesh has had invalid geometry corrected/removed.

Parameters:

• verbose (boolean, (optional)) – Verbose, Output information about the errors found

Returns:

Result

Return type:

boolean

from_pydata(vertices, edges, faces)

Make a mesh from a list of verts/edges/faces Until we have a nicer way to make geometry, use this.

Parameters:

• vertices (iterable object) – float triplets each representing (X, Y, Z) eg: [(0.0, 1.0, 0.5), ...].
• edges (iterable object) – int pairs, each pair contains two indices to the vertices argument. eg: [(1, 2), ...]
• faces (iterable object) – iterator of faces, each faces contains three or four indices to the vertices argument. eg: [(5, 6, 8, 9), (1, 2, 3), ...]

Inherited Properties

bpy_struct.id_data ID.name ID.use_fake_user

ID.library ID.tag ID.users

Inherited Functions

bpy_struct.as_pointer bpy_struct.callback_add bpy_struct.callback_remove bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert

bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.type_recast bpy_struct.values ID.copy ID.user_clear ID.animation_data_create ID.animation_data_clear ID.update_tag

References

BlendData.meshes BlendDataMeshes.new BlendDataMeshes.remove EditObjectActuator.mesh

Mesh.texco_mesh Mesh.texture_mesh Object.to_mesh