The Texture Tools UI

This guide provides a detailed overview of the main user interface for the Texture Tools plugin. Understanding the layout and the function of each panel is the key to building and managing your texture generation workflows.

1. Main Interface Layout

The Texture Tools window is divided into three primary vertical sections, each with a distinct purpose.

1. Viewports Panel (Left): This is the largest section, dedicated to visualizing your textures. It's split into an Input area on the left and an Output area on the right, allowing you to see your source textures and the results of your jobs side-by-side.

2. Job List Panel (Middle): This section contains the list of all the texture operations, or "jobs," you have created. You can add, delete, reorder, and select jobs from this list.

3. Details Panel (Right): This is a context-sensitive panel that displays all the settings and parameters for the job currently selected in the Job List.

2. The Job List Panel

This is the heart of your workflow, where you manage your queue of texture operations.

Managing Jobs

• Add Job: Opens a pop-up window where you can select a new job type (e.g., Blend Texture, AI Generation) to add to the list.

• Delete Jobs: Removes all currently selected jobs from the list.

• Run Selected Job: Executes only the job(s) currently highlighted in the list.

• Run Entire Queue: Executes all jobs in the list from top to bottom in sequence.

The Job List Columns

Each row in the list represents a single job and provides key information:

• Checkbox: Toggles whether the job is active or selected.

• Output Name: The name that will be given to the final output texture asset.

• Job Type: The type of operation this job will perform (e.g., "Modify Texture", "Channel Packer").

• Status: Shows the current state of the job.

  • Ready: The job has all required inputs and is ready to run.

  • Missing Inputs: The job is missing a required input texture.

  • Running: The job is currently being processed. A progress bar will appear.

  • Complete: The job has finished successfully. A magnifying glass icon will appear, which you can click to browse to the output file.

  • Failed: The job failed to complete. An error message will be displayed.

3. The Details Panel

This panel is your primary workspace for configuring each job.

• Context-Sensitive Settings: The contents of this panel change completely based on which job you have selected in the Job List. It will show all the relevant parameters, such as blend modes, filter types, or AI model selectors.

• Additional Buttons & Boxes: Some complex jobs, like the AI Generation job, will add extra UI elements at the top of the Details Panel for quick access to common actions like starting the ComfyUI backend or managing presets.

4. The Viewports Panel

This panel is where you visualize your work. It's divided into an Input section and an Output section.

See the "Navigating the Viewports" guide for a full breakdown on how to use the viewports.

5. The Generation Process

When you click "Run Selected Job" or "Run Entire Queue", the tool begins processing. For long operations like AI Generation, the main viewport area will be replaced by a progress bar overlay, showing the overall progress of the queue and the progress of the current node being executed by ComfyUI.