_      _ _
                             /_\  __| (_)_ __  ___
                            / _ \/ _` | | '  \/ -_)
                           /_/ \_\__,_|_|_|_|_\___|

                           Allegro Dialogs Made Easy
                                 Version 2.2.1

                                    Readme

                          http://adime.sourceforge.net/

                               by Sven Sandberg


Contents


Introduction

Adime is a library for constructing Allegro gui dialogs in a way similar to scanf(), using a format string. You only need one function call to create, e.g., a dialog where the user can enter an integer, a string, select a file, and select a string from a list.

Other features include (customizable) 3d look and feel, 3d versions of some of Allegro's gui procs, complete help in many formats (html, txt, chm, texinfo, man, devhelp, rtf), and four example programs.

Adime can currently be compiled on Linux, Windows/MinGW32, Windows/Borland C++, Windows/MSVC, DOS/DJGPP, DOS/Watcom, Apple MacOS X, and QNX.


Licence

The zlib/libpng license: see license.txt for more information.

You are also strongly encouraged to give away the source code of your program, but you do not have to do so.


Requirements

You need to have installed and compiled Allegro (http://alleg.sf.net/). You need at least version 4.*.

If you don't have a local copy of the Allegro library (e.g. because you deleted it to save some space after installation), then download the dimalleg.zip package from Adime's homepage. Unzip it to the same place where you unzipped Adime, then continue the installation as usually.


Installation

See the file corresponding to your platform:

   linux.txt
   mingw32.txt
   bcc32.txt
   msvc.txt
   djgpp.txt
   watcom.txt
   qnx.txt
   macosx.txt
These files are located in the docs/build/ directory.

Common Problems

It is easy to give invalid arguments to `adime_dialogf()' by accident, and the error might not point out the source of the problem very well. Here is a checklist with the most common problems:


Contact Info

See thanks.txt for email addresses to the developers.

The homepage is at http://adime.sourceforge.net/