# Navigating the Viewports

This guide provides a detailed overview of the interactive **Input** and **Output** viewports within the Texture Tools plugin. Understanding these UIs is key to efficiently managing your textures, previewing results, and using advanced features like inpainting and 3D material previews.

## 1. The Anatomy of a Texture Viewer

The foundation of the viewport is the **Texture Viewer**, a self-contained panel for displaying a single texture. Both the Input and Output areas are composed of one or more of these viewers.

<figure><img src="/files/0BVjO5hwQV4j5rYotbRN" alt=""><figcaption></figcaption></figure>

### Header Controls

At the top of each viewer, you'll find a set of utility buttons:

* **Add/Use/Find Buttons (Input Only):**
  * **Plus Icon:** Opens a Content Browser window to let you select a texture.
  * **Arrow Icon:** Uses the texture currently selected in the main Content Browser.
  * **Magnifying Glass Icon:** Locates the currently loaded texture in the Content Browser.
* **Tile Preview:** A numeric box that lets you tile the texture preview (e.g., a value of 2 will show the texture tiled 2x2). This is for preview only and does not affect the output.
* **Channel Toggles (R, G, B, A):** These buttons allow you to isolate and view individual color or alpha channels. This is extremely useful for inspecting masks and packed PBR textures.
* **Zoom Control:** Shows the current zoom percentage. Click it for preset zoom levels or use the **Mouse Wheel** over the image to zoom in and out.

### Interacting with the Viewer

* **Zoom:** Use the **Mouse Wheel** while your cursor is over the image.
* **Pan:** Use the scroll bars to the Bottom and Right to pan the image when zoomed in.
* **Remove Texture (Input Only):** **Right-click** on the image to clear the input slot.

## 2. Viewport Display Modes

Above both the Input and Output viewports is a segmented control that lets you switch between different display modes. The available modes change depending on the currently selected job.

<figure><img src="/files/dR6K372sjYxwanleMXt0" alt=""><figcaption><p>The AI Generation Job has the most view mode types</p></figcaption></figure>

### Grid View

This is the default view. It displays all available input or output texture viewers in a grid layout. This mode is excellent for seeing all your textures at a glance, especially when working with jobs that have multiple inputs like the **Channel Packer**.

<figure><img src="/files/VpWfqUrVgrGONqG5eB5f" alt=""><figcaption><p>Channel Packer Grid Input View</p></figcaption></figure>

### Carousel View

This mode displays only one texture viewer at a time, allowing you to focus on a single image.

* **Navigation:** Use the **<** and **>** arrow buttons below the viewer to cycle through the available textures.
* **Breadcrumbs:** The row of dots between the arrows indicates which texture you are currently viewing. You can also click on a dot to jump directly to that texture.

<figure><img src="/files/VVH5h1TvKenRcFeAaI9t" alt=""><figcaption><p>Channel Packer Carousel Input View</p></figcaption></figure>

### 3D Material View (Output Only)

This mode is available for the **Output** viewport when using a job that generates PBR textures, such as the **AI Generation** job. It allows you to preview your generated material on a 3D mesh in a fully lit environment.

* **Camera Controls:**
  * **Orbit:** Hold the **Left Mouse Button** and drag to orbit the camera around the mesh.
  * **Zoom:** Use the **Mouse Wheel** to zoom in and out.
  * **Pan:** Hold the **Middle Mouse Button** and drag to pan the camera.
* **Toolbar Controls:**
  * **Preview Mesh:** Use the radio buttons to switch between a **Sphere**, **Cube**, **Plane**, and **Cylinder**.
  * **Tile Preview:** Adjust the tiling of the material on the preview mesh.

<figure><img src="/files/nOVhtZB75NLaHjGPnI0l" alt=""><figcaption></figcaption></figure>

### Draw Mask View (Input Only)

This special mode is only available for the **Input** viewport when an **AI Generation** job is selected. It is used for inpainting. For a detailed guide on how to use its specific tools, please refer to the ["User Guide: Inpainting with the Draw Mask Canvas".](/assets-and-plugins/texture-tools/how-to-use-5.4+/ai-generation-job-overview/inpainting-with-the-draw-mask-canvas.md)

<figure><img src="/files/bHeWl9qsZAWDluw6KeAn" alt=""><figcaption></figcaption></figure>


---

# 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.shadersource.io/assets-and-plugins/texture-tools/how-to-use-5.4+/navigating-the-viewports.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.