Wiki
Clone wikiagtools / Host Development Environments
Windows 32bit or 64bit:
Cygwin/32
see Vincent's site for link to installer
Environment Variables
configure $AGTROOT to point at the agtools repo directory. e.g.
> export AGTROOT="$HOME/Projects/agtools"
You can add an equivalent line to your profile to ensure it is configured each time you log in.
GNU make
Use the Cygwin package installer
Atari MiNT GCC 4.6.4
see Vincent's site for link to installer
GIT SCM
Optional, but preferred for keeping the source repo up-to-date, compared with downloading the .zip snapshots. If you don't have experience with GIT, better stick with the .zip files until you're comfortable with it.
(There are also several GUIs available for GIT on Windows).
Ubuntu:
AGT has been tested on Ubuntu 16.10. It should work on any distro providing you can install the prerequisites:
Environment Variables
configure $AGTROOT to point at the agtools repo directory. e.g.
> export AGTROOT="$HOME/Projects/agtools"
You can add an equivalent line to your profile to ensure it is configured each time you log in.
GIT SCM
> sudo apt-get install mercurial
Wine Windows emulator
> sudo apt-get install wine-stable
Atari MiNT GCC 4.6.4
follow this link for instructions
Note: while Ubuntu 16.10 is the currently supported release, some earlier releases still have support. Change the deb source to suit:
Release Name Source Dir 16.10 Yakkety Yak yakkety/ 16.04 Xenial Xerus xenial/ 14.04 Trusty Tahr trusty/ 12.04 Precise Pangolin precise/
MacOSX/Darwin:
configure $AGTROOT to point at the agtools repo directory. e.g.
> export AGTROOT="$HOME/Projects/agtools"
You can add an equivalent line to your profile to ensure it is configured each time you log in.
The MacOS version previously used WINE to wrap Windows tools in exactly the same way as the Linux version. However this stopped working with Catalina. Now MacOS uses native builds of the AGT tools (under bin/mac).
Note: Only 'agtcut' and 'rmac' are provided. This is enough to use most of the samples but not all. Some tools are still missing.
GIT: Non-Windows Systems:
If using GIT from the commandline, obtain an initial clone of the source repo with the command below. You only need to do this once.
> git clone https://d_m_l@bitbucket.org/d_m_l/agtools.git
To pull new changes from BitBucket use:
> git pull
Note: GIT can be 'fun' at times, so practise & experimentation is recommended if you are not familiar with it.
GIT: Windows Systems:
On Windows you may use TortoiseGit, Tower, SmartGIT or any other GUI version you happen to like. Otherwise you can use GIT in the same way as for non-windows systems (commandline version) after installing it via the Cygwin package mananger or as native Windows tools.
Troubleshooting:
One of the sprite cutting formats (.emx) requires the 68k assembler rmac
to generate the binary data for each sprite frame. agtcut
will try to shell out to rmac.exe
in order to do this. However it expects to find rmac
on the system path.
So if you get errors from agtcut trying to invoke rmac
, either add the tool to your (Windows) $PATH or switch to one of the other sprite formats which doesn't depend on the assembler (.ims, .ems).
Updated