QT AGI Studio, release 1.3.1

About
=====

AGI (Adventure Game Interpreter) is the adventure game engine used by
Sierra On-Line(tm) to create some of their early games. QT AGI Studio
(formerly known as Linux AGI Studio) is a program which allows you to
view, create and edit AGI games. Basically, it is an enhanced port of
the Windows AGI Studio developed by Peter Kelly.

The program contains very little platform specific code so brave ones
are encouraged to try it on other operating systems that have QT
library support.


Availability
============

QT AGI Studio is available at http://agistudio.sourceforge.net/
The project is licensed under the GPL, GNU General Public License.
See COPYING for details.


System requirements
===================

Linux:  GNU make, g++, X Window System, QT library

The program is now being developed with QT version 4

NAGI, Sarien or ScummVM AGI interpreter is recommended to run games.
Sarien is available at http://sarien.sourceforge.net/
and NAGI at http://www.agidev.com/nagi.html
Sarien is more focused on portability and NAGI on compatibility
with Sierra's original AGI interpreter. Both are free.
ScummVM is actively developed, but does not integrate well
with QT AGI studio.

WINDOWS NOTE: the code hasn't been tested on Windows lately.
If you are interested, please go ahead, make a working
Visual Studio project and send a patch!


Building
========

Run "make" in the src subdirectory. If the supplied Makefile doesn't work,
you can either fix it or use tmake to generate a makefile for your platform:

 qmake agistudio.pro -o Makefile

If you don't have tmake, you can download it at http://www.trolltech.com

Make assumes that QT4 is installed and working (in particular, the QTDIR
environment variable is properly set)


Installation and setup
======================

The binary is called agistudio and will be built in the src subdirectory; you
can copy it to any path convenient to use (e.g. /usr/local/bin). In order to
use the help and an example game template, copy them to any convenient place
and specify the appropriate paths in the "Settings" menu when you'll run
agistudio.

AGI studio has its own help viewer, but you can also view the help with
any HTML browser.

If agistudio complains that it can't load qt shared library, then set the
LD_LIBRARY_PATH environment variable to the path which contains libqt.so.*.

Using
=====

Please read the online help. Note that if you want to use existing games'
files, all the filenames must be in lower case.


Credits
=======

 * Helen Zommer <helen@cc.huji.ac.il> - primary development
 * Jarno Elonen <elonen@iki.fi> - bitmap import, current maintainer

 * Chris Cromer <chris@cromer.cl> - fix build for gcc 7 with 64bit
 * Nat Budin <natb@brandeis.edu> - Win32 port
 * Claudio Matsuoka <claudio@helllabs.org> - sound support
 * Peter Kelly <pmk@post.com> - the original Windows version
 * Lance Ewing <lance.e@ihug.co.nz> - the original (DOS) Picedit


Feedback
========

Please visit project website at http://agistudio.sourceforge.net/ to
submit bug reports, comments, suggestions, etc.

Hope you'll have as much fun using it as we've had developing it :-)