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

Dialogs Made Easy version 1.2.4

Readme File


by Sven Sandberg



Dime is a library with functions for constructing Allegro gui dialogs in a simple way similar to scanf(), but much nicer for the user of course. You only need one line of code to create a dialog where the user can input eg two integers and one string, and select one file. This way it becomes a lot easier to open certain kinds of dialogs.

The following platforms are supported: DOS/DJGPP, DOS/Watcom, Linux, Windows/Mingw32 and Windows/MSVC.

This documentation is compiled the same way as Allegro's, so after installing the library you can read it in txt, html, inf, rtf or man format.


Dime is released under the conditions of the GNU Lesser General Public License, LGPL. In practice this means that you are allowed to use the library for your projects, no matter the license of your project. But if you distribute or modify Dime itself, you must give away the source code of this (possibly new) library under the same conditions that it was given to you. Please read the details in license.txt.


You need to have installed and compiled Allegro (http://www.talula.demon.co.uk/allegro/). You need at least version 3.9.35 (3.12 won't do, it's very old!). All other requirements must already be fulfilled if you manage to compile Allegro.


Installation goes in three simple steps, and should be familiar since it is exactly the same way as you installed Allegro:

That's it! You may also want to perform some of the optional steps:


You need Allegro in order to use this library. You most likely already have it since you found this library, but if you don't have it you should download it from http://www.talula.demon.co.uk/allegro/ and get familiar with it before using Dime.

#include <dime.h> in the top of each file that uses a function from the library.

If you link on the command line, link with '-ldime -lalleg'. It is important that you specify the libraries in that order. If you want the ability to debug inside dime's functions, or if you want the library to check for bad format strings (recommended for everything that is not a release version), then link with '-ldimed' instead of '-ldime'.

If you use RHIDE, go to the menu Options/Libraries and fill in dime. It is important that dime is above alleg. Don't forget to check the box to the left of the library. You may replace dime with dimed to include debugging information.

Before calling `dialogf()' or `vdialogf()' you must have initialized Allegro by calling `allegro_init()', `install_keyboard()', `install_mouse()', and `set_gfx_mode()'. Then you must call `dime_init()' to initialize Dime and after this, Dime's functions are ready to use.

Common Problems

It is easy to give invalid arguments to `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


Homepage: Telephone: Real Life Address: