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

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

Faces of the mesh

Type :MeshFaces 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

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

Inherited Functions

References

Previous topic

Menu(bpy_struct)

Next topic

MeshColor(bpy_struct)