> For the complete documentation index, see [llms.txt](https://2yeet.gitbook.io/anvilcsg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://2yeet.gitbook.io/anvilcsg/geometry/face-edge-vertex.md).

# Face, edge, and vertex editing

Component tools change the shape of an existing convex brush. Anvil rejects edits that would produce invalid or non-convex geometry.

Use these shortcuts:

* Face: `Shift+F`
* Edge: `Shift+D`
* Vertex: `Shift+V`

In Perspective, picking prefers visible components close to the camera. Edges and vertices use a practical screen-space hit area so they do not need to be clicked on a single pixel.

## Face editing

Select the Face tool, then click and drag a face.

* Drag along its normal to push or pull it.
* Drag sideways to shear it.
* Hold `Ctrl/Cmd` or `Shift` to toggle several faces.
* Faces from different brushes can be selected together.

### Faster face selection

Double-click first looks for a multi-brush opening boundary near the cursor. This is useful around a carved door, window, or arch.

If no opening is found, double-click selects a face strip on the current brush.

The Face context menu also provides:

* **Connected Faces**
* **Coplanar Faces**
* **Same Material**

### Face materials and UVs

The Face context menu provides:

* **Material > Apply Current Material**
* **Material > Pick Material**
* **UV > Fit Texture**
* **UV > Align From Neighbor**
* **UV > Reset**
* **UV > Options...**

Full material and UV workflows are covered in the Materials and UV sections.

### Bridge

Bridge requires exactly two compatible, non-coplanar faces.

1. Select the two faces.
2. Open the Face context menu.
3. Choose **Modify > Bridge**.

Anvil creates a new convex brush between them and keeps both source brushes.

## Edge editing

Select the Edge tool, then click and drag a visible edge. Hold `Ctrl/Cmd` or `Shift` to toggle several edges.

`Shift+right click` toggles an edge in Perspective. A right-button drag still controls fly-look, so click without dragging when changing the selection.

### Faster edge selection

Double-click first looks for the exposed boundary around touching coplanar brushes. This can select the border of a carved opening across several brushes.

If no opening boundary is found, double-click selects a straight edge chain.

The Edge context menu provides:

* **Loop** follows straight continuation.
* **Ring** crosses opposite edges through faces.
* **Connected** selects every edge on the current brush.

### Edge Bevel

Choose **Modify > Bevel** from the Edge context menu.

The bevel window provides:

* Width
* 1 to 8 segments
* Live preview

Edge Bevel supports several selected edges and brushes. Unsafe widths are clamped. If any result fails, all affected brushes are restored instead of leaving a partial edit.

New bevel faces align their UVs from neighboring surfaces.

## Vertex editing

Select the Vertex tool, then click and drag a visible vertex. Hold `Ctrl/Cmd` or `Shift` to toggle several vertices.

`Shift+right click` toggles a vertex in Perspective.

In an orthographic pane, visible vertex dots are shown across the map even when no brush is selected. Hold Shift and left-drag a marquee to select every vertex inside it across multiple brushes. This is a through-selection, so vertices at the same screen position behind other geometry are included.

### Faster vertex selection

Double-click first looks for a multi-brush opening boundary. If no opening is found, it selects a straight vertex line on the current brush.

The Vertex context menu provides:

* **Snap To Grid**
* **Merge At Center**
* **Connected**

**Merge At Center** moves the selected vertices to their shared center. The result is accepted only if the brush remains valid and convex.

## Selection behavior

Face, Edge, and Vertex modes show component selection without using the full object tint from normal Select mode.

Vertex marquee selection also updates the owning brush selection, making it clear which brushes will be affected by a multi-brush edit.

If a drag would collapse a face, invert geometry, or make a brush non-convex, Anvil rejects the result. Use a smaller movement, change fewer components, or split the shape into several convex brushes.

## Generated shapes

Generated stairs, arches, arcs, and cylinders are controlled by their wrapper settings. Direct edits to generated child geometry can be overwritten the next time the wrapper rebuilds.

For a permanent custom shape, build it from ordinary convex brushes or use CSG tools where suitable.