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

assistant: nors ( boolean , ( optional ) ) – Custom Normals Only, Only flip the custom loop normals of the selected elements bpy.ops.mesh. flip_quad_tessellation ( ) ¶ Flips the tessellation of selected quads bpy.ops.mesh. hide ( * , unselected = False ) ¶ Hide (un)selected vertices, edges or faces Parameters : unselected ( boolean , ( optional ) ) – Unselected, Hide unselected rather than selected bpy.ops.mesh. inset ( * , use_boundary = True , use_even_offset = True , use_relative_offset = False , use_edge_rail = False , thickness = 0.0 , depth = 0.0 , use_outset = False , use_select_inset = False , use_individual = False , use_interpolate = True , release_confirm = False ) ¶ Inset new faces into selected faces Parameters : use_boundary ( boolean , ( optional ) ) – Boundary, Inset face boundaries use_even_offset ( boolean , ( optional ) ) – Offset Even, Scale the offset to give more even thickness use_relative_offset ( boolean , ( optional ) ) – Offset Relative, Scale the offset by surrounding geometry use_edge_rail ( boolean , ( optional ) ) – Edge Rail, Inset the region along existing edges thickness ( float in [ 0 , inf ] , ( optional ) ) – Thickness depth ( float in [ -inf , inf ] , ( optional ) ) – Depth use_outset ( boolean , ( optional ) ) – Outset, Outset rather than inset use_select_inset ( boolean , ( optional ) ) – Select Outer, Select the new inset faces use_individual ( boolean , ( optional ) ) – Individual, Individual face inset use_interpolate ( boolean , ( optional ) ) – Interpolate, Blend face data across the inset release_confirm ( boolean , ( optional ) ) – Confirm on Release bpy.ops.mesh. intersect ( * , mode = 'SELECT_UNSELECT' , separate_mode = 'CUT' , threshold = 1e-06 , solver = 'EXACT' ) ¶ Cut an intersection into faces Parameters : mode (enum in [ 'SELECT' , 'SELECT_UNSELECT' ], (optional)) – Source SELECT Self Intersect – Self intersect selected faces. SELECT_UNSELECT Selected/Unselected – Intersect selected with unselected faces. separate_mode (enum in [ 'ALL' , 'CUT' , 'NONE' ], (optional)) – Separate Mode ALL All – Separate all geometry from intersections. CUT Cut – Cut into geometry keeping each side separate (Selected/Unselected only). NONE Merge – Merge all geometry from the intersection. threshold ( float in [ 0 , 0.01 ] , ( optional ) ) – Merge Threshold solver (enum in [ 'FLOAT' , 'EXACT' ], (optional)) – Solver, Which Intersect solver to use FLOAT Float – Simple solver with good performance, without support for overlapping geometry. EXACT Exact – Slower solver with the best results for coplanar faces. bpy.ops.mesh. intersect_boolean ( * , operation = 'DIFFERENCE' , use_swap = False , use_self = False , threshold = 1e-06 , solver = 'EXACT' ) ¶ Cut solid geometry from selected to unselected Parameters : operation (enum in [ 'INTERSECT' , 'UNION' , 'DIFFERENCE' ], (optional)) – Boolean Operation, Which boolean operation to apply use_swap ( boolean , ( optional ) ) – Swap, Use with difference intersection to swap which side is kept use_self ( boolean , ( optional ) ) – Self Intersection, Do self-union or self-intersection threshold ( float in [ 0 , 0.01 ] , ( optional ) ) – Merge Threshold solver (enum in [ 'FLOAT' , 'EXACT' ], (optional)) – Solver, Which Boolean solver to use FLOAT Float – Faster solver, some limitations. EXACT Exact – Exact solver, slower, handles more cases. bpy.ops.mesh. knife_project ( * , cut_through = False ) ¶ Use other objects outlines and boundaries to project knife cuts Parameters : cut_through ( boolean , ( optional ) ) – Cut Through, Cut through all faces, not just visible ones bpy.ops.mesh. knife_tool ( * , use_occlude_geometry = True , only_selected = False , xray = True , visible_measurements = 'NONE' , angle_snapping = 'NONE' , angle_snapping_increment = 0.523599 , wait_for_input = True ) ¶ Cut new topology Parameters : use_occlude_geometry ( boolean , ( optional ) ) – Occlude Geometry, Only cut the front most geometry only_selected ( boolean , ( optional ) ) – Only Selected, Only cut selected geometry xray ( boolean , ( optional ) ) – X-Ray, Show cuts hidden by geometry visible_measurements (enum in [ 'NONE' , 'BOTH' , 'DISTANCE' , 'ANGLE' ], (optional)) – Measurements, Visible distance and angle measurements NONE None – Show no measurements. BOTH Both – Show both distances and angles. DISTANCE Distance – Show just distance measurements. ANGLE Angle – Show just angle measurements. angle_snapping (enum in [ 'NONE' , 'SCREEN' , 'RELATIVE' ], (optional)) – Angle Snapping, Angle snapping mode NONE None – No angle snapping. SCREEN Screen – Screen space angle snapping. RELATIVE Relative – Angle snapping relative to the previous cut edge. angle_snapping_increment ( float in [ 0 , 3.14159 ] , ( optional ) ) – Angle Snap Increment, The angle snap increment used when in constrained angle mode wait_for_input ( boolean , ( optional ) ) – Wait for Input bpy.ops.mesh. loop_multi_select ( * , ring = False ) ¶ Select a loop of connected edges by connection type Parameters : ring ( boolean , ( optional ) ) – Ring bpy.ops.mesh. loop_select ( * , extend = False , deselect = False , toggle = False , ring = False ) ¶ Select a loop of connected edges Parameters : extend ( boolean , ( optional ) ) – Extend Select, Extend the selection deselect ( boolean , ( optional ) ) – Deselect, Remove from the selection toggle ( boolean , ( optional ) ) – Toggle Select, Toggle the selection ring ( boolean , ( optional ) ) – Select Ring, Select ring bpy.ops.mesh. loop_to_region ( * , select_bigger = False ) ¶ Select region of faces inside of a selected loop of edges Parameters : select_bigger ( boolean , ( optional ) ) – Select Bigger, Select bigger regions instead of smaller ones bpy.ops.mesh. loopcut ( * , number_cuts = 1 , smoothness = 0.0 , falloff = 'INVERSE_SQUARE' , object_index = -1 , edge_index = -1 , mesh_select_mode_init = (False, False, False) ) ¶ Add a new loop between existing loops Parameters : number_cuts ( int in [ 1 , 1000000 ] , ( optional ) ) – Number of Cuts smoothness ( float in [ -1000 , 1000 ] , ( optional ) ) – Smoothness, Smoothness factor falloff (enum in Proportional Falloff Curve Only Items , (optional)) – Falloff, Falloff type of the feather object_index ( int in [ -1 , inf ] , ( optional ) ) – Object Index edge_index ( int in [ -1 , inf ] , ( optional ) ) – Edge Index bpy.ops.mesh. loopcut_slide ( * , MESH_OT_loopcut = None , TRANSFORM_OT_edge_slide = None ) ¶ Cut mesh loop and slide it Parameters : MESH_OT_loopcut ( MESH_OT_loopcut , (optional)) – Loop Cut, Add a new loop between existing loops TRANSFORM_OT_edge_slide ( TRANSFORM_OT_edge_slide , (optional)) – Edge Slide, Slide an edge loop along a mesh bpy.ops.mesh. mark_freestyle_edge ( * , clear = False ) ¶ (Un)mark selected edges as Freestyle feature edges Parameters : clear ( boolean , ( optional ) ) – Clear bpy.ops.mesh. mark_freestyle_face ( * , clear = False ) ¶ (Un)mark selected faces for exclusion from Freestyle feature edge detection Parameters : clear ( boolean , ( optional ) ) – Clear bpy.ops.mesh. mark_seam ( * , clear = False ) ¶ (Un)mark selected edges as a seam Parameters : clear ( boolean , ( optional ) ) – Clear bpy.ops.mesh. mark_sharp ( * , clear = False , use_verts = False ) ¶ (Un)mark selected edges as sharp Parameters : clear ( boolean , ( optional ) ) – Clear use_verts ( boolean , ( optional ) ) – Vertices, Consider vertices instead of edges to select which edges to (un)tag as sharp bpy.ops.mesh. merge ( * , type = 'CENTER' , uvs = False ) ¶ Merge selected vertices Parameters : type (enum in [ 'CENTER' , 'CURSOR' , 'COLLAPSE' , 'FIRST' , 'LAST' ], (optional)) – Type, Merge method to use uvs ( boolean , ( optional ) ) – UVs, Move UVs according to merge bpy.ops.mesh. merge_normals ( ) ¶ Merge custom normals of selected vertices bpy.ops.mesh. mod_weighted_strength ( * , set = False , face_strength = 'MEDIUM' ) ¶ Set/Get strength of face (used in Weighted Normal modifier) Parameters : set ( boolean , ( optional ) ) – Set Value, Set value of faces face_strength (enum in [ 'WEAK' , 'MEDIUM' , 'STRONG' ], (optional)) – Face Strength, Strength to use for assigning or selecting face influence for weighted normal modifier bpy.ops.mesh. normals_make_consistent ( * , inside = False ) ¶ Make face and vertex normals point either outside or inside the mesh Parameters : inside ( boolean , ( optional ) ) – Inside bpy.ops.mesh. normals_tools ( * , mode = 'COPY' , absolute = False ) ¶ Custom normals tools using Normal Vector of UI Parameters : mode (enum in [ 'COPY' , 'PASTE' , 'ADD' , 'MULTIPLY' , 'RESET' ], (optional)) – Mode, Mode of tools taking input from interface COPY Copy Normal – Copy normal to the internal clipboard. PASTE Paste Normal – Paste normal from the internal clipboard. ADD Add Normal – Add normal vector with selection. MULTIPLY Multiply Normal – Multiply normal vector with selection. RESET Reset Normal – Reset the internal clipboard and/or normal of selected element. absolute ( boolean , ( optional ) ) – Absolute Coordinates, Copy Absolute coordinates of Normal vector bpy.ops.mesh. offset_edge_loops ( * , use_cap_endpoint = False ) ¶ Create offset edge loop from the current selection Parameters : use_cap_endpoint ( boolean , ( optional ) ) – Cap Endpoint, Extend loop around end-points bpy.ops.mesh. offset_edge_loops_slide ( * , MESH_OT_offset_edge_loops = None , TRANSFORM_OT_edge_slide = None ) ¶ Offset edge loop slide Parameters : MESH_OT_offset_edge_loops ( MESH_OT_offset_edge_loops , (optional)) – Offset Edge Loop, Create offset edge loop from the current selection TRANSFORM_OT_edge_slide ( TRANSFORM_OT_edge_slide , (optional)) – Edge Slide, Slide an edge loop along a mesh bpy.ops.mesh. point_normals ( * , mode = 'COORDINATES' , invert = False , align = False , target_location = (0.0, 0.0, 0.0) , spherize = False , spherize_strength = 0.1 ) ¶ Point selected custom normals to specified Target Parameters : mode (enum in [ 'COORDINATES' , 'MOUSE' ], (optional)) – Mode, How to define coordinates to point custom normals to COORDINATES Coordinates – Use static coordinates (defined by various means). MOUSE Mouse – Follow mouse cursor. invert ( boolean , ( optional ) ) – Invert, Invert affected normals align ( boolean , ( optional ) ) – Align, Make all affected normals parallel target_location ( mathutils.Vector of 3 items in [-inf, inf], (optional)) – Target, Target location to which normals will point spherize ( boolean , ( optional ) ) – Spherize, Interpolate between original and new normals spherize_strength ( float in [ 0 , 1 ] , ( optional ) ) – Spherize Strength, Ratio of spherized normal to original normal bpy.ops.mesh. poke ( * , offset = 0.0 , use_relative_offset = False , center_mode = 'MEDIAN_WEIGHTED' ) ¶ Split a face into a fan Parameters : offset ( float in [ -1000 , 1000 ] , ( optional ) ) – Poke Offset, Poke Offset use_relative_offset ( boolean , ( optional ) ) – Offset Relative, Scale the offset by surrounding geometry center_mode (enum in [ 'MEDIAN_WEIGHTED' , 'MEDIAN' , 'BOUNDS' ], (optional)) – Poke Center, Poke face center calculation MEDIAN_WEIGHTED Weighted Median – Weighted median face center. MEDIAN Median – Median face center. BOUNDS Bounds – Face bounds center. bpy.ops.mesh. polybuild_delete_at_cursor ( * , 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 ) ¶ Undocumented, consider contributing . 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. polybuild_dissolve_at_cursor ( ) ¶ Undocumented, consider contributing . bpy.ops.mesh. polybuild_extrude_at_cursor_move ( * , MESH_OT_polybuild_transform_at_cursor = None , MESH_OT_extrude_edges_indiv = None , TRANSFORM_OT_translate = None ) ¶ Undocumented, consider contributing . Parameters : MESH_OT_polybuild_transform_at_cursor ( MESH_OT_polybuild_transform_at_cursor , (optional)) – Poly Build Transform at Cursor MESH_OT_extrude_edges_indiv ( MESH_OT_extrude_edges_indiv , (optional)) – Extrude Only Edges, Extrude individual edges only TRANSFORM_OT_translate ( TRANSFORM_OT_translate , (optional)) – Move, Move selected items bpy.ops.mesh. polybuild_face_at_cursor ( * , create_quads = True , 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 ) ¶ Undocumented, consider contributing . Parameters : create_quads ( boolean , ( optional ) ) – Create Quads, Automatically split edges in triangles to maintain quad topology 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. polybuild_face_at_cursor_move ( * , MESH_OT_polybuild_face_at_cursor = None , TRANSFORM_OT_translate = None ) ¶ Undocumented, consider contributing . Parameters : MESH_OT_polybuild_face_at_cursor ( MESH_OT_polybuild_face_at_cursor , (optional)) – Poly Build Face at Cursor TRANSFORM_OT_translate ( TRANSFORM_OT_translate , (optional)) – Move, Move selected items bpy.ops.mesh. polybuild_split_at_cursor ( * , 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 ) ¶ Undocumented, consider contributing . 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. polybuild_split_at_cursor_move ( * , MESH_OT_polybuild_split_at_cursor = None , TRANSFORM_OT_translate = None ) ¶ Undocumented, consider contributing . Parameters : MESH_OT_polybuild_split_at_cursor ( MESH_OT_polybuild_split_at_cursor , (optional)) – Poly Build Split at Cursor TRANSFORM_OT_translate ( TRANSFORM_OT_translate , (optional)) – Move, Move selected items bpy.ops.mesh. polybuild_transform_at_cursor ( * , 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 ) ¶ Undocumented, consider contributing . 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. polybuild_transform_at_cursor_move ( * , MESH_OT_polybuild_transform_at_cursor = None , TRANSFORM_OT_translate = None ) ¶ Undocumented, consider contributing . Parameters : MESH_OT_polybuild_transform_at_cursor ( MESH_OT_polybuild_transform_at_cursor , (optional)) – Poly Build Transform at Cursor TRANSFORM_OT_translate ( TRANSFORM_OT_translate , (optional)) – Move, Move selected items bpy.ops.mesh. primitive_circle_add ( * , vertices = 32 , radius = 1.0 , fill_type = 'NOTHING' , 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 circle mesh Parameters : vertices ( int in [ 3 , 10000000 ] , ( optional ) ) – Vertices radius ( float in [ 0 , inf ] , ( optional ) ) – Radius fill_type (enum in [ 'NOTHING' , 'NGON' , 'TRIFAN' ], (optional)) – 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