Skip to content

Latest commit

 

History

History
76 lines (40 loc) · 3.76 KB

Readme.md

File metadata and controls

76 lines (40 loc) · 3.76 KB

AtlasTexture Manager for Godot

Supported Godot Version: 4.3 or later.

image

Installation

  1. Download the GD-AtlasTexture-Manager.zip from the latest release.
  2. Decompress the file and place the addons directory into the project root (res://).
  3. In Godot Editor, navigate to Project/Project Settings/Plugins, locate the AtlasTexture Manager from the Installed Plugins list, and check the Enable box under the Status column.
  4. The AtlasTexure Manager will launch at the Bottom Panel.

Guide

Inspect a Texture2D Resource in the AtlasTexture Manager

Double-clicking a Texture2D resource in the FileSystem window will send it to the active AtlasTexture Manager window, allowing the developer to modify it further.

QQ2024112-153014.mp4

Scan the AtlasTextures that belong to a Texture2D Resource

To scan for AtlasTextures that references the inspecting Texture2D, use the Scan in Directory or Scan in Project button. This will search and display the region of the eligible AtlasTextures in the inspector.

QQ2024112-15326.mp4

Create AtlasTextures from a Texture2D Resource

The AtlasTexture Manager offers two approaches to creating AtlasTextures: using Slicers or manually specifying the slice area.

AtlasTexture Slicers

There are three built-in slicers, each for a specific use case.

Cell Count Slicer

Create AtlasTextures by specifying how many columns and rows the current Texture2D resource contains.

QQ2024112-154623.mp4
Cell Size Slicer

Create AtlasTextures by specifying the size of each element the current Texture2D resource contains.

QQ2024112-155430.mp4
Automatic Slicer

Create AtlasTextures by automatically detecting the content the current Texture2D resource contains.

QQ2024112-155821.mp4

Create AtlasTexture Manually

Click and hold the left mouse button, then drag towards the inspector's bottom right to specify the target's range AtlasTextures.

QQ2024112-162036.mp4

Editing the Properties of an AtlasTexture

Click an existing AtlasTexture region inside the inspector will show its properties in the bottom right inspector; editing these values will mark the region modified; to write the changes to the actual AtlasTexture, the developer needs to Apply or Discard Modification.

Developer may only delete a newly created(not yet saved to asset) AtlasTexture region.

Apply or Discard Modification

The AtlasTexture Manager will display newly created AtlasTexture regions Yellow and modified AtlasTexture regions Green Yellow to notify there are pending changes.

To apply the changes, click the Create & Update button. This will convert all newly created AtlasTexture regions to actual AtlasTexture resources and save them to the same directory of the inspecting Texture2D resource. The pending changes to the existing AtlasTexture resources will also be applied.

QQ2024112-16454.mp4

To discard the changes, click the Discard button. This will remove all newly created AtlasTexture regions and restore all the pending changes to the existing AtlasTexture resources.

QQ2024112-165741.mp4