Hosted by [Project Page]
Adime
Allegro Dialogs Made Easy
Table of contents:
Introduction
Licence
Download
Detailed Features
Screenshot
Documentation
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
http://sf.net/projects/adime/
The ZLIB/LIBPNG license.
- You can download the library either as tar.gz or as zip,
depending on your preference.
adime221.zip
| Source of Adime 2.2.1 (in a zip archive with dos/windows style
text files)
| 322 kB
|
adime-2.2.1.tar.gz
| Source of Adime 2.2.1 (in a tar.gz archive with unix style text
files)
| 245 kB
|
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:
linux.txt,
mingw32.txt,
bcc32.txt,
msvc.txt,
djgpp.txt,
watcom.txt,
qnx.txt,
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
CVS tree.
- Really old versions (from when the library was merely called
"Dime") are at Dime's
homepage. What's the deal
with Dime?
- Only one function call to create a whole dialog, using a format
string.
- 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
file selector.
- 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:
file_select()
,
d_edit_proc()
,
d_list_proc()
,
d_button_proc()
,
d_check_proc()
and
d_text_list_proc()
.
Gui functions for edit boxes with mathematical
expressions and a multi-line version of
d_text_proc()
.
- 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_dialogf(
"adime_dialogf() example",
ADIME_ALIGN_CENTRE, ADIME_ALIGN_CENTRE, 200,
"Required Information%line[]"
"Name:%string[256]"
"Social security number:%double[0,9999999999]"
"Optional Information%line[]"
"Shoe size (Swedish units):%float[10,70]"
"Favourite text file:%filename[256,txt,Select a text file]"
"Language:%list[,Lojban;Mandarin;Swahili;Swedish]"
"Actions:%line[]"
"Extinguish on program termination:%bool[]"
"%button[Extinguish Now!]",
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
archives.
linux.txt
mingw32.txt
bcc32.txt
msvc.txt
djgpp.txt
watcom.txt
qnx.txt
macosx.txt