Render texture atlas animations exported from Adobe Animate.
You will need Python 3.6+ (tested on 3.9). Install dependencies with:
pip install -r requirements.txt
Note that if you look in requirements.txt, you'll see some installation options:
- If you install PyAV from the binary wheel, then you'll be limited to the features enabled in the built-in FFmpeg. If you want more features (e.g. codecs not included in the wheel), then install PyAV from source with
--no-binary av. - You may get a small performance boost if you swap Pillow for Pillow-SIMD. Note that extra steps are needed if you want to enable AVX2.
- You can skip tqdm if you don't want a progress bar.
Export your texture atlas animation from Adobe Animate. You must enable "Optimize Animation.json", as this script will not work otherwise. Then, run:
python render.py animation-dir output.mp4
You can change the canvas size (the animation is always centered in the canvas), background color, or video codec with:
python render.py --width 1280 --height 720 --background-color "#fff" --codec x265 animation-dir output.mp4
There's also a --resample option, which can be nearest, bilinear (the default), or bicubic. I recommend leaving it at bilinear, as nearest is low quality and bicubic can add white pixels to the borders of sprites. Of course, your results may differ.
Finally, you can pass a symbol name with --symbol to render just that symbol. (By default, the whole animation is rendered.)
- In certain configurations of transformed and nested symbol instances, symbols may randomly be scaled in size. This is a bug in the texture atlas export itself, so it can't be worked around.
- Animate can support fully transparent masks because it has access to the underlying shape information. But, when such a mask is exported as a sprite image, there's no shape information—it's just a fully transparent image. So, these kinds of masks will be skipped.
- Transparent background colors cause aliasing and black pixel artifacts, so background colors are forced to be opaque.
This program is licensed under the MIT License. See the LICENSE file for more information.