rsi-flip

CLI tools for working with RSI sprite sheets.

Installation

Installers (recommended)

Download and run the installer for your platform from the latest release. Installers are built using cargo-dist.

cargo install

cargo install --git https://github.com/Centronias/rsi-flip

Build from source

git clone https://github.com/Centronias/rsi-flip
cd rsi-flip
cargo build --release

Commands

flip

Horizontally mirrors an RSI sprite sheet. In 4-direction mode (the default), each directional sprite is mirrored and the east and west sprites swap quadrant positions. In 1-direction mode the entire image is simply flipped horizontally.

For example, this image

becomes this with 4 directions (the default):

or this with 1 direction:

rsi-flip flip -p sprite.png
rsi-flip flip -p sprite.png -d 1
rsi-flip flip -p sprite.png -o out.png --offsets n=0,2

Run rsi-flip flip --help for the full list of options.

overlay

Alpha-composites a foreground PNG on top of a background PNG of the same dimensions, producing a single merged image.

For example, using this image as the background

and this image as the foreground

produces this result:

rsi-flip overlay -b background.png -f foreground.png
rsi-flip overlay -b background.png -f foreground.png -o out.png

Run rsi-flip overlay --help for the full list of options.

Contact

I'll probably notice issues or whatever you create here, but feel free to beam me a message on Discord @Centronias.