j3soon / Allegro5OOPTemplate

An Object-Oriented 2D game library written from scratch. Includes a 2D tower defense game that supports enemy path-planning and homing missiles.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Allegro 5 Template for I2P(2)_2020_SR

We will use Allegro 5 OOP in mini-project 2.

Installation

Follow the steps here and remember to change all steps that contains C to C++.

Useful Links

Better Coding Environment & Basic Debugging Techniques

Video Link

FAQ

Mini Project 2

  • My mouse cursor seems to have a offset between the screen coordinate and the window coordinate.

    That's because your screen resolution is too low. Try increase the screen resolution or use hotkeys instead.

  • Can we use Code::Blocks or other IDEs to compile the project?

    Yes. Although the video shows it in Visual Studio, but using Code::Blocks, XCode, Dev-Cpp or other IDEs are also OK. You can even compile it directly through g++ or by Makefile.

  • Game crashes when winning.

    Yes the game will crash if you didn't finish TODO 5, after finishing it, winning should work fine.

  • If you want to use GIF images, you can download the plugin algif.

    It can be used like videos after putting the library under your project folder.

  • If you want to load MP3 audio, you can try out streaming as mentioned here.

  • If you play multiple BGMs or sound effects at the same time, the al_play_sample could fail and the sound would not come out.

    You can set reserveSamples to a higher value.

  • Unable to find resources when open the executable file located in ...\bin\ directly.

    You can copy all used resources to the ...\bin folder, since the executable file searches for the resources file located in the same folder.

  • Error message: assertion failed ... bitmap_draw...

    A high chance is that you didn't initialize one of your image file before drawing it. e.g.

    ALLEGRO_BITMAP* img;
    ...
    al_draw_bitmap(img, ...);

    The full error message:

    Assertion failed!
    
    Program: <PATH>\program.exe
    File: <PATH>/bitmap_draw.c, Line 140
    
    Expression: bitmap
    
  • al_load_bitmap keeps failing, but I've done nothing wrong.

    Some image files you downloaded from the internet might be in the incorrect format. You can open it in PhotoShop, GIMP, Paint.NET, ... and re-save it as *.png or any format you want. This problem occurs sometime if you are using Chrome, but it doesn't occur if you use Firefox.

    For example: You can try to save this image: http://img1.3png.com/340af8a9dd2e666738f797b6573a963e1e8f.png. Although it says it's a PNG file, but it's actually a JPEG file. If you don't believe it, you can open it in Notepad, Notepad++, ... You'll see the JFIF at the beginning lines, if it's a PNG file, you should see NG.

  • If your game loading time is very long, it is caused by the large music files. You can change the file to other audio, or simply disable (don't load) background music.

  • Key strokes cannot be detected.

    You should change your input from Chinese to English, otherwise the keycode will be different.

Installation on Windows

  • Cannot compile on Dev-C++. (unwind...)

    Project > Project Options... > Parameters > Linker add one more line below:

    -Wl,--allow-multiple-definition.

  • Cannot compile on Visual Studio. (unresolved external symbol...)

    • Remember to check Support C++ Desktop when installing.

    • Download the project here and find the TowerDefense/TowerDefense.sln file and double-click it.

    • For Visual Studio you may try out different configurations such as Debug x64, Debug x86, Release x64, Release x86.

    • When setting the configuration of Allegro5 plugins, make sure to set in All Configurations and All Platforms.

    • When not using Visual Studio 2017 (Using 2019 or other versions), choose any downloaded Windows SDK Version and any Platform Toolset. (Make sure the options you chose are installed in your computer)

    • If the compilation failed in Visual Studio, and you received the error message: Warning MSB8003 The WindowsSDKDir property is not defined. Some build tools may not be found., you may forgot to install Windows SDK:

      You may want to install the newest version. (or any version you want)

  • Cannot compile on Code::Blocks.

    For Code::Blocks you should create a project following the tutorial above, and set the project settings to allow C++11.

    The settings are almost the same in other IDEs.

    For 'abs(float&)' is ambiguous you can change 4 abs to fabs.

  • File allegro-5.0.10-monolith-mt-debug.dll is missing in Code::Blocks

    Find the file allegro/bin/allegro-5.0.10-monolith-mt-debug.dll located inside the unzipped library folder.

    Copy it to your project folder under bin\Debug. If these folders don't exist, you can create them by yourself, or simply compile and run the code, your IDE will create them for you.

  • Header not found using the new version Allegro5.2 in Dev-C++

    fatal error: allegro5/allegro.h: No such file or directory

    The include and library paths assume that you have extracted the library using the built-in Extract All..., and put it into the C drive.

    A way to check if you had put them in the correct path is to see if the include path really exists in the file system.

  • Cannot find resource files

    You should drag your resource files into your project folder.

  • Redefinition of ...

    You need to keep only one main function in one project, for example you may have both task_1_ans.c and task_2_ans.c in your project. You should only keep one.

    Or you might accidentally edit the Allgero5 library header, re-installing the library may help.

  • When reopen the project, all settings are gone.

    For Code::Blocks you should open the *.cbp file.

    For Dev-C++ you should open the *.dev file. If all files disappear, use Project > Add To Project... and select all files.

  • On Code::Blocks Release mode: The Application was Unable to Start Correctly (0xc000007b)

    You should copy both allegro_monolith-5.2.dll and allegro-5.2.dll to your /Release folder.

    Or you should copy both allegro_monolith-debug-5.2.dll and allegro-5.2.dll to your /Debug folder.

  • I want to hide the console window.

    For Code::Blocks:

    Set the build target type to GUI application.

    For other IDEs there are also such settings.

Installation on Mac OS

  • There are OpenGL related bugs in newer version of XCode make sure to use XCode versions prior or equal to 10.3.

  • Command not found - brew

    When installing homebrew, it'll ask you to press Return to continue, you must press Enter and type your password to continue installing.

    If you press any other keys, it'll abort the installation process.

  • Password are not read by terminal

    The password you type won't be shown on the terminal (it won't have something like ****). You can just type your password and press Enter.

  • Cannot find resource files

    You should drag your the resource folder (resources\) into your project, the process is like below but with the resources\ folder.

  • Redefinition of ...

    You need to keep only one main function in one project, for example you may have both task_1_ans.c and task_2_ans.c in your project. You should only keep one.

    Or you might accidentally edit the Allgero5 library header (e.g. fmaths.inl), re-installing the library using the command below may help.

    brew uninstall allegro
    brew install allegro

About

An Object-Oriented 2D game library written from scratch. Includes a 2D tower defense game that supports enemy path-planning and homing missiles.


Languages

Language:C++ 99.3%Language:Makefile 0.7%