user: Give a detailed overview of Bpy.Ops.Mesh: syntax, arguments, return values, common patterns.

assistant: (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. primitive_cone_add ( * , vertices = 32 , radius1 = 1.0 , radius2 = 0.0 , depth = 2.0 , end_fill_type = 'NGON' , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) ) ¶ Construct a conic mesh Parameters : vertices ( int in [ 3 , 10000000 ] , ( optional ) ) – Vertices radius1 ( float in [ 0 , inf ] , ( optional ) ) – Radius 1 radius2 ( float in [ 0 , inf ] , ( optional ) ) – Radius 2 depth ( float in [ 0 , inf ] , ( optional ) ) – Depth end_fill_type (enum in [ 'NOTHING' , 'NGON' , 'TRIFAN' ], (optional)) – Base Fill Type NOTHING Nothing – Don’t fill at all. NGON N-Gon – Use n-gons. TRIFAN Triangle Fan – Use triangle fans. calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. primitive_cube_add ( * , size = 2.0 , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) ) ¶ Construct a cube mesh that consists of six square faces Parameters : size ( float in [ 0 , inf ] , ( optional ) ) – Size calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. primitive_cube_add_gizmo ( * , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) , matrix = ((0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0)) ) ¶ Construct a cube mesh Parameters : calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object matrix ( mathutils.Matrix of 4 * 4 items in [-inf, inf], (optional)) – Matrix bpy.ops.mesh. primitive_cylinder_add ( * , vertices = 32 , radius = 1.0 , depth = 2.0 , end_fill_type = 'NGON' , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) ) ¶ Construct a cylinder mesh Parameters : vertices ( int in [ 3 , 10000000 ] , ( optional ) ) – Vertices radius ( float in [ 0 , inf ] , ( optional ) ) – Radius depth ( float in [ 0 , inf ] , ( optional ) ) – Depth end_fill_type (enum in [ 'NOTHING' , 'NGON' , 'TRIFAN' ], (optional)) – Cap Fill Type NOTHING Nothing – Don’t fill at all. NGON N-Gon – Use n-gons. TRIFAN Triangle Fan – Use triangle fans. calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. primitive_grid_add ( * , x_subdivisions = 10 , y_subdivisions = 10 , size = 2.0 , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) ) ¶ Construct a subdivided plane mesh Parameters : x_subdivisions ( int in [ 1 , 10000000 ] , ( optional ) ) – X Subdivisions y_subdivisions ( int in [ 1 , 10000000 ] , ( optional ) ) – Y Subdivisions size ( float in [ 0 , inf ] , ( optional ) ) – Size calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. primitive_ico_sphere_add ( * , subdivisions = 2 , radius = 1.0 , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) ) ¶ Construct a spherical mesh that consists of equally sized triangles Parameters : subdivisions ( int in [ 1 , 10 ] , ( optional ) ) – Subdivisions radius ( float in [ 0 , inf ] , ( optional ) ) – Radius calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. primitive_monkey_add ( * , size = 2.0 , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) ) ¶ Construct a Suzanne mesh Parameters : size ( float in [ 0 , inf ] , ( optional ) ) – Size calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. primitive_plane_add ( * , size = 2.0 , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) ) ¶ Construct a filled planar mesh with 4 vertices Parameters : size ( float in [ 0 , inf ] , ( optional ) ) – Size calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. primitive_torus_add ( * , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , major_segments = 48 , minor_segments = 12 , mode = 'MAJOR_MINOR' , major_radius = 1.0 , minor_radius = 0.25 , abso_major_rad = 1.25 , abso_minor_rad = 0.75 , generate_uvs = True ) ¶ Construct a torus mesh Parameters : align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation major_segments ( int in [ 3 , 256 ] , ( optional ) ) – Major Segments, Number of segments for the main ring of the torus minor_segments ( int in [ 3 , 256 ] , ( optional ) ) – Minor Segments, Number of segments for the minor ring of the torus mode (enum in [ 'MAJOR_MINOR' , 'EXT_INT' ], (optional)) – Dimensions Mode MAJOR_MINOR Major/Minor – Use the major/minor radii for torus dimensions. EXT_INT Exterior/Interior – Use the exterior/interior radii for torus dimensions. major_radius ( float in [ 0 , 10000 ] , ( optional ) ) – Major Radius, Radius from the origin to the center of the cross sections minor_radius ( float in [ 0 , 10000 ] , ( optional ) ) – Minor Radius, Radius of the torus’ cross section abso_major_rad ( float in [ 0 , 10000 ] , ( optional ) ) – Exterior Radius, Total Exterior Radius of the torus abso_minor_rad ( float in [ 0 , 10000 ] , ( optional ) ) – Interior Radius, Total Interior Radius of the torus generate_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map File : startup/bl_operators/add_mesh_torus.py:222 bpy.ops.mesh. primitive_uv_sphere_add ( * , segments = 32 , ring_count = 16 , radius = 1.0 , calc_uvs = True , enter_editmode = False , align = 'WORLD' , location = (0.0, 0.0, 0.0) , rotation = (0.0, 0.0, 0.0) , scale = (0.0, 0.0, 0.0) ) ¶ Construct a spherical mesh with quad faces, except for triangle faces at the top and bottom Parameters : segments ( int in [ 3 , 100000 ] , ( optional ) ) – Segments ring_count ( int in [ 3 , 100000 ] , ( optional ) ) – Rings radius ( float in [ 0 , inf ] , ( optional ) ) – Radius calc_uvs ( boolean , ( optional ) ) – Generate UVs, Generate a default UV map enter_editmode ( boolean , ( optional ) ) – Enter Edit Mode, Enter edit mode when adding this object align (enum in [ 'WORLD' , 'VIEW' , 'CURSOR' ], (optional)) – Align, The alignment of the new object WORLD World – Align the new object to the world. VIEW View – Align the new object to the view. CURSOR 3D Cursor – Use the 3D cursor orientation for the new object. location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Location, Location for the newly added object rotation ( mathutils.Euler rotation of 3 items in [-inf, inf], (optional)) – Rotation, Rotation for the newly added object scale ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Scale, Scale for the newly added object bpy.ops.mesh. quads_convert_to_tris ( * , quad_method = 'BEAUTY' , ngon_method = 'BEAUTY' ) ¶ Triangulate selected faces Parameters : quad_method (enum in Modifier Triangulate Quad Method Items , (optional)) – Quad Method, Method for splitting the quads into triangles ngon_method (enum in Modifier Triangulate Ngon Method Items , (optional)) – N-gon Method, Method for splitting the n-gons into triangles bpy.ops.mesh. region_to_loop ( ) ¶ Select boundary edges around the selected faces bpy.ops.mesh. remove_doubles ( * , threshold = 0.0001 , use_centroid = True , use_unselected = False , use_sharp_edge_from_normals = False ) ¶ Merge vertices based on their proximity Parameters : threshold ( float in [ 1e-06 , 50 ] , ( optional ) ) – Merge Distance, Maximum distance between elements to merge use_centroid ( boolean , ( optional ) ) – Centroid Merge, Move vertices to the centroid of the duplicate cluster, otherwise the vertex closest to the centroid is used. use_unselected ( boolean , ( optional ) ) – Unselected, Merge selected to other unselected vertices use_sharp_edge_from_normals ( boolean , ( optional ) ) – Sharp Edges, Calculate sharp edges using custom normal data (when available) bpy.ops.mesh. reorder_vertices_spatial ( ) ¶ Reorder mesh faces and vertices based on their spatial position for better BVH building and sculpting performance. bpy.ops.mesh. reveal ( * , select = True ) ¶ Reveal all hidden vertices, edges and faces Parameters : select ( boolean , ( optional ) ) – Select bpy.ops.mesh. rip ( * , mirror = False , use_proportional_edit = False , proportional_edit_falloff = 'SMOOTH' , proportional_size = 1.0 , use_proportional_connected = False , use_proportional_projected = False , release_confirm = False , use_accurate = False , use_fill = False ) ¶ Disconnect vertex or edges from connected geometry Parameters : mirror ( boolean , ( optional ) ) – Mirror Editing use_proportional_edit ( boolean , ( optional ) ) – Proportional Editing proportional_edit_falloff (enum in Proportional Falloff Items , (optional)) – Proportional Falloff, Falloff type for proportional editing mode proportional_size ( float in [ 1e-06 , inf ] , ( optional ) ) – Proportional Size use_proportional_connected ( boolean , ( optional ) ) – Connected use_proportional_projected ( boolean , ( optional ) ) – Projected (2D) release_confirm ( boolean , ( optional ) ) – Confirm on Release, Always confirm operation when releasing button use_accurate ( boolean , ( optional ) ) – Accurate, Use accurate transformation use_fill ( boolean , ( optional ) ) – Fill, Fill the ripped region bpy.ops.mesh. rip_edge ( * , mirror = False , use_proportional_edit = False , proportional_edit_falloff = 'SMOOTH' , proportional_size = 1.0 , use_proportional_connected = False , use_proportional_projected = False , release_confirm = False , use_accurate = False ) ¶ Extend vertices along the edge closest to the cursor Parameters : mirror ( boolean , ( optional ) ) – Mirror Editing use_proportional_edit ( boolean , ( optional ) ) – Proportional Editing proportional_edit_falloff (enum in Proportional Falloff Items , (optional)) – Proportional Falloff, Falloff type for proportional editing mode proportional_size ( float in [ 1e-06 , inf ] , ( optional ) ) – Proportional Size use_proportional_connected ( boolean , ( optional ) ) – Connected use_proportional_projected ( boolean , ( optional ) ) – Projected (2D) release_confirm ( boolean , ( optional ) ) – Confirm on Release, Always confirm operation when releasing button use_accurate ( boolean , ( optional ) ) – Accurate, Use accurate transformation bpy.ops.mesh. rip_edge_move ( * , MESH_OT_rip_edge = None , TRANSFORM_OT_translate = None ) ¶ Extend vertices and move the result Parameters : MESH_OT_rip_edge ( MESH_OT_rip_edge , (optional)) – Extend Vertices, Extend vertices along the edge closest to the cursor TRANSFORM_OT_translate ( TRANSFORM_OT_translate , (optional)) – Move, Move selected items bpy.ops.mesh. rip_move ( * , MESH_OT_rip = None , TRANSFORM_OT_translate = None ) ¶ Rip polygons and move the result Parameters : MESH_OT_rip ( MESH_OT_rip , (optional)) – Rip, Disconnect vertex or edges from connected geometry TRANSFORM_OT_translate ( TRANSFORM_OT_translate , (optional)) – Move, Move selected items bpy.ops.mesh. screw ( * , steps = 9 , turns = 1 , center = (0.0, 0