Hosted by [Project Page]
Allegro Dialogs Made Easy
Table of contents:
Adime, version 2.2.1, 6 August 2005
Adime is a portable add-on library for Allegro with functions for
generating Allegro dialogs in a very simple way. Its main purpose is
to give as easy an API as possible to people who want dialogs for
editing many kinds of input data.
It currently works with Linux, MinGW32, Borland C++, MSVC, DJGPP,
Watcom, QNX and Mac OS X. Help with porting (e.g., to Unix, or BeOS)
would be very appreciated!
The sourceforge project page is at
The ZLIB/LIBPNG license.
- You can download the library either as tar.gz or as zip,
depending on your preference.
||Source of Adime 2.2.1 (in a zip archive with dos/windows style
||Source of Adime 2.2.1 (in a tar.gz archive with unix style text
This is a source only distribution, so you will have to build it after
unzipping the archive. The following instructions for each platform
can also be found in the directory adime/docs/build/ in the archives:
macosx.txt. It requires Allegro version
4.0.0 or later (the Mac OS X port requires the latest Allegro WIP release).
If you use MSVC or QNX, note that it has not been tested yet
(because I don't have access to the platform). Any reports would be
appreciated. If there are problems under MSVC, please try the release notes for previous version
(2.2.0) and let me know if it works.
- The sourceforge download page is here. You
can find all older versions of Adime here.
- You can also browse the
- Really old versions (from when the library was merely called
"Dime") are at Dime's
homepage. What's the deal
- Only one function call to create a whole dialog, using a format
- 3d look and feel.
- No need to calculate object coordinates by hand. All such things
are handled completely automatically.
- Uses Allegro's gui in the bottom, so it supports Unicode and is
potentially portable to any system supported by Allegro (although
there are not makefiles for all of them).
- The format string supports the following kinds of input:
- Text input.
- Number input, supporting double, float and signed or unsigned
char, short and int. Thanks to the expression evaluator for Egg
(written by Shawn Hargreaves), it has a built-in calculator so that the
user can enter mathematical expressions.
- Selection of a filename, using (a 3d version of) Allegro's
- Boolean input, using a checkbox.
- Selection of a string from a list box.
- A new dialog recursively opened when the user clicks a button.
- Highly customizable look, using global variables for the fonts,
colors and measurements of the dialogs.
- The kernel is flexible enough to allow you to register your own
format strings at runtime.
- 3d versions of the following Allegro gui functions:
Gui functions for edit boxes with mathematical
expressions and a multi-line version of
- The format string is carefully checked for any possible errors,
thus minimizing the risk for you to make mistakes.
- Help compiles into txt, info, html, rtf, and chm formats.
- Four example programs.
Here is a typical example of what a dialog can look like:
This dialog was generated with the single function call:
ADIME_ALIGN_CENTRE, ADIME_ALIGN_CENTRE, 200,
"Social security number:%double[0,9999999999]"
"Shoe size (Swedish units):%float[10,70]"
"Favourite text file:%filename[256,txt,Select a text file]"
"Extinguish on program termination:%bool"
name, &age, &shoe_size, &file_name, &language_index, &extinguish_flag, extinguish_callback);
The documentation and the following
installation instructions for all supported platforms are also in the