# Canvas mode

While working in Canvas mode, you can control your view of a semantic model and its elements by using layout modes, the cards legend, node expand and collapse controls, the canvas toolbar, and cube resizing.

## Layout mode

Layout modes are applied to each cube, individually, so that you can use one layout mode for one cube and a different layout mode for another cube.&#x20;

<table><thead><tr><th width="164.2222900390625">Layout mode </th><th>Description </th></tr></thead><tbody><tr><td>Star Layout mode </td><td>Automatically arranges nodes in a star shape around the cube’s fact table and resizes the cube to fit all elements. You can enable Star Layout mode by clicking the Layout icon in the cube. The Star Layout mode is enabled by default in new cubes. </td></tr><tr><td>Free Layout Mode </td><td>Maintains the cube’s size and the position of other elements in the cube when a new element is added to the cube, or an element is moved around the cube. You can enable Free Layout mode by resizing a cube or moving an element in the cube. </td></tr></tbody></table>

## **Legend**

The Legend shows the meaning of the outline color for cards on the canvas so that you can identify the card type without reading the text on the card. Open and close the Legend by taking the following actions:&#x20;

* To show the Legend, next to the model's name, click the **More Actions** icon and select **Legend**. &#x20;
* To hide the Legend, click the **Close** icon in the top, right corner of the Legend.&#x20;

## Canvas toolbar

Move around the canvas while working with a semantic model by using the following options in the canvas toolbar:&#x20;

<table><thead><tr><th width="173.9998779296875">Option </th><th>Description </th></tr></thead><tbody><tr><td>Zoom In </td><td>Enlarges the size of the semantic model on the canvas so that you can see more details of individual elements in the model. </td></tr><tr><td>Zoom Out </td><td>Decreases the size of the semantic model on the canvas so that you can see more elements in the model at the same time, with less detail for individual elements. </td></tr><tr><td>Fit View </td><td>Resizes the semantic model and centers it on the canvas so that you can see as many elements in the model at the same time as possible. Whether the entire model can fit in the view depends on the size of the model. </td></tr><tr><td>Interactive </td><td>Locks and unlocks the canvas to control whether elements can be moved on the canvas. Interactive mode is unlocked by default.</td></tr><tr><td>Arrange Layout </td><td>Rearranges the top-level elements of a model, like cubes and shared dimensions, so that those elements do not overlap on the canvas. The arrangement of elements inside a top-level element, such as dimensions and measures inside a cube, is not changed.  </td></tr><tr><td>Hide All Edges or Show All Edges </td><td>Hides or shows the connections between different nodes inside cubes in the model. Hide cube edges to reduce visual noise when working with large semantic models that have a lot of cube edges. </td></tr></tbody></table>

## **Node expand and collapse**

Collapse and expand nodes to control how much node information is displayed in a cube by taking the following actions:&#x20;

* To collapse or expand a single node, next to the node’s name, click the **Collapse** icon or **Expand** button.
* To collapse or expand all nodes in a cube, in the cube toolbar, click the **Collapse All Nodes** icon or **Expand All Nodes** icon.&#x20;

## **Cube resizing**

To resize a cube, hover over the bottom, right corner of the cube until you see a double-sided arrow, and then click and drag to make the cube bigger or smaller.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentaho.com/pba/semantic-model-editor/canvas-mode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
