Skip to content

Latest commit

 

History

History
233 lines (163 loc) · 7.59 KB

README.md

File metadata and controls

233 lines (163 loc) · 7.59 KB

Installation

Windows

Code::Blocks

Step-by-step tutorial on YouTube.

  • Download allegro-mingw-gcc6.2.0-x86-static-5.2.2.zip

    Un-zip the file and move it to your C drive. The full path should be like: C:\allegro-mingw-gcc6.2.0-x86-static-5.2.2\allegro

  • Create a new project

    • Open Code::Blocks
    • File > New > Project...
    • Click Console application and Go.
    • Click Next, Select C and Next.
    • Enter title allegro-test, Next, Finish.

  • Set up project

    • Project > Build options...

    • [Optional] In Compiler settings > Compiler flags, you can check the -std=c99 flag if you want to use C99 features.

    • Set up include directories

      Make sure that the focus on the left side is the project name (allegro-test). Select Search directories > Compiler and click Add, paste the following path into the textbox and click OK.

      C:\allegro-mingw-gcc6.2.0-x86-static-5.2.2\allegro\include\

    • Set up library directories

      Make sure that the focus on the left side is the project name (allegro-test). Select Search directories > Linker and click Add, paste the following path into the textbox and click OK.

      C:\allegro-mingw-gcc6.2.0-x86-static-5.2.2\allegro\lib\

    • Select Debug at the left side. Select Linker settings and click Add, paste the following path into the textbox and click OK.

      C:\allegro-mingw-gcc6.2.0-x86-static-5.2.2\allegro\lib\liballegro_monolith-debug.dll.a

    • Select Release at the left side. Select Linker settings and click Add, paste the following path into the textbox and click OK.

      C:\allegro-mingw-gcc6.2.0-x86-static-5.2.2\allegro\lib\liballegro_monolith.dll.a

    • Click OK.

  • Test the library

    • Copy the code below and paste to your main.c at the left side Projects > Workspace > [ProjectName](allegro-test) > Sources > main.c:

      #include <allegro5/allegro.h>
#include <allegro5/allegro_font.h>
int main(int argc, char **argv) {
    al_init();
    al_init_font_addon();
    ALLEGRO_DISPLAY* display = al_create_display(800, 600);
    ALLEGRO_FONT* font = al_create_builtin_font();
    al_clear_to_color(al_map_rgb(0, 0, 0));
    al_draw_text(font, al_map_rgb(255, 255, 255), 400, 300, ALLEGRO_ALIGN_CENTER, "Welcome to Allegro!");
    al_flip_display();
    al_rest(5.0);
    al_destroy_font(font);
    al_destroy_display(display);
    return 0;
}

    • Press F9 to compile and run.

    • If it pops a dll not found error, copy the file below to [Project Directory]\bin\Debug\

      C:\allegro-mingw-gcc6.2.0-x86-static-5.2.2\allegro\bin\allegro_monolith-debug-5.2.dll

    • Press F9 and the window will pop out saying "Welcome to Allegro!".

Dev-C++

Step-by-step tutorial on YouTube.

Just watch the video will be enough.

Visual Studio

Step-by-step tutorial on YouTube.

Just watch the video will be enough.

Mac OS

XCode

Step-by-step tutorial on YouTube.

Open Terminal and type:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

You might need to enter your password and press yes a several times.

After finish installing, type:

brew install allegro

Open XCode, Create a new MacOS project, choose App.

Product Name type allegro-test, and for Organization Identifier, you can type anything you want. For language, choose Objective-C, and uncheck all other checkboxes.

Delete AppDelegate.h, AppDelegate.m, Main.m and select Move to Trash.

Click your project at the left side, go to Building Settings > All and search Search Paths.

Under Search Paths, set Header Search Paths to /usr/local/include and set Library Search Paths to /usr/local/lib. Both use non-recursive.

Open terminal and type:

cd /usr/local/Cellar
open .

Navigate to allegro/5.2.6.0/lib/

Sort by Modified date and select all files that is modified today. (don't need to select the pkgconfig folder)

Go back to XCode and click General

Drag the selected files into the Frameworks, Libraries, and Embedded Content.

Create main.c (File > New > File... > C file), uncheck Also create a header file.

Paste the code below to the file.

#include <allegro5/allegro.h>
#include <allegro5/allegro_font.h>
int main(int argc, char **argv) {
    al_init();
    al_init_font_addon();
    ALLEGRO_DISPLAY* display = al_create_display(800, 600);
    ALLEGRO_FONT* font = al_create_builtin_font();
    al_clear_to_color(al_map_rgb(0, 0, 0));
    al_draw_text(font, al_map_rgb(255, 255, 255), 400, 300, ALLEGRO_ALIGN_CENTER, "Welcome to Allegro!");
    al_flip_display();
    al_rest(5.0);
    al_destroy_font(font);
    al_destroy_display(display);
    return 0;
}

Click the Play button.

Others

Inspect your processor and download the corresponding library:

Unzip the file and put it under C drive.

Create main.c and paste the code below:

#include <allegro5/allegro.h>
#include <allegro5/allegro_font.h>
int main(int argc, char **argv) {
    al_init();
    al_init_font_addon();
    ALLEGRO_DISPLAY* display = al_create_display(800, 600);
    ALLEGRO_FONT* font = al_create_builtin_font();
    al_clear_to_color(al_map_rgb(0, 0, 0));
    al_draw_text(font, al_map_rgb(255, 255, 255), 400, 300, ALLEGRO_ALIGN_CENTER, "Welcome to Allegro!");
    al_flip_display();
    al_rest(5.0);
    al_destroy_font(font);
    al_destroy_display(display);
    return 0;
}

Type the command that matches your download.

gcc -Wall -g -IC:\allegro-i686-w64-mingw32-gcc-7.2.0-posix-dwarf-static-5.2.4.1\allegro\include main.c -LC:\allegro-i686-w64-mingw32-gcc-7.2.0-posix-dwarf-static-5.2.4.1\allegro\lib -lallegro_monolith.dll
gcc -Wall -g -IC:\allegro-x86_64-w64-mingw32-gcc-7.2.0-posix-seh-static-5.2.4.1\allegro\include main.c -LC:\allegro-x86_64-w64-mingw32-gcc-7.2.0-posix-seh-static-5.2.4.1\allegro\lib -lallegro_monolith.dll
gcc -Wall -g -IC:\allegro-mingw-gcc6.2.0-x86-static-5.2.2\allegro\include main.c -LC:\allegro-mingw-gcc6.2.0-x86-static-5.2.2\allegro\lib -lallegro_monolith.dll
gcc -Wall -g -IC:\allegro-mingw-gcc6.2.0-x64-static-5.2.2\allegro\include main.c -LC:\allegro-mingw-gcc6.2.0-x64-static-5.2.2\allegro\lib -lallegro_monolith.dll