> For the complete documentation index, see [llms.txt](https://help.clabassistant.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.clabassistant.com/manage-a-project/preview-tools.md).

# Preview Tools

The preview lets you inspect your pattern, compare pieces, and work with measurements. Available tools depend on your active subscription and the current project state.

## Navigate and arrange pieces

Use the mouse wheel or zoom buttons to zoom. Hold **Space** and drag to pan. Press **A** to fit the pattern in view and exit the zoom tool.

Press **Z**, then click a piece or drag a rectangle to zoom to it. Press **Z** again or **Esc** to exit. An area zoom exits the tool when you release the mouse.

The hint bar shows the next action for the active tool.

### More zoom controls

* Click the same piece again to zoom in another step, or a different piece to zoom to it.
* Hold **Alt** and click to zoom out.
* While drawing a zoom rectangle, hold **Space** and drag to reposition it.

Measurement lines cannot be selected while the zoom tool is active.

## Choose the scene orientation

In [User Preferences](https://help.clabassistant.com/getting-started/main-menu.md#user-preferences), open **Scene orientation** and choose **Standard** or **90° clockwise** separately for **Editor** and **Grading**.

This changes the view of the whole layout, including its measurement lines. It does not change pattern dimensions or saved grading rules. To rotate individual pieces instead, use **R** or **Align…** as described below.

## Select and rotate pieces

Drag pieces to arrange them. Right-click a piece for transformations, including horizontal and vertical flips.

Hold **Shift** and click a piece to add it to the selection. Repeat on a selected piece to remove it. Once at least one piece is selected, press **Ctrl/Cmd + A** to select all visible pieces.

Click empty preview space or press **Esc** to clear the piece selection, including in Grading mode. **Esc** keeps Grading active. If a tool is active, **Esc** exits that tool first.

Press **R** to rotate the selected pieces clockwise by 90°. Each piece rotates around its own center. If no pieces are selected, **R** rotates the piece under the pointer.

These controls also work in Grading mode. **Shift + click** on the body of a piece selects the piece; **Shift + click** on a grading point continues to select grading points.

## Align a piece horizontally

1. Right-click the piece and choose **Align…**.
2. Click the first point.
3. Hover a different valid point. A yellow line and its two endpoints show the proposed alignment.
4. Click the second point to align the line horizontally, with the second point to the right of the first.

Alternatively, after activating **Align…**, hover a contour segment or a visible internal-line segment. The segment turns yellow. Click it to align the piece using that segment's endpoints.

The piece rotates around the same center used by **R**. The yellow guide disappears when you confirm the alignment. Press **Esc** to cancel. Align also works in Grading mode and on reflected pieces.

## Arrange pieces without overlaps

Press **Ctrl/Cmd + Alt + X** to arrange all visible pieces with space between them. The command changes their placement while preserving their rotations and flips.

In Grading mode, the arrangement accounts for the geometry of the sizes currently displayed, including visible internal and construction lines. If you change the displayed sizes or geometry and need more room, run the command again.

## Reset piece placement

* Hover a piece and press **Ctrl/Cmd + X**, or right-click it and choose **Reset piece position**, to restore that piece's original position and orientation.
* Press **Alt + X**, or right-click empty space and choose **Reset piece positions**, to restore all pieces.

These resets also work in Grading mode. Grading rules edited after a rotation remain consistent with the restored orientation.

## Right-click menus

Right-click an empty area of the preview to access **Zoom all** and **Reset piece positions**. The menu also provides **Grading mode** when available; its availability depends on your subscription and the current project state. In Grading mode, use **Exit grading mode** to leave it.

Right-click directly on a piece to access its available actions. Right-clicking empty space opens the general preview menu, even if a piece was previously hovered or selected.

While measuring or walking pieces, the menu includes the corresponding **Exit** action. Available keyboard shortcuts appear beside the menu commands. In Grading mode, right-click a grading point to access its [grading actions](https://help.clabassistant.com/size-grading/grading-rules.md#copy-and-paste-grading-rules).

## Choose what to display

Use the preview controls to show or hide measurement lines and labels, display full pieces, and access the available point labels. In **Preview Options**, choose whether to show the block pattern, construction lines, internal lines, construction points, notches, and grainlines.

When you hide notches, their base points remain visible only if they are turn points or construction points you have chosen to show. Editing mode always shows all points.

## Measure in the preview

Measurement tools are included for all workspaces.

1. Select **Measure** in the preview toolbar.
2. Select the points or segments you want to measure, following the hint bar.
3. Read the result in the measurement panel.

Hold **Shift** while selecting points to add extra points. Use **Tab** or **Shift + Tab** to cycle nearby snap points. The measurement panel supports adding and subtracting measurements and applying a multiplication or division factor.

When a sizes table is available for a measurement entry, choose **Show sizes table** to compare its values across sizes. The table includes length, X/Y differences, and available comparisons. Use **Toggle add/subtract table** when offered to review combined measurements by size.

Press **X** to reset the current measurement points, or **Esc** to exit the tool.

## Walk pieces

Use **Walk pieces** from the piece context menu to compare pieces along their contours. Follow the preview hints to select and move along the relevant geometry. Use **Esc** to exit the tool.

## Download the preview

Select **Download preview SVG** to save the preview as an SVG file. For CAD pattern downloads, use [Generate Pattern](https://help.clabassistant.com/getting-started/generate-pattern.md).

## Capture and annotate a screenshot

When available in your workspace, use **Capture preview** to take a PNG screenshot of the current preview. Arrange the pieces and set the view before capturing. The shortcut is **Ctrl + Alt + H** on Windows or **Cmd + Option + H** on macOS.

The thumbnail offers **Copy screenshot**, **Download screenshot**, **Edit screenshot**, and a dismiss action. Copying lets you paste the image into another application; if clipboard access is unavailable, download it instead.

Choose **Edit screenshot** to open the image editor:

1. Add **Text**, **Arrow**, **Line**, **Rectangle**, or **Circle / ellipse** annotations.
2. Use **Select and resize** to move or resize annotations. Adjust their color and stroke width as needed; use **Delete annotation** to remove a selection.
3. Use **Crop** to draw a crop area, then **Confirm crop** or **Cancel crop**.
4. Use **Undo** and **Redo** to revise your annotations and crop. **Move preview**, zoom controls, and **Fit image** help you inspect the image.
5. Choose **Save**, then **Copy PNG** or **Download PNG** to keep the annotated result. If downloading with unsaved changes, choose **Save and continue** to include them, or **Continue without saving** to download the last saved PNG.

Annotations and cropping affect the screenshot only. They do not edit the pattern, measurements, or CAD files. Download or copy the result before leaving; screenshots are not saved as Pattern Versions.

## Keyboard shortcuts

Press **Ctrl + Alt + 7** on Windows or **Cmd + Option + 7** on macOS to open the keyboard shortcuts reference. It groups shortcuts by tool and explains when each action is available.

For grading tools, see [Grading Rules](https://help.clabassistant.com/size-grading/grading-rules.md).

## Edit pattern points

Use **Enable editing** to adjust the available **Turn points** and **Curvature points** on an editable pattern. See [Edit Pattern Points](https://help.clabassistant.com/manage-a-project/manual-editing.md) for selection, movement, and reset instructions.

## Compare with a reference

When available, **Preview comparison** lets you overlay a captured preview, another saved project, or an imported DXF. See [Compare Pattern Previews](https://help.clabassistant.com/manage-a-project/preview-comparison.md) for project selection, units, alignment, visibility, and temporary-reference behavior.
