diff --git a/manual/images/modeling_meshes_tools-extrude_boolean-intersection_open.gif b/manual/images/modeling_meshes_tools-extrude_boolean-intersection_open.gif new file mode 100644 index 000000000..db8c9a129 --- /dev/null +++ b/manual/images/modeling_meshes_tools-extrude_boolean-intersection_open.gif @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:82bb32e94c2774f9301f46b16e79567847d60aa507551a43458ff8388cd160ec +size 1633889 diff --git a/manual/images/modeling_meshes_tools-extrude_boolean-intersection_wires.gif b/manual/images/modeling_meshes_tools-extrude_boolean-intersection_wires.gif new file mode 100644 index 000000000..18a9b8d63 --- /dev/null +++ b/manual/images/modeling_meshes_tools-extrude_boolean-intersection_wires.gif @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:83e50952c0be7f5028de7e7304853fdd4e7aeb6374b78c667dab49e7954c2015 +size 374354 diff --git a/manual/images/modeling_meshes_tools-extrude_boolean-subtract.gif b/manual/images/modeling_meshes_tools-extrude_boolean-subtract.gif new file mode 100644 index 000000000..9979d1c19 --- /dev/null +++ b/manual/images/modeling_meshes_tools-extrude_boolean-subtract.gif @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5bdeb7bc9124a1eac0a78041308e7f4fef73d80d8949c5b0285f787952be0133 +size 1158098 diff --git a/manual/images/modeling_meshes_tools-extrude_boolean-union.gif b/manual/images/modeling_meshes_tools-extrude_boolean-union.gif new file mode 100644 index 000000000..2511a1431 --- /dev/null +++ b/manual/images/modeling_meshes_tools-extrude_boolean-union.gif @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1ee789e4b416ac349e91ff497d5cb9bf2c30e045f15d25f458d0e97d543932b4 +size 4150346 diff --git a/manual/modeling/meshes/editing/mesh/extrude.rst b/manual/modeling/meshes/editing/mesh/extrude.rst index 2ba22f81a..e743c8b4a 100644 --- a/manual/modeling/meshes/editing/mesh/extrude.rst +++ b/manual/modeling/meshes/editing/mesh/extrude.rst @@ -62,6 +62,14 @@ Available when a :term:`Vertex` is selected. See :ref:`bpy.ops.mesh.extrude_vertices_move`. +Extrude Boolean +=============== + +Available in any selection mode. + +See :doc:`/modeling/meshes/tools/extrude_boolean`. + + .. _bpy.ops.mesh.extrude_repeat: Extrude Repeat diff --git a/manual/modeling/meshes/tools/extrude_boolean.rst b/manual/modeling/meshes/tools/extrude_boolean.rst new file mode 100644 index 000000000..306612a0e --- /dev/null +++ b/manual/modeling/meshes/tools/extrude_boolean.rst @@ -0,0 +1,54 @@ +.. _bpy.ops.view3d.edit_mesh_extrude_boolean_move_normal: + +**************** +Extrude Boolean +**************** + +.. reference:: + + :Mode: Edit Mode + :Tool: :menuselection:`Toolbar --> Extrude Boolean` + :Menu: :menuselection:`Mesh --> Extrude --> Extrude Boolean` + +This tool is similar to :doc:`/modeling/meshes/editing/face/extrude_faces` +but before generating the geometry, it displays a preview mesh that will perform boolean +operations on the original mesh once confirmed. + + +Properties +---------- + +Overlap Threshold + Threshold for checking overlapping geometry. +Invert + Removes outside faces instead of inside faces. +Remove coplanar faces + Determines what to do with overlapping faces. + + +Example +------- + +Geometry subtraction: + +.. figure:: /images/modeling_meshes_tools-extrude_boolean-subtract.gif + + Extrude Boolean - Geometry subtraction example. + +Geometry union: + +.. figure:: /images/modeling_meshes_tools-extrude_boolean-union.gif + + Extrude Boolean - Geometry union example. + +Open geometry intersection: + +.. figure:: /images/modeling_meshes_tools-extrude_boolean-intersection_open.gif + + Extrude Boolean - Open geometry intersection example + +Wire edge intersection: + +.. figure:: /images/modeling_meshes_tools-extrude_boolean-intersection_wires.gif + + Extrude Boolean - Wire edge intersection example. diff --git a/manual/modeling/meshes/tools/index.rst b/manual/modeling/meshes/tools/index.rst index 3dd94eace..fc79573d1 100644 --- a/manual/modeling/meshes/tools/index.rst +++ b/manual/modeling/meshes/tools/index.rst @@ -18,6 +18,7 @@ Types extrude_region.rst extrude_manifold.rst + extrude_boolean.rst extrude_cursor.rst loop.rst poly_build.rst