autoParallax for Aseprite

autoParallax.lua is a Lua script for Aseprite that allows you to automate the process of creating parallax scrolling animations using pixel shifting. It also allows for manual scrolling and automatic scrolling with a few simple steps.

What It Does:

• autoParallax.lua can automatically scroll the content of the selection once or over multiple frames.
• You must have a sprite opened, and a selection has to be made, for the script to work. When no selection is available, it will suggest to Select All instead.

Instructions:

• While editing a Sprite, make a selection on the content you wanna scroll, then select File > Scripts > autoParallax. This will open a new dialog.
• Choose the shift distance, which controls how many pixels to move per frame, and also the shift direction.
• Press Shift Once to only apply the parallax shift to the current frame; or press Shift Auto to apply the parallax scrolling all the frames, starting with the currently selected frame.
• By default, the option to multiple the shift distance by the frame number is turned on. This is what results in the automatic scrolling. It can be disabled to shift all frames by the same amount instead.
• Also by default, we interpret the first frame as being frame zero, so that the parallax scrolling doesn't affect the first frame of the animation. This can also be turned off, if necessary. It has no effect when manually shifting the image with Shift Once.
• Important: Make sure to unlink any linked cels first, otherwise the parallax scrolling will shift the pixels of the image multiple times.

In case of a bug, or any other kind of unintentional behavior, feel free to contact me at kidmarscat [at] gmail [dot] com or leave a comment on the autoParallax download page, kidmarscat.itch.io/autoparallax

ChangeLog

Date	Version	What changed
2024-09	0.2	Added automatic shift for parallax scrolling, code improved.
2023-05	0.1	First Release, internal use only. Had no automatic shift.