Scribd
Upload
5 views

bcc32

This document provides instructions for using Allegro with Borland C++Builder, including required software and installation steps. It details how to set up the environment, compile Allegro-based programs, and link with the necessary libraries. Additionally, it offers a workaround for compiling C++ programs that include Allegro headers and emphasizes the need to distribute the appropriate DLLs with the programs.

Uploaded by

jjbgamesstudio
Copyright
© © All Rights Reserved
Available Formats
Download as TXT, PDF, TXT or read online on Scribd
5 views

bcc32

This document provides instructions for using Allegro with Borland C++Builder, including required software and installation steps. It details how to set up the environment, compile Allegro-based programs, and link with the necessary libraries. Additionally, it offers a workaround for compiling C++ programs that include Allegro headers and emphasizes the need to distribute the appropriate DLLs with the programs.

Uploaded by

jjbgamesstudio
Copyright
© © All Rights Reserved
Available Formats
Download as TXT, PDF, TXT or read online on Scribd
You are on page 1/ 2

______ ___ ___

/\ _ \ /\_ \ /\_ \
\ \ \L\ \\//\ \ \//\ \ __ __ _ __ ___
\ \ __ \ \ \ \ \ \ \ /'__`\ /'_ `\/\`'__\/ __`\
\ \ \/\ \ \_\ \_ \_\ \_/\ __//\ \L\ \ \ \//\ \L\ \
\ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/
\/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/
/\____/
\_/__/

Borland C++Builder-specific information.

See readme.txt for a more general overview.

====================================
=========== BCC32 notes ============
====================================

Status: it works. It currently doesn't build the Allegro library


from the sources, but it does let you compile your own Allegro-based
programs and run them with the Allegro DLLs. Thanks to Inprise for
creating the very useful IMPLIB program.

===========================================
============ Required software ============
===========================================

- Borland C++Builder (or Borland C++ command line tools)


- Recent set of DirectX and other Windows SDK headers.
- GNU make 3.77 or higher.
- Optional: GNU sed. Used by "make depend" and "fixdll.bat".
- Optional: GNU sort (not DOS sort). Used by "fixdll.bat".

In order to run your programs, you need to obtain the Allegro DLLs and
install them in the Windows system directory.

This is known to work with the Borland C++ 5.5 command line compiler.
Earlier versions may cause problems (for example v5.02).

You need to use GNU make, since Borland make is really ugly about its
makefiles. You can grab it from either the MinGW32 or DJGPP
distributions; more info on this in available in the following files:
docs/build/mingw32.txt and docs/build/djgpp.txt.

============================================
============ Installing Allegro ============
============================================

Set up your environment so that Borland C++ can be used from the
commandline. Then set the variable BCC32DIR to the directory where
Borland C++ is located, for example 'set BCC32DIR=c:\bcc32'.
Type "cd allegro" and then "fix.bat bcc32". Then, run "make". Find
something fun to do while it's compiling. It will eventually
finish; then just type "make install" to set the library up for use.

If you also want to install a debugging version of the library (highly


recommended), type "make install DEBUGMODE=1". Case is important, so
it must be DEBUGMODE, not debugmode!

If you also want to install a profiling version of the library, now type
"make install PROFILEMODE=1".

If your copy of Allegro doesn't include the makefile.dep dependency files


(unlikely, unless you have run "make veryclean" at some point), you can
regenerate them by running "make depend".

If your copy of Allegro doesn't include the linker .def file (unlikely,
unless you have run "make veryclean" at some point), you can regenerate
it by running "misc\fixdll.bat".

=======================================
============ Using Allegro ============
=======================================

All the Allegro functions, variables, and data structures are defined in
allegro.h. You should include this in your programs, and link with one of
the libraries:

alleg.lib - optimised DLL import library


alld.lib - debugging DLL import library
allp.lib - profiling DLL import library

Don't forget that you need to use the END_OF_MAIN() macro right after
your main() function!

Note: including any Allegro headers in a C++ program currently prevents


Borland C++ from compiling it. The workaround is to include the following
6 standard C headers prior to including any Allegro headers:
#include <errno.h>
#include <limits.h>
#include <stdarg.h>
#include <stddef.h>
#include <stdlib.h>
#include <time.h>

You will need to distribute the appropriate DLL along with your program.

You might also like