Unit alUNIX

This function is only available under X. It lets you to specify the window name and group (or class). They are important because they allow the window manager to remember the window attributes (position, layer, etc). Note that the name and the title of the window are two different things: the title is what appears in the title bar of the window, but usually has no other effects on the behaviour of the application.

See also

al_set_window_title

On platforms that are capable of it, this routine alters the window title for your Allegro program.

X Windows system driver.

See also

al_install

Initialises the Allegro library.

Linux system driver.

See also

al_install

Initialises the Allegro library.

The standard X graphics driver. This should work on any Unix system, and can operate remotely. It does not require root permissions. If the ARGB cursor extension is available, this driver is capable of displaying a hardware cursor. This needs to be enabled by calling al_enable_hardware_cursor because it cannot be used reliably alongside al_get_mouse_mickeys.

See also

al_set_gfx_mode

Switches into graphics mode.

AL_GFX_XWINDOWS_FULLSCREEN

The same as AL_GFX_XWINDOWS, but while AL_GFX_XWINDOWS runs windowed, this one uses the XF86VidMode extension to make it run in fullscreen mode even without root permissions.

The same as AL_GFX_XWINDOWS, but while AL_GFX_XWINDOWS runs windowed, this one uses the XF86VidMode extension to make it run in fullscreen mode even without root permissions. You're still using the standard X protocol though, so expect the same low performances as with the windowed driver version. If the ARGB cursor extension is available, this driver is capable of displaying a hardware cursor. This needs to be enabled by calling al_enable_hardware_cursor because it cannot be used reliably alongside al_get_mouse_mickeys.

See also

al_set_gfx_mode

Switches into graphics mode.

AL_GFX_XWINDOWS

The standard X graphics driver.

Uses new DGA 2.0 extension provided by XFree86 4.0.x. This will work in fullscreen mode, and it will support hardware acceleration if available. This driver requires root permissions.

See also

al_set_gfx_mode

Switches into graphics mode.

AL_GFX_XDGA2_SOFT

The same as AL_GFX_XDGA2, but turns off hardware acceleration support.

The same as AL_GFX_XDGA2, but turns off hardware acceleration support. This driver requires root permissions.

See also

al_set_gfx_mode

Switches into graphics mode.

AL_GFX_XDGA2

Uses new DGA 2.0 extension provided by XFree86 4.0.x.

Uses the framebuffer device (eg. /dev/fb0). This requires you to have framebuffer support compiled into your kernel, and correctly configured for your hardware. It is currently the only console mode driver that will work without root permissions, unless you are using a development version of SVGAlib.

See also

al_set_gfx_mode

Switches into graphics mode.

Uses a VBE/AF driver (vbeaf.drv), assuming that you have installed one which works under Linux (currently only two of the FreeBE/AF project drivers are capable of this: I don't know about the SciTech ones). VBE/AF requires root permissions, but is currently the only Linux driver which supports hardware accelerated graphics.

Note: Previous paragraph may be outdated.

See also

al_set_gfx_mode

Switches into graphics mode.

Uses the SVGAlib library for graphics output. This requires root permissions if your version of SVGAlib requires them.

See also

al_set_gfx_mode

Switches into graphics mode.

Uses direct hardware access to set standard VGA resolutions, supporting the same modes as in the DOS version of this driver. Requires root permissions.

See also

al_set_gfx_mode

Switches into graphics mode.

Uses direct hardware access to set standard but not documented Mode-X resolutions, supporting the same modes as in the DOS version of this driver. Requires root permissions.

See also

al_set_gfx_mode

Switches into graphics mode.

Open Sound System.

See also

al_install_sound

Initialises the sound module.

Enlightened Sound Daemon.

See also

al_install_sound

Initialises the sound module.

aRts (Analog Real-Time Synthesizer).

See also

al_install_sound

Initialises the sound module.

ALSA sound driver.

See also

al_install_sound

Initialises the sound module.

JACK sound driver.

See also

al_install_sound

Initialises the sound module.

Open Sound System.

See also

al_install_sound

Initialises the sound module.

ALSA RawMIDI driver.

See also

al_install_sound

Initialises the sound module.

Regular joystick interface. Joystick support needs to be enabled in your kernel.

See also

al_install_joystick

Installs Allegro's joystick handler, and calibrates the centre position values.

This is a pointer to the Allegro X11 icon, which is in the format of standard .xpm bitmap data. You do not normally have to bother with this at all: you can use the xfixicon.sh utility from the tools/x11 directory to convert a true colour bitmap to a C file that you only need to link with your own code to set the icon.