# User Guide: Usage - Graphical User Interface (GUI)

This document explains how to use the Asset Processor Tool's Graphical User Interface.

## Running the GUI

From the project root directory, run the following command:

```bash
python -m gui.main_window
```

## Interface Overview

*   **Menu Bar:** The "View" menu allows you to toggle the visibility of the Log Console and the Detailed File Preview.
*   **Preset Editor Panel (Left):**
    *   **Optional Log Console:** Displays application logs (toggle via View menu).
    *   **Preset List:** Create, delete, load, edit, and save presets. On startup, the "-- Select a Preset --" item is explicitly selected. You must select a specific preset from this list to load it into the editor below, enable the detailed file preview, and enable the "Start Processing" button.
    *   **Preset Editor Tabs:** Edit the details of the selected preset.
*   **Processing Panel (Right):**
    *   **Preset Selector:** Choose the preset to use for *processing* the current queue.
    *   **Output Directory:** Set the output path (defaults to `config.py`, use "Browse...")
    *   **Drag and Drop Area:** Add asset `.zip`, `.rar`, `.7z` files, or folders by dragging and dropping them here.
    *   **Preview Table:** Shows queued assets. Initially, this area displays a message prompting you to select a preset. Once a preset is selected from the Preset List, the detailed file preview will load here. The mode of the preview depends on the "View" menu:
    *   **Detailed Preview (Default):** Lists all files, predicted status (`Mapped`, `Model`, `Extra`, `Unrecognised`, `Ignored`, `Error`), output name, etc., based on the selected *processing* preset. Text colors are applied to cells based on the status of the individual file they represent. Rows use alternating background colors per asset group for visual separation.
    *   **Simple View (Preview Disabled):** Lists only top-level input asset paths.
*   **Progress Bar:** Shows overall processing progress.
*   **Blender Post-Processing:** Checkbox to enable Blender scripts. If enabled, shows fields and browse buttons for target `.blend` files (defaults from `config.py`).
    *   **Options & Controls (Bottom):**
        *   `Overwrite Existing`: Checkbox to force reprocessing.
        *   `Workers`: Spinbox for concurrent processes.
        *   `Clear Queue`: Button to clear the queue and preview.
        *   `Start Processing`: Button to start processing the queue. This button is disabled until a valid preset is selected from the Preset List.
        *   `Cancel`: Button to attempt stopping processing.
*   **Status Bar:** Displays current status, errors, and completion messages.