______   ___    ___
/\  _  \ /\_ \  /\_ \
\ \ \L\ \\//\ \ \//\ \      __     __   _  __  ___        __    ___      ____
 \ \  __ \ \ \ \  \ \ \   /'__`\ /'_ `\/\`'__\/ __`\    /'__`\ /\__`\  /'___/
  \ \ \/\ \ \_\ \_ \_\ \_/\  __//\ \L\ \ \ \//\ \L\ \__/\ \L\ \\/ __ \/\____`\
   \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/\_\ \  __//\____/\/\____/
    \/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/\/_/\ \ \/ \/___/  \/___/
                                   /\____/               \ \_\
     Version 5.2                   \/___/                 \/_/

  A wrapper to use the Allegro library with Pascal compilers
  by Guillermo "Ñuño" Martínez, November 10, 2024.

Introduction

Allegro.pas is a wrapper that allows Pascal compilers (such as Free Pascal and Delphi) to use the Allegro library.

Note that Allegro 5 is wholly incompatible with Allegro 4 and earlier versions, and so Allegro.pas is, but both may be installed at the same time without conflicts.

Current version was tested with Free Pascal on Windows 7, Windows 11 and GNU/Linux, both 32bit and 64 bit, and with Delphi 11.3 Community Edition on Windows 32bit. MacOS was tested but it is no possible to make it work. Other operating systems and compilers weren't tested.

Changes between versions 5.2.b.1-1 and 5.2.0

API changes

• Most pointers are types instead of aliases now.
• al_get_opengl_variant returns an ALLEGRO_OPENGL_VARIANT now.
• Removed constants ALLEGRO_IS_ALPHA and ALLEGRO_IS_BETA.
• al_init_user_event_source and al_destroy_user_event_source get pointers now. This should prevent issues with optimizations.
• Removed threading support as it seems no compatible with Pascal.
• Removed al5nativedlg unit as it seems no compatible with Pascal.

News

• Added notes about threading.
• Added stuff from Allegro 5.2.8:
• Audio devices.
• Oklab color space.
• Linear color conversion.
• New shader modes.
• Platform identification.
• Transformation transpose.

Other

• Added FAQ file.
• Improved Delphi compatibility.
• New examples that are more how to do this and less look how cool is this.
• A few internal changes in al5strings that should improve compatability.