Configuring Andorra 2D
Since version 0.4.5 the "src" directory contains a file named "andorra_conf.inc", which contains all compiler switches available in Andorra 2D. This short article gives an overview over the meaning of those switches.
Using the "andorra_conf.inc"
The changes made in "src/andorra_conf.inc" are applied globally to all projects. If this is not desired, delete the "andorra_conf.inc" from the "src" directory and create a copy for all your projects. Add this file to your project or add it to its search path. If you want to be sure whether your settings are actually used, you can activate the "TEST"-switch.
Available switches
DO_NOT_INCLUDE_STD_FORMATS
The
VCL/LCL graphics format loaders, which are included by default, will be removed from your project, if you activate this switch. The
unit "Graphics" will not be needed anymore, which significantly decreases the size of the executable. As a downside, graphics formats like "BMP" etc. cannot be loaded anymore. To make this possible again, other loaders have to be included, such as "AdBMP", "AdTGA", "AdPNG" (see below), "AdDevIL" (requires the "DevIL"-library) or "AdFreeImage" (requires the "FreeImage"-library).
Another disadvantage is that generating fonts will be disabled. To use fonts in your project, you have to generate the fonts in an external application, store them in a file and load them afterwards.
DO_NOT_INCLUDE_STD_WINDOWMGR
This switch deactivates loading the
VCL/LCL window frameworks - Andorra 2D will not use the
unit "Forms" anymore. Activate this compiler switch if you are using other window frameworks such as "AdGLFW", "AdSDL" or "AdWin32". If this compiler switch is activated, Andorra 2D cannot be integrated into an existing
VCL/LCL application.
DO_NOT_USE_3DNOW
Deactivates the use of the 3DNow! instruction set extension when running on AMD processors. This extension is available on AMD processors and increases the speed of matrix multiplication (which is used quite often in Andorra 2D). Activating the "DO_NOT_USE_ASM" switch includes this switch.
DO_NOT_USE_ASM
This switch removes any assembler code from Andorra 2D. Native pascal is used.
DO_NOT_USE_INTERNAL_PNG
The image loader
unit "AdPNG" may use the external library "PNGImage" or an internal loader. The internal loader works in most cases, but still has some problems. This is why this switch is activated by default.
Copyright and license
(c) by Andreas Stöckel December 2008
This tutorial is subject to the
GNU Licence for Free Documentation