Allegro ist eine in C geschriebene Bibliothek für C/C++-Multimediaanwendungen, die auf allen großen betriebssystemen läuft und unter der zlib-Lizenz steht. Allegro umfasst Funktionen für Grafiken, Sounds, Eingabe und Zeitsteuerung und kann mit SDL oder SFML (siehe [[Spiele_programmieren_lernen#Eine_kleine_Übersicht|Übersicht im Einsteigerartikel]]) verglichen werden. Es gibt verschiedene Versionen: 4 und 5. Die Version 4 wird nicht mehr weiterentwickelt und abwärtskompatibel bis zur Version 2.

=== Installation von Allegro ===

für seinen Compiler runterladen. Danach geben wir noch in den Projekteinstellungen der IDE die entsprechenden Pfade der Header- und Bibliotheksdateien an. In unserem Fall sind das die Ordner \include und \lib. Desweiterern müssen die benötigten DLLs in den Projektordner kopiert werden.

=== Header ===

Wie (fast) jede C++-Anwedung fangen wir mit dem Einbinden der benötigten Header-Dateien an, wir benötigen dazu mehrere um alle Themen abdecken zu können.  

#include <allegro5\allegro.h>

Zusäzlich müssen wir noch die ''allegro-5.0.4-monolith-md.lib'' einbinden bzw. die ''allegro-5.0.4-monolith-md-debug.lib'' wenn wir im Debug-Modus arbeiten.

Zusätzlich müssen wir noch die ''allegro-5.0.4-monolith-md.lib'' und wenn wir im Debug-Modus arbeiten die ''allegro-5.0.4-monolith-md-debug.lib'' einbinden.

=== Variablen-Deklaration ===

In diesem Tutorial  arbeiten wir, um es einfach zu halten, nur mit der Main-Funktion. Zu beginn deklarieren wir alle nötigen Variablen und Zeiger, welche wir in der Anwendung verwenden. Dazu gehören Standard-C++ Variablen aber auch Zeiger auf Allegro-Strukturen, die wir z.B. für die Bitmap benötigen.

int screenWidth = 800;

int screenHeight = 600;

bool running = true;

bool redraw = true;

 

ALLEGRO_EVENT ev;

ALLEGRO_BITMAP* bitmap = 0;

ALLEGRO_SAMPLE* sample = 0;

ALLEGRO_FONT* font = 0;

ALLEGRO_TIMER *timer = 0;

</sourcecode>

Ist dies der Fall, können wir mit dem Aufurf der Funktion ''al_create_display'' das Fenster erstellen. Dazu übergeben wir ihr die gewünschte Fensterhöhe, bzw. -breite. Auch hier überprüfen wir wieder ob sie korrekt ausgeführt werden konnte. ist dies der Fall, sind wir bereit mit dem Erstellen des Fensters fertig.

<sourcecode lang="cpp" tab="4">

Um ein Bild darstellen zu können, muss zuerst das entsprechende Addon, das für die Bearbeitung von Bildern benötigte Addon initialisiert werden. Danach laden wir das eigentliche Bild und berechnen seine Startposition, damit es am Anfang in der Mitte des Fensters zu sehen ist. Für dieses Beispiel heißt das Bild ''Test.png''. Zeichnen können wir die Bitmap später mit der Funktion ''al_draw_bitmap''. Dazu übergeben wir den Bitmap-Zeiger, die X- und Y-Position, sowie eine ''0'' als zusätzliche Flags.

bitmap = al_load_bitmap("Test.png");

running = false;

posY = (screenHeight / 2) - (bitmapHeight / 2);  

al_reserve_samples(1);

sample = al_load_sample("Test.wav");

Abspielen können wir das Sample später mit der Funktion ''al_play_sample'', dieser übergeben wir den Zeiger des Samples, die Lautstärke, die Position (-1: links, 0: mittig, 1: recht),  die Geschwindigkeit (1: normal), die Wiedergabeart (ALLEGRO_PLAYMODE_ONCE oder ALLEGRO_PLAYMODE_LOOP) und eine ''0'', da der letzte Parameter für uns erstmal nicht relevatn ist.

al_init_font_addon();

al_init_ttf_addon();

font = al_load_font("Test.ttf", 16, 0);

Danach können wir an jeder Stelle innerhalb der Anwendung Texte in die Szene einbauen. Dazu stehen uns zwei unterschiedliche Funktionen zur Verfügung. Die erste zeichnet nur den reinen Text, die zweite kann zusätzlich noch Variablen verarbeiten (ähnlich der ''printf''-Funktion in C).

al_draw_textf(font, al_map_rgb(r, g, b), X, Y, Flags, "text...");

Damit wir in unserer Anwedung mit der Zeit arbeiten können, erstellen wir uns einen Timer. Dazu rufen wir die Funktion ''al_create_timer'' auf und Übergeben ihr als Parameter die Dauer eines einzelnen Frames. Wenn wir z.B. 60 FPS haben wollen, geben wir als Parameter ''1.0 / 60'' an. Danach überprüfen wir, ob der Timer erstellt werden konnte.

timer = al_create_timer(1.0 / 60); // 60 FPS

if(!timer)

running = false;

al_install_keyboard();

 

 

 

 

 

 

al_start_timer(timer);

Nun programmieren wir die Game-Loop. Diese ist eigentlich nur eine ''while''-Schleife, die solange ausgeführt wird, bis das Fenster geschlossen wird. Sie besteht aus mehreren Teilschirtten:

while(running)

al_wait_for_event(eventQueue, &ev);

 

frameNumber++;

Anschließend berechnen wir die neue Position des Bitmaps, dies soll in jedem Durchlauf, wenn die entsprechende Pfeiltaste gedrückt ist, um vier Pixel verschoben werden. Zusätzlich kontrollieren wir, dass die neue Position innerhalb des sichtbaren Bereichs des Fensters liegt, ist dies nicht der Fall, wird die Bitmap nicht verschoben. Damit dies in jedem Durchlauf passiert, kontrollieren wir ob es ein Event ist, das vom Timer ausgelöst wurde (''ALLEGRO_EVENT_TIMER''). Zusätzlich setzen wir die Variable ''redraw'' auf ''true'', damit die Szene ebenfalls neu gezeichnet wird.

posY -= 4.0;

running = false;

Als nächstes machen wir uns an das Abfragen der Tastatur. Wenn die entsprechende Taste gedrückt wird setzen wir das entsprechende Element des Arrays auf ''true'' und wenn sie wieder losgelassen wird auf ''false''.

<sourcecode lang="cpp" tab="4">

// Taste gedrückt

switch(ev.keyboard.keycode)

redraw = false;

al_clear_to_color(al_map_rgb(0,0,0));

Statt nun einfach das Programm zu beenden, wollen wir vorher noch den verwendeten Speicher freigeben, um mögliche Fehler zu vermeiden. Dazu rufen wir für jedes Objekt eine extra Funktion ''al_destroy_$object'' auf und übergeben ihr das entsprechende Objekt. Anschließend geben wir noch eine ''0'' an das Betriebssystem zurück und unsere Beispiel-Anwendung ist fertig.

 

#include <allegro5\allegro.h>

 

 

 

int main()

// Variablen-Deklaration

int screenWidth = 800;

bool key[4] = {false, false, false, false};

enum KEYS {UP, DOWN, LEFT, RIGHT};

 

 

 

running = false;

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

break;

 

{{Spoiler|<xh4>Ergebnis</xh4>|

[[Datei:AllegroTut.png]]

al_set_window_title(display, "Beispieltitel");

Nicht selten kommt es vor, dass ein Benutzer über mehr als einen Monitor verfügt. Allegro gibt uns die Möglichkeit, einen Monitor auszuwählen. Besonders wenn wir uns später den Vollbild-Modus anschauen kann dies wichtig sein, da man ein Fenster verschieben kann, aber keine Vollbild-Anwendung. Um den gewünschten Monitor auszuwählen, verwenden wir die Funktion ''al_set_new_display_adapter''. Als Paramet übergeben wir die Nummer des Monitors, wobei ''0'' der erste Monitor ist. Die Funktion muss ''vor'' dem Aufruf von ''al_create_display'' aufgereufen werden.

<sourcecode lang="cpp" tab="4">

</sourcecode>

 

Richtige Spielatmosphäre kommt in einem Fenster nicht wirklich auf. Deshalb schauen wir uns als nächstes an, wie wir den Vollbildmodus aktivieren können. Dabei ist zu beachten, dass wir zuerst, wie oben beschrieben, den Monitor auswählen. Nach dieser Auswahl rufen wir, ebenfalls vor dem Aufruf von ''al_create_display'', die Funktion ''al_set_new_display_falgs'' auf und übergeben ihr den Parameter ''ALLEGRO_FULLSCREEN''.

 

 

// Ein paar Beispiele (eine komplette Liste, steht in der Allegro-Dokumentation)

al_draw_line(startX, startY, endX, endY, al_map_rgb(r, g, b), Breite); // Eine Linie

al_draw_filled_rectangle(startX, startY, endX, endY, al_map_rgb(r, g, b)); // Ein Viereck

al_draw_circle(mittelX, mittelY, radius, al_map_rgb(r, g, b), Breite); // Ein Kreis

Natürlich war dies nur ein sehr kurzer Einstieg in Allegro. Allerdings sind wir nun theoretisch in der Lage ein Spiel mit Allegro zu programmieren. <br />

Unser wichtigstes Hilftmittel für die Zukunft, um mit Allegro zu programmieren, ist die [http://alleg.sourceforge.net/a5docs/refman/index.html Dokumentation]. Ansonsten gilt wie immer "Learning by doing".