annabunches/advanced-spritesheet-export
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
Improved spritesheet export functionality for Aseprite.
9 Commits 1 Branch 2 Tags 86 KiB
Lua 98.8%
Makefile 1.2%
4f0f5dc8ad
Go to file
annabunches 4f0f5dc8ad First attempt at re-calculating all colors in a group hierarchy when one color changes, and also protecting user-defined colors.
2024-07-30 18:57:17 -04:00
.vscode Metadata updates. 2024-07-29 21:24:46 -04:00
.gitignore Get licensing and build configured. 2024-07-29 20:35:25 -04:00
abase-commands.lua First attempt at re-calculating all colors in a group hierarchy when one color changes, and also protecting user-defined colors. 2024-07-30 18:57:17 -04:00
abase-listeners.lua Add new layer detection to keep colors mapped correctly. 2024-07-29 23:22:57 -04:00
abase-sprite.lua First attempt at re-calculating all colors in a group hierarchy when one color changes, and also protecting user-defined colors. 2024-07-30 18:57:17 -04:00
advanced-spritesheet-export.lua Add new layer detection to keep colors mapped correctly. 2024-07-29 23:22:57 -04:00
LICENSE Get licensing and build configured. 2024-07-29 20:35:25 -04:00
Makefile Get licensing and build configured. 2024-07-29 20:35:25 -04:00
package.json Add new layer detection to keep colors mapped correctly. 2024-07-29 23:22:57 -04:00
readme.md First attempt at re-calculating all colors in a group hierarchy when one color changes, and also protecting user-defined colors. 2024-07-30 18:57:17 -04:00

readme.md

Advanced spritesheet exporter for Aseprite

This extension adds a more sophisticated spritesheet export command to Aseprite.

Installation

To install, go to Aseprite's Settings -> Extensions -> Add Extension, and select advanced-spritesheet-export.aseprite-extension

Features

  • Choose which layers to export, regardless of visibility.
  • Export groups as a single sprite.

Usage

  • All layers are exported by default. To ignore a 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.
  • Invoke the tool via File -> Export -> Export Sprite Sheet (Advanced).

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.
  • 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.
  • To force a layer's color to be controlled by the extension, simply reset the layer's color to all 0 values. (red, green, blue, and alpha should all be 0) You may need to toggle the export settings of a parent layer or create a new layer before the changes take effect.

Copyright Notice

Copyright 2024 Anna Wiggins

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.