# User Interface

## Introduction

**Durty Cloth Tool** provides a clean and straightforward interface designed to streamline the process of managing and creating GTA 5 addon clothing packs. Below is a breakdown of the various elements within the user interface to help you get started.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FzxudDvLhuZoWbSIBOvna%2Fimage.png?alt=media&#x26;token=733e7cb8-b1b1-48c1-b56c-e996ad5f9fc0" alt=""><figcaption><p>Durty Cloth Tool UI Overview</p></figcaption></figure>

## Top Navigation Bar

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FjQ1r0YPSPfwlkM29UQqE%2Fimage.png?alt=media&#x26;token=f1f0b65b-58a8-4645-b799-8a6a824516b1" alt=""><figcaption><p>Durty Cloth Tool Top Navigation Bar</p></figcaption></figure>

The top navigation bar contains several important tools for managing projects and configuring settings. Here's an overview of each element:

* **Project**: This menu provides options for creating a new project, saving, opening existing projects, and exporting them. The status of the project, such as "saved," is also displayed in the window title. See [durty-cloth-projects](https://docs.gta.clothing/basics/useful-to-know/durty-cloth-projects "mention") for Cloth Project related details.
* **Options**: Access global settings for the tool. This includes preferences for the working environment, such as the 3D previewer and more.\
  See [app-and-project-settings](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings "mention") for App Options and Project Settings related details.
* **View**: This grants quick access to open different views such as the Logs or Error List window for example. See their individual documentations for more details.
* **Help**: Find useful links and information such as the Website, Documentation, How to Register the License or general License Info.
* **Right Side Status**: Indicates DCT Version and whether it recognized a license. Clicking on it will also open the License Info.

## Main Workspace Area

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fn9mpQJqw5znEsKKac78H%2Fimage.png?alt=media&#x26;token=e16fea55-030c-4e68-9abe-f48bafd8e9a6" alt=""><figcaption><p>Durty Cloth Tool Main Workspace Area</p></figcaption></figure>

The workspace area is divided into multiple sections:

### Left Section - **Appearance Items List**

This is where the cloth drawables (clothing models), tattoos and more are managed. You can search, add, and remove these items from the project here.

* :mag: **Search bar**: The search bar allows users to quickly filter items by entering search terms.\
  See [integrated-search](https://docs.gta.clothing/basics/good-to-know/integrated-search "mention") for more details.
* :card\_box: **Import Package**: Import existing packages containing multiple drawables, streamlining the workflow.\
  See [import-and-export-formats](https://docs.gta.clothing/basics/useful-to-know/import-and-export-formats "mention") for more details.
* **Add options**:

  * :transgender\_symbol: **Add**: Add a new item automatically or for both gender.
  * :man: **Add Male**: Add male-specific cloth drawables or tattoos.
  * :woman: **Add Female**: Add female-specific cloth drawables or tattoos.

  *See below for details on the different add options.*
* 🗑️ **Remove**: Delete selected appearance item(s) from the project.

#### Available Add Options

* **Add from DCT package:** If available this is always the best option to add anything, as it will contain all information of one or multiple items, including textures and additional naming information.
* **Add from file(s):** This will open a file picker dialog that allows for selecting one or multiple files to add them to the current cloth project.
* **Add from folder(s):** This will open a folder picker dialog that allows for selecting one or multiple folders that will be recursively searched for any files that can be added.
* **Add tattoo:** This will add any texture / image file as a tattoo to the project for either a specific gender or both genders.\
  See [addon-tattoos](https://docs.gta.clothing/basics/good-to-know/addon-tattoos "mention") for more details.
* **Add reservation dummy:** This will allow for adding a dummy / placeholder clothing drawable for a specific gender.\
  **See** [placeholders-dummy-ids](https://docs.gta.clothing/basics/good-to-know/placeholders-dummy-ids "mention") for more details.

{% hint style="warning" %}
Add from files/folders option in the ":transgender\_symbol: **Add**" dropdown will only work when the given file names contain gender information (like the multiplayer ped name).
{% endhint %}

{% hint style="info" %}
**Like the default windows file and folder picker more?** You can switch to the legacy windows file explorer using a option in the App Options window.
{% endhint %}

### Right Section - Item **Details**

This is where detailed information about the selected item appears. Once a drawable or tattoo is selected from the list, its attributes and properties can be modified in this panel.

{% hint style="info" %}
As the options here differ depending on what kind of item is selected and what type of drawable it is, please refer to individual features documentation on the left side.
{% endhint %}

### Reorder Cloth Drawable Textures via Drag and Drop

It is possible to conveniently reorder Cloth Texture Variations using drag and drop. In order to do so grab the texture you want to reposition in the same Cloth Drawable and reposition it.

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2F9KqVZdZ4tKPoMNSWKxrm%2FDCT-ReorderTextures.gif?alt=media&#x26;token=d18106e2-877a-49c8-93bf-d74998686464" alt=""><figcaption><p>Reordering Cloth Texture Variations via Drag and Drop in Durty Cloth Tool</p></figcaption></figure>

## Context Menu Options

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2FZ9id5nKeIpMEVIUo7Xns%2Fimage.png?alt=media&#x26;token=0afeaf19-ce92-49c3-bf2a-c190f64c8417" alt=""><figcaption><p>Showcase of the various Context Menu Options available in DCT</p></figcaption></figure>

Durty Cloth Tool provides a wide range of **Context Menu Options** to streamline workflow and provide quick access to essential actions. These options are available by right-clicking on **appearance items** in the left panel or **cloth texture variations** in the texture list. Below is a breakdown of the available actions:

### **Context Menu Options for Appearance Items**

| **Action**                                                                                                   | **Description**                                                                                   | **Shortcut** |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | ------------ |
| **Remove**                                                                                                   | Deletes the selected appearance item without removing the actual `.ydd` file on disk.             | `Del`        |
| **Replace**                                                                                                  | Replaces the source file with a new updated file, useful for updating models with fixed versions. | `Ctrl+H`     |
| **Replace with Dummy**                                                                                       | Replaces the appearance item with a dummy file to prevent drawable ID shifts.                     | `Ctrl+J`     |
| **Create Copy for Other Gender**                                                                             | Duplicates the selected clothing and its textures for the opposite gender.                        | -            |
| **Show in Windows Explorer**                                                                                 | Opens the file's location in Windows Explorer.                                                    | `Ctrl+E`     |
| **Export as DCT Package**                                                                                    | Exports the appearance item as a Durty Cloth Tool-compatible package.                             | -            |
| **Export**                                                                                                   | Creates a copy of the source file and exports it to a desired location.                           | -            |
| **Export with Textures**                                                                                     | Exports the source file along with all its textures.                                              | -            |
| **Export XML**                                                                                               | Exports the appearance item in XML format, compatible with tools like CodeWalker.                 | -            |
| **Export Textures as DDS**                                                                                   | Exports all embedded textures in DDS format.                                                      | -            |
| **Export Textures as PNG**                                                                                   | Exports all embedded textures in PNG format.                                                      | -            |
| [material-editor](https://docs.gta.clothing/basics/good-to-know/material-editor "mention")                   | Opens the Material Editor for the selected drawable to view and edit shader and parameters.       | -            |
| [embedded-textures-editor](https://docs.gta.clothing/basics/good-to-know/embedded-textures-editor "mention") | Opens the editor to view/replace/rename/delete embedded textures and auto-fix shader params.      | -            |
| **Copy Name**                                                                                                | Copies the displayed name of the appearance item.                                                 | -            |
| **Copy Game Name**                                                                                           | Copies the appearance item's name in the format used by the game.                                 | -            |
| **Copy File Path**                                                                                           | Copies the file path of the selected appearance item.                                             | -            |
| **Optimize Embedded Textures**                                                                               | Opens options to optimize textures embedded in the model automatically.                           | `Ctrl+O`     |
| **Fix Invalid Fixup File**                                                                                   | Attempts to fix invalid fixup issues on optimized models (experimental feature).                  | -            |
| **3D Preview Selected Cloth**                                                                                | Opens the 3D Previewer for the selected drawable and its first available texture.                 | `Enter`      |

### **Context Menu Options for Cloth Texture Variations**

| **Action**                    | **Description**                                                              | **Shortcut** |
| ----------------------------- | ---------------------------------------------------------------------------- | ------------ |
| **Remove**                    | Deletes the selected texture variation without removing the `.ytd` file.     | `Del`        |
| **Rename**                    | Opens a dialog to rename the selected texture for better organization.       | `F2`         |
| **Replace**                   | Replaces the selected texture file with an updated version.                  | `Ctrl+H`     |
| **Replace with Dummy**        | Replaces the texture variation with a dummy file to avoid texture ID shifts. | `Ctrl+J`     |
| **Show in Windows Explorer**  | Opens the location of the texture file in Windows Explorer.                  | `Ctrl+E`     |
| **Export**                    | Creates a copy of the texture file and exports it to a desired location.     | -            |
| **Export XML**                | Exports the texture in XML format, compatible with CodeWalker.               | -            |
| **Export DDS**                | Exports all texture images in DDS format.                                    | -            |
| **Export PNG**                | Exports all texture images in PNG format.                                    | -            |
| **Copy Letter**               | Copies the prefix of the selected texture.                                   | -            |
| **Copy Game Name**            | Copies the texture name in the format expected by the game.                  | -            |
| **Copy File Path**            | Copies the file path of the selected texture.                                | -            |
| **Optimize Texture**          | Opens options to automatically optimize the selected texture.                | `Ctrl+O`     |
| **3D Preview Selected Cloth** | Opens the 3D Previewer for the selected drawable and its associated texture. | `Enter`      |

These context menu options are tailored to enhance usability, allowing quick and efficient management of appearance items and textures directly within the tool.

## Footer Section

<figure><img src="https://2130288373-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRsXe3tqSiAvM8iKYjngE%2Fuploads%2Fi5TDWtesksxUIO1lrAQ9%2Fimage.png?alt=media&#x26;token=b017bda4-4c1f-486e-bf6e-cca20fc33d30" alt=""><figcaption><p>Durty Cloth Tool Footer Section</p></figcaption></figure>

The footer provides additional actions and status information for managing your cloth project:

### Action Buttons

* **Error List**: This button opens the error window, giving an overview of any issues, errors and tips generated for your current Cloth Project.\
  See [cloth-analysis-report](https://docs.gta.clothing/basics/essential-knowledge/cloth-analysis-report "mention") for details.
* **Settings**: Opens the settings for the currently loaded Cloth Project.\
  See [app-and-project-settings](https://docs.gta.clothing/basics/good-to-know/app-and-project-settings "mention") for more details.
* **Build Project**: This button is crucial when you're ready to export your project. It compiles all the items, checks for issues, and packages them for use in your preferred target GTA 5 multiplayer or Singleplayer.\
  See [build-options](https://docs.gta.clothing/basics/essential-knowledge/build-options "mention") for more details.

### Status Bar

At the very bottom of the tool, there is a status bar that will always display the most recent log entry. Clicking on it will open the logs window with all logs for the currently loaded Cloth Project. See [logs](https://docs.gta.clothing/basics/useful-to-know/logs "mention") for more details.

## Key Best Practices for Using the UI

1. **Utilize Search Filters**: When working with large projects, use the search bar in the Appearance Items List to quickly find and locate specific clothing items.
2. **Regularly Save Projects**: Always save your project frequently using the **Project** menu to avoid data loss.
3. **Check the Error List**: Before exporting your project, always review the **Error List** for any potential issues that could prevent successful exports.
4. **Explore the Settings**: Customize the tool to suit your workflow by exploring the **App & Project Settings** menu.

***

This documentation provides a high-level overview of the user interface. For in-depth guidance on specific workflows, refer to individual documentation pages on the Basics section.