VEW2VEW User Documentation
VEW2VEW
An AGI to SCI view resource converter by John Nickerson (Mokalus of Borg), mokalus@yahoo.com.au
(c) John Nickerson (Mokalus of Borg), March 2002

-- License Agreement --
You are hereby granted the right to do whatever you like with this software
and it's source code, including redistribution and alteration, on the following
conditions:

1. The author's name and contact details (John Nickerson (Mokalus of Borg), mokalus@yahoo.com.au)
are not removed or hidden.

2. The author accepts no responsibility for any damage that may be caused
to your hardware, other software, or wetware, through use of the program.

3. No warranty is given, either express or implied, including, but not limited
to, usability or fitness for a particular purpose, except where prohibited
by law, and on the planet Neptune ('coz we all know what they're like about
warranties).

-- Executive Summary of License Agreement --
Go nuts, but don't bother me.


-- Current Version --
1.1.3


-- Using the Program --

(The file "vew2vew.exe" has been compiled from "vew2vew.py" with "py2exe", available from Starship Python, and requires "python21.dll" to run.)
(The file "vew2vew.py" requires the Python interpreter, which can be downloaded for free at www.python.org for a variety of platforms.)

The program can be run with either command-line arguments, or user input. The command-line syntax is as follows:

vew2vew agifile scifile
where 'agifile' is the name of the extracted AGI view resource,
and 'scifile' is the name of the SCI output file to write.
If no arguments are given on the command line, then the program will prompt for file names during execution. If you have  problems getting the program to open files, try specifying the path in full.
There is no command for online help.
The program works with AGIv2 views, and will not work with encrypted
views.


-- Further Information/Programs --
To extract AGI views: http://members.ozemail.com.au/~ptrkelly/agi/agistudio.html
The AGI view format: http://members.ozemail.com.au/~ptrkelly/agi/specs/view/6-1.html
To show SCI views: http://www.bripro.com/scistudio/download.html
The SCI view format: http://freesci.linuxgames.com/scihtml/x1681.html
The Python interpreter and language: http://www.python.org


-- Known Issues --

1. AGI views can include a text description to be used in the game when the
illustrated object is LOOKed at. The SCI view format does not include descriptions,
and so any description found is dropped during translation.
2. The standalone executable sometimes misses a cel.
Workaround: use the original
Python script instead for views where this problem occurs.

-- Bug Reporting --

To report a bug, please email me at mokalus@yahoo.com.au, with the following format:

Name:
Date:
Program version:
Command line used:
Description of error:
Error message (if any):

