Revised readme and added tag exporter.

Author: lukehollenback

Export Tags.lua

@@ -0,0 +1,48 @@
+----------------------------------------------------------------------------------------------------
+-- Exports the defined tags of the sprite as individual image files according to the supplied root
+-- directory and the export directory specified in the user data of each tag.
+----------------------------------------------------------------------------------------------------
+
+--
+-- Get a handle to the current sprite.
+--
+local spr = app.activeSprite
+if not spr then
+  return app.alert("There is no active sprite.")
+end
+
+--
+-- Ask the user where the root directory that they would like tags to be exported to resides.
+--
+local dlg = Dialog("Export Tags")
+dlg:entry{ id="directory", label="Output Directory", focus=true }
+dlg:slider{ id="scale", label="Scale", min=1, max=10, value=2 }
+ :button{ id="ok", text="&Export"}
+ :button{ text="&Cancel" }
+ :show()
+
+if not dlg.data.ok then
+    return end
+
+--
+-- Export each tagged frame as its own PNG file according to the exportPath defined in its user data
+-- and its name.
+--
+-- NOTE: Currently, we only support exporting single-frame tags and PNG files. In the future, we
+--  might add support for exporting multi-frame tags (either as sprite strips or as GIF files).
+--
+for i, tag in ipairs(spr.tags) do
+    local _, exportPathKeyEnd = string.find(tag.data, "exportPath=\"")
+    local exportPathValueEnd, _ = string.find(tag.data, "\"", (exportPathKeyEnd + 1))
+    local exportPath = string.sub(tag.data, (exportPathKeyEnd + 1), (exportPathValueEnd - 1))
+    local img = Image(spr.width, spr.height)
+
+    img:drawSprite(spr, tag.fromFrame.frameNumber, 0)
+    img:resize(spr.width * dlg.data.scale, spr.height * dlg.data.scale)
+    img:saveAs(dlg.data.directory .. "/" .. exportPath .. tag.name .. ".png")
+end
+
+--
+-- Make sure the UI and state update.
+--
+app.refresh()

Quick Ramp (Down).lua

@@ -1,5 +1,5 @@
 ----------------------------------------------------------------------------------------------------
--- Adjusts the hue, saturation, and lightness of the current foreground color up slightly to help
+-- Adjusts the hue, saturation, and lightness of the current foreground color down slightly to help
 -- create a quick color palette ramp.
 ----------------------------------------------------------------------------------------------------
 

README.md

@@ -1,3 +1,5 @@
 # Aseprite Scripts
 
+![Status: Complete](https://img.shields.io/badge/Work-in-Progress-blue.svg)
+
 Random scripts to help create art in Aseprite.