https://github.com/dinpx/asescale

Automates export of Aseprite files in different scales and formats.
https://github.com/dinpx/asescale

aseprite aseprite-export automate-the-boring-stuff exporter godot godot-engine godot3

Last synced: 2 months ago
JSON representation

Automates export of Aseprite files in different scales and formats.

• Host: GitHub
• URL: https://github.com/dinpx/asescale
• Owner: DinPX
• License: mit
• Created: 2024-12-31T15:42:04.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-01-07T06:01:56.000Z (5 months ago)
• Last Synced: 2025-01-22T01:24:58.146Z (4 months ago)
• Topics: aseprite, aseprite-export, automate-the-boring-stuff, exporter, godot, godot-engine, godot3
• Language: GDScript
• Homepage:
• Size: 1.77 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# AseScale

Automates export of Aseprite files in different scales.  

Supports `PNG` and `GIF` formats, and exports from x1 to x10 scales.

![preview of 'on start' and 'running' app](/preview.png)

> [!NOTE]  

> You need Aseprite installed to your system in order for this to work.

## Usage

Choose your preferred format and scales first.  

Then, drag and drop **an* Aseprite file, and the files will be exported on `~/Documents/AseScale` folder.

> [!IMPORTANT]  

> *Drop 1 file at a time only. Multiple files at once isn't supported.

## Testing

There's a `Test/test_smug.aseprite` you can test with the `PNG` *format option* and it should generate the following:

![preview of exported files](/export_test.png)

> [!NOTE]  

> Only at source. Not included in export builds.

## Docs

The program uses the following functions in order to work.

### Godot

- `OS.get_system_dir(OS.SYSTEM_DIR_DOCUMENTS)` - to get user's Documents path in various platforms.

- `OS.execute(, <[args]>)` - to run Aseprite and its arguments in the command line.

    - Example: `OS.execute("aseprite", ["--batch" , file_path, "--scale", "2", "--save-as", export_path + "/" + output_name + "_x2.png"])`

### Aseprite

- `aseprite [OPTIONS] [FILES]...` - launch installed Aseprite in the command line (see [aseprite.org/docs/cli/#options](https://www.aseprite.org/docs/cli/#options))

- `--batch`/`-b` - run and process commands only, then finish them. (see [aseprite.org/docs/cli/#batch](https://www.aseprite.org/docs/cli/#batch))

    - Example: `aseprite -b`

- `--save-as` - saves the document with the provided file name. (see [aseprite.org/docs/cli/#save-as](https://www.aseprite.org/docs/cli/#save-as))

- `--scale FACTOR` - resizes the image with the given `FACTOR`. (see [aseprite.org/docs/cli/#scale](https://www.aseprite.org/docs/cli/#scale))

    - Example: `aseprite -b amogus.png --scale 4 --save-as amogus_x4.png`

## To-do

- [x] Add `.gif` format

- [x] Add scale options

## License

### AseScale

This work is under the [MIT License](/LICENSE.md).

### Bit3 Font

Made by [Camshaft](https://www.fontsc.com/font/designer/camshaft), © 2016-present  

https://www.fontsc.com/font/bit3  

License: Freeware - Personal & Commercial Use