Canvas Templates

Current Release: v0.1.0 - MIT LICENSE 

©2024 John Riggles

This Aseprite extension allows you to choose from a number of canvas size templates for new Aseprite files, as well as create your own custom templates.  Predefined templates are available for a number of various game consoles, aspect ratios, and more!

This is a preliminary release, so please feel free to provide any constructive feedback or ideas you may have!

Requirements

    This extension has been tested on both Windows and Mac OS (specifically, Windows 11 and Mac OS Sonoma 14.3.1)

    It to run on Aseprite version 1.3 or later and requires API version 1.3-rc5 (as long as you have the latest version of Aseprite, you should be fine!)

Permissions

    When you run this extension for the first time, you'll be asked to grant some permissions. This extension uses stores your templates in a JSON file and will need your permission to read from and write to it.

When prompted, select the "Give full trust to this script" checkbox and then click "Give Script Full Access" (you'll only need to do this once)

Features & Usage

    To use this extension, go to the File menu in Aseprite and then select "Canvas Size Templates..."

Then you can choose the template you'd like to use for your new Aseprite file from the template selection window . You can click on the checkbox next to each category name to show or hide that category.

    To add your own templates or modify the existing ones, click on "Open "templates.json"..." to open the templates file for editing (this will open the extension's builtin templates.json file in whatever your default editor is).

NOTE: the templates in templates.json are structured like so ...

{
  "Category One": {
    "Template One": {"width": 123, "height": 456},
    "Template Two": {"width": 123, "height": 456}
  }, 
  "Category Two": {
     "Template Three": {"width": 123, "height": 456},
     "Template Four": {"width": 123, "height": 456}     
  }
}

Take care to use properly formatted JSON or you'll get a message saying that there is a problem with your templates.json file.

The values for width and height are expected to be numbers, and will be rounded down if decimals are included.

---

P.S.: 

I'm aware that the templates on the dialog are not shown in the same order they are in templates.json - this is a side-effect of how Lua stores "tables" (order is ignored). I'm looking for a workaround! Thanks for understanding :)

---

     If you find this extension useful, please consider donating to support further development! ♥

Latest Changes

• Initial Release!

You can track development changes here:

https://github.com/JRiggles/Canvas-Templates