| … | … | @@ -740,22 +740,34 @@ drawing, modifiers while drawing, and stack / cutter housekeeping. Survey of wha |
| 740 | 740 | The mouse is the camera in every builder tool, so "drawing" means aiming, as in the create |
| 741 | 741 | and curve tools. Phases: |
| 742 | 742 | |
| 743 | **KEYS FOLLOW BOXCUTTER'S MANUAL** (user 2026-10-18: "are we sticking to the blender |
| 744 | hotkeys"; boxcutter-manual.readthedocs.io/en/latest/hotkeys). BoxCutter is an add-on, |
| 745 | so these are its keys, not Blender core's. They are TOOL-LOCAL: outside the tool, X is |
| 746 | still delete, B box select, S scale, G grab and Shift+R repeat, as in Blender. |
| 747 | |
| 743 | 748 | 1. **Footprint.** |
| 744 | | - Tab cycles rect / circle / ngon / polygon. |
| 745 | | - S cycles the surface: |
| 746 | | - the aimed face (default); |
| 747 | | - the view plane through the 3D cursor; |
| 748 | | - the cursor's own plane; |
| 749 | | - the world grid at the cursor's height. |
| 749 | - **D** opens the tool's menu (BoxCutter's pie). It holds: |
| 750 | - the shape: box (default) / circle / ngon / custom polygon; |
| 751 | - the surface: |
| 752 | - the aimed face (default); |
| 753 | - the view plane through the 3D cursor; |
| 754 | - the cursor's own plane; |
| 755 | - the world grid at the cursor's height; |
| 756 | - taper and wedge (§13.4). |
| 750 | 757 | - LMB / P sets the first corner (or the centre); the aim drags the other, snapped to |
| 751 | | the grid on that plane. |
| 758 | the grid on that plane. Alt draws from the centre, Shift draws a square (BoxCutter's |
| 759 | center / uniform draw). |
| 752 | 760 | - For polygon, P adds points and Backspace removes one. |
| 753 | | - [ ] steps ngon sides, or circle segments. |
| 761 | - [ ] (or the wheel) steps ngon sides, or circle segments. |
| 762 | - **Tab** pauses the shape for fine edits (BoxCutter's pause): the aim stops dragging. |
| 754 | 763 | 2. **Depth.** |
| 755 | | - The default is THROUGH (§13.3). |
| 756 | | - [ ] steps it in grid units; 0 = back to through. |
| 757 | | 3. **Offset** (optional): [ ] slides the footprint along the normal (cut-in from above the |
| 758 | | surface). Enter commits from any phase. |
| 764 | - **E** enters extrude: [ ] steps the depth in grid units. |
| 765 | - **Space** before E confirms THROUGH (§13.3; BoxCutter's lazorcut). Through is also the |
| 766 | default when the depth was never set. |
| 767 | 3. **Offset.** **O** enters offset: [ ] slides the footprint along the normal (cut-in from |
| 768 | above the surface). |
| 769 | |
| 770 | LMB or Space confirms from any phase. Esc / RMB cancels. |
| 759 | 771 | |
| 760 | 772 | **Commit = ONE gesture:** |
| 761 | 773 | - `shape.create {type: prism}` for the cutter; |
| … | … | @@ -765,8 +777,8 @@ and curve tools. Phases: |
| 765 | 777 | |
| 766 | 778 | One Ctrl+Z undoes all of it. |
| 767 | 779 | |
| 768 | | Key: Shift+B opens the tool (Blender's BoxCutter is a tool, not a menu). keymap_gate |
| 769 | | checks for collisions. |
| 780 | Key: **Alt+W** starts the tool (BoxCutter's own; free here). keymap_gate checks for |
| 781 | collisions. |
| 770 | 782 | |
| 771 | 783 | ### 13.3 Through-depth |
| 772 | 784 | |
| … | … | @@ -778,22 +790,31 @@ checks for collisions. |
| 778 | 790 | |
| 779 | 791 | ### 13.4 Modes and modifiers while drawing |
| 780 | 792 | |
| 781 | | - **X cycles the mode:** subtract → slice → intersect → inset → outset. In inset/outset, |
| 782 | | [ ] edits that mode's depth when focused (Tab). |
| 783 | | - **Extract** is a Q-menu row on a cut op, not part of the draw: |
| 784 | | - each intersect piece (target ∩ cutter) becomes a new `hull` shape; |
| 785 | | - those shapes go into a new collection "Extract"; |
| 786 | | - they are ordinary shapes, ready to be used as cutters. |
| 787 | | - **Modifier keys while drawing** queue `mod.create` records on the cutter: |
| 788 | | - B chamfer; |
| 789 | | - V array (Shift+V radial about the cursor); |
| 790 | | - 1 / 2 / 3 mirror X / Y / Z; |
| 791 | | - G grid. |
| 793 | - **Modes, as BoxCutter:** |
| 794 | - the default is subtract (BoxCutter's cut); |
| 795 | - **X** cycles slice → intersect → inset → outset → subtract (BoxCutter: X slice, X X |
| 796 | intersect, X X X inset); |
| 797 | - **I** jumps straight to inset. |
| 798 | - Outset has no BoxCutter key. It sits after inset in the cycle. BoxCutter's J (join, a |
| 799 | union) has no counterpart here, and is not bound. |
| 800 | - In inset/outset, [ ] edits that mode's depth. |
| 801 | - **Extract: Y** while drawing (BoxCutter's key), and a Q-menu row on a cut op. |
| 802 | - Each intersect piece (target ∩ cutter) becomes a new `hull` shape. |
| 803 | - Those shapes go into a new collection "Extract". |
| 804 | - They are ordinary shapes, ready to be used as cutters. |
| 805 | - **Modifier keys while drawing** (BoxCutter's) queue `mod.create` records on the cutter: |
| 806 | - **B** chamfer: the wheel or [ ] steps segments; |
| 807 | - **V** array, **V V** radial about the cursor; |
| 808 | - **1 / 2 / 3** mirror X / Y / Z; **Shift+1/2/3** flips that mirror's side; |
| 809 | - **Shift+G** grid. BoxCutter binds no grid key, and G is grab; #120 lists Shift+G. |
| 792 | 810 | |
| 793 | 811 | The queue shows on the status line; pressing the same key again removes it. ModFold |
| 794 | 812 | already copies a cutter's pieces with `cutter: true`, so a mirrored cutter cuts |
| 795 | 813 | mirrored holes. |
| 796 | | - **T** steps taper and **Shift+T** steps shear (the wedge): prism params, §13.1. |
| 814 | - **Taper and wedge** are values in the D menu (prism params, §13.1). BoxCutter binds no |
| 815 | taper key, and its T is solidify, which is out of scope, so T is left unbound. |
| 816 | - **L** toggles the new op on/off before commit (BoxCutter's live toggle). Cuts here are |
| 817 | live already, so BoxCutter's Shift+confirm "keep live" needs no key. |
| 797 | 818 | |
| 798 | 819 | ### 13.5 Housekeeping |
| 799 | 820 | |
| … | … | @@ -823,7 +844,8 @@ checks for collisions. |
| 823 | 844 | 2. Through-depth function: `gate_cut_through` (slab, stepped target, two targets). |
| 824 | 845 | 3. The tool, rect on a face, mode X, commit as one gesture: `gate_box_cutter`. |
| 825 | 846 | 4. Footprints circle / ngon / polygon and surfaces view / cursor / grid: `gate_box_cutter` B-checks. |
| 826 | | 5. Modifier keys while drawing, plus T / Shift+T: `gate_box_cutter` M-checks. |
| 847 | 5. Modifier keys while drawing (B, V / V V, 1/2/3 + Shift, Shift+G), Y extract, L, and the D |
| 848 | menu's taper / wedge: `gate_box_cutter` M-checks. |
| 827 | 849 | 6. Whole-selection targets, the Cutters collection, repeat: `gate_box_cutter` H-checks. |
| 828 | 850 | 7. Q menu Change cut, Extract, Apply up to here: `gate_q_stack`. |
| 829 | 851 | 8. Stack scroll preview: `gate_q_stack` S-checks. |