From 3691524807bc26f92801544dab4f41a40b505f57 Mon Sep 17 00:00:00 2001 From: Crash Date: Tue, 31 Mar 2026 20:40:59 -0500 Subject: [PATCH 1/6] Fix app.clipboard typo --- api/app_clipboard.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/app_clipboard.md b/api/app_clipboard.md index 2c3f8b6..3e1e371 100644 --- a/api/app_clipboard.md +++ b/api/app_clipboard.md @@ -1,4 +1,4 @@ -## app.clipboard +# app.clipboard A set of functions to handle the clipboard. From 3e0a17b52cd013c5f243cfd5797ae441ef8cf084 Mon Sep 17 00:00:00 2001 From: Crash Date: Fri, 3 Apr 2026 21:47:25 -0500 Subject: [PATCH 2/6] Document sprite.isValid --- api/sprite.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/api/sprite.md b/api/sprite.md index 15c10c9..333b7ce 100644 --- a/api/sprite.md +++ b/api/sprite.md @@ -119,9 +119,17 @@ Returns the id of this sprite, as an integer. local modified = sprite.isModified ``` -Returns true if the sprite is modified compared to the latest saved +Returns `true` if the sprite is modified compared to the latest saved state on disk. +## Sprite.isValid + +```lua +local valid = sprite.isValid +``` + +Returns `true` if the sprite object is a valid object (the sprite is open). + ## Sprite.colorSpace ```lua From 0e1d838b07191723dbcdbd2f7393d0397148e3c3 Mon Sep 17 00:00:00 2001 From: Crash Date: Fri, 3 Apr 2026 23:04:38 -0500 Subject: [PATCH 3/6] Complete missing SaveFile command doc --- api/command/SaveFile.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/api/command/SaveFile.md b/api/command/SaveFile.md index 0b80ce6..0f9f7ed 100644 --- a/api/command/SaveFile.md +++ b/api/command/SaveFile.md @@ -32,15 +32,12 @@ little differences by default: Parameters: -* `ui`: Shows the dialog to select the filename. `SaveFile` doesn't - show the UI (`false` by default) if the sprite has an associated - file. `SaveFileAs` and `SaveFileCopyAs` will show the UI by - default. +* `ui`: Shows the dialog to select the filename. Defaults to `true`. When using `SaveFile`, if the sprite already has an associated file, the ui will not show. * `recent`: Only available since v1.3.7, it adds the file to the list of recent files. By default it depends if the dialog to select the filename is displayed (depends on the value of the `ui` parameter). * `filename`: The filename where to save the sprite. The default - values is the + values is the sprite name (e.g "Sprite-0001"). When using `SaveFile`, this parameter should not be set (as Aseprite will throw an error). * `filenameFormat`: Special value similar to [--filename-format](https://www.aseprite.org/docs/cli/#filename-format) when we use [--save-as](https://www.aseprite.org/docs/cli/#save-as) from the [CLI](https://www.aseprite.org/docs/cli/) * `tag`: A tag name. You can save only the range of frames specified by this tag. From 220e33b2f0f51a027f8354a28a158676008a0d24 Mon Sep 17 00:00:00 2001 From: Crash Date: Sat, 4 Apr 2026 23:05:18 -0500 Subject: [PATCH 4/6] Update Changes.md --- Changes.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/Changes.md b/Changes.md index 6594acb..36980f9 100644 --- a/Changes.md +++ b/Changes.md @@ -23,6 +23,44 @@ else -- Future versions will be 2, 3, etc. end ``` + +## v1.3.17 + +* [`app.apiVersion`](api/app.md#appapiversion) is `39` +* Fixed security issue where a script could gain already given access from other script + +## v1.3.17-beta1 + +* [`app.apiVersion`](api/app.md#appapiversion) is `38` +* Added Dialog `onresize` event [#4736](https://github.com/aseprite/aseprite/issues/4736) [#5354](https://github.com/aseprite/aseprite/issues/5354) +* Fixed `Image:drawSprite()` call when the user is drawing [#3916](https://github.com/aseprite/aseprite/issues/3916) + +## v1.3.16 + +* [`app.apiVersion`](api/app.md#appapiversion) is `38` +* **New Behavior**: Property changes outside a transaction don't generate undo steps [#4568](https://github.com/aseprite/aseprite/issues/4568) +* **New Behavior**: Layer flag changes inside a transaction generate undo steps [#2991](https://github.com/aseprite/aseprite/issues/2991) +* Avoid clicking an invalid button after a new window is displayed [#4757](https://github.com/aseprite/aseprite/issues/4757) +* Don't reset dialog bounds after `Dialog:show{autoscrollbars}` when `dialog.bounds` were set before [#4758](https://github.com/aseprite/aseprite/issues/4758) +* Allow mouse wheel scrolling in dialogs with `autoscrollbars` option [#5116](https://github.com/aseprite/aseprite/issues/5116) +* Fixed widgets interactivity using bounds and `autoscrollbars` in `Dialog:show{}` [#5516](https://github.com/aseprite/aseprite/issues/5516) +* Fixed dialog with scrollbar wrong size in a particular case [#5396](https://github.com/aseprite/aseprite/issues/5396) [#5481](https://github.com/aseprite/aseprite/issues/5481) +* Fixed crash using a `label` field in `Dialog:endtags{}` [#5114](https://github.com/aseprite/aseprite/issues/5114) +* Fixed disabled checkbox style change after `Dialog:combobox()` change [#4988](https://github.com/aseprite/aseprite/issues/4988) +* Fixed crash setting properties with its same value [#5519](https://github.com/aseprite/aseprite/issues/5519) +* Added `Sprite.isValid` [#5017](https://github.com/aseprite/aseprite/issues/5017) +* Fixed console re-centering [#5349](https://github.com/aseprite/aseprite/issues/5349) [#5562](https://github.com/aseprite/aseprite/issues/5562) +* Fixed calling filters inside the same `app.transaction()` with `ui=true` [#5572](https://github.com/aseprite/aseprite/issues/5572) +* Don't show progress bar for filters when running with `ui=false` [#5537](https://github.com/aseprite/aseprite/issues/5537) + +## v1.3.15.5 + +* [`app.apiVersion`](api/app.md#appapiversion) is `37` +* Avoid setting window bounds when the app is closing [#5384](https://github.com/aseprite/aseprite/issues/5384) +* Fixed centering a dialog with `autoscrollbars` behavior [#5485](https://github.com/aseprite/aseprite/issues/5485) +* `WebSocket`: Added `error` param to `onreceive` handler +* Fixed `app.clipboard.content.selection` property + ## v1.3.16-beta1 * [`app.apiVersion`](api/app.md#appapiversion) is `36` From c030f66eb83e2b08a2b357ce73283ff7ad9a69f9 Mon Sep 17 00:00:00 2001 From: Crash Date: Mon, 6 Apr 2026 18:32:09 -0500 Subject: [PATCH 5/6] Document Color{tile=integer} --- api/color.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/api/color.md b/api/color.md index fcca7c0..9dbf37c 100644 --- a/api/color.md +++ b/api/color.md @@ -18,10 +18,13 @@ c = Color{ hue=360.0, saturation=1.0, value=1.0, alpha=255 } c = Color{ hue=360.0, saturation=1.0, lightness=1.0, alpha=255 } c = Color{ gray=255, alpha=255 } c = Color{ index=integer } +c = Color{ tile=integer } c = Color(integer) ``` * If `alpha` argument is not specified, it's 255 by default (opacity = 100%). +* The `Color{ index=integer }` returns the color at the specified index from the palette. +* The `Color{ tile=integer }` returns a special "tile color" at the specified index from the current tileset. This "tile color" can be used to pass tiles into parameters that require the color object (e.g: `app.useTool{color=Color{tile=integer}}`). * The `Color(integer)` constructor receives a [pixel color](pixelcolor.md#apppixelcolor) and the integer is interpreted depending on the [active sprite](app.md#appsprite). From c23dc0ec7162f4bd9e6d5dfcabefdb33b65c51d4 Mon Sep 17 00:00:00 2001 From: Crash Date: Mon, 6 Apr 2026 18:32:30 -0500 Subject: [PATCH 6/6] Document sprite.useLayerUuids --- api/sprite.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/api/sprite.md b/api/sprite.md index 333b7ce..576a4c0 100644 --- a/api/sprite.md +++ b/api/sprite.md @@ -155,6 +155,15 @@ local spec = sprite.spec Returns the [specification](imagespec.md#imagespec) for image in this sprite. +## Sprite.useLayerUuids + +```lua +local layeruuids = sprite.useLayerUuids +sprite.useLayerUuids = layeruuids +``` + +Gets or sets if the sprite should use [layer](layer.md#layer) UUIDs. + ## Sprite.undoHistory.undoSteps ```lua