Hosted by [Project Page]

Adime

Allegro Dialogs Made Easy

Table of contents:
Introduction
Licence
Download
Detailed Features
Screenshot
Documentation

Introduction

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/

Licence

Download

• 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?

Detailed Features

• 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.

Screenshot

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

Documentation

By Sven Sandberg, svens@it.uu.se. Last updated on 6 August 2005.