QT AGIStudio allows AGI games to be created or edited.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Chris Cromer b93a3246e0
update docs for new release
3 months ago
help update docs for new release 3 months ago
packaging update docs for new release 3 months ago
src update docs for new release 3 months ago
template initial 1.3.0 3 months ago
.gitignore ignore binary and generated files 3 months ago
COPYING initial 1.3.0 3 months ago
README update docs for new release 3 months ago
agistudio.1 update docs for new release 3 months ago
relnotes update docs for new release 3 months ago

README

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 :-)