Changes.md

API Changes

We will try minimize API changes between versions and keep backward compatibility, but if a function in the API was introduced with a bug, it's probable that its behavior will change in the next Aseprite release.

Deprecated should be avoided because might be removed in future versions of Aseprite.

Detect available API

You can use app.apiVersion:

if app.apiVersion == nil then
  -- First scripting API available
  app.alert("This is Aseprite v1.2.10-beta1 or v1.2.10-beta2")
elseif app.apiVersion == 1 then
  -- Second revision of the scripting API
  app.alert("This is Aseprite v1.2.10-beta3")
else
  -- Future versions will be 2, 3, etc.
end

From v1.2.10-beta3 to v1.2.10-beta4

• app.apiVersion is 2
• Fixed app.sprites table
• Added app.param table

From v1.2.10-beta2 to v1.2.10-beta3

• app
  • New app.apiVersion with value 1.
  • Different return value for app.activeFrame: Now it returns a Frame instead of a frame number (an integer value). In v1.2.10-beta2 this function returned nil when we were in the first frame, now it returns the valid Frame object with frame.frameNumber = 1. You can access the old frame number value doing:

    local activeFrameNumber = app.activeFrame.frameNumber

  • New app.range
• Site
  • Different return value for app.site.frame: Now it returns a Frame instead of a frame number.
• Rectangle
  • Added Rectangle.contains function.
  • Added Rectangle.intersect function.
  • Added Rectangle.intersects function.
  • Added Rectangle.union function.
• Sprite
  • Added Sprite.bounds property.
  • Different Sprite:newFrame and Sprite:newEmptyFrame behavior (check documentation and issue #4).
• Image
  • Added Image:clear() function.
  • Added Image:isEqual, Image:clear.
  • Added Image:drawPixel as an alias for Image:putPixel (both functions will be available).
  • Deprecated Image:putImage, replaced with Image:drawImage.
  • Deprecated Image:putSprite, replaced with Image:drawSprite. Also Image:putSprite wasn't working correctly for positions != 0,0.
• ColorMode:
  • Deprecated ColorMode.GRAYSCALE, replaced with ColorMode.GRAY.
• Tag:
  • Different return value for Tag.fromFrame and Tag.toFrame: now they return a Frame object instead of an integer value.
• All functions that receive an integer can automatically accept floating numbers doing an implicit math.floor(number) conversion.

v1.2.10-beta1 and v1.2.10-beta2

• app
  • app.apiVersion didn't exist (is nil)