Skip to content

ztalib

ztalib is a parsing library for Zoo Tycoon 1 animation graphics and palette files.

Repository

https://github.com/GoosiferIO/ztalib

Features

  • Read Zoo Tycoon 1 animation graphics and palette files in-memory
  • Supports the following types of ZT1 graphics:
  • Static graphics
  • Simple animations (no background frames)
  • Complex animations (with background frames)
  • Shadow animations
  • CMake build system for easy integration into C++ projects

Install

The easiest way to start using ztalib is to use the Python bindings, which are available on PyPI as pyzta:

pip install pyzta

Then, in your Python code, you can import the library as so:

from pyzta import ZtaF
zta = ZtaF()
animation = zta.load("path/to/animation")
buffer = zta.getFrameBuffer()

See the example project to see it in action, or check out the API reference for more details on how to use the library.

Compile from source

If you want to use the library in a C++ project, or if you want to contribute to the development of ztalib, you can compile it from source. First, make sure you have CMake installed on your system. For further instructions, see the compile guide.

Acknowledgements

Thank you to Jeff Bostoen for his documentation on the ZT1 file formats: https://github.com/jbostoen/ZTStudio/wiki/ZT1-Graphics-Explained