B
Bartlomiej Borowicz
of course a read instrucitio and i did everythink, but i still can't
use that library
---
Setting up Dev-C++ to build Allegro
Some people prefer to use the Dev-C++ distribution to make Allegro
programs. Dev-C++ is a neat development IDE and includes an updated
MingW32 compiler. Please do not unzip or install anything until
step 4.
Getting what you need:
1) Download the complete MingW32 distribution from
'http://www.mingw.org'
You should download the complete package instead the many small
ones
unless you want to move files manually. At the time of
writing
(November, 2001) version 1.1 is the newest. A direct link is
here:
'http://prdownloads.sourceforge.net/mingw/MinGW-1.1.tar.gz'
2) Download the Dev-C++ 4 IDE (without MingW32 compiler and
libraries)
from 'http://www.bloodshed.net/dev/download.html'.
Once again, make sure you do not install it until you get to
step 4.
3) Get the minimal DirectX 7 SDK for MingW32. (dx70_mgw.zip)
Download it
from 'http://alleg.sourceforge.net/wip.html'. Please don't
confuse it
with dx70_min.zip.
Installation process:
4) Install the package from step 1. I recommend you unzip it
to 'C:\Dev-Cpp' (the following steps assume this is what you
used).
Do NOT install it in a directory name with spaces, plus signs,
slashes,
or anything else that's fancy enough to break the compiler.
That goes double for people installing in C:\Program Files.
5) Install the package from step 2 to 'C:\Dev-Cpp'. Overwrite any
existing
files.
6) Unzip the file from step 3 to 'C:\Dev-Cpp' Overwrite any
existing
files.
7) You now need to add 'C:\Dev-Cpp\bin' to the *beginning* of your
PATH.
If you use Windows 9x you can add the line
'path c:\Dev-Cpp\bin;%PATH%' to the end of your
'c:\autoexec.bat'
file. You can use 'edit', 'msconfig', 'sysedit', 'notepad' or
any
other editor capable of editing ASCII text.
If you use Windows ME, you'll need to run 'msconfig', then
select the
'Environment' tab, and add 'c:\Dev-Cpp\bin' to PATH.
If you use Windows NT (which includes 2000 and XP) then open
Control Panel, and click the 'System' applet, then the
'Advanced' tab,
and finally the 'Environment' button. Select the PATH= entry,
and add
'c:\Dev-Cpp\bin' to it.
8) Likewise add the line 'set MINGDIR=C:\Dev-Cpp' to your
'c:\autoexec.bat'.
9) Now reboot!
Test the installation by typing the following on the command line:
'gcc -v'. The answer should be simmilar to:
Using builtin specs.
gcc version 2.95.2 19991024 (release)
(click on Start -> Run then type "command" or "cmd" to get a
command
prompt.)
10) Now scroll down a bit for instructions on how to install
Allegro
and an example program.
Installing Allegro
Step-by-step instructions on how to build the MingW32 version of
Allegro.
This assumes you have unzipped allegro to c:\allegro
First configure Allegro by entering the following on the
commandline:
(click on Start -> Run then type "command" or "cmd" to get a
command
prompt)
cd c:\allegro
fix.bat mingw32
The dynamically linked version of Allegro gets built by default but
if
you want to build the statically linked version of Allegro write
the
following on the command line:
SET STATICLINK=1
If you want to build either the debug or the profiling version of
the library enter one of the following. Skip them to build the
release (default) version.
SET DEBUGMODE=1
SET PROFILEMODE=1
Now we're ready to make the Allegro library.
make
If your copy of Allegro does not include the linker .def file
(unlikely,
unless you have run "make veryclean" at some point, or are using
the CVS
version of Allegro), you can regenerate it by running
"misc\fixdll.bat".
You will need to have GNU sed and sort installed for this operation
to
work. The version of sed that is linked from the MingW32 site does
not
work properly; it has issues with end-of-line characters. You
should get
sed and sort from the link at the top of this document.
Once the build is finished you can recover some disk space by
running
"make compress", which uses the UPX program to compress the
executable
files and the optimized dll. Before running "make compress", you
must set
the environment variable UPX_BIN to point to upx.exe. You will have
to
do run "make compress" before "make install" if you want the
compressed
dll to be copied to the windows directory. To recover even more
disk
space, you can run "make clean" to get rid of all the temporary
files and
HTML format documentation.
And then the last thing; Installing the Allegro library.
make install
You have now installed MingW32 and allegro! See the rest of the
documentation and examples to learn more about it.
A simple example on how to create a little program with Dev-C++:
Launch Dev-C++ and create a new project (File/New Project). Select
"Windows Application", then click on the "Ok" button. Name your
project and give associate it to a new file. You should now see a
sample code in a window. Close that window since you won't be
needing it (Allegro is much simpler to use than this). Create a
new file (File/New Source File), then write a small Allegro
program. You can inspire yourself by the Allegro examples if you
wish. Here's a small program you can type to see if everything
worked until now:
#include <allegro.h>
int main() {
allegro_init();
allegro_message("Hello World!");
return 0;
}
END_OF_MAIN();
You now need to tell Dev-C++ that you'd like to make a program that
uses Allegro. For that, go in the Project Options screen
(Project/Project Options menu), then enter -lalleg (or -lalld for
the debug mode) in the box under 'Further object file or linker
options'.
Compile your project! Simply click on the green check mark on
your Dev-C++ toolbar. Correct any syntax errors in your code,
then click on "Execute" to run the program. If all worked
you will see a message box pop up with "Hello World" inside of it.
Happy coding!
use that library
---
Setting up Dev-C++ to build Allegro
Some people prefer to use the Dev-C++ distribution to make Allegro
programs. Dev-C++ is a neat development IDE and includes an updated
MingW32 compiler. Please do not unzip or install anything until
step 4.
Getting what you need:
1) Download the complete MingW32 distribution from
'http://www.mingw.org'
You should download the complete package instead the many small
ones
unless you want to move files manually.
At the time ofwriting
(November, 2001) version 1.1 is the newest. A direct link is
here:
'http://prdownloads.sourceforge.net/mingw/MinGW-1.1.tar.gz'
2) Download the Dev-C++ 4 IDE (without MingW32 compiler and
libraries)
from 'http://www.bloodshed.net/dev/download.html'.
Once again, make sure you do not install it until you get to
step 4.
3) Get the minimal DirectX 7 SDK for MingW32. (dx70_mgw.zip)
Download it
from 'http://alleg.sourceforge.net/wip.html'. Please don't
confuse it
with dx70_min.zip.
Installation process:
4) Install the package from step 1. I recommend you unzip it
to 'C:\Dev-Cpp' (the following steps assume this is what you
used).
Do NOT install it in a directory name with spaces, plus signs,
slashes,
or anything else that's fancy enough to break the compiler.
That goes double for people installing in C:\Program Files.
5) Install the package from step 2 to 'C:\Dev-Cpp'. Overwrite any
existing
files.
6) Unzip the file from step 3 to 'C:\Dev-Cpp' Overwrite any
existing
files.
7) You now need to add 'C:\Dev-Cpp\bin' to the *beginning* of your
PATH.
If you use Windows 9x you can add the line
'path c:\Dev-Cpp\bin;%PATH%' to the end of your
'c:\autoexec.bat'
file. You can use 'edit', 'msconfig', 'sysedit', 'notepad' or
any
other editor capable of editing ASCII text.
If you use Windows ME, you'll need to run 'msconfig', then
select the
'Environment' tab, and add 'c:\Dev-Cpp\bin' to PATH.
If you use Windows NT (which includes 2000 and XP) then open
Control Panel, and click the 'System' applet, then the
'Advanced' tab,
and finally the 'Environment' button. Select the PATH= entry,
and add
'c:\Dev-Cpp\bin' to it.
8) Likewise add the line 'set MINGDIR=C:\Dev-Cpp' to your
'c:\autoexec.bat'.
9) Now reboot!
Test the installation by typing the following on the command line:
'gcc -v'. The answer should be simmilar to:
Using builtin specs.
gcc version 2.95.2 19991024 (release)
(click on Start -> Run then type "command" or "cmd" to get a
command
prompt.)
10) Now scroll down a bit for instructions on how to install
Allegro
and an example program.
Installing Allegro
Step-by-step instructions on how to build the MingW32 version of
Allegro.
This assumes you have unzipped allegro to c:\allegro
First configure Allegro by entering the following on the
commandline:
(click on Start -> Run then type "command" or "cmd" to get a
command
prompt)
cd c:\allegro
fix.bat mingw32
The dynamically linked version of Allegro gets built by default but
if
you want to build the statically linked version of Allegro write
the
following on the command line:
SET STATICLINK=1
If you want to build either the debug or the profiling version of
the library enter one of the following. Skip them to build the
release (default) version.
SET DEBUGMODE=1
SET PROFILEMODE=1
Now we're ready to make the Allegro library.
make
If your copy of Allegro does not include the linker .def file
(unlikely,
unless you have run "make veryclean" at some point, or are using
the CVS
version of Allegro), you can regenerate it by running
"misc\fixdll.bat".
You will need to have GNU sed and sort installed for this operation
to
work. The version of sed that is linked from the MingW32 site does
not
work properly; it has issues with end-of-line characters. You
should get
sed and sort from the link at the top of this document.
Once the build is finished you can recover some disk space by
running
"make compress", which uses the UPX program to compress the
executable
files and the optimized dll. Before running "make compress", you
must set
the environment variable UPX_BIN to point to upx.exe. You will have
to
do run "make compress" before "make install" if you want the
compressed
dll to be copied to the windows directory. To recover even more
disk
space, you can run "make clean" to get rid of all the temporary
files and
HTML format documentation.
And then the last thing; Installing the Allegro library.
make install
You have now installed MingW32 and allegro! See the rest of the
documentation and examples to learn more about it.
A simple example on how to create a little program with Dev-C++:
Launch Dev-C++ and create a new project (File/New Project). Select
"Windows Application", then click on the "Ok" button. Name your
project and give associate it to a new file. You should now see a
sample code in a window. Close that window since you won't be
needing it (Allegro is much simpler to use than this). Create a
new file (File/New Source File), then write a small Allegro
program. You can inspire yourself by the Allegro examples if you
wish. Here's a small program you can type to see if everything
worked until now:
#include <allegro.h>
int main() {
allegro_init();
allegro_message("Hello World!");
return 0;
}
END_OF_MAIN();
You now need to tell Dev-C++ that you'd like to make a program that
uses Allegro. For that, go in the Project Options screen
(Project/Project Options menu), then enter -lalleg (or -lalld for
the debug mode) in the box under 'Further object file or linker
options'.
Compile your project! Simply click on the green check mark on
your Dev-C++ toolbar. Correct any syntax errors in your code,
then click on "Execute" to run the program. If all worked
you will see a message box pop up with "Hello World" inside of it.
Happy coding!