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

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

Type :float in [-inf, inf], default 0.0

auto_texspace

Adjust active object’s texture space automatically when transforming object

Type :boolean, default False

edges

Edges of the mesh

Type :MeshEdges bpy_prop_collection of MeshEdge, (readonly)

layers_float

Type :FloatProperties bpy_prop_collection of MeshFloatPropertyLayer, (readonly)

layers_int

Type :IntProperties bpy_prop_collection of MeshIntPropertyLayer, (readonly)

layers_string

Type :StringProperties bpy_prop_collection of MeshStringPropertyLayer, (readonly)

loops

Loops of the mesh (polygon corners)

Type :MeshLoops bpy_prop_collection of MeshLoop, (readonly)

materials

Type :IDMaterials bpy_prop_collection of Material, (readonly)

polygons

Polygons of the mesh

Type :MeshPolygons bpy_prop_collection of MeshPolygon, (readonly)

shape_keys

Type :Key, (readonly)

show_all_edges

Display 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

Display weights created for the Bevel modifier

Type :boolean, default False

show_edge_crease

Display creases created for subsurf weighting

Type :boolean, default False

show_edge_seams

Display UV unwrapping seams

Type :boolean, default False

show_edge_sharp

Display sharp edges, used with the EdgeSplit modifier

Type :boolean, default False

show_edges

Display selected edges using hilights in the 3D view and UV editor

Type :boolean, default False

show_extra_edge_length

Display selected edge lengths, using global values when set in the transform panel

Type :boolean, default False

show_extra_face_angle

Display 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

Display the area of selected faces, using global values when set in the transform panel

Type :boolean, default False

show_extra_indices

Display the index numbers of selected vertices, edges, and faces

Type :boolean, default False

show_faces

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

Type :boolean, default False

show_normal_face

Display face normals as lines

Type :boolean, default False

show_normal_vertex

Display vertex normals as lines

Type :boolean, default False

sticky

Sticky texture coordinates

Type :bpy_prop_collection of MeshSticky, (readonly)

tessface_uv_textures

All UV maps for tessellated faces (read-only, for use by renderers)

Type :TessfaceUVTextures bpy_prop_collection of MeshTextureFaceLayer, (readonly)

tessface_vertex_colors

All tessellated face colors (read-only, for use by renderers)

Type :VertexColors bpy_prop_collection of MeshColorLayer, (readonly)

tessfaces

Tessellation faces of the mesh (derived from polygons)

Type :MeshTessFaces bpy_prop_collection of MeshTessFace, (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

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

Type :boolean, default False

use_auto_texspace

Adjust 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

use_paint_mask_vertex

Vertex selection masking for painting (weight paint only)

Type :boolean, default False

uv_loop_layer_clone

UV loop layer to be used as cloning source

Type :MeshUVLoopLayer

uv_loop_layer_clone_index

Clone UV loop layer index

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

uv_loop_layer_stencil

UV loop layer to mask the painted area

Type :MeshUVLoopLayer

uv_loop_layer_stencil_index

Mask UV loop layer index

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

uv_loop_layers

All UV loop layers

Type :UVLoopLayers bpy_prop_collection of MeshUVLoopLayer, (readonly)

uv_texture_clone

UV map to be used as cloning source

Type :MeshTexturePolyLayer

uv_texture_clone_index

Clone UV map index

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

uv_texture_stencil

UV map to mask the painted area

Type :MeshTexturePolyLayer

uv_texture_stencil_index

Mask UV map index

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

uv_textures

All UV maps

Type :UVTextures bpy_prop_collection of MeshTexturePolyLayer, (readonly)

vertex_colors

All vertex colors

Type :LoopColors bpy_prop_collection of MeshLoopColorLayer, (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

calc_tessface()

Calculate face tessellation (supports editmode too)

update(calc_edges=False, calc_tessface=False)

update

Parameters:

• calc_edges (boolean, (optional)) – Calculate Edges, Force recalculation of edges
• calc_tessface (boolean, (optional)) – Calculate Tessellation, Force recalculation of tessellation faces

unit_test_compare(mesh=None)

unit_test_compare

Parameters:mesh (Mesh, (optional)) – Mesh to compare to Returns:Return value, String description of result of comparison Return type:string

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 vertices/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 more 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.is_updated

ID.is_updated_data 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 Mesh.unit_test_compare Object.to_mesh