annabunches/advanced-spritesheet-export
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

Documentation cleanup.

Browse Source
This commit is contained in:
Anna Rose Wiggins 2024-07-30 21:54:35 -04:00 committed by annabunches
parent 62379c3ac5
commit 2378c40afd
1 changed files with 15 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
readme.md
View File

@ -8,17 +8,26 @@ To install, go to Aseprite's Settings -> Extensions -> Add Extension, and select
## Features ## Features
* Choose which layers to export, regardless of visibility. * Export layers regardless of visibility. (layers and groups can instead be explicitly ignored)
* Export groups as a single sprite. * Selectively export layer groups as single sprites without modifying or flattening the groups.
* Configure layer settings via Layer menu, right click menu, or keyboard shortcut. * Configure layer settings via Layer menu, right click menu, or keyboard shortcut.
* Modify settings for multiple selected layers at once.
## Usage ## Usage
* All layers are exported by default. To ignore the active layer or group, select Layer -> Advanced Export -> Toggle Ignore. (default keyboard shortcut: Ctrl+Alt+I) * All layers are exported by default. To ignore the active layer or group, select Layer -> Advanced Export -> Toggle Ignore.
* To export a layer group as a single sprite, select Layer -> Advanced Export -> Toggle Merge Group. (default keyboard shortcut: Ctrl+Alt+M) * To export a layer group as a single sprite, select Layer -> Advanced Export -> Toggle Merge Group.
* Invoke the tool via File -> Export -> Export Sprite Sheet (Advanced). (default keyboard shortcut: Ctrl+Alt+E) * Invoke the tool via File -> Export -> Export Sprite Sheet (Advanced).
## Additional Notes ### Default Keyboard Shortcuts
| Command | Keyboard Shortcut (Windows and Linux) | Shortcut (MacOS) |
|-------------------------------|---------------------------------------|------------------|
| Toggle Ignore Layer(s) | Ctrl+Alt+I | Cmd+Ctrl+I |
| Toggle Merge Group(s) | Ctrl+Alt+M | Cmd+Ctrl+M |
| Export Spritesheet (Advanced) | Ctrl+Alt+E | Cmd+Ctrl+E |
### Additional Notes
* Ignored layers always take precedence over merging; if a sublayer in a group is ignored, it will not be merged into the final sprite. * Ignored layers always take precedence over merging; if a sublayer in a group is ignored, it will not be merged into the final sprite.
* Toggling the advanced export settings on a layer will modify the layer colors. The extension will attempt to detect and preserve user-colored layers. If you happen to use one of the exact colors we have chosen, this will fail. We have chosen odd alpha values to reduce the likelihood of a false negative, but if you are using layer colors extensively, this extension may not work well for you. * Toggling the advanced export settings on a layer will modify the layer colors. The extension will attempt to detect and preserve user-colored layers. If you happen to use one of the exact colors we have chosen, this will fail. We have chosen odd alpha values to reduce the likelihood of a false negative, but if you are using layer colors extensively, this extension may not work well for you.