--- /srv/reproducible-results/rbuild-debian/r-b-build.aqGUUDhu/b1/allegro5_5.2.10.1+dfsg-1_i386.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.aqGUUDhu/b2/allegro5_5.2.10.1+dfsg-1_i386.changes ├── Files │ @@ -1,9 +1,9 @@ │ │ - 60716dc8230050d46954996d8be821ff 1400540 doc optional allegro5-doc_5.2.10.1+dfsg-1_all.deb │ + 5fcf23c4133debf74eaae9f5bb89baba 1408704 doc optional allegro5-doc_5.2.10.1+dfsg-1_all.deb │ 1092523e273263426abe3153aa510aaa 19380 libdevel optional liballegro-acodec5-dev_5.2.10.1+dfsg-1_i386.deb │ ce22528f045b9e931b7a602d0e19cc48 53724 debug optional liballegro-acodec5.2t64-dbgsym_5.2.10.1+dfsg-1_i386.deb │ f85662f6349ee07110aea85ba66f3830 40676 libs optional liballegro-acodec5.2t64_5.2.10.1+dfsg-1_i386.deb │ 53ff3b0fad5f7bb46d71af2356ed3131 22156 libdevel optional liballegro-audio5-dev_5.2.10.1+dfsg-1_i386.deb │ 075b7dd654a05f98fbdbdefda5bf65e0 91664 debug optional liballegro-audio5.2t64-dbgsym_5.2.10.1+dfsg-1_i386.deb │ 54be11ae91720ce3eadbb2ec1529fbe8 64308 libs optional liballegro-audio5.2t64_5.2.10.1+dfsg-1_i386.deb │ 4dcd9560aea0bf0cb8720646b820ae5c 20432 libdevel optional liballegro-dialog5-dev_5.2.10.1+dfsg-1_i386.deb ├── allegro5-doc_5.2.10.1+dfsg-1_all.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2025-01-09 13:52:42.000000 debian-binary │ │ --rw-r--r-- 0 0 0 31656 2025-01-09 13:52:42.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 1368692 2025-01-09 13:52:42.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 31692 2025-01-09 13:52:42.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 1376820 2025-01-09 13:52:42.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./control │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ Package: allegro5-doc │ │ │ │ Source: allegro5 │ │ │ │ Version: 2:5.2.10.1+dfsg-1 │ │ │ │ Architecture: all │ │ │ │ Maintainer: Debian Games Team │ │ │ │ -Installed-Size: 5629 │ │ │ │ +Installed-Size: 5782 │ │ │ │ Depends: fonts-dejavu-core │ │ │ │ Section: doc │ │ │ │ Priority: optional │ │ │ │ Multi-Arch: foreign │ │ │ │ Homepage: https://liballeg.org/ │ │ │ │ Description: documentation for the Allegro 5 library │ │ │ │ This package contains the Allegro documentation in various formats, │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -198,402 +198,402 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 5396 2024-12-29 03:52:10.000000 ./usr/share/doc/allegro5-doc/examples/ex_window_maximized.c │ │ │ │ -rw-r--r-- 0 root (0) root (0) 2660 2024-12-29 03:52:10.000000 ./usr/share/doc/allegro5-doc/examples/ex_window_title.c │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6511 2024-12-29 03:52:10.000000 ./usr/share/doc/allegro5-doc/examples/ex_windows.c │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1674 2024-12-29 03:52:10.000000 ./usr/share/doc/allegro5-doc/examples/ex_winfull.c │ │ │ │ -rw-r--r-- 0 root (0) root (0) 19521 2024-12-29 03:52:10.000000 ./usr/share/doc/allegro5-doc/examples/nihgui.cpp │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6456 2024-12-29 03:52:10.000000 ./usr/share/doc/allegro5-doc/examples/nihgui.hpp │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 11782 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/acodec.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 234053 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/audio.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 12204 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/acodec.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 281743 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/audio.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 36350 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/autosuggest.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 66987 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/color.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 37788 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/config.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 86312 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/color.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 38314 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/config.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 17712 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/direct3d.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 89023 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/display.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 82072 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/events.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 62308 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/file.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 56556 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/fixed.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 95359 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/font.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 42369 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/fshook.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 13488 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/fullscreen_mode.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 89297 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/display.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 84172 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/events.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 62816 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/file.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 56732 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/fixed.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 118376 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/font.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 43136 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/fshook.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 13650 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/fullscreen_mode.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 17055 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/getting_started.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 224378 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/graphics.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 69780 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/haptic.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 12423 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/image.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 225915 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/graphics.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 70455 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/haptic.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 13270 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/image.html │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/images/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 21480 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/images/LINE_CAP.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 15893 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/images/LINE_JOIN.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 65065 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/images/audio.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 16058 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/images/primitives1.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 25805 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/images/primitives2.png │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6773 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/index.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 110785 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/index_all.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 35289 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/joystick.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 24132 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/keyboard.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 35825 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/joystick.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 24344 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/keyboard.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9013 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/main.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 10521 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/memfile.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 24142 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/memory.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 10394 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/misc.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 15363 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/monitor.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 43913 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/mouse.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 80347 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/native_dialog.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 11156 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/memfile.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 27358 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/memory.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 10569 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/misc.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 15525 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/monitor.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 44119 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/mouse.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 94710 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/native_dialog.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 27233 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/opengl.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3973 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/pandoc.css │ │ │ │ -rw-r--r-- 0 root (0) root (0) 38119 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/path.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 11854 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/physfs.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 31535 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/platform.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 145966 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/primitives.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 12287 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/physfs.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 31625 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/platform.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 174802 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/primitives.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 72292 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/search_index.js │ │ │ │ --rw-r--r-- 0 root (0) root (0) 45830 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/shader.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 15871 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/state.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 72351 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/system.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 35452 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/threads.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 46597 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/shader.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 16224 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/state.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 72892 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/system.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 36034 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/threads.html │ │ │ │ -rw-r--r-- 0 root (0) root (0) 12633 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/time.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 26749 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/timer.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 22267 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/touch.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 82433 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/transformations.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 104512 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/utf8.html │ │ │ │ --rw-r--r-- 0 root (0) root (0) 31892 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/video.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 28713 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/timer.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 23245 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/touch.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 82635 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/transformations.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 104905 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/utf8.html │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 37236 2025-01-09 13:52:42.000000 ./usr/share/doc/allegro5-doc/refman/video.html │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-09 13:52:42.000000 ./usr/share/doc-base/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 300 2025-01-01 19:45:12.000000 ./usr/share/doc-base/allegro5-doc.allegro5 │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-09 13:52:42.000000 ./usr/share/man/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 405 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_DEPTH.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 254 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_DEVICE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 554 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_EVENT_TYPE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 554 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_PAN_NONE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 316 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_RECORDER.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 474 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_RECORDER_EVENT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1124 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_STREAM.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 247 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_BITMAP.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 459 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_BITMAP_WRAP.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 250 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_BPM_TO_SECS.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 245 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_BPS_TO_SECS.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 281 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_CHANNEL_CONF.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 313 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_COLOR.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 244 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_COND.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 220 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_CONFIG.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 288 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_CONFIG_ENTRY.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 286 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_CONFIG_SECTION.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 247 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_DISPLAY.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 458 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_DISPLAY_MODE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 5117 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 364 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT_QUEUE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 398 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT_SOURCE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT_TYPE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT_TYPE_IS_USER.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 268 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FILE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 248 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FILECHOOSER.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 772 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FILE_INTERFACE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 312 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FILE_MODE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 409 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FONT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 418 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FOR_EACH_FS_ENTRY_RESULT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 314 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FS_ENTRY.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 509 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FS_INTERFACE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 689 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_GET_EVENT_TYPE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 786 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_GLYPH.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 426 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_HAPTIC.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 813 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_HAPTIC_CONSTANTS.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 3142 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_HAPTIC_EFFECT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 453 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_HAPTIC_EFFECT_ID.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 362 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_INDEX_BUFFER.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 335 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_JOYFLAGS.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 275 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_JOYSTICK.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 413 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_JOYSTICK_STATE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 453 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_KEYBOARD_STATE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 428 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_LINE_CAP.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 404 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_LINE_JOIN.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 794 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_LOCKED_REGION.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 368 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MEMORY_INTERFACE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 289 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MENU.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 706 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MENU_INFO.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 502 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MIXER.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 296 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MIXER_QUALITY.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 461 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MONITOR_INFO.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 445 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MOUSE_EMULATION_MODE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 455 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MOUSE_STATE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 243 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MSECS_TO_SECS.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 236 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MUTEX.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 298 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 290 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PI.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 2159 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PIXEL_FORMAT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 467 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PLAYMODE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1138 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_ATTR.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 568 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_BUFFER_FLAGS.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 358 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_QUALITY.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 902 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_STORAGE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 484 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_TYPE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 334 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_RENDER_FUNCTION.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 859 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_RENDER_STATE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 407 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SAMPLE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 332 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SAMPLE_ID.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 597 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SAMPLE_INSTANCE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SEEK.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 456 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SHADER.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 510 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SHADER_PLATFORM.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 699 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SHADER_TYPE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 680 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_STATE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 269 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_STATE_FLAGS.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 386 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SYSTEM_ID.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 247 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TEXTLOG.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 238 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_THREAD.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 408 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_DEPTH.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 258 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_DEVICE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 556 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_EVENT_TYPE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 559 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_PAN_NONE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 320 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_RECORDER.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 478 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_RECORDER_EVENT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1127 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_AUDIO_STREAM.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 250 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_BITMAP.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 461 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_BITMAP_WRAP.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 252 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_BPM_TO_SECS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 249 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_BPS_TO_SECS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 283 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_CHANNEL_CONF.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 316 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_COLOR.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 249 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_COND.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 239 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_CONFIG.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_CONFIG_ENTRY.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_CONFIG_SECTION.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 251 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_DISPLAY.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 461 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_DISPLAY_MODE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 5119 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 369 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT_QUEUE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 402 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT_SOURCE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 299 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT_TYPE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 310 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_EVENT_TYPE_IS_USER.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 273 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FILE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 252 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FILECHOOSER.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 775 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FILE_INTERFACE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 314 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FILE_MODE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 413 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FONT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 422 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FOR_EACH_FS_ENTRY_RESULT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 318 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FS_ENTRY.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 511 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_FS_INTERFACE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 692 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_GET_EVENT_TYPE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 789 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_GLYPH.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 431 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_HAPTIC.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 816 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_HAPTIC_CONSTANTS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 3144 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_HAPTIC_EFFECT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 457 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_HAPTIC_EFFECT_ID.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_INDEX_BUFFER.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_JOYFLAGS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_JOYSTICK.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 418 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_JOYSTICK_STATE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 457 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_KEYBOARD_STATE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 430 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_LINE_CAP.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 406 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_LINE_JOIN.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 798 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_LOCKED_REGION.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 372 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MEMORY_INTERFACE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 293 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MENU.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 709 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MENU_INFO.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 506 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MIXER.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 299 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MIXER_QUALITY.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 464 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MONITOR_INFO.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 448 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MOUSE_EMULATION_MODE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 458 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MOUSE_STATE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 247 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MSECS_TO_SECS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 240 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_MUTEX.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 296 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PI.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 2161 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PIXEL_FORMAT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 469 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PLAYMODE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1140 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_ATTR.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 571 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_BUFFER_FLAGS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 360 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_QUALITY.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 904 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_STORAGE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 485 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_PRIM_TYPE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_RENDER_FUNCTION.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 862 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_RENDER_STATE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 412 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SAMPLE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 337 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SAMPLE_ID.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 601 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SAMPLE_INSTANCE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 297 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SEEK.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 459 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SHADER.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 514 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SHADER_PLATFORM.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 702 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SHADER_TYPE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 685 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_STATE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_STATE_FLAGS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 389 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_SYSTEM_ID.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 251 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TEXTLOG.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 241 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_THREAD.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TIMEOUT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 247 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TIMER.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 342 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT_STATE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 462 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TOUCH_STATE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 362 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TRANSFORM.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 243 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_USECS_TO_SECS.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 669 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_USER_EVENT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_USTR.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 346 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_USTR_INFO.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 588 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 353 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX_BUFFER.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 412 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX_CACHE_SIZE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX_DECL.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 884 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX_ELEMENT.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 516 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VIDEO_EVENT_TYPE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 553 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VIDEO_POSITION_TYPE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 383 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VOICE.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 381 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_WRITE_MASK_FLAGS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 251 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TIMER.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 275 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 275 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 347 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT_STATE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 466 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TOUCH_STATE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_TRANSFORM.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 247 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_USECS_TO_SECS.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 672 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_USER_EVENT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 311 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_USTR.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_USTR_INFO.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 593 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 358 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX_BUFFER.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 416 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX_CACHE_SIZE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 376 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX_DECL.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 889 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VERTEX_ELEMENT.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 518 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VIDEO_EVENT_TYPE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 558 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VIDEO_POSITION_TYPE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 388 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_VOICE.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 384 2025-01-09 13:52:42.000000 ./usr/share/man/man3/ALLEGRO_WRITE_MASK_FLAGS.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 477 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_acknowledge_drawing_halt.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 301 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_acknowledge_drawing_resume.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 554 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_acknowledge_resize.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 420 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_add_config_comment.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 301 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_add_config_section.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 291 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_add_new_bitmap_flag.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 371 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_add_timer_count.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_android_get_activity.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 625 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_android_get_jni_env.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_android_get_os_version.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 817 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_android_open_fd.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 394 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_android_set_apk_file_interface.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 494 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_android_set_apk_fs_interface.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 362 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_append_menu_item.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 452 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_append_native_text_log.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_append_menu_item.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 457 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_append_native_text_log.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_append_path_component.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 629 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_apply_window_constraints.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 340 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_audio_stream_to_mixer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 567 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_audio_stream_to_voice.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 438 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_mixer_to_mixer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 377 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_mixer_to_voice.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_sample_instance_to_mixer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 551 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_sample_instance_to_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_audio_stream_to_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 572 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_audio_stream_to_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 442 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_mixer_to_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 381 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_mixer_to_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 353 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_sample_instance_to_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 556 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_sample_instance_to_voice.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1752 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_shader_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 418 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_attach_shader_source_file.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 607 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_backup_dirty_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 344 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_backup_dirty_bitmaps.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 418 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_broadcast_cond.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 816 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_build_camera_transform.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 437 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_build_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 441 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_build_menu.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 526 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_build_shader.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 568 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_build_transform.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1237 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calculate_arc.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 660 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calculate_ribbon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 620 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calculate_spline.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 333 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calloc.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1241 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calculate_arc.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 666 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calculate_ribbon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 626 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calculate_spline.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calloc.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 351 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_calloc_with_context.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 286 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_can_get_mouse_cursor_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 281 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_can_set_keyboard_leds.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 274 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_change_directory.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 896 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_check_inverse.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 560 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clear_depth_buffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 643 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clear_keyboard_state.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clear_to_color.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 309 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clipboard_has_text.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 422 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clone_bitmap.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 357 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clone_menu.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clone_menu_for_popup.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 359 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clone_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 299 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clone_menu_for_popup.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_clone_path.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_close_directory.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_close_native_text_log.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 289 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_close_video.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_cmyk.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 300 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_cmyk_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 715 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_distance_ciede2000.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 365 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_hsl.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 404 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_hsl_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 362 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_hsv.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 396 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_hsv_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 436 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_html.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 499 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_html_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 574 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_lab.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_lab_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 531 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_lch.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 303 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_lch_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 756 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_linear.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 325 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_linear_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_name.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1213 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_name_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 486 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_oklab.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 298 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_oklab_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 424 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_cmyk.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_hsl.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 347 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_hsv.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 509 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_html.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 301 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_lab.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_lch.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 323 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_linear.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 320 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_name.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_oklab.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 301 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_xyy.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_xyz.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 291 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_yuv.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 391 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_xyy.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 301 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_xyy_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 533 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_xyz.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 303 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_xyz_to_rgb.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_yuv.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 292 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_yuv_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 312 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_close_native_text_log.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 293 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_close_video.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 310 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_cmyk.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_cmyk_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 719 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_distance_ciede2000.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 369 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_hsl.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 408 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_hsl_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 366 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_hsv.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 400 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_hsv_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 440 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_html.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 503 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_html_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 578 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_lab.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_lab_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 535 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_lch.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_lch_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 760 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_linear.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 328 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_linear_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_name.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1219 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_name_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 491 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_oklab.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_oklab_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 428 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_cmyk.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 355 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_hsl.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 352 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_hsv.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 514 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_html.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_lab.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_lch.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 327 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_linear.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 322 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_name.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 309 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_oklab.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_xyy.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_xyz.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_rgb_to_yuv.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 397 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_xyy.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_xyy_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 538 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_xyz.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_xyz_to_rgb.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 284 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_yuv.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 297 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_color_yuv_to_rgb.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 477 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_compose_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 473 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_convert_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_convert_mask_to_alpha.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 549 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_convert_memory_bitmaps.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_copy_transform.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1022 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_audio_recorder.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1252 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_audio_stream.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1028 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_audio_recorder.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1257 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_audio_stream.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1605 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_bitmap.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 590 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_builtin_font.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 594 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_builtin_font.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_cond.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_config.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 562 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_display.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_event_queue.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 420 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_file_handle.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_fs_entry.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 776 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_index_buffer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 318 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_menu.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 572 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 782 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_index_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 322 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 578 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_mixer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 406 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_mouse_cursor.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_mutex.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 468 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_mutex_recursive.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1600 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_native_file_dialog.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1624 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_native_file_dialog.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 404 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_path.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_path_for_directory.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 370 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_popup_menu.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 787 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 394 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_sample_instance.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_popup_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 793 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 398 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_sample_instance.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 628 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_shader.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 711 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_sub_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 396 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_thread.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 503 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_thread_with_stacksize.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 504 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_timer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 778 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_vertex_buffer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 414 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_vertex_decl.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 701 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 783 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_vertex_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 418 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_vertex_decl.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 707 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_create_voice.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 660 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_cstr.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 395 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_cstr_dup.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 429 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_audio_recorder.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 362 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_audio_stream.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 433 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_audio_recorder.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 366 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_audio_stream.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 457 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 316 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_cond.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_config.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 416 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_display.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 378 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_event_queue.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_font.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 288 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_font.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 320 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_fs_entry.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_index_buffer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 356 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_menu.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 253 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 310 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_index_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 360 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 257 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_mixer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_mouse_cursor.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 318 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_mutex.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 264 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_native_file_dialog.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 268 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_native_file_dialog.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_path.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 402 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_sample_instance.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 406 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 341 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_sample_instance.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 456 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_shader.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 335 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_thread.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 354 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_timer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 326 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_user_event_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_vertex_buffer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 327 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_vertex_decl.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_voice.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 317 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_detach_audio_stream.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 283 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_detach_mixer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 347 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_detach_sample_instance.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 299 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_detach_voice.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 321 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_disable_menu_event_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 922 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_do_multiline_text.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_do_multiline_ustr.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 355 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_drain_audio_stream.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 493 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_arc.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 311 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_vertex_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 331 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_vertex_decl.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 299 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_destroy_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 321 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_detach_audio_stream.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 286 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_detach_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 351 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_detach_sample_instance.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_detach_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 325 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_disable_menu_event_source.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 929 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_do_multiline_text.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_do_multiline_ustr.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 359 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_drain_audio_stream.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 498 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_arc.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 729 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 455 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_bitmap_region.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 399 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_circle.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 402 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_ellipse.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 517 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_elliptical_arc.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_circle.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 352 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_ellipse.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 472 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_pieslice.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 505 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_polygon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 944 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_polygon_with_holes.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 369 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_rectangle.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 395 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_rounded_rectangle.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 353 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_triangle.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 635 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_glyph.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 721 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_indexed_buffer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 624 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_indexed_prim.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 570 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_justified_text.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 382 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_justified_textf.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 359 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_justified_ustr.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 403 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_line.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1236 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_multiline_text.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 405 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_multiline_textf.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 383 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_multiline_ustr.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 520 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_pieslice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 403 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_circle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 406 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_ellipse.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 522 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_elliptical_arc.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 350 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_circle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 357 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_ellipse.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 477 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_pieslice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 522 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_polygon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 953 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_polygon_with_holes.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_rectangle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 400 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_rounded_rectangle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 357 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_filled_triangle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 640 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_glyph.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 726 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_indexed_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 630 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_indexed_prim.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 575 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_justified_text.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 387 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_justified_textf.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 366 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_justified_ustr.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 407 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_line.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1241 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_multiline_text.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 409 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_multiline_textf.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 390 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_multiline_ustr.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 525 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_pieslice.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 620 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_pixel.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 570 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_polygon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 795 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_polyline.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 756 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_prim.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 417 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_rectangle.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 580 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_ribbon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 574 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_polygon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 801 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_polyline.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 762 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_prim.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 421 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_rectangle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 586 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_ribbon.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 677 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_rotated_bitmap.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 449 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_rounded_rectangle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 454 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_rounded_rectangle.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 463 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_scaled_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 546 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_scaled_rotated_bitmap.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 811 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_soft_line.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1048 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_soft_triangle.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 419 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_spline.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 697 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_text.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 362 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_textf.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 818 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_soft_line.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1058 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_soft_triangle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 423 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_spline.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 702 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_text.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 368 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_textf.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 507 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_tinted_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 375 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_tinted_bitmap_region.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_tinted_rotated_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 380 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_tinted_scaled_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 388 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_tinted_scaled_rotated_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 531 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_tinted_scaled_rotated_bitmap_region.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 409 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_triangle.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 362 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_ustr.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 615 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_vertex_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 414 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_triangle.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_ustr.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 622 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_draw_vertex_buffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 332 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_drop_next_event.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 269 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_drop_path_tail.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 972 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_emit_user_event.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 397 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_enable_menu_event_source.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 402 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_enable_menu_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 427 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fclearerr.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 300 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fclose.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 478 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_feof.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 365 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ferrmsg.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ferror.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fflush.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 462 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fget_ustr.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 281 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fgetc.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 544 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fgets.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_filename_exists.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 371 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fill_silence.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 403 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_find_menu.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 513 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_find_menu_item.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 377 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fill_silence.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 408 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_find_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 518 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_find_menu_item.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 501 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixacos.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 638 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixadd.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 602 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixasin.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 406 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixatan.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 590 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixatan2.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixceil.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 429 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixcos.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 697 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixdiv.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 891 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixed.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 895 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixed.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 385 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixfloor.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 318 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixhypot.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 670 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixmul.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 409 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixsin.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 292 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixsqrt.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 651 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixsub.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 464 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fixtan.3alleg5.gz │ │ │ │ @@ -611,76 +611,76 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 357 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fputc.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 503 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fputs.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 469 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fread.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 398 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fread16be.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 400 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fread16le.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 397 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fread32be.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 400 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fread32le.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 454 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_free.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 458 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_free.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 342 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_free_with_context.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 341 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fs_entry_exists.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 546 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fseek.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 256 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fsize.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ftell.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 513 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ftofix.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 547 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fungetc.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 393 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fwrite.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 329 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fwrite16be.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 330 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fwrite16le.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 329 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fwrite32be.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 330 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_fwrite32le.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_acodec_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_audio_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_color_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 265 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_font_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_image_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_memfile_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 271 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_native_dialog_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 268 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_physfs_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_primitives_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 265 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_ttf_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_audio_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_color_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 268 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_font_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_image_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_memfile_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 275 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_native_dialog_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 271 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_physfs_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 273 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_primitives_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 268 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_ttf_version.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 544 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_version.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_video_version.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_allegro_video_version.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 256 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_app_name.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 301 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_depth_size.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_device_name.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 277 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_output_device.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 321 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_recorder_event.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_recorder_event_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_attached.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 286 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_channels.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 273 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_depth.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 333 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_event_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 707 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_fragment.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 340 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_fragments.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 265 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_frequency.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_gain.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 263 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_length.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_length_secs.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 271 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_pan.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_played_samples.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 290 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_playmode.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 348 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_position_secs.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 284 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_speed.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 350 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_available_audio_stream_fragments.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_depth_size.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 284 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_device_name.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_output_device.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 326 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_recorder_event.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 351 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_recorder_event_source.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 310 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_attached.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 290 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_channels.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 277 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_depth.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 337 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_event_source.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 711 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_fragment.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 343 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_fragments.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 269 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_frequency.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_gain.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_length.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 379 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_length_secs.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_pan.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_played_samples.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 297 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_playmode.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 353 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_position_secs.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 288 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_audio_stream_speed.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 354 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_available_audio_stream_fragments.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 577 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_backbuffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 326 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_blend_color.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 361 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_blender.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 361 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_depth.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 266 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_flags.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 282 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_format.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 246 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_height.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_samples.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 246 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_width.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 309 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_x.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 309 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_bitmap_y.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 298 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_blend_color.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_blender.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_channel_count.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_channel_count.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 519 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_clipboard_text.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_clipping_rectangle.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 417 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_config_value.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 664 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_cpu_count.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 407 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_current_directory.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 303 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_current_display.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 426 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_current_inverse_transform.3alleg5.gz │ │ │ │ @@ -688,60 +688,60 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 294 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_current_shader.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_current_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 332 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_d3d_device.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 353 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_d3d_system_texture.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 394 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_d3d_texture_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 374 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_d3d_texture_size.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 376 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_d3d_video_texture.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 363 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_default_menu_event_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 402 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_default_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_default_menu_event_source.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 407 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_default_mixer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 501 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_default_shader_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_default_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 283 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_default_voice.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 303 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_adapter.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 315 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 456 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_flags.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 266 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_format.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_height.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 323 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 329 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_menu.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 433 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_mode.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 274 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_option.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_orientation.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 262 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_refresh_rate.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_display_width.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 284 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_errno.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 316 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_event_source_data.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fallback_font.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fallback_font.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_file_userdata.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 425 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_first_config_entry.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 475 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_first_config_section.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 275 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_font_ascent.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_font_descent.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 543 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_font_line_height.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 501 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_font_ranges.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_font_ascent.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_font_descent.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 546 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_font_line_height.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 505 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_font_ranges.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 404 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fs_entry_atime.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fs_entry_ctime.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 320 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fs_entry_mode.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fs_entry_mtime.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 540 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fs_entry_name.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fs_entry_size.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 298 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_fs_interface.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 511 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_glyph.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1225 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_glyph_advance.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1082 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_glyph_dimensions.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 381 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_glyph_width.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 516 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_glyph.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1230 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_glyph_advance.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1087 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_glyph_dimensions.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 385 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_glyph_width.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 710 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_autocenter.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 440 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_capabilities.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 463 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_effect_duration.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 416 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_from_display.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 525 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_from_joystick.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 420 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_from_keyboard.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 413 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_from_mouse.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 425 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_from_touch_input.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 577 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_haptic_gain.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 282 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_index_buffer_size.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_index_buffer_size.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 481 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 385 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_active.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_axis_name.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 343 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_button_name.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 293 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_name.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 312 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_num_axes.3alleg5.gz │ │ │ │ @@ -749,38 +749,38 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_num_sticks.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 291 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_state.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 327 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_stick_flags.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 327 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_joystick_stick_name.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 316 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_keyboard_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_keyboard_state.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 459 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_max_haptic_effects.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 357 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_menu_item_caption.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 353 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_menu_item_flags.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 403 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_menu_item_icon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 325 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_attached.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 277 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_channels.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_depth.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_frequency.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 303 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_gain.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 268 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 273 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_quality.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 361 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_menu_item_caption.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 356 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_menu_item_flags.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 407 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_menu_item_icon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 329 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_attached.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 281 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_channels.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 271 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_depth.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_frequency.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_gain.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 271 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 277 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mixer_quality.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 281 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_monitor_dpi.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 460 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_monitor_info.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 355 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_monitor_refresh_rate.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 411 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mouse_cursor_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 401 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mouse_emulation_mode.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 313 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mouse_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 271 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mouse_num_axes.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mouse_num_buttons.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 476 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mouse_state.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 342 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mouse_state_axis.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 278 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_mouse_wheel_precision.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_native_file_dialog_count.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 478 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_native_file_dialog_path.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 469 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_native_text_log_event_source.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 289 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_native_file_dialog_count.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 483 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_native_file_dialog_path.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 474 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_native_text_log_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 370 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_bitmap_depth.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 258 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_bitmap_flags.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 278 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_bitmap_format.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 370 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_bitmap_samples.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 330 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_bitmap_wrap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 344 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_display_adapter.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 282 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_display_flags.3alleg5.gz │ │ │ │ @@ -788,15 +788,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 284 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_display_refresh_rate.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_file_interface.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_window_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 450 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_new_window_title.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 314 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_next_config_entry.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 352 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_next_config_section.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 402 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_next_event.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 288 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_num_audio_output_devices.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 291 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_num_audio_output_devices.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 394 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_num_display_modes.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 366 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_num_joysticks.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 436 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_num_video_adapters.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 773 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_opengl_extension_list.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 528 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_opengl_fbo.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 697 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_opengl_proc_address.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 312 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_opengl_program_object.3alleg5.gz │ │ │ │ @@ -818,315 +818,315 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_pixel_block_height.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 320 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_pixel_block_size.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_pixel_block_width.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 331 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_pixel_format_bits.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 331 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_pixel_size.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 707 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_ram_size.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 369 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_render_state.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 446 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 311 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_channels.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 300 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_data.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_depth.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_frequency.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 316 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_attached.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 309 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_channels.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 297 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_depth.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 287 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_frequency.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_gain.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_length.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_pan.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 321 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 297 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_playmode.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 290 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_position.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 290 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_speed.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 310 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_time.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_length.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 450 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 316 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_channels.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_data.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 310 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_depth.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_frequency.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 320 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_attached.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 314 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_channels.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 301 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_depth.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 291 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_frequency.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 288 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_gain.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 341 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_length.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 282 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_pan.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 325 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_playmode.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 294 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_position.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_speed.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 315 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_instance_time.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_sample_length.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 377 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_separate_bitmap_blender.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 326 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_separate_blender.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 398 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_shader_log.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_shader_platform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1433 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_standard_path.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 719 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_system_config.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 271 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_system_id.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 261 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_target_bitmap.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 528 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_text_dimensions.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 321 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_text_width.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 534 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_text_dimensions.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 325 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_text_width.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 428 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_thread_should_stop.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 320 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_time.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 287 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_timer_count.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_timer_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_timer_speed.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 258 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_timer_started.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 328 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_touch_input_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 444 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_touch_input_mouse_emulation_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 312 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_touch_input_state.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_ustr_dimensions.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 288 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_ustr_width.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 284 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_vertex_buffer_size.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 262 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_audio_rate.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_event_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 292 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_fps.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 544 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_frame.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 331 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_position.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 358 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_scaled_height.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 356 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_scaled_width.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_channels.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_depth.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_frequency.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 273 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_position.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 341 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_ustr_dimensions.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 290 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_ustr_width.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 287 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_vertex_buffer_size.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 266 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_audio_rate.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_event_source.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_fps.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 548 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_frame.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_position.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 361 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_scaled_height.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 360 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_video_scaled_width.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 283 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_channels.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 273 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_depth.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 277 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_frequency.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 277 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 343 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_voice_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 266 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_win_window_handle.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 514 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_window_borders.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 314 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_window_constraints.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 290 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_window_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 265 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_get_x_window_id.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1188 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_grab_font_from_bitmap.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1192 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_grab_font_from_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 438 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_grab_mouse.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 322 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_have_d3d_non_pow2_texture_support.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 310 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_have_d3d_non_square_texture_support.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 423 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_have_opengl_extension.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 371 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_hide_mouse_cursor.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 755 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_hold_bitmap_drawing.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 353 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_horizontal_shear_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 398 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 541 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_bitmap_f.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 404 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 538 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_sample_f.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 383 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_video.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 476 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_video_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 407 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 541 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_sample_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 387 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_video.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 481 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identify_video_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 380 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_identity_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 348 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_inhibit_screensaver.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 501 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 672 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_acodec_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 518 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_font_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 614 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_image_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 472 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_native_dialog_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 296 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_primitives_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 506 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 675 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_acodec_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 521 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_font_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 615 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_image_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 476 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_native_dialog_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 298 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_primitives_addon.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 370 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_timeout.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 319 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_ttf_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 323 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_ttf_addon.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 772 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_user_event_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 238 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_video_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 787 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_insert_menu_item.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 239 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_init_video_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 794 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_insert_menu_item.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 410 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_insert_path_component.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_install_audio.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 352 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_install_audio.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 657 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_install_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 287 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_install_joystick.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_install_keyboard.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_install_mouse.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 732 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_install_system.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 300 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_install_touch_input.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 462 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_invert_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_iphone_get_view.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 271 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_iphone_get_window.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 351 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_iphone_set_statusbar_orientation.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_acodec_addon_initialized.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 262 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_audio_installed.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_audio_recorder_recording.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 273 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_acodec_addon_initialized.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 265 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_audio_installed.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 343 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_audio_recorder_recording.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 274 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_bitmap_drawing_held.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 287 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_bitmap_locked.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 348 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_color_valid.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 575 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_compatible_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 361 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_d3d_device_lost.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 443 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_display_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_event_queue_empty.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 286 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_event_queue_paused.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 300 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_event_source_registered.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 297 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_font_addon_initialized.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 300 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_font_addon_initialized.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 389 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_haptic_active.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 475 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_haptic_capable.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 443 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_haptic_effect_ok.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 505 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_haptic_effect_playing.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 373 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_haptic_installed.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 269 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_image_addon_initialized.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_image_addon_initialized.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 387 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_joystick_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 250 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_joystick_installed.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 387 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_keyboard_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 250 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_keyboard_installed.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 383 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_mouse_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 246 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_mouse_installed.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_native_dialog_addon_initialized.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 303 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_primitives_addon_initialized.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_native_dialog_addon_initialized.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_primitives_addon_initialized.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 295 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_sub_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 250 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_system_installed.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 401 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_touch_input_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 261 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_touch_input_installed.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 298 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_ttf_addon_initialized.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 268 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_video_addon_initialized.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 262 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_video_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 301 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_ttf_addon_initialized.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_video_addon_initialized.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 265 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_is_video_playing.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 529 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_itofix.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 480 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_join_paths.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 401 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_join_thread.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 291 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_key_down.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 247 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_keycode_to_name.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 650 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_audio_stream.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 771 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_audio_stream_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 657 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_audio_stream.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 777 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_audio_stream_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 540 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 602 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_bitmap_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1751 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_bitmap_flags.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 591 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_bitmap_flags_f.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 425 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_bitmap_font.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 372 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_bitmap_font_flags.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 429 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_bitmap_font.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 376 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_bitmap_font_flags.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 328 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_config_file.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 342 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_config_file_f.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 474 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_font.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 522 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 611 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_sample_f.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 820 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_ttf_font.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 434 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_ttf_font_f.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 538 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_ttf_font_stretch.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 468 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_ttf_font_stretch_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 479 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_font.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 526 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 616 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_sample_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 824 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_ttf_font.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 439 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_ttf_font_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 543 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_ttf_font_stretch.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 474 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_load_ttf_font_stretch_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1178 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 559 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_bitmap_blocked.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 640 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_bitmap_region.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 386 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_bitmap_region_blocked.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 517 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_index_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 521 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_index_buffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 500 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_mutex.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 583 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_sample_id.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 515 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_vertex_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 587 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_sample_id.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 519 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_lock_vertex_buffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 378 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_make_directory.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 440 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_make_path_canonical.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 517 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_make_temp_file.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 355 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_malloc.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 360 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_malloc.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_malloc_with_context.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_map_rgb.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 332 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_map_rgb_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_map_rgba.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 328 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_map_rgba_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_merge_config.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_merge_config_into.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_mixer_has_attachments.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 343 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_mixer_has_attachments.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 480 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_mouse_button_down.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 334 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_open_directory.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 419 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_open_fs_entry.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 559 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_open_memfile.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 622 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_open_native_text_log.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 313 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_open_video.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 565 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_open_memfile.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 628 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_open_native_text_log.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 317 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_open_video.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 835 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_orthographic_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 279 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_osx_get_window.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 477 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_path_cstr.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 485 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_path_ustr.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 484 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_pause_event_queue.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 409 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_peek_next_event.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_perspective_transform.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 608 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_audio_stream.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 727 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_audio_stream_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 612 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_audio_stream.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 732 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_audio_stream_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 598 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_haptic_effect.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 698 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 294 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_sample_instance.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 675 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_popup_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 703 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 298 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_play_sample_instance.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 680 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_popup_menu.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 622 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_premul_rgba.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 605 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_premul_rgba_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 300 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_put_blended_pixel.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 408 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_put_pixel.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 363 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_radtofix_r.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 465 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_read_directory.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 335 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_realloc.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 340 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_realloc.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 352 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_realloc_with_context.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 451 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_rebase_path.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 785 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_reconfigure_joysticks.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 394 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ref_buffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 531 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ref_cstr.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 364 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ref_info.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 610 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ref_ustr.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 376 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_assert_handler.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 544 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_audio_stream_loader.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 548 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_audio_stream_loader_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 550 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_audio_stream_loader.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 553 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_audio_stream_loader_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 684 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_bitmap_identifier.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 508 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_bitmap_loader.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 502 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_bitmap_loader_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 507 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_bitmap_saver.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 501 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_bitmap_saver_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 373 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_event_source.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 496 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_font_loader.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 695 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_identifier.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 502 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_loader.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 495 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_loader_f.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 509 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_saver.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 501 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_saver_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 501 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_font_loader.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 700 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_identifier.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 505 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_loader.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 499 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_loader_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 512 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_saver.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 506 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_sample_saver_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 447 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_register_trace_handler.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 604 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_release_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 718 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_release_haptic_effect.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 269 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_release_joystick.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 335 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_config_key.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_config_section.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 382 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_display_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 385 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_display_menu.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 392 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_filename.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 357 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_fs_entry.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 485 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_menu_item.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 490 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_menu_item.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_opengl_fbo.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 373 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_remove_path_component.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 522 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_reparent_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 383 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_replace_path_component.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 612 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_reserve_samples.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 614 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_reserve_samples.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_reset_bitmap_blender.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 356 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_reset_clipping_rectangle.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 260 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_reset_new_display_options.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 391 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_resize_display.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 411 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_rest.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 450 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_restore_default_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 453 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_restore_default_mixer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 274 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_restore_state.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 384 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_resume_timer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_rewind_audio_stream.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_rewind_audio_stream.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 341 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_rotate_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 382 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_rotate_transform_3d.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 798 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_rumble_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 394 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_run_detached_thread.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 483 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_run_main.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 449 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_save_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 523 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_save_bitmap_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 311 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_save_config_file.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 330 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_save_config_file_f.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 470 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_save_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 511 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_save_sample_f.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 474 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_save_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 515 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_save_sample_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_scale_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 330 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_scale_transform_3d.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 379 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_seek_audio_stream_secs.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_seek_video.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 383 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_seek_audio_stream_secs.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 308 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_seek_video.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 357 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_app_name.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 286 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_channel_matrix.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 356 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_fragment.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 341 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_gain.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 347 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_loop_secs.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 491 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_pan.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 323 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_playmode.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 361 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_speed.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 361 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_fragment.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 346 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_gain.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 350 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_loop_secs.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 496 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_pan.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 312 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 327 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_playmode.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 365 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_audio_stream_speed.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 339 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_bitmap_blend_color.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 469 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_bitmap_blender.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 324 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_blend_color.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1432 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_blender.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 315 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_clipboard_text.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 323 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_clipping_rectangle.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 539 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_config_value.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 512 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_current_opengl_context.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 419 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_d3d_device_release_callback.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 400 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_d3d_device_restore_callback.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 420 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_default_mixer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 363 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_default_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 426 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_default_mixer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 366 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_default_voice.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 490 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_display_flag.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 306 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_display_icon.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 530 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_display_icons.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 637 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_display_menu.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 642 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_display_menu.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 580 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_display_option.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 227 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_errno.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 367 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_event_source_data.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 457 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_exe_name.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 393 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_fallback_font.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 398 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_fallback_font.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 294 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_fs_interface.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 771 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_haptic_autocenter.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 595 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_haptic_gain.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 434 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_keyboard_leds.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 418 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_memory_interface.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 344 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_menu_item_caption.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_menu_item_flags.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 463 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_menu_item_icon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 342 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_frequency.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 321 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_gain.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 299 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 465 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_postprocess_callback.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_menu_item_caption.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 342 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_menu_item_flags.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 465 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_menu_item_icon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_frequency.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 326 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_gain.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 303 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 470 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_postprocess_callback.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mixer_quality.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 344 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mouse_axis.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 395 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mouse_cursor.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 394 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mouse_emulation_mode.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mouse_w.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 746 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mouse_wheel_precision.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 378 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_mouse_xy.3alleg5.gz │ │ │ │ @@ -1143,25 +1143,25 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 337 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_new_file_interface.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 399 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_new_window_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 396 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_new_window_title.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 363 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_org_name.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 310 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_path_drive.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 446 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_path_extension.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 335 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_path_filename.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 671 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_physfs_file_interface.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 673 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_physfs_file_interface.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 376 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_render_state.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 593 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 751 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_channel_matrix.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_gain.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 414 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_length.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 546 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_pan.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 356 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 332 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_playmode.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 326 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_position.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 368 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_speed.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 598 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 755 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_channel_matrix.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_gain.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 418 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_length.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 551 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_pan.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 360 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_playmode.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 329 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_position.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 372 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_sample_instance_speed.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 437 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_separate_bitmap_blender.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 397 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_separate_blender.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 348 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_shader_bool.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 348 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_shader_float.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 322 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_shader_float_vector.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 353 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_shader_int.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 689 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_shader_int_vector.3alleg5.gz │ │ │ │ @@ -1171,64 +1171,64 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_standard_fs_interface.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 596 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_system_mouse_cursor.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 280 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_target_backbuffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1461 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_target_bitmap.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 300 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_thread_should_stop.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 352 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_timer_count.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 446 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_timer_speed.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 260 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_video_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 395 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_voice_playing.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 359 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_voice_position.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 263 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_video_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 401 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_voice_playing.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 365 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_voice_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 451 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_window_constraints.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 291 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_window_position.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 276 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_set_window_title.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 334 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_show_mouse_cursor.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 541 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_show_native_file_dialog.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1144 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_show_native_message_box.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 298 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_font_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 282 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_image_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 270 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_native_dialog_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 304 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_primitives_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 257 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_ttf_addon.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 292 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_video_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 545 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_show_native_file_dialog.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1150 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_show_native_message_box.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 302 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_font_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 285 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_image_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_native_dialog_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_primitives_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 259 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_ttf_addon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 296 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_shutdown_video_addon.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 338 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_signal_cond.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 429 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_start_audio_recorder.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 433 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_start_audio_recorder.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 336 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_start_thread.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 398 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_start_timer.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 269 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_start_video.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 286 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_start_video_with_voice.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 492 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_audio_recorder.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 272 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_start_video.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 289 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_start_video_with_voice.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 497 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_audio_recorder.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 450 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_haptic_effect.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 265 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_sample.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 269 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_sample_instance.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 247 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_samples.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 267 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_sample.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 273 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_sample_instance.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 251 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_samples.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 341 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_stop_timer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 525 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_store_state.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 487 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_toggle_menu_item_flags.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 492 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_toggle_menu_item_flags.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 342 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_transform_coordinates.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 419 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_transform_coordinates_3d.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 769 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_transform_coordinates_3d_projective.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 365 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_transform_coordinates_4d.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 333 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_translate_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 329 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_translate_transform_3d.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 445 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_transpose_transform.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 808 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_triangulate_polygon.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 815 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_triangulate_polygon.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 307 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ungrab_mouse.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 243 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_uninstall_audio.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 246 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_uninstall_audio.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 482 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_uninstall_haptic.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 347 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_uninstall_joystick.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 323 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_uninstall_keyboard.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 305 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_uninstall_mouse.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 292 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_uninstall_system.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 315 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_uninstall_touch_input.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 356 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unlock_bitmap.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 293 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unlock_index_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 297 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unlock_index_buffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 333 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unlock_mutex.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 452 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unlock_sample_id.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 294 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unlock_vertex_buffer.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 457 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unlock_sample_id.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 299 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unlock_vertex_buffer.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 356 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unmap_rgb.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 348 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unmap_rgb_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 349 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unmap_rgba.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 344 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unmap_rgba_f.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 380 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unref_user_event.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 383 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_unregister_event_source.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 454 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_update_display_region.3alleg5.gz │ │ │ │ @@ -1297,15 +1297,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 385 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_ustr_vappendf.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 434 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_utf16_encode.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 341 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_utf16_width.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 423 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_utf8_encode.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 347 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_utf8_width.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 350 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_vertical_shear_transform.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 345 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_vfprintf.3alleg5.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 324 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_voice_has_attachments.3alleg5.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 329 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_voice_has_attachments.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 654 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_wait_cond.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 372 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_wait_cond_until.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 392 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_wait_for_event.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 541 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_wait_for_event_timed.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 547 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_wait_for_event_until.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 416 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_wait_for_vsync.3alleg5.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 599 2025-01-09 13:52:42.000000 ./usr/share/man/man3/al_win_add_window_callback.3alleg5.gz │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/acodec.html │ │ │ │ @@ -181,15 +181,16 @@ │ │ │ │ id="toc-al_get_allegro_acodec_version">al_get_allegro_acodec_version │ │ │ │ │ │ │ │ │ │ │ │

These functions are declared in the following header file. Link with │ │ │ │ allegro_acodec.

│ │ │ │ 
 #include <allegro5/allegro_acodec.h>
│ │ │ │

al_init_acodec_addon

│ │ │ │ -
bool al_init_acodec_addon(void)
│ │ │ │ +
bool al_init_acodec_addon(void)
│ │ │ │ +bool al_init_acodec_addon(void)
│ │ │ │

Source │ │ │ │ Code

│ │ │ │

This function registers all the known audio file type handlers for al_load_sample, al_save_sample, al_load_audio_stream, │ │ │ │ @@ -220,15 +221,16 @@ │ │ │ │

  • ex_acodec_multi.c
    • │ │ │ │
  • ex_kcm_direct.c
    • │ │ │ │ │ │ │ │

    al_is_acodec_addon_initialized

    │ │ │ │ -
    bool al_is_acodec_addon_initialized(void)
    │ │ │ │ +
    bool al_is_acodec_addon_initialized(void)
│ │ │ │ +bool al_is_acodec_addon_initialized(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if the acodec addon is initialized, otherwise returns │ │ │ │ false.

    │ │ │ │

    Since: 5.2.6

    │ │ │ │

    │ │ │ │ │ ************ aall__iinniitt__aaccooddeecc__aaddddoonn ************ │ │ │ │ │ bool al_init_acodec_addon(void) │ │ │ │ │ +bool al_init_acodec_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This function registers all the known audio file type handlers for │ │ │ │ │ _a_l___l_o_a_d___s_a_m_p_l_e, _a_l___s_a_v_e___s_a_m_p_l_e, _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m, etc. │ │ │ │ │ Depending on what libraries are available, the full set of recognised │ │ │ │ │ extensions is: .wav, .flac, .ogg, .opus, .it, .mod, .s3m, .xm, .voc. │ │ │ │ │ LLiimmiittaattiioonnss:: │ │ │ │ │ * Saving is only supported for wav files. │ │ │ │ │ @@ -70,14 +71,15 @@ │ │ │ │ │ Return true on success. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ ************ aall__iiss__aaccooddeecc__aaddddoonn__iinniittiiaalliizzeedd ************ │ │ │ │ │ bool al_is_acodec_addon_initialized(void) │ │ │ │ │ +bool al_is_acodec_addon_initialized(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the acodec addon is initialized, otherwise returns false. │ │ │ │ │ Since: 5.2.6 │ │ │ │ │ ************ aall__ggeett__aalllleeggrroo__aaccooddeecc__vveerrssiioonn ************ │ │ │ │ │ uint32_t al_get_allegro_acodec_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/audio.html │ │ │ │ @@ -554,15 +554,16 @@ │ │ │ │

    If you want to play large audio files (e.g. background music) without │ │ │ │ loading the whole file at once you can use al_play_audio_stream (after │ │ │ │ calling al_reserve_samples). │ │ │ │ This will load and play an ALLEGRO_AUDIO_STREAM. Note that │ │ │ │ the basic API only supports one such audio stream playing at once.

    │ │ │ │

    ALLEGRO_SAMPLE_ID

    │ │ │ │ -
    typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID;
    │ │ │ │ +
    typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID;
│ │ │ │ +typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An ALLEGRO_SAMPLE_ID represents a sample being played via al_play_sample. It can be used to │ │ │ │ later stop the sample with al_stop_sample. The underlying │ │ │ │ @@ -570,15 +571,16 @@ │ │ │ │ href="audio.html#al_lock_sample_id">al_lock_sample_id.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_install_audio

    │ │ │ │ -
    bool al_install_audio(void)
    │ │ │ │ +
    bool al_install_audio(void)
│ │ │ │ +bool al_install_audio(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Install the audio subsystem.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │
    │ │ │ │

    Note: most users will call ex_audio_devices.c │ │ │ │

  • ex_saw.c
    • │ │ │ │
  • ex_stream_file.c
    • │ │ │ │ │ │ │ │

    al_uninstall_audio

    │ │ │ │ -
    void al_uninstall_audio(void)
    │ │ │ │ +
    void al_uninstall_audio(void)
│ │ │ │ +void al_uninstall_audio(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Uninstalls the audio subsystem.

    │ │ │ │

    See also: al_install_audio

    │ │ │ │

    Examples:

    │ │ │ │ @@ -614,23 +617,25 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_saw.c#L123">ex_saw.c │ │ │ │
  • ex_stream_file.c
    • │ │ │ │
  • ex_acodec_multi.c
    • │ │ │ │ │ │ │ │

    al_is_audio_installed

    │ │ │ │ -
    bool al_is_audio_installed(void)
    │ │ │ │ +
    bool al_is_audio_installed(void)
│ │ │ │ +bool al_is_audio_installed(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if al_install_audio was called │ │ │ │ previously and returned successfully.

    │ │ │ │

    al_reserve_samples

    │ │ │ │ -
    bool al_reserve_samples(int reserve_samples)
    │ │ │ │ +
    bool al_reserve_samples(int reserve_samples)
│ │ │ │ +bool al_reserve_samples(int reserve_samples)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Reserves a number of sample instances, attaching them to the default │ │ │ │ mixer. If no default mixer is set when this function is called, then it │ │ │ │ will create one and attach it to the default voice. If no default voice │ │ │ │ has been set, it, too, will be created.

    │ │ │ │ @@ -658,15 +663,17 @@ │ │ │ │
  • ex_audio_props.cpp
    • │ │ │ │
  • ex_resample_test.c
    • │ │ │ │ │ │ │ │

    al_play_sample

    │ │ │ │ 
    bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed,
│ │ │ │ -   ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id)
    │ │ │ │ + ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id) │ │ │ │ +bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed, │ │ │ │ + ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Plays a sample on one of the sample instances created by al_reserve_samples. Returns │ │ │ │ true on success, false on failure. Playback may fail because all the │ │ │ │ reserved sample instances are currently used.

    │ │ │ │ @@ -699,15 +706,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L107">ex_acodec_multi.c │ │ │ │
  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_stop_sample

    │ │ │ │ -
    void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id)
    │ │ │ │ +
    void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id)
│ │ │ │ +void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Stop the sample started by al_play_sample.

    │ │ │ │

    See also: al_stop_samples

    │ │ │ │ @@ -717,28 +725,30 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L123">ex_acodec_multi.c │ │ │ │
  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_stop_samples

    │ │ │ │ -
    void al_stop_samples(void)
    │ │ │ │ +
    void al_stop_samples(void)
│ │ │ │ +void al_stop_samples(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Stop all samples started by al_play_sample.

    │ │ │ │

    See also: al_stop_sample

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_lock_sample_id

    │ │ │ │ -
    ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)
    │ │ │ │ +
    ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)
│ │ │ │ +ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Locks a ALLEGRO_SAMPLE_ID, │ │ │ │ returning the underlying ALLEGRO_SAMPLE_INSTANCE. │ │ │ │ This allows you to adjust the various properties of the instance (such │ │ │ │ @@ -760,15 +770,16 @@ │ │ │ │

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_unlock_sample_id

    │ │ │ │ -
    void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)
    │ │ │ │ +
    void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)
│ │ │ │ +void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Unlocks a ALLEGRO_SAMPLE_ID, allowing │ │ │ │ future calls to al_play_sample │ │ │ │ to reuse it if possible. Note that after the id is unlocked, the │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_play_audio_stream

    │ │ │ │ -
    ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)
    │ │ │ │ +
    ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)
│ │ │ │ +ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Loads and plays an audio file, streaming from disk as it is needed. │ │ │ │ This API can only play one audio stream at a time. This requires a │ │ │ │ default mixer to be set, which is typically done via al_reserve_samples, but can │ │ │ │ @@ -818,15 +830,16 @@ │ │ │ │ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_play_audio_stream_f

    │ │ │ │ -
    ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)
    │ │ │ │ +
    ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)
│ │ │ │ +ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Loads and plays an audio file from ALLEGRO_FILE stream, streaming it is │ │ │ │ needed. This API can only play one audio stream at a time. This requires │ │ │ │ a default mixer to be set, which is typically done via Since: 5.2.8

    │ │ │ │
    │ │ │ │

    Unstable │ │ │ │ API: New API.

    │ │ │ │
    │ │ │ │

    Samples

    │ │ │ │

    ALLEGRO_SAMPLE

    │ │ │ │ -
    typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE;
    │ │ │ │ +
    typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE;
│ │ │ │ +typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An ALLEGRO_SAMPLE object stores the data necessary for playing │ │ │ │ pre-defined digital audio. It holds a user-specified PCM data buffer and │ │ │ │ information about its format (data length, depth, frequency, channel │ │ │ │ configuration). You can have the same ALLEGRO_SAMPLE playing multiple │ │ │ │ @@ -874,15 +888,18 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L21">ex_acodec_multi.c │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │ │ │ │ │

    al_create_sample

    │ │ │ │ 
    ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples,
│ │ │ │     unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,
│ │ │ │ -   ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf)
    │ │ │ │ + ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf) │ │ │ │ +ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples, │ │ │ │ + unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ + ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Create a sample data structure from the supplied buffer. If │ │ │ │ free_buf is true then the buffer will be freed with al_free when the sample data structure is │ │ │ │ destroyed. For portability (especially Windows), the buffer should have │ │ │ │ @@ -912,15 +929,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L83">ex_acodec_multi.c │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_load_sample

    │ │ │ │ -
    ALLEGRO_SAMPLE *al_load_sample(const char *filename)
    │ │ │ │ +
    ALLEGRO_SAMPLE *al_load_sample(const char *filename)
│ │ │ │ +ALLEGRO_SAMPLE *al_load_sample(const char *filename)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Loads a few different audio file formats based on their │ │ │ │ extension.

    │ │ │ │

    Note that this stores the entire file in memory at once, which may be │ │ │ │ time consuming. To read the file as it is needed, use ex_acodec_multi.c │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_load_sample_f

    │ │ │ │ -
    ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident)
    │ │ │ │ +
    ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident)
│ │ │ │ +ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Loads an audio file from an ALLEGRO_FILE stream into an ALLEGRO_SAMPLE. The file type is │ │ │ │ determined by the passed ‘ident’ parameter, which is a file name │ │ │ │ @@ -966,15 +985,16 @@ │ │ │ │ file formats by default. You must use the allegro_acodec addon, or │ │ │ │ register your own format handler.

    │ │ │ │ │ │ │ │

    See also: al_register_sample_loader_f, │ │ │ │ al_init_acodec_addon

    │ │ │ │

    al_save_sample

    │ │ │ │ -
    bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl)
    │ │ │ │ +
    bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl)
│ │ │ │ +bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Writes a sample into a file. Currently, wav is the only supported │ │ │ │ format, and the extension must be “.wav”.

    │ │ │ │

    Returns true on success, false on error.

    │ │ │ │
    │ │ │ │ @@ -983,15 +1003,16 @@ │ │ │ │ register your own format handler.

    │ │ │ │
    │ │ │ │

    See also: al_save_sample_f, │ │ │ │ al_register_sample_saver, │ │ │ │ al_init_acodec_addon

    │ │ │ │

    al_save_sample_f

    │ │ │ │ -
    bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl)
    │ │ │ │ +
    bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl)
│ │ │ │ +bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Writes a sample into a ALLEGRO_FILE filestream. Currently, │ │ │ │ wav is the only supported format, and the extension must be “.wav”.

    │ │ │ │

    Returns true on success, false on error. The file remains open │ │ │ │ @@ -1001,15 +1022,16 @@ │ │ │ │ file formats by default. You must use the allegro_acodec addon, or │ │ │ │ register your own format handler.

    │ │ │ │ │ │ │ │

    See also: al_save_sample, al_register_sample_saver_f, │ │ │ │ al_init_acodec_addon

    │ │ │ │

    al_destroy_sample

    │ │ │ │ -
    void al_destroy_sample(ALLEGRO_SAMPLE *spl)
    │ │ │ │ +
    void al_destroy_sample(ALLEGRO_SAMPLE *spl)
│ │ │ │ +void al_destroy_sample(ALLEGRO_SAMPLE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Free the sample data structure. If it was created with the │ │ │ │ free_buf parameter set to true, then the buffer will be │ │ │ │ freed with al_free.

    │ │ │ │

    This function will stop any sample instances which may be playing the │ │ │ │ @@ -1025,61 +1047,66 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L86">ex_acodec_multi.c │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_get_sample_channels

    │ │ │ │ -
    ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl)
    │ │ │ │ +
    ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl)
│ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the channel configuration of the sample.

    │ │ │ │

    See also: ALLEGRO_CHANNEL_CONF, al_get_sample_depth, al_get_sample_frequency, │ │ │ │ al_get_sample_length, al_get_sample_data

    │ │ │ │

    al_get_sample_depth

    │ │ │ │ -
    ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl)
    │ │ │ │ +
    ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl)
│ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the audio depth of the sample.

    │ │ │ │

    See also: ALLEGRO_AUDIO_DEPTH, al_get_sample_channels, al_get_sample_frequency, │ │ │ │ al_get_sample_length, al_get_sample_data

    │ │ │ │

    al_get_sample_frequency

    │ │ │ │ -
    unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl)
    │ │ │ │ +
    unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl)
│ │ │ │ +unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the frequency (in Hz) of the sample.

    │ │ │ │

    See also: al_get_sample_channels, al_get_sample_depth, al_get_sample_length, al_get_sample_data

    │ │ │ │

    al_get_sample_length

    │ │ │ │ -
    unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl)
    │ │ │ │ +
    unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl)
│ │ │ │ +unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the length of the sample in sample values.

    │ │ │ │

    See also: al_get_sample_channels, al_get_sample_depth, al_get_sample_frequency, │ │ │ │ al_get_sample_data

    │ │ │ │

    al_get_sample_data

    │ │ │ │ -
    void *al_get_sample_data(const ALLEGRO_SAMPLE *spl)
    │ │ │ │ +
    void *al_get_sample_data(const ALLEGRO_SAMPLE *spl)
│ │ │ │ +void *al_get_sample_data(const ALLEGRO_SAMPLE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return a pointer to the raw sample data.

    │ │ │ │

    See also: al_get_sample_channels, al_get_sample_depth, al_set_default_mixer.

    │ │ │ │

    Sample instances

    │ │ │ │

    ALLEGRO_SAMPLE_INSTANCE

    │ │ │ │ -
    typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE;
    │ │ │ │ +
    typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE;
│ │ │ │ +typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An ALLEGRO_SAMPLE_INSTANCE object represents a playable instance of a │ │ │ │ predefined sound effect. It holds information about how the effect │ │ │ │ should be played: These playback parameters consist of the looping mode, │ │ │ │ loop start/end points, playing position, speed, gain, pan and the │ │ │ │ @@ -1206,15 +1234,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L22">ex_acodec_multi.c │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_create_sample_instance

    │ │ │ │ -
    ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data)
    │ │ │ │ +
    ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data)
│ │ │ │ +ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates a sample instance, using the supplied sample data. The │ │ │ │ instance must be attached to a mixer (or voice) in order to actually │ │ │ │ produce output.

    │ │ │ │

    The argument may be NULL. You can then set the sample data later with │ │ │ │ @@ -1227,15 +1256,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L83">ex_acodec_multi.c │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_destroy_sample_instance

    │ │ │ │ -
    void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Detaches the sample instance from anything it may be attached to and │ │ │ │ frees it (the sample data, i.e. its ALLEGRO_SAMPLE, is not │ │ │ │ freed!).

    │ │ │ │

    See also: ex_acodec_multi.c │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_play_sample_instance

    │ │ │ │ -
    bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Play the sample instance. Returns true on success, false on │ │ │ │ failure.

    │ │ │ │

    See also: al_stop_sample_instance

    │ │ │ │ @@ -1264,15 +1295,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L107">ex_acodec_multi.c │ │ │ │
  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_stop_sample_instance

    │ │ │ │ -
    bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Stop an sample instance playing.

    │ │ │ │

    See also: al_play_sample_instance

    │ │ │ │

    Examples:

    │ │ │ │ @@ -1283,15 +1315,17 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_kcm_direct.c#L88">ex_kcm_direct.c │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_get_sample_instance_channels

    │ │ │ │ 
    ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels(
│ │ │ │ -   const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ + const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels( │ │ │ │ + const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the channel configuration of the sample instance’s sample │ │ │ │ data.

    │ │ │ │

    See also: ALLEGRO_CHANNEL_CONF.

    │ │ │ │ @@ -1299,42 +1333,45 @@ │ │ │ │ │ │ │ │

    al_get_sample_instance_depth

    │ │ │ │ -
    ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the audio depth of the sample instance’s sample data.

    │ │ │ │

    See also: ALLEGRO_AUDIO_DEPTH.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_sample_instance_frequency

    │ │ │ │ -
    unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the frequency (in Hz) of the sample instance’s sample │ │ │ │ data.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_sample_instance_length

    │ │ │ │ -
    unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the length of the sample instance in sample values. This │ │ │ │ property may differ from the length of the instance’s sample data.

    │ │ │ │

    See also: al_set_sample_instance_length, │ │ │ │ @@ -1346,15 +1383,17 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_props.cpp#L196">ex_audio_props.cpp │ │ │ │

  • ex_audio_simple.c
    • │ │ │ │ │ │ │ │

    al_set_sample_instance_length

    │ │ │ │ 
    bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl,
│ │ │ │ -   unsigned int val)
    │ │ │ │ + unsigned int val) │ │ │ │ +bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ + unsigned int val) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the length of the sample instance in sample values. This can be │ │ │ │ used to play only parts of the underlying sample. Be careful not to │ │ │ │ exceed the actual length of the sample data, though.

    │ │ │ │

    Return true on success, false on failure. Will fail if the sample │ │ │ │ @@ -1364,30 +1403,33 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_sample_instance_position

    │ │ │ │ -
    unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Get the playback position of a sample instance.

    │ │ │ │

    See also: al_set_sample_instance_position

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_sample_instance_position

    │ │ │ │ 
    bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl,
│ │ │ │ -   unsigned int val)
    │ │ │ │ + unsigned int val) │ │ │ │ +bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ + unsigned int val) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the playback position of a sample instance.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: al_get_sample_instance_position

    │ │ │ │ @@ -1395,23 +1437,25 @@ │ │ │ │ │ │ │ │

    al_get_sample_instance_speed

    │ │ │ │ -
    float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the relative playback speed of the sample instance.

    │ │ │ │

    See also: al_set_sample_instance_speed

    │ │ │ │

    al_set_sample_instance_speed

    │ │ │ │ -
    bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
    │ │ │ │ +
    bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
│ │ │ │ +bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the relative playback speed of the sample instance. 1.0 means │ │ │ │ normal speed.

    │ │ │ │

    Return true on success, false on failure. Will fail if the sample │ │ │ │ instance is attached directly to a voice.

    │ │ │ │ @@ -1421,28 +1465,30 @@ │ │ │ │ │ │ │ │

    al_get_sample_instance_gain

    │ │ │ │ -
    float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the playback gain of the sample instance.

    │ │ │ │

    See also: al_set_sample_instance_gain

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_sample_instance_gain

    │ │ │ │ -
    bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
    │ │ │ │ +
    bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
│ │ │ │ +bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the playback gain of the sample instance.

    │ │ │ │

    Returns true on success, false on failure. Will fail if the sample │ │ │ │ instance is attached directly to a voice.

    │ │ │ │

    See also: ex_mixer_chain.c │ │ │ │

  • ex_acodec.c
    • │ │ │ │
  • ex_audio_props.cpp
    • │ │ │ │ │ │ │ │

    al_get_sample_instance_pan

    │ │ │ │ -
    float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Get the pan value of the sample instance.

    │ │ │ │

    See also: al_set_sample_instance_pan.

    │ │ │ │

    al_set_sample_instance_pan

    │ │ │ │ -
    bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
    │ │ │ │ +
    bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
│ │ │ │ +bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the pan value on a sample instance. A value of -1.0 means to play │ │ │ │ the sample only through the left speaker; +1.0 means only through the │ │ │ │ right speaker; 0.0 means the sample is centre balanced. A special value │ │ │ │ ALLEGRO_AUDIO_PAN_NONE │ │ │ │ @@ -1489,15 +1537,16 @@ │ │ │ │

    │ │ │ │

    al_get_sample_instance_time

    │ │ │ │ -
    float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the length of the sample instance in seconds, assuming a │ │ │ │ playback speed of 1.0.

    │ │ │ │

    See also: al_get_sample_instance_length

    │ │ │ │ @@ -1508,26 +1557,29 @@ │ │ │ │
  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_get_sample_instance_playmode

    │ │ │ │ -
    ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the playback mode of the sample instance.

    │ │ │ │

    See also: ALLEGRO_PLAYMODE, │ │ │ │ al_set_sample_instance_playmode

    │ │ │ │

    al_set_sample_instance_playmode

    │ │ │ │ 
    bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl,
│ │ │ │ -   ALLEGRO_PLAYMODE val)
    │ │ │ │ + ALLEGRO_PLAYMODE val) │ │ │ │ +bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ + ALLEGRO_PLAYMODE val) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the playback mode of the sample instance.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: ALLEGRO_PLAYMODE, │ │ │ │ ex_mixer_chain.c │ │ │ │

  • ex_acodec.c
    • │ │ │ │ │ │ │ │

    al_get_sample_instance_playing

    │ │ │ │ -
    bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ -Code

    │ │ │ │ +href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_in_stream_loader#L%20size_t%20buffer_count,%20unsigned%20int%20samples">Source │ │ │ │ +Code))

    │ │ │ │

    Return true if the sample instance is in the playing state. This may │ │ │ │ be true even if the instance is not attached to anything.

    │ │ │ │

    See also: al_set_sample_instance_playing

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_sample_instance_playing

    │ │ │ │ -
    bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val)
    │ │ │ │ +
    bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val)
│ │ │ │ +bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Change whether the sample instance is playing.

    │ │ │ │

    The instance does not need to be attached to anything (since: │ │ │ │ 5.1.8).

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │ @@ -1573,27 +1627,29 @@ │ │ │ │
  • ex_audio_props.cpp
    • │ │ │ │
  • ex_audio_chain.cpp
    • │ │ │ │ │ │ │ │

    al_get_sample_instance_attached

    │ │ │ │ -
    bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return whether the sample instance is attached to something.

    │ │ │ │

    See also: al_attach_sample_instance_to_mixer, │ │ │ │ al_attach_sample_instance_to_voice, │ │ │ │ al_detach_sample_instance

    │ │ │ │

    al_detach_sample_instance

    │ │ │ │ -
    bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Detach the sample instance from whatever it’s attached to, if │ │ │ │ anything.

    │ │ │ │

    Returns true on success.

    │ │ │ │

    See also: al_get_sample_instance_attached

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_sample

    │ │ │ │ -
    ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │ +
    ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl)
│ │ │ │ +ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the sample data that the sample instance plays.

    │ │ │ │

    Note this returns a pointer to an internal structure, not │ │ │ │ the ALLEGRO_SAMPLE that you may │ │ │ │ have passed to al_set_sample. │ │ │ │ @@ -1628,15 +1685,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L109">ex_acodec_multi.c │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_set_sample

    │ │ │ │ -
    bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data)
    │ │ │ │ +
    bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data)
│ │ │ │ +bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Change the sample data that a sample instance plays. This can be │ │ │ │ quite an involved process.

    │ │ │ │

    First, the sample is stopped if it is not already.

    │ │ │ │

    Next, if data is NULL, the sample is detached from its parent (if │ │ │ │ @@ -1658,15 +1716,16 @@ │ │ │ │

  • ex_mixer_chain.c
    • │ │ │ │
  • ex_acodec.c
    • │ │ │ │ │ │ │ │

    al_set_sample_instance_channel_matrix

    │ │ │ │ -
    bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const float *matrix)
    │ │ │ │ +
    bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const float *matrix)
│ │ │ │ +bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const float *matrix)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the matrix used to mix the channels coming from this instance │ │ │ │ into the mixer it is attached to. Normally Allegro derives the values of │ │ │ │ this matrix from the gain and pan settings, as well as the channel │ │ │ │ configurations of this instance and the mixer it is attached to, but │ │ │ │ @@ -1696,15 +1755,16 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    Audio streams

    │ │ │ │

    ALLEGRO_AUDIO_STREAM

    │ │ │ │ -
    typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM;
    │ │ │ │ +
    typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM;
│ │ │ │ +typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An ALLEGRO_AUDIO_STREAM object is used to stream generated audio to │ │ │ │ the sound device, in real-time. This is done by reading from a buffer, │ │ │ │ which is split into a number of fragments. Whenever a fragment has │ │ │ │ finished playing, the user can refill it with new data.

    │ │ │ │ @@ -1762,15 +1822,18 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_file.c#L79">ex_stream_file.c │ │ │ │
  • ex_resample_test.c
    • │ │ │ │ │ │ │ │

    al_create_audio_stream

    │ │ │ │ 
    ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count,
│ │ │ │     unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth,
│ │ │ │ -   ALLEGRO_CHANNEL_CONF chan_conf)
    │ │ │ │ + ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count, │ │ │ │ + unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ + ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates an ALLEGRO_AUDIO_STREAM. The │ │ │ │ stream will be set to play by default. It will feed audio data from a │ │ │ │ buffer, which is split into a number of fragments.

    │ │ │ │ @@ -1826,15 +1889,17 @@ │ │ │ │
  • ex_resample_test.c
    • │ │ │ │
  • ex_synth.cpp
    • │ │ │ │ │ │ │ │

    al_load_audio_stream

    │ │ │ │ 
    ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename,
│ │ │ │ -   size_t buffer_count, unsigned int samples)
    │ │ │ │ + size_t buffer_count, unsigned int samples) │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename, │ │ │ │ + size_t buffer_count, unsigned int samples) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Loads an audio file from disk as it is needed.

    │ │ │ │

    Unlike regular streams, the one returned by this function need not be │ │ │ │ fed by the user; the library will automatically read more of the file as │ │ │ │ it is needed. The stream will contain buffer_count buffers with │ │ │ │ @@ -1860,15 +1925,17 @@ │ │ │ │

  • ex_mixer_pp.c
    • │ │ │ │
  • ex_stream_seek.c
    • │ │ │ │ │ │ │ │

    al_load_audio_stream_f

    │ │ │ │ 
    ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident,
│ │ │ │ -   size_t buffer_count, unsigned int samples)
    │ │ │ │ + size_t buffer_count, unsigned int samples) │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident, │ │ │ │ + size_t buffer_count, unsigned int samples) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Loads an audio file from ALLEGRO_FILE stream as it is │ │ │ │ needed.

    │ │ │ │

    Unlike regular streams, the one returned by this function need not be │ │ │ │ @@ -1890,15 +1957,16 @@ │ │ │ │ register your own format handler.

    │ │ │ │ │ │ │ │

    See also: al_load_audio_stream, al_register_audio_stream_loader_f, │ │ │ │ al_init_acodec_addon

    │ │ │ │

    al_destroy_audio_stream

    │ │ │ │ -
    void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Destroy an audio stream which was created with al_create_audio_stream or │ │ │ │ al_load_audio_stream.

    │ │ │ │
    │ │ │ │ @@ -1916,15 +1984,17 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_file.c#L124">ex_stream_file.c │ │ │ │
  • ex_resample_test.c
    • │ │ │ │ │ │ │ │

    al_get_audio_stream_event_source

    │ │ │ │ 
    ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source(
│ │ │ │ -   ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ + ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source( │ │ │ │ + ALLEGRO_AUDIO_STREAM *stream) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Retrieve the associated event source.

    │ │ │ │

    See al_get_audio_stream_fragment │ │ │ │ for a description of the ex_saw.c │ │ │ │

  • ex_stream_file.c
    • │ │ │ │
  • ex_resample_test.c
    • │ │ │ │ │ │ │ │

    al_drain_audio_stream

    │ │ │ │ -
    void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    You should call this to finalise an audio stream that you will no │ │ │ │ longer be feeding, to wait for all pending buffers to finish playing. │ │ │ │ The stream’s playing state will change to false.

    │ │ │ │

    See also: ex_saw.c │ │ │ │

  • ex_resample_test.c
    • │ │ │ │
  • ex_record.c
    • │ │ │ │ │ │ │ │

    al_rewind_audio_stream

    │ │ │ │ -
    bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the streaming file playing position to the beginning. Returns │ │ │ │ true on success. Currently this can only be called on streams created │ │ │ │ with al_load_audio_stream, │ │ │ │ al_play_audio_stream, Examples:

    │ │ │ │ │ │ │ │

    al_get_audio_stream_frequency

    │ │ │ │ -
    unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the stream frequency (in Hz).

    │ │ │ │

    al_get_audio_stream_channels

    │ │ │ │ 
    ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels(
│ │ │ │ -   const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels( │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the stream channel configuration.

    │ │ │ │

    See also: ALLEGRO_CHANNEL_CONF.

    │ │ │ │

    al_get_audio_stream_depth

    │ │ │ │ 
    ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth(
│ │ │ │ -   const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth( │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the stream audio depth.

    │ │ │ │

    See also: ALLEGRO_AUDIO_DEPTH.

    │ │ │ │

    al_get_audio_stream_length

    │ │ │ │ -
    unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the stream length in samples.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_audio_stream_speed

    │ │ │ │ -
    float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the relative playback speed of the stream.

    │ │ │ │

    See also: al_set_audio_stream_speed.

    │ │ │ │

    al_set_audio_stream_speed

    │ │ │ │ -
    bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val)
    │ │ │ │ +
    bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val)
│ │ │ │ +bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the relative playback speed of the stream. 1.0 means normal │ │ │ │ speed.

    │ │ │ │

    Return true on success, false on failure. Will fail if the audio │ │ │ │ stream is attached directly to a voice.

    │ │ │ │

    See also: al_get_audio_stream_speed.

    │ │ │ │

    al_get_audio_stream_gain

    │ │ │ │ -
    float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the playback gain of the stream.

    │ │ │ │

    See also: al_set_audio_stream_gain.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_audio_stream_gain

    │ │ │ │ -
    bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val)
    │ │ │ │ +
    bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val)
│ │ │ │ +bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the playback gain of the stream.

    │ │ │ │

    Returns true on success, false on failure. Will fail if the audio │ │ │ │ stream is attached directly to a voice.

    │ │ │ │

    See also: │ │ │ │

  • ex_synth.cpp
    • │ │ │ │
  • ex_audio_chain.cpp
    • │ │ │ │ │ │ │ │

    al_get_audio_stream_pan

    │ │ │ │ -
    float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *streamR *mixer, ALLEGRO_MIXER_QUALITY new_quality)
│ │ │ │ +float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ +href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_mixer.c#L969">Source │ │ │ │ Code

    │ │ │ │

    Get the pan value of the stream.

    │ │ │ │

    See also: al_set_audio_stream_pan.

    │ │ │ │

    al_set_audio_stream_pan

    │ │ │ │ -
    bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val)
    │ │ │ │ +
    bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val)
│ │ │ │ +bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the pan value on an audio stream. A value of -1.0 means to play │ │ │ │ the stream only through the left speaker; +1.0 means only through the │ │ │ │ right speaker; 0.0 means the sample is centre balanced. A special value │ │ │ │ ALLEGRO_AUDIO_PAN_NONE │ │ │ │ @@ -2087,15 +2171,16 @@ │ │ │ │ href="audio.html#allegro_audio_pan_none">ALLEGRO_AUDIO_PAN_NONE

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_audio_stream_playing

    │ │ │ │ -
    bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return true if the stream is playing.

    │ │ │ │

    See also: al_set_audio_stream_playing.

    │ │ │ │

    Examples:

    │ │ │ │ @@ -2104,15 +2189,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_record.c#L274">ex_record.c │ │ │ │
  • ex_stream_seek.c
    • │ │ │ │
  • ex_audio_chain.cpp
    • │ │ │ │ │ │ │ │

    al_set_audio_stream_playing

    │ │ │ │ -
    bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val)
    │ │ │ │ +
    bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val)
│ │ │ │ +bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Change whether the stream is playing.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: al_get_audio_stream_playing

    │ │ │ │ @@ -2123,25 +2209,29 @@ │ │ │ │
  • ex_record.c
    • │ │ │ │
  • ex_stream_seek.c
    • │ │ │ │ │ │ │ │

    al_get_audio_stream_playmode

    │ │ │ │ 
    ALLEGRO_PLAYMODE al_get_audio_stream_playmode(
│ │ │ │ -   const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ +ALLEGRO_PLAYMODE al_get_audio_stream_playmode( │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the playback mode of the stream.

    │ │ │ │

    See also: ALLEGRO_PLAYMODE, │ │ │ │ al_set_audio_stream_playmode.

    │ │ │ │

    al_set_audio_stream_playmode

    │ │ │ │ 
    bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream,
│ │ │ │ -   ALLEGRO_PLAYMODE val)
    │ │ │ │ + ALLEGRO_PLAYMODE val) │ │ │ │ +bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ + ALLEGRO_PLAYMODE val) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the playback mode of the stream.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: ALLEGRO_PLAYMODE, │ │ │ │ ex_stream_file.c │ │ │ │

  • ex_mixer_pp.c
    • │ │ │ │
  • ex_stream_seek.c
    • │ │ │ │ │ │ │ │

    al_get_audio_stream_attached

    │ │ │ │ -
    bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return whether the stream is attached to something.

    │ │ │ │

    See also: al_attach_audio_stream_to_mixer, │ │ │ │ al_attach_audio_stream_to_voice, │ │ │ │ al_detach_audio_stream.

    │ │ │ │

    al_detach_audio_stream

    │ │ │ │ -
    bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Detach the stream from whatever it’s attached to, if anything.

    │ │ │ │

    See also: al_attach_audio_stream_to_mixer, │ │ │ │ Examples:

    │ │ │ │ │ │ │ │

    al_get_audio_stream_played_samples

    │ │ │ │ -
    uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Get the number of samples consumed by the parent since the audio │ │ │ │ stream was started.

    │ │ │ │

    Since: 5.1.8

    │ │ │ │

    al_get_audio_stream_fragment

    │ │ │ │ -
    void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    When using Allegro’s audio streaming, you will use this function to │ │ │ │ continuously provide new sample data to a stream.

    │ │ │ │

    If the stream is ready for new data, the function will return the │ │ │ │ address of an internal buffer to be filled with audio data. The length │ │ │ │ @@ -2236,15 +2330,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_saw.c#L39">ex_saw.c │ │ │ │

  • ex_resample_test.c
    • │ │ │ │
  • ex_synth.cpp
    • │ │ │ │ │ │ │ │

    al_set_audio_stream_fragment

    │ │ │ │ -
    bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val)
    │ │ │ │ +
    bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val)
│ │ │ │ +bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This function needs to be called for every successful call of al_get_audio_stream_fragment │ │ │ │ to indicate that the buffer (pointed to by val) is filled │ │ │ │ with new data.

    │ │ │ │ @@ -2257,39 +2352,43 @@ │ │ │ │
  • ex_resample_test.c
    • │ │ │ │
  • ex_synth.cpp
    • │ │ │ │ │ │ │ │

    al_get_audio_stream_fragments

    │ │ │ │ -
    unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the number of fragments this stream uses. This is the same │ │ │ │ value as passed to al_create_audio_stream when │ │ │ │ a new stream is created.

    │ │ │ │

    See also: al_get_available_audio_stream_fragments

    │ │ │ │

    al_get_available_audio_stream_fragments

    │ │ │ │ 
    unsigned int al_get_available_audio_stream_fragments(
│ │ │ │ -   const ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ +unsigned int al_get_available_audio_stream_fragments( │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the number of available fragments in the stream, that is, │ │ │ │ fragments which are not currently filled with data for playback.

    │ │ │ │

    See also: al_get_audio_stream_fragment, │ │ │ │ al_get_audio_stream_fragments

    │ │ │ │

    al_seek_audio_stream_secs

    │ │ │ │ -
    bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)
    │ │ │ │ +
    bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)
│ │ │ │ +bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the streaming file playing position to time. Returns true on │ │ │ │ success. Currently this can only be called on streams created with al_load_audio_stream, al_play_audio_stream, Examples:

    │ │ │ │ │ │ │ │

    al_get_audio_stream_position_secs

    │ │ │ │ -
    double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the position of the stream in seconds. Currently this can only │ │ │ │ be called on streams created with al_load_audio_stream, al_play_audio_stream, Examples:

    │ │ │ │ │ │ │ │

    al_get_audio_stream_length_secs

    │ │ │ │ -
    double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │ +
    double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream)
│ │ │ │ +double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the length of the stream in seconds, if known. Otherwise │ │ │ │ returns zero.

    │ │ │ │

    Currently this can only be called on streams created with al_load_audio_stream, │ │ │ │

  • ex_stream_seek.c
    • │ │ │ │ │ │ │ │

    al_set_audio_stream_loop_secs

    │ │ │ │ 
    bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream,
│ │ │ │ -   double start, double end)
    │ │ │ │ + double start, double end) │ │ │ │ +bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ + double start, double end) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sets the loop points for the stream in seconds. Currently this can │ │ │ │ only be called on streams created with al_load_audio_stream, al_play_audio_stream, │ │ │ │

    Unstable │ │ │ │ API: New API.

    │ │ │ │
    │ │ │ │

    Advanced audio file I/O

    │ │ │ │

    al_register_sample_loader

    │ │ │ │ 
    bool al_register_sample_loader(const char *ext,
│ │ │ │ -   ALLEGRO_SAMPLE *(*loader)(const char *filename))
    │ │ │ │ + ALLEGRO_SAMPLE *(*loader)(const char *filename)) │ │ │ │ +bool al_register_sample_loader(const char *ext, │ │ │ │ + ALLEGRO_SAMPLE *(*loader)(const char *filename)) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Register a handler for al_load_sample. The given function │ │ │ │ will be used to handle the loading of sample files with the given │ │ │ │ extension.

    │ │ │ │ @@ -2395,15 +2500,17 @@ │ │ │ │ unregistering an entry that doesn’t exist.

    │ │ │ │

    See also: al_register_sample_loader_f, │ │ │ │ al_register_sample_saver

    │ │ │ │

    al_register_sample_loader_f

    │ │ │ │ 
    bool al_register_sample_loader_f(const char *ext,
│ │ │ │ -   ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp))
    │ │ │ │ + ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp)) │ │ │ │ +bool al_register_sample_loader_f(const char *ext, │ │ │ │ + ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp)) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Register a handler for al_load_sample_f. The given │ │ │ │ function will be used to handle the loading of sample files with the │ │ │ │ given extension.

    │ │ │ │ @@ -2413,15 +2520,17 @@ │ │ │ │ entry.

    │ │ │ │

    Returns true on success, false on error. Returns false if │ │ │ │ unregistering an entry that doesn’t exist.

    │ │ │ │

    See also: al_register_sample_loader

    │ │ │ │

    al_register_sample_saver

    │ │ │ │ 
    bool al_register_sample_saver(const char *ext,
│ │ │ │ -   bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl))
    │ │ │ │ + bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl)) │ │ │ │ +bool al_register_sample_saver(const char *ext, │ │ │ │ + bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl)) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Register a handler for al_save_sample. The given function │ │ │ │ will be used to handle the saving of sample files with the given │ │ │ │ extension.

    │ │ │ │ @@ -2434,15 +2543,17 @@ │ │ │ │

    See also: al_register_sample_saver_f, │ │ │ │ al_register_sample_loader

    │ │ │ │

    al_register_sample_saver_f

    │ │ │ │ 
    bool al_register_sample_saver_f(const char *ext,
│ │ │ │ -   bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl))
    │ │ │ │ + bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl)) │ │ │ │ +bool al_register_sample_saver_f(const char *ext, │ │ │ │ + bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl)) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Register a handler for al_save_sample_f. The given │ │ │ │ function will be used to handle the saving of sample files with the │ │ │ │ given extension.

    │ │ │ │ @@ -2455,15 +2566,17 @@ │ │ │ │

    See also: al_register_sample_saver

    │ │ │ │

    al_register_audio_stream_loader

    │ │ │ │ 
    bool al_register_audio_stream_loader(const char *ext,
│ │ │ │     ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename,
│ │ │ │ -      size_t buffer_count, unsigned int samples))
    │ │ │ │ +bool al_register_audio_stream_loader(const char *ext, │ │ │ │ + ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename, │ │ │ │ + size_t buffer_count, unsigned int samples)) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Register a handler for al_load_audio_stream and al_play_audio_stream. The │ │ │ │ given function will be used to open streams from files with the given │ │ │ │ @@ -2477,15 +2590,18 @@ │ │ │ │

    See also: al_register_audio_stream_loader_f

    │ │ │ │

    al_register_audio_stream_loader_f

    │ │ │ │ 
    bool al_register_audio_stream_loader_f(const char *ext,
│ │ │ │     ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp,
│ │ │ │ -      size_t buffer_count, unsigned int samples))
    │ │ │ │ + size_t buffer_count, unsigned int samples)) │ │ │ │ +bool al_register_audio_stream_loader_f(const char *ext, │ │ │ │ + ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp, │ │ │ │ + size_t buffer_count, unsigned int samples)) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Register a handler for al_load_audio_stream_f and │ │ │ │ al_play_audio_stream_f. │ │ │ │ The given function will be used to open streams from files with the │ │ │ │ @@ -2498,15 +2614,17 @@ │ │ │ │ unregistering an entry that doesn’t exist.

    │ │ │ │

    See also: al_register_audio_stream_loader

    │ │ │ │

    al_register_sample_identifier

    │ │ │ │ 
    bool al_register_sample_identifier(const char *ext,
│ │ │ │ -   bool (*identifier)(ALLEGRO_FILE* fp))
    │ │ │ │ + bool (*identifier)(ALLEGRO_FILE* fp)) │ │ │ │ +bool al_register_sample_identifier(const char *ext, │ │ │ │ + bool (*identifier)(ALLEGRO_FILE* fp)) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Register an identify handler for al_identify_sample. The given │ │ │ │ function will be used to detect files for the given extension. It will │ │ │ │ be called with a single argument of type Returns true on success, false on error. Returns false if │ │ │ │ unregistering an entry that doesn’t exist.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    See also: al_identify_bitmap

    │ │ │ │

    al_identify_sample

    │ │ │ │ 
    char const *al_identify_sample(char const *filename)
    │ │ │ │ +class="sourceCode c">char const *al_identify_sample(char const *filename) │ │ │ │ +char const *al_identify_sample(char const *filename) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This works exactly as al_identify_sample_f but you │ │ │ │ specify the filename of the file for which to detect the type and not a │ │ │ │ file handle. The extension, if any, of the passed filename is not taken │ │ │ │ @@ -2539,15 +2658,16 @@ │ │ │ │

    Since: 5.2.8

    │ │ │ │

    See also: al_init_acodec_addon, al_identify_sample_f, al_register_sample_identifier

    │ │ │ │

    al_identify_sample_f

    │ │ │ │ 
    char const *al_identify_sample_f(ALLEGRO_FILE *fp)
    │ │ │ │ +class="sourceCode c">char const *al_identify_sample_f(ALLEGRO_FILE *fp) │ │ │ │ +char const *al_identify_sample_f(ALLEGRO_FILE *fp) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Tries to guess the audio file type of the open ALLEGRO_FILE by │ │ │ │ reading the first few bytes. By default Allegro cannot recognize any │ │ │ │ file types, but calling al_init_acodec_addon will │ │ │ │ @@ -2569,15 +2689,16 @@ │ │ │ │ add a small amount of latency. However, for most applications that small │ │ │ │ overhead will not adversely affect performance.

    │ │ │ │

    Recording is supported by the ALSA, AudioQueue, DirectSound8, and │ │ │ │ PulseAudio drivers. Enumerating or choosing other recording devices is │ │ │ │ not yet supported.

    │ │ │ │

    ALLEGRO_AUDIO_RECORDER

    │ │ │ │ 
    typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER;
    │ │ │ │ +class="sourceCode c">typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER; │ │ │ │ +typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER; │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An opaque datatype that represents a recording device.

    │ │ │ │

    Since: 5.1.1

    │ │ │ │
    │ │ │ │

    Unstable │ │ │ │ @@ -2588,15 +2709,16 @@ │ │ │ │

  • ex_record_name.c
    • │ │ │ │
  • ex_record.c
    • │ │ │ │ │ │ │ │

    ALLEGRO_AUDIO_RECORDER_EVENT

    │ │ │ │ 
    typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT;
    │ │ │ │ +class="sourceCode c">typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT; │ │ │ │ +typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT; │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Structure that holds the audio recorder event data. Every event type │ │ │ │ will contain:

    │ │ │ │
      │ │ │ │
    • .source: pointer to the audio recorder
      • │ │ │ │ @@ -2620,15 +2742,18 @@ │ │ │ │
    • ex_record.c
      • │ │ │ │
    │ │ │ │

    al_create_audio_recorder

    │ │ │ │ 
    ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count,
│ │ │ │     unsigned int samples, unsigned int frequency,
│ │ │ │ -   ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
    │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ +ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count, │ │ │ │ + unsigned int samples, unsigned int frequency, │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates an audio recorder using the system’s default recording │ │ │ │ device. (So if the returned device does not work, try updating the │ │ │ │ system’s default recording device.)

    │ │ │ │

    Allegro will internally buffer several seconds of captured audio with │ │ │ │ @@ -2665,15 +2790,16 @@ │ │ │ │

  • ex_record_name.c
    • │ │ │ │
  • ex_record.c
    • │ │ │ │ │ │ │ │

    al_start_audio_recorder

    │ │ │ │ 
    bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
    │ │ │ │ +class="sourceCode c">bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ +bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Begin recording into the fragment buffer. Once a complete fragment │ │ │ │ has been captured (as specified in al_create_audio_recorder), │ │ │ │ an ex_record_name.c │ │ │ │

  • ex_record.c
    • │ │ │ │ │ │ │ │

    al_stop_audio_recorder

    │ │ │ │ 
    void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
    │ │ │ │ +class="sourceCode c">void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ +void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Stop capturing audio data. Note that the audio recorder is still │ │ │ │ active and consuming resources, so if you are finished recording you │ │ │ │ should destroy it with al_destroy_audio_recorder.

    │ │ │ │ @@ -2710,28 +2837,30 @@ │ │ │ │
    │ │ │ │

    Unstable │ │ │ │ API: The API may need a slight redesign.

    │ │ │ │
    │ │ │ │

    al_is_audio_recorder_recording

    │ │ │ │ 
    bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r)
    │ │ │ │ +class="sourceCode c">bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ +bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if the audio recorder is currently capturing data and │ │ │ │ generating events.

    │ │ │ │

    Since: 5.1.1

    │ │ │ │
    │ │ │ │

    Unstable │ │ │ │ API: The API may need a slight redesign.

    │ │ │ │
    │ │ │ │

    al_get_audio_recorder_event

    │ │ │ │ 
    ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event)
    │ │ │ │ +class="sourceCode c">ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event) │ │ │ │ +ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the event as an ALLEGRO_AUDIO_RECORDER_EVENT.

    │ │ │ │

    Since: 5.1.1

    │ │ │ │
    │ │ │ │ @@ -2744,15 +2873,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_record_name.c#L131">ex_record_name.c │ │ │ │
  • ex_record.c
    • │ │ │ │ │ │ │ │

    al_get_audio_recorder_event_source

    │ │ │ │ 
    ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER *r)
    │ │ │ │ +class="sourceCode c">ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the event source for the recorder that generates the various │ │ │ │ recording events.

    │ │ │ │

    Since: 5.1.1

    │ │ │ │
    │ │ │ │ @@ -2764,15 +2894,16 @@ │ │ │ │
  • ex_record_name.c
    • │ │ │ │
  • ex_record.c
    • │ │ │ │ │ │ │ │

    al_destroy_audio_recorder

    │ │ │ │ 
    void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r)
    │ │ │ │ +class="sourceCode c">void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ +void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Destroys the audio recorder and frees all resources associated with │ │ │ │ it. It is safe to destroy a recorder that is recording.

    │ │ │ │

    You may receive events after the recorder has been destroyed. They │ │ │ │ must be ignored, as the fragment buffer will no longer be valid.

    │ │ │ │ @@ -2787,69 +2918,74 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_record_name.c#L215">ex_record_name.c │ │ │ │
  • ex_record.c
    • │ │ │ │ │ │ │ │

    Audio devices

    │ │ │ │

    ALLEGRO_AUDIO_DEVICE

    │ │ │ │ 
    typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE;
    │ │ │ │ +class="sourceCode c">typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE; │ │ │ │ +typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE; │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An opaque datatype that represents an audio device.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_num_audio_output_devices

    │ │ │ │ 
    int al_get_num_audio_output_devices()
    │ │ │ │ +class="sourceCode c">int al_get_num_audio_output_devices() │ │ │ │ +int al_get_num_audio_output_devices() │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Get the number of available audio output devices on the system.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    return -1 for unsupported drivers.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_audio_output_device

    │ │ │ │ 
    const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index)
    │ │ │ │ +class="sourceCode c">const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index) │ │ │ │ +const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Get the output audio device of the specified index.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_audio_device_name

    │ │ │ │ 
    const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device)
    │ │ │ │ +class="sourceCode c">const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device) │ │ │ │ +const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Get the user friendly display name of the device.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    Voices

    │ │ │ │

    ALLEGRO_VOICE

    │ │ │ │ 
    typedef struct ALLEGRO_VOICE ALLEGRO_VOICE;
    │ │ │ │ +class="sourceCode c">typedef struct ALLEGRO_VOICE ALLEGRO_VOICE; │ │ │ │ +typedef struct ALLEGRO_VOICE ALLEGRO_VOICE; │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A voice represents an audio device on the system, which may be a real │ │ │ │ device, or an abstract device provided by the operating system. To play │ │ │ │ back audio, you would attach a mixer, sample instance or audio stream to │ │ │ │ a voice.

    │ │ │ │ @@ -2864,15 +3000,17 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L24">ex_acodec_multi.c │ │ │ │
  • ex_kcm_direct.c
    • │ │ │ │ │ │ │ │

    al_create_voice

    │ │ │ │ 
    ALLEGRO_VOICE *al_create_voice(unsigned int freq,
│ │ │ │ -   ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
    │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ +ALLEGRO_VOICE *al_create_voice(unsigned int freq, │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates a voice structure and allocates a voice from the digital │ │ │ │ sound driver. The passed frequency (in Hz), sample format and channel │ │ │ │ configuration are used as a hint to what kind of data will be sent to │ │ │ │ the voice. However, the underlying sound driver is free to use │ │ │ │ @@ -2895,15 +3033,16 @@ │ │ │ │

  • ex_acodec_multi.c
    • │ │ │ │
  • ex_kcm_direct.c
    • │ │ │ │ │ │ │ │

    al_destroy_voice

    │ │ │ │ 
    void al_destroy_voice(ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">void al_destroy_voice(ALLEGRO_VOICE *voice) │ │ │ │ +void al_destroy_voice(ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Destroys the voice and deallocates it from the digital driver. Does │ │ │ │ nothing if the voice is NULL.

    │ │ │ │

    See also: al_create_voice

    │ │ │ │ @@ -2914,15 +3053,16 @@ │ │ │ │
  • ex_acodec_multi.c
    • │ │ │ │
  • ex_kcm_direct.c
    • │ │ │ │ │ │ │ │

    al_detach_voice

    │ │ │ │ 
    void al_detach_voice(ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">void al_detach_voice(ALLEGRO_VOICE *voice) │ │ │ │ +void al_detach_voice(ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Detaches the mixer, sample instance or audio stream from the │ │ │ │ voice.

    │ │ │ │

    See also: al_attach_mixer_to_voice, │ │ │ │ @@ -2930,15 +3070,17 @@ │ │ │ │ href="audio.html#al_attach_sample_instance_to_voice">al_attach_sample_instance_to_voice, │ │ │ │ al_attach_audio_stream_to_voice

    │ │ │ │

    al_attach_audio_stream_to_voice

    │ │ │ │ 
    bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream,
│ │ │ │ -   ALLEGRO_VOICE *voice)
    │ │ │ │ + ALLEGRO_VOICE *voice) │ │ │ │ +bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ + ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Attaches an audio stream to a voice. The same rules as al_attach_sample_instance_to_voice │ │ │ │ apply. This may fail if the driver can’t create a voice with the buffer │ │ │ │ count and buffer size the stream uses.

    │ │ │ │ @@ -2956,15 +3098,16 @@ │ │ │ │
  • ex_stream_file.c
    • │ │ │ │
  • ex_audio_chain.cpp
    • │ │ │ │ │ │ │ │

    al_attach_mixer_to_voice

    │ │ │ │ 
    bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice) │ │ │ │ +bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Attaches a mixer to a voice. It must have the same frequency and │ │ │ │ channel configuration, but the depth may be different.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: al_detach_voice, │ │ │ │ @@ -2979,15 +3122,17 @@ │ │ │ │

  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_attach_sample_instance_to_voice

    │ │ │ │ 
    bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl,
│ │ │ │ -   ALLEGRO_VOICE *voice)
    │ │ │ │ + ALLEGRO_VOICE *voice) │ │ │ │ +bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ + ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Attaches a sample instance to a voice, and allows it to play. The │ │ │ │ instance’s gain and loop mode will be ignored, and it must have the same │ │ │ │ frequency, channel configuration and depth (including signed-ness) as │ │ │ │ the voice. This function may fail if the selected driver doesn’t support │ │ │ │ @@ -3003,54 +3148,59 @@ │ │ │ │

  • ex_kcm_direct.c
    • │ │ │ │
  • ex_audio_chain.cpp
    • │ │ │ │ │ │ │ │

    al_get_voice_frequency

    │ │ │ │ 
    unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">unsigned int al_get_voic) │ │ │ │ +unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ +href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_stream.c#L248">Source │ │ │ │ Code

    │ │ │ │

    Return the frequency of the voice (in Hz), e.g. 44100.

    │ │ │ │

    al_get_voice_channels

    │ │ │ │ 
    ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice) │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the channel configuration of the voice.

    │ │ │ │

    See also: ALLEGRO_CHANNEL_CONF.

    │ │ │ │

    al_get_voice_depth

    │ │ │ │ 
    ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice) │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the audio depth of the voice.

    │ │ │ │

    See also: ALLEGRO_AUDIO_DEPTH.

    │ │ │ │

    al_get_voice_playing

    │ │ │ │ 
    bool al_get_voice_playing(const ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">bool al_get_voice_playing(const ALLEGRO_VOICE *voice) │ │ │ │ +bool al_get_voice_playing(const ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return true if the voice is currently playing.

    │ │ │ │

    See also: al_set_voice_playing

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_voice_playing

    │ │ │ │ 
    bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val)
    │ │ │ │ +class="sourceCode c">bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val) │ │ │ │ +bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Change whether a voice is playing or not. This can only work if the │ │ │ │ voice has a non-streaming object attached to it, e.g. a sample instance. │ │ │ │ On success the voice’s current sample position is reset.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │ @@ -3059,52 +3209,56 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_voice_position

    │ │ │ │ 
    unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice) │ │ │ │ +unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    When the voice has a non-streaming object attached to it, e.g. a │ │ │ │ sample, returns the voice’s current sample position. Otherwise, returns │ │ │ │ zero.

    │ │ │ │

    See also: al_set_voice_position.

    │ │ │ │

    al_set_voice_position

    │ │ │ │ 
    bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val)
    │ │ │ │ +class="sourceCode c">bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val) │ │ │ │ +bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the voice position. This can only work if the voice has a │ │ │ │ non-streaming object attached to it, e.g. a sample instance.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: al_get_voice_position.

    │ │ │ │

    al_voice_has_attachments

    │ │ │ │ 
    bool al_voice_has_attachments(const ALLEGRO_VOICE* voice)
    │ │ │ │ +class="sourceCode c">bool al_voice_has_attachments(const ALLEGRO_VOICE* voice) │ │ │ │ +bool al_voice_has_attachments(const ALLEGRO_VOICE* voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if the voice has something attached to it.

    │ │ │ │

    See also: al_attach_mixer_to_voice, │ │ │ │ al_attach_sample_instance_to_voice, │ │ │ │ al_attach_audio_stream_to_voice

    │ │ │ │

    Since: 5.2.9

    │ │ │ │

    Mixers

    │ │ │ │

    ALLEGRO_MIXER

    │ │ │ │ 
    typedef struct ALLEGRO_MIXER ALLEGRO_MIXER;
    │ │ │ │ +class="sourceCode c">typedef struct ALLEGRO_MIXER ALLEGRO_MIXER; │ │ │ │ +typedef struct ALLEGRO_MIXER ALLEGRO_MIXER; │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A mixer mixes together attached streams into a single buffer. In the │ │ │ │ process, it converts channel configurations, sample frequencies and │ │ │ │ audio depths of the attached sample instances and audio streams │ │ │ │ accordingly. You can control the quality of this conversion using │ │ │ │ @@ -3121,28 +3275,31 @@ │ │ │ │

  • ex_acodec_multi.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    ALLEGRO_MIXER_QUALITY

    │ │ │ │ 
    enum ALLEGRO_MIXER_QUALITY
    │ │ │ │ +class="sourceCode c">enum ALLEGRO_MIXER_QUALITY │ │ │ │ +enum ALLEGRO_MIXER_QUALITY │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │
      │ │ │ │
    • ALLEGRO_MIXER_QUALITY_POINT - point sampling
      • │ │ │ │
    • ALLEGRO_MIXER_QUALITY_LINEAR - linear interpolation
      • │ │ │ │
    • ALLEGRO_MIXER_QUALITY_CUBIC - cubic interpolation (since: 5.0.8, │ │ │ │ 5.1.4)
      • │ │ │ │
    │ │ │ │

    al_create_mixer

    │ │ │ │ 
    ALLEGRO_MIXER *al_create_mixer(unsigned int freq,
│ │ │ │ -   ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
    │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ +ALLEGRO_MIXER *al_create_mixer(unsigned int freq, │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates a mixer to attach sample instances, audio streams, or other │ │ │ │ mixers to. It will mix into a buffer at the requested frequency (in Hz) │ │ │ │ and channel count.

    │ │ │ │

    The only supported audio depths are ALLEGRO_AUDIO_DEPTH_FLOAT32 and │ │ │ │ @@ -3164,15 +3321,16 @@ │ │ │ │

  • ex_acodec_multi.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_destroy_mixer

    │ │ │ │ 
    void al_destroy_mixer(ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">void al_destroy_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ +void al_destroy_mixer(ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Destroys the mixer.

    │ │ │ │

    See also: al_create_mixer

    │ │ │ │

    Examples:

    │ │ │ │ @@ -3182,15 +3340,16 @@ │ │ │ │
  • ex_acodec_multi.c
    • │ │ │ │
  • ex_mixer_chain.c
    • │ │ │ │ │ │ │ │

    al_get_default_mixer

    │ │ │ │ 
    ALLEGRO_MIXER *al_get_default_mixer(void)
    │ │ │ │ +class="sourceCode c">ALLEGRO_MIXER *al_get_default_mixer(void) │ │ │ │ +ALLEGRO_MIXER *al_get_default_mixer(void) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the default mixer, or NULL if one has not been set. Although │ │ │ │ different configurations of mixers and voices can be used, in most cases │ │ │ │ a single mixer attached to a voice is what you want. The default mixer │ │ │ │ is used by al_play_sample.

    │ │ │ │ @@ -3206,15 +3365,16 @@ │ │ │ │
  • ex_audio_props.cpp
    • │ │ │ │
  • ex_resample_test.c
    • │ │ │ │ │ │ │ │

    al_set_default_mixer

    │ │ │ │ 
    bool al_set_default_mixer(ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">bool al_set_default_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ +bool al_set_default_mixer(ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sets the default mixer. All samples started with al_play_sample will be stopped and │ │ │ │ all sample instances returned by al_lock_sample_id will be │ │ │ │ @@ -3225,15 +3385,16 @@ │ │ │ │

    See also: al_reserve_samples, al_play_sample, al_get_default_mixer, al_restore_default_mixer

    │ │ │ │

    al_restore_default_mixer

    │ │ │ │ 
    bool al_restore_default_mixer(void)
    │ │ │ │ +class="sourceCode c">bool al_restore_default_mixer(void) │ │ │ │ +bool al_restore_default_mixer(void) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Restores Allegro’s default mixer and attaches it to the default │ │ │ │ voice. If the default mixer hasn’t been created before, it will be │ │ │ │ created. If the default voice hasn’t been set via al_set_default_voice or │ │ │ │ @@ -3245,37 +3406,40 @@ │ │ │ │

    Returns true on success, false on error.

    │ │ │ │

    See also: al_get_default_mixer, al_set_default_mixer, al_reserve_samples.

    │ │ │ │

    al_get_default_voice

    │ │ │ │ 
    ALLEGRO_VOICE *al_get_default_voice(void)
    │ │ │ │ +class="sourceCode c">ALLEGRO_VOICE *al_get_default_voice(void) │ │ │ │ +ALLEGRO_VOICE *al_get_default_voice(void) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the default voice or NULL if there is none.

    │ │ │ │

    Since: 5.1.13

    │ │ │ │

    See also: al_get_default_mixer

    │ │ │ │

    al_set_default_voice

    │ │ │ │ 
    void al_set_default_voice(ALLEGRO_VOICE *voice)
    │ │ │ │ +class="sourceCode c">void al_set_default_voice(ALLEGRO_VOICE *voice) │ │ │ │ +void al_set_default_voice(ALLEGRO_VOICE *voice) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    You can call this before calling al_restore_default_mixer to provide │ │ │ │ the voice which should be used. Any previous voice will be destroyed. │ │ │ │ You can also pass NULL to destroy the current default voice.

    │ │ │ │

    Since: 5.1.13

    │ │ │ │

    See also: al_get_default_mixer

    │ │ │ │

    al_attach_mixer_to_mixer

    │ │ │ │ 
    bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer) │ │ │ │ +bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Attaches the mixer passed as the first argument onto the mixer passed │ │ │ │ as the second argument. The first mixer (that is going to be attached) │ │ │ │ must not already be attached to anything. Both mixers must use the same │ │ │ │ frequency, audio depth and channel configuration.

    │ │ │ │ @@ -3290,15 +3454,17 @@ │ │ │ │
  • ex_audio_chain.cpp
    • │ │ │ │ │ │ │ │

    al_attach_sample_instance_to_mixer

    │ │ │ │ 
    bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl,
│ │ │ │ -   ALLEGRO_MIXER *mixer)
    │ │ │ │ + ALLEGRO_MIXER *mixer) │ │ │ │ +bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ + ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Attach a sample instance to a mixer. The instance must not already be │ │ │ │ attached to anything.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: ex_mixer_chain.c │ │ │ │

  • ex_acodec.c
    • │ │ │ │ │ │ │ │

    al_attach_audio_stream_to_mixer

    │ │ │ │ 
    bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, ALLEGRO_MIXER *mixer) │ │ │ │ +bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Attach an audio stream to a mixer. The stream must not already be │ │ │ │ attached to anything.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: ex_stream_file.c │ │ │ │

  • ex_resample_test.c
    • │ │ │ │ │ │ │ │

    al_get_mixer_frequency

    │ │ │ │ 
    unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer) │ │ │ │ +unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the mixer frequency (in Hz).

    │ │ │ │

    See also: al_set_mixer_frequency

    │ │ │ │

    al_set_mixer_frequency

    │ │ │ │ 
    bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val)
    │ │ │ │ +class="sourceCode c">bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val) │ │ │ │ +bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the mixer frequency (in Hz). This will only work if the mixer is │ │ │ │ not attached to anything.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: al_get_mixer_frequency

    │ │ │ │

    al_get_mixer_channels

    │ │ │ │ 
    ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer) │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the mixer channel configuration.

    │ │ │ │

    See also: ALLEGRO_CHANNEL_CONF.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_mixer_depth

    │ │ │ │ 
    ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer) │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the mixer audio depth.

    │ │ │ │

    See also: ALLEGRO_AUDIO_DEPTH.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_mixer_gain

    │ │ │ │ 
    float al_get_mixer_gain(const ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">float al_get_mixer_gain(const ALLEGRO_MIXER *mixer) │ │ │ │ +float al_get_mixer_gain(const ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the mixer gain (amplification factor). The default is 1.0.

    │ │ │ │

    Since: 5.0.6, 5.1.0

    │ │ │ │

    See also: al_set_mixer_gain.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_mixer_gain

    │ │ │ │ 
    bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain)
    │ │ │ │ +class="sourceCode c">bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain) │ │ │ │ +bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Set the mixer gain (amplification factor).

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    Since: 5.0.6, 5.1.0

    │ │ │ │

    See also: ex_audio_props.cpp │ │ │ │

  • ex_audio_chain.cpp
    • │ │ │ │ │ │ │ │

    al_get_mixer_quality

    │ │ │ │ 
    ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer) │ │ │ │ +ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the mixer quality.

    │ │ │ │

    See also: ALLEGRO_MIXER_QUALITY, al_set_mixer_quality

    │ │ │ │ @@ -3434,44 +3608,47 @@ │ │ │ │ have anything attached to it.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: ALLEGRO_MIXER_QUALITY, al_get_mixer_quality

    │ │ │ │

    al_get_mixer_playing

    │ │ │ │ 
    bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer) │ │ │ │ +bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return true if the mixer is playing.

    │ │ │ │

    See also: al_set_mixer_playing.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_mixer_playing

    │ │ │ │ 
    bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val)
    │ │ │ │ +class="sourceCode c">bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val) │ │ │ │ +bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Change whether the mixer is playing.

    │ │ │ │

    Returns true on success, false on failure.

    │ │ │ │

    See also: al_get_mixer_playing.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_mixer_attached

    │ │ │ │ 
    bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer) │ │ │ │ +bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return true if the mixer is attached to something.

    │ │ │ │

    See also: al_mixer_has_attachments, │ │ │ │ al_attach_audio_stream_to_mixer, │ │ │ │ al_attach_mixer_to_mixer, │ │ │ │ al_detach_mixer

    │ │ │ │

    al_mixer_has_attachments

    │ │ │ │ 
    bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer)
    │ │ │ │ +class="sourceCode c">bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer) │ │ │ │ +bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if the mixer has something attached to it.

    │ │ │ │

    See also: al_get_mixer_attached, al_attach_sample_instance_to_mixer, │ │ │ │ @@ -3495,15 +3673,16 @@ │ │ │ │ href="audio.html#al_attach_audio_stream_to_mixer">al_attach_audio_stream_to_mixer, │ │ │ │ al_attach_mixer_to_mixer, │ │ │ │ al_detach_mixer

    │ │ │ │

    Since: 5.2.9

    │ │ │ │

    al_detach_mixer

    │ │ │ │ 
    bool al_detach_mixer(ALLEGRO_MIXER *mixer)
    │ │ │ │ +class="sourceCode c">bool al_detach_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ +bool al_detach_mixer(ALLEGRO_MIXER *mixer) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Detach the mixer from whatever it is attached to, if anything.

    │ │ │ │

    See also: al_attach_mixer_to_mixer.

    │ │ │ │

    Examples:

    │ │ │ │ @@ -3512,15 +3691,18 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_chain.cpp#L460">ex_audio_chain.cpp │ │ │ │ │ │ │ │

    al_set_mixer_postprocess_callback

    │ │ │ │ 
    bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer,
│ │ │ │     void (*pp_callback)(void *buf, unsigned int samples, void *data),
│ │ │ │ -   void *pp_callback_userdata)
    │ │ │ │ + void *pp_callback_userdata) │ │ │ │ +bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer, │ │ │ │ + void (*pp_callback)(void *buf, unsigned int samples, void *data), │ │ │ │ + void *pp_callback_userdata) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sets a post-processing filter function that’s called after the │ │ │ │ attached streams have been mixed. The buffer’s format will be whatever │ │ │ │ the mixer was created with. The sample count and user-data pointer is │ │ │ │ also passed.

    │ │ │ │ @@ -3536,15 +3718,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_synth.cpp#L490">ex_synth.cpp │ │ │ │
  • ex_mixer_pp.c
    • │ │ │ │ │ │ │ │

    Miscelaneous

    │ │ │ │

    ALLEGRO_AUDIO_DEPTH

    │ │ │ │ 
    enum ALLEGRO_AUDIO_DEPTH
    │ │ │ │ +class="sourceCode c">enum ALLEGRO_AUDIO_DEPTH │ │ │ │ +enum ALLEGRO_AUDIO_DEPTH │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sample depth and type as well as signedness. Mixers only use 32-bit │ │ │ │ signed float (-1..+1), or 16-bit signed integers. Signedness is │ │ │ │ determined by an “unsigned” bit-flag applied to the depth value.

    │ │ │ │ │ │ │ │

    ALLEGRO_AUDIO_PAN_NONE

    │ │ │ │ 
    #define ALLEGRO_AUDIO_PAN_NONE      (-1000.0f)
    │ │ │ │ +class="sourceCode c">#define ALLEGRO_AUDIO_PAN_NONE (-1000.0f) │ │ │ │ +#define ALLEGRO_AUDIO_PAN_NONE (-1000.0f) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A special value for the pan property of sample instances and audio │ │ │ │ streams. Use this value to disable panning on sample instances and audio │ │ │ │ streams, and play them without attentuation implied by panning │ │ │ │ support.

    │ │ │ │ @@ -3589,15 +3773,16 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    ALLEGRO_CHANNEL_CONF

    │ │ │ │ 
    enum ALLEGRO_CHANNEL_CONF
    │ │ │ │ +class="sourceCode c">enum ALLEGRO_CHANNEL_CONF │ │ │ │ +enum ALLEGRO_CHANNEL_CONF │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Speaker configuration (mono, stereo, 2.1, etc).

    │ │ │ │
      │ │ │ │
    • ALLEGRO_CHANNEL_CONF_1
      • │ │ │ │
    • ALLEGRO_CHANNEL_CONF_2
      • │ │ │ │ @@ -3614,15 +3799,16 @@ │ │ │ │
    • ex_stream_file.c
      • │ │ │ │
    • ex_acodec_multi.c
      • │ │ │ │
    │ │ │ │

    ALLEGRO_PLAYMODE

    │ │ │ │ 
    enum ALLEGRO_PLAYMODE
    │ │ │ │ +class="sourceCode c">enum ALLEGRO_PLAYMODE │ │ │ │ +enum ALLEGRO_PLAYMODE │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sample and stream playback mode.

    │ │ │ │
      │ │ │ │
    • ALLEGRO_PLAYMODE_ONCE - the sample/stream is played from start to │ │ │ │ finish an then it stops.
      • │ │ │ │ @@ -3644,15 +3830,16 @@ │ │ │ │
    • ex_kcm_direct.c
      • │ │ │ │
    • ex_mixer_chain.c
      • │ │ │ │
    │ │ │ │

    ALLEGRO_AUDIO_EVENT_TYPE

    │ │ │ │ 
    enum ALLEGRO_AUDIO_EVENT_TYPE
    │ │ │ │ +class="sourceCode c">enum ALLEGRO_AUDIO_EVENT_TYPE │ │ │ │ +enum ALLEGRO_AUDIO_EVENT_TYPE │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Events sent by al_get_audio_stream_event_source │ │ │ │ or al_get_audio_recorder_event_source.

    │ │ │ │ @@ -3675,52 +3862,57 @@ │ │ │ │

    Since: 5.1.1

    │ │ │ │
    │ │ │ │

    Unstable │ │ │ │ API: The API may need a slight redesign.

    │ │ │ │
    │ │ │ │

    al_get_allegro_audio_version

    │ │ │ │ 
    uint32_t al_get_allegro_audio_version(void)
    │ │ │ │ +class="sourceCode c">uint32_t al_get_allegro_audio_version(void) │ │ │ │ +uint32_t al_get_allegro_audio_version(void) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

    │ │ │ │

    al_get_audio_depth_size

    │ │ │ │ 
    size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth)
    │ │ │ │ +class="sourceCode c">size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth) │ │ │ │ +size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the size of a sample, in bytes, for the given format. The │ │ │ │ format is one of the values listed under ALLEGRO_AUDIO_DEPTH.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_channel_count

    │ │ │ │ 
    size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf)
    │ │ │ │ +class="sourceCode c">size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf) │ │ │ │ +size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return the number of channels for the given channel configuration, │ │ │ │ which is one of the values listed under ALLEGRO_CHANNEL_CONF.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_fill_silence

    │ │ │ │ 
    void al_fill_silence(void *buf, unsigned int samples,
│ │ │ │ -   ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf)
    │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ +void al_fill_silence(void *buf, unsigned int samples, │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Fill a buffer with silence, for the given format and channel │ │ │ │ configuration. The buffer must have enough space for the given number of │ │ │ │ samples, and be properly aligned.

    │ │ │ │

    Since: 5.1.8

    │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -228,49 +228,54 @@ │ │ │ │ │ samples, you can use the _A_L_L_E_G_R_O___S_A_M_P_L_E___I_D that al_play_sample returns. │ │ │ │ │ If you want to play large audio files (e.g. background music) without loading │ │ │ │ │ the whole file at once you can use _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m (after calling │ │ │ │ │ _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s). This will load and play an ALLEGRO_AUDIO_STREAM. Note that │ │ │ │ │ the basic API only supports one such audio stream playing at once. │ │ │ │ │ ********** AALLLLEEGGRROO__SSAAMMPPLLEE__IIDD ********** │ │ │ │ │ typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID; │ │ │ │ │ +typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An ALLEGRO_SAMPLE_ID represents a sample being played via _a_l___p_l_a_y___s_a_m_p_l_e. It │ │ │ │ │ can be used to later stop the sample with _a_l___s_t_o_p___s_a_m_p_l_e. The underlying │ │ │ │ │ ALLEGRO_SAMPLE_INSTANCE can be extracted using _a_l___l_o_c_k___s_a_m_p_l_e___i_d. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ ********** aall__iinnssttaallll__aauuddiioo ********** │ │ │ │ │ bool al_install_audio(void) │ │ │ │ │ +bool al_install_audio(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Install the audio subsystem. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ Note: most users will call _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s and │ │ │ │ │ _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n after this. │ │ │ │ │ See also: _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s, _a_l___u_n_i_n_s_t_a_l_l___a_u_d_i_o, _a_l___i_s___a_u_d_i_o___i_n_s_t_a_l_l_e_d, │ │ │ │ │ _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___d_e_v_i_c_e_s_._c │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ ********** aall__uunniinnssttaallll__aauuddiioo ********** │ │ │ │ │ void al_uninstall_audio(void) │ │ │ │ │ +void al_uninstall_audio(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Uninstalls the audio subsystem. │ │ │ │ │ See also: _a_l___i_n_s_t_a_l_l___a_u_d_i_o │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ ********** aall__iiss__aauuddiioo__iinnssttaalllleedd ********** │ │ │ │ │ bool al_is_audio_installed(void) │ │ │ │ │ +bool al_is_audio_installed(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if _a_l___i_n_s_t_a_l_l___a_u_d_i_o was called previously and returned │ │ │ │ │ successfully. │ │ │ │ │ ********** aall__rreesseerrvvee__ssaammpplleess ********** │ │ │ │ │ bool al_reserve_samples(int reserve_samples) │ │ │ │ │ +bool al_reserve_samples(int reserve_samples) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Reserves a number of sample instances, attaching them to the default mixer. If │ │ │ │ │ no default mixer is set when this function is called, then it will create one │ │ │ │ │ and attach it to the default voice. If no default voice has been set, it, too, │ │ │ │ │ will be created. │ │ │ │ │ If you call this function a second time with a smaller number of samples, then │ │ │ │ │ the excess internal sample instances will be destroyed causing some sounds to │ │ │ │ │ @@ -287,14 +292,16 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ ********** aall__ppllaayy__ssaammppllee ********** │ │ │ │ │ bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed, │ │ │ │ │ ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id) │ │ │ │ │ +bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed, │ │ │ │ │ + ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Plays a sample on one of the sample instances created by _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s. │ │ │ │ │ Returns true on success, false on failure. Playback may fail because all the │ │ │ │ │ reserved sample instances are currently used. │ │ │ │ │ Parameters: │ │ │ │ │ * gain - relative volume at which the sample is played; 1.0 is normal. │ │ │ │ │ * pan - 0.0 is centred, -1.0 is left, 1.0 is right, or │ │ │ │ │ @@ -310,30 +317,33 @@ │ │ │ │ │ _A_L_L_E_G_R_O___S_A_M_P_L_E___I_D, _a_l___s_t_o_p___s_a_m_p_l_e, _a_l___s_t_o_p___s_a_m_p_l_e_s, _a_l___l_o_c_k___s_a_m_p_l_e___i_d. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ssttoopp__ssaammppllee ********** │ │ │ │ │ void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ +void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Stop the sample started by _a_l___p_l_a_y___s_a_m_p_l_e. │ │ │ │ │ See also: _a_l___s_t_o_p___s_a_m_p_l_e_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ssttoopp__ssaammpplleess ********** │ │ │ │ │ void al_stop_samples(void) │ │ │ │ │ +void al_stop_samples(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Stop all samples started by _a_l___p_l_a_y___s_a_m_p_l_e. │ │ │ │ │ See also: _a_l___s_t_o_p___s_a_m_p_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ ********** aall__lloocckk__ssaammppllee__iidd ********** │ │ │ │ │ ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ +ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Locks a _A_L_L_E_G_R_O___S_A_M_P_L_E___I_D, returning the underlying _A_L_L_E_G_R_O___S_A_M_P_L_E___I_N_S_T_A_N_C_E. │ │ │ │ │ This allows you to adjust the various properties of the instance (such as │ │ │ │ │ volume, pan, etc) while the sound is playing. │ │ │ │ │ This function will return NULL if the sound corresponding to the id is no │ │ │ │ │ longer playing. │ │ │ │ │ While locked, ALLEGRO_SAMPLE_ID will be unavailable to additional calls to │ │ │ │ │ @@ -343,26 +353,28 @@ │ │ │ │ │ See also: _a_l___p_l_a_y___s_a_m_p_l_e, _a_l___u_n_l_o_c_k___s_a_m_p_l_e___i_d │ │ │ │ │ Since: 5.2.3 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: New API. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ ********** aall__uunnlloocckk__ssaammppllee__iidd ********** │ │ │ │ │ void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ +void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Unlocks a _A_L_L_E_G_R_O___S_A_M_P_L_E___I_D, allowing future calls to _a_l___p_l_a_y___s_a_m_p_l_e to reuse │ │ │ │ │ it if possible. Note that after the id is unlocked, the _A_L_L_E_G_R_O___S_A_M_P_L_E___I_N_S_T_A_N_C_E │ │ │ │ │ that was previously returned by _a_l___l_o_c_k___s_a_m_p_l_e___i_d will possibly be playing a │ │ │ │ │ different sound, so you should only use it after locking the id again. │ │ │ │ │ See also: _a_l___p_l_a_y___s_a_m_p_l_e, _a_l___l_o_c_k___s_a_m_p_l_e___i_d │ │ │ │ │ Since: 5.2.3 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: New API. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ ********** aall__ppllaayy__aauuddiioo__ssttrreeaamm ********** │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Loads and plays an audio file, streaming from disk as it is needed. This API │ │ │ │ │ can only play one audio stream at a time. This requires a default mixer to be │ │ │ │ │ set, which is typically done via _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s, but can also be done via │ │ │ │ │ _a_l___s_e_t___d_e_f_a_u_l_t___m_i_x_e_r. │ │ │ │ │ Returns the stream on success, NULL on failure. You must not destroy the │ │ │ │ │ returned stream, it will be automatically destroyed when the addon is shut │ │ │ │ │ @@ -374,14 +386,16 @@ │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: New API. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ ********** aall__ppllaayy__aauuddiioo__ssttrreeaamm__ff ********** │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char │ │ │ │ │ *ident) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char │ │ │ │ │ +*ident) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Loads and plays an audio file from _A_L_L_E_G_R_O___F_I_L_E stream, streaming it is needed. │ │ │ │ │ This API can only play one audio stream at a time. This requires a default │ │ │ │ │ mixer to be set, which is typically done via _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s, but can also │ │ │ │ │ be done via _a_l___s_e_t___d_e_f_a_u_l_t___m_i_x_e_r. │ │ │ │ │ The file type is determined by the passed ‘ident’ parameter, which is a file │ │ │ │ │ name extension including the leading dot. │ │ │ │ │ @@ -395,28 +409,32 @@ │ │ │ │ │ register your own format handler. │ │ │ │ │ See also: _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m, _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m___f │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: New API. │ │ │ │ │ ************ SSaammpplleess ************ │ │ │ │ │ ********** AALLLLEEGGRROO__SSAAMMPPLLEE ********** │ │ │ │ │ typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE; │ │ │ │ │ +typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An ALLEGRO_SAMPLE object stores the data necessary for playing pre-defined │ │ │ │ │ digital audio. It holds a user-specified PCM data buffer and information about │ │ │ │ │ its format (data length, depth, frequency, channel configuration). You can have │ │ │ │ │ the same ALLEGRO_SAMPLE playing multiple times simultaneously. │ │ │ │ │ See also: _A_L_L_E_G_R_O___S_A_M_P_L_E___I_N_S_T_A_N_C_E │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___g_l_e_x_t_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ ********** aall__ccrreeaattee__ssaammppllee ********** │ │ │ │ │ ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples, │ │ │ │ │ unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ │ ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf) │ │ │ │ │ +ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples, │ │ │ │ │ + unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ │ + ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Create a sample data structure from the supplied buffer. If free_buf is true │ │ │ │ │ then the buffer will be freed with _a_l___f_r_e_e when the sample data structure is │ │ │ │ │ destroyed. For portability (especially Windows), the buffer should have been │ │ │ │ │ allocated with _a_l___m_a_l_l_o_c. Otherwise you should free the sample data yourself. │ │ │ │ │ A sample that is referred to by the samples parameter refers to a sequence │ │ │ │ │ channel intensities. E.g. if you’re making a stereo sample with the samples set │ │ │ │ │ @@ -432,14 +450,15 @@ │ │ │ │ │ See also: _a_l___d_e_s_t_r_o_y___s_a_m_p_l_e, _A_L_L_E_G_R_O___A_U_D_I_O___D_E_P_T_H, _A_L_L_E_G_R_O___C_H_A_N_N_E_L___C_O_N_F │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__llooaadd__ssaammppllee ********** │ │ │ │ │ ALLEGRO_SAMPLE *al_load_sample(const char *filename) │ │ │ │ │ +ALLEGRO_SAMPLE *al_load_sample(const char *filename) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Loads a few different audio file formats based on their extension. │ │ │ │ │ Note that this stores the entire file in memory at once, which may be time │ │ │ │ │ consuming. To read the file as it is needed, use _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m or │ │ │ │ │ _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m. │ │ │ │ │ Returns the sample on success, NULL on failure. │ │ │ │ │ NNoottee:: the allegro_audio library does not support any audio file │ │ │ │ │ @@ -448,14 +467,15 @@ │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___l_o_a_d_e_r, _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__llooaadd__ssaammppllee__ff ********** │ │ │ │ │ ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident) │ │ │ │ │ +ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Loads an audio file from an _A_L_L_E_G_R_O___F_I_L_E stream into an _A_L_L_E_G_R_O___S_A_M_P_L_E. The │ │ │ │ │ file type is determined by the passed ‘ident’ parameter, which is a file name │ │ │ │ │ extension including the leading dot. │ │ │ │ │ Note that this stores the entire file in memory at once, which may be time │ │ │ │ │ consuming. To read the file as it is needed, use _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m___f or │ │ │ │ │ _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m___f. │ │ │ │ │ @@ -463,70 +483,78 @@ │ │ │ │ │ afterwards. │ │ │ │ │ NNoottee:: the allegro_audio library does not support any audio file │ │ │ │ │ formats by default. You must use the allegro_acodec addon, or │ │ │ │ │ register your own format handler. │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___l_o_a_d_e_r___f, _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n │ │ │ │ │ ********** aall__ssaavvee__ssaammppllee ********** │ │ │ │ │ bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl) │ │ │ │ │ +bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Writes a sample into a file. Currently, wav is the only supported format, and │ │ │ │ │ the extension must be “.wav”. │ │ │ │ │ Returns true on success, false on error. │ │ │ │ │ NNoottee:: the allegro_audio library does not support any audio file │ │ │ │ │ formats by default. You must use the allegro_acodec addon, or │ │ │ │ │ register your own format handler. │ │ │ │ │ See also: _a_l___s_a_v_e___s_a_m_p_l_e___f, _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___s_a_v_e_r, _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n │ │ │ │ │ ********** aall__ssaavvee__ssaammppllee__ff ********** │ │ │ │ │ bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl) │ │ │ │ │ +bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Writes a sample into a _A_L_L_E_G_R_O___F_I_L_E filestream. Currently, wav is the only │ │ │ │ │ supported format, and the extension must be “.wav”. │ │ │ │ │ Returns true on success, false on error. The file remains open afterwards. │ │ │ │ │ NNoottee:: the allegro_audio library does not support any audio file │ │ │ │ │ formats by default. You must use the allegro_acodec addon, or │ │ │ │ │ register your own format handler. │ │ │ │ │ See also: _a_l___s_a_v_e___s_a_m_p_l_e, _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___s_a_v_e_r___f, _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n │ │ │ │ │ ********** aall__ddeessttrrooyy__ssaammppllee ********** │ │ │ │ │ void al_destroy_sample(ALLEGRO_SAMPLE *spl) │ │ │ │ │ +void al_destroy_sample(ALLEGRO_SAMPLE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Free the sample data structure. If it was created with the free_buf parameter │ │ │ │ │ set to true, then the buffer will be freed with _a_l___f_r_e_e. │ │ │ │ │ This function will stop any sample instances which may be playing the buffer │ │ │ │ │ referenced by the _A_L_L_E_G_R_O___S_A_M_P_L_E. │ │ │ │ │ See also: _a_l___d_e_s_t_r_o_y___s_a_m_p_l_e___i_n_s_t_a_n_c_e, _a_l___s_t_o_p___s_a_m_p_l_e, _a_l___s_t_o_p___s_a_m_p_l_e_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__cchhaannnneellss ********** │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the channel configuration of the sample. │ │ │ │ │ See also: _A_L_L_E_G_R_O___C_H_A_N_N_E_L___C_O_N_F, _a_l___g_e_t___s_a_m_p_l_e___d_e_p_t_h, _a_l___g_e_t___s_a_m_p_l_e___f_r_e_q_u_e_n_c_y, │ │ │ │ │ _a_l___g_e_t___s_a_m_p_l_e___l_e_n_g_t_h, _a_l___g_e_t___s_a_m_p_l_e___d_a_t_a │ │ │ │ │ ********** aall__ggeett__ssaammppllee__ddeepptthh ********** │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the audio depth of the sample. │ │ │ │ │ See also: _A_L_L_E_G_R_O___A_U_D_I_O___D_E_P_T_H, _a_l___g_e_t___s_a_m_p_l_e___c_h_a_n_n_e_l_s, _a_l___g_e_t___s_a_m_p_l_e___f_r_e_q_u_e_n_c_y, │ │ │ │ │ _a_l___g_e_t___s_a_m_p_l_e___l_e_n_g_t_h, _a_l___g_e_t___s_a_m_p_l_e___d_a_t_a │ │ │ │ │ ********** aall__ggeett__ssaammppllee__ffrreeqquueennccyy ********** │ │ │ │ │ unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the frequency (in Hz) of the sample. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___c_h_a_n_n_e_l_s, _a_l___g_e_t___s_a_m_p_l_e___d_e_p_t_h, _a_l___g_e_t___s_a_m_p_l_e___l_e_n_g_t_h, │ │ │ │ │ _a_l___g_e_t___s_a_m_p_l_e___d_a_t_a │ │ │ │ │ ********** aall__ggeett__ssaammppllee__lleennggtthh ********** │ │ │ │ │ unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the length of the sample in sample values. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___c_h_a_n_n_e_l_s, _a_l___g_e_t___s_a_m_p_l_e___d_e_p_t_h, _a_l___g_e_t___s_a_m_p_l_e___f_r_e_q_u_e_n_c_y, │ │ │ │ │ _a_l___g_e_t___s_a_m_p_l_e___d_a_t_a │ │ │ │ │ ********** aall__ggeett__ssaammppllee__ddaattaa ********** │ │ │ │ │ void *al_get_sample_data(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +void *al_get_sample_data(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return a pointer to the raw sample data. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___c_h_a_n_n_e_l_s, _a_l___g_e_t___s_a_m_p_l_e___d_e_p_t_h, _a_l___g_e_t___s_a_m_p_l_e___f_r_e_q_u_e_n_c_y, │ │ │ │ │ _a_l___g_e_t___s_a_m_p_l_e___l_e_n_g_t_h │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___t_i_m_e_r_._c │ │ │ │ │ ************ AAddvvaanncceedd AAuuddiioo ************ │ │ │ │ │ @@ -600,14 +628,15 @@ │ │ │ │ │ al_play_sample is called, it’ll use one of these internal sample instances that │ │ │ │ │ is not currently playing to play the requested sample. All of these sample │ │ │ │ │ instances will be attached to the default mixer, which can be changed via │ │ │ │ │ _a_l___s_e_t___d_e_f_a_u_l_t___m_i_x_e_r. │ │ │ │ │ ************ SSaammppllee iinnssttaanncceess ************ │ │ │ │ │ ********** AALLLLEEGGRROO__SSAAMMPPLLEE__IINNSSTTAANNCCEE ********** │ │ │ │ │ typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE; │ │ │ │ │ +typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An ALLEGRO_SAMPLE_INSTANCE object represents a playable instance of a │ │ │ │ │ predefined sound effect. It holds information about how the effect should be │ │ │ │ │ played: These playback parameters consist of the looping mode, loop start/end │ │ │ │ │ points, playing position, speed, gain, pan and the playmode. Whether a sample │ │ │ │ │ instance is currently playing or paused is also one of its properties. │ │ │ │ │ An instance uses the data from an _A_L_L_E_G_R_O___S_A_M_P_L_E object. Multiple instances may │ │ │ │ │ @@ -618,155 +647,178 @@ │ │ │ │ │ See also: _A_L_L_E_G_R_O___S_A_M_P_L_E │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ccrreeaattee__ssaammppllee__iinnssttaannccee ********** │ │ │ │ │ ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data) │ │ │ │ │ +ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a sample instance, using the supplied sample data. The instance must be │ │ │ │ │ attached to a mixer (or voice) in order to actually produce output. │ │ │ │ │ The argument may be NULL. You can then set the sample data later with │ │ │ │ │ _a_l___s_e_t___s_a_m_p_l_e. │ │ │ │ │ See also: _a_l___d_e_s_t_r_o_y___s_a_m_p_l_e___i_n_s_t_a_n_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__ssaammppllee__iinnssttaannccee ********** │ │ │ │ │ void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Detaches the sample instance from anything it may be attached to and frees it │ │ │ │ │ (the sample data, i.e. its ALLEGRO_SAMPLE, is nnoott freed!). │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___s_a_m_p_l_e___i_n_s_t_a_n_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ppllaayy__ssaammppllee__iinnssttaannccee ********** │ │ │ │ │ bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Play the sample instance. Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___s_t_o_p___s_a_m_p_l_e___i_n_s_t_a_n_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ssttoopp__ssaammppllee__iinnssttaannccee ********** │ │ │ │ │ bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Stop an sample instance playing. │ │ │ │ │ See also: _a_l___p_l_a_y___s_a_m_p_l_e___i_n_s_t_a_n_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__cchhaannnneellss ********** │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels( │ │ │ │ │ const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels( │ │ │ │ │ + const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the channel configuration of the sample instance’s sample data. │ │ │ │ │ See also: _A_L_L_E_G_R_O___C_H_A_N_N_E_L___C_O_N_F. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ddeepptthh ********** │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE │ │ │ │ │ *spl) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE │ │ │ │ │ +*spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the audio depth of the sample instance’s sample data. │ │ │ │ │ See also: _A_L_L_E_G_R_O___A_U_D_I_O___D_E_P_T_H. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ffrreeqquueennccyy ********** │ │ │ │ │ unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE │ │ │ │ │ *spl) │ │ │ │ │ +unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE │ │ │ │ │ +*spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the frequency (in Hz) of the sample instance’s sample data. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__lleennggtthh ********** │ │ │ │ │ unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the length of the sample instance in sample values. This property may │ │ │ │ │ differ from the length of the instance’s sample data. │ │ │ │ │ See also: _a_l___s_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___l_e_n_g_t_h, _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_i_m_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ ********** aall__sseett__ssaammppllee__iinnssttaannccee__lleennggtthh ********** │ │ │ │ │ bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ unsigned int val) │ │ │ │ │ +bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + unsigned int val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the length of the sample instance in sample values. This can be used to │ │ │ │ │ play only parts of the underlying sample. Be careful not to exceed the actual │ │ │ │ │ length of the sample data, though. │ │ │ │ │ Return true on success, false on failure. Will fail if the sample instance is │ │ │ │ │ currently playing. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___l_e_n_g_t_h │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ppoossiittiioonn ********** │ │ │ │ │ unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE │ │ │ │ │ *spl) │ │ │ │ │ +unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE │ │ │ │ │ +*spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get the playback position of a sample instance. │ │ │ │ │ See also: _a_l___s_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___p_o_s_i_t_i_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__ssaammppllee__iinnssttaannccee__ppoossiittiioonn ********** │ │ │ │ │ bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ unsigned int val) │ │ │ │ │ +bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + unsigned int val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the playback position of a sample instance. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___p_o_s_i_t_i_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ssppeeeedd ********** │ │ │ │ │ float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the relative playback speed of the sample instance. │ │ │ │ │ See also: _a_l___s_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___s_p_e_e_d │ │ │ │ │ ********** aall__sseett__ssaammppllee__iinnssttaannccee__ssppeeeedd ********** │ │ │ │ │ bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ +bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the relative playback speed of the sample instance. 1.0 means normal speed. │ │ │ │ │ Return true on success, false on failure. Will fail if the sample instance is │ │ │ │ │ attached directly to a voice. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___s_p_e_e_d │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ggaaiinn ********** │ │ │ │ │ float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the playback gain of the sample instance. │ │ │ │ │ See also: _a_l___s_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___g_a_i_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__ssaammppllee__iinnssttaannccee__ggaaiinn ********** │ │ │ │ │ bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ +bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the playback gain of the sample instance. │ │ │ │ │ Returns true on success, false on failure. Will fail if the sample instance is │ │ │ │ │ attached directly to a voice. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___g_a_i_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c_._c │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ppaann ********** │ │ │ │ │ float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get the pan value of the sample instance. │ │ │ │ │ See also: _a_l___s_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___p_a_n. │ │ │ │ │ ********** aall__sseett__ssaammppllee__iinnssttaannccee__ppaann ********** │ │ │ │ │ bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ +bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the pan value on a sample instance. A value of -1.0 means to play the │ │ │ │ │ sample only through the left speaker; +1.0 means only through the right │ │ │ │ │ speaker; 0.0 means the sample is centre balanced. A special value │ │ │ │ │ _A_L_L_E_G_R_O___A_U_D_I_O___P_A_N___N_O_N_E disables panning and plays the sample at its original │ │ │ │ │ level. This will be louder than a pan value of 0.0. │ │ │ │ │ Note: panning samples with more than two channels doesn’t work yet. │ │ │ │ │ @@ -774,88 +826,99 @@ │ │ │ │ │ attached directly to a voice. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___p_a_n, _A_L_L_E_G_R_O___A_U_D_I_O___P_A_N___N_O_N_E │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ttiimmee ********** │ │ │ │ │ float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the length of the sample instance in seconds, assuming a playback speed │ │ │ │ │ of 1.0. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___l_e_n_g_t_h │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ppllaayymmooddee ********** │ │ │ │ │ ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE │ │ │ │ │ *spl) │ │ │ │ │ +ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE │ │ │ │ │ +*spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the playback mode of the sample instance. │ │ │ │ │ See also: _A_L_L_E_G_R_O___P_L_A_Y_M_O_D_E, _a_l___s_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___p_l_a_y_m_o_d_e │ │ │ │ │ ********** aall__sseett__ssaammppllee__iinnssttaannccee__ppllaayymmooddee ********** │ │ │ │ │ bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ ALLEGRO_PLAYMODE val) │ │ │ │ │ +bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + ALLEGRO_PLAYMODE val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the playback mode of the sample instance. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _A_L_L_E_G_R_O___P_L_A_Y_M_O_D_E, _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___p_l_a_y_m_o_d_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c_._c │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__ppllaayyiinngg ********** │ │ │ │ │ bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ -_S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ +bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +_S_o_u_r_c_e_ _C_o_d_e)) │ │ │ │ │ Return true if the sample instance is in the playing state. This may be true │ │ │ │ │ even if the instance is not attached to anything. │ │ │ │ │ See also: _a_l___s_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___p_l_a_y_i_n_g │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__ssaammppllee__iinnssttaannccee__ppllaayyiinngg ********** │ │ │ │ │ bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val) │ │ │ │ │ +bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Change whether the sample instance is playing. │ │ │ │ │ The instance does not need to be attached to anything (since: 5.1.8). │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___p_l_a_y_i_n_g │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__ssaammppllee__iinnssttaannccee__aattttaacchheedd ********** │ │ │ │ │ bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return whether the sample instance is attached to something. │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___m_i_x_e_r, │ │ │ │ │ _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___v_o_i_c_e, _a_l___d_e_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e │ │ │ │ │ ********** aall__ddeettaacchh__ssaammppllee__iinnssttaannccee ********** │ │ │ │ │ bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Detach the sample instance from whatever it’s attached to, if anything. │ │ │ │ │ Returns true on success. │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___m_i_x_e_r, │ │ │ │ │ _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___v_o_i_c_e, _a_l___g_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___a_t_t_a_c_h_e_d │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__ssaammppllee ********** │ │ │ │ │ ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the sample data that the sample instance plays. │ │ │ │ │ Note this returns a pointer to an internal structure, nnoott the _A_L_L_E_G_R_O___S_A_M_P_L_E │ │ │ │ │ that you may have passed to _a_l___s_e_t___s_a_m_p_l_e. However, the sample buffer of the │ │ │ │ │ returned ALLEGRO_SAMPLE will be the same as the one that was used to create the │ │ │ │ │ sample (passed to _a_l___c_r_e_a_t_e___s_a_m_p_l_e). You can use _a_l___g_e_t___s_a_m_p_l_e___d_a_t_a on the │ │ │ │ │ return value to retrieve and compare it. │ │ │ │ │ See also: _a_l___s_e_t___s_a_m_p_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__sseett__ssaammppllee ********** │ │ │ │ │ bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data) │ │ │ │ │ +bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Change the sample data that a sample instance plays. This can be quite an │ │ │ │ │ involved process. │ │ │ │ │ First, the sample is stopped if it is not already. │ │ │ │ │ Next, if data is NULL, the sample is detached from its parent (if any). │ │ │ │ │ If data is not NULL, the sample may be detached and reattached to its parent │ │ │ │ │ (if any). This is not necessary if the old sample data and new sample data have │ │ │ │ │ @@ -869,14 +932,16 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c_._c │ │ │ │ │ ********** aall__sseett__ssaammppllee__iinnssttaannccee__cchhaannnneell__mmaattrriixx ********** │ │ │ │ │ bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const │ │ │ │ │ float *matrix) │ │ │ │ │ +bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const │ │ │ │ │ +float *matrix) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the matrix used to mix the channels coming from this instance into the │ │ │ │ │ mixer it is attached to. Normally Allegro derives the values of this matrix │ │ │ │ │ from the gain and pan settings, as well as the channel configurations of this │ │ │ │ │ instance and the mixer it is attached to, but this allows you override that │ │ │ │ │ default value. Note that if you do set gain or pan of this instance or the │ │ │ │ │ mixer it is attached to, you’ll need to call this function again. │ │ │ │ │ @@ -898,14 +963,15 @@ │ │ │ │ │ Since: 5.2.3 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: New API. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c_._c │ │ │ │ │ ************ AAuuddiioo ssttrreeaammss ************ │ │ │ │ │ ********** AALLLLEEGGRROO__AAUUDDIIOO__SSTTRREEAAMM ********** │ │ │ │ │ typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM; │ │ │ │ │ +typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An ALLEGRO_AUDIO_STREAM object is used to stream generated audio to the sound │ │ │ │ │ device, in real-time. This is done by reading from a buffer, which is split │ │ │ │ │ into a number of fragments. Whenever a fragment has finished playing, the user │ │ │ │ │ can refill it with new data. │ │ │ │ │ As with _A_L_L_E_G_R_O___S_A_M_P_L_E___I_N_S_T_A_N_C_E objects, streams store information necessary │ │ │ │ │ for playback, so you may not play the same stream multiple times │ │ │ │ │ @@ -941,14 +1007,17 @@ │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ ********** aall__ccrreeaattee__aauuddiioo__ssttrreeaamm ********** │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count, │ │ │ │ │ unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ │ ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count, │ │ │ │ │ + unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ │ + ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates an _A_L_L_E_G_R_O___A_U_D_I_O___S_T_R_E_A_M. The stream will be set to play by default. It │ │ │ │ │ will feed audio data from a buffer, which is split into a number of fragments. │ │ │ │ │ Parameters: │ │ │ │ │ * fragment_count - How many fragments to use for the audio stream. Usually │ │ │ │ │ only two fragments are required - splitting the audio buffer in two │ │ │ │ │ halves. But it means that the only time when new data can be supplied is │ │ │ │ │ @@ -984,14 +1053,16 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ ********** aall__llooaadd__aauuddiioo__ssttrreeaamm ********** │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename, │ │ │ │ │ size_t buffer_count, unsigned int samples) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename, │ │ │ │ │ + size_t buffer_count, unsigned int samples) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Loads an audio file from disk as it is needed. │ │ │ │ │ Unlike regular streams, the one returned by this function need not be fed by │ │ │ │ │ the user; the library will automatically read more of the file as it is needed. │ │ │ │ │ The stream will contain bbuuffffeerr__ccoouunntt buffers with ssaammpplleess samples. │ │ │ │ │ The audio stream will start in the playing state. It should be attached to a │ │ │ │ │ voice or mixer to generate any output. See _A_L_L_E_G_R_O___A_U_D_I_O___S_T_R_E_A_M for more │ │ │ │ │ @@ -1006,14 +1077,17 @@ │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___m_i_x_e_r___p_p_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__llooaadd__aauuddiioo__ssttrreeaamm__ff ********** │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char │ │ │ │ │ *ident, │ │ │ │ │ size_t buffer_count, unsigned int samples) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char │ │ │ │ │ +*ident, │ │ │ │ │ + size_t buffer_count, unsigned int samples) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Loads an audio file from _A_L_L_E_G_R_O___F_I_L_E stream as it is needed. │ │ │ │ │ Unlike regular streams, the one returned by this function need not be fed by │ │ │ │ │ the user; the library will automatically read more of the file as it is needed. │ │ │ │ │ The stream will contain bbuuffffeerr__ccoouunntt buffers with ssaammpplleess samples. │ │ │ │ │ The file type is determined by the passed ‘ident’ parameter, which is a file │ │ │ │ │ name extension including the leading dot. │ │ │ │ │ @@ -1026,182 +1100,210 @@ │ │ │ │ │ NNoottee:: the allegro_audio library does not support any audio file │ │ │ │ │ formats by default. You must use the allegro_acodec addon, or │ │ │ │ │ register your own format handler. │ │ │ │ │ See also: _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m, _a_l___r_e_g_i_s_t_e_r___a_u_d_i_o___s_t_r_e_a_m___l_o_a_d_e_r___f, │ │ │ │ │ _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n │ │ │ │ │ ********** aall__ddeessttrrooyy__aauuddiioo__ssttrreeaamm ********** │ │ │ │ │ void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Destroy an audio stream which was created with _a_l___c_r_e_a_t_e___a_u_d_i_o___s_t_r_e_a_m or │ │ │ │ │ _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m. │ │ │ │ │ NNoottee:: If the stream is still attached to a mixer or voice, │ │ │ │ │ _a_l___d_e_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m is automatically called on it first. │ │ │ │ │ See also: _a_l___d_r_a_i_n___a_u_d_i_o___s_t_r_e_a_m. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__eevveenntt__ssoouurrccee ********** │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source( │ │ │ │ │ ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source( │ │ │ │ │ + ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Retrieve the associated event source. │ │ │ │ │ See _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___f_r_a_g_m_e_n_t for a description of the │ │ │ │ │ _A_L_L_E_G_R_O___E_V_E_N_T___A_U_D_I_O___S_T_R_E_A_M___F_R_A_G_M_E_N_T event that audio streams emit. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ ********** aall__ddrraaiinn__aauuddiioo__ssttrreeaamm ********** │ │ │ │ │ void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ You should call this to finalise an audio stream that you will no longer be │ │ │ │ │ feeding, to wait for all pending buffers to finish playing. The stream’s │ │ │ │ │ playing state will change to false. │ │ │ │ │ See also: _a_l___d_e_s_t_r_o_y___a_u_d_i_o___s_t_r_e_a_m │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ ********** aall__rreewwiinndd__aauuddiioo__ssttrreeaamm ********** │ │ │ │ │ bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the streaming file playing position to the beginning. Returns true on │ │ │ │ │ success. Currently this can only be called on streams created with │ │ │ │ │ _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m, _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m, _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m___f or │ │ │ │ │ _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m___f. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ffrreeqquueennccyy ********** │ │ │ │ │ unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the stream frequency (in Hz). │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__cchhaannnneellss ********** │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels( │ │ │ │ │ const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels( │ │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the stream channel configuration. │ │ │ │ │ See also: _A_L_L_E_G_R_O___C_H_A_N_N_E_L___C_O_N_F. │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ddeepptthh ********** │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth( │ │ │ │ │ const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth( │ │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the stream audio depth. │ │ │ │ │ See also: _A_L_L_E_G_R_O___A_U_D_I_O___D_E_P_T_H. │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__lleennggtthh ********** │ │ │ │ │ unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the stream length in samples. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ssppeeeedd ********** │ │ │ │ │ float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the relative playback speed of the stream. │ │ │ │ │ See also: _a_l___s_e_t___a_u_d_i_o___s_t_r_e_a_m___s_p_e_e_d. │ │ │ │ │ ********** aall__sseett__aauuddiioo__ssttrreeaamm__ssppeeeedd ********** │ │ │ │ │ bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ +bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the relative playback speed of the stream. 1.0 means normal speed. │ │ │ │ │ Return true on success, false on failure. Will fail if the audio stream is │ │ │ │ │ attached directly to a voice. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___s_p_e_e_d. │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ggaaiinn ********** │ │ │ │ │ float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the playback gain of the stream. │ │ │ │ │ See also: _a_l___s_e_t___a_u_d_i_o___s_t_r_e_a_m___g_a_i_n. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__aauuddiioo__ssttrreeaamm__ggaaiinn ********** │ │ │ │ │ bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ +bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the playback gain of the stream. │ │ │ │ │ Returns true on success, false on failure. Will fail if the audio stream is │ │ │ │ │ attached directly to a voice. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___g_a_i_n. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ppaann ********** │ │ │ │ │ +float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *streamR *mixer, │ │ │ │ │ +ALLEGRO_MIXER_QUALITY new_quality) │ │ │ │ │ float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get the pan value of the stream. │ │ │ │ │ See also: _a_l___s_e_t___a_u_d_i_o___s_t_r_e_a_m___p_a_n. │ │ │ │ │ ********** aall__sseett__aauuddiioo__ssttrreeaamm__ppaann ********** │ │ │ │ │ bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ +bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the pan value on an audio stream. A value of -1.0 means to play the stream │ │ │ │ │ only through the left speaker; +1.0 means only through the right speaker; 0.0 │ │ │ │ │ means the sample is centre balanced. A special value _A_L_L_E_G_R_O___A_U_D_I_O___P_A_N___N_O_N_E │ │ │ │ │ disables panning and plays the stream at its original level. This will be │ │ │ │ │ louder than a pan value of 0.0. │ │ │ │ │ Returns true on success, false on failure. Will fail if the audio stream is │ │ │ │ │ attached directly to a voice. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___p_a_n, _A_L_L_E_G_R_O___A_U_D_I_O___P_A_N___N_O_N_E │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ppllaayyiinngg ********** │ │ │ │ │ bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return true if the stream is playing. │ │ │ │ │ See also: _a_l___s_e_t___a_u_d_i_o___s_t_r_e_a_m___p_l_a_y_i_n_g. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__aauuddiioo__ssttrreeaamm__ppllaayyiinngg ********** │ │ │ │ │ bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val) │ │ │ │ │ +bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Change whether the stream is playing. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___p_l_a_y_i_n_g │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___s_i_m_p_l_e_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ppllaayymmooddee ********** │ │ │ │ │ ALLEGRO_PLAYMODE al_get_audio_stream_playmode( │ │ │ │ │ const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +ALLEGRO_PLAYMODE al_get_audio_stream_playmode( │ │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the playback mode of the stream. │ │ │ │ │ See also: _A_L_L_E_G_R_O___P_L_A_Y_M_O_D_E, _a_l___s_e_t___a_u_d_i_o___s_t_r_e_a_m___p_l_a_y_m_o_d_e. │ │ │ │ │ ********** aall__sseett__aauuddiioo__ssttrreeaamm__ppllaayymmooddee ********** │ │ │ │ │ bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ ALLEGRO_PLAYMODE val) │ │ │ │ │ +bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ + ALLEGRO_PLAYMODE val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the playback mode of the stream. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _A_L_L_E_G_R_O___P_L_A_Y_M_O_D_E, _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___p_l_a_y_m_o_d_e. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___m_i_x_e_r___p_p_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__aattttaacchheedd ********** │ │ │ │ │ bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return whether the stream is attached to something. │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m___t_o___m_i_x_e_r, _a_l___a_t_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m___t_o___v_o_i_c_e, │ │ │ │ │ _a_l___d_e_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m. │ │ │ │ │ ********** aall__ddeettaacchh__aauuddiioo__ssttrreeaamm ********** │ │ │ │ │ bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Detach the stream from whatever it’s attached to, if anything. │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m___t_o___m_i_x_e_r, _a_l___a_t_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m___t_o___v_o_i_c_e, │ │ │ │ │ _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___a_t_t_a_c_h_e_d. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ppllaayyeedd__ssaammpplleess ********** │ │ │ │ │ uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get the number of samples consumed by the parent since the audio stream was │ │ │ │ │ started. │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ffrraaggmmeenntt ********** │ │ │ │ │ void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ When using Allegro’s audio streaming, you will use this function to │ │ │ │ │ continuously provide new sample data to a stream. │ │ │ │ │ If the stream is ready for new data, the function will return the address of an │ │ │ │ │ internal buffer to be filled with audio data. The length and format of the │ │ │ │ │ buffer are specified with _a_l___c_r_e_a_t_e___a_u_d_i_o___s_t_r_e_a_m or can be queried with the │ │ │ │ │ various functions described here. Once the buffer is filled, you must signal │ │ │ │ │ @@ -1217,66 +1319,75 @@ │ │ │ │ │ _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___d_e_p_t_h, _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___l_e_n_g_t_h │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ ********** aall__sseett__aauuddiioo__ssttrreeaamm__ffrraaggmmeenntt ********** │ │ │ │ │ bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val) │ │ │ │ │ +bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This function needs to be called for every successful call of │ │ │ │ │ _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___f_r_a_g_m_e_n_t to indicate that the buffer (pointed to by val) is │ │ │ │ │ filled with new data. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___f_r_a_g_m_e_n_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ffrraaggmmeennttss ********** │ │ │ │ │ unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the number of fragments this stream uses. This is the same value as │ │ │ │ │ passed to _a_l___c_r_e_a_t_e___a_u_d_i_o___s_t_r_e_a_m when a new stream is created. │ │ │ │ │ See also: _a_l___g_e_t___a_v_a_i_l_a_b_l_e___a_u_d_i_o___s_t_r_e_a_m___f_r_a_g_m_e_n_t_s │ │ │ │ │ ********** aall__ggeett__aavvaaiillaabbllee__aauuddiioo__ssttrreeaamm__ffrraaggmmeennttss ********** │ │ │ │ │ unsigned int al_get_available_audio_stream_fragments( │ │ │ │ │ const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +unsigned int al_get_available_audio_stream_fragments( │ │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the number of available fragments in the stream, that is, fragments │ │ │ │ │ which are not currently filled with data for playback. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___f_r_a_g_m_e_n_t, _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___f_r_a_g_m_e_n_t_s │ │ │ │ │ ********** aall__sseeeekk__aauuddiioo__ssttrreeaamm__sseeccss ********** │ │ │ │ │ bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time) │ │ │ │ │ +bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the streaming file playing position to time. Returns true on success. │ │ │ │ │ Currently this can only be called on streams created with _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m, │ │ │ │ │ _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m, _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m___f or _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m___f. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___p_o_s_i_t_i_o_n___s_e_c_s, _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___l_e_n_g_t_h___s_e_c_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__ppoossiittiioonn__sseeccss ********** │ │ │ │ │ double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the position of the stream in seconds. Currently this can only be called │ │ │ │ │ on streams created with _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m, _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m, │ │ │ │ │ _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m___f or _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m___f. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___l_e_n_g_t_h___s_e_c_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ssttrreeaamm__lleennggtthh__sseeccss ********** │ │ │ │ │ double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the length of the stream in seconds, if known. Otherwise returns zero. │ │ │ │ │ Currently this can only be called on streams created with _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m, │ │ │ │ │ _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m, _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m___f or _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m___f. │ │ │ │ │ See also: _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___p_o_s_i_t_i_o_n___s_e_c_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__sseett__aauuddiioo__ssttrreeaamm__lloooopp__sseeccss ********** │ │ │ │ │ bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ double start, double end) │ │ │ │ │ +bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ + double start, double end) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sets the loop points for the stream in seconds. Currently this can only be │ │ │ │ │ called on streams created with _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m, _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m, │ │ │ │ │ _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m___f or _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m___f. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ********** aall__sseett__aauuddiioo__ssttrreeaamm__cchhaannnneell__mmaattrriixx ********** │ │ │ │ │ @@ -1284,89 +1395,104 @@ │ │ │ │ │ Like _a_l___s_e_t___s_a_m_p_l_e___i_n_s_t_a_n_c_e___c_h_a_n_n_e_l___m_a_t_r_i_x but for streams. │ │ │ │ │ Since: 5.2.3 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: New API. │ │ │ │ │ ************ AAddvvaanncceedd aauuddiioo ffiillee II//OO ************ │ │ │ │ │ ********** aall__rreeggiisstteerr__ssaammppllee__llooaaddeerr ********** │ │ │ │ │ bool al_register_sample_loader(const char *ext, │ │ │ │ │ ALLEGRO_SAMPLE *(*loader)(const char *filename)) │ │ │ │ │ +bool al_register_sample_loader(const char *ext, │ │ │ │ │ + ALLEGRO_SAMPLE *(*loader)(const char *filename)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Register a handler for _a_l___l_o_a_d___s_a_m_p_l_e. The given function will be used to │ │ │ │ │ handle the loading of sample files with the given extension. │ │ │ │ │ The extension should include the leading dot (‘.’) character. It will be │ │ │ │ │ matched case-insensitively. │ │ │ │ │ The loader argument may be NULL to unregister an entry. │ │ │ │ │ Returns true on success, false on error. Returns false if unregistering an │ │ │ │ │ entry that doesn’t exist. │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___l_o_a_d_e_r___f, _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___s_a_v_e_r │ │ │ │ │ ********** aall__rreeggiisstteerr__ssaammppllee__llooaaddeerr__ff ********** │ │ │ │ │ bool al_register_sample_loader_f(const char *ext, │ │ │ │ │ ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp)) │ │ │ │ │ +bool al_register_sample_loader_f(const char *ext, │ │ │ │ │ + ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Register a handler for _a_l___l_o_a_d___s_a_m_p_l_e___f. The given function will be used to │ │ │ │ │ handle the loading of sample files with the given extension. │ │ │ │ │ The extension should include the leading dot (‘.’) character. It will be │ │ │ │ │ matched case-insensitively. │ │ │ │ │ The loader argument may be NULL to unregister an entry. │ │ │ │ │ Returns true on success, false on error. Returns false if unregistering an │ │ │ │ │ entry that doesn’t exist. │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___l_o_a_d_e_r │ │ │ │ │ ********** aall__rreeggiisstteerr__ssaammppllee__ssaavveerr ********** │ │ │ │ │ bool al_register_sample_saver(const char *ext, │ │ │ │ │ bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl)) │ │ │ │ │ +bool al_register_sample_saver(const char *ext, │ │ │ │ │ + bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Register a handler for _a_l___s_a_v_e___s_a_m_p_l_e. The given function will be used to │ │ │ │ │ handle the saving of sample files with the given extension. │ │ │ │ │ The extension should include the leading dot (‘.’) character. It will be │ │ │ │ │ matched case-insensitively. │ │ │ │ │ The saver argument may be NULL to unregister an entry. │ │ │ │ │ Returns true on success, false on error. Returns false if unregistering an │ │ │ │ │ entry that doesn’t exist. │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___s_a_v_e_r___f, _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___l_o_a_d_e_r │ │ │ │ │ ********** aall__rreeggiisstteerr__ssaammppllee__ssaavveerr__ff ********** │ │ │ │ │ bool al_register_sample_saver_f(const char *ext, │ │ │ │ │ bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl)) │ │ │ │ │ +bool al_register_sample_saver_f(const char *ext, │ │ │ │ │ + bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Register a handler for _a_l___s_a_v_e___s_a_m_p_l_e___f. The given function will be used to │ │ │ │ │ handle the saving of sample files with the given extension. │ │ │ │ │ The extension should include the leading dot (‘.’) character. It will be │ │ │ │ │ matched case-insensitively. │ │ │ │ │ The saver argument may be NULL to unregister an entry. │ │ │ │ │ Returns true on success, false on error. Returns false if unregistering an │ │ │ │ │ entry that doesn’t exist. │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___s_a_v_e_r │ │ │ │ │ ********** aall__rreeggiisstteerr__aauuddiioo__ssttrreeaamm__llooaaddeerr ********** │ │ │ │ │ bool al_register_audio_stream_loader(const char *ext, │ │ │ │ │ ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename, │ │ │ │ │ +bool al_register_audio_stream_loader(const char *ext, │ │ │ │ │ + ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename, │ │ │ │ │ size_t buffer_count, unsigned int samples)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Register a handler for _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m and _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m. The given │ │ │ │ │ function will be used to open streams from files with the given extension. │ │ │ │ │ The extension should include the leading dot (‘.’) character. It will be │ │ │ │ │ matched case-insensitively. │ │ │ │ │ The stream_loader argument may be NULL to unregister an entry. │ │ │ │ │ Returns true on success, false on error. Returns false if unregistering an │ │ │ │ │ entry that doesn’t exist. │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___a_u_d_i_o___s_t_r_e_a_m___l_o_a_d_e_r___f │ │ │ │ │ ********** aall__rreeggiisstteerr__aauuddiioo__ssttrreeaamm__llooaaddeerr__ff ********** │ │ │ │ │ bool al_register_audio_stream_loader_f(const char *ext, │ │ │ │ │ ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp, │ │ │ │ │ size_t buffer_count, unsigned int samples)) │ │ │ │ │ +bool al_register_audio_stream_loader_f(const char *ext, │ │ │ │ │ + ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp, │ │ │ │ │ + size_t buffer_count, unsigned int samples)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Register a handler for _a_l___l_o_a_d___a_u_d_i_o___s_t_r_e_a_m___f and _a_l___p_l_a_y___a_u_d_i_o___s_t_r_e_a_m___f. The │ │ │ │ │ given function will be used to open streams from files with the given │ │ │ │ │ extension. │ │ │ │ │ The extension should include the leading dot (‘.’) character. It will be │ │ │ │ │ matched case-insensitively. │ │ │ │ │ The stream_loader argument may be NULL to unregister an entry. │ │ │ │ │ Returns true on success, false on error. Returns false if unregistering an │ │ │ │ │ entry that doesn’t exist. │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___a_u_d_i_o___s_t_r_e_a_m___l_o_a_d_e_r │ │ │ │ │ ********** aall__rreeggiisstteerr__ssaammppllee__iiddeennttiiffiieerr ********** │ │ │ │ │ bool al_register_sample_identifier(const char *ext, │ │ │ │ │ bool (*identifier)(ALLEGRO_FILE* fp)) │ │ │ │ │ +bool al_register_sample_identifier(const char *ext, │ │ │ │ │ + bool (*identifier)(ALLEGRO_FILE* fp)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Register an identify handler for _a_l___i_d_e_n_t_i_f_y___s_a_m_p_l_e. The given function will be │ │ │ │ │ used to detect files for the given extension. It will be called with a single │ │ │ │ │ argument of type _A_L_L_E_G_R_O___F_I_L_E which is a file handle opened for reading and │ │ │ │ │ located at the first byte of the file. The handler should try to read as few │ │ │ │ │ bytes as possible to safely determine if the given file contents correspond to │ │ │ │ │ the type with the extension and return true in that case, false otherwise. The │ │ │ │ │ @@ -1377,23 +1503,25 @@ │ │ │ │ │ The identifier argument may be NULL to unregister an entry. │ │ │ │ │ Returns true on success, false on error. Returns false if unregistering an │ │ │ │ │ entry that doesn’t exist. │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ See also: _a_l___i_d_e_n_t_i_f_y___b_i_t_m_a_p │ │ │ │ │ ********** aall__iiddeennttiiffyy__ssaammppllee ********** │ │ │ │ │ char const *al_identify_sample(char const *filename) │ │ │ │ │ +char const *al_identify_sample(char const *filename) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This works exactly as _a_l___i_d_e_n_t_i_f_y___s_a_m_p_l_e___f but you specify the filename of the │ │ │ │ │ file for which to detect the type and not a file handle. The extension, if any, │ │ │ │ │ of the passed filename is not taken into account - only the file contents. │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ See also: _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n, _a_l___i_d_e_n_t_i_f_y___s_a_m_p_l_e___f, │ │ │ │ │ _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___i_d_e_n_t_i_f_i_e_r │ │ │ │ │ ********** aall__iiddeennttiiffyy__ssaammppllee__ff ********** │ │ │ │ │ char const *al_identify_sample_f(ALLEGRO_FILE *fp) │ │ │ │ │ +char const *al_identify_sample_f(ALLEGRO_FILE *fp) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Tries to guess the audio file type of the open ALLEGRO_FILE by reading the │ │ │ │ │ first few bytes. By default Allegro cannot recognize any file types, but │ │ │ │ │ calling _a_l___i_n_i_t___a_c_o_d_e_c___a_d_d_o_n will add detection of the types it can read. You │ │ │ │ │ can also use _a_l___r_e_g_i_s_t_e_r___s_a_m_p_l_e___i_d_e_n_t_i_f_i_e_r to add identification for custom │ │ │ │ │ file types. │ │ │ │ │ Returns a pointer to a static string with a file extension for the type, │ │ │ │ │ @@ -1408,23 +1536,25 @@ │ │ │ │ │ specific implementation details with its own buffering, it will add a small │ │ │ │ │ amount of latency. However, for most applications that small overhead will not │ │ │ │ │ adversely affect performance. │ │ │ │ │ Recording is supported by the ALSA, AudioQueue, DirectSound8, and PulseAudio │ │ │ │ │ drivers. Enumerating or choosing other recording devices is not yet supported. │ │ │ │ │ ********** AALLLLEEGGRROO__AAUUDDIIOO__RREECCOORRDDEERR ********** │ │ │ │ │ typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER; │ │ │ │ │ +typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An opaque datatype that represents a recording device. │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ ********** AALLLLEEGGRROO__AAUUDDIIOO__RREECCOORRDDEERR__EEVVEENNTT ********** │ │ │ │ │ typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT; │ │ │ │ │ +typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Structure that holds the audio recorder event data. Every event type will │ │ │ │ │ contain: │ │ │ │ │ * .source: pointer to the audio recorder │ │ │ │ │ The following will be available depending on the event type: │ │ │ │ │ * .buffer: pointer to buffer containing the audio samples │ │ │ │ │ * .samples: number of samples (not bytes) that are available │ │ │ │ │ @@ -1434,14 +1564,17 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ ********** aall__ccrreeaattee__aauuddiioo__rreeccoorrddeerr ********** │ │ │ │ │ ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count, │ │ │ │ │ unsigned int samples, unsigned int frequency, │ │ │ │ │ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count, │ │ │ │ │ + unsigned int samples, unsigned int frequency, │ │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates an audio recorder using the system’s default recording device. (So if │ │ │ │ │ the returned device does not work, try updating the system’s default recording │ │ │ │ │ device.) │ │ │ │ │ Allegro will internally buffer several seconds of captured audio with minimal │ │ │ │ │ latency. (XXX: These settings need to be exposed via config or API calls.) │ │ │ │ │ Audio will be copied out of that private buffer into a fragment buffer of the │ │ │ │ │ @@ -1465,119 +1598,133 @@ │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ ********** aall__ssttaarrtt__aauuddiioo__rreeccoorrddeerr ********** │ │ │ │ │ bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Begin recording into the fragment buffer. Once a complete fragment has been │ │ │ │ │ captured (as specified in _a_l___c_r_e_a_t_e___a_u_d_i_o___r_e_c_o_r_d_e_r), an │ │ │ │ │ _A_L_L_E_G_R_O___E_V_E_N_T___A_U_D_I_O___R_E_C_O_R_D_E_R___F_R_A_G_M_E_N_T event will be triggered. │ │ │ │ │ Returns true if it was able to begin recording. │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ ********** aall__ssttoopp__aauuddiioo__rreeccoorrddeerr ********** │ │ │ │ │ void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Stop capturing audio data. Note that the audio recorder is still active and │ │ │ │ │ consuming resources, so if you are finished recording you should destroy it │ │ │ │ │ with _a_l___d_e_s_t_r_o_y___a_u_d_i_o___r_e_c_o_r_d_e_r. │ │ │ │ │ You may still receive a few events after you call this function as the device │ │ │ │ │ flushes the buffer. │ │ │ │ │ If you restart the recorder, it will begin recording at the beginning of the │ │ │ │ │ next fragment buffer. │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ ********** aall__iiss__aauuddiioo__rreeccoorrddeerr__rreeccoorrddiinngg ********** │ │ │ │ │ bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the audio recorder is currently capturing data and generating │ │ │ │ │ events. │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ ********** aall__ggeett__aauuddiioo__rreeccoorrddeerr__eevveenntt ********** │ │ │ │ │ ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event) │ │ │ │ │ +ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the event as an _A_L_L_E_G_R_O___A_U_D_I_O___R_E_C_O_R_D_E_R___E_V_E_N_T. │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__rreeccoorrddeerr__eevveenntt__ssoouurrccee ********** │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER │ │ │ │ │ *r) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER │ │ │ │ │ +*r) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the event source for the recorder that generates the various recording │ │ │ │ │ events. │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__aauuddiioo__rreeccoorrddeerr ********** │ │ │ │ │ void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Destroys the audio recorder and frees all resources associated with it. It is │ │ │ │ │ safe to destroy a recorder that is recording. │ │ │ │ │ You may receive events after the recorder has been destroyed. They must be │ │ │ │ │ ignored, as the fragment buffer will no longer be valid. │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d_._c │ │ │ │ │ ************ AAuuddiioo ddeevviicceess ************ │ │ │ │ │ ********** AALLLLEEGGRROO__AAUUDDIIOO__DDEEVVIICCEE ********** │ │ │ │ │ typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE; │ │ │ │ │ +typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An opaque datatype that represents an audio device. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___d_e_v_i_c_e_s_._c │ │ │ │ │ ********** aall__ggeett__nnuumm__aauuddiioo__oouuttppuutt__ddeevviicceess ********** │ │ │ │ │ int al_get_num_audio_output_devices() │ │ │ │ │ +int al_get_num_audio_output_devices() │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get the number of available audio output devices on the system. │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ return -1 for unsupported drivers. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___d_e_v_i_c_e_s_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__oouuttppuutt__ddeevviiccee ********** │ │ │ │ │ const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index) │ │ │ │ │ +const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get the output audio device of the specified index. │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___d_e_v_i_c_e_s_._c │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ddeevviiccee__nnaammee ********** │ │ │ │ │ const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device) │ │ │ │ │ +const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get the user friendly display name of the device. │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___d_e_v_i_c_e_s_._c │ │ │ │ │ ************ VVooiicceess ************ │ │ │ │ │ ********** AALLLLEEGGRROO__VVOOIICCEE ********** │ │ │ │ │ typedef struct ALLEGRO_VOICE ALLEGRO_VOICE; │ │ │ │ │ +typedef struct ALLEGRO_VOICE ALLEGRO_VOICE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A voice represents an audio device on the system, which may be a real device, │ │ │ │ │ or an abstract device provided by the operating system. To play back audio, you │ │ │ │ │ would attach a mixer, sample instance or audio stream to a voice. │ │ │ │ │ See also: _A_L_L_E_G_R_O___M_I_X_E_R, _A_L_L_E_G_R_O___S_A_M_P_L_E, _A_L_L_E_G_R_O___A_U_D_I_O___S_T_R_E_A_M │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ ********** aall__ccrreeaattee__vvooiiccee ********** │ │ │ │ │ ALLEGRO_VOICE *al_create_voice(unsigned int freq, │ │ │ │ │ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +ALLEGRO_VOICE *al_create_voice(unsigned int freq, │ │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a voice structure and allocates a voice from the digital sound driver. │ │ │ │ │ The passed frequency (in Hz), sample format and channel configuration are used │ │ │ │ │ as a hint to what kind of data will be sent to the voice. However, the │ │ │ │ │ underlying sound driver is free to use non-matching values. For example, it may │ │ │ │ │ be the native format of the sound hardware. │ │ │ │ │ If a mixer is attached to the voice, the mixer will handle the conversion of │ │ │ │ │ @@ -1590,31 +1737,35 @@ │ │ │ │ │ See also: _a_l___d_e_s_t_r_o_y___v_o_i_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__vvooiiccee ********** │ │ │ │ │ void al_destroy_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ +void al_destroy_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Destroys the voice and deallocates it from the digital driver. Does nothing if │ │ │ │ │ the voice is NULL. │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___v_o_i_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ ********** aall__ddeettaacchh__vvooiiccee ********** │ │ │ │ │ void al_detach_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ +void al_detach_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Detaches the mixer, sample instance or audio stream from the voice. │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___m_i_x_e_r___t_o___v_o_i_c_e, _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___v_o_i_c_e, │ │ │ │ │ _a_l___a_t_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m___t_o___v_o_i_c_e │ │ │ │ │ ********** aall__aattttaacchh__aauuddiioo__ssttrreeaamm__ttoo__vvooiiccee ********** │ │ │ │ │ bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ ALLEGRO_VOICE *voice) │ │ │ │ │ +bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ + ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Attaches an audio stream to a voice. The same rules as │ │ │ │ │ _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___v_o_i_c_e apply. This may fail if the driver can’t │ │ │ │ │ create a voice with the buffer count and buffer size the stream uses. │ │ │ │ │ An audio stream attached directly to a voice has a number of limitations: The │ │ │ │ │ audio stream plays immediately and cannot be stopped. The stream position, │ │ │ │ │ speed, gain and panning cannot be changed. At this time, we don’t recommend │ │ │ │ │ @@ -1622,93 +1773,105 @@ │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___d_e_t_a_c_h___v_o_i_c_e, _a_l___v_o_i_c_e___h_a_s___a_t_t_a_c_h_m_e_n_t_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__aattttaacchh__mmiixxeerr__ttoo__vvooiiccee ********** │ │ │ │ │ bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice) │ │ │ │ │ +bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Attaches a mixer to a voice. It must have the same frequency and channel │ │ │ │ │ configuration, but the depth may be different. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___d_e_t_a_c_h___v_o_i_c_e, _a_l___v_o_i_c_e___h_a_s___a_t_t_a_c_h_m_e_n_t_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__aattttaacchh__ssaammppllee__iinnssttaannccee__ttoo__vvooiiccee ********** │ │ │ │ │ bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ ALLEGRO_VOICE *voice) │ │ │ │ │ +bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Attaches a sample instance to a voice, and allows it to play. The instance’s │ │ │ │ │ gain and loop mode will be ignored, and it must have the same frequency, │ │ │ │ │ channel configuration and depth (including signed-ness) as the voice. This │ │ │ │ │ function may fail if the selected driver doesn’t support preloading sample │ │ │ │ │ data. │ │ │ │ │ At this time, we don’t recommend attaching sample instances directly to voices. │ │ │ │ │ Use a mixer inbetween. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___d_e_t_a_c_h___v_o_i_c_e, _a_l___v_o_i_c_e___h_a_s___a_t_t_a_c_h_m_e_n_t_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__vvooiiccee__ffrreeqquueennccyy ********** │ │ │ │ │ +unsigned int al_get_voic) │ │ │ │ │ unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the frequency of the voice (in Hz), e.g. 44100. │ │ │ │ │ ********** aall__ggeett__vvooiiccee__cchhaannnneellss ********** │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the channel configuration of the voice. │ │ │ │ │ See also: _A_L_L_E_G_R_O___C_H_A_N_N_E_L___C_O_N_F. │ │ │ │ │ ********** aall__ggeett__vvooiiccee__ddeepptthh ********** │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the audio depth of the voice. │ │ │ │ │ See also: _A_L_L_E_G_R_O___A_U_D_I_O___D_E_P_T_H. │ │ │ │ │ ********** aall__ggeett__vvooiiccee__ppllaayyiinngg ********** │ │ │ │ │ bool al_get_voice_playing(const ALLEGRO_VOICE *voice) │ │ │ │ │ +bool al_get_voice_playing(const ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return true if the voice is currently playing. │ │ │ │ │ See also: _a_l___s_e_t___v_o_i_c_e___p_l_a_y_i_n_g │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__vvooiiccee__ppllaayyiinngg ********** │ │ │ │ │ bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val) │ │ │ │ │ +bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Change whether a voice is playing or not. This can only work if the voice has a │ │ │ │ │ non-streaming object attached to it, e.g. a sample instance. On success the │ │ │ │ │ voice’s current sample position is reset. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___g_e_t___v_o_i_c_e___p_l_a_y_i_n_g │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__vvooiiccee__ppoossiittiioonn ********** │ │ │ │ │ unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice) │ │ │ │ │ +unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ When the voice has a non-streaming object attached to it, e.g. a sample, │ │ │ │ │ returns the voice’s current sample position. Otherwise, returns zero. │ │ │ │ │ See also: _a_l___s_e_t___v_o_i_c_e___p_o_s_i_t_i_o_n. │ │ │ │ │ ********** aall__sseett__vvooiiccee__ppoossiittiioonn ********** │ │ │ │ │ bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val) │ │ │ │ │ +bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the voice position. This can only work if the voice has a non-streaming │ │ │ │ │ object attached to it, e.g. a sample instance. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___g_e_t___v_o_i_c_e___p_o_s_i_t_i_o_n. │ │ │ │ │ ********** aall__vvooiiccee__hhaass__aattttaacchhmmeennttss ********** │ │ │ │ │ bool al_voice_has_attachments(const ALLEGRO_VOICE* voice) │ │ │ │ │ +bool al_voice_has_attachments(const ALLEGRO_VOICE* voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the voice has something attached to it. │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___m_i_x_e_r___t_o___v_o_i_c_e, _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___v_o_i_c_e, │ │ │ │ │ _a_l___a_t_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m___t_o___v_o_i_c_e │ │ │ │ │ Since: 5.2.9 │ │ │ │ │ ************ MMiixxeerrss ************ │ │ │ │ │ ********** AALLLLEEGGRROO__MMIIXXEERR ********** │ │ │ │ │ typedef struct ALLEGRO_MIXER ALLEGRO_MIXER; │ │ │ │ │ +typedef struct ALLEGRO_MIXER ALLEGRO_MIXER; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A mixer mixes together attached streams into a single buffer. In the process, │ │ │ │ │ it converts channel configurations, sample frequencies and audio depths of the │ │ │ │ │ attached sample instances and audio streams accordingly. You can control the │ │ │ │ │ quality of this conversion using ALLEGRO_MIXER_QUALITY. │ │ │ │ │ When going from mono to stereo (and above), the mixer reduces the volume of │ │ │ │ │ both channels by sqrt(2). When going from stereo (and above) to mono, the mixer │ │ │ │ │ @@ -1716,21 +1879,24 @@ │ │ │ │ │ to the center channel (if present). │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** AALLLLEEGGRROO__MMIIXXEERR__QQUUAALLIITTYY ********** │ │ │ │ │ enum ALLEGRO_MIXER_QUALITY │ │ │ │ │ +enum ALLEGRO_MIXER_QUALITY │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ * ALLEGRO_MIXER_QUALITY_POINT - point sampling │ │ │ │ │ * ALLEGRO_MIXER_QUALITY_LINEAR - linear interpolation │ │ │ │ │ * ALLEGRO_MIXER_QUALITY_CUBIC - cubic interpolation (since: 5.0.8, 5.1.4) │ │ │ │ │ ********** aall__ccrreeaattee__mmiixxeerr ********** │ │ │ │ │ ALLEGRO_MIXER *al_create_mixer(unsigned int freq, │ │ │ │ │ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +ALLEGRO_MIXER *al_create_mixer(unsigned int freq, │ │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a mixer to attach sample instances, audio streams, or other mixers to. │ │ │ │ │ It will mix into a buffer at the requested frequency (in Hz) and channel count. │ │ │ │ │ The only supported audio depths are ALLEGRO_AUDIO_DEPTH_FLOAT32 and │ │ │ │ │ ALLEGRO_AUDIO_DEPTH_INT16 (not yet complete). │ │ │ │ │ To actually produce any output, the mixer will have to be attached to a voice │ │ │ │ │ using _a_l___a_t_t_a_c_h___m_i_x_e_r___t_o___v_o_i_c_e. │ │ │ │ │ @@ -1740,212 +1906,239 @@ │ │ │ │ │ See also: _a_l___d_e_s_t_r_o_y___m_i_x_e_r, _A_L_L_E_G_R_O___A_U_D_I_O___D_E_P_T_H, _A_L_L_E_G_R_O___C_H_A_N_N_E_L___C_O_N_F │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__mmiixxeerr ********** │ │ │ │ │ void al_destroy_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ +void al_destroy_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Destroys the mixer. │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___m_i_x_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** aall__ggeett__ddeeffaauulltt__mmiixxeerr ********** │ │ │ │ │ ALLEGRO_MIXER *al_get_default_mixer(void) │ │ │ │ │ +ALLEGRO_MIXER *al_get_default_mixer(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the default mixer, or NULL if one has not been set. Although different │ │ │ │ │ configurations of mixers and voices can be used, in most cases a single mixer │ │ │ │ │ attached to a voice is what you want. The default mixer is used by │ │ │ │ │ _a_l___p_l_a_y___s_a_m_p_l_e. │ │ │ │ │ See also: _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s, _a_l___p_l_a_y___s_a_m_p_l_e, _a_l___s_e_t___d_e_f_a_u_l_t___m_i_x_e_r, │ │ │ │ │ _a_l___r_e_s_t_o_r_e___d_e_f_a_u_l_t___m_i_x_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ ********** aall__sseett__ddeeffaauulltt__mmiixxeerr ********** │ │ │ │ │ bool al_set_default_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_set_default_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sets the default mixer. All samples started with _a_l___p_l_a_y___s_a_m_p_l_e will be stopped │ │ │ │ │ and all sample instances returned by _a_l___l_o_c_k___s_a_m_p_l_e___i_d will be invalidated. If │ │ │ │ │ you are using your own mixer, this should be called before _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s. │ │ │ │ │ Returns true on success, false on error. │ │ │ │ │ See also: _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s, _a_l___p_l_a_y___s_a_m_p_l_e, _a_l___g_e_t___d_e_f_a_u_l_t___m_i_x_e_r, │ │ │ │ │ _a_l___r_e_s_t_o_r_e___d_e_f_a_u_l_t___m_i_x_e_r │ │ │ │ │ ********** aall__rreessttoorree__ddeeffaauulltt__mmiixxeerr ********** │ │ │ │ │ bool al_restore_default_mixer(void) │ │ │ │ │ +bool al_restore_default_mixer(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Restores Allegro’s default mixer and attaches it to the default voice. If the │ │ │ │ │ default mixer hasn’t been created before, it will be created. If the default │ │ │ │ │ voice hasn’t been set via _a_l___s_e_t___d_e_f_a_u_l_t___v_o_i_c_e or created before, it will also │ │ │ │ │ be created. All samples started with _a_l___p_l_a_y___s_a_m_p_l_e will be stopped and all │ │ │ │ │ sample instances returned by _a_l___l_o_c_k___s_a_m_p_l_e___i_d will be invalidated. │ │ │ │ │ Returns true on success, false on error. │ │ │ │ │ See also: _a_l___g_e_t___d_e_f_a_u_l_t___m_i_x_e_r, _a_l___s_e_t___d_e_f_a_u_l_t___m_i_x_e_r, _a_l___r_e_s_e_r_v_e___s_a_m_p_l_e_s. │ │ │ │ │ ********** aall__ggeett__ddeeffaauulltt__vvooiiccee ********** │ │ │ │ │ ALLEGRO_VOICE *al_get_default_voice(void) │ │ │ │ │ +ALLEGRO_VOICE *al_get_default_voice(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the default voice or NULL if there is none. │ │ │ │ │ Since: 5.1.13 │ │ │ │ │ See also: _a_l___g_e_t___d_e_f_a_u_l_t___m_i_x_e_r │ │ │ │ │ ********** aall__sseett__ddeeffaauulltt__vvooiiccee ********** │ │ │ │ │ void al_set_default_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ +void al_set_default_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ You can call this before calling al_restore_default_mixer to provide the voice │ │ │ │ │ which should be used. Any previous voice will be destroyed. You can also pass │ │ │ │ │ NULL to destroy the current default voice. │ │ │ │ │ Since: 5.1.13 │ │ │ │ │ See also: _a_l___g_e_t___d_e_f_a_u_l_t___m_i_x_e_r │ │ │ │ │ ********** aall__aattttaacchh__mmiixxeerr__ttoo__mmiixxeerr ********** │ │ │ │ │ bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Attaches the mixer passed as the first argument onto the mixer passed as the │ │ │ │ │ second argument. The first mixer (that is going to be attached) must not │ │ │ │ │ already be attached to anything. Both mixers must use the same frequency, audio │ │ │ │ │ depth and channel configuration. │ │ │ │ │ Returns true on success, false on error. │ │ │ │ │ It is invalid to attach a mixer to itself. │ │ │ │ │ See also: _a_l___d_e_t_a_c_h___m_i_x_e_r. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__aattttaacchh__ssaammppllee__iinnssttaannccee__ttoo__mmiixxeerr ********** │ │ │ │ │ bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Attach a sample instance to a mixer. The instance must not already be attached │ │ │ │ │ to anything. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___d_e_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c_._c │ │ │ │ │ ********** aall__aattttaacchh__aauuddiioo__ssttrreeaamm__ttoo__mmiixxeerr ********** │ │ │ │ │ bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ +ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Attach an audio stream to a mixer. The stream must not already be attached to │ │ │ │ │ anything. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___d_e_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ ********** aall__ggeett__mmiixxeerr__ffrreeqquueennccyy ********** │ │ │ │ │ unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the mixer frequency (in Hz). │ │ │ │ │ See also: _a_l___s_e_t___m_i_x_e_r___f_r_e_q_u_e_n_c_y │ │ │ │ │ ********** aall__sseett__mmiixxeerr__ffrreeqquueennccyy ********** │ │ │ │ │ bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val) │ │ │ │ │ +bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the mixer frequency (in Hz). This will only work if the mixer is not │ │ │ │ │ attached to anything. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___g_e_t___m_i_x_e_r___f_r_e_q_u_e_n_c_y │ │ │ │ │ ********** aall__ggeett__mmiixxeerr__cchhaannnneellss ********** │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the mixer channel configuration. │ │ │ │ │ See also: _A_L_L_E_G_R_O___C_H_A_N_N_E_L___C_O_N_F. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ ********** aall__ggeett__mmiixxeerr__ddeepptthh ********** │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the mixer audio depth. │ │ │ │ │ See also: _A_L_L_E_G_R_O___A_U_D_I_O___D_E_P_T_H. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ ********** aall__ggeett__mmiixxeerr__ggaaiinn ********** │ │ │ │ │ float al_get_mixer_gain(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +float al_get_mixer_gain(const ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the mixer gain (amplification factor). The default is 1.0. │ │ │ │ │ Since: 5.0.6, 5.1.0 │ │ │ │ │ See also: _a_l___s_e_t___m_i_x_e_r___g_a_i_n. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__mmiixxeerr__ggaaiinn ********** │ │ │ │ │ bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain) │ │ │ │ │ +bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the mixer gain (amplification factor). │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ Since: 5.0.6, 5.1.0 │ │ │ │ │ See also: _a_l___g_e_t___m_i_x_e_r___g_a_i_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__mmiixxeerr__qquuaalliittyy ********** │ │ │ │ │ ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the mixer quality. │ │ │ │ │ See also: _A_L_L_E_G_R_O___M_I_X_E_R___Q_U_A_L_I_T_Y, _a_l___s_e_t___m_i_x_e_r___q_u_a_l_i_t_y │ │ │ │ │ ********** aall__sseett__mmiixxeerr__qquuaalliittyy ********** │ │ │ │ │ bool al_set_mixer_quality(ALLEGRO_MIXER *mixer, ALLEGRO_MIXER_QUALITY │ │ │ │ │ new_quality) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the mixer quality. This can only succeed if the mixer does not have │ │ │ │ │ anything attached to it. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _A_L_L_E_G_R_O___M_I_X_E_R___Q_U_A_L_I_T_Y, _a_l___g_e_t___m_i_x_e_r___q_u_a_l_i_t_y │ │ │ │ │ ********** aall__ggeett__mmiixxeerr__ppllaayyiinngg ********** │ │ │ │ │ bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return true if the mixer is playing. │ │ │ │ │ See also: _a_l___s_e_t___m_i_x_e_r___p_l_a_y_i_n_g. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__mmiixxeerr__ppllaayyiinngg ********** │ │ │ │ │ bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val) │ │ │ │ │ +bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Change whether the mixer is playing. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ See also: _a_l___g_e_t___m_i_x_e_r___p_l_a_y_i_n_g. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ggeett__mmiixxeerr__aattttaacchheedd ********** │ │ │ │ │ bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return true if the mixer is attached to something. │ │ │ │ │ See also: _a_l___m_i_x_e_r___h_a_s___a_t_t_a_c_h_m_e_n_t_s, _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___m_i_x_e_r, │ │ │ │ │ _a_l___a_t_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m___t_o___m_i_x_e_r, _a_l___a_t_t_a_c_h___m_i_x_e_r___t_o___m_i_x_e_r, _a_l___d_e_t_a_c_h___m_i_x_e_r │ │ │ │ │ ********** aall__mmiixxeerr__hhaass__aattttaacchhmmeennttss ********** │ │ │ │ │ bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer) │ │ │ │ │ +bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the mixer has something attached to it. │ │ │ │ │ See also: _a_l___g_e_t___m_i_x_e_r___a_t_t_a_c_h_e_d, _a_l___a_t_t_a_c_h___s_a_m_p_l_e___i_n_s_t_a_n_c_e___t_o___m_i_x_e_r, │ │ │ │ │ _a_l___a_t_t_a_c_h___a_u_d_i_o___s_t_r_e_a_m___t_o___m_i_x_e_r, _a_l___a_t_t_a_c_h___m_i_x_e_r___t_o___m_i_x_e_r, _a_l___d_e_t_a_c_h___m_i_x_e_r │ │ │ │ │ Since: 5.2.9 │ │ │ │ │ ********** aall__ddeettaacchh__mmiixxeerr ********** │ │ │ │ │ bool al_detach_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_detach_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Detach the mixer from whatever it is attached to, if anything. │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___m_i_x_e_r___t_o___m_i_x_e_r. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__sseett__mmiixxeerr__ppoossttpprroocceessss__ccaallllbbaacckk ********** │ │ │ │ │ bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer, │ │ │ │ │ void (*pp_callback)(void *buf, unsigned int samples, void *data), │ │ │ │ │ void *pp_callback_userdata) │ │ │ │ │ +bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer, │ │ │ │ │ + void (*pp_callback)(void *buf, unsigned int samples, void *data), │ │ │ │ │ + void *pp_callback_userdata) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sets a post-processing filter function that’s called after the attached streams │ │ │ │ │ have been mixed. The buffer’s format will be whatever the mixer was created │ │ │ │ │ with. The sample count and user-data pointer is also passed. │ │ │ │ │ NNoottee:: The callback is called from a dedicated audio thread. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ * _e_x___m_i_x_e_r___p_p_._c │ │ │ │ │ ************ MMiisscceellaanneeoouuss ************ │ │ │ │ │ ********** AALLLLEEGGRROO__AAUUDDIIOO__DDEEPPTTHH ********** │ │ │ │ │ enum ALLEGRO_AUDIO_DEPTH │ │ │ │ │ +enum ALLEGRO_AUDIO_DEPTH │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sample depth and type as well as signedness. Mixers only use 32-bit signed │ │ │ │ │ float (-1..+1), or 16-bit signed integers. Signedness is determined by an │ │ │ │ │ “unsigned” bit-flag applied to the depth value. │ │ │ │ │ * ALLEGRO_AUDIO_DEPTH_INT8 │ │ │ │ │ * ALLEGRO_AUDIO_DEPTH_INT16 │ │ │ │ │ * ALLEGRO_AUDIO_DEPTH_INT24 │ │ │ │ │ @@ -1957,28 +2150,30 @@ │ │ │ │ │ * ALLEGRO_AUDIO_DEPTH_UINT24 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ ********** AALLLLEEGGRROO__AAUUDDIIOO__PPAANN__NNOONNEE ********** │ │ │ │ │ #define ALLEGRO_AUDIO_PAN_NONE (-1000.0f) │ │ │ │ │ +#define ALLEGRO_AUDIO_PAN_NONE (-1000.0f) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A special value for the pan property of sample instances and audio streams. Use │ │ │ │ │ this value to disable panning on sample instances and audio streams, and play │ │ │ │ │ them without attentuation implied by panning support. │ │ │ │ │ ALLEGRO_AUDIO_PAN_NONE is different from a pan value of 0.0 (centered) because, │ │ │ │ │ when panning is enabled, we try to maintain a constant sound power level as a │ │ │ │ │ sample is panned from left to right. A sound coming out of one speaker should │ │ │ │ │ sound as loud as it does when split over two speakers. As a consequence, a │ │ │ │ │ sample with pan value 0.0 will be 3 dB softer than the original level. │ │ │ │ │ (Please correct us if this is wrong.) │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_u_d_i_o___p_r_o_p_s_._c_p_p │ │ │ │ │ ********** AALLLLEEGGRROO__CCHHAANNNNEELL__CCOONNFF ********** │ │ │ │ │ enum ALLEGRO_CHANNEL_CONF │ │ │ │ │ +enum ALLEGRO_CHANNEL_CONF │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Speaker configuration (mono, stereo, 2.1, etc). │ │ │ │ │ * ALLEGRO_CHANNEL_CONF_1 │ │ │ │ │ * ALLEGRO_CHANNEL_CONF_2 │ │ │ │ │ * ALLEGRO_CHANNEL_CONF_3 │ │ │ │ │ * ALLEGRO_CHANNEL_CONF_4 │ │ │ │ │ * ALLEGRO_CHANNEL_CONF_5_1 │ │ │ │ │ @@ -1986,14 +2181,15 @@ │ │ │ │ │ * ALLEGRO_CHANNEL_CONF_7_1 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___a_c_o_d_e_c___m_u_l_t_i_._c │ │ │ │ │ ********** AALLLLEEGGRROO__PPLLAAYYMMOODDEE ********** │ │ │ │ │ enum ALLEGRO_PLAYMODE │ │ │ │ │ +enum ALLEGRO_PLAYMODE │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sample and stream playback mode. │ │ │ │ │ * ALLEGRO_PLAYMODE_ONCE - the sample/stream is played from start to finish │ │ │ │ │ an then it stops. │ │ │ │ │ * ALLEGRO_PLAYMODE_LOOP - the sample/stream is played from start to finish │ │ │ │ │ (or between the two loop points). When it reaches the end, it restarts │ │ │ │ │ from the beginning. │ │ │ │ │ @@ -2006,14 +2202,15 @@ │ │ │ │ │ for streams. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_t_r_e_a_m___f_i_l_e_._c │ │ │ │ │ * _e_x___k_c_m___d_i_r_e_c_t_._c │ │ │ │ │ * _e_x___m_i_x_e_r___c_h_a_i_n_._c │ │ │ │ │ ********** AALLLLEEGGRROO__AAUUDDIIOO__EEVVEENNTT__TTYYPPEE ********** │ │ │ │ │ enum ALLEGRO_AUDIO_EVENT_TYPE │ │ │ │ │ +enum ALLEGRO_AUDIO_EVENT_TYPE │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Events sent by _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___e_v_e_n_t___s_o_u_r_c_e or │ │ │ │ │ _a_l___g_e_t___a_u_d_i_o___r_e_c_o_r_d_e_r___e_v_e_n_t___s_o_u_r_c_e. │ │ │ │ │ ******** AALLLLEEGGRROO__EEVVEENNTT__AAUUDDIIOO__SSTTRREEAAMM__FFRRAAGGMMEENNTT ******** │ │ │ │ │ Sent when a stream fragment is ready to be filled in. See │ │ │ │ │ _a_l___g_e_t___a_u_d_i_o___s_t_r_e_a_m___f_r_a_g_m_e_n_t. │ │ │ │ │ ******** AALLLLEEGGRROO__EEVVEENNTT__AAUUDDIIOO__SSTTRREEAAMM__FFIINNIISSHHEEDD ******** │ │ │ │ │ @@ -2023,34 +2220,39 @@ │ │ │ │ │ to _A_L_L_E_G_R_O___A_U_D_I_O___R_E_C_O_R_D_E_R___E_V_E_N_T via _a_l___g_e_t___a_u_d_i_o___r_e_c_o_r_d_e_r___e_v_e_n_t. │ │ │ │ │ You must always check the values for the buffer and samples as they are not │ │ │ │ │ guaranteed to be exactly what was originally specified. │ │ │ │ │ Since: 5.1.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: The API may need a slight redesign. │ │ │ │ │ ********** aall__ggeett__aalllleeggrroo__aauuddiioo__vveerrssiioonn ********** │ │ │ │ │ uint32_t al_get_allegro_audio_version(void) │ │ │ │ │ +uint32_t al_get_allegro_audio_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ ********** aall__ggeett__aauuddiioo__ddeepptthh__ssiizzee ********** │ │ │ │ │ size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth) │ │ │ │ │ +size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the size of a sample, in bytes, for the given format. The format is one │ │ │ │ │ of the values listed under _A_L_L_E_G_R_O___A_U_D_I_O___D_E_P_T_H. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ ********** aall__ggeett__cchhaannnneell__ccoouunntt ********** │ │ │ │ │ size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf) │ │ │ │ │ +size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the number of channels for the given channel configuration, which is one │ │ │ │ │ of the values listed under _A_L_L_E_G_R_O___C_H_A_N_N_E_L___C_O_N_F. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___a_c_o_d_e_c_._c │ │ │ │ │ ********** aall__ffiillll__ssiilleennccee ********** │ │ │ │ │ void al_fill_silence(void *buf, unsigned int samples, │ │ │ │ │ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +void al_fill_silence(void *buf, unsigned int samples, │ │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Fill a buffer with silence, for the given format and channel configuration. The │ │ │ │ │ buffer must have enough space for the given number of samples, and be properly │ │ │ │ │ aligned. │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/color.html │ │ │ │ @@ -263,15 +263,16 @@ │ │ │ │ between the three color channels into account as well. In general, most │ │ │ │ monitors nowadays try to be close to the sRGB specification. And so if │ │ │ │ in an Allegro game you display something with color

    │ │ │ │

    al_map_rgb_f(0.5, 0.5, 0,5)

    │ │ │ │

    then it will appear at about half brightness (even though the actual │ │ │ │ brightness output of the monitor will be less than half).

    │ │ │ │

    al_color_cmyk

    │ │ │ │ -
    ALLEGRO_COLOR al_color_cmyk(float c, float m, float y, float k)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_cmyk(float c, float m, float y, float k)
│ │ │ │ +ALLEGRO_COLOR al_color_cmyk(float c, float m, float y, float k)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from CMYK values (cyan, magenta, yellow, black).

    │ │ │ │

    See also: al_color_cmyk_to_rgb, Examples:

    │ │ │ │ │ │ │ │

    al_color_cmyk_to_rgb

    │ │ │ │ 
    void al_color_cmyk_to_rgb(float cyan, float magenta, float yellow,
│ │ │ │ -    float key, float *red, float *green, float *blue)
    │ │ │ │ + float key, float *red, float *green, float *blue) │ │ │ │ +void al_color_cmyk_to_rgb(float cyan, float magenta, float yellow, │ │ │ │ + float key, float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert CMYK values to RGB values.

    │ │ │ │

    See also: al_color_cmyk, al_color_rgb_to_cmyk

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_hsl

    │ │ │ │ -
    ALLEGRO_COLOR al_color_hsl(float h, float s, float l)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_hsl(float h, float s, float l)
│ │ │ │ +ALLEGRO_COLOR al_color_hsl(float h, float s, float l)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from HSL (hue, saturation, lightness) values.

    │ │ │ │

    Parameters:

    │ │ │ │
      │ │ │ │ @@ -318,15 +322,17 @@ │ │ │ │
    • ex_clip.c
      • │ │ │ │
    • ex_palette.c
      • │ │ │ │
    │ │ │ │

    al_color_hsl_to_rgb

    │ │ │ │ 
    void al_color_hsl_to_rgb(float hue, float saturation, float lightness,
│ │ │ │ -   float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_hsl_to_rgb(float hue, float saturation, float lightness, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert values in HSL color model to RGB color model.

    │ │ │ │

    Parameters:

    │ │ │ │
      │ │ │ │
    • hue - Color hue angle in the range 0..360
      • │ │ │ │ @@ -342,15 +348,16 @@ │ │ │ │ │ │ │ │

      al_color_hsv

      │ │ │ │ -
      ALLEGRO_COLOR al_color_hsv(float h, float s, float v)
      │ │ │ │ +
      ALLEGRO_COLOR al_color_hsv(float h, float s, float v)
│ │ │ │ +ALLEGRO_COLOR al_color_hsv(float h, float s, float v)
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Return an ALLEGRO_COLOR │ │ │ │ structure from HSV (hue, saturation, value) values.

      │ │ │ │

      Parameters:

      │ │ │ │ │ │ │ │

      al_color_hsv_to_rgb

      │ │ │ │ 
      void al_color_hsv_to_rgb(float hue, float saturation, float value,
│ │ │ │ -   float *red, float *green, float *blue)
      │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_hsv_to_rgb(float hue, float saturation, float value, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Convert values in HSV color model to RGB color model.

      │ │ │ │

      Parameters:

      │ │ │ │
        │ │ │ │
      • hue - Color hue angle in the range 0..360
        • │ │ │ │ @@ -390,15 +399,16 @@ │ │ │ │ href="color.html#al_color_hsl_to_rgb">al_color_hsl_to_rgb

        │ │ │ │

        Examples:

        │ │ │ │ │ │ │ │

        al_color_html

        │ │ │ │ -
        ALLEGRO_COLOR al_color_html(char const *string)
        │ │ │ │ +
        ALLEGRO_COLOR al_color_html(char const *string)
│ │ │ │ +ALLEGRO_COLOR al_color_html(char const *string)
        │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Interprets an HTML-style hex number (e.g. #00faff) as a color. The │ │ │ │ accepted format is the same as al_color_html_to_rgb.

        │ │ │ │

        Returns the interpreted color, or │ │ │ │ @@ -409,15 +419,17 @@ │ │ │ │ Allegro 5.0.x.

        │ │ │ │
    │ │ │ │

    See also: al_color_html_to_rgb, al_color_rgb_to_html

    │ │ │ │

    al_color_html_to_rgb

    │ │ │ │ 
    bool al_color_html_to_rgb(char const *string,
│ │ │ │ -   float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +bool al_color_html_to_rgb(char const *string, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Interprets an HTML-style hex number (e.g. #00faff) as a color. The │ │ │ │ only accepted formats are “#RRGGBB” and “RRGGBB” where R, G, B are │ │ │ │ hexadecimal digits [0-9A-Fa-f].

    │ │ │ │

    Returns true on success, false on failure. On failure all components │ │ │ │ @@ -426,15 +438,17 @@ │ │ │ │

    Note: the behaviour on invalid strings is different from │ │ │ │ Allegro 5.0.x.

    │ │ │ │
    │ │ │ │

    See also: al_color_html, al_color_rgb_to_html

    │ │ │ │

    al_color_rgb_to_html

    │ │ │ │ 
    void al_color_rgb_to_html(float red, float green, float blue,
│ │ │ │ -    char *string)
    │ │ │ │ + char *string) │ │ │ │ +void al_color_rgb_to_html(float red, float green, float blue, │ │ │ │ + char *string) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Create an HTML-style string representation of an ALLEGRO_COLOR, e.g. #00faff.

    │ │ │ │

    Parameters:

    │ │ │ │
      │ │ │ │ @@ -450,15 +464,16 @@ │ │ │ │ href="color.html#al_color_html_to_rgb">al_color_html_to_rgb

      │ │ │ │

      Examples:

      │ │ │ │ │ │ │ │

      al_color_name

      │ │ │ │ -
      ALLEGRO_COLOR al_color_name(char const *name)
      │ │ │ │ +
      ALLEGRO_COLOR al_color_name(char const *name)
│ │ │ │ +ALLEGRO_COLOR al_color_name(char const *name)
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Return an ALLEGRO_COLOR │ │ │ │ with the given name. If the color is not found then black is │ │ │ │ returned.

      │ │ │ │

      See ex_drag_and_drop.c │ │ │ │

    • ex_multisample_target.c
      • │ │ │ │
    • ex_clip.c
      • │ │ │ │
    │ │ │ │

    al_color_name_to_rgb

    │ │ │ │ -
    bool al_color_name_to_rgb(char const *name, float *r, float *g, float *b)
    │ │ │ │ +
    bool al_color_name_to_rgb(char const *name, float *r, float *g, float *b)
│ │ │ │ +bool al_color_name_to_rgb(char const *name, float *r, float *g, float *b)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Parameters:

    │ │ │ │
      │ │ │ │
    • name - The (lowercase) name of the color.
      • │ │ │ │
    • r, g, b - If one of the recognized color names below is passed, the │ │ │ │ @@ -518,15 +534,17 @@ │ │ │ │ lightgray = lightgrey, lightslategray = lightslategrey, slategray = │ │ │ │ slategrey

      │ │ │ │

      Returns: true if a name from the list above was passed, else │ │ │ │ false.

      │ │ │ │

      See also: al_color_name

      │ │ │ │

      al_color_rgb_to_cmyk

      │ │ │ │ 
      void al_color_rgb_to_cmyk(float red, float green, float blue,
│ │ │ │ -   float *cyan, float *magenta, float *yellow, float *key)
      │ │ │ │ + float *cyan, float *magenta, float *yellow, float *key) │ │ │ │ +void al_color_rgb_to_cmyk(float red, float green, float blue, │ │ │ │ + float *cyan, float *magenta, float *yellow, float *key) │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Each RGB color can be represented in CMYK with a K component of 0 │ │ │ │ with the following formula:

      │ │ │ │ 
      C = 1 - R
│ │ │ │  M = 1 - G
│ │ │ │ @@ -539,15 +557,17 @@
│ │ │ │  
      Examples:
      
│ │ │ │  
│ │ │ │  
      al_color_rgb_to_hsl
      
│ │ │ │  
      void al_color_rgb_to_hsl(float red, float green, float blue,
│ │ │ │ -   float *hue, float *saturation, float *lightness)
      
│ │ │ │ +   float *hue, float *saturation, float *lightness)
│ │ │ │ +void al_color_rgb_to_hsl(float red, float green, float blue,
│ │ │ │ +   float *hue, float *saturation, float *lightness)
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Given an RGB triplet with components in the range 0..1, return the │ │ │ │ hue in degrees from 0..360 and saturation and lightness in the range │ │ │ │ 0..1.

      │ │ │ │

      See also: ex_color.cpp

      • │ │ │ │
    • ex_palette.c
      • │ │ │ │
    │ │ │ │

    al_color_rgb_to_hsv

    │ │ │ │ 
    void al_color_rgb_to_hsv(float red, float green, float blue,
│ │ │ │ -   float *hue, float *saturation, float *value)
    │ │ │ │ + float *hue, float *saturation, float *value) │ │ │ │ +void al_color_rgb_to_hsv(float red, float green, float blue, │ │ │ │ + float *hue, float *saturation, float *value) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Given an RGB triplet with components in the range 0..1, return the │ │ │ │ hue in degrees from 0..360 and saturation and value in the range │ │ │ │ 0..1.

    │ │ │ │

    See also: │ │ │ │

  • ex_color.cpp
    • │ │ │ │
  • ex_color_gradient.c
    • │ │ │ │ │ │ │ │

    al_color_rgb_to_name

    │ │ │ │ -
    char const *al_color_rgb_to_name(float r, float g, float b)
    │ │ │ │ +
    char const *al_color_rgb_to_name(float r, float g, float b)
│ │ │ │ +char const *al_color_rgb_to_name(float r, float g, float b)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Given an RGB triplet with components in the range 0..1, find a color │ │ │ │ name describing it approximately.

    │ │ │ │

    See also: al_color_name_to_rgb, Examples:

    │ │ │ │ │ │ │ │

    al_color_rgb_to_xyz

    │ │ │ │ 
    void al_color_rgb_to_xyz(float red, float green, float blue,
│ │ │ │ -   float *x, float *y, float *z)
    │ │ │ │ + float *x, float *y, float *z) │ │ │ │ +void al_color_rgb_to_xyz(float red, float green, float blue, │ │ │ │ + float *x, float *y, float *z) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert RGB values to XYZ color space.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_xyz, al_color_xyz_to_rgb

    │ │ │ │

    al_color_xyz

    │ │ │ │ -
    ALLEGRO_COLOR al_color_xyz(float x, float y, float z)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_xyz(float x, float y, float z)
│ │ │ │ +ALLEGRO_COLOR al_color_xyz(float x, float y, float z)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from XYZ values. The CIE 1931 XYZ color space consists of │ │ │ │ three components in the range 0..1. The Y component corresponds to │ │ │ │ luminance and the X and Z components define the color.

    │ │ │ │ @@ -623,34 +649,39 @@ │ │ │ │
    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_xyz_to_rgb, al_color_rgb_to_xyz

    │ │ │ │

    al_color_xyz_to_rgb

    │ │ │ │ 
    void al_color_xyz_to_rgb(float x, float y, float z,
│ │ │ │ -    float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_xyz_to_rgb(float x, float y, float z, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert XYZ color values to RGB color space.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_xyz, al_color_rgb_to_xyz

    │ │ │ │

    al_color_rgb_to_xyy

    │ │ │ │ 
    void al_color_rgb_to_xyy(float red, float green, float blue,
│ │ │ │ -   float *x, float *y, float *y2)
    │ │ │ │ + float *x, float *y, float *y2) │ │ │ │ +void al_color_rgb_to_xyy(float red, float green, float blue, │ │ │ │ + float *x, float *y, float *y2) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert RGB values to xyY color space.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_xyy, al_color_xyy_to_rgb

    │ │ │ │

    al_color_xyy

    │ │ │ │ -
    ALLEGRO_COLOR al_color_xyy(float x, float y, float y2)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_xyy(float x, float y, float y2)
│ │ │ │ +ALLEGRO_COLOR al_color_xyy(float x, float y, float y2)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from xyY values. The Y component in the xyY color space is the │ │ │ │ same as the Y in XYZ.

    │ │ │ │

    However the x and y values are computed from XYZ like this:

    │ │ │ │ @@ -658,39 +689,44 @@ │ │ │ │ y = Y / (X + Y + Z) │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_xyy_to_rgb, al_color_rgb_to_xyy

    │ │ │ │

    al_color_xyy_to_rgb

    │ │ │ │ 
    void al_color_xyy_to_rgb(float x, float y, float y2,
│ │ │ │ -    float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_xyy_to_rgb(float x, float y, float y2, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert xyY color values to RGB color space.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_xyy, al_color_rgb_to_xyy

    │ │ │ │

    al_color_rgb_to_lab

    │ │ │ │ 
    void al_color_rgb_to_lab(float red, float green, float blue,
│ │ │ │ -   float *l, float *a, float *b)
    │ │ │ │ + float *l, float *a, float *b) │ │ │ │ +void al_color_rgb_to_lab(float red, float green, float blue, │ │ │ │ + float *l, float *a, float *b) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert RGB values to L*a*b* color space.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_lab, al_color_lab_to_rgb

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_lab

    │ │ │ │ -
    ALLEGRO_COLOR al_color_lab(float l, float a, float b)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_lab(float l, float a, float b)
│ │ │ │ +ALLEGRO_COLOR al_color_lab(float l, float a, float b)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from CIE L*a*b* values. The L* component corresponds to │ │ │ │ luminance from 0..1. The a* and b* components are in the range │ │ │ │ -1..+1.

    │ │ │ │ @@ -716,44 +752,49 @@ │ │ │ │
  • ex_color2.c
    • │ │ │ │
  • ex_color_gradient.c
    • │ │ │ │ │ │ │ │

    al_color_lab_to_rgb

    │ │ │ │ 
    void al_color_lab_to_rgb(float l, float a, float b,
│ │ │ │ -    float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_lab_to_rgb(float l, float a, float b, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert CIE L*a*b* color values to RGB color space.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_lab, al_color_rgb_to_lab

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_rgb_to_lch

    │ │ │ │ 
    void al_color_rgb_to_lch(float red, float green, float blue,
│ │ │ │ -   float *l, float *c, float *h)
    │ │ │ │ + float *l, float *c, float *h) │ │ │ │ +void al_color_rgb_to_lch(float red, float green, float blue, │ │ │ │ + float *l, float *c, float *h) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert RGB values to CIE LCH color space.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_lch, al_color_lch_to_rgb

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_lch

    │ │ │ │ -
    ALLEGRO_COLOR al_color_lch(float l, float c, float h)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_lch(float l, float c, float h)
│ │ │ │ +ALLEGRO_COLOR al_color_lch(float l, float c, float h)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from CIE LCH values. LCH colors are very similar to HSL, with │ │ │ │ the same meaning of L and H and C corresponding to S. However LCH is │ │ │ │ more visually uniform. Furthermore, this function expects the angle for │ │ │ │ @@ -770,30 +811,34 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_lch_to_rgb

    │ │ │ │ 
    void al_color_lch_to_rgb(float l, float c, float h,
│ │ │ │ -    float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_lch_to_rgb(float l, float c, float h, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert CIE LCH color values to RGB color space.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    See also: al_color_lch, al_color_rgb_to_lch

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_distance_ciede2000

    │ │ │ │ 
    double al_color_distance_ciede2000(ALLEGRO_COLOR color1,
│ │ │ │ -      ALLEGRO_COLOR color2) {
    │ │ │ │ + ALLEGRO_COLOR color2) { │ │ │ │ +double al_color_distance_ciede2000(ALLEGRO_COLOR color1, │ │ │ │ + ALLEGRO_COLOR color2) { │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This function computes the CIEDE2000 color difference between two RGB │ │ │ │ colors. This is a visually uniform color difference, unlike for example │ │ │ │ the RGB distance.

    │ │ │ │

    When using the RGB distance (Euklidean distance between two RGB │ │ │ │ @@ -816,28 +861,30 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_rgb_to_yuv

    │ │ │ │ 
    void al_color_rgb_to_yuv(float red, float green, float blue,
│ │ │ │ -   float *y, float *u, float *v)
    │ │ │ │ +void al_color_rgb_to_yuv(float red, float green, float blue, │ │ │ │ + float *y, float *u, float *v) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert RGB values to YUV color space.

    │ │ │ │

    See also: al_color_yuv, al_color_yuv_to_rgb

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_yuv

    │ │ │ │ -
    ALLEGRO_COLOR al_color_yuv(float y, float u, float v)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_yuv(float y, float u, float v)
│ │ │ │ +ALLEGRO_COLOR al_color_yuv(float y, float u, float v)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from YUV values.

    │ │ │ │

    See also: al_color_yuv_to_rgb, Examples:

    │ │ │ │ │ │ │ │

    al_color_yuv_to_rgb

    │ │ │ │ 
    void al_color_yuv_to_rgb(float y, float u, float v,
│ │ │ │ -    float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_yuv_to_rgb(float y, float u, float v, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert YUV color values to RGB color space.

    │ │ │ │

    See also: al_color_yuv, al_color_rgb_to_yuv

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_allegro_color_version

    │ │ │ │ -
    uint32_t al_get_allegro_color_version(void)
    │ │ │ │ +
    uint32_t al_get_allegro_color_version(void)
│ │ │ │ +uint32_t al_get_allegro_color_version(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

    │ │ │ │

    al_is_color_valid

    │ │ │ │

    Source Code

    │ │ │ │

    Checks if all components of the color are between 0 and 1. Some of │ │ │ │ the color conversions in this addon support color spaces with more │ │ │ │ colors than can be represented in sRGB and when converted to RGB will │ │ │ │ result in invalid color components outside the 0..1 range.

    │ │ │ │

    Since: 5.2.3

    │ │ │ │

    al_color_rgb_to_oklab

    │ │ │ │ 
    void al_color_rgb_to_oklab(float red, float green, float blue,
│ │ │ │ -   float *ol, float *oa, float *ob)
    │ │ │ │ + float *ol, float *oa, float *ob) │ │ │ │ +void al_color_rgb_to_oklab(float red, float green, float blue, │ │ │ │ + float *ol, float *oa, float *ob) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert RGB values to the Oklab color space.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    See also: al_color_oklab, al_color_oklab_to_rgb

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_oklab

    │ │ │ │ -
    ALLEGRO_COLOR al_color_oklab(float l, float a, float b)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_oklab(float l, float a, float b)
│ │ │ │ +ALLEGRO_COLOR al_color_oklab(float l, float a, float b)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from Oklab values. The L component corresponds to luminance │ │ │ │ from 0..1. The a and b components are in the range -1..+1.

    │ │ │ │
    │ │ │ │ @@ -912,25 +965,29 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_oklab_to_rgb

    │ │ │ │ 
    void al_color_oklab_to_rgb(float ol, float oa, float ob,
│ │ │ │ -    float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_oklab_to_rgb(float ol, float oa, float ob, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert Oklab color values to RGB.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    See also: al_color_oklab, al_color_rgb_to_oklab

    │ │ │ │

    al_color_rgb_to_linear

    │ │ │ │ 
    void al_color_rgb_to_linear(float red, float green, float blue,
│ │ │ │ -   float *r, float *g, float *b)
    │ │ │ │ + float *r, float *g, float *b) │ │ │ │ +void al_color_rgb_to_linear(float red, float green, float blue, │ │ │ │ + float *r, float *g, float *b) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert gamma corrected sRGB values (i.e. normal RGB) to linear sRGB │ │ │ │ space.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    See also: al_color_linear, │ │ │ │ @@ -938,15 +995,16 @@ │ │ │ │ href="color.html#al_color_linear_to_rgb">al_color_linear_to_rgb

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_linear

    │ │ │ │ -
    ALLEGRO_COLOR al_color_linear(float r, float g, float b)
    │ │ │ │ +
    ALLEGRO_COLOR al_color_linear(float r, float g, float b)
│ │ │ │ +ALLEGRO_COLOR al_color_linear(float r, float g, float b)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Return an ALLEGRO_COLOR │ │ │ │ structure from linear sRGB values. Allegro RGB values are assumed to be │ │ │ │ sRGB. The sRGB standard is in wide use by various display devices. It │ │ │ │ accounts for a standard gamma correction applied to RGB colors before │ │ │ │ @@ -970,15 +1028,17 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_color_linear_to_rgb

    │ │ │ │ 
    void al_color_linear_to_rgb(float r, float g, float b,
│ │ │ │ -    float *red, float *green, float *blue)
    │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ +void al_color_linear_to_rgb(float r, float g, float b, │ │ │ │ + float *red, float *green, float *blue) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Convert linear sRGB color values to gamma corrected (i.e. normal) RGB │ │ │ │ values.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    See also: [al_color_linera], │ │ │ │ 

    ALLEGRO_CONFIG* cfg = al_load_config_file("test.cfg");
│ │ │ │  printf("%s\n", al_get_config_value(cfg, "", "monster name")); /* Prints: Allegro Developer */
│ │ │ │  printf("%s\n", al_get_config_value(cfg, "weapon 0", "damage")); /* Prints: 443 */
│ │ │ │  printf("%s\n", al_get_config_value(cfg, "weapon 1", "damage")); /* Prints: 503 */
│ │ │ │  al_destroy_config(cfg);
    │ │ │ │

    ALLEGRO_CONFIG

    │ │ │ │ -
    typedef struct ALLEGRO_CONFIG ALLEGRO_CONFIG;
    │ │ │ │ +
    typedef struct ALLEGRO_CONFIG ALLEGRO_CONFIG;
│ │ │ │ +typedef struct ALLEGRO_CONFIG ALLEGRO_CONFIG;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An abstract configuration structure.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    ALLEGRO_CONFIG_SECTION

    │ │ │ │ -
    typedef struct ALLEGRO_CONFIG_SECTION ALLEGRO_CONFIG_SECTION;
    │ │ │ │ +
    typedef struct ALLEGRO_CONFIG_SECTION ALLEGRO_CONFIG_SECTION;
│ │ │ │ +typedef struct ALLEGRO_CONFIG_SECTION ALLEGRO_CONFIG_SECTION;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An opaque structure used for iterating across sections in a │ │ │ │ configuration structure.

    │ │ │ │

    See also: al_get_first_config_section, │ │ │ │ @@ -284,15 +286,16 @@ │ │ │ │ href="config.html#al_get_next_config_section">al_get_next_config_section

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    ALLEGRO_CONFIG_ENTRY

    │ │ │ │ -
    typedef struct ALLEGRO_CONFIG_ENTRY ALLEGRO_CONFIG_ENTRY;
    │ │ │ │ +
    typedef struct ALLEGRO_CONFIG_ENTRY ALLEGRO_CONFIG_ENTRY;
│ │ │ │ +typedef struct ALLEGRO_CONFIG_ENTRY ALLEGRO_CONFIG_ENTRY;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An opaque structure used for iterating across entries in a │ │ │ │ configuration section.

    │ │ │ │

    See also: al_get_first_config_entry, │ │ │ │ @@ -587,14 +590,11 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L515">Source │ │ │ │ Code

    │ │ │ │

    Merge one configuration structure into another. Values in │ │ │ │ configuration ‘add’ override those in ‘master’. ‘master’ is modified. │ │ │ │ Comments from ‘add’ are not retained.

    │ │ │ │

    See also: al_merge_config

    │ │ │ │ -

    │ │ │ │ -Allegro version 5.2.10 │ │ │ │ - - Last updated: 2025-01-09 13:52:42 UTC │ │ │ │ -

    │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -101,30 +101,33 @@ │ │ │ │ │ printf("%s\n", al_get_config_value(cfg, "weapon 0", "damage")); /* Prints: 443 │ │ │ │ │ */ │ │ │ │ │ printf("%s\n", al_get_config_value(cfg, "weapon 1", "damage")); /* Prints: 503 │ │ │ │ │ */ │ │ │ │ │ al_destroy_config(cfg); │ │ │ │ │ ************ AALLLLEEGGRROO__CCOONNFFIIGG ************ │ │ │ │ │ typedef struct ALLEGRO_CONFIG ALLEGRO_CONFIG; │ │ │ │ │ +typedef struct ALLEGRO_CONFIG ALLEGRO_CONFIG; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An abstract configuration structure. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___c_o_n_f_i_g_._c │ │ │ │ │ * _e_x___v_s_y_n_c_._c │ │ │ │ │ * _e_x___s_t_r_e_a_m___s_e_e_k_._c │ │ │ │ │ ************ AALLLLEEGGRROO__CCOONNFFIIGG__SSEECCTTIIOONN ************ │ │ │ │ │ typedef struct ALLEGRO_CONFIG_SECTION ALLEGRO_CONFIG_SECTION; │ │ │ │ │ +typedef struct ALLEGRO_CONFIG_SECTION ALLEGRO_CONFIG_SECTION; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An opaque structure used for iterating across sections in a configuration │ │ │ │ │ structure. │ │ │ │ │ See also: _a_l___g_e_t___f_i_r_s_t___c_o_n_f_i_g___s_e_c_t_i_o_n, _a_l___g_e_t___n_e_x_t___c_o_n_f_i_g___s_e_c_t_i_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___c_o_n_f_i_g_._c │ │ │ │ │ ************ AALLLLEEGGRROO__CCOONNFFIIGG__EENNTTRRYY ************ │ │ │ │ │ typedef struct ALLEGRO_CONFIG_ENTRY ALLEGRO_CONFIG_ENTRY; │ │ │ │ │ +typedef struct ALLEGRO_CONFIG_ENTRY ALLEGRO_CONFIG_ENTRY; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An opaque structure used for iterating across entries in a configuration │ │ │ │ │ section. │ │ │ │ │ See also: _a_l___g_e_t___f_i_r_s_t___c_o_n_f_i_g___e_n_t_r_y, _a_l___g_e_t___n_e_x_t___c_o_n_f_i_g___e_n_t_r_y │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___c_o_n_f_i_g_._c │ │ │ │ │ ************ aall__ccrreeaattee__ccoonnffiigg ************ │ │ │ │ │ @@ -293,8 +296,7 @@ │ │ │ │ │ ************ aall__mmeerrggee__ccoonnffiigg__iinnttoo ************ │ │ │ │ │ void al_merge_config_into(ALLEGRO_CONFIG *master, const ALLEGRO_CONFIG *add) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Merge one configuration structure into another. Values in configuration ‘add’ │ │ │ │ │ override those in ‘master’. ‘master’ is modified. Comments from ‘add’ are not │ │ │ │ │ retained. │ │ │ │ │ See also: _a_l___m_e_r_g_e___c_o_n_f_i_g │ │ │ │ │ -Allegro version 5.2.10 - Last updated: 2025-01-09 13:52:42 UTC │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/display.html │ │ │ │ @@ -340,15 +340,16 @@ │ │ │ │ example.

    │ │ │ │

    In order to write a well-behaved application, it is necessary to │ │ │ │ remember that displays will also inform you about important events via their event sources.

    │ │ │ │

    Display creation

    │ │ │ │

    ALLEGRO_DISPLAY

    │ │ │ │ -
    typedef struct ALLEGRO_DISPLAY ALLEGRO_DISPLAY;
    │ │ │ │ +
    typedef struct ALLEGRO_DISPLAY ALLEGRO_DISPLAY;
│ │ │ │ +typedef struct ALLEGRO_DISPLAY ALLEGRO_DISPLAY;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An opaque type representing an open display or window.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE

    │ │ │ │ -
    #define ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE 255
    │ │ │ │ +
    #define ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE 255
│ │ │ │ +#define ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE 255
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This is the maximum size of the title that can be set with al_set_new_window_title.

    │ │ │ │

    See also: al_set_new_window_title

    │ │ │ │ @@ -1637,14 +1639,11 @@ │ │ │ │ href="display.html#al_set_clipboard_text">al_set_clipboard_text, al_get_clipboard_text

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │ -

    │ │ │ │ -Allegro version 5.2.10 │ │ │ │ - - Last updated: 2025-01-09 13:52:42 UTC │ │ │ │ -

    │ │ │ │ + │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -126,14 +126,15 @@ │ │ │ │ │ provides integration for both (see the OpenGL / Direct3D sections), so you can │ │ │ │ │ retrieve the underlying textures of _A_L_L_E_G_R_O___B_I_T_M_A_Ps, for example. │ │ │ │ │ In order to write a well-behaved application, it is necessary to remember that │ │ │ │ │ displays will also inform you about important _e_v_e_n_t_s via their _e_v_e_n_t_ _s_o_u_r_c_e_s. │ │ │ │ │ ************ DDiissppllaayy ccrreeaattiioonn ************ │ │ │ │ │ ********** AALLLLEEGGRROO__DDIISSPPLLAAYY ********** │ │ │ │ │ typedef struct ALLEGRO_DISPLAY ALLEGRO_DISPLAY; │ │ │ │ │ +typedef struct ALLEGRO_DISPLAY ALLEGRO_DISPLAY; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An opaque type representing an open display or window. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_o_n_i_t_o_r_i_n_f_o_._c │ │ │ │ │ * _e_x___d_3_d_._c_p_p │ │ │ │ │ * _e_x___k_e_y_b_o_a_r_d___f_o_c_u_s_._c │ │ │ │ │ ********** aall__ccrreeaattee__ddiissppllaayy ********** │ │ │ │ │ @@ -753,30 +754,31 @@ │ │ │ │ │ ********** aall__sseett__wwiinnddooww__ttiittllee ********** │ │ │ │ │ void al_set_window_title(ALLEGRO_DISPLAY *display, const char *title) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the title on a display. │ │ │ │ │ See also: _a_l___s_e_t___d_i_s_p_l_a_y___i_c_o_n, _a_l___s_e_t___d_i_s_p_l_a_y___i_c_o_n_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___i_c_o_n_._c │ │ │ │ │ - * _e_x___w_i_n_d_o_w___t_i_t_l_e_._c │ │ │ │ │ * _e_x___b_i_t_m_a_p_._c │ │ │ │ │ + * _e_x___o_g_r_e_3_d_._c_p_p │ │ │ │ │ ********** aall__sseett__nneeww__wwiinnddooww__ttiittllee ********** │ │ │ │ │ void al_set_new_window_title(const char *title) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Set the title that will be used when a new display is created. Allegro uses a │ │ │ │ │ static buffer of _A_L_L_E_G_R_O___N_E_W___W_I_N_D_O_W___T_I_T_L_E___M_A_X___S_I_Z_E to store this, so the length │ │ │ │ │ of the titme you set must be less than this. │ │ │ │ │ See also: _a_l___s_e_t___w_i_n_d_o_w___t_i_t_l_e, _a_l___g_e_t___n_e_w___w_i_n_d_o_w___t_i_t_l_e, _a_l___c_r_e_a_t_e___d_i_s_p_l_a_y, │ │ │ │ │ _A_L_L_E_G_R_O___N_E_W___W_I_N_D_O_W___T_I_T_L_E___M_A_X___S_I_Z_E │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___w_i_n_d_o_w___t_i_t_l_e_._c │ │ │ │ │ * _e_x___w_i_n_d_o_w_s_._c │ │ │ │ │ ********** AALLLLEEGGRROO__NNEEWW__WWIINNDDOOWW__TTIITTLLEE__MMAAXX__SSIIZZEE ********** │ │ │ │ │ #define ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE 255 │ │ │ │ │ +#define ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE 255 │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This is the maximum size of the title that can be set with │ │ │ │ │ _a_l___s_e_t___n_e_w___w_i_n_d_o_w___t_i_t_l_e. │ │ │ │ │ See also: _a_l___s_e_t___n_e_w___w_i_n_d_o_w___t_i_t_l_e │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ ********** aall__ggeett__nneeww__wwiinnddooww__ttiittllee ********** │ │ │ │ │ const char *al_get_new_window_title(void) │ │ │ │ │ @@ -878,8 +880,7 @@ │ │ │ │ │ bool al_clipboard_has_text(ALLEGRO_DISPLAY *display) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This function returns true if and only if the clipboard has text available. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ See also: _a_l___s_e_t___c_l_i_p_b_o_a_r_d___t_e_x_t, _a_l___g_e_t___c_l_i_p_b_o_a_r_d___t_e_x_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___c_l_i_p_b_o_a_r_d_._c │ │ │ │ │ -Allegro version 5.2.10 - Last updated: 2025-01-09 13:52:42 UTC │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/events.html │ │ │ │ @@ -315,15 +315,16 @@ │ │ │ │ union according to the event type.

    │ │ │ │

    In addition to the events sent by Allegro core, there’s also events │ │ │ │ send by the addons, see ALLEGRO_AUDIO_EVENT_TYPE │ │ │ │ and ALLEGRO_VIDEO_EVENT_TYPE.

    │ │ │ │

    ALLEGRO_EVENT

    │ │ │ │ -
    typedef union ALLEGRO_EVENT ALLEGRO_EVENT;
    │ │ │ │ +
    typedef union ALLEGRO_EVENT ALLEGRO_EVENT;
│ │ │ │ +typedef union ALLEGRO_EVENT ALLEGRO_EVENT;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An ALLEGRO_EVENT is a union of all builtin event structures, i.e. it │ │ │ │ is an object large enough to hold the data of any event type. All events │ │ │ │ have the following fields in common:

    │ │ │ │
    │ │ │ │ @@ -1015,15 +1016,16 @@ │ │ │ │

    Since: 5.2.9

    │ │ │ │
    │ │ │ │

    Unstable │ │ │ │ API: This is an experimental feature and currently only works │ │ │ │ for the X11 backend.

    │ │ │ │
    │ │ │ │

    ALLEGRO_USER_EVENT

    │ │ │ │ -
    typedef struct ALLEGRO_USER_EVENT ALLEGRO_USER_EVENT;
    │ │ │ │ +
    typedef struct ALLEGRO_USER_EVENT ALLEGRO_USER_EVENT;
│ │ │ │ +typedef struct ALLEGRO_USER_EVENT ALLEGRO_USER_EVENT;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An event structure that can be emitted by user event sources. These │ │ │ │ are the public fields:

    │ │ │ │
      │ │ │ │
    • ALLEGRO_EVENT_SOURCE *source;
      • │ │ │ │ @@ -1064,15 +1066,16 @@ │ │ │ │ href="events.html#al_init_user_event_source">al_init_user_event_source

      │ │ │ │

      Examples:

      │ │ │ │ │ │ │ │

      ALLEGRO_EVENT_QUEUE

      │ │ │ │ -
      typedef struct ALLEGRO_EVENT_QUEUE ALLEGRO_EVENT_QUEUE;
      │ │ │ │ +
      typedef struct ALLEGRO_EVENT_QUEUE ALLEGRO_EVENT_QUEUE;
│ │ │ │ +typedef struct ALLEGRO_EVENT_QUEUE ALLEGRO_EVENT_QUEUE;
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      An event queue holds events that have been generated by event sources │ │ │ │ that are registered with the queue. Events are stored in the order they │ │ │ │ are generated. Access is in a strictly FIFO (first-in-first-out) │ │ │ │ order.

      │ │ │ │ @@ -1085,15 +1088,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_inject_events.c#L18">ex_inject_events.c │ │ │ │
    • ex_enet_server.c
      • │ │ │ │
    • ex_timer_pause.c
      • │ │ │ │
    │ │ │ │

    ALLEGRO_EVENT_SOURCE

    │ │ │ │ -
    typedef struct ALLEGRO_EVENT_SOURCE ALLEGRO_EVENT_SOURCE;
    │ │ │ │ +
    typedef struct ALLEGRO_EVENT_SOURCE ALLEGRO_EVENT_SOURCE;
│ │ │ │ +typedef struct ALLEGRO_EVENT_SOURCE ALLEGRO_EVENT_SOURCE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An event source is any object which can generate events. For example, │ │ │ │ an ALLEGRO_DISPLAY can generate events, and you can get the │ │ │ │ ALLEGRO_EVENT_SOURCE pointer from an ALLEGRO_DISPLAY with al_get_display_event_source.

    │ │ │ │ @@ -1108,24 +1112,26 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_inject_events.c#L17">ex_inject_events.c │ │ │ │
  • ex_user_events.c
    • │ │ │ │
  • nihgui.cpp
    • │ │ │ │ │ │ │ │

    ALLEGRO_EVENT_TYPE

    │ │ │ │ -
    typedef unsigned int ALLEGRO_EVENT_TYPE;
    │ │ │ │ +
    typedef unsigned int ALLEGRO_EVENT_TYPE;
│ │ │ │ +typedef unsigned int ALLEGRO_EVENT_TYPE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An integer used to distinguish between different types of events.

    │ │ │ │

    See also: ALLEGRO_EVENT, ALLEGRO_GET_EVENT_TYPE, ALLEGRO_EVENT_TYPE_IS_USER

    │ │ │ │

    ALLEGRO_GET_EVENT_TYPE

    │ │ │ │ -
    #define ALLEGRO_GET_EVENT_TYPE(a, b, c, d)   AL_ID(a, b, c, d)
    │ │ │ │ +
    #define ALLEGRO_GET_EVENT_TYPE(a, b, c, d)   AL_ID(a, b, c, d)
│ │ │ │ +#define ALLEGRO_GET_EVENT_TYPE(a, b, c, d)   AL_ID(a, b, c, d)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Make an event type identifier, which is a 32-bit integer. Usually, │ │ │ │ but not necessarily, this will be made from four 8-bit character codes, │ │ │ │ for example:

    │ │ │ │ 
    Examples:
│ │ │ │ @@ -1152,15 +1158,16 @@
│ │ │ │     MEOW_EVENT,
│ │ │ │     SQUAWK_EVENT
│ │ │ │  };
    │ │ │ │

    See also: ALLEGRO_EVENT, ALLEGRO_USER_EVENT, ALLEGRO_EVENT_TYPE_IS_USER

    │ │ │ │

    ALLEGRO_EVENT_TYPE_IS_USER

    │ │ │ │ -
    #define ALLEGRO_EVENT_TYPE_IS_USER(t)        ((t) >= 512)
    │ │ │ │ +
    #define ALLEGRO_EVENT_TYPE_IS_USER(t)        ((t) >= 512)
│ │ │ │ +#define ALLEGRO_EVENT_TYPE_IS_USER(t)        ((t) >= 512)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A macro which evaluates to true if the event type is not a builtin │ │ │ │ event type, i.e. one of those described in ALLEGRO_EVENT_TYPE.

    │ │ │ │

    al_create_event_queue

    │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -118,14 +118,15 @@ │ │ │ │ │ events that can be generated by user-defined event sources. │ │ │ │ │ The appropriate reaction to an event is determined by examining the fields of │ │ │ │ │ the _A_L_L_E_G_R_O___E_V_E_N_T union according to the event type. │ │ │ │ │ In addition to the events sent by Allegro core, there’s also events send by the │ │ │ │ │ addons, see _A_L_L_E_G_R_O___A_U_D_I_O___E_V_E_N_T___T_Y_P_E and _A_L_L_E_G_R_O___V_I_D_E_O___E_V_E_N_T___T_Y_P_E. │ │ │ │ │ ************ AALLLLEEGGRROO__EEVVEENNTT ************ │ │ │ │ │ typedef union ALLEGRO_EVENT ALLEGRO_EVENT; │ │ │ │ │ +typedef union ALLEGRO_EVENT ALLEGRO_EVENT; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An ALLEGRO_EVENT is a union of all builtin event structures, i.e. it is an │ │ │ │ │ object large enough to hold the data of any event type. All events have the │ │ │ │ │ following fields in common: │ │ │ │ │ type (ALLEGRO_EVENT_TYPE) │ │ │ │ │ Indicates the type of event. │ │ │ │ │ any.source (ALLEGRO_EVENT_SOURCE *) │ │ │ │ │ @@ -496,14 +497,15 @@ │ │ │ │ │ action. If iiss__ccoommpplleettee is set before receiving an event where tteexxtt was │ │ │ │ │ not NULL it means the user aborted the drag&drop. │ │ │ │ │ Since: 5.2.9 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: This is an experimental feature and currently only │ │ │ │ │ works for the X11 backend. │ │ │ │ │ ************ AALLLLEEGGRROO__UUSSEERR__EEVVEENNTT ************ │ │ │ │ │ typedef struct ALLEGRO_USER_EVENT ALLEGRO_USER_EVENT; │ │ │ │ │ +typedef struct ALLEGRO_USER_EVENT ALLEGRO_USER_EVENT; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An event structure that can be emitted by user event sources. These are the │ │ │ │ │ public fields: │ │ │ │ │ * ALLEGRO_EVENT_SOURCE *source; │ │ │ │ │ * intptr_t data1; │ │ │ │ │ * intptr_t data2; │ │ │ │ │ * intptr_t data3; │ │ │ │ │ @@ -531,42 +533,46 @@ │ │ │ │ │ documentation for _A_L_L_E_G_R_O___G_E_T___E_V_E_N_T___T_Y_P_E for the rules you should follow when │ │ │ │ │ assigning identifiers. │ │ │ │ │ See also: _a_l___e_m_i_t___u_s_e_r___e_v_e_n_t, _A_L_L_E_G_R_O___G_E_T___E_V_E_N_T___T_Y_P_E, _a_l___i_n_i_t___u_s_e_r___e_v_e_n_t___s_o_u_r_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___u_s_e_r___e_v_e_n_t_s_._c │ │ │ │ │ ************ AALLLLEEGGRROO__EEVVEENNTT__QQUUEEUUEE ************ │ │ │ │ │ typedef struct ALLEGRO_EVENT_QUEUE ALLEGRO_EVENT_QUEUE; │ │ │ │ │ +typedef struct ALLEGRO_EVENT_QUEUE ALLEGRO_EVENT_QUEUE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An event queue holds events that have been generated by event sources that are │ │ │ │ │ registered with the queue. Events are stored in the order they are generated. │ │ │ │ │ Access is in a strictly FIFO (first-in-first-out) order. │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___e_v_e_n_t___q_u_e_u_e, _a_l___d_e_s_t_r_o_y___e_v_e_n_t___q_u_e_u_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___i_n_j_e_c_t___e_v_e_n_t_s_._c │ │ │ │ │ * _e_x___e_n_e_t___s_e_r_v_e_r_._c │ │ │ │ │ * _e_x___t_i_m_e_r___p_a_u_s_e_._c │ │ │ │ │ ************ AALLLLEEGGRROO__EEVVEENNTT__SSOOUURRCCEE ************ │ │ │ │ │ typedef struct ALLEGRO_EVENT_SOURCE ALLEGRO_EVENT_SOURCE; │ │ │ │ │ +typedef struct ALLEGRO_EVENT_SOURCE ALLEGRO_EVENT_SOURCE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An event source is any object which can generate events. For example, an │ │ │ │ │ ALLEGRO_DISPLAY can generate events, and you can get the ALLEGRO_EVENT_SOURCE │ │ │ │ │ pointer from an ALLEGRO_DISPLAY with _a_l___g_e_t___d_i_s_p_l_a_y___e_v_e_n_t___s_o_u_r_c_e. │ │ │ │ │ You may create your own “user” event sources that emit custom events. │ │ │ │ │ See also: _A_L_L_E_G_R_O___E_V_E_N_T, _a_l___i_n_i_t___u_s_e_r___e_v_e_n_t___s_o_u_r_c_e, _a_l___e_m_i_t___u_s_e_r___e_v_e_n_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___i_n_j_e_c_t___e_v_e_n_t_s_._c │ │ │ │ │ * _e_x___u_s_e_r___e_v_e_n_t_s_._c │ │ │ │ │ * _n_i_h_g_u_i_._c_p_p │ │ │ │ │ ************ AALLLLEEGGRROO__EEVVEENNTT__TTYYPPEE ************ │ │ │ │ │ typedef unsigned int ALLEGRO_EVENT_TYPE; │ │ │ │ │ +typedef unsigned int ALLEGRO_EVENT_TYPE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An integer used to distinguish between different types of events. │ │ │ │ │ See also: _A_L_L_E_G_R_O___E_V_E_N_T, _A_L_L_E_G_R_O___G_E_T___E_V_E_N_T___T_Y_P_E, _A_L_L_E_G_R_O___E_V_E_N_T___T_Y_P_E___I_S___U_S_E_R │ │ │ │ │ ************ AALLLLEEGGRROO__GGEETT__EEVVEENNTT__TTYYPPEE ************ │ │ │ │ │ #define ALLEGRO_GET_EVENT_TYPE(a, b, c, d) AL_ID(a, b, c, d) │ │ │ │ │ +#define ALLEGRO_GET_EVENT_TYPE(a, b, c, d) AL_ID(a, b, c, d) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Make an event type identifier, which is a 32-bit integer. Usually, but not │ │ │ │ │ necessarily, this will be made from four 8-bit character codes, for example: │ │ │ │ │ Examples: │ │ │ │ │ │ │ │ │ │ * [ex_user_events.c](https://github.com/liballeg/allegro5/blob/master/examples/ │ │ │ │ │ ex_user_events.c#L10) │ │ │ │ │ @@ -589,14 +595,15 @@ │ │ │ │ │ BARK_EVENT = ALLEGRO_GET_EVENT_TYPE('M','I','N','E'), │ │ │ │ │ MEOW_EVENT, │ │ │ │ │ SQUAWK_EVENT │ │ │ │ │ }; │ │ │ │ │ See also: _A_L_L_E_G_R_O___E_V_E_N_T, _A_L_L_E_G_R_O___U_S_E_R___E_V_E_N_T, _A_L_L_E_G_R_O___E_V_E_N_T___T_Y_P_E___I_S___U_S_E_R │ │ │ │ │ ************ AALLLLEEGGRROO__EEVVEENNTT__TTYYPPEE__IISS__UUSSEERR ************ │ │ │ │ │ #define ALLEGRO_EVENT_TYPE_IS_USER(t) ((t) >= 512) │ │ │ │ │ +#define ALLEGRO_EVENT_TYPE_IS_USER(t) ((t) >= 512) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A macro which evaluates to true if the event type is not a builtin event type, │ │ │ │ │ i.e. one of those described in _A_L_L_E_G_R_O___E_V_E_N_T___T_Y_P_E. │ │ │ │ │ ************ aall__ccrreeaattee__eevveenntt__qquueeuuee ************ │ │ │ │ │ ALLEGRO_EVENT_QUEUE *al_create_event_queue(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Create a new, empty event queue, returning a pointer to the newly created │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/file.html │ │ │ │ @@ -236,15 +236,16 @@ │ │ │ │ id="toc-al_get_file_userdata">al_get_file_userdata │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │

    These functions are declared in the main Allegro header file:

    │ │ │ │ 
     #include <allegro5/allegro.h>
    │ │ │ │

    ALLEGRO_FILE

    │ │ │ │ -
    typedef struct ALLEGRO_FILE ALLEGRO_FILE;
    │ │ │ │ +
    typedef struct ALLEGRO_FILE ALLEGRO_FILE;
│ │ │ │ +typedef struct ALLEGRO_FILE ALLEGRO_FILE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An opaque object representing an open file. This could be a real file │ │ │ │ on disk or a virtual file.

    │ │ │ │

    Examples:

    │ │ │ │
      │ │ │ │ @@ -252,15 +253,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file.c#L23">ex_file.c │ │ │ │
    • ex_dir.c
      • │ │ │ │
    • ex_memfile.c
      • │ │ │ │
    │ │ │ │

    ALLEGRO_FILE_INTERFACE

    │ │ │ │ -
    typedef struct ALLEGRO_FILE_INTERFACE
    │ │ │ │ +
    typedef struct ALLEGRO_FILE_INTERFACE
│ │ │ │ +typedef struct ALLEGRO_FILE_INTERFACE
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A structure containing function pointers to handle a type of “file”, │ │ │ │ real or virtual. See the full discussion in al_set_new_file_interface.

    │ │ │ │

    The fields are:

    │ │ │ │ @@ -291,15 +293,16 @@ │ │ │ │ char long buffer will be used.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    ALLEGRO_SEEK

    │ │ │ │ -
    typedef enum ALLEGRO_SEEK
    │ │ │ │ +
    typedef enum ALLEGRO_SEEK
│ │ │ │ +typedef enum ALLEGRO_SEEK
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │
      │ │ │ │
    • ALLEGRO_SEEK_SET - seek relative to beginning of file
      • │ │ │ │
    • ALLEGRO_SEEK_CUR - seek relative to current file position
      • │ │ │ │
    • ALLEGRO_SEEK_END - seek relative to end of file
      • │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -85,23 +85,25 @@ │ │ │ │ │ o _a_l___g_e_t___n_e_w___f_i_l_e___i_n_t_e_r_f_a_c_e │ │ │ │ │ o _a_l___c_r_e_a_t_e___f_i_l_e___h_a_n_d_l_e │ │ │ │ │ o _a_l___g_e_t___f_i_l_e___u_s_e_r_d_a_t_a │ │ │ │ │ These functions are declared in the main Allegro header file: │ │ │ │ │ #include │ │ │ │ │ ************ AALLLLEEGGRROO__FFIILLEE ************ │ │ │ │ │ typedef struct ALLEGRO_FILE ALLEGRO_FILE; │ │ │ │ │ +typedef struct ALLEGRO_FILE ALLEGRO_FILE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An opaque object representing an open file. This could be a real file on disk │ │ │ │ │ or a virtual file. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_i_l_e_._c │ │ │ │ │ * _e_x___d_i_r_._c │ │ │ │ │ * _e_x___m_e_m_f_i_l_e_._c │ │ │ │ │ ************ AALLLLEEGGRROO__FFIILLEE__IINNTTEERRFFAACCEE ************ │ │ │ │ │ typedef struct ALLEGRO_FILE_INTERFACE │ │ │ │ │ +typedef struct ALLEGRO_FILE_INTERFACE │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A structure containing function pointers to handle a type of “file”, real or │ │ │ │ │ virtual. See the full discussion in _a_l___s_e_t___n_e_w___f_i_l_e___i_n_t_e_r_f_a_c_e. │ │ │ │ │ The fields are: │ │ │ │ │ void* (*fi_fopen)(const char *path, const char *mode); │ │ │ │ │ bool (*fi_fclose)(ALLEGRO_FILE *f); │ │ │ │ │ size_t (*fi_fread)(ALLEGRO_FILE *f, void *ptr, size_t size); │ │ │ │ │ @@ -124,14 +126,15 @@ │ │ │ │ │ free the _A_L_L_E_G_R_O___F_I_L_E handle. │ │ │ │ │ If fi_fungetc is NULL, then Allegro’s default implementation of a 16 char long │ │ │ │ │ buffer will be used. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___c_u_r_l_._c │ │ │ │ │ ************ AALLLLEEGGRROO__SSEEEEKK ************ │ │ │ │ │ typedef enum ALLEGRO_SEEK │ │ │ │ │ +typedef enum ALLEGRO_SEEK │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ * ALLEGRO_SEEK_SET - seek relative to beginning of file │ │ │ │ │ * ALLEGRO_SEEK_CUR - seek relative to current file position │ │ │ │ │ * ALLEGRO_SEEK_END - seek relative to end of file │ │ │ │ │ See also: _a_l___f_s_e_e_k │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_i_l_e_._c │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/fixed.html │ │ │ │ @@ -202,15 +202,16 @@ │ │ │ │
    • al_fixhypot
      • │ │ │ │
    │ │ │ │ │ │ │ │ │ │ │ │

    These functions are declared in the main Allegro header file:

    │ │ │ │ 
     #include <allegro5/allegro.h>
    │ │ │ │

    al_fixed

    │ │ │ │ -
    typedef int32_t al_fixed;
    │ │ │ │ +
    typedef int32_t al_fixed;
│ │ │ │ +typedef int32_t al_fixed;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A fixed point number.

    │ │ │ │

    Allegro provides some routines for working with fixed point numbers, │ │ │ │ and defines the type al_fixed to be a signed 32-bit │ │ │ │ integer. The high word is used for the integer part and the low word for │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -66,14 +66,15 @@ │ │ │ │ │ o _a_l___f_i_x_a_t_a_n_2 │ │ │ │ │ o _a_l___f_i_x_s_q_r_t │ │ │ │ │ o _a_l___f_i_x_h_y_p_o_t │ │ │ │ │ These functions are declared in the main Allegro header file: │ │ │ │ │ #include │ │ │ │ │ ************ aall__ffiixxeedd ************ │ │ │ │ │ typedef int32_t al_fixed; │ │ │ │ │ +typedef int32_t al_fixed; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A fixed point number. │ │ │ │ │ Allegro provides some routines for working with fixed point numbers, and │ │ │ │ │ defines the type al_fixed to be a signed 32-bit integer. The high word is used │ │ │ │ │ for the integer part and the low word for the fraction, giving a range of - │ │ │ │ │ 32768 to 32767 and an accuracy of about four or five decimal places. Fixed │ │ │ │ │ point numbers can be assigned, compared, added, subtracted, negated and shifted │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/font.html │ │ │ │ @@ -283,15 +283,16 @@ │ │ │ │ │ │ │ │ │ │ │ │

    These functions are declared in the following header file. Link with │ │ │ │ allegro_font.

    │ │ │ │ 
     #include <allegro5/allegro_font.h>
    │ │ │ │

    General font routines

    │ │ │ │

    ALLEGRO_FONT

    │ │ │ │ -
    typedef struct ALLEGRO_FONT ALLEGRO_FONT;
    │ │ │ │ +
    typedef struct ALLEGRO_FONT ALLEGRO_FONT;
│ │ │ │ +typedef struct ALLEGRO_FONT ALLEGRO_FONT;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A handle identifying any kind of font. Usually you will create it │ │ │ │ with al_load_font which supports │ │ │ │ loading all kinds of TrueType fonts supported by the FreeType library. │ │ │ │ If you instead pass the filename of a bitmap file, it will be loaded │ │ │ │ @@ -304,15 +305,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_disable_screensaver.c#L10">ex_disable_screensaver.c │ │ │ │

  • ex_font_justify.cpp
    • │ │ │ │
  • ex_timedwait.c
    • │ │ │ │ │ │ │ │

    ALLEGRO_GLYPH

    │ │ │ │ -
    typedef struct ALLEGRO_GLYPH ALLEGRO_GLYPH;
    │ │ │ │ +
    typedef struct ALLEGRO_GLYPH ALLEGRO_GLYPH;
│ │ │ │ +typedef struct ALLEGRO_GLYPH ALLEGRO_GLYPH;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A structure containing the properties of a character in a font.

    │ │ │ │ 
    typedef struct ALLEGRO_GLYPH {
│ │ │ │     ALLEGRO_BITMAP *bitmap;   // the bitmap the character is on
│ │ │ │     int x;                    // the x position of the glyph on bitmap
│ │ │ │ @@ -343,15 +345,16 @@
│ │ │ │  
    See also: al_get_glyph
    
│ │ │ │  
    Examples:
    
│ │ │ │  
      
│ │ │ │  
    • ex_ttf.c
      • 
│ │ │ │  
    
│ │ │ │  
    al_init_font_addon
    
│ │ │ │ -
    bool al_init_font_addon(void)
    
│ │ │ │ +
    bool al_init_font_addon(void)
│ │ │ │ +bool al_init_font_addon(void)
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Initialise the font addon.
    
│ │ │ │  
    Note that if you intend to load bitmap fonts, you will need to
│ │ │ │  initialise allegro_image separately (unless you are using another
│ │ │ │  library to load images).
    
│ │ │ │ @@ -371,35 +374,38 @@
│ │ │ │  href="https://github.com/liballeg/allegro5/blob/master/examples/ex_disable_screensaver.c#L28">ex_disable_screensaver.c
│ │ │ │  
  • ex_font_justify.cpp
    • 
│ │ │ │  
  • ex_timedwait.c
    • 
│ │ │ │  
│ │ │ │  
    al_is_font_addon_initialized
    
│ │ │ │ -
    bool al_is_font_addon_initialized(void)
    
│ │ │ │ +
    bool al_is_font_addon_initialized(void)
│ │ │ │ +bool al_is_font_addon_initialized(void)
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Returns true if the font addon is initialized, otherwise returns
│ │ │ │  false.
    
│ │ │ │  
    Since: 5.2.6
    
│ │ │ │  
    See also: al_init_font_addon, al_shutdown_font_addon
    
│ │ │ │  
    al_shutdown_font_addon
    
│ │ │ │ -
    void al_shutdown_font_addon(void)
    
│ │ │ │ +
    void al_shutdown_font_addon(void)
│ │ │ │ +void al_shutdown_font_addon(void)
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Shut down the font addon. This is done automatically at program exit,
│ │ │ │  but can be called any time the user wishes as well.
    
│ │ │ │  
    See also: al_init_font_addon
    
│ │ │ │  
    al_load_font
    
│ │ │ │ -
    ALLEGRO_FONT *al_load_font(char const *filename, int size, int flags)
    
│ │ │ │ +
    ALLEGRO_FONT *al_load_font(char const *filename, int size, int flags)
│ │ │ │ +ALLEGRO_FONT *al_load_font(char const *filename, int size, int flags)
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Loads a font from disk. This will use al_load_bitmap_font_flags
│ │ │ │  if you pass the name of a known bitmap format, or else al_load_ttf_font.
    
│ │ │ │ @@ -418,15 +424,16 @@
│ │ │ │  href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L116">ex_font_justify.cpp
│ │ │ │  
  • ex_membmp.c
    • 
│ │ │ │  
  • ex_window_title.c
    • 
│ │ │ │  
│ │ │ │  
    al_destroy_font
    
│ │ │ │ -
    void al_destroy_font(ALLEGRO_FONT *f)
    
│ │ │ │ +
    void al_destroy_font(ALLEGRO_FONT *f)
│ │ │ │ +void al_destroy_font(ALLEGRO_FONT *f)
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Frees the memory being used by a font structure. Does nothing if
│ │ │ │  passed NULL.
    
│ │ │ │  
    See also: al_load_font
    
│ │ │ │  
    Examples:
    
│ │ │ │ @@ -436,30 +443,33 @@
│ │ │ │  
  • ex_font_justify.cpp
    • 
│ │ │ │  
  • ex_cpu.c
    • 
│ │ │ │  
│ │ │ │  
    al_register_font_loader
    
│ │ │ │  
    bool al_register_font_loader(char const *extension,
│ │ │ │ -   ALLEGRO_FONT *(*load_font)(char const *filename, int size, int flags))
    
│ │ │ │ +   ALLEGRO_FONT *(*load_font)(char const *filename, int size, int flags))
│ │ │ │ +bool al_register_font_loader(char const *extension,
│ │ │ │ +   ALLEGRO_FONT *(*load_font)(char const *filename, int size, int flags))
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Informs Allegro of a new font file type, telling it how to load files │ │ │ │ of this format.

    │ │ │ │

    The extension should include the leading dot (‘.’) │ │ │ │ character. It will be matched case-insensitively.

    │ │ │ │

    The load_font argument may be NULL to unregister an │ │ │ │ entry.

    │ │ │ │

    Returns true on success, false on error. Returns false if │ │ │ │ unregistering an entry that doesn’t exist.

    │ │ │ │

    See also: al_init_font_addon

    │ │ │ │

    al_get_font_line_height

    │ │ │ │ -
    int al_get_font_line_height(const ALLEGRO_FONT *f)
    │ │ │ │ +
    int al_get_font_line_height(const ALLEGRO_FONT *f)
│ │ │ │ +int al_get_font_line_height(const ALLEGRO_FONT *f)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the usual height of a line of text in the specified font. For │ │ │ │ bitmap fonts this is simply the height of all glyph bitmaps. For │ │ │ │ truetype fonts it is whatever the font file specifies. In particular, │ │ │ │ some special glyphs may be higher than the height returned here.

    │ │ │ │ @@ -485,43 +495,46 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L78">ex_font_justify.cpp │ │ │ │
  • ex_membmp.c
    • │ │ │ │
  • ex_mouse_warp.c
    • │ │ │ │ │ │ │ │

    al_get_font_ascent

    │ │ │ │ -
    int al_get_font_ascent(const ALLEGRO_FONT *f)
    │ │ │ │ +
    int al_get_font_ascent(const ALLEGRO_FONT *f)
│ │ │ │ +int al_get_font_ascent(const ALLEGRO_FONT *f)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the ascent of the specified font.

    │ │ │ │

    See also: al_get_font_descent, al_get_font_line_height

    │ │ │ │

    Examples:

    │ │ │ │
      │ │ │ │
    • ex_ttf.c
      • │ │ │ │
    │ │ │ │

    al_get_font_descent

    │ │ │ │ -
    int al_get_font_descent(const ALLEGRO_FONT *f)
    │ │ │ │ +
    int al_get_font_descent(const ALLEGRO_FONT *f)
│ │ │ │ +int al_get_font_descent(const ALLEGRO_FONT *f)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the descent of the specified font.

    │ │ │ │

    See also: al_get_font_ascent, al_get_font_line_height

    │ │ │ │

    Examples:

    │ │ │ │
      │ │ │ │
    • ex_ttf.c
      • │ │ │ │
    │ │ │ │

    al_get_text_width

    │ │ │ │ -
    int al_get_text_width(const ALLEGRO_FONT *f, const char *str)
    │ │ │ │ +
    int al_get_text_width(const ALLEGRO_FONT *f, const char *str)
│ │ │ │ +int al_get_text_width(const ALLEGRO_FONT *f, const char *str)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Calculates the length of a string in a particular font, in │ │ │ │ pixels.

    │ │ │ │

    See also: al_get_ustr_width, ex_display_options.c │ │ │ │

  • ex_record_name.c
    • │ │ │ │
  • ex_color_gradient.c
    • │ │ │ │ │ │ │ │

    al_get_ustr_width

    │ │ │ │ -
    int al_get_ustr_width(const ALLEGRO_FONT *f, ALLEGRO_USTR const *ustr)
    │ │ │ │ +
    int al_get_ustr_width(const ALLEGRO_FONT *f, ALLEGRO_USTR const *ustr)
│ │ │ │ +int al_get_ustr_width(const ALLEGRO_FONT *f, ALLEGRO_USTR const *ustr)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_get_text_width but │ │ │ │ expects an ALLEGRO_USTR.

    │ │ │ │

    See also: al_get_text_width, │ │ │ │

  • nihgui.cpp
    • │ │ │ │ │ │ │ │

    al_draw_text

    │ │ │ │ 
    void al_draw_text(const ALLEGRO_FONT *font,
│ │ │ │     ALLEGRO_COLOR color, float x, float y, int flags,
│ │ │ │ -   char const *text)
    │ │ │ │ + char const *text) │ │ │ │ +void al_draw_text(const ALLEGRO_FONT *font, │ │ │ │ + ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ + char const *text) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Writes the NUL-terminated string text onto the target │ │ │ │ bitmap at position x, y, using the specified │ │ │ │ font.

    │ │ │ │

    The flags parameter can be 0 or one of the following │ │ │ │ @@ -592,15 +609,18 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timedwait.c#L89">ex_timedwait.c │ │ │ │

  • ex_display_events.c
    • │ │ │ │ │ │ │ │

    al_draw_ustr

    │ │ │ │ 
    void al_draw_ustr(const ALLEGRO_FONT *font,
│ │ │ │     ALLEGRO_COLOR color, float x, float y, int flags,
│ │ │ │ -   const ALLEGRO_USTR *ustr)
    │ │ │ │ + const ALLEGRO_USTR *ustr) │ │ │ │ +void al_draw_ustr(const ALLEGRO_FONT *font, │ │ │ │ + ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ + const ALLEGRO_USTR *ustr) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_draw_text, except the │ │ │ │ text is passed as an ALLEGRO_USTR instead of a NUL-terminated char │ │ │ │ array.

    │ │ │ │

    See also: al_draw_text, nihgui.cpp │ │ │ │

  • ex_blend.c
    • │ │ │ │ │ │ │ │

    al_draw_justified_text

    │ │ │ │ 
    void al_draw_justified_text(const ALLEGRO_FONT *font,
│ │ │ │     ALLEGRO_COLOR color, float x1, float x2,
│ │ │ │ -   float y, float diff, int flags, const char *text)
    │ │ │ │ + float y, float diff, int flags, const char *text) │ │ │ │ +void al_draw_justified_text(const ALLEGRO_FONT *font, │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ + float y, float diff, int flags, const char *text) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_draw_text, but justifies │ │ │ │ the string to the region x1-x2.

    │ │ │ │

    The diff parameter is the maximum amount of horizontal │ │ │ │ space to allow between words. If justisfying the text would exceed │ │ │ │ @@ -641,29 +664,35 @@ │ │ │ │

    │ │ │ │

    al_draw_justified_ustr

    │ │ │ │ 
    void al_draw_justified_ustr(const ALLEGRO_FONT *font,
│ │ │ │     ALLEGRO_COLOR color, float x1, float x2,
│ │ │ │ -   float y, float diff, int flags, const ALLEGRO_USTR *ustr)
    │ │ │ │ + float y, float diff, int flags, const ALLEGRO_USTR *ustr) │ │ │ │ +void al_draw_justified_ustr(const ALLEGRO_FONT *font, │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ + float y, float diff, int flags, const ALLEGRO_USTR *ustr) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_draw_justified_text, │ │ │ │ except the text is passed as an ALLEGRO_USTR instead of a NUL-terminated │ │ │ │ char array.

    │ │ │ │

    See also: al_draw_justified_text, al_draw_justified_textf.

    │ │ │ │

    al_draw_textf

    │ │ │ │ 
    void al_draw_textf(const ALLEGRO_FONT *font, ALLEGRO_COLOR color,
│ │ │ │     float x, float y, int flags,
│ │ │ │ -   const char *format, ...)
    │ │ │ │ + const char *format, ...) │ │ │ │ +void al_draw_textf(const ALLEGRO_FONT *font, ALLEGRO_COLOR color, │ │ │ │ + float x, float y, int flags, │ │ │ │ + const char *format, ...) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Formatted text output, using a printf() style format string. All │ │ │ │ parameters have the same meaning as with al_draw_text otherwise.

    │ │ │ │

    See also: al_draw_text, ex_timedwait.c │ │ │ │

  • ex_display_events.c
    • │ │ │ │ │ │ │ │

    al_draw_justified_textf

    │ │ │ │ 
    void al_draw_justified_textf(const ALLEGRO_FONT *f,
│ │ │ │     ALLEGRO_COLOR color, float x1, float x2, float y,
│ │ │ │ -   float diff, int flags, const char *format, ...)
    │ │ │ │ + float diff, int flags, const char *format, ...) │ │ │ │ +void al_draw_justified_textf(const ALLEGRO_FONT *f, │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, float y, │ │ │ │ + float diff, int flags, const char *format, ...) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Formatted text output, using a printf() style format string. All │ │ │ │ parameters have the same meaning as with al_draw_justified_text │ │ │ │ otherwise.

    │ │ │ │

    See also: al_draw_justified_text, al_draw_justified_ustr.

    │ │ │ │

    al_get_text_dimensions

    │ │ │ │ 
    void al_get_text_dimensions(const ALLEGRO_FONT *f,
│ │ │ │     char const *text,
│ │ │ │ -   int *bbx, int *bby, int *bbw, int *bbh)
    │ │ │ │ + int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ +void al_get_text_dimensions(const ALLEGRO_FONT *f, │ │ │ │ + char const *text, │ │ │ │ + int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sometimes, the al_get_text_width and al_get_font_line_height │ │ │ │ functions are not enough for exact text placement, so this function │ │ │ │ @@ -720,33 +755,38 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_ttf.c#L210">ex_ttf.c │ │ │ │

  • ex_logo.c
    • │ │ │ │ │ │ │ │

    al_get_ustr_dimensions

    │ │ │ │ 
    void al_get_ustr_dimensions(const ALLEGRO_FONT *f,
│ │ │ │     ALLEGRO_USTR const *ustr,
│ │ │ │ -   int *bbx, int *bby, int *bbw, int *bbh)
    │ │ │ │ + int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ +void al_get_ustr_dimensions(const ALLEGRO_FONT *f, │ │ │ │ + ALLEGRO_USTR const *ustr, │ │ │ │ + int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_get_text_dimensions, │ │ │ │ except the text is passed as an ALLEGRO_USTR instead of a NUL-terminated │ │ │ │ char array.

    │ │ │ │

    See also: al_get_text_dimensions

    │ │ │ │

    al_get_allegro_font_version

    │ │ │ │ -
    uint32_t al_get_allegro_font_version(void)
    │ │ │ │ +
    uint32_t al_get_allegro_font_version(void)
│ │ │ │ +uint32_t al_get_allegro_font_version(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

    │ │ │ │

    al_get_font_ranges

    │ │ │ │ -
    int al_get_font_ranges(ALLEGRO_FONT *f, int ranges_count, int *ranges)
    │ │ │ │ +
    int al_get_font_ranges(ALLEGRO_FONT *f, int ranges_count, int *ranges)
│ │ │ │ +int al_get_font_ranges(ALLEGRO_FONT *f, int ranges_count, int *ranges)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Gets information about all glyphs contained in a font, as a list of │ │ │ │ ranges. Ranges have the same format as with al_grab_font_from_bitmap.

    │ │ │ │

    ranges_count is the maximum number of ranges that will │ │ │ │ @@ -762,15 +802,16 @@ │ │ │ │ href="font.html#al_grab_font_from_bitmap">al_grab_font_from_bitmap

    │ │ │ │

    Examples:

    │ │ │ │
      │ │ │ │
    • ex_ttf.c
      • │ │ │ │
    │ │ │ │

    al_set_fallback_font

    │ │ │ │ -
    void al_set_fallback_font(ALLEGRO_FONT *font, ALLEGRO_FONT *fallback)
    │ │ │ │ +
    void al_set_fallback_font(ALLEGRO_FONT *font, ALLEGRO_FONT *fallback)
│ │ │ │ +void al_set_fallback_font(ALLEGRO_FONT *font, ALLEGRO_FONT *fallback)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sets a font which is used instead if a character is not present. Can │ │ │ │ be chained, but make sure there is no loop as that would crash the │ │ │ │ application! Pass NULL to remove a fallback font again.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │ @@ -780,15 +821,16 @@ │ │ │ │ href="font.html#al_draw_text">al_draw_text

    │ │ │ │

    Examples:

    │ │ │ │
      │ │ │ │
    • ex_ttf.c
      • │ │ │ │
    │ │ │ │

    al_get_fallback_font

    │ │ │ │ -
    ALLEGRO_FONT *al_get_fallback_font(ALLEGRO_FONT *font)
    │ │ │ │ +
    ALLEGRO_FONT *al_get_fallback_font(ALLEGRO_FONT *font)
│ │ │ │ +ALLEGRO_FONT *al_get_fallback_font(ALLEGRO_FONT *font)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Retrieves the fallback font for this font or NULL.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │

    See also: al_set_fallback_font

    │ │ │ │ @@ -802,15 +844,17 @@ │ │ │ │

    And it’s also possible to get the kerning to use between two glyphs. │ │ │ │ These per glyph functions have less overhead than Allegro’s per string │ │ │ │ text drawing and dimensioning functions. So, with these functions you │ │ │ │ can write your own efficient and precise custom text drawing │ │ │ │ functions.

    │ │ │ │

    al_draw_glyph

    │ │ │ │ 
    void al_draw_glyph(const ALLEGRO_FONT *f, ALLEGRO_COLOR color, float x, float y,
│ │ │ │ -   int codepoint)
    │ │ │ │ + int codepoint) │ │ │ │ +void al_draw_glyph(const ALLEGRO_FONT *f, ALLEGRO_COLOR color, float x, float y, │ │ │ │ + int codepoint) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Draws the glyph that corresponds with codepoint in the │ │ │ │ given color using the given font. If │ │ │ │ font does not have such a glyph, nothing will be drawn.

    │ │ │ │

    To draw a string as left to right horizontal text you will need to │ │ │ │ @@ -834,28 +878,31 @@ │ │ │ │

    │ │ │ │

    al_get_glyph_width

    │ │ │ │ -
    int al_get_glyph_width(const ALLEGRO_FONT *f, int codepoint)
    │ │ │ │ +
    int al_get_glyph_width(const ALLEGRO_FONT *f, int codepoint)
│ │ │ │ +int al_get_glyph_width(const ALLEGRO_FONT *f, int codepoint)
    │ │ │ │

    Source │ │ │ │ -Code

    │ │ │ │ +href="https://github.com/liballeg/allegro5/blob/master/addorgb_to_yuv#L%20float%20*y,%20float%20*u,%20float%20*v">Source │ │ │ │ +Code)

    │ │ │ │

    This function returns the width in pixels of the glyph that │ │ │ │ corresponds with codepoint in the font font. │ │ │ │ Returns zero if the font does not have such a glyph.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │

    See also: al_draw_glyph, al_get_glyph_dimensions, al_get_glyph_advance.

    │ │ │ │

    al_get_glyph_dimensions

    │ │ │ │ 
    bool al_get_glyph_dimensions(const ALLEGRO_FONT *f,
│ │ │ │ -   int codepoint, int *bbx, int *bby, int *bbw, int *bbh)
    │ │ │ │ + int codepoint, int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ +bool al_get_glyph_dimensions(const ALLEGRO_FONT *f, │ │ │ │ + int codepoint, int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sometimes, the al_get_glyph_width or al_get_glyph_advance functions │ │ │ │ are not enough for exact glyph placement, so this function returns some │ │ │ │ @@ -909,15 +956,16 @@ │ │ │ │ href="font.html#al_get_glyph_advance">al_get_glyph_advance.

    │ │ │ │

    Examples:

    │ │ │ │
      │ │ │ │
    • ex_ttf.c
      • │ │ │ │
    │ │ │ │

    al_get_glyph_advance

    │ │ │ │ -
    int al_get_glyph_advance(const ALLEGRO_FONT *f, int codepoint1, int codepoint2)
    │ │ │ │ +
    int al_get_glyph_advance(const ALLEGRO_FONT *f, int codepoint1, int codepoint2)
│ │ │ │ +int al_get_glyph_advance(const ALLEGRO_FONT *f, int codepoint1, int codepoint2)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This function returns by how much the x position should be advanced │ │ │ │ for left to right text drawing when the glyph that corresponds to │ │ │ │ codepoint1 has been drawn, and the glyph that corresponds to codepoint2 │ │ │ │ will be the next to be drawn. This takes into consideration the │ │ │ │ @@ -988,15 +1036,18 @@ │ │ │ │

  • ex_ttf.c
    • │ │ │ │ │ │ │ │

    Multiline text drawing

    │ │ │ │

    al_draw_multiline_text

    │ │ │ │ 
    void al_draw_multiline_text(const ALLEGRO_FONT *font,
│ │ │ │       ALLEGRO_COLOR color, float x, float y, float max_width, float line_height,
│ │ │ │ -     int flags, const char *text)
    │ │ │ │ + int flags, const char *text) │ │ │ │ +void al_draw_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ + int flags, const char *text) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_draw_text, but this │ │ │ │ function supports drawing multiple lines of text. It will break │ │ │ │ text in lines based on its contents and the │ │ │ │ max_width parameter. The lines are then layed out │ │ │ │ @@ -1048,15 +1099,18 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_multiline.cpp#L158">ex_font_multiline.cpp │ │ │ │

  • ex_resize2.c
    • │ │ │ │ │ │ │ │

    al_draw_multiline_ustr

    │ │ │ │ 
    void al_draw_multiline_ustr(const ALLEGRO_FONT *font,
│ │ │ │       ALLEGRO_COLOR color, float x, float y, float max_width, float line_height,
│ │ │ │ -     int flags, const ALLEGRO_USTR *ustr)
    │ │ │ │ + int flags, const ALLEGRO_USTR *ustr) │ │ │ │ +void al_draw_multiline_ustr(const ALLEGRO_FONT *font, │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ + int flags, const ALLEGRO_USTR *ustr) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_draw_multiline_text, │ │ │ │ except the text is passed as an ALLEGRO_USTR instead of a NUL-terminated │ │ │ │ char array.

    │ │ │ │ @@ -1064,15 +1118,18 @@ │ │ │ │

    See also: al_draw_multiline_text, al_draw_multiline_textf, al_do_multiline_text

    │ │ │ │

    al_draw_multiline_textf

    │ │ │ │ 
    void al_draw_multiline_textf(const ALLEGRO_FONT *font,
│ │ │ │       ALLEGRO_COLOR color, float x, float y, float max_width, float line_height,
│ │ │ │ -     int flags, const char *format, ...)
    │ │ │ │ + int flags, const char *format, ...) │ │ │ │ +void al_draw_multiline_textf(const ALLEGRO_FONT *font, │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ + int flags, const char *format, ...) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Formatted text output, using a printf() style format string. All │ │ │ │ parameters have the same meaning as with al_draw_multiline_text │ │ │ │ otherwise.

    │ │ │ │ @@ -1086,15 +1143,19 @@ │ │ │ │
  • ex_resize2.c
    • │ │ │ │ │ │ │ │

    al_do_multiline_text

    │ │ │ │ 
    void al_do_multiline_text(const ALLEGRO_FONT *font,
│ │ │ │     float max_width, const char *text,
│ │ │ │     bool (*cb)(int line_num, const char *line, int size, void *extra),
│ │ │ │ -   void *extra)
    │ │ │ │ + void *extra) │ │ │ │ +void al_do_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ + float max_width, const char *text, │ │ │ │ + bool (*cb)(int line_num, const char *line, int size, void *extra), │ │ │ │ + void *extra) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This function processes the text and splits it into │ │ │ │ lines as al_draw_multiline_text │ │ │ │ would, and then calls the callback cb once for every line. │ │ │ │ @@ -1133,28 +1194,34 @@ │ │ │ │

  • ex_font_multiline.cpp
    • │ │ │ │ │ │ │ │

    al_do_multiline_ustr

    │ │ │ │ 
    void al_do_multiline_ustr(const ALLEGRO_FONT *font, float max_width,
│ │ │ │     const ALLEGRO_USTR *ustr,
│ │ │ │     bool (*cb)(int line_num, const ALLEGRO_USTR * line, void *extra),
│ │ │ │ -   void *extra)
    │ │ │ │ + void *extra) │ │ │ │ +void al_do_multiline_ustr(const ALLEGRO_FONT *font, float max_width, │ │ │ │ + const ALLEGRO_USTR *ustr, │ │ │ │ + bool (*cb)(int line_num, const ALLEGRO_USTR * line, void *extra), │ │ │ │ + void *extra) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_do_multiline_text, but │ │ │ │ using ALLEGRO_USTR instead of a NUL-terminated char array for text.

    │ │ │ │

    Since: 5.1.9

    │ │ │ │

    See also: al_draw_multiline_ustr

    │ │ │ │

    Bitmap fonts

    │ │ │ │

    al_grab_font_from_bitmap

    │ │ │ │ 
    ALLEGRO_FONT *al_grab_font_from_bitmap(ALLEGRO_BITMAP *bmp,
│ │ │ │ -   int ranges_n, const int ranges[])
    │ │ │ │ + int ranges_n, const int ranges[]) │ │ │ │ +ALLEGRO_FONT *al_grab_font_from_bitmap(ALLEGRO_BITMAP *bmp, │ │ │ │ + int ranges_n, const int ranges[]) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates a new font from an Allegro bitmap. You can delete the bitmap │ │ │ │ after the function returns as the font will contain a copy for │ │ │ │ itself.

    │ │ │ │

    Parameters:

    │ │ │ │ @@ -1211,15 +1278,16 @@ │ │ │ │ │ │ │ │

    al_load_bitmap_font

    │ │ │ │ -
    ALLEGRO_FONT *al_load_bitmap_font(const char *fname)
    │ │ │ │ +
    ALLEGRO_FONT *al_load_bitmap_font(const char *fname)
│ │ │ │ +ALLEGRO_FONT *al_load_bitmap_font(const char *fname)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Load a bitmap font from a file. This is done by first calling al_load_bitmap_flags and │ │ │ │ then al_grab_font_from_bitmap.

    │ │ │ │ @@ -1238,15 +1306,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_bitmap_flip.c#L105">ex_bitmap_flip.c │ │ │ │
  • ex_mouse_cursor.c
    • │ │ │ │
  • ex_record_name.c
    • │ │ │ │ │ │ │ │

    al_load_bitmap_font_flags

    │ │ │ │ -
    ALLEGRO_FONT *al_load_bitmap_font_flags(const char *fname, int flags)
    │ │ │ │ +
    ALLEGRO_FONT *al_load_bitmap_font_flags(const char *fname, int flags)
│ │ │ │ +ALLEGRO_FONT *al_load_bitmap_font_flags(const char *fname, int flags)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_load_bitmap_font │ │ │ │ but additionally takes a flags parameter which is a bitfield containing │ │ │ │ a combination of the following:

    │ │ │ │
    │ │ │ │ @@ -1256,15 +1325,16 @@ │ │ │ │ href="graphics.html#al_load_bitmap_flags">al_load_bitmap_flags. │ │ │ │ │ │ │ │
    │ │ │ │

    See also: al_load_bitmap_font, al_load_bitmap_flags

    │ │ │ │

    al_create_builtin_font

    │ │ │ │ -
    ALLEGRO_FONT *al_create_builtin_font(void)
    │ │ │ │ +
    ALLEGRO_FONT *al_create_builtin_font(void)
│ │ │ │ +ALLEGRO_FONT *al_create_builtin_font(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates a monochrome bitmap font (8x8 pixels per character).

    │ │ │ │

    This font is primarily intended to be used for displaying information │ │ │ │ in environments or during early runtime states where no external font │ │ │ │ data is available or loaded (e.g. for debugging).

    │ │ │ │ @@ -1290,15 +1360,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_display_events.c#L48">ex_display_events.c │ │ │ │ │ │ │ │

    TTF fonts

    │ │ │ │

    These functions are declared in the following header file. Link with │ │ │ │ allegro_ttf.

    │ │ │ │ 
     #include <allegro5/allegro_ttf.h>
    │ │ │ │

    al_init_ttf_addon

    │ │ │ │ -
    bool al_init_ttf_addon(void)
    │ │ │ │ +
    bool al_init_ttf_addon(void)
│ │ │ │ +bool al_init_ttf_addon(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Call this after al_init_font_addon to make al_load_font recognize “.ttf” and │ │ │ │ other formats supported by ex_font_justify.cpp │ │ │ │

  • ex_font_multiline.cpp
    • │ │ │ │
  • ex_color.cpp
    • │ │ │ │ │ │ │ │

    al_is_ttf_addon_initialized

    │ │ │ │ -
    bool al_is_ttf_addon_initialized(void)
    │ │ │ │ +
    bool al_is_ttf_addon_initialized(void)
│ │ │ │ +bool al_is_ttf_addon_initialized(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if the TTF addon is initialized, otherwise returns │ │ │ │ false.

    │ │ │ │

    Since: 5.2.6

    │ │ │ │

    See also: al_init_ttf_addon, al_shutdown_ttf_addon

    │ │ │ │

    al_shutdown_ttf_addon

    │ │ │ │ -
    void al_shutdown_ttf_addon(void)
    │ │ │ │ +
    void al_shutdown_ttf_addon(void)
│ │ │ │ +void al_shutdown_ttf_addon(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Unloads the ttf addon again. You normally don’t need to call │ │ │ │ this.

    │ │ │ │

    al_load_ttf_font

    │ │ │ │ -
    ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags)
    │ │ │ │ +
    ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags)
│ │ │ │ +ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Loads a TrueType font from a file using the FreeType library. Quoting │ │ │ │ from the FreeType FAQ this means support for many different font │ │ │ │ formats:

    │ │ │ │

    TrueType, OpenType, Type1, CID, CFF, Windows FON/FNT, X11 PCF, │ │ │ │ @@ -1369,29 +1443,33 @@ │ │ │ │

  • ex_synth.cpp
    • │ │ │ │
  • ex_audio_chain.cpp
    • │ │ │ │ │ │ │ │

    al_load_ttf_font_f

    │ │ │ │ 
    ALLEGRO_FONT *al_load_ttf_font_f(ALLEGRO_FILE *file,
│ │ │ │ -    char const *filename, int size, int flags)
    │ │ │ │ + char const *filename, int size, int flags) │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_f(ALLEGRO_FILE *file, │ │ │ │ + char const *filename, int size, int flags) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_load_ttf_font, but │ │ │ │ the font is read from the file handle. The filename is only used to find │ │ │ │ possible additional files next to a font file.

    │ │ │ │
    │ │ │ │

    Note: The file handle is owned by the returned ALLEGRO_FONT │ │ │ │ object and must not be freed by the caller, as FreeType expects to be │ │ │ │ able to read from it at a later time.

    │ │ │ │
    │ │ │ │

    al_load_ttf_font_stretch

    │ │ │ │ 
    ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h,
│ │ │ │ -   int flags)
    │ │ │ │ + int flags) │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h, │ │ │ │ + int flags) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_load_ttf_font, │ │ │ │ except it takes separate width and height parameters instead of a single │ │ │ │ size parameter.

    │ │ │ │

    If the height is a positive value, and the width zero or positive, │ │ │ │ @@ -1404,15 +1482,17 @@ │ │ │ │ negative, or if the height is negative while the width is positive.

    │ │ │ │

    Since: 5.0.6, 5.1.0

    │ │ │ │

    See also: al_load_ttf_font, │ │ │ │ al_load_ttf_font_stretch_f

    │ │ │ │

    al_load_ttf_font_stretch_f

    │ │ │ │ 
    ALLEGRO_FONT *al_load_ttf_font_stretch_f(ALLEGRO_FILE *file,
│ │ │ │ -    char const *filename, int w, int h, int flags)
    │ │ │ │ + char const *filename, int w, int h, int flags) │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_stretch_f(ALLEGRO_FILE *file, │ │ │ │ + char const *filename, int w, int h, int flags) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_load_ttf_font_stretch, │ │ │ │ but the font is read from the file handle. The filename is only used to │ │ │ │ find possible additional files next to a font file.

    │ │ │ │ @@ -1421,22 +1501,24 @@ │ │ │ │ object and must not be freed by the caller, as FreeType expects to be │ │ │ │ able to read from it at a later time.

    │ │ │ │
    │ │ │ │

    Since: 5.0.6, 5.1.0

    │ │ │ │

    See also: al_load_ttf_font_stretch

    │ │ │ │

    al_get_allegro_ttf_version

    │ │ │ │ -
    uint32_t al_get_allegro_ttf_version(void)
    │ │ │ │ +
    uint32_t al_get_allegro_ttf_version(void)
│ │ │ │ +uint32_t al_get_allegro_ttf_version(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

    │ │ │ │

    al_get_glyph

    │ │ │ │ -
    bool al_get_glyph(const ALLEGRO_FONT *f, int prev_codepoint, int codepoint, ALLEGRO_GLYPH *glyph)
    │ │ │ │ +
    bool al_get_glyph(const ALLEGRO_FONT *f, int prev_codepoint, int codepoint, ALLEGRO_GLYPH *glyph)
│ │ │ │ +bool al_get_glyph(const ALLEGRO_FONT *f, int prev_codepoint, int codepoint, ALLEGRO_GLYPH *glyph)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Gets all the information about a glyph, including the bitmap, needed │ │ │ │ to draw it yourself. prev_codepoint is the codepoint in the string │ │ │ │ before the one you want to draw and is used for kerning. codepoint is │ │ │ │ the character you want to get info about. You should clear the ‘glyph’ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -97,26 +97,28 @@ │ │ │ │ │ o _a_l___g_e_t___g_l_y_p_h │ │ │ │ │ These functions are declared in the following header file. Link with │ │ │ │ │ allegro_font. │ │ │ │ │ #include │ │ │ │ │ ************ GGeenneerraall ffoonntt rroouuttiinneess ************ │ │ │ │ │ ********** AALLLLEEGGRROO__FFOONNTT ********** │ │ │ │ │ typedef struct ALLEGRO_FONT ALLEGRO_FONT; │ │ │ │ │ +typedef struct ALLEGRO_FONT ALLEGRO_FONT; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A handle identifying any kind of font. Usually you will create it with │ │ │ │ │ _a_l___l_o_a_d___f_o_n_t which supports loading all kinds of TrueType fonts supported by │ │ │ │ │ the FreeType library. If you instead pass the filename of a bitmap file, it │ │ │ │ │ will be loaded with _a_l___l_o_a_d___b_i_t_m_a_p and a font in Allegro’s bitmap font format │ │ │ │ │ will be created from it with _a_l___g_r_a_b___f_o_n_t___f_r_o_m___b_i_t_m_a_p. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___d_i_s_a_b_l_e___s_c_r_e_e_n_s_a_v_e_r_._c │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___t_i_m_e_d_w_a_i_t_._c │ │ │ │ │ ********** AALLLLEEGGRROO__GGLLYYPPHH ********** │ │ │ │ │ typedef struct ALLEGRO_GLYPH ALLEGRO_GLYPH; │ │ │ │ │ +typedef struct ALLEGRO_GLYPH ALLEGRO_GLYPH; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A structure containing the properties of a character in a font. │ │ │ │ │ typedef struct ALLEGRO_GLYPH { │ │ │ │ │ ALLEGRO_BITMAP *bitmap; // the bitmap the character is on │ │ │ │ │ int x; // the x position of the glyph on bitmap │ │ │ │ │ int y; // the y position of the glyph on bitmap │ │ │ │ │ int w; // the width of the glyph in pixels │ │ │ │ │ @@ -139,14 +141,15 @@ │ │ │ │ │ Since: 5.2.1 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: This API is new and subject to refinement. │ │ │ │ │ See also: _a_l___g_e_t___g_l_y_p_h │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ********** aall__iinniitt__ffoonntt__aaddddoonn ********** │ │ │ │ │ bool al_init_font_addon(void) │ │ │ │ │ +bool al_init_font_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Initialise the font addon. │ │ │ │ │ Note that if you intend to load bitmap fonts, you will need to initialise │ │ │ │ │ allegro_image separately (unless you are using another library to load images). │ │ │ │ │ Similarly, if you wish to load truetype-fonts, do not forget to also call │ │ │ │ │ _a_l___i_n_i_t___t_t_f___a_d_d_o_n. │ │ │ │ │ Returns true on success, false on failure. On the 5.0 branch, this function has │ │ │ │ │ @@ -156,61 +159,68 @@ │ │ │ │ │ See also: _a_l___i_n_i_t___i_m_a_g_e___a_d_d_o_n, _a_l___i_n_i_t___t_t_f___a_d_d_o_n, _a_l___s_h_u_t_d_o_w_n___f_o_n_t___a_d_d_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___d_i_s_a_b_l_e___s_c_r_e_e_n_s_a_v_e_r_._c │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___t_i_m_e_d_w_a_i_t_._c │ │ │ │ │ ********** aall__iiss__ffoonntt__aaddddoonn__iinniittiiaalliizzeedd ********** │ │ │ │ │ bool al_is_font_addon_initialized(void) │ │ │ │ │ +bool al_is_font_addon_initialized(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the font addon is initialized, otherwise returns false. │ │ │ │ │ Since: 5.2.6 │ │ │ │ │ See also: _a_l___i_n_i_t___f_o_n_t___a_d_d_o_n, _a_l___s_h_u_t_d_o_w_n___f_o_n_t___a_d_d_o_n │ │ │ │ │ ********** aall__sshhuuttddoowwnn__ffoonntt__aaddddoonn ********** │ │ │ │ │ void al_shutdown_font_addon(void) │ │ │ │ │ +void al_shutdown_font_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Shut down the font addon. This is done automatically at program exit, but can │ │ │ │ │ be called any time the user wishes as well. │ │ │ │ │ See also: _a_l___i_n_i_t___f_o_n_t___a_d_d_o_n │ │ │ │ │ ********** aall__llooaadd__ffoonntt ********** │ │ │ │ │ ALLEGRO_FONT *al_load_font(char const *filename, int size, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_font(char const *filename, int size, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Loads a font from disk. This will use _a_l___l_o_a_d___b_i_t_m_a_p___f_o_n_t___f_l_a_g_s if you pass the │ │ │ │ │ name of a known bitmap format, or else _a_l___l_o_a_d___t_t_f___f_o_n_t. │ │ │ │ │ The flags parameter is passed through to either of those functions. Bitmap and │ │ │ │ │ TTF fonts are also affected by the current _b_i_t_m_a_p_ _f_l_a_g_s at the time the font is │ │ │ │ │ loaded. │ │ │ │ │ See also: _a_l___d_e_s_t_r_o_y___f_o_n_t, _a_l___i_n_i_t___f_o_n_t___a_d_d_o_n, _a_l___r_e_g_i_s_t_e_r___f_o_n_t___l_o_a_d_e_r, │ │ │ │ │ _a_l___l_o_a_d___b_i_t_m_a_p___f_o_n_t___f_l_a_g_s, _a_l___l_o_a_d___t_t_f___f_o_n_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___m_e_m_b_m_p_._c │ │ │ │ │ * _e_x___w_i_n_d_o_w___t_i_t_l_e_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__ffoonntt ********** │ │ │ │ │ void al_destroy_font(ALLEGRO_FONT *f) │ │ │ │ │ +void al_destroy_font(ALLEGRO_FONT *f) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Frees the memory being used by a font structure. Does nothing if passed NULL. │ │ │ │ │ See also: _a_l___l_o_a_d___f_o_n_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___d_i_s_a_b_l_e___s_c_r_e_e_n_s_a_v_e_r_._c │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___c_p_u_._c │ │ │ │ │ ********** aall__rreeggiisstteerr__ffoonntt__llooaaddeerr ********** │ │ │ │ │ bool al_register_font_loader(char const *extension, │ │ │ │ │ ALLEGRO_FONT *(*load_font)(char const *filename, int size, int flags)) │ │ │ │ │ +bool al_register_font_loader(char const *extension, │ │ │ │ │ + ALLEGRO_FONT *(*load_font)(char const *filename, int size, int flags)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Informs Allegro of a new font file type, telling it how to load files of this │ │ │ │ │ format. │ │ │ │ │ The extension should include the leading dot (‘.’) character. It will be │ │ │ │ │ matched case-insensitively. │ │ │ │ │ The load_font argument may be NULL to unregister an entry. │ │ │ │ │ Returns true on success, false on error. Returns false if unregistering an │ │ │ │ │ entry that doesn’t exist. │ │ │ │ │ See also: _a_l___i_n_i_t___f_o_n_t___a_d_d_o_n │ │ │ │ │ ********** aall__ggeett__ffoonntt__lliinnee__hheeiigghhtt ********** │ │ │ │ │ int al_get_font_line_height(const ALLEGRO_FONT *f) │ │ │ │ │ +int al_get_font_line_height(const ALLEGRO_FONT *f) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the usual height of a line of text in the specified font. For bitmap │ │ │ │ │ fonts this is simply the height of all glyph bitmaps. For truetype fonts it is │ │ │ │ │ whatever the font file specifies. In particular, some special glyphs may be │ │ │ │ │ higher than the height returned here. │ │ │ │ │ If the X is the position you specify to draw text, the meaning of ascent and │ │ │ │ │ descent and the line height is like in the figure below. │ │ │ │ │ @@ -228,46 +238,53 @@ │ │ │ │ │ See also: _a_l___g_e_t___t_e_x_t___w_i_d_t_h, _a_l___g_e_t___t_e_x_t___d_i_m_e_n_s_i_o_n_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___m_e_m_b_m_p_._c │ │ │ │ │ * _e_x___m_o_u_s_e___w_a_r_p_._c │ │ │ │ │ ********** aall__ggeett__ffoonntt__aasscceenntt ********** │ │ │ │ │ int al_get_font_ascent(const ALLEGRO_FONT *f) │ │ │ │ │ +int al_get_font_ascent(const ALLEGRO_FONT *f) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the ascent of the specified font. │ │ │ │ │ See also: _a_l___g_e_t___f_o_n_t___d_e_s_c_e_n_t, _a_l___g_e_t___f_o_n_t___l_i_n_e___h_e_i_g_h_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ********** aall__ggeett__ffoonntt__ddeesscceenntt ********** │ │ │ │ │ int al_get_font_descent(const ALLEGRO_FONT *f) │ │ │ │ │ +int al_get_font_descent(const ALLEGRO_FONT *f) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the descent of the specified font. │ │ │ │ │ See also: _a_l___g_e_t___f_o_n_t___a_s_c_e_n_t, _a_l___g_e_t___f_o_n_t___l_i_n_e___h_e_i_g_h_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ********** aall__ggeett__tteexxtt__wwiiddtthh ********** │ │ │ │ │ int al_get_text_width(const ALLEGRO_FONT *f, const char *str) │ │ │ │ │ +int al_get_text_width(const ALLEGRO_FONT *f, const char *str) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Calculates the length of a string in a particular font, in pixels. │ │ │ │ │ See also: _a_l___g_e_t___u_s_t_r___w_i_d_t_h, _a_l___g_e_t___f_o_n_t___l_i_n_e___h_e_i_g_h_t, _a_l___g_e_t___t_e_x_t___d_i_m_e_n_s_i_o_n_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___d_i_s_p_l_a_y___o_p_t_i_o_n_s_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ * _e_x___c_o_l_o_r___g_r_a_d_i_e_n_t_._c │ │ │ │ │ ********** aall__ggeett__uussttrr__wwiiddtthh ********** │ │ │ │ │ int al_get_ustr_width(const ALLEGRO_FONT *f, ALLEGRO_USTR const *ustr) │ │ │ │ │ +int al_get_ustr_width(const ALLEGRO_FONT *f, ALLEGRO_USTR const *ustr) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___g_e_t___t_e_x_t___w_i_d_t_h but expects an ALLEGRO_USTR. │ │ │ │ │ See also: _a_l___g_e_t___t_e_x_t___w_i_d_t_h, _a_l___g_e_t___u_s_t_r___d_i_m_e_n_s_i_o_n_s │ │ │ │ │ Examples: │ │ │ │ │ * _n_i_h_g_u_i_._c_p_p │ │ │ │ │ ********** aall__ddrraaww__tteexxtt ********** │ │ │ │ │ void al_draw_text(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ │ char const *text) │ │ │ │ │ +void al_draw_text(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ │ + char const *text) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Writes the NUL-terminated string text onto the target bitmap at position x, y, │ │ │ │ │ using the specified font. │ │ │ │ │ The flags parameter can be 0 or one of the following flags: │ │ │ │ │ * ALLEGRO_ALIGN_LEFT - Draw the text left-aligned (same as 0). │ │ │ │ │ * ALLEGRO_ALIGN_CENTRE - Draw the text centered around the given position. │ │ │ │ │ * ALLEGRO_ALIGN_RIGHT - Draw the text right-aligned to the given position. │ │ │ │ │ @@ -282,26 +299,32 @@ │ │ │ │ │ * _e_x___d_i_s_a_b_l_e___s_c_r_e_e_n_s_a_v_e_r_._c │ │ │ │ │ * _e_x___t_i_m_e_d_w_a_i_t_._c │ │ │ │ │ * _e_x___d_i_s_p_l_a_y___e_v_e_n_t_s_._c │ │ │ │ │ ********** aall__ddrraaww__uussttrr ********** │ │ │ │ │ void al_draw_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ │ const ALLEGRO_USTR *ustr) │ │ │ │ │ +void al_draw_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ │ + const ALLEGRO_USTR *ustr) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___d_r_a_w___t_e_x_t, except the text is passed as an ALLEGRO_USTR instead of a │ │ │ │ │ NUL-terminated char array. │ │ │ │ │ See also: _a_l___d_r_a_w___t_e_x_t, _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___u_s_t_r, _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___u_s_t_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___m_u_l_t_i_l_i_n_e_._c_p_p │ │ │ │ │ * _n_i_h_g_u_i_._c_p_p │ │ │ │ │ * _e_x___b_l_e_n_d_._c │ │ │ │ │ ********** aall__ddrraaww__jjuussttiiffiieedd__tteexxtt ********** │ │ │ │ │ void al_draw_justified_text(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ │ float y, float diff, int flags, const char *text) │ │ │ │ │ +void al_draw_justified_text(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ │ + float y, float diff, int flags, const char *text) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___d_r_a_w___t_e_x_t, but justifies the string to the region x1-x2. │ │ │ │ │ The diff parameter is the maximum amount of horizontal space to allow between │ │ │ │ │ words. If justisfying the text would exceed diff pixels, or the string contains │ │ │ │ │ less than two words, then the string will be drawn left aligned. │ │ │ │ │ The flags parameter can be 0 or one of the following flags: │ │ │ │ │ * ALLEGRO_ALIGN_INTEGER - Draw text aligned to integer pixel positions. │ │ │ │ │ @@ -309,42 +332,54 @@ │ │ │ │ │ See also: _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___t_e_x_t_f, _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___u_s_t_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ ********** aall__ddrraaww__jjuussttiiffiieedd__uussttrr ********** │ │ │ │ │ void al_draw_justified_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ │ float y, float diff, int flags, const ALLEGRO_USTR *ustr) │ │ │ │ │ +void al_draw_justified_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ │ + float y, float diff, int flags, const ALLEGRO_USTR *ustr) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___t_e_x_t, except the text is passed as an ALLEGRO_USTR │ │ │ │ │ instead of a NUL-terminated char array. │ │ │ │ │ See also: _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___t_e_x_t, _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___t_e_x_t_f. │ │ │ │ │ ********** aall__ddrraaww__tteexxttff ********** │ │ │ │ │ void al_draw_textf(const ALLEGRO_FONT *font, ALLEGRO_COLOR color, │ │ │ │ │ float x, float y, int flags, │ │ │ │ │ const char *format, ...) │ │ │ │ │ +void al_draw_textf(const ALLEGRO_FONT *font, ALLEGRO_COLOR color, │ │ │ │ │ + float x, float y, int flags, │ │ │ │ │ + const char *format, ...) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Formatted text output, using a printf() style format string. All parameters │ │ │ │ │ have the same meaning as with _a_l___d_r_a_w___t_e_x_t otherwise. │ │ │ │ │ See also: _a_l___d_r_a_w___t_e_x_t, _a_l___d_r_a_w___u_s_t_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___d_i_s_a_b_l_e___s_c_r_e_e_n_s_a_v_e_r_._c │ │ │ │ │ * _e_x___t_i_m_e_d_w_a_i_t_._c │ │ │ │ │ * _e_x___d_i_s_p_l_a_y___e_v_e_n_t_s_._c │ │ │ │ │ ********** aall__ddrraaww__jjuussttiiffiieedd__tteexxttff ********** │ │ │ │ │ void al_draw_justified_textf(const ALLEGRO_FONT *f, │ │ │ │ │ ALLEGRO_COLOR color, float x1, float x2, float y, │ │ │ │ │ float diff, int flags, const char *format, ...) │ │ │ │ │ +void al_draw_justified_textf(const ALLEGRO_FONT *f, │ │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, float y, │ │ │ │ │ + float diff, int flags, const char *format, ...) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Formatted text output, using a printf() style format string. All parameters │ │ │ │ │ have the same meaning as with _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___t_e_x_t otherwise. │ │ │ │ │ See also: _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___t_e_x_t, _a_l___d_r_a_w___j_u_s_t_i_f_i_e_d___u_s_t_r. │ │ │ │ │ ********** aall__ggeett__tteexxtt__ddiimmeennssiioonnss ********** │ │ │ │ │ void al_get_text_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ char const *text, │ │ │ │ │ int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ +void al_get_text_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ + char const *text, │ │ │ │ │ + int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sometimes, the _a_l___g_e_t___t_e_x_t___w_i_d_t_h and _a_l___g_e_t___f_o_n_t___l_i_n_e___h_e_i_g_h_t functions are not │ │ │ │ │ enough for exact text placement, so this function returns some additional │ │ │ │ │ information. │ │ │ │ │ Returned variables (all in pixels): │ │ │ │ │ * x, y - Offset to upper left corner of bounding box. │ │ │ │ │ * w, h - Dimensions of bounding box. │ │ │ │ │ @@ -354,25 +389,30 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ * _e_x___l_o_g_o_._c │ │ │ │ │ ********** aall__ggeett__uussttrr__ddiimmeennssiioonnss ********** │ │ │ │ │ void al_get_ustr_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ ALLEGRO_USTR const *ustr, │ │ │ │ │ int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ +void al_get_ustr_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ + ALLEGRO_USTR const *ustr, │ │ │ │ │ + int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___g_e_t___t_e_x_t___d_i_m_e_n_s_i_o_n_s, except the text is passed as an ALLEGRO_USTR │ │ │ │ │ instead of a NUL-terminated char array. │ │ │ │ │ See also: _a_l___g_e_t___t_e_x_t___d_i_m_e_n_s_i_o_n_s │ │ │ │ │ ********** aall__ggeett__aalllleeggrroo__ffoonntt__vveerrssiioonn ********** │ │ │ │ │ uint32_t al_get_allegro_font_version(void) │ │ │ │ │ +uint32_t al_get_allegro_font_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ ********** aall__ggeett__ffoonntt__rraannggeess ********** │ │ │ │ │ int al_get_font_ranges(ALLEGRO_FONT *f, int ranges_count, int *ranges) │ │ │ │ │ +int al_get_font_ranges(ALLEGRO_FONT *f, int ranges_count, int *ranges) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Gets information about all glyphs contained in a font, as a list of ranges. │ │ │ │ │ Ranges have the same format as with _a_l___g_r_a_b___f_o_n_t___f_r_o_m___b_i_t_m_a_p. │ │ │ │ │ ranges_count is the maximum number of ranges that will be returned. │ │ │ │ │ ranges should be an array with room for ranges_count * 2 elements. The even │ │ │ │ │ integers are the first unicode point in a range, the odd integers the last │ │ │ │ │ unicode point in a range. │ │ │ │ │ @@ -380,24 +420,26 @@ │ │ │ │ │ ranges_count). │ │ │ │ │ Since: 5.1.4 │ │ │ │ │ See also: _a_l___g_r_a_b___f_o_n_t___f_r_o_m___b_i_t_m_a_p │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ********** aall__sseett__ffaallllbbaacckk__ffoonntt ********** │ │ │ │ │ void al_set_fallback_font(ALLEGRO_FONT *font, ALLEGRO_FONT *fallback) │ │ │ │ │ +void al_set_fallback_font(ALLEGRO_FONT *font, ALLEGRO_FONT *fallback) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sets a font which is used instead if a character is not present. Can be │ │ │ │ │ chained, but make sure there is no loop as that would crash the application! │ │ │ │ │ Pass NULL to remove a fallback font again. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ See also: _a_l___g_e_t___f_a_l_l_b_a_c_k___f_o_n_t, _a_l___d_r_a_w___g_l_y_p_h, _a_l___d_r_a_w___t_e_x_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ********** aall__ggeett__ffaallllbbaacckk__ffoonntt ********** │ │ │ │ │ ALLEGRO_FONT *al_get_fallback_font(ALLEGRO_FONT *font) │ │ │ │ │ +ALLEGRO_FONT *al_get_fallback_font(ALLEGRO_FONT *font) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Retrieves the fallback font for this font or NULL. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ See also: _a_l___s_e_t___f_a_l_l_b_a_c_k___f_o_n_t │ │ │ │ │ ************ PPeerr ggllyypphh tteexxtt hhaannddlliinngg ************ │ │ │ │ │ For some applications Allegro’s text drawing functions may not be sufficient. │ │ │ │ │ For example, you would like to give a different color to every letter in a │ │ │ │ │ @@ -409,14 +451,17 @@ │ │ │ │ │ glyph functions have less overhead than Allegro’s per string text drawing and │ │ │ │ │ dimensioning functions. So, with these functions you can write your own │ │ │ │ │ efficient and precise custom text drawing functions. │ │ │ │ │ ********** aall__ddrraaww__ggllyypphh ********** │ │ │ │ │ void al_draw_glyph(const ALLEGRO_FONT *f, ALLEGRO_COLOR color, float x, float │ │ │ │ │ y, │ │ │ │ │ int codepoint) │ │ │ │ │ +void al_draw_glyph(const ALLEGRO_FONT *f, ALLEGRO_COLOR color, float x, float │ │ │ │ │ +y, │ │ │ │ │ + int codepoint) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws the glyph that corresponds with codepoint in the given color using the │ │ │ │ │ given font. If font does not have such a glyph, nothing will be drawn. │ │ │ │ │ To draw a string as left to right horizontal text you will need to use │ │ │ │ │ _a_l___g_e_t___g_l_y_p_h___a_d_v_a_n_c_e to determine the position of each glyph. For drawing │ │ │ │ │ strings in other directions, such as top to down, use _a_l___g_e_t___g_l_y_p_h___d_i_m_e_n_s_i_o_n_s │ │ │ │ │ to determine the size and position of each glyph. │ │ │ │ │ @@ -427,23 +472,26 @@ │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ See also: _a_l___g_e_t___g_l_y_p_h___w_i_d_t_h, _a_l___g_e_t___g_l_y_p_h___d_i_m_e_n_s_i_o_n_s, _a_l___g_e_t___g_l_y_p_h___a_d_v_a_n_c_e. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t_._c │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ********** aall__ggeett__ggllyypphh__wwiiddtthh ********** │ │ │ │ │ int al_get_glyph_width(const ALLEGRO_FONT *f, int codepoint) │ │ │ │ │ -_S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ +int al_get_glyph_width(const ALLEGRO_FONT *f, int codepoint) │ │ │ │ │ +_S_o_u_r_c_e_ _C_o_d_e) │ │ │ │ │ This function returns the width in pixels of the glyph that corresponds with │ │ │ │ │ codepoint in the font font. Returns zero if the font does not have such a │ │ │ │ │ glyph. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ See also: _a_l___d_r_a_w___g_l_y_p_h, _a_l___g_e_t___g_l_y_p_h___d_i_m_e_n_s_i_o_n_s, _a_l___g_e_t___g_l_y_p_h___a_d_v_a_n_c_e. │ │ │ │ │ ********** aall__ggeett__ggllyypphh__ddiimmeennssiioonnss ********** │ │ │ │ │ bool al_get_glyph_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ int codepoint, int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ +bool al_get_glyph_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ + int codepoint, int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sometimes, the _a_l___g_e_t___g_l_y_p_h___w_i_d_t_h or _a_l___g_e_t___g_l_y_p_h___a_d_v_a_n_c_e functions are not │ │ │ │ │ enough for exact glyph placement, so this function returns some additional │ │ │ │ │ information, particularly if you want to draw the font vertically. │ │ │ │ │ The function itself returns true if the character was present in font and false │ │ │ │ │ if the character was not present in font. │ │ │ │ │ Returned variables (all in pixel): │ │ │ │ │ @@ -483,14 +531,15 @@ │ │ │ │ │ +---+-------+ │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ See also: _a_l___d_r_a_w___g_l_y_p_h, _a_l___g_e_t___g_l_y_p_h___w_i_d_t_h, _a_l___g_e_t___g_l_y_p_h___a_d_v_a_n_c_e. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ********** aall__ggeett__ggllyypphh__aaddvvaannccee ********** │ │ │ │ │ int al_get_glyph_advance(const ALLEGRO_FONT *f, int codepoint1, int codepoint2) │ │ │ │ │ +int al_get_glyph_advance(const ALLEGRO_FONT *f, int codepoint1, int codepoint2) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This function returns by how much the x position should be advanced for left to │ │ │ │ │ right text drawing when the glyph that corresponds to codepoint1 has been │ │ │ │ │ drawn, and the glyph that corresponds to codepoint2 will be the next to be │ │ │ │ │ drawn. This takes into consideration the horizontal advance width of the glyph │ │ │ │ │ that corresponds with codepoint1 as well as the kerning between the glyphs of │ │ │ │ │ codepoint1 and codepoint2. │ │ │ │ │ @@ -548,14 +597,17 @@ │ │ │ │ │ * _e_x___f_o_n_t_._c │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ************ MMuullttiilliinnee tteexxtt ddrraawwiinngg ************ │ │ │ │ │ ********** aall__ddrraaww__mmuullttiilliinnee__tteexxtt ********** │ │ │ │ │ void al_draw_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ int flags, const char *text) │ │ │ │ │ +void al_draw_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ + int flags, const char *text) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___d_r_a_w___t_e_x_t, but this function supports drawing multiple lines of text. │ │ │ │ │ It will break text in lines based on its contents and the max_width parameter. │ │ │ │ │ The lines are then layed out vertically depending on the line_height parameter │ │ │ │ │ and drawn each as if _a_l___d_r_a_w___t_e_x_t was called on them. │ │ │ │ │ A newline \n in the text will cause a “hard” line break after its occurrence in │ │ │ │ │ the string. The text after a hard break is placed on a new line. Carriage │ │ │ │ │ @@ -584,35 +636,45 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___m_u_l_t_i_l_i_n_e_._c_p_p │ │ │ │ │ * _e_x___r_e_s_i_z_e_2_._c │ │ │ │ │ ********** aall__ddrraaww__mmuullttiilliinnee__uussttrr ********** │ │ │ │ │ void al_draw_multiline_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ int flags, const ALLEGRO_USTR *ustr) │ │ │ │ │ +void al_draw_multiline_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ + int flags, const ALLEGRO_USTR *ustr) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___t_e_x_t, except the text is passed as an ALLEGRO_USTR │ │ │ │ │ instead of a NUL-terminated char array. │ │ │ │ │ Since: 5.1.9 │ │ │ │ │ See also: _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___t_e_x_t, _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___t_e_x_t_f, _a_l___d_o___m_u_l_t_i_l_i_n_e___t_e_x_t │ │ │ │ │ ********** aall__ddrraaww__mmuullttiilliinnee__tteexxttff ********** │ │ │ │ │ void al_draw_multiline_textf(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ int flags, const char *format, ...) │ │ │ │ │ +void al_draw_multiline_textf(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ + int flags, const char *format, ...) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Formatted text output, using a printf() style format string. All parameters │ │ │ │ │ have the same meaning as with _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___t_e_x_t otherwise. │ │ │ │ │ Since: 5.1.9 │ │ │ │ │ See also: _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___t_e_x_t, _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___u_s_t_r, _a_l___d_o___m_u_l_t_i_l_i_n_e___t_e_x_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___r_e_s_i_z_e_2_._c │ │ │ │ │ ********** aall__ddoo__mmuullttiilliinnee__tteexxtt ********** │ │ │ │ │ void al_do_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ │ float max_width, const char *text, │ │ │ │ │ bool (*cb)(int line_num, const char *line, int size, void *extra), │ │ │ │ │ void *extra) │ │ │ │ │ +void al_do_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ │ + float max_width, const char *text, │ │ │ │ │ + bool (*cb)(int line_num, const char *line, int size, void *extra), │ │ │ │ │ + void *extra) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This function processes the text and splits it into lines as │ │ │ │ │ _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___t_e_x_t would, and then calls the callback cb once for every │ │ │ │ │ line. This is useful for custom drawing of multiline text, or for calculating │ │ │ │ │ the size of multiline text ahead of time. See the documentation on │ │ │ │ │ _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___t_e_x_t for an explanation of the splitting algorithm. │ │ │ │ │ For every line that this function splits text into the callback cb will be │ │ │ │ │ @@ -634,23 +696,29 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___m_u_l_t_i_l_i_n_e_._c_p_p │ │ │ │ │ ********** aall__ddoo__mmuullttiilliinnee__uussttrr ********** │ │ │ │ │ void al_do_multiline_ustr(const ALLEGRO_FONT *font, float max_width, │ │ │ │ │ const ALLEGRO_USTR *ustr, │ │ │ │ │ bool (*cb)(int line_num, const ALLEGRO_USTR * line, void *extra), │ │ │ │ │ void *extra) │ │ │ │ │ +void al_do_multiline_ustr(const ALLEGRO_FONT *font, float max_width, │ │ │ │ │ + const ALLEGRO_USTR *ustr, │ │ │ │ │ + bool (*cb)(int line_num, const ALLEGRO_USTR * line, void *extra), │ │ │ │ │ + void *extra) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___d_o___m_u_l_t_i_l_i_n_e___t_e_x_t, but using ALLEGRO_USTR instead of a NUL-terminated │ │ │ │ │ char array for text. │ │ │ │ │ Since: 5.1.9 │ │ │ │ │ See also: _a_l___d_r_a_w___m_u_l_t_i_l_i_n_e___u_s_t_r │ │ │ │ │ ************ BBiittmmaapp ffoonnttss ************ │ │ │ │ │ ********** aall__ggrraabb__ffoonntt__ffrroomm__bbiittmmaapp ********** │ │ │ │ │ ALLEGRO_FONT *al_grab_font_from_bitmap(ALLEGRO_BITMAP *bmp, │ │ │ │ │ int ranges_n, const int ranges[]) │ │ │ │ │ +ALLEGRO_FONT *al_grab_font_from_bitmap(ALLEGRO_BITMAP *bmp, │ │ │ │ │ + int ranges_n, const int ranges[]) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a new font from an Allegro bitmap. You can delete the bitmap after the │ │ │ │ │ function returns as the font will contain a copy for itself. │ │ │ │ │ Parameters: │ │ │ │ │ * bmp: The bitmap with the glyphs drawn onto it │ │ │ │ │ * n: Number of unicode ranges in the bitmap. │ │ │ │ │ * ranges: ‘n’ pairs of first and last unicode point to map glyphs to for │ │ │ │ │ @@ -694,35 +762,38 @@ │ │ │ │ │ characters found in the Allegro 4 font.) │ │ │ │ │ See also: _a_l___l_o_a_d___b_i_t_m_a_p, _a_l___g_r_a_b___f_o_n_t___f_r_o_m___b_i_t_m_a_p │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t_._c │ │ │ │ │ * _e_x___t_t_f_._c │ │ │ │ │ ********** aall__llooaadd__bbiittmmaapp__ffoonntt ********** │ │ │ │ │ ALLEGRO_FONT *al_load_bitmap_font(const char *fname) │ │ │ │ │ +ALLEGRO_FONT *al_load_bitmap_font(const char *fname) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Load a bitmap font from a file. This is done by first calling │ │ │ │ │ _a_l___l_o_a_d___b_i_t_m_a_p___f_l_a_g_s and then _a_l___g_r_a_b___f_o_n_t___f_r_o_m___b_i_t_m_a_p. │ │ │ │ │ If you wanted to load an old A4 font, for example, it would be better to load │ │ │ │ │ the bitmap yourself in order to call _a_l___c_o_n_v_e_r_t___m_a_s_k___t_o___a_l_p_h_a on it before │ │ │ │ │ passing it to _a_l___g_r_a_b___f_o_n_t___f_r_o_m___b_i_t_m_a_p. │ │ │ │ │ See also: _a_l___l_o_a_d___b_i_t_m_a_p___f_o_n_t___f_l_a_g_s, _a_l___l_o_a_d___f_o_n_t, _a_l___l_o_a_d___b_i_t_m_a_p___f_l_a_g_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___b_i_t_m_a_p___f_l_i_p_._c │ │ │ │ │ * _e_x___m_o_u_s_e___c_u_r_s_o_r_._c │ │ │ │ │ * _e_x___r_e_c_o_r_d___n_a_m_e_._c │ │ │ │ │ ********** aall__llooaadd__bbiittmmaapp__ffoonntt__ffllaaggss ********** │ │ │ │ │ ALLEGRO_FONT *al_load_bitmap_font_flags(const char *fname, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_bitmap_font_flags(const char *fname, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___l_o_a_d___b_i_t_m_a_p___f_o_n_t but additionally takes a flags parameter which is a │ │ │ │ │ bitfield containing a combination of the following: │ │ │ │ │ ALLEGRO_NO_PREMULTIPLIED_ALPHA │ │ │ │ │ The same meaning as for _a_l___l_o_a_d___b_i_t_m_a_p___f_l_a_g_s. │ │ │ │ │ See also: _a_l___l_o_a_d___b_i_t_m_a_p___f_o_n_t, _a_l___l_o_a_d___b_i_t_m_a_p___f_l_a_g_s │ │ │ │ │ ********** aall__ccrreeaattee__bbuuiillttiinn__ffoonntt ********** │ │ │ │ │ ALLEGRO_FONT *al_create_builtin_font(void) │ │ │ │ │ +ALLEGRO_FONT *al_create_builtin_font(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a monochrome bitmap font (8x8 pixels per character). │ │ │ │ │ This font is primarily intended to be used for displaying information in │ │ │ │ │ environments or during early runtime states where no external font data is │ │ │ │ │ available or loaded (e.g. for debugging). │ │ │ │ │ The builtin font contains the following unicode character ranges: │ │ │ │ │ 0x0020 to 0x007F (ASCII) │ │ │ │ │ @@ -740,34 +811,38 @@ │ │ │ │ │ * _e_x___d_i_s_p_l_a_y___e_v_e_n_t_s_._c │ │ │ │ │ ************ TTTTFF ffoonnttss ************ │ │ │ │ │ These functions are declared in the following header file. Link with │ │ │ │ │ allegro_ttf. │ │ │ │ │ #include │ │ │ │ │ ********** aall__iinniitt__ttttff__aaddddoonn ********** │ │ │ │ │ bool al_init_ttf_addon(void) │ │ │ │ │ +bool al_init_ttf_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Call this after _a_l___i_n_i_t___f_o_n_t___a_d_d_o_n to make _a_l___l_o_a_d___f_o_n_t recognize “.ttf” and │ │ │ │ │ other formats supported by _a_l___l_o_a_d___t_t_f___f_o_n_t. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___f_o_n_t___m_u_l_t_i_l_i_n_e_._c_p_p │ │ │ │ │ * _e_x___c_o_l_o_r_._c_p_p │ │ │ │ │ ********** aall__iiss__ttttff__aaddddoonn__iinniittiiaalliizzeedd ********** │ │ │ │ │ bool al_is_ttf_addon_initialized(void) │ │ │ │ │ +bool al_is_ttf_addon_initialized(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the TTF addon is initialized, otherwise returns false. │ │ │ │ │ Since: 5.2.6 │ │ │ │ │ See also: _a_l___i_n_i_t___t_t_f___a_d_d_o_n, _a_l___s_h_u_t_d_o_w_n___t_t_f___a_d_d_o_n │ │ │ │ │ ********** aall__sshhuuttddoowwnn__ttttff__aaddddoonn ********** │ │ │ │ │ void al_shutdown_ttf_addon(void) │ │ │ │ │ +void al_shutdown_ttf_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Unloads the ttf addon again. You normally don’t need to call this. │ │ │ │ │ ********** aall__llooaadd__ttttff__ffoonntt ********** │ │ │ │ │ ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Loads a TrueType font from a file using the FreeType library. Quoting from the │ │ │ │ │ FreeType FAQ this means support for many different font formats: │ │ │ │ │ TTrruueeTTyyppee,, OOppeennTTyyppee,, TTyyppee11,, CCIIDD,, CCFFFF,, WWiinnddoowwss FFOONN//FFNNTT,, XX1111 PPCCFF,, aanndd ootthheerrss │ │ │ │ │ The size parameter determines the size the font will be rendered at, specified │ │ │ │ │ in pixels. The standard font size is measured in uunniittss ppeerr EEMM, if you instead │ │ │ │ │ want to specify the size as the total height of glyphs in pixels, pass it as a │ │ │ │ │ @@ -785,23 +860,27 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___b_i_t_m_a_p___f_l_i_p_._c │ │ │ │ │ * _e_x___s_y_n_t_h_._c_p_p │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__llooaadd__ttttff__ffoonntt__ff ********** │ │ │ │ │ ALLEGRO_FONT *al_load_ttf_font_f(ALLEGRO_FILE *file, │ │ │ │ │ char const *filename, int size, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_f(ALLEGRO_FILE *file, │ │ │ │ │ + char const *filename, int size, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___l_o_a_d___t_t_f___f_o_n_t, but the font is read from the file handle. The filename │ │ │ │ │ is only used to find possible additional files next to a font file. │ │ │ │ │ NNoottee:: The file handle is owned by the returned ALLEGRO_FONT object │ │ │ │ │ and must not be freed by the caller, as FreeType expects to be able │ │ │ │ │ to read from it at a later time. │ │ │ │ │ ********** aall__llooaadd__ttttff__ffoonntt__ssttrreettcchh ********** │ │ │ │ │ ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h, │ │ │ │ │ int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h, │ │ │ │ │ + int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___l_o_a_d___t_t_f___f_o_n_t, except it takes separate width and height parameters │ │ │ │ │ instead of a single size parameter. │ │ │ │ │ If the height is a positive value, and the width zero or positive, then font │ │ │ │ │ will be stretched according to those parameters. The width must not be negative │ │ │ │ │ if the height is positive. │ │ │ │ │ As with _a_l___l_o_a_d___t_t_f___f_o_n_t, the height may be a negative value to specify the │ │ │ │ │ @@ -809,30 +888,35 @@ │ │ │ │ │ Returns NULL if the height is positive while width is negative, or if the │ │ │ │ │ height is negative while the width is positive. │ │ │ │ │ Since: 5.0.6, 5.1.0 │ │ │ │ │ See also: _a_l___l_o_a_d___t_t_f___f_o_n_t, _a_l___l_o_a_d___t_t_f___f_o_n_t___s_t_r_e_t_c_h___f │ │ │ │ │ ********** aall__llooaadd__ttttff__ffoonntt__ssttrreettcchh__ff ********** │ │ │ │ │ ALLEGRO_FONT *al_load_ttf_font_stretch_f(ALLEGRO_FILE *file, │ │ │ │ │ char const *filename, int w, int h, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_stretch_f(ALLEGRO_FILE *file, │ │ │ │ │ + char const *filename, int w, int h, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___l_o_a_d___t_t_f___f_o_n_t___s_t_r_e_t_c_h, but the font is read from the file handle. The │ │ │ │ │ filename is only used to find possible additional files next to a font file. │ │ │ │ │ NNoottee:: The file handle is owned by the returned ALLEGRO_FONT object │ │ │ │ │ and must not be freed by the caller, as FreeType expects to be able │ │ │ │ │ to read from it at a later time. │ │ │ │ │ Since: 5.0.6, 5.1.0 │ │ │ │ │ See also: _a_l___l_o_a_d___t_t_f___f_o_n_t___s_t_r_e_t_c_h │ │ │ │ │ ********** aall__ggeett__aalllleeggrroo__ttttff__vveerrssiioonn ********** │ │ │ │ │ uint32_t al_get_allegro_ttf_version(void) │ │ │ │ │ +uint32_t al_get_allegro_ttf_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ ********** aall__ggeett__ggllyypphh ********** │ │ │ │ │ bool al_get_glyph(const ALLEGRO_FONT *f, int prev_codepoint, int codepoint, │ │ │ │ │ ALLEGRO_GLYPH *glyph) │ │ │ │ │ +bool al_get_glyph(const ALLEGRO_FONT *f, int prev_codepoint, int codepoint, │ │ │ │ │ +ALLEGRO_GLYPH *glyph) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Gets all the information about a glyph, including the bitmap, needed to draw it │ │ │ │ │ yourself. prev_codepoint is the codepoint in the string before the one you want │ │ │ │ │ to draw and is used for kerning. codepoint is the character you want to get │ │ │ │ │ info about. You should clear the ‘glyph’ structure to 0 with memset before │ │ │ │ │ passing it to this function for future compatibility. │ │ │ │ │ Since: 5.2.1 │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/fshook.html │ │ │ │ @@ -242,15 +242,16 @@ │ │ │ │ │ │ │ │

    These functions are declared in the main Allegro header file:

    │ │ │ │ 
     #include <allegro5/allegro.h>
    │ │ │ │

    These functions allow access to the filesystem. This can either be │ │ │ │ the real filesystem like your harddrive, or a virtual filesystem like a │ │ │ │ .zip archive (or whatever else you or an addon makes it do).

    │ │ │ │

    ALLEGRO_FS_ENTRY

    │ │ │ │ -
    typedef struct ALLEGRO_FS_ENTRY ALLEGRO_FS_ENTRY;
    │ │ │ │ +
    typedef struct ALLEGRO_FS_ENTRY ALLEGRO_FS_ENTRY;
│ │ │ │ +typedef struct ALLEGRO_FS_ENTRY ALLEGRO_FS_ENTRY;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Opaque filesystem entry object. Represents a file or a directory │ │ │ │ (check with al_get_fs_entry_mode). There │ │ │ │ are no user accessible member variables.

    │ │ │ │ @@ -258,15 +259,16 @@ │ │ │ │ │ │ │ │

    ALLEGRO_FILE_MODE

    │ │ │ │ -
    typedef enum ALLEGRO_FILE_MODE
    │ │ │ │ +
    typedef enum ALLEGRO_FILE_MODE
│ │ │ │ +typedef enum ALLEGRO_FILE_MODE
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Filesystem modes/types

    │ │ │ │
      │ │ │ │
    • ALLEGRO_FILEMODE_READ - Readable
      • │ │ │ │
    • ALLEGRO_FILEMODE_WRITE - Writable
      • │ │ │ │ @@ -591,15 +593,16 @@ │ │ │ │ entry, but uses the appropriate file interface, not whatever was set │ │ │ │ with the latest call to al_set_new_file_interface.

      │ │ │ │

      Returns the handle on success, NULL on error.

      │ │ │ │

      See also: al_fopen

      │ │ │ │

      ALLEGRO_FOR_EACH_FS_ENTRY_RESULT

      │ │ │ │ -
      typedef enum ALLEGRO_FOR_EACH_FS_ENTRY_RESULT {
      │ │ │ │ +
      typedef enum ALLEGRO_FOR_EACH_FS_ENTRY_RESULT {
│ │ │ │ +typedef enum ALLEGRO_FOR_EACH_FS_ENTRY_RESULT {
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Return values for the callbacks of al_for_each_fs_entry and for │ │ │ │ that function itself.

      │ │ │ │
        │ │ │ │ @@ -678,15 +681,16 @@ │ │ │ │

        By default, Allegro uses platform specific filesystem functions for │ │ │ │ things like directory access. However if for example the files of your │ │ │ │ game are not in the local filesystem but inside some file archive, you │ │ │ │ can provide your own set of functions (or use an addon which does this │ │ │ │ for you, for example our physfs addon allows access to the most common │ │ │ │ archive formats).

        │ │ │ │

        ALLEGRO_FS_INTERFACE

        │ │ │ │ -
        typedef struct ALLEGRO_FS_INTERFACE ALLEGRO_FS_INTERFACE;
        │ │ │ │ +
        typedef struct ALLEGRO_FS_INTERFACE ALLEGRO_FS_INTERFACE;
│ │ │ │ +typedef struct ALLEGRO_FS_INTERFACE ALLEGRO_FS_INTERFACE;
        │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        The available functions you can provide for a filesystem. They │ │ │ │ are:

        │ │ │ │ 
           ALLEGRO_FS_ENTRY *  fs_create_entry   (const char *path);
│ │ │ │     void                fs_destroy_entry  (ALLEGRO_FS_ENTRY *e);
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -76,22 +76,24 @@
│ │ │ │ │  These functions are declared in the main Allegro header file:
│ │ │ │ │   #include 
│ │ │ │ │  These functions allow access to the filesystem. This can either be the real
│ │ │ │ │  filesystem like your harddrive, or a virtual filesystem like a .zip archive (or
│ │ │ │ │  whatever else you or an addon makes it do).
│ │ │ │ │  ************ AALLLLEEGGRROO__FFSS__EENNTTRRYY ************
│ │ │ │ │  typedef struct ALLEGRO_FS_ENTRY ALLEGRO_FS_ENTRY;
│ │ │ │ │ +typedef struct ALLEGRO_FS_ENTRY ALLEGRO_FS_ENTRY;
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Opaque filesystem entry object. Represents a file or a directory (check with
│ │ │ │ │  _a_l___g_e_t___f_s___e_n_t_r_y___m_o_d_e). There are no user accessible member variables.
│ │ │ │ │  Examples:
│ │ │ │ │      * _e_x___d_i_r_._c
│ │ │ │ │      * _e_x___p_h_y_s_f_s_._c
│ │ │ │ │  ************ AALLLLEEGGRROO__FFIILLEE__MMOODDEE ************
│ │ │ │ │  typedef enum ALLEGRO_FILE_MODE
│ │ │ │ │ +typedef enum ALLEGRO_FILE_MODE
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Filesystem modes/types
│ │ │ │ │      * ALLEGRO_FILEMODE_READ - Readable
│ │ │ │ │      * ALLEGRO_FILEMODE_WRITE - Writable
│ │ │ │ │      * ALLEGRO_FILEMODE_EXECUTE - Executable
│ │ │ │ │      * ALLEGRO_FILEMODE_HIDDEN - Hidden
│ │ │ │ │      * ALLEGRO_FILEMODE_ISFILE - Regular file
│ │ │ │ │ @@ -279,14 +281,15 @@
│ │ │ │ │  This is like calling _a_l___f_o_p_e_n with the name of the filesystem entry, but uses
│ │ │ │ │  the appropriate file interface, not whatever was set with the latest call to
│ │ │ │ │  _a_l___s_e_t___n_e_w___f_i_l_e___i_n_t_e_r_f_a_c_e.
│ │ │ │ │  Returns the handle on success, NULL on error.
│ │ │ │ │  See also: _a_l___f_o_p_e_n
│ │ │ │ │  ********** AALLLLEEGGRROO__FFOORR__EEAACCHH__FFSS__EENNTTRRYY__RREESSUULLTT **********
│ │ │ │ │  typedef enum ALLEGRO_FOR_EACH_FS_ENTRY_RESULT {
│ │ │ │ │ +typedef enum ALLEGRO_FOR_EACH_FS_ENTRY_RESULT {
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Return values for the callbacks of _a_l___f_o_r___e_a_c_h___f_s___e_n_t_r_y and for that function
│ │ │ │ │  itself.
│ │ │ │ │      * ALLEGRO_FOR_EACH_FS_ENTRY_ERROR - An error ocurred.
│ │ │ │ │      * ALLEGRO_FOR_EACH_FS_ENTRY_OK - Continue normally and recurse into
│ │ │ │ │        directories.
│ │ │ │ │      * ALLEGRO_FOR_EACH_FS_ENTRY_SKIP - Continue but do NOT recusively descend.
│ │ │ │ │ @@ -333,14 +336,15 @@
│ │ │ │ │  By default, Allegro uses platform specific filesystem functions for things like
│ │ │ │ │  directory access. However if for example the files of your game are not in the
│ │ │ │ │  local filesystem but inside some file archive, you can provide your own set of
│ │ │ │ │  functions (or use an addon which does this for you, for example our physfs
│ │ │ │ │  addon allows access to the most common archive formats).
│ │ │ │ │  ********** AALLLLEEGGRROO__FFSS__IINNTTEERRFFAACCEE **********
│ │ │ │ │  typedef struct ALLEGRO_FS_INTERFACE ALLEGRO_FS_INTERFACE;
│ │ │ │ │ +typedef struct ALLEGRO_FS_INTERFACE ALLEGRO_FS_INTERFACE;
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  The available functions you can provide for a filesystem. They are:
│ │ │ │ │     ALLEGRO_FS_ENTRY *  fs_create_entry   (const char *path);
│ │ │ │ │     void                fs_destroy_entry  (ALLEGRO_FS_ENTRY *e);
│ │ │ │ │     const char *        fs_entry_name     (ALLEGRO_FS_ENTRY *e);
│ │ │ │ │     bool                fs_update_entry   (ALLEGRO_FS_ENTRY *e);
│ │ │ │ │     uint32_t            fs_entry_mode     (ALLEGRO_FS_ENTRY *e);
│ │ │ ├── ./usr/share/doc/allegro5-doc/refman/fullscreen_mode.html
│ │ │ │ @@ -180,15 +180,16 @@
│ │ │ │  
      • al_get_num_display_modes
        • 
│ │ │ │
      │ │ │ │ │ │ │ │

      These functions are declared in the main Allegro header file:

      │ │ │ │ 
       #include <allegro5/allegro.h>
      │ │ │ │

      ALLEGRO_DISPLAY_MODE

      │ │ │ │ -
      typedef struct ALLEGRO_DISPLAY_MODE
      │ │ │ │ +
      typedef struct ALLEGRO_DISPLAY_MODE
│ │ │ │ +typedef struct ALLEGRO_DISPLAY_MODE
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Used for fullscreen mode queries. Contains information about a │ │ │ │ supported fullscreen modes.

      │ │ │ │ 
      typedef struct ALLEGRO_DISPLAY_MODE {
│ │ │ │     int width;          // Screen width
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -46,14 +46,15 @@
│ │ │ │ │      * _A_L_L_E_G_R_O___D_I_S_P_L_A_Y___M_O_D_E
│ │ │ │ │      * _a_l___g_e_t___d_i_s_p_l_a_y___m_o_d_e
│ │ │ │ │      * _a_l___g_e_t___n_u_m___d_i_s_p_l_a_y___m_o_d_e_s
│ │ │ │ │  These functions are declared in the main Allegro header file:
│ │ │ │ │   #include 
│ │ │ │ │  ************ AALLLLEEGGRROO__DDIISSPPLLAAYY__MMOODDEE ************
│ │ │ │ │  typedef struct ALLEGRO_DISPLAY_MODE
│ │ │ │ │ +typedef struct ALLEGRO_DISPLAY_MODE
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Used for fullscreen mode queries. Contains information about a supported
│ │ │ │ │  fullscreen modes.
│ │ │ │ │  typedef struct ALLEGRO_DISPLAY_MODE {
│ │ │ │ │     int width;          // Screen width
│ │ │ │ │     int height;         // Screen height
│ │ │ │ │     int format;         // The pixel format of the mode
│ │ │ ├── ./usr/share/doc/allegro5-doc/refman/graphics.html
│ │ │ │ @@ -441,15 +441,16 @@
│ │ │ │
    │ │ │ │ │ │ │ │ │ │ │ │

    These functions are declared in the main Allegro header file:

    │ │ │ │ 
     #include <allegro5/allegro.h>
    │ │ │ │

    Colors

    │ │ │ │

    ALLEGRO_COLOR

    │ │ │ │ -
    typedef struct ALLEGRO_COLOR ALLEGRO_COLOR;
    │ │ │ │ +
    typedef struct ALLEGRO_COLOR ALLEGRO_COLOR;
│ │ │ │ +typedef struct ALLEGRO_COLOR ALLEGRO_COLOR;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An ALLEGRO_COLOR structure describes a color in a device independent │ │ │ │ way. Use al_map_rgb et al. and al_unmap_rgb et al. to translate │ │ │ │ from and to various color representations.

    │ │ │ │ @@ -474,18 +475,18 @@ │ │ │ │

    This function can be called before Allegro is initialized.

    │ │ │ │

    See also: al_map_rgba, al_map_rgba_f, al_map_rgb_f

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_map_rgb_f

    │ │ │ │ 
    ALLEGRO_COLOR al_map_rgb_f(float r, float g, float b)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │ @@ -677,15 +678,16 @@ │ │ │ │
  • ex_blend_test.c
    • │ │ │ │
  • ex_logo.c
    • │ │ │ │ │ │ │ │

    Locking and pixel formats

    │ │ │ │

    ALLEGRO_LOCKED_REGION

    │ │ │ │ -
    typedef struct ALLEGRO_LOCKED_REGION ALLEGRO_LOCKED_REGION;
    │ │ │ │ +
    typedef struct ALLEGRO_LOCKED_REGION ALLEGRO_LOCKED_REGION;
│ │ │ │ +typedef struct ALLEGRO_LOCKED_REGION ALLEGRO_LOCKED_REGION;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Users who wish to manually edit or read from a bitmap are required to │ │ │ │ lock it first. The ALLEGRO_LOCKED_REGION structure represents the locked │ │ │ │ region of the bitmap. This call will work with any bitmap, including │ │ │ │ memory bitmaps.

    │ │ │ │ @@ -722,15 +724,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_lockbitmap.c#L21">ex_lockbitmap.c │ │ │ │
  • ex_premulalpha.c
    • │ │ │ │
  • ex_multisample.c
    • │ │ │ │ │ │ │ │

    ALLEGRO_PIXEL_FORMAT

    │ │ │ │ -
    typedef enum ALLEGRO_PIXEL_FORMAT
    │ │ │ │ +
    typedef enum ALLEGRO_PIXEL_FORMAT
│ │ │ │ +typedef enum ALLEGRO_PIXEL_FORMAT
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Pixel formats. Each pixel format specifies the exact size and bit │ │ │ │ layout of a pixel in memory. Components are specified from high bits to │ │ │ │ low bits, so for example a fully opaque red pixel in ARGB_8888 format is │ │ │ │ 0xFFFF0000.

    │ │ │ │ @@ -1083,15 +1086,16 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    Bitmap creation

    │ │ │ │

    ALLEGRO_BITMAP

    │ │ │ │ -
    typedef struct ALLEGRO_BITMAP ALLEGRO_BITMAP;
    │ │ │ │ +
    typedef struct ALLEGRO_BITMAP ALLEGRO_BITMAP;
│ │ │ │ +typedef struct ALLEGRO_BITMAP ALLEGRO_BITMAP;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Abstract type representing a bitmap (2D image).

    │ │ │ │

    Examples:

    │ │ │ │
      │ │ │ │
    • Examples:

      │ │ │ │       │ │ │ │

      al_convert_bitmap

      │ │ │ │ 
      void al_convert_bitmap(ALLEGRO_BITMAP *bitmap)
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Converts the bitmap to the current bitmap flags and format. The │ │ │ │ @@ -1605,15 +1609,16 @@ │ │ │ │

      │ │ │ │

      Unstable │ │ │ │ API: This is an experimental feature.

      │ │ │ │
      │ │ │ │

      See also: ALLEGRO_BITMAP_WRAP

      │ │ │ │

      ALLEGRO_BITMAP_WRAP

      │ │ │ │ -
      typedef enum ALLEGRO_BITMAP_WRAP {
      │ │ │ │ +
      typedef enum ALLEGRO_BITMAP_WRAP {
│ │ │ │ +typedef enum ALLEGRO_BITMAP_WRAP {
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Controls the how the pixel color is determined from a texture │ │ │ │ querying the texture coordinates are outside the usual bounds.

      │ │ │ │
        │ │ │ │

      • ALLEGRO_BITMAP_WRAP_DEFAULT - The default behavior. This │ │ │ │ @@ -1674,15 +1679,15 @@ │ │ │ │

        Examples:

        │ │ │ │
          │ │ │ │
        • ex_multiwin.c
          • │ │ │ │
        • ex_resize.c
          • │ │ │ │
        • ex_membmp.c
          • │ │ │ │ +href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend_target.c#L52">ex_blend_target.c │ │ │ │
        │ │ │ │

        al_get_bitmap_width

        │ │ │ │ 
        int al_get_bitmap_width(ALLEGRO_BITMAP *bitmap)
        │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Returns the width of a bitmap in pixels.

        │ │ │ │ @@ -3297,15 +3302,16 @@ │ │ │ │

        See also: al_init_image_addon, al_identify_bitmap, al_register_bitmap_identifier

        │ │ │ │

        Render State

        │ │ │ │

        ALLEGRO_RENDER_STATE

        │ │ │ │ 
        typedef enum ALLEGRO_RENDER_STATE {
        │ │ │ │ +class="sourceCode c">typedef enum ALLEGRO_RENDER_STATE { │ │ │ │ +typedef enum ALLEGRO_RENDER_STATE { │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Possible render states which can be set with al_set_render_state:

        │ │ │ │
        │ │ │ │
        ALLEGRO_ALPHA_TEST
        │ │ │ │ @@ -3353,15 +3359,16 @@ │ │ │ │

        See also: al_set_render_state, ALLEGRO_RENDER_FUNCTION, │ │ │ │ ALLEGRO_WRITE_MASK_FLAGS

        │ │ │ │

        ALLEGRO_RENDER_FUNCTION

        │ │ │ │ 
        typedef enum ALLEGRO_RENDER_FUNCTION {
        │ │ │ │ +class="sourceCode c">typedef enum ALLEGRO_RENDER_FUNCTION { │ │ │ │ +typedef enum ALLEGRO_RENDER_FUNCTION { │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Possible functions are:

        │ │ │ │
          │ │ │ │
        • ALLEGRO_RENDER_NEVER
          • │ │ │ │
        • ALLEGRO_RENDER_ALWAYS
          • │ │ │ │ @@ -3375,15 +3382,16 @@ │ │ │ │
        • ALLEGRO_RENDER_GREATER_EQUAL
          • │ │ │ │
        │ │ │ │

        Since: 5.1.2

        │ │ │ │

        See also: al_set_render_state

        │ │ │ │

        ALLEGRO_WRITE_MASK_FLAGS

        │ │ │ │ 
        typedef enum ALLEGRO_WRITE_MASK_FLAGS {
        │ │ │ │ +class="sourceCode c">typedef enum ALLEGRO_WRITE_MASK_FLAGS { │ │ │ │ +typedef enum ALLEGRO_WRITE_MASK_FLAGS { │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Each enabled bit means the corresponding value is written, a disabled │ │ │ │ bit means it is not.

        │ │ │ │
          │ │ │ │
        • ALLEGRO_MASK_RED
          • │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -171,14 +171,15 @@ │ │ │ │ │ o _a_l___b_a_c_k_u_p___d_i_r_t_y___b_i_t_m_a_p │ │ │ │ │ o _a_l___b_a_c_k_u_p___d_i_r_t_y___b_i_t_m_a_p_s │ │ │ │ │ These functions are declared in the main Allegro header file: │ │ │ │ │ #include │ │ │ │ │ ************ CCoolloorrss ************ │ │ │ │ │ ********** AALLLLEEGGRROO__CCOOLLOORR ********** │ │ │ │ │ typedef struct ALLEGRO_COLOR ALLEGRO_COLOR; │ │ │ │ │ +typedef struct ALLEGRO_COLOR ALLEGRO_COLOR; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An ALLEGRO_COLOR structure describes a color in a device independent way. Use │ │ │ │ │ _a_l___m_a_p___r_g_b et al. and _a_l___u_n_m_a_p___r_g_b et al. to translate from and to various │ │ │ │ │ color representations. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___k_e_y_b_o_a_r_d___f_o_c_u_s_._c │ │ │ │ │ * _e_x___n_o_d_i_s_p_l_a_y_._c │ │ │ │ │ @@ -188,16 +189,16 @@ │ │ │ │ │ unsigned char r, unsigned char g, unsigned char b) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Convert r, g, b (ranging from 0-255) into an _A_L_L_E_G_R_O___C_O_L_O_R, using 255 for │ │ │ │ │ alpha. │ │ │ │ │ This function can be called before Allegro is initialized. │ │ │ │ │ See also: _a_l___m_a_p___r_g_b_a, _a_l___m_a_p___r_g_b_a___f, _a_l___m_a_p___r_g_b___f │ │ │ │ │ Examples: │ │ │ │ │ - * _e_x___e_n_e_t___s_e_r_v_e_r_._c │ │ │ │ │ * _e_x___k_e_y_b_o_a_r_d___f_o_c_u_s_._c │ │ │ │ │ + * _e_x___e_n_e_t___s_e_r_v_e_r_._c │ │ │ │ │ * _e_x___n_o_d_i_s_p_l_a_y_._c │ │ │ │ │ ********** aall__mmaapp__rrggbb__ff ********** │ │ │ │ │ ALLEGRO_COLOR al_map_rgb_f(float r, float g, float b) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Convert r, g, b, (ranging from 0.0f-1.0f) into an _A_L_L_E_G_R_O___C_O_L_O_R, using 1.0f for │ │ │ │ │ alpha. │ │ │ │ │ This function can be called before Allegro is initialized. │ │ │ │ │ @@ -307,14 +308,15 @@ │ │ │ │ │ See also: _a_l___u_n_m_a_p___r_g_b_a, _a_l___u_n_m_a_p___r_g_b, _a_l___u_n_m_a_p___r_g_b___f │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___b_l_e_n_d___t_e_s_t_._c │ │ │ │ │ * _e_x___l_o_g_o_._c │ │ │ │ │ ************ LLoocckkiinngg aanndd ppiixxeell ffoorrmmaattss ************ │ │ │ │ │ ********** AALLLLEEGGRROO__LLOOCCKKEEDD__RREEGGIIOONN ********** │ │ │ │ │ typedef struct ALLEGRO_LOCKED_REGION ALLEGRO_LOCKED_REGION; │ │ │ │ │ +typedef struct ALLEGRO_LOCKED_REGION ALLEGRO_LOCKED_REGION; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Users who wish to manually edit or read from a bitmap are required to lock it │ │ │ │ │ first. The ALLEGRO_LOCKED_REGION structure represents the locked region of the │ │ │ │ │ bitmap. This call will work with any bitmap, including memory bitmaps. │ │ │ │ │ typedef struct ALLEGRO_LOCKED_REGION { │ │ │ │ │ void *data; │ │ │ │ │ int format; │ │ │ │ │ @@ -339,14 +341,15 @@ │ │ │ │ │ _A_L_L_E_G_R_O___P_I_X_E_L___F_O_R_M_A_T │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___l_o_c_k_b_i_t_m_a_p_._c │ │ │ │ │ * _e_x___p_r_e_m_u_l_a_l_p_h_a_._c │ │ │ │ │ * _e_x___m_u_l_t_i_s_a_m_p_l_e_._c │ │ │ │ │ ********** AALLLLEEGGRROO__PPIIXXEELL__FFOORRMMAATT ********** │ │ │ │ │ typedef enum ALLEGRO_PIXEL_FORMAT │ │ │ │ │ +typedef enum ALLEGRO_PIXEL_FORMAT │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Pixel formats. Each pixel format specifies the exact size and bit layout of a │ │ │ │ │ pixel in memory. Components are specified from high bits to low bits, so for │ │ │ │ │ example a fully opaque red pixel in ARGB_8888 format is 0xFFFF0000. │ │ │ │ │ NNoottee:: │ │ │ │ │ The pixel format is independent of endianness. That is, in the above │ │ │ │ │ example you can always get the red component with │ │ │ │ │ @@ -581,14 +584,15 @@ │ │ │ │ │ Since: 5.1.9 │ │ │ │ │ See also: _a_l___l_o_c_k___b_i_t_m_a_p___r_e_g_i_o_n, _a_l___l_o_c_k___b_i_t_m_a_p___b_l_o_c_k_e_d │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___c_o_m_p_r_e_s_s_e_d_._c │ │ │ │ │ ************ BBiittmmaapp ccrreeaattiioonn ************ │ │ │ │ │ ********** AALLLLEEGGRROO__BBIITTMMAAPP ********** │ │ │ │ │ typedef struct ALLEGRO_BITMAP ALLEGRO_BITMAP; │ │ │ │ │ +typedef struct ALLEGRO_BITMAP ALLEGRO_BITMAP; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Abstract type representing a bitmap (2D image). │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___c_o_n_v_e_r_t_._c │ │ │ │ │ * _e_x___n_o_d_i_s_p_l_a_y_._c │ │ │ │ │ * _e_x___o_p_e_n_g_l___p_i_x_e_l___s_h_a_d_e_r_._c │ │ │ │ │ ********** aall__ccrreeaattee__bbiittmmaapp ********** │ │ │ │ │ @@ -675,15 +679,15 @@ │ │ │ │ │ the new bitmap is a memory bitmap, its projection bitmap is reset to be │ │ │ │ │ orthographic. │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___b_i_t_m_a_p, _a_l___s_e_t___n_e_w___b_i_t_m_a_p___f_o_r_m_a_t, _a_l___s_e_t___n_e_w___b_i_t_m_a_p___f_l_a_g_s, │ │ │ │ │ _a_l___c_o_n_v_e_r_t___b_i_t_m_a_p │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_u_b_b_i_t_m_a_p_._c │ │ │ │ │ * _e_x___f_o_n_t_._c │ │ │ │ │ - * _e_x___p_r_e_m_u_l_a_l_p_h_a_._c │ │ │ │ │ + * _e_x___b_l_e_n_d_2_._c_p_p │ │ │ │ │ ********** aall__ccoonnvveerrtt__bbiittmmaapp ********** │ │ │ │ │ void al_convert_bitmap(ALLEGRO_BITMAP *bitmap) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Converts the bitmap to the current bitmap flags and format. The bitmap will be │ │ │ │ │ as if it was created anew with _a_l___c_r_e_a_t_e___b_i_t_m_a_p but retain its contents. All of │ │ │ │ │ this bitmap’s sub-bitmaps are also converted. If the new bitmap type is memory, │ │ │ │ │ then the bitmap’s projection bitmap is reset to be orthographic. │ │ │ │ │ @@ -906,14 +910,15 @@ │ │ │ │ │ Returns the value currently set with _a_l___s_e_t___n_e_w___b_i_t_m_a_p___w_r_a_p on the current │ │ │ │ │ thread. │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: This is an experimental feature. │ │ │ │ │ See also: _A_L_L_E_G_R_O___B_I_T_M_A_P___W_R_A_P │ │ │ │ │ ********** AALLLLEEGGRROO__BBIITTMMAAPP__WWRRAAPP ********** │ │ │ │ │ typedef enum ALLEGRO_BITMAP_WRAP { │ │ │ │ │ +typedef enum ALLEGRO_BITMAP_WRAP { │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Controls the how the pixel color is determined from a texture querying the │ │ │ │ │ texture coordinates are outside the usual bounds. │ │ │ │ │ * ALLEGRO_BITMAP_WRAP_DEFAULT - The default behavior. This corresponds to │ │ │ │ │ ALLEGRO_BITMAP_WRAP_REPEAT when using the primitives addon and │ │ │ │ │ ALLEGRO_BITMAP_WRAP_CLAMP otherwise. │ │ │ │ │ * ALLEGRO_BITMAP_WRAP_REPEAT - The texture coordinates get shifted to the │ │ │ │ │ @@ -945,15 +950,15 @@ │ │ │ │ │ ********** aall__ggeett__bbiittmmaapp__hheeiigghhtt ********** │ │ │ │ │ int al_get_bitmap_height(ALLEGRO_BITMAP *bitmap) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the height of a bitmap in pixels. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_u_l_t_i_w_i_n_._c │ │ │ │ │ * _e_x___r_e_s_i_z_e_._c │ │ │ │ │ - * _e_x___m_e_m_b_m_p_._c │ │ │ │ │ + * _e_x___b_l_e_n_d___t_a_r_g_e_t_._c │ │ │ │ │ ********** aall__ggeett__bbiittmmaapp__wwiiddtthh ********** │ │ │ │ │ int al_get_bitmap_width(ALLEGRO_BITMAP *bitmap) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the width of a bitmap in pixels. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___m_u_l_t_i_w_i_n_._c │ │ │ │ │ @@ -1936,14 +1941,15 @@ │ │ │ │ │ bitmap type cannot be determined. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ See also: _a_l___i_n_i_t___i_m_a_g_e___a_d_d_o_n, _a_l___i_d_e_n_t_i_f_y___b_i_t_m_a_p, │ │ │ │ │ _a_l___r_e_g_i_s_t_e_r___b_i_t_m_a_p___i_d_e_n_t_i_f_i_e_r │ │ │ │ │ ************ RReennddeerr SSttaattee ************ │ │ │ │ │ ********** AALLLLEEGGRROO__RREENNDDEERR__SSTTAATTEE ********** │ │ │ │ │ typedef enum ALLEGRO_RENDER_STATE { │ │ │ │ │ +typedef enum ALLEGRO_RENDER_STATE { │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Possible render states which can be set with _a_l___s_e_t___r_e_n_d_e_r___s_t_a_t_e: │ │ │ │ │ ALLEGRO_ALPHA_TEST │ │ │ │ │ If this is set to 1, the values of ALLEGRO_ALPHA_FUNCTION and │ │ │ │ │ ALLEGRO_ALPHA_TEST_VALUE define a comparison function which is performed │ │ │ │ │ on the alpha component of each pixel. Only if it evaluates to true the │ │ │ │ │ pixel is written. Otherwise no subsequent processing (like depth test or │ │ │ │ │ @@ -1966,28 +1972,30 @@ │ │ │ │ │ ALLEGRO_DEPTH_FUNCTION │ │ │ │ │ One of _A_L_L_E_G_R_O___R_E_N_D_E_R___F_U_N_C_T_I_O_N, only used when ALLEGRO_DEPTH_TEST is 1. │ │ │ │ │ Since: 5.1.2 │ │ │ │ │ See also: _a_l___s_e_t___r_e_n_d_e_r___s_t_a_t_e, _A_L_L_E_G_R_O___R_E_N_D_E_R___F_U_N_C_T_I_O_N, │ │ │ │ │ _A_L_L_E_G_R_O___W_R_I_T_E___M_A_S_K___F_L_A_G_S │ │ │ │ │ ********** AALLLLEEGGRROO__RREENNDDEERR__FFUUNNCCTTIIOONN ********** │ │ │ │ │ typedef enum ALLEGRO_RENDER_FUNCTION { │ │ │ │ │ +typedef enum ALLEGRO_RENDER_FUNCTION { │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Possible functions are: │ │ │ │ │ * ALLEGRO_RENDER_NEVER │ │ │ │ │ * ALLEGRO_RENDER_ALWAYS │ │ │ │ │ * ALLEGRO_RENDER_LESS │ │ │ │ │ * ALLEGRO_RENDER_EQUAL │ │ │ │ │ * ALLEGRO_RENDER_LESS_EQUAL │ │ │ │ │ * ALLEGRO_RENDER_GREATER │ │ │ │ │ * ALLEGRO_RENDER_NOT_EQUAL │ │ │ │ │ * ALLEGRO_RENDER_GREATER_EQUAL │ │ │ │ │ Since: 5.1.2 │ │ │ │ │ See also: _a_l___s_e_t___r_e_n_d_e_r___s_t_a_t_e │ │ │ │ │ ********** AALLLLEEGGRROO__WWRRIITTEE__MMAASSKK__FFLLAAGGSS ********** │ │ │ │ │ typedef enum ALLEGRO_WRITE_MASK_FLAGS { │ │ │ │ │ +typedef enum ALLEGRO_WRITE_MASK_FLAGS { │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Each enabled bit means the corresponding value is written, a disabled bit means │ │ │ │ │ it is not. │ │ │ │ │ * ALLEGRO_MASK_RED │ │ │ │ │ * ALLEGRO_MASK_GREEN │ │ │ │ │ * ALLEGRO_MASK_BLUE │ │ │ │ │ * ALLEGRO_MASK_ALPHA │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/haptic.html │ │ │ │ @@ -250,15 +250,16 @@ │ │ │ │ file:

          │ │ │ │ 
           #include <allegro5/allegro.h>
          │ │ │ │

          Currently force feedback is fully supported on Linux and on Windows │ │ │ │ for DirectInput compatible devices. There is also minimal support for │ │ │ │ Android. It is not yet supported on OSX, iOS, or on Windows for XInput │ │ │ │ compatible devices.

          │ │ │ │

          ALLEGRO_HAPTIC

          │ │ │ │ -
          typedef struct ALLEGRO_HAPTIC ALLEGRO_HAPTIC;
          │ │ │ │ +
          typedef struct ALLEGRO_HAPTIC ALLEGRO_HAPTIC;
│ │ │ │ +typedef struct ALLEGRO_HAPTIC ALLEGRO_HAPTIC;
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          This is an abstract data type representing a haptic device that │ │ │ │ supports force feedback or vibration.

          │ │ │ │

          Since: 5.1.8

          │ │ │ │
          │ │ │ │ @@ -273,15 +274,16 @@ │ │ │ │ │ │ │ │

          ALLEGRO_HAPTIC_CONSTANTS

          │ │ │ │ -
          enum ALLEGRO_HAPTIC_CONSTANTS
          │ │ │ │ +
          enum ALLEGRO_HAPTIC_CONSTANTS
│ │ │ │ +enum ALLEGRO_HAPTIC_CONSTANTS
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          This enum contains flags that are used to define haptic effects and │ │ │ │ capabilities. If the flag is set in the return value of al_get_haptic_capabilities, │ │ │ │ it means the device supports the given effect. The value of these flags │ │ │ │ @@ -320,15 +322,16 @@ │ │ │ │ users.

          │ │ │ │
          │ │ │ │

          See also: al_get_haptic_capabilities, │ │ │ │ ALLEGRO_HAPTIC_EFFECT

          │ │ │ │

          ALLEGRO_HAPTIC_EFFECT

          │ │ │ │ -
          struct ALLEGRO_HAPTIC_EFFECT
          │ │ │ │ +
          struct ALLEGRO_HAPTIC_EFFECT
│ │ │ │ +struct ALLEGRO_HAPTIC_EFFECT
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          This struct models a particular haptic or vibration effect. It needs │ │ │ │ to be filled in correctly and uploaded to a haptic device before the │ │ │ │ device can play it back.

          │ │ │ │

          Fields:

          │ │ │ │ @@ -531,15 +534,16 @@ │ │ │ │ │ │ │ │

          ALLEGRO_HAPTIC_EFFECT_ID

          │ │ │ │ -
          typedef struct ALLEGRO_HAPTIC_EFFECT_ID ALLEGRO_HAPTIC_EFFECT_ID;
          │ │ │ │ +
          typedef struct ALLEGRO_HAPTIC_EFFECT_ID ALLEGRO_HAPTIC_EFFECT_ID;
│ │ │ │ +typedef struct ALLEGRO_HAPTIC_EFFECT_ID ALLEGRO_HAPTIC_EFFECT_ID;
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          This struct is used as a handle to control playback of a haptic │ │ │ │ effect and should be considered opaque. Its implementation is visible │ │ │ │ merely to allow allocation by the users of the Allegro library.

          │ │ │ │

          Since: 5.1.8

          │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -82,27 +82,29 @@ │ │ │ │ │ functions are declared in the main Allegro header file: │ │ │ │ │ #include │ │ │ │ │ Currently force feedback is fully supported on Linux and on Windows for │ │ │ │ │ DirectInput compatible devices. There is also minimal support for Android. It │ │ │ │ │ is not yet supported on OSX, iOS, or on Windows for XInput compatible devices. │ │ │ │ │ ************ AALLLLEEGGRROO__HHAAPPTTIICC ************ │ │ │ │ │ typedef struct ALLEGRO_HAPTIC ALLEGRO_HAPTIC; │ │ │ │ │ +typedef struct ALLEGRO_HAPTIC ALLEGRO_HAPTIC; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This is an abstract data type representing a haptic device that supports force │ │ │ │ │ feedback or vibration. │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: Perhaps could be simplified due to limited support for │ │ │ │ │ all the exposed features across all of the platforms. Awaiting │ │ │ │ │ feedback from users. │ │ │ │ │ See also: _a_l___g_e_t___h_a_p_t_i_c___f_r_o_m___j_o_y_s_t_i_c_k │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___h_a_p_t_i_c_._c │ │ │ │ │ * _e_x___h_a_p_t_i_c_2_._c_p_p │ │ │ │ │ ************ AALLLLEEGGRROO__HHAAPPTTIICC__CCOONNSSTTAANNTTSS ************ │ │ │ │ │ enum ALLEGRO_HAPTIC_CONSTANTS │ │ │ │ │ +enum ALLEGRO_HAPTIC_CONSTANTS │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This enum contains flags that are used to define haptic effects and │ │ │ │ │ capabilities. If the flag is set in the return value of │ │ │ │ │ _a_l___g_e_t___h_a_p_t_i_c___c_a_p_a_b_i_l_i_t_i_e_s, it means the device supports the given effect. The │ │ │ │ │ value of these flags should be set into a _A_L_L_E_G_R_O___H_A_P_T_I_C___E_F_F_E_C_T struct to │ │ │ │ │ determine what kind of haptic effect should be played. │ │ │ │ │ * ALLEGRO_HAPTIC_RUMBLE - simple vibration effects │ │ │ │ │ @@ -127,14 +129,15 @@ │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: Perhaps could be simplified due to limited support for │ │ │ │ │ all the exposed features across all of the platforms. Awaiting │ │ │ │ │ feedback from users. │ │ │ │ │ See also: _a_l___g_e_t___h_a_p_t_i_c___c_a_p_a_b_i_l_i_t_i_e_s, _A_L_L_E_G_R_O___H_A_P_T_I_C___E_F_F_E_C_T │ │ │ │ │ ************ AALLLLEEGGRROO__HHAAPPTTIICC__EEFFFFEECCTT ************ │ │ │ │ │ struct ALLEGRO_HAPTIC_EFFECT │ │ │ │ │ +struct ALLEGRO_HAPTIC_EFFECT │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This struct models a particular haptic or vibration effect. It needs to be │ │ │ │ │ filled in correctly and uploaded to a haptic device before the device can play │ │ │ │ │ it back. │ │ │ │ │ FFiieellddss:: │ │ │ │ │ type │ │ │ │ │ The type of the haptic effect. May be one of the ALLEGRO_HAPTIC_CONSTANTS │ │ │ │ │ @@ -291,14 +294,15 @@ │ │ │ │ │ all the exposed features across all of the platforms. Awaiting │ │ │ │ │ feedback from users. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___h_a_p_t_i_c_._c │ │ │ │ │ * _e_x___h_a_p_t_i_c_2_._c_p_p │ │ │ │ │ ************ AALLLLEEGGRROO__HHAAPPTTIICC__EEFFFFEECCTT__IIDD ************ │ │ │ │ │ typedef struct ALLEGRO_HAPTIC_EFFECT_ID ALLEGRO_HAPTIC_EFFECT_ID; │ │ │ │ │ +typedef struct ALLEGRO_HAPTIC_EFFECT_ID ALLEGRO_HAPTIC_EFFECT_ID; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This struct is used as a handle to control playback of a haptic effect and │ │ │ │ │ should be considered opaque. Its implementation is visible merely to allow │ │ │ │ │ allocation by the users of the Allegro library. │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: Perhaps could be simplified due to limited support for │ │ │ │ │ all the exposed features across all of the platforms. Awaiting │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/image.html │ │ │ │ @@ -187,15 +187,16 @@ │ │ │ │ allegro_image.

          │ │ │ │ 
           #include <allegro5/allegro_image.h>
          │ │ │ │

          Some of the format handlers define configuration options for │ │ │ │ specifying things like compression level or gamma handling. Refer to al_get_system_config for │ │ │ │ their documentation.

          │ │ │ │

          al_init_image_addon

          │ │ │ │ -
          bool al_init_image_addon(void)
          │ │ │ │ +
          bool al_init_image_addon(void)
│ │ │ │ +bool al_init_image_addon(void)
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Initializes the image addon. This registers bitmap format handlers │ │ │ │ for al_load_bitmap, al_load_bitmap_f, al_save_bitmap, ex_nodisplay.c │ │ │ │

        • ex_opengl_pixel_shader.c
          • │ │ │ │
        │ │ │ │

        al_is_image_addon_initialized

        │ │ │ │ -
        bool al_is_image_addon_initialized(void)
        │ │ │ │ +
        bool al_is_image_addon_initialized(void)
│ │ │ │ +bool al_is_image_addon_initialized(void)
        │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Returns true if the image addon is initialized, otherwise returns │ │ │ │ false.

        │ │ │ │

        Since: 5.2.6

        │ │ │ │

        al_shutdown_image_addon

        │ │ │ │ -
        void al_shutdown_image_addon(void)
        │ │ │ │ +
        void al_shutdown_image_addon(void)
│ │ │ │ +void al_shutdown_image_addon(void)
        │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Shut down the image addon. This is done automatically at program │ │ │ │ exit, but can be called any time the user wishes as well.

        │ │ │ │

        al_get_allegro_image_version

        │ │ │ │ -
        uint32_t al_get_allegro_image_version(void)
        │ │ │ │ +
        uint32_t al_get_allegro_image_version(void)
│ │ │ │ +uint32_t al_get_allegro_image_version(void)
        │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

        │ │ │ │

        │ │ │ │ Allegro version 5.2.10 │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -51,14 +51,15 @@ │ │ │ │ │ allegro_image. │ │ │ │ │ #include │ │ │ │ │ Some of the format handlers define configuration options for specifying things │ │ │ │ │ like compression level or gamma handling. Refer to _a_l___g_e_t___s_y_s_t_e_m___c_o_n_f_i_g for │ │ │ │ │ their documentation. │ │ │ │ │ ************ aall__iinniitt__iimmaaggee__aaddddoonn ************ │ │ │ │ │ bool al_init_image_addon(void) │ │ │ │ │ +bool al_init_image_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Initializes the image addon. This registers bitmap format handlers for │ │ │ │ │ _a_l___l_o_a_d___b_i_t_m_a_p, _a_l___l_o_a_d___b_i_t_m_a_p___f, _a_l___s_a_v_e___b_i_t_m_a_p, _a_l___s_a_v_e___b_i_t_m_a_p___f. │ │ │ │ │ The following types are built into the Allegro image addon and guaranteed to be │ │ │ │ │ available: BMP, DDS, PCX, TGA. Every platform also supports JPEG and PNG via │ │ │ │ │ external dependencies. │ │ │ │ │ Other formats may be available depending on the operating system and installed │ │ │ │ │ @@ -70,21 +71,24 @@ │ │ │ │ │ have the pixel format matching the format in the file. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___c_o_n_v_e_r_t_._c │ │ │ │ │ * _e_x___n_o_d_i_s_p_l_a_y_._c │ │ │ │ │ * _e_x___o_p_e_n_g_l___p_i_x_e_l___s_h_a_d_e_r_._c │ │ │ │ │ ************ aall__iiss__iimmaaggee__aaddddoonn__iinniittiiaalliizzeedd ************ │ │ │ │ │ bool al_is_image_addon_initialized(void) │ │ │ │ │ +bool al_is_image_addon_initialized(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the image addon is initialized, otherwise returns false. │ │ │ │ │ Since: 5.2.6 │ │ │ │ │ ************ aall__sshhuuttddoowwnn__iimmaaggee__aaddddoonn ************ │ │ │ │ │ void al_shutdown_image_addon(void) │ │ │ │ │ +void al_shutdown_image_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Shut down the image addon. This is done automatically at program exit, but can │ │ │ │ │ be called any time the user wishes as well. │ │ │ │ │ ************ aall__ggeett__aalllleeggrroo__iimmaaggee__vveerrssiioonn ************ │ │ │ │ │ uint32_t al_get_allegro_image_version(void) │ │ │ │ │ +uint32_t al_get_allegro_image_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ Allegro version 5.2.10 - Last updated: 2025-01-09 13:52:42 UTC │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/joystick.html │ │ │ │ @@ -223,15 +223,16 @@ │ │ │ │ Xinput one. If support for XInput was compiled in, then it can be │ │ │ │ enabled by calling al_set_config_value(al_get_system_config(), │ │ │ │ “joystick”, “driver”, “xinput”) before calling al_install_joystick, or │ │ │ │ by setting the same option in the allegro5.cfg configuration file. The │ │ │ │ Xinput and DirectInput drivers are mutually exclusive. The haptics │ │ │ │ subsystem will use the same driver as the joystick system does.

        │ │ │ │

        ALLEGRO_JOYSTICK

        │ │ │ │ -
        typedef struct ALLEGRO_JOYSTICK ALLEGRO_JOYSTICK;
        │ │ │ │ +
        typedef struct ALLEGRO_JOYSTICK ALLEGRO_JOYSTICK;
│ │ │ │ +typedef struct ALLEGRO_JOYSTICK ALLEGRO_JOYSTICK;
        │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        This is an abstract data type representing a physical joystick.

        │ │ │ │

        See also: al_get_joystick

        │ │ │ │

        Examples:

        │ │ │ │ @@ -240,15 +241,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L14">ex_haptic.c
        • │ │ │ │
      • ex_joystick_hotplugging.c
        • │ │ │ │
      • ex_joystick_events.c
        • │ │ │ │
      │ │ │ │

      ALLEGRO_JOYSTICK_STATE

      │ │ │ │ -
      typedef struct ALLEGRO_JOYSTICK_STATE ALLEGRO_JOYSTICK_STATE;
      │ │ │ │ +
      typedef struct ALLEGRO_JOYSTICK_STATE ALLEGRO_JOYSTICK_STATE;
│ │ │ │ +typedef struct ALLEGRO_JOYSTICK_STATE ALLEGRO_JOYSTICK_STATE;
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      This is a structure that is used to hold a “snapshot” of a joystick’s │ │ │ │ axes and buttons at a particular instant. All fields public and │ │ │ │ read-only.

      │ │ │ │ 
      struct {
│ │ │ │ @@ -261,15 +263,16 @@
│ │ │ │  
│ │ │ │  
      ALLEGRO_JOYFLAGS
      
│ │ │ │ -
      enum ALLEGRO_JOYFLAGS
      
│ │ │ │ +
      enum ALLEGRO_JOYFLAGS
│ │ │ │ +enum ALLEGRO_JOYFLAGS
      
│ │ │ │  
      Source
│ │ │ │  Code
      
│ │ │ │  
        
│ │ │ │  
      • ALLEGRO_JOYFLAG_DIGITAL - the stick provides digital input
        • 
│ │ │ │  
      • ALLEGRO_JOYFLAG_ANALOGUE - the stick provides analogue input
        • 
│ │ │ │  
      
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -71,36 +71,39 @@
│ │ │ │ │  al_set_config_value(al_get_system_config(), “joystick”, “driver”, “xinput”)
│ │ │ │ │  before calling al_install_joystick, or by setting the same option in the
│ │ │ │ │  allegro5.cfg configuration file. The Xinput and DirectInput drivers are
│ │ │ │ │  mutually exclusive. The haptics subsystem will use the same driver as the
│ │ │ │ │  joystick system does.
│ │ │ │ │  ************ AALLLLEEGGRROO__JJOOYYSSTTIICCKK ************
│ │ │ │ │  typedef struct ALLEGRO_JOYSTICK ALLEGRO_JOYSTICK;
│ │ │ │ │ +typedef struct ALLEGRO_JOYSTICK ALLEGRO_JOYSTICK;
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  This is an abstract data type representing a physical joystick.
│ │ │ │ │  See also: _a_l___g_e_t___j_o_y_s_t_i_c_k
│ │ │ │ │  Examples:
│ │ │ │ │      * _e_x___h_a_p_t_i_c_._c
│ │ │ │ │      * _e_x___j_o_y_s_t_i_c_k___h_o_t_p_l_u_g_g_i_n_g_._c
│ │ │ │ │      * _e_x___j_o_y_s_t_i_c_k___e_v_e_n_t_s_._c
│ │ │ │ │  ************ AALLLLEEGGRROO__JJOOYYSSTTIICCKK__SSTTAATTEE ************
│ │ │ │ │  typedef struct ALLEGRO_JOYSTICK_STATE ALLEGRO_JOYSTICK_STATE;
│ │ │ │ │ +typedef struct ALLEGRO_JOYSTICK_STATE ALLEGRO_JOYSTICK_STATE;
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  This is a structure that is used to hold a “snapshot” of a joystick’s axes and
│ │ │ │ │  buttons at a particular instant. All fields public and read-only.
│ │ │ │ │  struct {
│ │ │ │ │     float axis[num_axes];             // -1.0 to 1.0
│ │ │ │ │  } stick[num_sticks];
│ │ │ │ │  int button[num_buttons];             // 0 to 32767
│ │ │ │ │  See also: _a_l___g_e_t___j_o_y_s_t_i_c_k___s_t_a_t_e
│ │ │ │ │  Examples:
│ │ │ │ │      * _e_x___j_o_y_s_t_i_c_k___h_o_t_p_l_u_g_g_i_n_g_._c
│ │ │ │ │      * _e_x___j_o_y_s_t_i_c_k___e_v_e_n_t_s_._c
│ │ │ │ │  ************ AALLLLEEGGRROO__JJOOYYFFLLAAGGSS ************
│ │ │ │ │  enum ALLEGRO_JOYFLAGS
│ │ │ │ │ +enum ALLEGRO_JOYFLAGS
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │      * ALLEGRO_JOYFLAG_DIGITAL - the stick provides digital input
│ │ │ │ │      * ALLEGRO_JOYFLAG_ANALOGUE - the stick provides analogue input
│ │ │ │ │  (this enum is a holdover from the old API and may be removed)
│ │ │ │ │  See also: _a_l___g_e_t___j_o_y_s_t_i_c_k___s_t_i_c_k___f_l_a_g_s
│ │ │ │ │  ************ aall__iinnssttaallll__jjooyyssttiicckk ************
│ │ │ │ │  bool al_install_joystick(void)
│ │ │ ├── ./usr/share/doc/allegro5-doc/refman/keyboard.html
│ │ │ │ @@ -198,15 +198,16 @@
│ │ │ │  
    • al_get_keyboard_event_source
      • 
│ │ │ │
    │ │ │ │ │ │ │ │

    These functions are declared in the main Allegro header file:

    │ │ │ │ 
     #include <allegro5/allegro.h>
    │ │ │ │

    ALLEGRO_KEYBOARD_STATE

    │ │ │ │ -
    typedef struct ALLEGRO_KEYBOARD_STATE ALLEGRO_KEYBOARD_STATE;
    │ │ │ │ +
    typedef struct ALLEGRO_KEYBOARD_STATE ALLEGRO_KEYBOARD_STATE;
│ │ │ │ +typedef struct ALLEGRO_KEYBOARD_STATE ALLEGRO_KEYBOARD_STATE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This is a structure that is used to hold a “snapshot” of a keyboard’s │ │ │ │ state at a particular instant. It contains the following publically │ │ │ │ readable fields:

    │ │ │ │
      │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -56,14 +56,15 @@ │ │ │ │ │ * _a_l___c_a_n___s_e_t___k_e_y_b_o_a_r_d___l_e_d_s │ │ │ │ │ * _a_l___s_e_t___k_e_y_b_o_a_r_d___l_e_d_s │ │ │ │ │ * _a_l___g_e_t___k_e_y_b_o_a_r_d___e_v_e_n_t___s_o_u_r_c_e │ │ │ │ │ These functions are declared in the main Allegro header file: │ │ │ │ │ #include │ │ │ │ │ ************ AALLLLEEGGRROO__KKEEYYBBOOAARRDD__SSTTAATTEE ************ │ │ │ │ │ typedef struct ALLEGRO_KEYBOARD_STATE ALLEGRO_KEYBOARD_STATE; │ │ │ │ │ +typedef struct ALLEGRO_KEYBOARD_STATE ALLEGRO_KEYBOARD_STATE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This is a structure that is used to hold a “snapshot” of a keyboard’s state at │ │ │ │ │ a particular instant. It contains the following publically readable fields: │ │ │ │ │ * display - points to the display that had keyboard focus at the time the │ │ │ │ │ state was saved. If no display was focused, this points to NULL. │ │ │ │ │ You cannot read the state of keys directly. Use the function _a_l___k_e_y___d_o_w_n. │ │ │ │ │ Examples: │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/memfile.html │ │ │ │ @@ -181,15 +181,16 @@ │ │ │ │ │ │ │ │

      The memfile interface allows you to treat a fixed block of contiguous │ │ │ │ memory as a file that can be used with Allegro’s I/O functions.

      │ │ │ │

      These functions are declared in the following header file. Link with │ │ │ │ allegro_memfile.

      │ │ │ │ 
       #include <allegro5/allegro_memfile.h>
      │ │ │ │

      al_open_memfile

      │ │ │ │ -
      ALLEGRO_FILE *al_open_memfile(void *mem, int64_t size, const char *mode)
      │ │ │ │ +
      ALLEGRO_FILE *al_open_memfile(void *mem, int64_t size, const char *mode)
│ │ │ │ +ALLEGRO_FILE *al_open_memfile(void *mem, int64_t size, const char *mode)
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Returns a file handle to the block of memory. All read and write │ │ │ │ operations act upon the memory directly, so it must not be freed while │ │ │ │ the file remains open.

      │ │ │ │

      The mode can be any combination of “r” (readable) and “w” (writable). │ │ │ │ @@ -203,15 +204,16 @@ │ │ │ │

      Examples:

      │ │ │ │ │ │ │ │

      al_get_allegro_memfile_version

      │ │ │ │ -
      uint32_t al_get_allegro_memfile_version(void)
      │ │ │ │ +
      uint32_t al_get_allegro_memfile_version(void)
│ │ │ │ +uint32_t al_get_allegro_memfile_version(void)
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

      │ │ │ │

      │ │ │ │ Allegro version 5.2.10 │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -48,24 +48,26 @@ │ │ │ │ │ The memfile interface allows you to treat a fixed block of contiguous memory as │ │ │ │ │ a file that can be used with Allegro’s I/O functions. │ │ │ │ │ These functions are declared in the following header file. Link with │ │ │ │ │ allegro_memfile. │ │ │ │ │ #include │ │ │ │ │ ************ aall__ooppeenn__mmeemmffiillee ************ │ │ │ │ │ ALLEGRO_FILE *al_open_memfile(void *mem, int64_t size, const char *mode) │ │ │ │ │ +ALLEGRO_FILE *al_open_memfile(void *mem, int64_t size, const char *mode) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns a file handle to the block of memory. All read and write operations act │ │ │ │ │ upon the memory directly, so it must not be freed while the file remains open. │ │ │ │ │ The mode can be any combination of “r” (readable) and “w” (writable). │ │ │ │ │ Regardless of the mode, the file always opens at position 0. The file size is │ │ │ │ │ fixed and cannot be expanded. The file is always read from/written to in binary │ │ │ │ │ mode, which means that no newline translation is performed. │ │ │ │ │ It should be closed with _a_l___f_c_l_o_s_e. After the file is closed, you are │ │ │ │ │ responsible for freeing the memory (if needed). │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_m_f_i_l_e_._c │ │ │ │ │ ************ aall__ggeett__aalllleeggrroo__mmeemmffiillee__vveerrssiioonn ************ │ │ │ │ │ uint32_t al_get_allegro_memfile_version(void) │ │ │ │ │ +uint32_t al_get_allegro_memfile_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ Allegro version 5.2.10 - Last updated: 2025-01-09 13:52:42 UTC │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/memory.html │ │ │ │ @@ -191,15 +191,17 @@ │ │ │ │ id="toc-al_set_memory_interface">al_set_memory_interface │ │ │ │

    │ │ │ │ │ │ │ │

    These functions are declared in the main Allegro header file:

    │ │ │ │ 
     #include <allegro5/allegro.h>
    │ │ │ │

    al_malloc

    │ │ │ │ 
    #define al_malloc(n) \
│ │ │ │ -   (al_malloc_with_context((n), __LINE__, __FILE__, __func__))
    │ │ │ │ + (al_malloc_with_context((n), __LINE__, __FILE__, __func__)) │ │ │ │ +#define al_malloc(n) \ │ │ │ │ + (al_malloc_with_context((n), __LINE__, __FILE__, __func__))     │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like malloc() in the C standard library, but the implementation may │ │ │ │ be overridden.

    │ │ │ │

    This is a macro.

    │ │ │ │

    See also: al_free, ex_audio_timer.c │ │ │ │

  • ex_vertex_buffer.c
    • │ │ │ │ │ │ │ │

    al_free

    │ │ │ │ 
    #define al_free(p) \
│ │ │ │ -   (al_free_with_context((p), __LINE__, __FILE__, __func__))
    │ │ │ │ + (al_free_with_context((p), __LINE__, __FILE__, __func__)) │ │ │ │ +#define al_free(p) \ │ │ │ │ + (al_free_with_context((p), __LINE__, __FILE__, __func__))     │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like free() in the C standard library, but the implementation may be │ │ │ │ overridden.

    │ │ │ │

    Additionally, on Windows, a memory block allocated by one DLL must be │ │ │ │ freed from the same DLL. In the few places where an Allegro function │ │ │ │ @@ -236,26 +240,30 @@ │ │ │ │

  • ex_drag_and_drop.c
    • │ │ │ │
  • ex_record_name.c
    • │ │ │ │ │ │ │ │

    al_realloc

    │ │ │ │ 
    #define al_realloc(p, n) \
│ │ │ │ -   (al_realloc_with_context((p), (n), __LINE__, __FILE__, __func__))
    │ │ │ │ + (al_realloc_with_context((p), (n), __LINE__, __FILE__, __func__)) │ │ │ │ +#define al_realloc(p, n) \ │ │ │ │ + (al_realloc_with_context((p), (n), __LINE__, __FILE__, __func__))     │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like realloc() in the C standard library, but the implementation may │ │ │ │ be overridden.

    │ │ │ │

    This is a macro.

    │ │ │ │

    See also: al_malloc, al_realloc_with_context

    │ │ │ │

    al_calloc

    │ │ │ │ 
    #define al_calloc(c, n) \
│ │ │ │ -   (al_calloc_with_context((c), (n), __LINE__, __FILE__, __func__))
    │ │ │ │ + (al_calloc_with_context((c), (n), __LINE__, __FILE__, __func__)) │ │ │ │ +#define al_calloc(c, n) \ │ │ │ │ + (al_calloc_with_context((c), (n), __LINE__, __FILE__, __func__)) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like calloc() in the C standard library, but the implementation may │ │ │ │ be overridden.

    │ │ │ │

    This is a macro.

    │ │ │ │

    See also: al_malloc,

    │ │ │ │

    This calls calloc() from the Allegro library (this matters on │ │ │ │ Windows), unless overridden with al_set_memory_interface,

    │ │ │ │

    Generally you should use the al_calloc macro.

    │ │ │ │

    ALLEGRO_MEMORY_INTERFACE

    │ │ │ │ -
    typedef struct ALLEGRO_MEMORY_INTERFACE ALLEGRO_MEMORY_INTERFACE;
    │ │ │ │ +
    typedef struct ALLEGRO_MEMORY_INTERFACE ALLEGRO_MEMORY_INTERFACE;
│ │ │ │ +typedef struct ALLEGRO_MEMORY_INTERFACE ALLEGRO_MEMORY_INTERFACE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This structure has the following fields.

    │ │ │ │ 
    void *(*mi_malloc)(size_t n, int line, const char *file, const char *func);
│ │ │ │  void (*mi_free)(void *ptr, int line, const char *file, const char *func);
│ │ │ │  void *(*mi_realloc)(void *ptr, size_t n, int line, const char *file,
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -54,26 +54,30 @@
│ │ │ │ │      * _A_L_L_E_G_R_O___M_E_M_O_R_Y___I_N_T_E_R_F_A_C_E
│ │ │ │ │      * _a_l___s_e_t___m_e_m_o_r_y___i_n_t_e_r_f_a_c_e
│ │ │ │ │  These functions are declared in the main Allegro header file:
│ │ │ │ │   #include 
│ │ │ │ │  ************ aall__mmaalllloocc ************
│ │ │ │ │  #define al_malloc(n) \
│ │ │ │ │     (al_malloc_with_context((n), __LINE__, __FILE__, __func__))
│ │ │ │ │ +#define al_malloc(n) \
│ │ │ │ │ +   (al_malloc_with_context((n), __LINE__, __FILE__, __func__))
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Like malloc() in the C standard library, but the implementation may be
│ │ │ │ │  overridden.
│ │ │ │ │  This is a macro.
│ │ │ │ │  See also: _a_l___f_r_e_e, _a_l___r_e_a_l_l_o_c, _a_l___c_a_l_l_o_c, _a_l___m_a_l_l_o_c___w_i_t_h___c_o_n_t_e_x_t,
│ │ │ │ │  _a_l___s_e_t___m_e_m_o_r_y___i_n_t_e_r_f_a_c_e
│ │ │ │ │  Examples:
│ │ │ │ │      * _e_x___a_u_d_i_o___t_i_m_e_r_._c
│ │ │ │ │      * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c
│ │ │ │ │  ************ aall__ffrreeee ************
│ │ │ │ │  #define al_free(p) \
│ │ │ │ │     (al_free_with_context((p), __LINE__, __FILE__, __func__))
│ │ │ │ │ +#define al_free(p) \
│ │ │ │ │ +   (al_free_with_context((p), __LINE__, __FILE__, __func__))
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Like free() in the C standard library, but the implementation may be
│ │ │ │ │  overridden.
│ │ │ │ │  Additionally, on Windows, a memory block allocated by one DLL must be freed
│ │ │ │ │  from the same DLL. In the few places where an Allegro function returns a
│ │ │ │ │  pointer that must be freed, you must use _a_l___f_r_e_e for portability to Windows.
│ │ │ │ │  This is a macro.
│ │ │ │ │ @@ -81,22 +85,26 @@
│ │ │ │ │  Examples:
│ │ │ │ │      * _e_x___c_l_i_p_b_o_a_r_d_._c
│ │ │ │ │      * _e_x___d_r_a_g___a_n_d___d_r_o_p_._c
│ │ │ │ │      * _e_x___r_e_c_o_r_d___n_a_m_e_._c
│ │ │ │ │  ************ aall__rreeaalllloocc ************
│ │ │ │ │  #define al_realloc(p, n) \
│ │ │ │ │     (al_realloc_with_context((p), (n), __LINE__, __FILE__, __func__))
│ │ │ │ │ +#define al_realloc(p, n) \
│ │ │ │ │ +   (al_realloc_with_context((p), (n), __LINE__, __FILE__, __func__))
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Like realloc() in the C standard library, but the implementation may be
│ │ │ │ │  overridden.
│ │ │ │ │  This is a macro.
│ │ │ │ │  See also: _a_l___m_a_l_l_o_c, _a_l___r_e_a_l_l_o_c___w_i_t_h___c_o_n_t_e_x_t
│ │ │ │ │  ************ aall__ccaalllloocc ************
│ │ │ │ │  #define al_calloc(c, n) \
│ │ │ │ │     (al_calloc_with_context((c), (n), __LINE__, __FILE__, __func__))
│ │ │ │ │ +#define al_calloc(c, n) \
│ │ │ │ │ +   (al_calloc_with_context((c), (n), __LINE__, __FILE__, __func__))
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Like calloc() in the C standard library, but the implementation may be
│ │ │ │ │  overridden.
│ │ │ │ │  This is a macro.
│ │ │ │ │  See also: _a_l___m_a_l_l_o_c, _a_l___c_a_l_l_o_c___w_i_t_h___c_o_n_t_e_x_t
│ │ │ │ │  Examples:
│ │ │ │ │      * _e_x___r_e_c_o_r_d___n_a_m_e_._c
│ │ │ │ │ @@ -126,14 +134,15 @@
│ │ │ │ │     int line, const char *file, const char *func)
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  This calls calloc() from the Allegro library (this matters on Windows), unless
│ │ │ │ │  overridden with _a_l___s_e_t___m_e_m_o_r_y___i_n_t_e_r_f_a_c_e,
│ │ │ │ │  Generally you should use the _a_l___c_a_l_l_o_c macro.
│ │ │ │ │  ************ AALLLLEEGGRROO__MMEEMMOORRYY__IINNTTEERRFFAACCEE ************
│ │ │ │ │  typedef struct ALLEGRO_MEMORY_INTERFACE ALLEGRO_MEMORY_INTERFACE;
│ │ │ │ │ +typedef struct ALLEGRO_MEMORY_INTERFACE ALLEGRO_MEMORY_INTERFACE;
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  This structure has the following fields.
│ │ │ │ │  void *(*mi_malloc)(size_t n, int line, const char *file, const char *func);
│ │ │ │ │  void (*mi_free)(void *ptr, int line, const char *file, const char *func);
│ │ │ │ │  void *(*mi_realloc)(void *ptr, size_t n, int line, const char *file,
│ │ │ │ │                      const char *func);
│ │ │ │ │  void *(*mi_calloc)(size_t count, size_t n, int line, const char *file,
│ │ │ ├── ./usr/share/doc/allegro5-doc/refman/misc.html
│ │ │ │ @@ -176,15 +176,16 @@
│ │ │ │  
  • ALLEGRO_PI
    • 
│ │ │ │  
  • al_run_main
    • 
│ │ │ │  
│ │ │ │  
│ │ │ │  
    These functions are declared in the main Allegro header file:
    
│ │ │ │  
     #include <allegro5/allegro.h>
    
│ │ │ │  
    ALLEGRO_PI
    
│ │ │ │ -
    #define ALLEGRO_PI        3.14159265358979323846
    
│ │ │ │ +
    #define ALLEGRO_PI        3.14159265358979323846
│ │ │ │ +#define ALLEGRO_PI        3.14159265358979323846
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    C99 compilers have no predefined value like M_PI for the constant π,
│ │ │ │  but you can use this one instead.
    
│ │ │ │  
    Examples:
    
│ │ │ │  
      
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -45,14 +45,15 @@
│ │ │ │ │  ************ MMiisscceellllaanneeoouuss rroouuttiinneess ************
│ │ │ │ │      * _A_L_L_E_G_R_O___P_I
│ │ │ │ │      * _a_l___r_u_n___m_a_i_n
│ │ │ │ │  These functions are declared in the main Allegro header file:
│ │ │ │ │   #include 
│ │ │ │ │  ************ AALLLLEEGGRROO__PPII ************
│ │ │ │ │  #define ALLEGRO_PI        3.14159265358979323846
│ │ │ │ │ +#define ALLEGRO_PI        3.14159265358979323846
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  C99 compilers have no predefined value like M_PI for the constant π, but you
│ │ │ │ │  can use this one instead.
│ │ │ │ │  Examples:
│ │ │ │ │      * _e_x___c_o_n_v_e_r_t_._c
│ │ │ │ │      * _e_x___o_p_e_n_g_l_._c
│ │ │ │ │      * _e_x___b_l_e_n_d___b_e_n_c_h_._c
│ │ │ ├── ./usr/share/doc/allegro5-doc/refman/monitor.html
│ │ │ │ @@ -184,15 +184,16 @@
│ │ │ │  
    • al_get_monitor_refresh_rate
      • 
│ │ │ │  
    
│ │ │ │  
│ │ │ │  
    These functions are declared in the main Allegro header file:
    
│ │ │ │  
     #include <allegro5/allegro.h>
    
│ │ │ │  
    ALLEGRO_MONITOR_INFO
    
│ │ │ │ -
    typedef struct ALLEGRO_MONITOR_INFO
    
│ │ │ │ +
    typedef struct ALLEGRO_MONITOR_INFO
│ │ │ │ +typedef struct ALLEGRO_MONITOR_INFO
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Describes a monitor’s size and position relative to other monitors.
│ │ │ │  x1, y1 will be 0, 0 on the primary display. Other monitors can have
│ │ │ │  negative values if they are to the left or above the primary display.
│ │ │ │  x2, y2 are the coordinates one beyond the bottom right pixel, so that
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -48,14 +48,15 @@
│ │ │ │ │      * _a_l___g_e_t___m_o_n_i_t_o_r___d_p_i
│ │ │ │ │      * _a_l___g_e_t___n_u_m___v_i_d_e_o___a_d_a_p_t_e_r_s
│ │ │ │ │      * _a_l___g_e_t___m_o_n_i_t_o_r___r_e_f_r_e_s_h___r_a_t_e
│ │ │ │ │  These functions are declared in the main Allegro header file:
│ │ │ │ │   #include 
│ │ │ │ │  ************ AALLLLEEGGRROO__MMOONNIITTOORR__IINNFFOO ************
│ │ │ │ │  typedef struct ALLEGRO_MONITOR_INFO
│ │ │ │ │ +typedef struct ALLEGRO_MONITOR_INFO
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Describes a monitor’s size and position relative to other monitors. x1, y1 will
│ │ │ │ │  be 0, 0 on the primary display. Other monitors can have negative values if they
│ │ │ │ │  are to the left or above the primary display. x2, y2 are the coordinates one
│ │ │ │ │  beyond the bottom right pixel, so that x2-x1 gives the width and y2-y1 gives
│ │ │ │ │  the height of the display.
│ │ │ │ │  typedef struct ALLEGRO_MONITOR_INFO
│ │ │ ├── ./usr/share/doc/allegro5-doc/refman/mouse.html
│ │ │ │ @@ -231,15 +231,16 @@
│ │ │ │  id="toc-al_ungrab_mouse">al_ungrab_mouse
│ │ │ │  
│ │ │ │  
│ │ │ │  
│ │ │ │  
    These functions are declared in the main Allegro header file:
    
│ │ │ │  
     #include <allegro5/allegro.h>
    
│ │ │ │  
    ALLEGRO_MOUSE_STATE
    
│ │ │ │ -
    typedef struct ALLEGRO_MOUSE_STATE ALLEGRO_MOUSE_STATE;
    
│ │ │ │ +
    typedef struct ALLEGRO_MOUSE_STATE ALLEGRO_MOUSE_STATE;
│ │ │ │ +typedef struct ALLEGRO_MOUSE_STATE ALLEGRO_MOUSE_STATE;
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Public fields (read only):
    
│ │ │ │  
      
│ │ │ │  
    • x - mouse x position
      • 
│ │ │ │  
    • y - mouse y position
      • 
│ │ │ │ @@ -469,17 +470,17 @@
│ │ │ │  generated by this event source.
      
│ │ │ │  
      Returns NULL if the mouse subsystem was not installed.
      
│ │ │ │  
      Examples:
      
│ │ │ │  
│ │ │ │  
      al_set_mouse_wheel_precision
      
│ │ │ │  
      void al_set_mouse_wheel_precision(int precision)
      
│ │ │ │  
      Source
│ │ │ │  Code
      
│ │ │ │  
      Sets the precision of the mouse wheel (the z and w coordinates). This
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -71,14 +71,15 @@
│ │ │ │ │            o _a_l___s_h_o_w___m_o_u_s_e___c_u_r_s_o_r
│ │ │ │ │            o _a_l___g_r_a_b___m_o_u_s_e
│ │ │ │ │            o _a_l___u_n_g_r_a_b___m_o_u_s_e
│ │ │ │ │  These functions are declared in the main Allegro header file:
│ │ │ │ │   #include 
│ │ │ │ │  ************ AALLLLEEGGRROO__MMOOUUSSEE__SSTTAATTEE ************
│ │ │ │ │  typedef struct ALLEGRO_MOUSE_STATE ALLEGRO_MOUSE_STATE;
│ │ │ │ │ +typedef struct ALLEGRO_MOUSE_STATE ALLEGRO_MOUSE_STATE;
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Public fields (read only):
│ │ │ │ │      * x - mouse x position
│ │ │ │ │      * y - mouse y position
│ │ │ │ │      * w, z - mouse wheel position (2D ‘ball’)
│ │ │ │ │      * buttons - mouse buttons bitfield
│ │ │ │ │        The zeroth bit is set if the primary mouse button is held down, the first
│ │ │ │ │ @@ -215,16 +216,16 @@
│ │ │ │ │  ALLEGRO_EVENT_SOURCE *al_get_mouse_event_source(void)
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Retrieve the mouse event source. All _m_o_u_s_e_ _e_v_e_n_t_s are generated by this event
│ │ │ │ │  source.
│ │ │ │ │  Returns NULL if the mouse subsystem was not installed.
│ │ │ │ │  Examples:
│ │ │ │ │      * _e_x___d_i_s_p_l_a_y___e_v_e_n_t_s_._c
│ │ │ │ │ -    * _e_x___m_o_u_s_e___w_a_r_p_._c
│ │ │ │ │      * _e_x___n_o_f_r_a_m_e_._c
│ │ │ │ │ +    * _e_x___m_o_u_s_e___w_a_r_p_._c
│ │ │ │ │  ************ aall__sseett__mmoouussee__wwhheeeell__pprreecciissiioonn ************
│ │ │ │ │  void al_set_mouse_wheel_precision(int precision)
│ │ │ │ │  _S_o_u_r_c_e_ _C_o_d_e
│ │ │ │ │  Sets the precision of the mouse wheel (the z and w coordinates). This precision
│ │ │ │ │  manifests itself as a multiplier on the dz and dw fields in mouse events. It
│ │ │ │ │  also affects the z and w fields of events and _A_L_L_E_G_R_O___M_O_U_S_E___S_T_A_T_E, but not in a
│ │ │ │ │  simple way if you alter the precision often, so it is suggested to reset those
│ │ │ ├── ./usr/share/doc/allegro5-doc/refman/native_dialog.html
│ │ │ │ @@ -262,39 +262,42 @@
│ │ │ │  
    
│ │ │ │  
│ │ │ │  
│ │ │ │  
    These functions are declared in the following header file. Link with
│ │ │ │  allegro_dialog.
    
│ │ │ │  
     #include <allegro5/allegro_native_dialog.h>
    
│ │ │ │  
    ALLEGRO_FILECHOOSER
    
│ │ │ │ -
    typedef struct ALLEGRO_FILECHOOSER ALLEGRO_FILECHOOSER;
    
│ │ │ │ +
    typedef struct ALLEGRO_FILECHOOSER ALLEGRO_FILECHOOSER;
│ │ │ │ +typedef struct ALLEGRO_FILECHOOSER ALLEGRO_FILECHOOSER;
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Opaque handle to a native file dialog.
    
│ │ │ │  
    Examples:
    
│ │ │ │  
│ │ │ │  
    ALLEGRO_TEXTLOG
    
│ │ │ │ -
    typedef struct ALLEGRO_TEXTLOG ALLEGRO_TEXTLOG;
    
│ │ │ │ +
    typedef struct ALLEGRO_TEXTLOG ALLEGRO_TEXTLOG;
│ │ │ │ +typedef struct ALLEGRO_TEXTLOG ALLEGRO_TEXTLOG;
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Opaque handle to a text log window.
    
│ │ │ │  
    Examples:
    
│ │ │ │  
│ │ │ │  
    al_init_native_dialog_addon
    
│ │ │ │ -
    bool al_init_native_dialog_addon(void)
    
│ │ │ │ +
    bool al_init_native_dialog_addon(void)
│ │ │ │ +bool al_init_native_dialog_addon(void)
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Initialise the native dialog addon.
    
│ │ │ │  
    Returns true on success, false on error.
    
│ │ │ │  
    Since: 5.0.9, 5.1.0
    
│ │ │ │  
    
│ │ │ │ @@ -315,37 +318,44 @@
│ │ │ │  
  • ex_window_maximized.c
    • 
│ │ │ │  
  • ex_menu.c
    • 
│ │ │ │  
│ │ │ │  
    al_is_native_dialog_addon_initialized
    
│ │ │ │ -
    bool al_is_native_dialog_addon_initialized(void)
    
│ │ │ │ +
    bool al_is_native_dialog_addon_initialized(void)
│ │ │ │ +bool al_is_native_dialog_addon_initialized(void)
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Returns true if the native dialog addon is initialized, otherwise
│ │ │ │  returns false.
    
│ │ │ │  
    Since: 5.2.6
    
│ │ │ │  
    al_shutdown_native_dialog_addon
    
│ │ │ │ -
    void al_shutdown_native_dialog_addon(void)
    
│ │ │ │ +
    void al_shutdown_native_dialog_addon(void)
│ │ │ │ +void al_shutdown_native_dialog_addon(void)
    
│ │ │ │  
    Source
│ │ │ │  Code
    
│ │ │ │  
    Shut down the native dialog addon.
    
│ │ │ │  
    Since: 5.0.9, 5.1.5
    
│ │ │ │  
    See also: al_init_native_dialog_addon
    
│ │ │ │  
    al_create_native_file_dialog
    
│ │ │ │  
    ALLEGRO_FILECHOOSER *al_create_native_file_dialog(
│ │ │ │     char const *initial_path,
│ │ │ │     char const *title,
│ │ │ │     char const *patterns,
│ │ │ │ -   int mode)
    
│ │ │ │ +   int mode)
│ │ │ │ +ALLEGRO_FILECHOOSER *al_create_native_file_dialog(
│ │ │ │ +   char const *initial_path,
│ │ │ │ +   char const *title,
│ │ │ │ +   char const *patterns,eta, float delta_theta, float thickness,
│ │ │ │ +   int mode)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates a new native file dialog. You should only have one such │ │ │ │ dialog opened at a time.

    │ │ │ │

    Parameters:

    │ │ │ │
      │ │ │ │ @@ -434,15 +444,17 @@ │ │ │ │

      Examples:

      │ │ │ │ │ │ │ │

      al_show_native_file_dialog

      │ │ │ │ 
      bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display,
│ │ │ │ -   ALLEGRO_FILECHOOSER *dialog)
      │ │ │ │ + ALLEGRO_FILECHOOSER *dialog) │ │ │ │ +bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display, │ │ │ │ + ALLEGRO_FILECHOOSER *dialog) │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Show the dialog window. The display may be NULL, otherwise the given │ │ │ │ display is treated as the parent if possible.

      │ │ │ │

      This function blocks the calling thread until it returns, so you may │ │ │ │ want to spawn a thread with Examples:

      │ │ │ │ │ │ │ │

      al_get_native_file_dialog_count

      │ │ │ │ -
      int al_get_native_file_dialog_count(const ALLEGRO_FILECHOOSER *dialog)
      │ │ │ │ +
      int al_get_native_file_dialog_count(const ALLEGRO_FILECHOOSER *dialog)
│ │ │ │ +int al_get_native_file_dialog_count(const ALLEGRO_FILECHOOSER *dialog)
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Returns the number of files selected, or 0 if the dialog was │ │ │ │ cancelled.

      │ │ │ │

      Examples:

      │ │ │ │ │ │ │ │

      al_get_native_file_dialog_path

      │ │ │ │ 
      const char *al_get_native_file_dialog_path(
│ │ │ │ -   const ALLEGRO_FILECHOOSER *dialog, size_t i)
      │ │ │ │ + const ALLEGRO_FILECHOOSER *dialog, size_t i) │ │ │ │ +const char *al_get_native_file_dialog_path( │ │ │ │ + const ALLEGRO_FILECHOOSER *dialog, size_t i) │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Returns one of the selected paths with index i. The │ │ │ │ index should range from 0 to the return value of al_get_native_file_dialog_count │ │ │ │ -1.

      │ │ │ │ @@ -495,28 +510,32 @@ │ │ │ │

      Examples:

      │ │ │ │ │ │ │ │

      al_destroy_native_file_dialog

      │ │ │ │ -
      void al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER *dialog)
      │ │ │ │ +
      void al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER *dialog)
│ │ │ │ +void al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER *dialog)
      │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Frees up all resources used by the file dialog.

      │ │ │ │

      Examples:

      │ │ │ │ │ │ │ │

      al_show_native_message_box

      │ │ │ │ 
      int al_show_native_message_box(ALLEGRO_DISPLAY *display,
│ │ │ │     char const *title, char const *heading, char const *text,
│ │ │ │ -   char const *buttons, int flags)
      │ │ │ │ + char const *buttons, int flags) │ │ │ │ +int al_show_native_message_box(ALLEGRO_DISPLAY *display, │ │ │ │ + char const *title, char const *heading, char const *text, │ │ │ │ + char const *buttons, int flags) │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Show a native GUI message box. This can be used for example to │ │ │ │ display an error message if creation of an initial display fails. The │ │ │ │ display may be NULL, otherwise the given display is treated as the │ │ │ │ parent if possible.

      │ │ │ │ @@ -588,15 +607,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_nodisplay.c#L54">ex_nodisplay.c │ │ │ │
    • common.c
      • │ │ │ │
    • ex_menu.c
      • │ │ │ │
    │ │ │ │

    al_open_native_text_log

    │ │ │ │ -
    ALLEGRO_TEXTLOG *al_open_native_text_log(char const *title, int flags)
    │ │ │ │ +
    ALLEGRO_TEXTLOG *al_open_native_text_log(char const *title, int flags)
│ │ │ │ +ALLEGRO_TEXTLOG *al_open_native_text_log(char const *title, int flags)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Opens a window to which you can append log messages with al_append_native_text_log. │ │ │ │ This can be useful for debugging if you don’t want to depend on a │ │ │ │ console being available.

    │ │ │ │ @@ -629,15 +649,16 @@ │ │ │ │ │ │ │ │

    al_close_native_text_log

    │ │ │ │ -
    void al_close_native_text_log(ALLEGRO_TEXTLOG *textlog)
    │ │ │ │ +
    void al_close_native_text_log(ALLEGRO_TEXTLOG *textlog)
│ │ │ │ +void al_close_native_text_log(ALLEGRO_TEXTLOG *textlog)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Closes a message log window opened with al_open_native_text_log │ │ │ │ earlier.

    │ │ │ │

    Does nothing if passed NULL.

    │ │ │ │ @@ -648,15 +669,17 @@ │ │ │ │
  • common.c
    • │ │ │ │
  • ex_native_filechooser.c
    • │ │ │ │ │ │ │ │

    al_append_native_text_log

    │ │ │ │ 
    void al_append_native_text_log(ALLEGRO_TEXTLOG *textlog,
│ │ │ │ -   char const *format, ...)
    │ │ │ │ + char const *format, ...) │ │ │ │ +void al_append_native_text_log(ALLEGRO_TEXTLOG *textlog, │ │ │ │ + char const *format, ...) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Appends a line of text to the message log window and scrolls to the │ │ │ │ bottom (if the line would not be visible otherwise). This works like │ │ │ │ printf. A line is continued until you add a newline character.

    │ │ │ │

    If the window is NULL then this function will fall back to calling │ │ │ │ @@ -668,15 +691,17 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/common.c#L84">common.c │ │ │ │

  • ex_native_filechooser.c
    • │ │ │ │ │ │ │ │

    al_get_native_text_log_event_source

    │ │ │ │ 
    ALLEGRO_EVENT_SOURCE *al_get_native_text_log_event_source(
│ │ │ │ -   ALLEGRO_TEXTLOG *textlog)
    │ │ │ │ + ALLEGRO_TEXTLOG *textlog) │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_native_text_log_event_source( │ │ │ │ + ALLEGRO_TEXTLOG *textlog) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Get an event source for a text log window. The possible events │ │ │ │ are:

    │ │ │ │
    │ │ │ │
    ALLEGRO_EVENT_NATIVE_DIALOG_CLOSE
    │ │ │ │ @@ -696,15 +721,16 @@ │ │ │ │
  • ex_saw.c
    • │ │ │ │
  • ex_resample_test.c
    • │ │ │ │ │ │ │ │

    al_get_allegro_native_dialog_version

    │ │ │ │ -
    uint32_t al_get_allegro_native_dialog_version(void)
    │ │ │ │ +
    uint32_t al_get_allegro_native_dialog_version(void)
│ │ │ │ +uint32_t al_get_allegro_native_dialog_version(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

    │ │ │ │

    Menus

    │ │ │ │

    Menus are implemented on Windows, X and OS X. Menus on X are │ │ │ │ @@ -754,27 +780,29 @@ │ │ │ │ exit_program(); │ │ │ │ } │ │ │ │ } │ │ │ │

    Because there is no “DISPLAY_DESTROYED” event, you must call │ │ │ │ al_set_display_menu(display, NULL) before destroying any display with a │ │ │ │ menu attached, to avoid leaking resources.

    │ │ │ │

    ALLEGRO_MENU

    │ │ │ │ -
    typedef struct ALLEGRO_MENU ALLEGRO_MENU;
    │ │ │ │ +
    typedef struct ALLEGRO_MENU ALLEGRO_MENU;
│ │ │ │ +typedef struct ALLEGRO_MENU ALLEGRO_MENU;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An opaque data type that represents a menu that contains menu items. │ │ │ │ Each of the menu items may optionally include a sub-menu.

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    ALLEGRO_MENU_INFO

    │ │ │ │ -
    typedef struct ALLEGRO_MENU_INFO {
    │ │ │ │ +
    typedef struct ALLEGRO_MENU_INFO {
│ │ │ │ +typedef struct ALLEGRO_MENU_INFO {
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A structure that defines how to create a complete menu system. For │ │ │ │ standard menu items, the following format is used:

    │ │ │ │ 
       { caption, id, flags, icon }
    │ │ │ │

    For special items, these macros are helpful:

    │ │ │ │ @@ -809,26 +837,28 @@ │ │ │ │ href="native_dialog.html#al_build_menu">al_build_menu

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_create_menu

    │ │ │ │ -
    ALLEGRO_MENU *al_create_menu(void)
    │ │ │ │ +
    ALLEGRO_MENU *al_create_menu(void)
│ │ │ │ +ALLEGRO_MENU *al_create_menu(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates a menu container that can hold menu items.

    │ │ │ │

    Returns NULL on failure.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    See also: al_create_popup_menu, │ │ │ │ al_build_menu

    │ │ │ │

    al_create_popup_menu

    │ │ │ │ -
    ALLEGRO_MENU *al_create_popup_menu(void)
    │ │ │ │ +
    ALLEGRO_MENU *al_create_popup_menu(void)
│ │ │ │ +ALLEGRO_MENU *al_create_popup_menu(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Creates a menu container for popup menus. Only the root (outermost) │ │ │ │ menu should be created with this function. Sub menus of popups should be │ │ │ │ created with al_create_menu.

    │ │ │ │ @@ -839,15 +869,16 @@ │ │ │ │ href="native_dialog.html#al_build_menu">al_build_menu

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_build_menu

    │ │ │ │ -
    ALLEGRO_MENU *al_build_menu(ALLEGRO_MENU_INFO *info)
    │ │ │ │ +
    ALLEGRO_MENU *al_build_menu(ALLEGRO_MENU_INFO *info)
│ │ │ │ +ALLEGRO_MENU *al_build_menu(ALLEGRO_MENU_INFO *info)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Builds a menu based on the specifications of a sequence of │ │ │ │ ALLEGRO_MENU_INFO elements.

    │ │ │ │

    Returns a pointer to the root ALLEGRO_MENU, or │ │ │ │ NULL on failure. To gain access to the other menus and │ │ │ │ @@ -861,15 +892,17 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_append_menu_item

    │ │ │ │ 
    int al_append_menu_item(ALLEGRO_MENU *parent, char const *title, uint16_t id,
│ │ │ │ -   int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu)
    │ │ │ │ + int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ +int al_append_menu_item(ALLEGRO_MENU *parent, char const *title, uint16_t id, │ │ │ │ + int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Appends a menu item to the end of the menu. See al_insert_menu_item │ │ │ │ for more information.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │ @@ -880,15 +913,17 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_insert_menu_item

    │ │ │ │ 
    int al_insert_menu_item(ALLEGRO_MENU *parent, int pos, char const *title,
│ │ │ │ -   uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu)
    │ │ │ │ + uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ +int al_insert_menu_item(ALLEGRO_MENU *parent, int pos, char const *title, │ │ │ │ + uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Inserts a menu item at the spot specified. See the introductory text │ │ │ │ for a detailed explanation of how the pos parameter is │ │ │ │ interpreted.

    │ │ │ │

    The parent menu can be a popup menu or a regular menu. │ │ │ │ @@ -919,15 +954,16 @@ │ │ │ │

    Returns true on success.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    See also: al_append_menu_item, │ │ │ │ al_remove_menu_item

    │ │ │ │

    al_remove_menu_item

    │ │ │ │ -
    bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos)
    │ │ │ │ +
    bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos)
│ │ │ │ +bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Removes the specified item from the menu and destroys it. If the item │ │ │ │ contains a sub-menu, it too is destroyed. Any references to it are │ │ │ │ invalidated. If you want to preserve that sub-menu, you should first │ │ │ │ make a copy with al_destroy_menu

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_clone_menu

    │ │ │ │ -
    ALLEGRO_MENU *al_clone_menu(ALLEGRO_MENU *menu)
    │ │ │ │ +
    ALLEGRO_MENU *al_clone_menu(ALLEGRO_MENU *menu)
│ │ │ │ +ALLEGRO_MENU *al_clone_menu(ALLEGRO_MENU *menu)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Makes a copy of a menu so that it can be reused on another display. │ │ │ │ The menu being cloned can be anything: a regular menu, a popup menu, or │ │ │ │ a sub-menu.

    │ │ │ │

    Returns the cloned menu.

    │ │ │ │ @@ -959,15 +996,16 @@ │ │ │ │ href="native_dialog.html#al_clone_menu_for_popup">al_clone_menu_for_popup

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_clone_menu_for_popup

    │ │ │ │ -
    ALLEGRO_MENU *al_clone_menu_for_popup(ALLEGRO_MENU *menu)
    │ │ │ │ +
    ALLEGRO_MENU *al_clone_menu_for_popup(ALLEGRO_MENU *menu)
│ │ │ │ +ALLEGRO_MENU *al_clone_menu_for_popup(ALLEGRO_MENU *menu)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Exactly like al_clone_menu, except that │ │ │ │ the copy is for a popup menu.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │ @@ -975,15 +1013,16 @@ │ │ │ │ href="native_dialog.html#al_clone_menu">al_clone_menu

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_destroy_menu

    │ │ │ │ -
    void al_destroy_menu(ALLEGRO_MENU *menu)
    │ │ │ │ +
    void al_destroy_menu(ALLEGRO_MENU *menu)
│ │ │ │ +void al_destroy_menu(ALLEGRO_MENU *menu)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Destroys an entire menu, including its sub-menus. Any references to │ │ │ │ it or a sub-menu are no longer valid. It is safe to call this on a menu │ │ │ │ that is currently being displayed.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │ @@ -991,26 +1030,28 @@ │ │ │ │ href="native_dialog.html#al_remove_menu_item">al_remove_menu_item

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_menu_item_caption

    │ │ │ │ -
    const char *al_get_menu_item_caption(ALLEGRO_MENU *menu, int pos)
    │ │ │ │ +
    const char *al_get_menu_item_caption(ALLEGRO_MENU *menu, int pos)
│ │ │ │ +const char *al_get_menu_item_caption(ALLEGRO_MENU *menu, int pos)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the caption associated with the menu item. It is valid as │ │ │ │ long as the caption is not modified.

    │ │ │ │

    Returns NULL if the item was not found.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    See also: al_set_menu_item_caption

    │ │ │ │

    al_set_menu_item_caption

    │ │ │ │ -
    void al_set_menu_item_caption(ALLEGRO_MENU *menu, int pos, const char *caption)
    │ │ │ │ +
    void al_set_menu_item_caption(ALLEGRO_MENU *menu, int pos, const char *caption)
│ │ │ │ +void al_set_menu_item_caption(ALLEGRO_MENU *menu, int pos, const char *caption)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Updates the menu item caption with the new caption. This │ │ │ │ will invalidate any previous calls to al_get_menu_item_caption.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │ @@ -1018,15 +1059,16 @@ │ │ │ │ href="native_dialog.html#al_get_menu_item_caption">al_get_menu_item_caption

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_menu_item_flags

    │ │ │ │ -
    int al_get_menu_item_flags(ALLEGRO_MENU *menu, int pos)
    │ │ │ │ +
    int al_get_menu_item_flags(ALLEGRO_MENU *menu, int pos)
│ │ │ │ +int al_get_menu_item_flags(ALLEGRO_MENU *menu, int pos)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the currently set flags. See al_insert_menu_item │ │ │ │ for a description of the available flags.

    │ │ │ │

    Returns -1 if the item was not found.

    │ │ │ │ @@ -1037,15 +1079,16 @@ │ │ │ │ href="native_dialog.html#al_toggle_menu_item_flags">al_toggle_menu_item_flags

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_menu_item_flags

    │ │ │ │ -
    void al_set_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags)
    │ │ │ │ +
    void al_set_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags)
│ │ │ │ +void al_set_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Updates the menu item’s flags. See al_insert_menu_item │ │ │ │ for a description of the available flags.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │ @@ -1055,15 +1098,16 @@ │ │ │ │ href="native_dialog.html#al_toggle_menu_item_flags">al_toggle_menu_item_flags

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_toggle_menu_item_flags

    │ │ │ │ -
    int al_toggle_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags)
    │ │ │ │ +
    int al_toggle_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags)
│ │ │ │ +int al_toggle_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Toggles the specified menu item’s flags. See al_insert_menu_item │ │ │ │ for a description of the available flags.

    │ │ │ │

    Returns a bitfield of only the specified flags that are set after the │ │ │ │ @@ -1076,29 +1120,31 @@ │ │ │ │ al_get/set_menu_item_flags.

    │ │ │ │ │ │ │ │

    See also: al_get_menu_item_flags, │ │ │ │ al_set_menu_item_flags

    │ │ │ │

    al_get_menu_item_icon

    │ │ │ │ -
    ALLEGRO_BITMAP *al_get_menu_item_icon(ALLEGRO_MENU *menu, int pos)
    │ │ │ │ +
    ALLEGRO_BITMAP *al_get_menu_item_icon(ALLEGRO_MENU *menu, int pos)
│ │ │ │ +ALLEGRO_BITMAP *al_get_menu_item_icon(ALLEGRO_MENU *menu, int pos)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the icon associated with the menu. It is safe to draw to the │ │ │ │ returned bitmap, but you must call al_set_menu_item_icon │ │ │ │ in order for the changes to be applied.

    │ │ │ │

    Returns NULL if the item was not found or if it has no │ │ │ │ icon.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    See also: al_set_menu_item_icon

    │ │ │ │

    al_set_menu_item_icon

    │ │ │ │ -
    void al_set_menu_item_icon(ALLEGRO_MENU *menu, int pos, ALLEGRO_BITMAP *icon)
    │ │ │ │ +
    void al_set_menu_item_icon(ALLEGRO_MENU *menu, int pos, ALLEGRO_BITMAP *icon)
│ │ │ │ +void al_set_menu_item_icon(ALLEGRO_MENU *menu, int pos, ALLEGRO_BITMAP *icon)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Sets the icon for the specified menu item. The menu assumes ownership │ │ │ │ of the ALLEGRO_BITMAP and may invalidate the pointer, so │ │ │ │ you must clone it if you wish to continue using it.

    │ │ │ │

    If a video bitmap is passed, it will automatically be converted to a │ │ │ │ @@ -1109,15 +1155,16 @@ │ │ │ │ al_clone_bitmap

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_find_menu

    │ │ │ │ -
    ALLEGRO_MENU *al_find_menu(ALLEGRO_MENU *haystack, uint16_t id)
    │ │ │ │ +
    ALLEGRO_MENU *al_find_menu(ALLEGRO_MENU *haystack, uint16_t id)
│ │ │ │ +ALLEGRO_MENU *al_find_menu(ALLEGRO_MENU *haystack, uint16_t id)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Searches in the haystack menu for any submenu with the │ │ │ │ given id. (Note that this only represents a literal ID, and │ │ │ │ cannot be used as an index.)

    │ │ │ │

    Returns the menu, if found. Otherwise returns NULL.

    │ │ │ │ @@ -1127,15 +1174,17 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_find_menu_item

    │ │ │ │ 
    bool al_find_menu_item(ALLEGRO_MENU *haystack, uint16_t id, ALLEGRO_MENU **menu,
│ │ │ │ -   int *index)
    │ │ │ │ + int *index) │ │ │ │ +bool al_find_menu_item(ALLEGRO_MENU *haystack, uint16_t id, ALLEGRO_MENU **menu, │ │ │ │ + int *index) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Searches in the haystack menu for an item with the given │ │ │ │ id. (Note that this only represents a literal ID, and │ │ │ │ cannot be used as an index.)

    │ │ │ │

    If menu and index are not │ │ │ │ @@ -1144,15 +1193,16 @@ │ │ │ │ was not found, then their values are undefined.)

    │ │ │ │

    Returns true if the menu item was found.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    See also: al_find_menu

    │ │ │ │

    al_get_default_menu_event_source

    │ │ │ │ -
    ALLEGRO_EVENT_SOURCE *al_get_default_menu_event_source(void)
    │ │ │ │ +
    ALLEGRO_EVENT_SOURCE *al_get_default_menu_event_source(void)
│ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_default_menu_event_source(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the default event source used for menu clicks. If a menu was │ │ │ │ not given its own event source via al_enable_menu_event_source, │ │ │ │ then it will use this default source.

    │ │ │ │ @@ -1165,15 +1215,16 @@ │ │ │ │ href="native_dialog.html#al_disable_menu_event_source">al_disable_menu_event_source

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_enable_menu_event_source

    │ │ │ │ -
    ALLEGRO_EVENT_SOURCE *al_enable_menu_event_source(ALLEGRO_MENU *menu)
    │ │ │ │ +
    ALLEGRO_EVENT_SOURCE *al_enable_menu_event_source(ALLEGRO_MENU *menu)
│ │ │ │ +ALLEGRO_EVENT_SOURCE *al_enable_menu_event_source(ALLEGRO_MENU *menu)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Enables a unique event source for this menu. It and all of its │ │ │ │ sub-menus will use this event source. (It is safe to call this multiple │ │ │ │ times on the same menu.)

    │ │ │ │

    Returns the event source.

    │ │ │ │ @@ -1181,37 +1232,40 @@ │ │ │ │

    See also: al_register_event_source, │ │ │ │ al_get_default_menu_event_source, │ │ │ │ al_disable_menu_event_source

    │ │ │ │

    al_disable_menu_event_source

    │ │ │ │ -
    void al_disable_menu_event_source(ALLEGRO_MENU *menu)
    │ │ │ │ +
    void al_disable_menu_event_source(ALLEGRO_MENU *menu)
│ │ │ │ +void al_disable_menu_event_source(ALLEGRO_MENU *menu)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Disables a unique event source for the menu, causing it to use the │ │ │ │ default event source.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    See also: al_get_default_menu_event_source, │ │ │ │ al_enable_menu_event_source

    │ │ │ │

    al_get_display_menu

    │ │ │ │ -
    ALLEGRO_MENU *al_get_display_menu(ALLEGRO_DISPLAY *display)
    │ │ │ │ +
    ALLEGRO_MENU *al_get_display_menu(ALLEGRO_DISPLAY *display)
│ │ │ │ +ALLEGRO_MENU *al_get_display_menu(ALLEGRO_DISPLAY *displaynt,
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the menu associated with the display, or │ │ │ │ NULL if it does not have a menu.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    See also: al_set_display_menu

    │ │ │ │

    al_set_display_menu

    │ │ │ │ -
    bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu)
    │ │ │ │ +
    bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu)
│ │ │ │ +bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Associates the menu with the display and │ │ │ │ shows it. If there was a previous menu associated with the display, it │ │ │ │ will be destroyed. If you don’t want that to happen, you should first │ │ │ │ remove the menu with al_remove_display_menu

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_popup_menu

    │ │ │ │ -
    bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display)
    │ │ │ │ +
    bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display)
│ │ │ │ +bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Displays a context menu next to the mouse cursor. The menu must have │ │ │ │ been created with al_create_popup_menu. │ │ │ │ It generates events just like a regular display menu does. It is │ │ │ │ @@ -1261,15 +1316,16 @@ │ │ │ │ href="native_dialog.html#al_create_popup_menu">al_create_popup_menu

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_remove_display_menu

    │ │ │ │ -
    ALLEGRO_MENU *al_remove_display_menu(ALLEGRO_DISPLAY *display)
    │ │ │ │ +
    ALLEGRO_MENU *al_remove_display_menu(ALLEGRO_DISPLAY *display)
│ │ │ │ +ALLEGRO_MENU *al_remove_display_menu(ALLEGRO_DISPLAY *display)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Detaches the menu associated with the display and returns it. The │ │ │ │ menu can then be used on a different display.

    │ │ │ │

    If you simply want to destroy the active menu, you can call al_set_display_menu │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -88,27 +88,30 @@ │ │ │ │ │ o _a_l___p_o_p_u_p___m_e_n_u │ │ │ │ │ o _a_l___r_e_m_o_v_e___d_i_s_p_l_a_y___m_e_n_u │ │ │ │ │ These functions are declared in the following header file. Link with │ │ │ │ │ allegro_dialog. │ │ │ │ │ #include │ │ │ │ │ ************ AALLLLEEGGRROO__FFIILLEECCHHOOOOSSEERR ************ │ │ │ │ │ typedef struct ALLEGRO_FILECHOOSER ALLEGRO_FILECHOOSER; │ │ │ │ │ +typedef struct ALLEGRO_FILECHOOSER ALLEGRO_FILECHOOSER; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Opaque handle to a native file dialog. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ AALLLLEEGGRROO__TTEEXXTTLLOOGG ************ │ │ │ │ │ typedef struct ALLEGRO_TEXTLOG ALLEGRO_TEXTLOG; │ │ │ │ │ +typedef struct ALLEGRO_TEXTLOG ALLEGRO_TEXTLOG; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Opaque handle to a text log window. │ │ │ │ │ Examples: │ │ │ │ │ * _c_o_m_m_o_n_._c │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__iinniitt__nnaattiivvee__ddiiaalloogg__aaddddoonn ************ │ │ │ │ │ bool al_init_native_dialog_addon(void) │ │ │ │ │ +bool al_init_native_dialog_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Initialise the native dialog addon. │ │ │ │ │ Returns true on success, false on error. │ │ │ │ │ Since: 5.0.9, 5.1.0 │ │ │ │ │ NNoottee:: Prior to Allegro 5.1.0 native dialog functions could be called │ │ │ │ │ without explicit initialisation, but that is now deprecated. Future │ │ │ │ │ functionality may require explicit initialisation. An exception is │ │ │ │ │ @@ -117,30 +120,37 @@ │ │ │ │ │ See also: _a_l___s_h_u_t_d_o_w_n___n_a_t_i_v_e___d_i_a_l_o_g___a_d_d_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _c_o_m_m_o_n_._c │ │ │ │ │ * _e_x___w_i_n_d_o_w___m_a_x_i_m_i_z_e_d_._c │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ************ aall__iiss__nnaattiivvee__ddiiaalloogg__aaddddoonn__iinniittiiaalliizzeedd ************ │ │ │ │ │ bool al_is_native_dialog_addon_initialized(void) │ │ │ │ │ +bool al_is_native_dialog_addon_initialized(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the native dialog addon is initialized, otherwise returns │ │ │ │ │ false. │ │ │ │ │ Since: 5.2.6 │ │ │ │ │ ************ aall__sshhuuttddoowwnn__nnaattiivvee__ddiiaalloogg__aaddddoonn ************ │ │ │ │ │ void al_shutdown_native_dialog_addon(void) │ │ │ │ │ +void al_shutdown_native_dialog_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Shut down the native dialog addon. │ │ │ │ │ Since: 5.0.9, 5.1.5 │ │ │ │ │ See also: _a_l___i_n_i_t___n_a_t_i_v_e___d_i_a_l_o_g___a_d_d_o_n │ │ │ │ │ ************ aall__ccrreeaattee__nnaattiivvee__ffiillee__ddiiaalloogg ************ │ │ │ │ │ ALLEGRO_FILECHOOSER *al_create_native_file_dialog( │ │ │ │ │ char const *initial_path, │ │ │ │ │ char const *title, │ │ │ │ │ char const *patterns, │ │ │ │ │ int mode) │ │ │ │ │ +ALLEGRO_FILECHOOSER *al_create_native_file_dialog( │ │ │ │ │ + char const *initial_path, │ │ │ │ │ + char const *title, │ │ │ │ │ + char const *patterns,eta, float delta_theta, float thickness, │ │ │ │ │ + int mode) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a new native file dialog. You should only have one such dialog opened │ │ │ │ │ at a time. │ │ │ │ │ Parameters: │ │ │ │ │ * initial_path: The initial search path and filename. Can be NULL. To start │ │ │ │ │ with a blank file name the string should end with a directory separator │ │ │ │ │ (this should be the common case). │ │ │ │ │ @@ -194,54 +204,63 @@ │ │ │ │ │ are done, call _a_l___d_e_s_t_r_o_y___n_a_t_i_v_e___f_i_l_e___d_i_a_l_o_g on it. │ │ │ │ │ If a dialog window could not be created then this function returns NULL. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__sshhooww__nnaattiivvee__ffiillee__ddiiaalloogg ************ │ │ │ │ │ bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display, │ │ │ │ │ ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ +bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display, │ │ │ │ │ + ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Show the dialog window. The display may be NULL, otherwise the given display is │ │ │ │ │ treated as the parent if possible. │ │ │ │ │ This function blocks the calling thread until it returns, so you may want to │ │ │ │ │ spawn a thread with _a_l___c_r_e_a_t_e___t_h_r_e_a_d and call it from inside that thread. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ NNoottee:: On Android, _A_L_L_E_G_R_O___E_V_E_N_T___D_I_S_P_L_A_Y___H_A_L_T___D_R_A_W_I_N_G and │ │ │ │ │ _A_L_L_E_G_R_O___E_V_E_N_T___D_I_S_P_L_A_Y___R_E_S_U_M_E___D_R_A_W_I_N_G need to be handled before this │ │ │ │ │ function returns. This means that you must call it from a different │ │ │ │ │ thread. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__ggeett__nnaattiivvee__ffiillee__ddiiaalloogg__ccoouunntt ************ │ │ │ │ │ int al_get_native_file_dialog_count(const ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ +int al_get_native_file_dialog_count(const ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the number of files selected, or 0 if the dialog was cancelled. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__ggeett__nnaattiivvee__ffiillee__ddiiaalloogg__ppaatthh ************ │ │ │ │ │ const char *al_get_native_file_dialog_path( │ │ │ │ │ const ALLEGRO_FILECHOOSER *dialog, size_t i) │ │ │ │ │ +const char *al_get_native_file_dialog_path( │ │ │ │ │ + const ALLEGRO_FILECHOOSER *dialog, size_t i) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns one of the selected paths with index i. The index should range from 0 │ │ │ │ │ to the return value of _a_l___g_e_t___n_a_t_i_v_e___f_i_l_e___d_i_a_l_o_g___c_o_u_n_t -1. │ │ │ │ │ NNoottee:: On Android, this function returns a content:// Universal │ │ │ │ │ Resource Identifier instead of a file path due to the constraints of │ │ │ │ │ Scoped Storage. Selected files may be accessed using │ │ │ │ │ _a_l___a_n_d_r_o_i_d___o_p_e_n___f_d. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__ddeessttrrooyy__nnaattiivvee__ffiillee__ddiiaalloogg ************ │ │ │ │ │ void al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ +void al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Frees up all resources used by the file dialog. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__sshhooww__nnaattiivvee__mmeessssaaggee__bbooxx ************ │ │ │ │ │ int al_show_native_message_box(ALLEGRO_DISPLAY *display, │ │ │ │ │ char const *title, char const *heading, char const *text, │ │ │ │ │ char const *buttons, int flags) │ │ │ │ │ +int al_show_native_message_box(ALLEGRO_DISPLAY *display, │ │ │ │ │ + char const *title, char const *heading, char const *text, │ │ │ │ │ + char const *buttons, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Show a native GUI message box. This can be used for example to display an error │ │ │ │ │ message if creation of an initial display fails. The display may be NULL, │ │ │ │ │ otherwise the given display is treated as the parent if possible. │ │ │ │ │ The message box will have a single “OK” button and use the style informative │ │ │ │ │ dialog boxes usually have on the native system. If the buttons parameter is not │ │ │ │ │ NULL, you can instead specify the button text in a string, with buttons │ │ │ │ │ @@ -286,14 +305,15 @@ │ │ │ │ │ ); │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___n_o_d_i_s_p_l_a_y_._c │ │ │ │ │ * _c_o_m_m_o_n_._c │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ************ aall__ooppeenn__nnaattiivvee__tteexxtt__lloogg ************ │ │ │ │ │ ALLEGRO_TEXTLOG *al_open_native_text_log(char const *title, int flags) │ │ │ │ │ +ALLEGRO_TEXTLOG *al_open_native_text_log(char const *title, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Opens a window to which you can append log messages with │ │ │ │ │ _a_l___a_p_p_e_n_d___n_a_t_i_v_e___t_e_x_t___l_o_g. This can be useful for debugging if you don’t want │ │ │ │ │ to depend on a console being available. │ │ │ │ │ Use _a_l___c_l_o_s_e___n_a_t_i_v_e___t_e_x_t___l_o_g to close the window again. │ │ │ │ │ The flags available are: │ │ │ │ │ ALLEGRO_TEXTLOG_NO_CLOSE │ │ │ │ │ @@ -307,50 +327,56 @@ │ │ │ │ │ NNoottee:: On Android, logs can be viewed using logcat. │ │ │ │ │ See also: _a_l___a_p_p_e_n_d___n_a_t_i_v_e___t_e_x_t___l_o_g, _a_l___c_l_o_s_e___n_a_t_i_v_e___t_e_x_t___l_o_g │ │ │ │ │ Examples: │ │ │ │ │ * _c_o_m_m_o_n_._c │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__cclloossee__nnaattiivvee__tteexxtt__lloogg ************ │ │ │ │ │ void al_close_native_text_log(ALLEGRO_TEXTLOG *textlog) │ │ │ │ │ +void al_close_native_text_log(ALLEGRO_TEXTLOG *textlog) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Closes a message log window opened with _a_l___o_p_e_n___n_a_t_i_v_e___t_e_x_t___l_o_g earlier. │ │ │ │ │ Does nothing if passed NULL. │ │ │ │ │ See also: _a_l___o_p_e_n___n_a_t_i_v_e___t_e_x_t___l_o_g │ │ │ │ │ Examples: │ │ │ │ │ * _c_o_m_m_o_n_._c │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__aappppeenndd__nnaattiivvee__tteexxtt__lloogg ************ │ │ │ │ │ void al_append_native_text_log(ALLEGRO_TEXTLOG *textlog, │ │ │ │ │ char const *format, ...) │ │ │ │ │ +void al_append_native_text_log(ALLEGRO_TEXTLOG *textlog, │ │ │ │ │ + char const *format, ...) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Appends a line of text to the message log window and scrolls to the bottom (if │ │ │ │ │ the line would not be visible otherwise). This works like printf. A line is │ │ │ │ │ continued until you add a newline character. │ │ │ │ │ If the window is NULL then this function will fall back to calling printf. This │ │ │ │ │ makes it convenient to support logging to a window or a terminal. │ │ │ │ │ Examples: │ │ │ │ │ * _c_o_m_m_o_n_._c │ │ │ │ │ * _e_x___n_a_t_i_v_e___f_i_l_e_c_h_o_o_s_e_r_._c │ │ │ │ │ ************ aall__ggeett__nnaattiivvee__tteexxtt__lloogg__eevveenntt__ssoouurrccee ************ │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_native_text_log_event_source( │ │ │ │ │ ALLEGRO_TEXTLOG *textlog) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_native_text_log_event_source( │ │ │ │ │ + ALLEGRO_TEXTLOG *textlog) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get an event source for a text log window. The possible events are: │ │ │ │ │ ALLEGRO_EVENT_NATIVE_DIALOG_CLOSE │ │ │ │ │ The window was requested to be closed, either by pressing the close │ │ │ │ │ button or pressing Escape on the keyboard. The user.data1 field will hold │ │ │ │ │ a pointer to the _A_L_L_E_G_R_O___T_E_X_T_L_O_G which generated the event. The │ │ │ │ │ user.data2 field will be 1 if the event was generated as a result of a │ │ │ │ │ key press; otherwise it will be zero. │ │ │ │ │ Examples: │ │ │ │ │ * _c_o_m_m_o_n_._c │ │ │ │ │ * _e_x___s_a_w_._c │ │ │ │ │ * _e_x___r_e_s_a_m_p_l_e___t_e_s_t_._c │ │ │ │ │ ************ aall__ggeett__aalllleeggrroo__nnaattiivvee__ddiiaalloogg__vveerrssiioonn ************ │ │ │ │ │ uint32_t al_get_allegro_native_dialog_version(void) │ │ │ │ │ +uint32_t al_get_allegro_native_dialog_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ ************ MMeennuuss ************ │ │ │ │ │ Menus are implemented on Windows, X and OS X. Menus on X are implemented with │ │ │ │ │ GTK, and have a special requirement: you must set the ALLEGRO_GTK_TOPLEVEL │ │ │ │ │ display flag prior to creating the display which will have menus attached. │ │ │ │ │ @@ -394,21 +420,23 @@ │ │ │ │ │ } │ │ │ │ │ } │ │ │ │ │ Because there is no “DISPLAY_DESTROYED” event, you must call │ │ │ │ │ al_set_display_menu(display, NULL) before destroying any display with a menu │ │ │ │ │ attached, to avoid leaking resources. │ │ │ │ │ ********** AALLLLEEGGRROO__MMEENNUU ********** │ │ │ │ │ typedef struct ALLEGRO_MENU ALLEGRO_MENU; │ │ │ │ │ +typedef struct ALLEGRO_MENU ALLEGRO_MENU; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An opaque data type that represents a menu that contains menu items. Each of │ │ │ │ │ the menu items may optionally include a sub-menu. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** AALLLLEEGGRROO__MMEENNUU__IINNFFOO ********** │ │ │ │ │ typedef struct ALLEGRO_MENU_INFO { │ │ │ │ │ +typedef struct ALLEGRO_MENU_INFO { │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A structure that defines how to create a complete menu system. For standard │ │ │ │ │ menu items, the following format is used: │ │ │ │ │ { caption, id, flags, icon } │ │ │ │ │ For special items, these macros are helpful: │ │ │ │ │ ALLEGRO_START_OF_MENU(caption, id) │ │ │ │ │ ALLEGRO_MENU_SEPARATOR │ │ │ │ │ @@ -436,55 +464,62 @@ │ │ │ │ │ If you prefer, you can build the menu without the structure by using │ │ │ │ │ _a_l___c_r_e_a_t_e___m_e_n_u and _a_l___i_n_s_e_r_t___m_e_n_u___i_t_e_m. │ │ │ │ │ See also: _a_l___b_u_i_l_d___m_e_n_u │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__ccrreeaattee__mmeennuu ********** │ │ │ │ │ ALLEGRO_MENU *al_create_menu(void) │ │ │ │ │ +ALLEGRO_MENU *al_create_menu(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a menu container that can hold menu items. │ │ │ │ │ Returns NULL on failure. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___p_o_p_u_p___m_e_n_u, _a_l___b_u_i_l_d___m_e_n_u │ │ │ │ │ ********** aall__ccrreeaattee__ppooppuupp__mmeennuu ********** │ │ │ │ │ ALLEGRO_MENU *al_create_popup_menu(void) │ │ │ │ │ +ALLEGRO_MENU *al_create_popup_menu(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a menu container for popup menus. Only the root (outermost) menu should │ │ │ │ │ be created with this function. Sub menus of popups should be created with │ │ │ │ │ _a_l___c_r_e_a_t_e___m_e_n_u. │ │ │ │ │ Returns NULL on failure. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___m_e_n_u, _a_l___b_u_i_l_d___m_e_n_u │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__bbuuiilldd__mmeennuu ********** │ │ │ │ │ ALLEGRO_MENU *al_build_menu(ALLEGRO_MENU_INFO *info) │ │ │ │ │ +ALLEGRO_MENU *al_build_menu(ALLEGRO_MENU_INFO *info) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Builds a menu based on the specifications of a sequence of ALLEGRO_MENU_INFO │ │ │ │ │ elements. │ │ │ │ │ Returns a pointer to the root ALLEGRO_MENU, or NULL on failure. To gain access │ │ │ │ │ to the other menus and items, you will need to search for them using │ │ │ │ │ _a_l___f_i_n_d___m_e_n_u___i_t_e_m. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _A_L_L_E_G_R_O___M_E_N_U___I_N_F_O, _a_l___c_r_e_a_t_e___m_e_n_u, _a_l___c_r_e_a_t_e___p_o_p_u_p___m_e_n_u │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__aappppeenndd__mmeennuu__iitteemm ********** │ │ │ │ │ int al_append_menu_item(ALLEGRO_MENU *parent, char const *title, uint16_t id, │ │ │ │ │ int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ │ +int al_append_menu_item(ALLEGRO_MENU *parent, char const *title, uint16_t id, │ │ │ │ │ + int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Appends a menu item to the end of the menu. See _a_l___i_n_s_e_r_t___m_e_n_u___i_t_e_m for more │ │ │ │ │ information. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___i_n_s_e_r_t___m_e_n_u___i_t_e_m, _a_l___r_e_m_o_v_e___m_e_n_u___i_t_e_m │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__iinnsseerrtt__mmeennuu__iitteemm ********** │ │ │ │ │ int al_insert_menu_item(ALLEGRO_MENU *parent, int pos, char const *title, │ │ │ │ │ uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ │ +int al_insert_menu_item(ALLEGRO_MENU *parent, int pos, char const *title, │ │ │ │ │ + uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Inserts a menu item at the spot specified. See the introductory text for a │ │ │ │ │ detailed explanation of how the pos parameter is interpreted. │ │ │ │ │ The parent menu can be a popup menu or a regular menu. To underline one │ │ │ │ │ character in the title, prefix it with an ampersand. │ │ │ │ │ The flags can be any combination of: │ │ │ │ │ ALLEGRO_MENU_ITEM_DISABLED │ │ │ │ │ @@ -500,181 +535,201 @@ │ │ │ │ │ menu must have previously been created with al_create_menu, and not be │ │ │ │ │ associated with any other menu. │ │ │ │ │ Returns true on success. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___a_p_p_e_n_d___m_e_n_u___i_t_e_m, _a_l___r_e_m_o_v_e___m_e_n_u___i_t_e_m │ │ │ │ │ ********** aall__rreemmoovvee__mmeennuu__iitteemm ********** │ │ │ │ │ bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ +bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Removes the specified item from the menu and destroys it. If the item contains │ │ │ │ │ a sub-menu, it too is destroyed. Any references to it are invalidated. If you │ │ │ │ │ want to preserve that sub-menu, you should first make a copy with │ │ │ │ │ _a_l___c_l_o_n_e___m_e_n_u. │ │ │ │ │ This is safe to call on a menu that is currently being displayed. │ │ │ │ │ Returns true if an item was removed. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___a_p_p_e_n_d___m_e_n_u___i_t_e_m, _a_l___i_n_s_e_r_t___m_e_n_u___i_t_e_m, _a_l___d_e_s_t_r_o_y___m_e_n_u │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__cclloonnee__mmeennuu ********** │ │ │ │ │ ALLEGRO_MENU *al_clone_menu(ALLEGRO_MENU *menu) │ │ │ │ │ +ALLEGRO_MENU *al_clone_menu(ALLEGRO_MENU *menu) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Makes a copy of a menu so that it can be reused on another display. The menu │ │ │ │ │ being cloned can be anything: a regular menu, a popup menu, or a sub-menu. │ │ │ │ │ Returns the cloned menu. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___c_l_o_n_e___m_e_n_u___f_o_r___p_o_p_u_p │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__cclloonnee__mmeennuu__ffoorr__ppooppuupp ********** │ │ │ │ │ ALLEGRO_MENU *al_clone_menu_for_popup(ALLEGRO_MENU *menu) │ │ │ │ │ +ALLEGRO_MENU *al_clone_menu_for_popup(ALLEGRO_MENU *menu) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Exactly like _a_l___c_l_o_n_e___m_e_n_u, except that the copy is for a popup menu. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___c_l_o_n_e___m_e_n_u │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__mmeennuu ********** │ │ │ │ │ void al_destroy_menu(ALLEGRO_MENU *menu) │ │ │ │ │ +void al_destroy_menu(ALLEGRO_MENU *menu) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Destroys an entire menu, including its sub-menus. Any references to it or a │ │ │ │ │ sub-menu are no longer valid. It is safe to call this on a menu that is │ │ │ │ │ currently being displayed. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___r_e_m_o_v_e___m_e_n_u___i_t_e_m │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__ggeett__mmeennuu__iitteemm__ccaappttiioonn ********** │ │ │ │ │ const char *al_get_menu_item_caption(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ +const char *al_get_menu_item_caption(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the caption associated with the menu item. It is valid as long as the │ │ │ │ │ caption is not modified. │ │ │ │ │ Returns NULL if the item was not found. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___s_e_t___m_e_n_u___i_t_e_m___c_a_p_t_i_o_n │ │ │ │ │ ********** aall__sseett__mmeennuu__iitteemm__ccaappttiioonn ********** │ │ │ │ │ void al_set_menu_item_caption(ALLEGRO_MENU *menu, int pos, const char *caption) │ │ │ │ │ +void al_set_menu_item_caption(ALLEGRO_MENU *menu, int pos, const char *caption) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Updates the menu item caption with the new caption. This will invalidate any │ │ │ │ │ previous calls to _a_l___g_e_t___m_e_n_u___i_t_e_m___c_a_p_t_i_o_n. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___g_e_t___m_e_n_u___i_t_e_m___c_a_p_t_i_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__ggeett__mmeennuu__iitteemm__ffllaaggss ********** │ │ │ │ │ int al_get_menu_item_flags(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ +int al_get_menu_item_flags(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the currently set flags. See _a_l___i_n_s_e_r_t___m_e_n_u___i_t_e_m for a description of │ │ │ │ │ the available flags. │ │ │ │ │ Returns -1 if the item was not found. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___s_e_t___m_e_n_u___i_t_e_m___f_l_a_g_s, _a_l___t_o_g_g_l_e___m_e_n_u___i_t_e_m___f_l_a_g_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__sseett__mmeennuu__iitteemm__ffllaaggss ********** │ │ │ │ │ void al_set_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags) │ │ │ │ │ +void al_set_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Updates the menu item’s flags. See _a_l___i_n_s_e_r_t___m_e_n_u___i_t_e_m for a description of the │ │ │ │ │ available flags. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___g_e_t___m_e_n_u___i_t_e_m___f_l_a_g_s, _a_l___t_o_g_g_l_e___m_e_n_u___i_t_e_m___f_l_a_g_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__ttooggggllee__mmeennuu__iitteemm__ffllaaggss ********** │ │ │ │ │ int al_toggle_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags) │ │ │ │ │ +int al_toggle_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Toggles the specified menu item’s flags. See _a_l___i_n_s_e_r_t___m_e_n_u___i_t_e_m for a │ │ │ │ │ description of the available flags. │ │ │ │ │ Returns a bitfield of only the specified flags that are set after the toggle. A │ │ │ │ │ flag that was not toggled will not be returned, even if it is set. Returns - │ │ │ │ │ 1 if the id is invalid. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: Redundant with al_get/set_menu_item_flags. │ │ │ │ │ See also: _a_l___g_e_t___m_e_n_u___i_t_e_m___f_l_a_g_s, _a_l___s_e_t___m_e_n_u___i_t_e_m___f_l_a_g_s │ │ │ │ │ ********** aall__ggeett__mmeennuu__iitteemm__iiccoonn ********** │ │ │ │ │ ALLEGRO_BITMAP *al_get_menu_item_icon(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ +ALLEGRO_BITMAP *al_get_menu_item_icon(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the icon associated with the menu. It is safe to draw to the returned │ │ │ │ │ bitmap, but you must call _a_l___s_e_t___m_e_n_u___i_t_e_m___i_c_o_n in order for the changes to be │ │ │ │ │ applied. │ │ │ │ │ Returns NULL if the item was not found or if it has no icon. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___s_e_t___m_e_n_u___i_t_e_m___i_c_o_n │ │ │ │ │ ********** aall__sseett__mmeennuu__iitteemm__iiccoonn ********** │ │ │ │ │ void al_set_menu_item_icon(ALLEGRO_MENU *menu, int pos, ALLEGRO_BITMAP *icon) │ │ │ │ │ +void al_set_menu_item_icon(ALLEGRO_MENU *menu, int pos, ALLEGRO_BITMAP *icon) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sets the icon for the specified menu item. The menu assumes ownership of the │ │ │ │ │ ALLEGRO_BITMAP and may invalidate the pointer, so you must clone it if you wish │ │ │ │ │ to continue using it. │ │ │ │ │ If a video bitmap is passed, it will automatically be converted to a memory │ │ │ │ │ bitmap, so it is preferable to pass a memory bitmap. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___g_e_t___m_e_n_u___i_t_e_m___i_c_o_n, _a_l___c_l_o_n_e___b_i_t_m_a_p │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__ffiinndd__mmeennuu ********** │ │ │ │ │ ALLEGRO_MENU *al_find_menu(ALLEGRO_MENU *haystack, uint16_t id) │ │ │ │ │ +ALLEGRO_MENU *al_find_menu(ALLEGRO_MENU *haystack, uint16_t id) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Searches in the haystack menu for any submenu with the given id. (Note that │ │ │ │ │ this only represents a literal ID, and cannot be used as an index.) │ │ │ │ │ Returns the menu, if found. Otherwise returns NULL. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___f_i_n_d___m_e_n_u___i_t_e_m │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__ffiinndd__mmeennuu__iitteemm ********** │ │ │ │ │ bool al_find_menu_item(ALLEGRO_MENU *haystack, uint16_t id, ALLEGRO_MENU │ │ │ │ │ **menu, │ │ │ │ │ int *index) │ │ │ │ │ +bool al_find_menu_item(ALLEGRO_MENU *haystack, uint16_t id, ALLEGRO_MENU │ │ │ │ │ +**menu, │ │ │ │ │ + int *index) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Searches in the haystack menu for an item with the given id. (Note that this │ │ │ │ │ only represents a literal ID, and cannot be used as an index.) │ │ │ │ │ If menu and index are not NULL, they will be set as the parent menu containing │ │ │ │ │ the item and the zero-based (positive) index of the item. (If the menu item was │ │ │ │ │ not found, then their values are undefined.) │ │ │ │ │ Returns true if the menu item was found. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___f_i_n_d___m_e_n_u │ │ │ │ │ ********** aall__ggeett__ddeeffaauulltt__mmeennuu__eevveenntt__ssoouurrccee ********** │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_default_menu_event_source(void) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_default_menu_event_source(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the default event source used for menu clicks. If a menu was not given │ │ │ │ │ its own event source via _a_l___e_n_a_b_l_e___m_e_n_u___e_v_e_n_t___s_o_u_r_c_e, then it will use this │ │ │ │ │ default source. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___e_v_e_n_t___s_o_u_r_c_e, _a_l___e_n_a_b_l_e___m_e_n_u___e_v_e_n_t___s_o_u_r_c_e, │ │ │ │ │ _a_l___d_i_s_a_b_l_e___m_e_n_u___e_v_e_n_t___s_o_u_r_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__eennaabbllee__mmeennuu__eevveenntt__ssoouurrccee ********** │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_enable_menu_event_source(ALLEGRO_MENU *menu) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_enable_menu_event_source(ALLEGRO_MENU *menu) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Enables a unique event source for this menu. It and all of its sub-menus will │ │ │ │ │ use this event source. (It is safe to call this multiple times on the same │ │ │ │ │ menu.) │ │ │ │ │ Returns the event source. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___r_e_g_i_s_t_e_r___e_v_e_n_t___s_o_u_r_c_e, _a_l___g_e_t___d_e_f_a_u_l_t___m_e_n_u___e_v_e_n_t___s_o_u_r_c_e, │ │ │ │ │ _a_l___d_i_s_a_b_l_e___m_e_n_u___e_v_e_n_t___s_o_u_r_c_e │ │ │ │ │ ********** aall__ddiissaabbllee__mmeennuu__eevveenntt__ssoouurrccee ********** │ │ │ │ │ void al_disable_menu_event_source(ALLEGRO_MENU *menu) │ │ │ │ │ +void al_disable_menu_event_source(ALLEGRO_MENU *menu) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Disables a unique event source for the menu, causing it to use the default │ │ │ │ │ event source. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___g_e_t___d_e_f_a_u_l_t___m_e_n_u___e_v_e_n_t___s_o_u_r_c_e, _a_l___e_n_a_b_l_e___m_e_n_u___e_v_e_n_t___s_o_u_r_c_e │ │ │ │ │ ********** aall__ggeett__ddiissppllaayy__mmeennuu ********** │ │ │ │ │ ALLEGRO_MENU *al_get_display_menu(ALLEGRO_DISPLAY *display) │ │ │ │ │ +ALLEGRO_MENU *al_get_display_menu(ALLEGRO_DISPLAY *displaynt, │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the menu associated with the display, or NULL if it does not have a │ │ │ │ │ menu. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___s_e_t___d_i_s_p_l_a_y___m_e_n_u │ │ │ │ │ ********** aall__sseett__ddiissppllaayy__mmeennuu ********** │ │ │ │ │ bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu) │ │ │ │ │ +bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Associates the menu with the display and shows it. If there was a previous menu │ │ │ │ │ associated with the display, it will be destroyed. If you don’t want that to │ │ │ │ │ happen, you should first remove the menu with _a_l___r_e_m_o_v_e___d_i_s_p_l_a_y___m_e_n_u. │ │ │ │ │ If the menu is already attached to a display, it will not be attached to the │ │ │ │ │ new display. If menu is NULL, the current menu will still be destroyed. │ │ │ │ │ NNoottee:: Attaching a menu may cause the window as available to your │ │ │ │ │ @@ -684,14 +739,15 @@ │ │ │ │ │ Returns true if successful. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___m_e_n_u, _a_l___r_e_m_o_v_e___d_i_s_p_l_a_y___m_e_n_u │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__ppooppuupp__mmeennuu ********** │ │ │ │ │ bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display) │ │ │ │ │ +bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Displays a context menu next to the mouse cursor. The menu must have been │ │ │ │ │ created with _a_l___c_r_e_a_t_e___p_o_p_u_p___m_e_n_u. It generates events just like a regular │ │ │ │ │ display menu does. It is possible that the menu will be canceled without any │ │ │ │ │ selection being made. │ │ │ │ │ The display parameter indicates which window the menu is associated with (when │ │ │ │ │ you process the menu click event), but does not actually affect where the menu │ │ │ │ │ @@ -703,14 +759,15 @@ │ │ │ │ │ corresponds to the final mouse button that was pressed. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___p_o_p_u_p___m_e_n_u │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_e_n_u_._c │ │ │ │ │ ********** aall__rreemmoovvee__ddiissppllaayy__mmeennuu ********** │ │ │ │ │ ALLEGRO_MENU *al_remove_display_menu(ALLEGRO_DISPLAY *display) │ │ │ │ │ +ALLEGRO_MENU *al_remove_display_menu(ALLEGRO_DISPLAY *display) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Detaches the menu associated with the display and returns it. The menu can then │ │ │ │ │ be used on a different display. │ │ │ │ │ If you simply want to destroy the active menu, you can call _a_l___s_e_t___d_i_s_p_l_a_y___m_e_n_u │ │ │ │ │ with a NULL menu. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___s_e_t___d_i_s_p_l_a_y___m_e_n_u │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/physfs.html │ │ │ │ @@ -191,15 +191,16 @@ │ │ │ │ href="physfs.html#al_set_physfs_file_interface">al_set_physfs_file_interface, │ │ │ │ then al_fopen or another function that │ │ │ │ calls al_fopen.

    │ │ │ │

    These functions are declared in the following header file. Link with │ │ │ │ allegro_physfs.

    │ │ │ │ 
     #include <allegro5/allegro_physfs.h>
    │ │ │ │

    al_set_physfs_file_interface

    │ │ │ │ -
    void al_set_physfs_file_interface(void)
    │ │ │ │ +
    void al_set_physfs_file_interface(void)
│ │ │ │ +void al_set_physfs_file_interface(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This function sets both the ALLEGRO_FILE_INTERFACE and │ │ │ │ ALLEGRO_FS_INTERFACE for │ │ │ │ the calling thread.

    │ │ │ │ @@ -231,15 +232,16 @@ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_allegro_physfs_version

    │ │ │ │ -
    uint32_t al_get_allegro_physfs_version(void)
    │ │ │ │ +
    uint32_t al_get_allegro_physfs_version(void)
│ │ │ │ +uint32_t al_get_allegro_physfs_version(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

    │ │ │ │

    │ │ │ │ Allegro version 5.2.10 │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -54,14 +54,15 @@ │ │ │ │ │ ALLEGRO_FILE using PhysicsFS, first call _a_l___s_e_t___p_h_y_s_f_s___f_i_l_e___i_n_t_e_r_f_a_c_e, then │ │ │ │ │ _a_l___f_o_p_e_n or another function that calls _a_l___f_o_p_e_n. │ │ │ │ │ These functions are declared in the following header file. Link with │ │ │ │ │ allegro_physfs. │ │ │ │ │ #include │ │ │ │ │ ************ aall__sseett__pphhyyssffss__ffiillee__iinntteerrffaaccee ************ │ │ │ │ │ void al_set_physfs_file_interface(void) │ │ │ │ │ +void al_set_physfs_file_interface(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This function sets bbootthh the _A_L_L_E_G_R_O___F_I_L_E___I_N_T_E_R_F_A_C_E and _A_L_L_E_G_R_O___F_S___I_N_T_E_R_F_A_C_E for │ │ │ │ │ the calling thread. │ │ │ │ │ Subsequent calls to _a_l___f_o_p_e_n on the calling thread will be handled by │ │ │ │ │ PHYSFS_open(). Operations on the files returned by _a_l___f_o_p_e_n will then be │ │ │ │ │ performed through PhysicsFS. Calls to the Allegro filesystem functions, such as │ │ │ │ │ _a_l___r_e_a_d___d_i_r_e_c_t_o_r_y or _a_l___c_r_e_a_t_e___f_s___e_n_t_r_y, on the calling thread will be diverted │ │ │ │ │ @@ -74,11 +75,12 @@ │ │ │ │ │ NNoottee:: PhysFS does not support the text-mode reading and writing, │ │ │ │ │ which means that Windows-style newlines will not be preserved. │ │ │ │ │ See also: _a_l___s_e_t___n_e_w___f_i_l_e___i_n_t_e_r_f_a_c_e. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_h_y_s_f_s_._c │ │ │ │ │ ************ aall__ggeett__aalllleeggrroo__pphhyyssffss__vveerrssiioonn ************ │ │ │ │ │ uint32_t al_get_allegro_physfs_version(void) │ │ │ │ │ +uint32_t al_get_allegro_physfs_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ Allegro version 5.2.10 - Last updated: 2025-01-09 13:52:42 UTC │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/platform.html │ │ │ │ @@ -476,11 +476,14 @@ │ │ │ │ API: New API.

    │ │ │ │ │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │ - │ │ │ │ +

    │ │ │ │ +Allegro version 5.2.10 │ │ │ │ + - Last updated: 2025-01-09 13:52:42 UTC │ │ │ │ +

    │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -236,7 +236,8 @@ │ │ │ │ │ work and you need to use a .desktop file. But with this function you can set an │ │ │ │ │ icon before calling al_create_display. This works by setting the icon before │ │ │ │ │ XMapWindow. │ │ │ │ │ Since: 5.2.3 │ │ │ │ │ _UU_nn_ss_tt_aa_bb_ll_ee_ _AA_PP_II:: New API. │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___i_c_o_n_2_._c │ │ │ │ │ +Allegro version 5.2.10 - Last updated: 2025-01-09 13:52:42 UTC │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/primitives.html │ │ │ │ @@ -328,53 +328,57 @@ │ │ │ │ │ │ │ │

    These functions are declared in the following header file. Link with │ │ │ │ allegro_primitives.

    │ │ │ │ 
     #include <allegro5/allegro_primitives.h>
    │ │ │ │

    General

    │ │ │ │

    al_get_allegro_primitives_version

    │ │ │ │ -
    uint32_t al_get_allegro_primitives_version(void)
    │ │ │ │ +
    uint32_t al_get_allegro_primitives_version(void)
│ │ │ │ +uint32_t al_get_allegro_primitives_version(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

    │ │ │ │

    al_init_primitives_addon

    │ │ │ │ -
    bool al_init_primitives_addon(void)
    │ │ │ │ +
    bool al_init_primitives_addon(void)
│ │ │ │ +bool al_init_primitives_addon(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Initializes the primitives addon.

    │ │ │ │

    Returns: True on success, false on failure.

    │ │ │ │

    See also: al_shutdown_primitives_addon

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_is_primitives_addon_initialized

    │ │ │ │ -
    bool al_is_primitives_addon_initialized(void)
    │ │ │ │ +
    bool al_is_primitives_addon_initialized(void)
│ │ │ │ +bool al_is_primitives_addon_initialized(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if the primitives addon is initialized, otherwise │ │ │ │ returns false.

    │ │ │ │

    Since: 5.2.6

    │ │ │ │

    See also: al_init_primitives_addon, │ │ │ │ al_shutdown_primitives_addon

    │ │ │ │

    al_shutdown_primitives_addon

    │ │ │ │ -
    void al_shutdown_primitives_addon(void)
    │ │ │ │ +
    void al_shutdown_primitives_addon(void)
│ │ │ │ +void al_shutdown_primitives_addon(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Shut down the primitives addon. This is done automatically at program │ │ │ │ exit, but can be called any time the user wishes as well.

    │ │ │ │

    See also: al_init_primitives_addon

    │ │ │ │ @@ -469,15 +473,17 @@ │ │ │ │ completely covered by a shape or completely not covered, then the shape │ │ │ │ edges will be sharp. The offsets used in the second diagram were chosen │ │ │ │ so that this is the case: if you use those offsets, your shapes (if they │ │ │ │ are oriented the same way as they are on the diagram) should look the │ │ │ │ same whether multisampling is turned on or off.

    │ │ │ │

    al_draw_line

    │ │ │ │ 
    void al_draw_line(float x1, float y1, float x2, float y2,
│ │ │ │ -   ALLEGRO_COLOR color, float thickness)
    │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ +void al_draw_line(float x1, float y1, float x2, float y2, │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Draws a line segment between two points.

    │ │ │ │

    Parameters:

    │ │ │ │
      │ │ │ │
    • x1, y1, x2, y2 - Start and end points of the line
      • │ │ │ │ @@ -494,15 +500,17 @@ │ │ │ │
    • ex_resize.c
      • │ │ │ │
    • ex_mouse_warp.c
      • │ │ │ │
    │ │ │ │

    al_draw_triangle

    │ │ │ │ 
    void al_draw_triangle(float x1, float y1, float x2, float y2,
│ │ │ │ -   float x3, float y3, ALLEGRO_COLOR color, float thickness)
    │ │ │ │ + float x3, float y3, ALLEGRO_COLOR color, float thickness) │ │ │ │ +void al_draw_triangle(float x1, float y1, float x2, float y2, │ │ │ │ + float x3, float y3, ALLEGRO_COLOR color, float thickness) │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Draws an outlined triangle.

    │ │ │ │

    Parameters:

    │ │ │ │
      │ │ │ │
    • x1, y1, x2, y2, x3, y3 - Three points of the triangle
      • │ │ │ │ @@ -517,15 +525,17 @@ │ │ │ │

      Examples:

      │ │ │ │ │ │ │ │

      al_draw_filled_triangle

      │ │ │ │ 
      void al_draw_filled_triangle(float x1, float y1, float x2, float y2,
│ │ │ │ -   float x3, float y3, ALLEGRO_COLOR color)
      │ │ │ │ + float x3, float y3, ALLEGRO_COLOR color) │ │ │ │ +void al_draw_filled_triangle(float x1, float y1, float x2, float y2, │ │ │ │ + float x3, float y3, ALLEGRO_COLOR color) │ │ │ │

      Source │ │ │ │ Code

      │ │ │ │

      Draws a filled triangle.

      │ │ │ │

      Parameters:

      │ │ │ │
        │ │ │ │
      • x1, y1, x2, y2, x3, y3 - Three points of the triangle
        • │ │ │ │ @@ -536,15 +546,17 @@ │ │ │ │

        Examples:

        │ │ │ │ │ │ │ │

        al_draw_rectangle

        │ │ │ │ 
        void al_draw_rectangle(float x1, float y1, float x2, float y2,
│ │ │ │ -   ALLEGRO_COLOR color, float thickness)
        │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ +void al_draw_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Draws an outlined rectangle.

        │ │ │ │

        Parameters:

        │ │ │ │
          │ │ │ │
        • x1, y1, x2, y2 - Upper left and lower right points of the │ │ │ │ @@ -564,15 +576,17 @@ │ │ │ │
        • ex_font_justify.cpp
          • │ │ │ │
        • ex_subbitmap.c
          • │ │ │ │
        │ │ │ │

        al_draw_filled_rectangle

        │ │ │ │ 
        void al_draw_filled_rectangle(float x1, float y1, float x2, float y2,
│ │ │ │ -   ALLEGRO_COLOR color)
        │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │ +void al_draw_filled_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Draws a filled rectangle.

        │ │ │ │

        Parameters:

        │ │ │ │
          │ │ │ │
        • x1, y1, x2, y2 - Upper left and lower right points of the │ │ │ │ @@ -589,15 +603,17 @@ │ │ │ │
        • ex_timer.c
          • │ │ │ │
        • ex_window_maximized.c
          • │ │ │ │
        │ │ │ │

        al_draw_rounded_rectangle

        │ │ │ │ 
        void al_draw_rounded_rectangle(float x1, float y1, float x2, float y2,
│ │ │ │ -   float rx, float ry, ALLEGRO_COLOR color, float thickness)
        │ │ │ │ + float rx, float ry, ALLEGRO_COLOR color, float thickness) │ │ │ │ +void al_draw_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ + float rx, float ry, ALLEGRO_COLOR color, float thickness) │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Draws an outlined rounded rectangle.

        │ │ │ │

        Parameters:

        │ │ │ │
          │ │ │ │
        • x1, y1, x2, y2 - Upper left and lower right points of the │ │ │ │ @@ -618,15 +634,17 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim.c#L323">ex_prim.c
          • │ │ │ │
        • ex_audio_chain.cpp
          • │ │ │ │
        │ │ │ │

        al_draw_filled_rounded_rectangle

        │ │ │ │ 
        void al_draw_filled_rounded_rectangle(float x1, float y1, float x2, float y2,
│ │ │ │ -   float rx, float ry, ALLEGRO_COLOR color)
        │ │ │ │ + float rx, float ry, ALLEGRO_COLOR color) │ │ │ │ +void al_draw_filled_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ + float rx, float ry, ALLEGRO_COLOR color) │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Draws an filled rounded rectangle.

        │ │ │ │

        Parameters:

        │ │ │ │
          │ │ │ │
        • x1, y1, x2, y2 - Upper left and lower right points of the │ │ │ │ @@ -645,16 +663,18 @@ │ │ │ │
        • ex_video.c
          • │ │ │ │
        • ex_prim.c
          • │ │ │ │
        │ │ │ │

        al_calculate_arc

        │ │ │ │ 
        void al_calculate_arc(float* dest, int stride, float cx, float cy,
│ │ │ │ -   float rx, float ry, float start_theta, float delta_theta, float thickness,
│ │ │ │ -   int num_points)
        │ │ │ │ + int num_points) │ │ │ │ +void al_calculate_arc(float* dest, int stride, float cx, float cy, │ │ │ │ + float rx, float ry, float start_theta, float delta_theta, float thickness, │ │ │ │ + int num_points) │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        When thickness <= 0 this function computes positions │ │ │ │ of num_points regularly spaced points on an elliptical arc. │ │ │ │ When thickness > 0 this function computes two sets of │ │ │ │ points, obtained as follows: the first set is obtained by taking the │ │ │ │ @@ -718,15 +738,17 @@ │ │ │ │

        Examples:

        │ │ │ │ │ │ │ │

        al_draw_pieslice

        │ │ │ │ 
        void al_draw_pieslice(float cx, float cy, float r, float start_theta,
│ │ │ │ -   float delta_theta, ALLEGRO_COLOR color, float thickness)
        │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ +void al_draw_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Draws a pieslice (outlined circular sector).

        │ │ │ │

        Parameters:

        │ │ │ │
          │ │ │ │
        • cx, cy - Center of the pieslice
          • │ │ │ │ @@ -745,15 +767,17 @@ │ │ │ │

          Examples:

          │ │ │ │ │ │ │ │

          al_draw_filled_pieslice

          │ │ │ │ 
          void al_draw_filled_pieslice(float cx, float cy, float r, float start_theta,
│ │ │ │ -   float delta_theta, ALLEGRO_COLOR color)
          │ │ │ │ + float delta_theta, ALLEGRO_COLOR color) │ │ │ │ +void al_draw_filled_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ + float delta_theta, ALLEGRO_COLOR color) │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Draws a filled pieslice (filled circular sector).

          │ │ │ │

          Parameters:

          │ │ │ │
            │ │ │ │
          • cx, cy - Center of the pieslice
            • │ │ │ │ @@ -770,15 +794,17 @@ │ │ │ │

            Examples:

            │ │ │ │ │ │ │ │

            al_draw_ellipse

            │ │ │ │ 
            void al_draw_ellipse(float cx, float cy, float rx, float ry,
│ │ │ │ -   ALLEGRO_COLOR color, float thickness)
            │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ +void al_draw_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Draws an outlined ellipse.

            │ │ │ │

            Parameters:

            │ │ │ │
              │ │ │ │
            • cx, cy - Center of the ellipse
              • │ │ │ │ @@ -795,15 +821,17 @@ │ │ │ │
            • ex_draw.c
              • │ │ │ │
            • ex_prim.c
              • │ │ │ │
            │ │ │ │

            al_draw_filled_ellipse

            │ │ │ │ 
            void al_draw_filled_ellipse(float cx, float cy, float rx, float ry,
│ │ │ │ -   ALLEGRO_COLOR color)
            │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │ +void al_draw_filled_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Draws a filled ellipse.

            │ │ │ │

            Parameters:

            │ │ │ │
              │ │ │ │
            • cx, cy - Center of the ellipse
              • │ │ │ │ @@ -818,15 +846,17 @@ │ │ │ │
            • ex_draw.c
              • │ │ │ │
            • ex_prim.c
              • │ │ │ │
            │ │ │ │

            al_draw_circle

            │ │ │ │ 
            void al_draw_circle(float cx, float cy, float r, ALLEGRO_COLOR color,
│ │ │ │ -   float thickness)
            │ │ │ │ + float thickness) │ │ │ │ +void al_draw_circle(float cx, float cy, float r, ALLEGRO_COLOR color, │ │ │ │ + float thickness) │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Draws an outlined circle.

            │ │ │ │

            Parameters:

            │ │ │ │
              │ │ │ │
            • cx, cy - Center of the circle
              • │ │ │ │ @@ -842,15 +872,16 @@ │ │ │ │ │ │ │ │

              al_draw_filled_circle

              │ │ │ │ -
              void al_draw_filled_circle(float cx, float cy, float r, ALLEGRO_COLOR color)
              │ │ │ │ +
              void al_draw_filled_circle(float cx, float cy, float r, ALLEGRO_COLOR color)
│ │ │ │ +void al_draw_filled_circle(float cx, float cy, float r, ALLEGRO_COLOR color)
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              Draws a filled circle.

              │ │ │ │

              Parameters:

              │ │ │ │ │ │ │ │

              al_draw_arc

              │ │ │ │ 
              void al_draw_arc(float cx, float cy, float r, float start_theta,
│ │ │ │ -   float delta_theta, ALLEGRO_COLOR color, float thickness)
              │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ +void al_draw_arc(float cx, float cy, float r, float start_theta, │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              Draws an arc.

              │ │ │ │

              Parameters:

              │ │ │ │
                │ │ │ │
              • cx, cy - Center of the arc
                • │ │ │ │ @@ -894,15 +927,17 @@ │ │ │ │

                Examples:

                │ │ │ │ │ │ │ │

                al_draw_elliptical_arc

                │ │ │ │ 
                void al_draw_elliptical_arc(float cx, float cy, float rx, float ry, float start_theta,
│ │ │ │ -   float delta_theta, ALLEGRO_COLOR color, float thickness)
                │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ +void al_draw_elliptical_arc(float cx, float cy, float rx, float ry, float start_theta, │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                Draws an elliptical arc.

                │ │ │ │

                Parameters:

                │ │ │ │
                  │ │ │ │
                • cx, cy - Center of the arc
                  • │ │ │ │ @@ -922,15 +957,17 @@ │ │ │ │

                  Examples:

                  │ │ │ │ │ │ │ │

                  al_calculate_spline

                  │ │ │ │ 
                  void al_calculate_spline(float* dest, int stride, const float points[8],
│ │ │ │ -   float thickness, int num_segments)
                  │ │ │ │ + float thickness, int num_segments) │ │ │ │ +void al_calculate_spline(float* dest, int stride, const float points[8], │ │ │ │ + float thickness, int num_segments) │ │ │ │

                  Source │ │ │ │ Code

                  │ │ │ │

                  Calculates a Bézier spline given 4 control points. If │ │ │ │ thickness <= 0, then num_segments of points │ │ │ │ are required in the destination, otherwise twice as many are needed. The │ │ │ │ destination buffer should consist of regularly spaced (by distance of │ │ │ │ @@ -947,15 +984,16 @@ │ │ │ │

                • num_segments - The number of points to calculate
                  • │ │ │ │
                │ │ │ │

                See also: al_draw_spline, al_calculate_arc, al_calculate_ribbon

                │ │ │ │

                al_draw_spline

                │ │ │ │ -
                void al_draw_spline(const float points[8], ALLEGRO_COLOR color, float thickness)
                │ │ │ │ +
                void al_draw_spline(const float points[8], ALLEGRO_COLOR color, float thickness)
│ │ │ │ +void al_draw_spline(const float points[8], ALLEGRO_COLOR color, float thickness)
                │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                Draws a Bézier spline given 4 control points.

                │ │ │ │

                Parameters:

                │ │ │ │
                  │ │ │ │
                • points - An array of 4 pairs of coordinates of the 4 control │ │ │ │ @@ -969,15 +1007,17 @@ │ │ │ │

                  Examples:

                  │ │ │ │ │ │ │ │

                  al_calculate_ribbon

                  │ │ │ │ 
                  void al_calculate_ribbon(float* dest, int dest_stride, const float *points,
│ │ │ │ -   int points_stride, float thickness, int num_segments)
                  │ │ │ │ + int points_stride, float thickness, int num_segments) │ │ │ │ +void al_calculate_ribbon(float* dest, int dest_stride, const float *points, │ │ │ │ + int points_stride, float thickness, int num_segments) │ │ │ │

                  Source │ │ │ │ Code

                  │ │ │ │

                  Calculates a ribbon given an array of points. The ribbon will go │ │ │ │ through all of the passed points. If thickness <= 0, │ │ │ │ then num_segments of points are required in the destination │ │ │ │ buffer, otherwise twice as many are needed. The destination and the │ │ │ │ @@ -996,15 +1036,17 @@ │ │ │ │

                │ │ │ │

                See also: al_draw_ribbon, al_calculate_arc, al_calculate_spline

                │ │ │ │

                al_draw_ribbon

                │ │ │ │ 
                void al_draw_ribbon(const float *points, int points_stride, ALLEGRO_COLOR color,
│ │ │ │ -   float thickness, int num_segments)
                │ │ │ │ + float thickness, int num_segments) │ │ │ │ +void al_draw_ribbon(const float *points, int points_stride, ALLEGRO_COLOR color, │ │ │ │ + float thickness, int num_segments) │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                Draws a ribbon given an array of points. The ribbon will go through │ │ │ │ all of the passed points. The points buffer should consist of regularly │ │ │ │ spaced doublets of floats, corresponding to x and y coordinates of the │ │ │ │ vertices.

                │ │ │ │ @@ -1043,15 +1085,17 @@ │ │ │ │ pass to the al_draw_prim by (0.5, 0.5) if you need precise pixel │ │ │ │ control. E.g. to refer to pixel (5, 10) you’d set the u and v to 5.5 and │ │ │ │ 10.5 respectively.

                │ │ │ │

                See also: Pixel-precise output

                │ │ │ │

                al_draw_prim

                │ │ │ │ 
                int al_draw_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl,
│ │ │ │ -   ALLEGRO_BITMAP* texture, int start, int end, int type)
                │ │ │ │ + ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │ +int al_draw_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ + ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                Draws a subset of the passed vertex array.

                │ │ │ │

                Parameters:

                │ │ │ │
                  │ │ │ │
                • texture - Texture to use, pass NULL to use only color shaded │ │ │ │ @@ -1088,15 +1132,17 @@ │ │ │ │
                • ex_vertex_buffer.c
                  • │ │ │ │
                • ex_prim_wrap.c
                  • │ │ │ │
                │ │ │ │

                al_draw_indexed_prim

                │ │ │ │ 
                int al_draw_indexed_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl,
│ │ │ │ -   ALLEGRO_BITMAP* texture, const int* indices, int num_vtx, int type)
                │ │ │ │ + ALLEGRO_BITMAP* texture, const int* indices, int num_vtx, int type) │ │ │ │ +int al_draw_indexed_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ + ALLEGRO_BITMAP* texture, const int* indices, int num_vtx, int type) │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                Draws a subset of the passed vertex array. This function uses an │ │ │ │ index array to specify which vertices to use.

                │ │ │ │

                Parameters:

                │ │ │ │ │ │ │ │

                al_draw_vertex_buffer

                │ │ │ │ 
                int al_draw_vertex_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer,
│ │ │ │ -   ALLEGRO_BITMAP* texture, int start, int end, int type)
                │ │ │ │ + ALLEGRO_BITMAP* texture, int sta) │ │ │ │ +int al_draw_vertex_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ + ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                Draws a subset of the passed vertex buffer. The vertex buffer must │ │ │ │ not be locked. Additionally, to draw onto memory bitmaps or with memory │ │ │ │ bitmap textures the vertex buffer must support reading (i.e. it must be │ │ │ │ created with the ALLEGRO_PRIM_BUFFER_READWRITE).

                │ │ │ │ @@ -1158,15 +1206,18 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_vertex_buffer.c#L58">ex_vertex_buffer.c │ │ │ │
              • ex_prim.c
                • │ │ │ │
              │ │ │ │

              al_draw_indexed_buffer

              │ │ │ │ 
              int al_draw_indexed_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer,
│ │ │ │     ALLEGRO_BITMAP* texture, ALLEGRO_INDEX_BUFFER* index_buffer,
│ │ │ │ -   int start, int end, int type)
              │ │ │ │ + int start, int end, int type) │ │ │ │ +int al_draw_indexed_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ + ALLEGRO_BITMAP* texture, ALLEGRO_INDEX_BUFFER* index_buffer, │ │ │ │ + int start, int end, int type) │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              Draws a subset of the passed vertex buffer. This function uses an │ │ │ │ index buffer to specify which vertices to use. Both buffers must not be │ │ │ │ locked. Additionally, to draw onto memory bitmaps or with memory bitmap │ │ │ │ textures both buffers must support reading (i.e. they must be created │ │ │ │ @@ -1199,15 +1250,21 @@ │ │ │ │

            │ │ │ │

            al_draw_soft_triangle

            │ │ │ │ 
            void al_draw_soft_triangle(
│ │ │ │     ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, ALLEGRO_VERTEX* v3, uintptr_t state,
│ │ │ │     void (*init)(uintptr_t, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*),
│ │ │ │     void (*first)(uintptr_t, int, int, int, int),
│ │ │ │     void (*step)(uintptr_t, int),
│ │ │ │ -   void (*draw)(uintptr_t, int, int, int))
            │ │ │ │ + void (*draw)(uintptr_t, int, int, int)) │ │ │ │ +void al_draw_soft_triangle( │ │ │ │ + ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, ALLEGRO_VERTEX* v3, uintptr_t state, │ │ │ │ + void (*init)(uintptr_t, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ + void (*first)(uintptr_t, int, int, int, int), │ │ │ │ + void (*step)(uintptr_t, int), │ │ │ │ + void (*draw)(uintptr_t, int, int, int)) │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Draws a triangle using the software rasterizer and user supplied │ │ │ │ pixel functions. For help in understanding what these functions do, see │ │ │ │ the implementation of the various shading routines in │ │ │ │ addons/primitives/tri_soft.c. The triangle is drawn in two segments, │ │ │ │ @@ -1238,15 +1295,19 @@ │ │ │ │

          │ │ │ │

          See also: al_draw_triangle

          │ │ │ │

          al_draw_soft_line

          │ │ │ │ 
          void al_draw_soft_line(ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, uintptr_t state,
│ │ │ │     void (*first)(uintptr_t, int, int, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*),
│ │ │ │     void (*step)(uintptr_t, int),
│ │ │ │ -   void (*draw)(uintptr_t, int, int))
          │ │ │ │ + void (*draw)(uintptr_t, int, int)) │ │ │ │ +void al_draw_soft_line(ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, uintptr_t state, │ │ │ │ + void (*first)(uintptr_t, int, int, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ + void (*step)(uintptr_t, int), │ │ │ │ + void (*draw)(uintptr_t, int, int)) │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Draws a line using the software rasterizer and user supplied pixel │ │ │ │ functions. For help in understanding what these functions do, see the │ │ │ │ implementation of the various shading routines in │ │ │ │ addons/primitives/line_soft.c. The line is drawn top to bottom.

          │ │ │ │ @@ -1266,15 +1327,16 @@ │ │ │ │
        • draw - Called once per pixel. The function is expected to draw the │ │ │ │ pixel at the coordinates passed to it.
          • │ │ │ │
        │ │ │ │

        See also: al_draw_line

        │ │ │ │

        Custom vertex declaration │ │ │ │ routines

        │ │ │ │

        al_create_vertex_decl

        │ │ │ │ -
        ALLEGRO_VERTEX_DECL* al_create_vertex_decl(const ALLEGRO_VERTEX_ELEMENT* elements, int stride)
        │ │ │ │ +
        ALLEGRO_VERTEX_DECL* al_create_vertex_decl(const ALLEGRO_VERTEX_ELEMENT* elements, int stride)
│ │ │ │ +ALLEGRO_VERTEX_DECL* al_create_vertex_decl(const ALLEGRO_VERTEX_ELEMENT* elements, int stride)
        │ │ │ │

        Source │ │ │ │ Code

        │ │ │ │

        Creates a vertex declaration, which describes a custom vertex │ │ │ │ format.

        │ │ │ │

        Parameters:

        │ │ │ │
          │ │ │ │ @@ -1293,15 +1355,16 @@ │ │ │ │ │ │ │ │

          al_destroy_vertex_decl

          │ │ │ │ -
          void al_destroy_vertex_decl(ALLEGRO_VERTEX_DECL* decl)
          │ │ │ │ +
          void al_destroy_vertex_decl(ALLEGRO_VERTEX_DECL* decl)
│ │ │ │ +void al_destroy_vertex_decl(ALLEGRO_VERTEX_DECL* decl)
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Destroys a vertex declaration.

          │ │ │ │

          Parameters:

          │ │ │ │
            │ │ │ │
          • decl - Vertex declaration to destroy
            • │ │ │ │ @@ -1315,15 +1378,17 @@ │ │ │ │ │ │ │ │

            Vertex buffer routines

            │ │ │ │

            al_create_vertex_buffer

            │ │ │ │ 
            ALLEGRO_VERTEX_BUFFER* al_create_vertex_buffer(ALLEGRO_VERTEX_DECL* decl,
│ │ │ │ -   const void* initial_data, int num_vertices, int flags)
            │ │ │ │ + const void* initial_data, int num_vertices, int flags) │ │ │ │ +ALLEGRO_VERTEX_BUFFER* al_create_vertex_buffer(ALLEGRO_VERTEX_DECL* decl, │ │ │ │ + const void* initial_data, int num_vertices, int flags) │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Creates a vertex buffer. Can return NULL if the buffer could not be │ │ │ │ created (e.g. the system only supports write-only buffers).

            │ │ │ │
            │ │ │ │

            Note:

            │ │ │ │ @@ -1355,15 +1420,16 @@ │ │ │ │ │ │ │ │

            al_destroy_vertex_buffer

            │ │ │ │ -
            void al_destroy_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer)
            │ │ │ │ +
            void al_destroy_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer)
│ │ │ │ +void al_destroy_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer)
            │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Destroys a vertex buffer. Does nothing if passed NULL.

            │ │ │ │

            Since: 5.1.3

            │ │ │ │

            See also: ALLEGRO_VERTEX_BUFFER, │ │ │ │ @@ -1374,15 +1440,17 @@ │ │ │ │

          • ex_vertex_buffer.c
            • │ │ │ │
          • ex_prim.c
            • │ │ │ │
          │ │ │ │

          al_lock_vertex_buffer

          │ │ │ │ 
          void* al_lock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer, int offset,
│ │ │ │ -   int length, int flags)
          │ │ │ │ + int length, int flags) │ │ │ │ +void* al_lock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer, int offset, │ │ │ │ + int length, int flags) │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Locks a vertex buffer so you can access its data. Will return NULL if │ │ │ │ the parameters are invalid, if reading is requested from a write only │ │ │ │ buffer, or if the buffer is already locked.

          │ │ │ │

          Parameters:

          │ │ │ │ @@ -1402,15 +1470,16 @@ │ │ │ │ │ │ │ │

          al_unlock_vertex_buffer

          │ │ │ │ -
          void al_unlock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer)
          │ │ │ │ +
          void al_unlock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer)
│ │ │ │ +void al_unlock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer)
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Unlocks a previously locked vertex buffer.

          │ │ │ │

          Since: 5.1.3

          │ │ │ │

          See also: ALLEGRO_VERTEX_BUFFER, │ │ │ │ @@ -1420,26 +1489,29 @@ │ │ │ │

          │ │ │ │

          al_get_vertex_buffer_size

          │ │ │ │ -
          int al_get_vertex_buffer_size(ALLEGRO_VERTEX_BUFFER* buffer)
          │ │ │ │ +
          int al_get_vertex_buffer_size(ALLEGRO_VERTEX_BUFFER* buffer)
│ │ │ │ +int al_get_vertex_buffer_size(ALLEGRO_VERTEX_BUFFER* buffer)
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Returns the size of the vertex buffer

          │ │ │ │

          Since: 5.1.8

          │ │ │ │

          See also: ALLEGRO_VERTEX_BUFFER

          │ │ │ │

          Index buffer routines

          │ │ │ │

          al_create_index_buffer

          │ │ │ │ 
          ALLEGRO_INDEX_BUFFER* al_create_index_buffer(int index_size,
│ │ │ │ -    const void* initial_data, int num_indices, int flags)
          │ │ │ │ + const void* initial_data, int num_indices, int flags) │ │ │ │ +ALLEGRO_INDEX_BUFFER* al_create_index_buffer(int index_size, │ │ │ │ + const void* initial_data, int num_indices, int flags) │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Creates a index buffer. Can return NULL if the buffer could not be │ │ │ │ created (e.g. the system only supports write-only buffers).

          │ │ │ │
          │ │ │ │

          Note:

          │ │ │ │ @@ -1467,15 +1539,16 @@ │ │ │ │ href="primitives.html#al_destroy_index_buffer">al_destroy_index_buffer

          │ │ │ │

          Examples:

          │ │ │ │ │ │ │ │

          al_destroy_index_buffer

          │ │ │ │ -
          void al_destroy_index_buffer(ALLEGRO_INDEX_BUFFER* buffer)
          │ │ │ │ +
          void al_destroy_index_buffer(ALLEGRO_INDEX_BUFFER* buffer)
│ │ │ │ +void al_destroy_index_buffer(ALLEGRO_INDEX_BUFFER* buffer)
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Destroys a index buffer. Does nothing if passed NULL.

          │ │ │ │

          Since: 5.1.8

          │ │ │ │

          See also: ALLEGRO_INDEX_BUFFER, Examples:

          │ │ │ │ │ │ │ │

          al_lock_index_buffer

          │ │ │ │ 
          void* al_lock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer, int offset,
│ │ │ │ -    int length, int flags)
          │ │ │ │ + int length, int flags) │ │ │ │ +void* al_lock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer, int offset, │ │ │ │ + int length, int flags) │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Locks a index buffer so you can access its data. Will return NULL if │ │ │ │ the parameters are invalid, if reading is requested from a write only │ │ │ │ buffer and if the buffer is already locked.

          │ │ │ │

          Parameters:

          │ │ │ │ @@ -1508,42 +1583,47 @@ │ │ │ │ href="primitives.html#al_unlock_index_buffer">al_unlock_index_buffer

          │ │ │ │

          Examples:

          │ │ │ │ │ │ │ │

          al_unlock_index_buffer

          │ │ │ │ -
          void al_unlock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer)
          │ │ │ │ +
          void al_unlock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer)
│ │ │ │ +void al_unlock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer)
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Unlocks a previously locked index buffer.

          │ │ │ │

          Since: 5.1.8

          │ │ │ │

          See also: ALLEGRO_INDEX_BUFFER, al_lock_index_buffer

          │ │ │ │

          Examples:

          │ │ │ │ │ │ │ │

          al_get_index_buffer_size

          │ │ │ │ -
          int al_get_index_buffer_size(ALLEGRO_INDEX_BUFFER* buffer)
          │ │ │ │ +
          int al_get_index_buffer_size(ALLEGRO_INDEX_BUFFER* buffer)
│ │ │ │ +int al_get_index_buffer_size(ALLEGRO_INDEX_BUFFER* buffer)
          │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Returns the size of the index buffer

          │ │ │ │

          Since: 5.1.8

          │ │ │ │

          See also: ALLEGRO_INDEX_BUFFER

          │ │ │ │

          Polygon routines

          │ │ │ │

          al_draw_polyline

          │ │ │ │ 
          void al_draw_polyline(const float* vertices, int vertex_stride,
│ │ │ │     int vertex_count, int join_style, int cap_style,
│ │ │ │ -   ALLEGRO_COLOR color, float thickness, float miter_limit)
          │ │ │ │ + ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ +void al_draw_polyline(const float* vertices, int vertex_stride, │ │ │ │ + int vertex_count, int join_style, int cap_style, │ │ │ │ + ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │

          Source │ │ │ │ Code

          │ │ │ │

          Draw a series of line segments.

          │ │ │ │
            │ │ │ │
          • vertices - Interleaved array of (x, y) vertex coordinates
            • │ │ │ │
          • vertex_stride - the number of bytes between pairs of vertices (the │ │ │ │ @@ -1584,15 +1664,17 @@ │ │ │ │

            Examples:

            │ │ │ │ │ │ │ │

            al_draw_polygon

            │ │ │ │ 
            void al_draw_polygon(const float *vertices, int vertex_count,
│ │ │ │ -   int join_style, ALLEGRO_COLOR color, float thickness, float miter_limit)
            │ │ │ │ + int join_style, ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ +void al_draw_polygon(const float *vertices, int vertex_count, │ │ │ │ + int join_style, ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Draw an unfilled polygon. This is the same as passing │ │ │ │ ALLEGRO_LINE_CAP_CLOSED to al_draw_polyline.

            │ │ │ │
              │ │ │ │ @@ -1613,18 +1695,20 @@ │ │ │ │ href="primitives.html#allegro_line_join">ALLEGRO_LINE_JOIN

              │ │ │ │

              Examples:

              │ │ │ │ │ │ │ │

              al_draw_filled_polygon

              │ │ │ │ -
              void al_draw_filled_polygon(const float *vertices, int vertex_count,
│ │ │ │ -   ALLEGRO_COLOR color)
              │ │ │ │ +
              void al_draw_filled_polygon(const float *vertices, int vertex_cou
│ │ │ │ +   ALLEGRO_COLOR color)
│ │ │ │ +void al_draw_filled_polygon(const float *vertices, int vertex_court, int end, int type)
│ │ │ │ +   ALLEGRO_COLOR color)
              │ │ │ │

              Source │ │ │ │ +href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L56">Source │ │ │ │ Code

              │ │ │ │

              Draw a filled, simple polygon. Simple means it does not have to be │ │ │ │ convex but must not be self-overlapping.

              │ │ │ │
                │ │ │ │
              • vertices - Interleaved array of (x, y) vertex coordinates
                • │ │ │ │
              • vertex_count - Number of vertices in the array
                • │ │ │ │
              • color - Color of the filled polygon
                • │ │ │ │ @@ -1639,15 +1723,17 @@ │ │ │ │ │ │ │ │

                al_draw_filled_polygon_with_holes

                │ │ │ │ 
                void al_draw_filled_polygon_with_holes(const float *vertices,
│ │ │ │ -   const int *vertex_counts, ALLEGRO_COLOR color)
                │ │ │ │ + const int *vertex_counts, ALLEGRO_COLOR color) │ │ │ │ +void al_draw_filled_polygon_with_holes(const float *vertices, │ │ │ │ + const int *vertex_counts, ALLEGRO_COLOR color) │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                Draws a filled simple polygon with zero or more other simple polygons │ │ │ │ subtracted from it - the holes. The holes cannot touch or intersect with │ │ │ │ the outline of the filled polygon.

                │ │ │ │
                  │ │ │ │ @@ -1694,15 +1780,18 @@ │ │ │ │ │ │ │ │

                  al_triangulate_polygon

                  │ │ │ │ 
                  bool al_triangulate_polygon(
│ │ │ │     const float* vertices, size_t vertex_stride, const int* vertex_counts,
│ │ │ │ -   void (*emit_triangle)(int, int, int, void*), void* userdata)
                  │ │ │ │ + void (*emit_triangle)(int, int, int, void*), void* userdata) │ │ │ │ +bool al_triangulate_polygon( │ │ │ │ + const float* vertices, size_t vertex_stride, const int* vertex_counts, │ │ │ │ + void (*emit_triangle)(int, int, int, void*), void* userdata) │ │ │ │

                  Source │ │ │ │ Code

                  │ │ │ │

                  Divides a simple polygon into triangles, with zero or more other │ │ │ │ simple polygons subtracted from it - the holes. The holes cannot touch │ │ │ │ or intersect with the outline of the main polygon. Simple means the │ │ │ │ polygon does not have to be convex but must not be self-overlapping.

                  │ │ │ │ @@ -1722,15 +1811,16 @@ │ │ │ │
                • userdata - arbitrary data to be passed to emit_triangle.
                  • │ │ │ │
                │ │ │ │

                Since: 5.1.0

                │ │ │ │

                See also: al_draw_filled_polygon_with_holes

                │ │ │ │

                Structures and types

                │ │ │ │

                ALLEGRO_VERTEX

                │ │ │ │ -
                typedef struct ALLEGRO_VERTEX ALLEGRO_VERTEX;
                │ │ │ │ +
                typedef struct ALLEGRO_VERTEX ALLEGRO_VERTEX;
│ │ │ │ +typedef struct ALLEGRO_VERTEX ALLEGRO_VERTEX;
                │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                Defines the generic vertex type, with a 3D position, color and │ │ │ │ texture coordinates for a single texture. Note that at this time, the │ │ │ │ software driver for this addon cannot render 3D primitives. If you want │ │ │ │ a 2D only primitive, set z to 0. Note that you must initialize all │ │ │ │ @@ -1749,18 +1839,19 @@ │ │ │ │

                Examples:

                │ │ │ │
                  │ │ │ │
                • ex_shader.cpp
                  • │ │ │ │
                • ex_shader_target.c
                  • │ │ │ │
                • ex_prim_shader.c
                  • │ │ │ │ +href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_multitex.c#L72">ex_shader_multitex.c │ │ │ │
                │ │ │ │

                ALLEGRO_VERTEX_DECL

                │ │ │ │ -
                typedef struct ALLEGRO_VERTEX_DECL ALLEGRO_VERTEX_DECL;
                │ │ │ │ +
                typedef struct ALLEGRO_VERTEX_DECL ALLEGRO_VERTEX_DECL;
│ │ │ │ +typedef struct ALLEGRO_VERTEX_DECL ALLEGRO_VERTEX_DECL;
                │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                A vertex declaration. This opaque structure is responsible for │ │ │ │ describing the format and layout of a user defined custom vertex. It is │ │ │ │ created and destroyed by specialized functions.

                │ │ │ │

                See also: │ │ │ │

              • ex_prim_shader.c
                • │ │ │ │
              • ex_prim.c
                • │ │ │ │
              │ │ │ │

              ALLEGRO_VERTEX_ELEMENT

              │ │ │ │ -
              typedef struct ALLEGRO_VERTEX_ELEMENT ALLEGRO_VERTEX_ELEMENT;
              │ │ │ │ +
              typedef struct ALLEGRO_VERTEX_ELEMENT ALLEGRO_VERTEX_ELEMENT;
│ │ │ │ +typedef struct ALLEGRO_VERTEX_ELEMENT ALLEGRO_VERTEX_ELEMENT;
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              A small structure describing a certain element of a vertex. E.g. the │ │ │ │ position of the vertex, or its color. These structures are used by the │ │ │ │ al_create_vertex_decl │ │ │ │ @@ -1822,15 +1914,16 @@ │ │ │ │

              │ │ │ │

              ALLEGRO_PRIM_TYPE

              │ │ │ │ -
              typedef enum ALLEGRO_PRIM_TYPE
              │ │ │ │ +
              typedef enum ALLEGRO_PRIM_TYPE
│ │ │ │ +typedef enum ALLEGRO_PRIM_TYPE
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              Enumerates the types of primitives this addon can draw.

              │ │ │ │
                │ │ │ │

              • ALLEGRO_PRIM_POINT_LIST - A list of points, each vertex defines a │ │ │ │ point

                • │ │ │ │ @@ -1844,15 +1937,16 @@ │ │ │ │ triplets of vertices define disjointed triangles

                │ │ │ │

              • ALLEGRO_PRIM_TRIANGLE_STRIP - A strip of triangles, sequential │ │ │ │ vertices define a strip of triangles

                • │ │ │ │

              • ALLEGRO_PRIM_TRIANGLE_FAN - A fan of triangles, all triangles │ │ │ │ share the first vertex

                • │ │ │ │
              │ │ │ │

              ALLEGRO_PRIM_ATTR

              │ │ │ │ -
              typedef enum ALLEGRO_PRIM_ATTR
              │ │ │ │ +
              typedef enum ALLEGRO_PRIM_ATTR
│ │ │ │ +typedef enum ALLEGRO_PRIM_ATTR
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              Enumerates the types of vertex attributes that a custom vertex may │ │ │ │ have.

              │ │ │ │
                │ │ │ │

              • ALLEGRO_PRIM_POSITION - Position information, can be stored only │ │ │ │ @@ -1901,15 +1995,16 @@ │ │ │ │

                Since: 5.1.6

                • │ │ │ │
              │ │ │ │

              See also: ALLEGRO_VERTEX_DECL, ALLEGRO_PRIM_STORAGE, al_attach_shader_source

              │ │ │ │

              ALLEGRO_PRIM_STORAGE

              │ │ │ │ -
              typedef enum ALLEGRO_PRIM_STORAGE
              │ │ │ │ +
              typedef enum ALLEGRO_PRIM_STORAGE
│ │ │ │ +typedef enum ALLEGRO_PRIM_STORAGE
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              Enumerates the types of storage an attribute of a custom vertex may │ │ │ │ be stored in. Many of these can only be used for ALLEGRO_PRIM_USER_ATTR │ │ │ │ attributes and can only be accessed via shaders. Usually no matter what │ │ │ │ the storage is specified the attribute gets converted to single │ │ │ │ @@ -1962,35 +2057,38 @@ │ │ │ │ href="primitives.html#al_create_vertex_decl">al_create_vertex_decl │ │ │ │ will return NULL if you use it on those platforms.

              │ │ │ │

              Since: 5.1.6

              │ │ │ │
            │ │ │ │

            See also: ALLEGRO_PRIM_ATTR

            │ │ │ │

            ALLEGRO_VERTEX_CACHE_SIZE

            │ │ │ │ -
            #define ALLEGRO_VERTEX_CACHE_SIZE 256
            │ │ │ │ +
            #define ALLEGRO_VERTEX_CACHE_SIZE 256
│ │ │ │ +#define ALLEGRO_VERTEX_CACHE_SIZE 256
            │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Defines the size of the transformation vertex cache for the software │ │ │ │ renderer. If you pass less than this many vertices to the primitive │ │ │ │ rendering functions you will get a speed boost. This also defines the │ │ │ │ size of the cache vertex buffer, used for the high-level primitives. │ │ │ │ This corresponds to the maximum number of line segments that will be │ │ │ │ used to form them.

            │ │ │ │

            ALLEGRO_PRIM_QUALITY

            │ │ │ │ -
            #define ALLEGRO_PRIM_QUALITY 10
            │ │ │ │ +
            #define ALLEGRO_PRIM_QUALITY 10
│ │ │ │ +#define ALLEGRO_PRIM_QUALITY 10
            │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │

            Controls the quality of the approximation of curved primitives │ │ │ │ (e.g. circles). Curved primitives are drawn by approximating them with a │ │ │ │ sequence of line segments. By default, this roughly corresponds to error │ │ │ │ of less than half of a pixel.

            │ │ │ │

            ALLEGRO_LINE_JOIN

            │ │ │ │ -
            typedef enum ALLEGRO_LINE_JOIN
            │ │ │ │ +
            typedef enum ALLEGRO_LINE_JOIN
│ │ │ │ +typedef enum ALLEGRO_LINE_JOIN
            │ │ │ │

            Source │ │ │ │ Code

            │ │ │ │
              │ │ │ │
            • ALLEGRO_LINE_JOIN_NONE
              • │ │ │ │
            • ALLEGRO_LINE_JOIN_BEVEL
              • │ │ │ │
            • ALLEGRO_LINE_JOIN_ROUND
              • │ │ │ │ @@ -2009,15 +2107,16 @@ │ │ │ │ href="primitives.html#al_draw_polygon">al_draw_polygon

              │ │ │ │

              Examples:

              │ │ │ │ │ │ │ │

              ALLEGRO_LINE_CAP

              │ │ │ │ -
              typedef enum ALLEGRO_LINE_CAP
              │ │ │ │ +
              typedef enum ALLEGRO_LINE_CAP
│ │ │ │ +typedef enum ALLEGRO_LINE_CAP
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │
                │ │ │ │
              • ALLEGRO_LINE_CAP_NONE
                • │ │ │ │
              • ALLEGRO_LINE_CAP_SQUARE
                • │ │ │ │
              • ALLEGRO_LINE_CAP_ROUND
                • │ │ │ │ @@ -2039,15 +2138,16 @@ │ │ │ │ href="primitives.html#al_draw_polygon">al_draw_polygon

                │ │ │ │

                Examples:

                │ │ │ │ │ │ │ │

                ALLEGRO_VERTEX_BUFFER

                │ │ │ │ -
                typedef struct ALLEGRO_VERTEX_BUFFER ALLEGRO_VERTEX_BUFFER;
                │ │ │ │ +
                typedef struct ALLEGRO_VERTEX_BUFFER ALLEGRO_VERTEX_BUFFER;
│ │ │ │ +typedef struct ALLEGRO_VERTEX_BUFFER ALLEGRO_VERTEX_BUFFER;
                │ │ │ │

                Source │ │ │ │ Code

                │ │ │ │

                A GPU vertex buffer that you can use to store vertices on the GPU │ │ │ │ instead of uploading them afresh during every drawing operation.

                │ │ │ │

                Since: 5.1.3

                │ │ │ │

                See also: │ │ │ │

              • ex_vertex_buffer.c
                • │ │ │ │
              • ex_prim.c
                • │ │ │ │
              │ │ │ │

              ALLEGRO_INDEX_BUFFER

              │ │ │ │ -
              typedef struct ALLEGRO_INDEX_BUFFER ALLEGRO_INDEX_BUFFER;
              │ │ │ │ +
              typedef struct ALLEGRO_INDEX_BUFFER ALLEGRO_INDEX_BUFFER;
│ │ │ │ +typedef struct ALLEGRO_INDEX_BUFFER ALLEGRO_INDEX_BUFFER;
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              A GPU index buffer that you can use to store indices of vertices in a │ │ │ │ vertex buffer on the GPU instead of uploading them afresh during every │ │ │ │ drawing operation.

              │ │ │ │

              Since: 5.1.8

              │ │ │ │ @@ -2076,15 +2177,16 @@ │ │ │ │ href="primitives.html#al_destroy_index_buffer">al_destroy_index_buffer

              │ │ │ │

              Examples:

              │ │ │ │ │ │ │ │

              ALLEGRO_PRIM_BUFFER_FLAGS

              │ │ │ │ -
              typedef enum ALLEGRO_PRIM_BUFFER_FLAGS
              │ │ │ │ +
              typedef enum ALLEGRO_PRIM_BUFFER_FLAGS
│ │ │ │ +typedef enum ALLEGRO_PRIM_BUFFER_FLAGS
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              Flags to specify how to create a vertex or an index buffer.

              │ │ │ │
                │ │ │ │

              • ALLEGRO_PRIM_BUFFER_STREAM - Hints to the driver that the buffer │ │ │ │ is written to often, but used only a few times per frame

                • │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -114,35 +114,39 @@ │ │ │ │ │ o _A_L_L_E_G_R_O___P_R_I_M___B_U_F_F_E_R___F_L_A_G_S │ │ │ │ │ These functions are declared in the following header file. Link with │ │ │ │ │ allegro_primitives. │ │ │ │ │ #include │ │ │ │ │ ************ GGeenneerraall ************ │ │ │ │ │ ********** aall__ggeett__aalllleeggrroo__pprriimmiittiivveess__vveerrssiioonn ********** │ │ │ │ │ uint32_t al_get_allegro_primitives_version(void) │ │ │ │ │ +uint32_t al_get_allegro_primitives_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ ********** aall__iinniitt__pprriimmiittiivveess__aaddddoonn ********** │ │ │ │ │ bool al_init_primitives_addon(void) │ │ │ │ │ +bool al_init_primitives_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Initializes the primitives addon. │ │ │ │ │ RReettuurrnnss:: True on success, false on failure. │ │ │ │ │ See also: _a_l___s_h_u_t_d_o_w_n___p_r_i_m_i_t_i_v_e_s___a_d_d_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_o_u_c_h___i_n_p_u_t_._c │ │ │ │ │ * _e_x___b_l_e_n_d___b_e_n_c_h_._c │ │ │ │ │ - * _e_x___e_n_e_t___c_l_i_e_n_t_._c │ │ │ │ │ + * _e_x___m_o_u_s_e_._c │ │ │ │ │ ********** aall__iiss__pprriimmiittiivveess__aaddddoonn__iinniittiiaalliizzeedd ********** │ │ │ │ │ bool al_is_primitives_addon_initialized(void) │ │ │ │ │ +bool al_is_primitives_addon_initialized(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the primitives addon is initialized, otherwise returns false. │ │ │ │ │ Since: 5.2.6 │ │ │ │ │ See also: _a_l___i_n_i_t___p_r_i_m_i_t_i_v_e_s___a_d_d_o_n, _a_l___s_h_u_t_d_o_w_n___p_r_i_m_i_t_i_v_e_s___a_d_d_o_n │ │ │ │ │ ********** aall__sshhuuttddoowwnn__pprriimmiittiivveess__aaddddoonn ********** │ │ │ │ │ void al_shutdown_primitives_addon(void) │ │ │ │ │ +void al_shutdown_primitives_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Shut down the primitives addon. This is done automatically at program exit, but │ │ │ │ │ can be called any time the user wishes as well. │ │ │ │ │ See also: _a_l___i_n_i_t___p_r_i_m_i_t_i_v_e_s___a_d_d_o_n │ │ │ │ │ ************ HHiigghh lleevveell ddrraawwiinngg rroouuttiinneess ************ │ │ │ │ │ High level drawing routines encompass the most common usage of this addon: to │ │ │ │ │ draw geometric primitives, both smooth (variations on the circle theme) and │ │ │ │ │ @@ -222,78 +226,90 @@ │ │ │ │ │ sharp. The offsets used in the second diagram were chosen so that this is the │ │ │ │ │ case: if you use those offsets, your shapes (if they are oriented the same way │ │ │ │ │ as they are on the diagram) should look the same whether multisampling is │ │ │ │ │ turned on or off. │ │ │ │ │ ********** aall__ddrraaww__lliinnee ********** │ │ │ │ │ void al_draw_line(float x1, float y1, float x2, float y2, │ │ │ │ │ ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_line(float x1, float y1, float x2, float y2, │ │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a line segment between two points. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * x1, y1, x2, y2 - Start and end points of the line │ │ │ │ │ * color - Color of the line │ │ │ │ │ * thickness - Thickness of the line, pass <= 0 to draw hairline lines │ │ │ │ │ See also: _a_l___d_r_a_w___s_o_f_t___l_i_n_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___r_e_s_i_z_e_._c │ │ │ │ │ * _e_x___m_o_u_s_e___w_a_r_p_._c │ │ │ │ │ ********** aall__ddrraaww__ttrriiaannggllee ********** │ │ │ │ │ void al_draw_triangle(float x1, float y1, float x2, float y2, │ │ │ │ │ float x3, float y3, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_triangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + float x3, float y3, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws an outlined triangle. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * x1, y1, x2, y2, x3, y3 - Three points of the triangle │ │ │ │ │ * color - Color of the triangle │ │ │ │ │ * thickness - Thickness of the lines, pass <= 0 to draw hairline lines │ │ │ │ │ See also: _a_l___d_r_a_w___f_i_l_l_e_d___t_r_i_a_n_g_l_e, _a_l___d_r_a_w___s_o_f_t___t_r_i_a_n_g_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__ffiilllleedd__ttrriiaannggllee ********** │ │ │ │ │ void al_draw_filled_triangle(float x1, float y1, float x2, float y2, │ │ │ │ │ float x3, float y3, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_triangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + float x3, float y3, ALLEGRO_COLOR color) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a filled triangle. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * x1, y1, x2, y2, x3, y3 - Three points of the triangle │ │ │ │ │ * color - Color of the triangle │ │ │ │ │ See also: _a_l___d_r_a_w___t_r_i_a_n_g_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__rreeccttaannggllee ********** │ │ │ │ │ void al_draw_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws an outlined rectangle. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * x1, y1, x2, y2 - Upper left and lower right points of the rectangle │ │ │ │ │ * color - Color of the rectangle │ │ │ │ │ * thickness - Thickness of the lines, pass <= 0 to draw hairline lines │ │ │ │ │ See also: _a_l___d_r_a_w___f_i_l_l_e_d___r_e_c_t_a_n_g_l_e, _a_l___d_r_a_w___r_o_u_n_d_e_d___r_e_c_t_a_n_g_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_o_u_s_e_._c │ │ │ │ │ * _e_x___f_o_n_t___j_u_s_t_i_f_y_._c_p_p │ │ │ │ │ * _e_x___s_u_b_b_i_t_m_a_p_._c │ │ │ │ │ ********** aall__ddrraaww__ffiilllleedd__rreeccttaannggllee ********** │ │ │ │ │ void al_draw_filled_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a filled rectangle. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * x1, y1, x2, y2 - Upper left and lower right points of the rectangle │ │ │ │ │ * color - Color of the rectangle │ │ │ │ │ See also: _a_l___d_r_a_w___r_e_c_t_a_n_g_l_e, _a_l___d_r_a_w___f_i_l_l_e_d___r_o_u_n_d_e_d___r_e_c_t_a_n_g_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___m_o_u_s_e_._c │ │ │ │ │ * _e_x___t_i_m_e_r_._c │ │ │ │ │ * _e_x___w_i_n_d_o_w___m_a_x_i_m_i_z_e_d_._c │ │ │ │ │ ********** aall__ddrraaww__rroouunnddeedd__rreeccttaannggllee ********** │ │ │ │ │ void al_draw_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ float rx, float ry, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + float rx, float ry, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws an outlined rounded rectangle. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * x1, y1, x2, y2 - Upper left and lower right points of the rectangle │ │ │ │ │ * color - Color of the rectangle │ │ │ │ │ * rx, ry - The radii of the round │ │ │ │ │ * thickness - Thickness of the lines, pass <= 0 to draw hairline lines │ │ │ │ │ @@ -301,27 +317,31 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_h_r_e_a_d_s_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ * _e_x___a_u_d_i_o___c_h_a_i_n_._c_p_p │ │ │ │ │ ********** aall__ddrraaww__ffiilllleedd__rroouunnddeedd__rreeccttaannggllee ********** │ │ │ │ │ void al_draw_filled_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ float rx, float ry, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + float rx, float ry, ALLEGRO_COLOR color) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws an filled rounded rectangle. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * x1, y1, x2, y2 - Upper left and lower right points of the rectangle │ │ │ │ │ * color - Color of the rectangle │ │ │ │ │ * rx, ry - The radii of the round │ │ │ │ │ See also: _a_l___d_r_a_w___r_o_u_n_d_e_d___r_e_c_t_a_n_g_l_e, _a_l___d_r_a_w___f_i_l_l_e_d___r_e_c_t_a_n_g_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_h_r_e_a_d_s_._c │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ccaallccuullaattee__aarrcc ********** │ │ │ │ │ void al_calculate_arc(float* dest, int stride, float cx, float cy, │ │ │ │ │ + int num_points) │ │ │ │ │ +void al_calculate_arc(float* dest, int stride, float cx, float cy, │ │ │ │ │ float rx, float ry, float start_theta, float delta_theta, float thickness, │ │ │ │ │ int num_points) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ When thickness <= 0 this function computes positions of num_points regularly │ │ │ │ │ spaced points on an elliptical arc. When thickness > 0 this function computes │ │ │ │ │ two sets of points, obtained as follows: the first set is obtained by taking │ │ │ │ │ the points computed in the thickness <= 0 case and shifting them by thickness / │ │ │ │ │ @@ -376,14 +396,16 @@ │ │ │ │ │ * num_points - The number of points to calculate │ │ │ │ │ See also: _a_l___d_r_a_w___a_r_c, _a_l___c_a_l_c_u_l_a_t_e___s_p_l_i_n_e, _a_l___c_a_l_c_u_l_a_t_e___r_i_b_b_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c │ │ │ │ │ ********** aall__ddrraaww__ppiieesslliiccee ********** │ │ │ │ │ void al_draw_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ │ float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a pieslice (outlined circular sector). │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * cx, cy - Center of the pieslice │ │ │ │ │ * r - Radius of the pieslice │ │ │ │ │ * color - Color of the pieslice │ │ │ │ │ * start_theta - The initial angle from which the pieslice is drawn in │ │ │ │ │ @@ -394,14 +416,16 @@ │ │ │ │ │ Since: 5.0.6, 5.1.0 │ │ │ │ │ See also: _a_l___d_r_a_w___f_i_l_l_e_d___p_i_e_s_l_i_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__ffiilllleedd__ppiieesslliiccee ********** │ │ │ │ │ void al_draw_filled_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ │ float delta_theta, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ │ + float delta_theta, ALLEGRO_COLOR color) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a filled pieslice (filled circular sector). │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * cx, cy - Center of the pieslice │ │ │ │ │ * r - Radius of the pieslice │ │ │ │ │ * color - Color of the pieslice │ │ │ │ │ * start_theta - The initial angle from which the pieslice is drawn in │ │ │ │ │ @@ -411,14 +435,16 @@ │ │ │ │ │ Since: 5.0.6, 5.1.0 │ │ │ │ │ See also: _a_l___d_r_a_w___p_i_e_s_l_i_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__eelllliippssee ********** │ │ │ │ │ void al_draw_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ │ ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws an outlined ellipse. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * cx, cy - Center of the ellipse │ │ │ │ │ * rx, ry - Radii of the ellipse │ │ │ │ │ * color - Color of the ellipse │ │ │ │ │ * thickness - Thickness of the ellipse, pass <= 0 to draw a hairline │ │ │ │ │ @@ -426,54 +452,61 @@ │ │ │ │ │ See also: _a_l___d_r_a_w___f_i_l_l_e_d___e_l_l_i_p_s_e, _a_l___d_r_a_w___c_i_r_c_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___d_r_a_w_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__ffiilllleedd__eelllliippssee ********** │ │ │ │ │ void al_draw_filled_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ │ ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a filled ellipse. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * cx, cy - Center of the ellipse │ │ │ │ │ * rx, ry - Radii of the ellipse │ │ │ │ │ * color - Color of the ellipse │ │ │ │ │ See also: _a_l___d_r_a_w___e_l_l_i_p_s_e, _a_l___d_r_a_w___f_i_l_l_e_d___c_i_r_c_l_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___d_r_a_w_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__cciirrccllee ********** │ │ │ │ │ void al_draw_circle(float cx, float cy, float r, ALLEGRO_COLOR color, │ │ │ │ │ float thickness) │ │ │ │ │ +void al_draw_circle(float cx, float cy, float r, ALLEGRO_COLOR color, │ │ │ │ │ + float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws an outlined circle. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * cx, cy - Center of the circle │ │ │ │ │ * r - Radius of the circle │ │ │ │ │ * color - Color of the circle │ │ │ │ │ * thickness - Thickness of the circle, pass <= 0 to draw a hairline circle │ │ │ │ │ See also: _a_l___d_r_a_w___f_i_l_l_e_d___c_i_r_c_l_e, _a_l___d_r_a_w___e_l_l_i_p_s_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___t_o_u_c_h___i_n_p_u_t_._c │ │ │ │ │ * _e_x___t_r_a_n_s_f_o_r_m_._c │ │ │ │ │ ********** aall__ddrraaww__ffiilllleedd__cciirrccllee ********** │ │ │ │ │ void al_draw_filled_circle(float cx, float cy, float r, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_circle(float cx, float cy, float r, ALLEGRO_COLOR color) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a filled circle. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * cx, cy - Center of the circle │ │ │ │ │ * r - Radius of the circle │ │ │ │ │ * color - Color of the circle │ │ │ │ │ See also: _a_l___d_r_a_w___c_i_r_c_l_e, _a_l___d_r_a_w___f_i_l_l_e_d___e_l_l_i_p_s_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___e_n_e_t___c_l_i_e_n_t_._c │ │ │ │ │ * _e_x___j_o_y_s_t_i_c_k___h_o_t_p_l_u_g_g_i_n_g_._c │ │ │ │ │ * _e_x___b_l_e_n_d_2_._c_p_p │ │ │ │ │ ********** aall__ddrraaww__aarrcc ********** │ │ │ │ │ void al_draw_arc(float cx, float cy, float r, float start_theta, │ │ │ │ │ float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_arc(float cx, float cy, float r, float start_theta, │ │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws an arc. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * cx, cy - Center of the arc │ │ │ │ │ * r - Radius of the arc │ │ │ │ │ * color - Color of the arc │ │ │ │ │ * start_theta - The initial angle from which the arc is calculated in │ │ │ │ │ @@ -484,14 +517,17 @@ │ │ │ │ │ See also: _a_l___c_a_l_c_u_l_a_t_e___a_r_c, _a_l___d_r_a_w___e_l_l_i_p_t_i_c_a_l___a_r_c │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__eelllliippttiiccaall__aarrcc ********** │ │ │ │ │ void al_draw_elliptical_arc(float cx, float cy, float rx, float ry, float │ │ │ │ │ start_theta, │ │ │ │ │ float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_elliptical_arc(float cx, float cy, float rx, float ry, float │ │ │ │ │ +start_theta, │ │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws an elliptical arc. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * cx, cy - Center of the arc │ │ │ │ │ * rx, ry - Radii of the arc │ │ │ │ │ * color - Color of the arc │ │ │ │ │ * start_theta - The initial angle from which the arc is calculated in │ │ │ │ │ @@ -502,14 +538,16 @@ │ │ │ │ │ Since: 5.0.6, 5.1.0 │ │ │ │ │ See also: _a_l___c_a_l_c_u_l_a_t_e___a_r_c, _a_l___d_r_a_w___a_r_c │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ccaallccuullaattee__sspplliinnee ********** │ │ │ │ │ void al_calculate_spline(float* dest, int stride, const float points[8], │ │ │ │ │ float thickness, int num_segments) │ │ │ │ │ +void al_calculate_spline(float* dest, int stride, const float points[8], │ │ │ │ │ + float thickness, int num_segments) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Calculates a Bézier spline given 4 control points. If thickness <= 0, then │ │ │ │ │ num_segments of points are required in the destination, otherwise twice as many │ │ │ │ │ are needed. The destination buffer should consist of regularly spaced (by │ │ │ │ │ distance of stride bytes) doublets of floats, corresponding to x and y │ │ │ │ │ coordinates of the vertices. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ @@ -519,26 +557,30 @@ │ │ │ │ │ * points - An array of 4 pairs of coordinates of the 4 control points │ │ │ │ │ * thickness - Thickness of the spline ribbon │ │ │ │ │ * num_segments - The number of points to calculate │ │ │ │ │ See also: _a_l___d_r_a_w___s_p_l_i_n_e, _a_l___c_a_l_c_u_l_a_t_e___a_r_c, _a_l___c_a_l_c_u_l_a_t_e___r_i_b_b_o_n │ │ │ │ │ ********** aall__ddrraaww__sspplliinnee ********** │ │ │ │ │ void al_draw_spline(const float points[8], ALLEGRO_COLOR color, float │ │ │ │ │ thickness) │ │ │ │ │ +void al_draw_spline(const float points[8], ALLEGRO_COLOR color, float │ │ │ │ │ +thickness) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a Bézier spline given 4 control points. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * points - An array of 4 pairs of coordinates of the 4 control points │ │ │ │ │ * color - Color of the spline │ │ │ │ │ * thickness - Thickness of the spline, pass <= 0 to draw a hairline spline │ │ │ │ │ See also: _a_l___c_a_l_c_u_l_a_t_e___s_p_l_i_n_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ccaallccuullaattee__rriibbbboonn ********** │ │ │ │ │ void al_calculate_ribbon(float* dest, int dest_stride, const float *points, │ │ │ │ │ int points_stride, float thickness, int num_segments) │ │ │ │ │ +void al_calculate_ribbon(float* dest, int dest_stride, const float *points, │ │ │ │ │ + int points_stride, float thickness, int num_segments) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Calculates a ribbon given an array of points. The ribbon will go through all of │ │ │ │ │ the passed points. If thickness <= 0, then num_segments of points are required │ │ │ │ │ in the destination buffer, otherwise twice as many are needed. The destination │ │ │ │ │ and the points buffer should consist of regularly spaced doublets of floats, │ │ │ │ │ corresponding to x and y coordinates of the vertices. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ @@ -551,14 +593,17 @@ │ │ │ │ │ * thickness - Thickness of the spline ribbon │ │ │ │ │ * num_segments - The number of points to calculate │ │ │ │ │ See also: _a_l___d_r_a_w___r_i_b_b_o_n, _a_l___c_a_l_c_u_l_a_t_e___a_r_c, _a_l___c_a_l_c_u_l_a_t_e___s_p_l_i_n_e │ │ │ │ │ ********** aall__ddrraaww__rriibbbboonn ********** │ │ │ │ │ void al_draw_ribbon(const float *points, int points_stride, ALLEGRO_COLOR │ │ │ │ │ color, │ │ │ │ │ float thickness, int num_segments) │ │ │ │ │ +void al_draw_ribbon(const float *points, int points_stride, ALLEGRO_COLOR │ │ │ │ │ +color, │ │ │ │ │ + float thickness, int num_segments) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a ribbon given an array of points. The ribbon will go through all of the │ │ │ │ │ passed points. The points buffer should consist of regularly spaced doublets of │ │ │ │ │ floats, corresponding to x and y coordinates of the vertices. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * points - An array of coordinate pairs (x and y) for each point │ │ │ │ │ * points_stride - Distance (in bytes) between starts of successive pairs of │ │ │ │ │ @@ -588,14 +633,16 @@ │ │ │ │ │ offset the texture coordinates you pass to the al_draw_prim by (0.5, 0.5) if │ │ │ │ │ you need precise pixel control. E.g. to refer to pixel (5, 10) you’d set the u │ │ │ │ │ and v to 5.5 and 10.5 respectively. │ │ │ │ │ See also: _P_i_x_e_l_-_p_r_e_c_i_s_e_ _o_u_t_p_u_t │ │ │ │ │ ********** aall__ddrraaww__pprriimm ********** │ │ │ │ │ int al_draw_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │ │ +int al_draw_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ + ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a subset of the passed vertex array. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * texture - Texture to use, pass NULL to use only color shaded primitves │ │ │ │ │ * vtxs - Pointer to an array of vertices │ │ │ │ │ * decl - Pointer to a _v_e_r_t_e_x_ _d_e_c_l_a_r_a_t_i_o_n. If set to NULL, the vertices are │ │ │ │ │ assumed to be of the _A_L_L_E_G_R_O___V_E_R_T_E_X type │ │ │ │ │ @@ -616,14 +663,16 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m___w_r_a_p_._c │ │ │ │ │ ********** aall__ddrraaww__iinnddeexxeedd__pprriimm ********** │ │ │ │ │ int al_draw_indexed_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ ALLEGRO_BITMAP* texture, const int* indices, int num_vtx, int type) │ │ │ │ │ +int al_draw_indexed_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ + ALLEGRO_BITMAP* texture, const int* indices, int num_vtx, int type) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a subset of the passed vertex array. This function uses an index array to │ │ │ │ │ specify which vertices to use. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * texture - Texture to use, pass NULL to use only color shaded primitves │ │ │ │ │ * vtxs - Pointer to an array of vertices │ │ │ │ │ * decl - Pointer to a vertex declaration. If set to NULL, the vtxs are │ │ │ │ │ @@ -635,14 +684,16 @@ │ │ │ │ │ RReettuurrnnss:: Number of primitives drawn │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X, _A_L_L_E_G_R_O___P_R_I_M___T_Y_P_E, _A_L_L_E_G_R_O___V_E_R_T_E_X___D_E_C_L, _a_l___d_r_a_w___p_r_i_m │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_o_j_e_c_t_i_o_n_2_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__vveerrtteexx__bbuuffffeerr ********** │ │ │ │ │ int al_draw_vertex_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ │ + ALLEGRO_BITMAP* texture, int sta) │ │ │ │ │ +int al_draw_vertex_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ │ ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a subset of the passed vertex buffer. The vertex buffer must not be │ │ │ │ │ locked. Additionally, to draw onto memory bitmaps or with memory bitmap │ │ │ │ │ textures the vertex buffer must support reading (i.e. it must be created with │ │ │ │ │ the ALLEGRO_PRIM_BUFFER_READWRITE). │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ @@ -658,14 +709,17 @@ │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddrraaww__iinnddeexxeedd__bbuuffffeerr ********** │ │ │ │ │ int al_draw_indexed_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ │ ALLEGRO_BITMAP* texture, ALLEGRO_INDEX_BUFFER* index_buffer, │ │ │ │ │ int start, int end, int type) │ │ │ │ │ +int al_draw_indexed_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ │ + ALLEGRO_BITMAP* texture, ALLEGRO_INDEX_BUFFER* index_buffer, │ │ │ │ │ + int start, int end, int type) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a subset of the passed vertex buffer. This function uses an index buffer │ │ │ │ │ to specify which vertices to use. Both buffers must not be locked. │ │ │ │ │ Additionally, to draw onto memory bitmaps or with memory bitmap textures both │ │ │ │ │ buffers must support reading (i.e. they must be created with the │ │ │ │ │ ALLEGRO_PRIM_BUFFER_READWRITE). │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ @@ -685,14 +739,20 @@ │ │ │ │ │ ********** aall__ddrraaww__ssoofftt__ttrriiaannggllee ********** │ │ │ │ │ void al_draw_soft_triangle( │ │ │ │ │ ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, ALLEGRO_VERTEX* v3, uintptr_t state, │ │ │ │ │ void (*init)(uintptr_t, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ │ void (*first)(uintptr_t, int, int, int, int), │ │ │ │ │ void (*step)(uintptr_t, int), │ │ │ │ │ void (*draw)(uintptr_t, int, int, int)) │ │ │ │ │ +void al_draw_soft_triangle( │ │ │ │ │ + ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, ALLEGRO_VERTEX* v3, uintptr_t state, │ │ │ │ │ + void (*init)(uintptr_t, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ │ + void (*first)(uintptr_t, int, int, int, int), │ │ │ │ │ + void (*step)(uintptr_t, int), │ │ │ │ │ + void (*draw)(uintptr_t, int, int, int)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a triangle using the software rasterizer and user supplied pixel │ │ │ │ │ functions. For help in understanding what these functions do, see the │ │ │ │ │ implementation of the various shading routines in addons/primitives/tri_soft.c. │ │ │ │ │ The triangle is drawn in two segments, from top to bottom. The segments are │ │ │ │ │ deliniated by the vertically middle vertex of the triangle. One of the two │ │ │ │ │ segments may be absent if two vertices are horizontally collinear. │ │ │ │ │ @@ -718,14 +778,18 @@ │ │ │ │ │ coordinates are inclusive. │ │ │ │ │ See also: _a_l___d_r_a_w___t_r_i_a_n_g_l_e │ │ │ │ │ ********** aall__ddrraaww__ssoofftt__lliinnee ********** │ │ │ │ │ void al_draw_soft_line(ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, uintptr_t state, │ │ │ │ │ void (*first)(uintptr_t, int, int, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ │ void (*step)(uintptr_t, int), │ │ │ │ │ void (*draw)(uintptr_t, int, int)) │ │ │ │ │ +void al_draw_soft_line(ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, uintptr_t state, │ │ │ │ │ + void (*first)(uintptr_t, int, int, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ │ + void (*step)(uintptr_t, int), │ │ │ │ │ + void (*draw)(uintptr_t, int, int)) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a line using the software rasterizer and user supplied pixel functions. │ │ │ │ │ For help in understanding what these functions do, see the implementation of │ │ │ │ │ the various shading routines in addons/primitives/line_soft.c. The line is │ │ │ │ │ drawn top to bottom. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * v1, v2 - The two vertices of the line │ │ │ │ │ @@ -742,37 +806,42 @@ │ │ │ │ │ * draw - Called once per pixel. The function is expected to draw the pixel │ │ │ │ │ at the coordinates passed to it. │ │ │ │ │ See also: _a_l___d_r_a_w___l_i_n_e │ │ │ │ │ ************ CCuussttoomm vveerrtteexx ddeeccllaarraattiioonn rroouuttiinneess ************ │ │ │ │ │ ********** aall__ccrreeaattee__vveerrtteexx__ddeeccll ********** │ │ │ │ │ ALLEGRO_VERTEX_DECL* al_create_vertex_decl(const ALLEGRO_VERTEX_ELEMENT* │ │ │ │ │ elements, int stride) │ │ │ │ │ +ALLEGRO_VERTEX_DECL* al_create_vertex_decl(const ALLEGRO_VERTEX_ELEMENT* │ │ │ │ │ +elements, int stride) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a vertex declaration, which describes a custom vertex format. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * elements - An array of _A_L_L_E_G_R_O___V_E_R_T_E_X___E_L_E_M_E_N_T structures. │ │ │ │ │ * stride - Size of the custom vertex structure │ │ │ │ │ RReettuurrnnss:: Newly created vertex declaration. │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X___E_L_E_M_E_N_T, _A_L_L_E_G_R_O___V_E_R_T_E_X___D_E_C_L, _a_l___d_e_s_t_r_o_y___v_e_r_t_e_x___d_e_c_l │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__vveerrtteexx__ddeeccll ********** │ │ │ │ │ void al_destroy_vertex_decl(ALLEGRO_VERTEX_DECL* decl) │ │ │ │ │ +void al_destroy_vertex_decl(ALLEGRO_VERTEX_DECL* decl) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Destroys a vertex declaration. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * decl - Vertex declaration to destroy │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X___E_L_E_M_E_N_T, _A_L_L_E_G_R_O___V_E_R_T_E_X___D_E_C_L, _a_l___c_r_e_a_t_e___v_e_r_t_e_x___d_e_c_l │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ ************ VVeerrtteexx bbuuffffeerr rroouuttiinneess ************ │ │ │ │ │ ********** aall__ccrreeaattee__vveerrtteexx__bbuuffffeerr ********** │ │ │ │ │ ALLEGRO_VERTEX_BUFFER* al_create_vertex_buffer(ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ const void* initial_data, int num_vertices, int flags) │ │ │ │ │ +ALLEGRO_VERTEX_BUFFER* al_create_vertex_buffer(ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ + const void* initial_data, int num_vertices, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a vertex buffer. Can return NULL if the buffer could not be created │ │ │ │ │ (e.g. the system only supports write-only buffers). │ │ │ │ │ NNoottee:: │ │ │ │ │ This is an advanced feature, often unsupported on lower-end video │ │ │ │ │ cards. Be extra mindful of this function failing and make │ │ │ │ │ arrangements for fallback drawing functionality or a nice error │ │ │ │ │ @@ -789,24 +858,27 @@ │ │ │ │ │ Since: 5.1.3 │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X___B_U_F_F_E_R, _a_l___d_e_s_t_r_o_y___v_e_r_t_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__vveerrtteexx__bbuuffffeerr ********** │ │ │ │ │ void al_destroy_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ +void al_destroy_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Destroys a vertex buffer. Does nothing if passed NULL. │ │ │ │ │ Since: 5.1.3 │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X___B_U_F_F_E_R, _a_l___c_r_e_a_t_e___v_e_r_t_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__lloocckk__vveerrtteexx__bbuuffffeerr ********** │ │ │ │ │ void* al_lock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer, int offset, │ │ │ │ │ int length, int flags) │ │ │ │ │ +void* al_lock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer, int offset, │ │ │ │ │ + int length, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Locks a vertex buffer so you can access its data. Will return NULL if the │ │ │ │ │ parameters are invalid, if reading is requested from a write only buffer, or if │ │ │ │ │ the buffer is already locked. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * buffer - Vertex buffer to lock │ │ │ │ │ * offset - Vertex index of the start of the locked range │ │ │ │ │ @@ -816,31 +888,35 @@ │ │ │ │ │ Since: 5.1.3 │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X___B_U_F_F_E_R, _a_l___u_n_l_o_c_k___v_e_r_t_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__uunnlloocckk__vveerrtteexx__bbuuffffeerr ********** │ │ │ │ │ void al_unlock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ +void al_unlock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Unlocks a previously locked vertex buffer. │ │ │ │ │ Since: 5.1.3 │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X___B_U_F_F_E_R, _a_l___l_o_c_k___v_e_r_t_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ggeett__vveerrtteexx__bbuuffffeerr__ssiizzee ********** │ │ │ │ │ int al_get_vertex_buffer_size(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ +int al_get_vertex_buffer_size(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the size of the vertex buffer │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X___B_U_F_F_E_R │ │ │ │ │ ************ IInnddeexx bbuuffffeerr rroouuttiinneess ************ │ │ │ │ │ ********** aall__ccrreeaattee__iinnddeexx__bbuuffffeerr ********** │ │ │ │ │ ALLEGRO_INDEX_BUFFER* al_create_index_buffer(int index_size, │ │ │ │ │ const void* initial_data, int num_indices, int flags) │ │ │ │ │ +ALLEGRO_INDEX_BUFFER* al_create_index_buffer(int index_size, │ │ │ │ │ + const void* initial_data, int num_indices, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Creates a index buffer. Can return NULL if the buffer could not be created │ │ │ │ │ (e.g. the system only supports write-only buffers). │ │ │ │ │ NNoottee:: │ │ │ │ │ This is an advanced feature, often unsupported on lower-end video │ │ │ │ │ cards. Be extra mindful of this function failing and make │ │ │ │ │ arrangements for fallback drawing functionality or a nice error │ │ │ │ │ @@ -856,23 +932,26 @@ │ │ │ │ │ ALLEGRO_PRIM_BUFFER_STATIC. │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ See also: _A_L_L_E_G_R_O___I_N_D_E_X___B_U_F_F_E_R, _a_l___d_e_s_t_r_o_y___i_n_d_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ddeessttrrooyy__iinnddeexx__bbuuffffeerr ********** │ │ │ │ │ void al_destroy_index_buffer(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ +void al_destroy_index_buffer(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Destroys a index buffer. Does nothing if passed NULL. │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ See also: _A_L_L_E_G_R_O___I_N_D_E_X___B_U_F_F_E_R, _a_l___c_r_e_a_t_e___i_n_d_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__lloocckk__iinnddeexx__bbuuffffeerr ********** │ │ │ │ │ void* al_lock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer, int offset, │ │ │ │ │ int length, int flags) │ │ │ │ │ +void* al_lock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer, int offset, │ │ │ │ │ + int length, int flags) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Locks a index buffer so you can access its data. Will return NULL if the │ │ │ │ │ parameters are invalid, if reading is requested from a write only buffer and if │ │ │ │ │ the buffer is already locked. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * buffer - Index buffer to lock │ │ │ │ │ * offset - Element index of the start of the locked range │ │ │ │ │ @@ -881,31 +960,36 @@ │ │ │ │ │ ALLEGRO_LOCK_READWRITE │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ See also: _A_L_L_E_G_R_O___I_N_D_E_X___B_U_F_F_E_R, _a_l___u_n_l_o_c_k___i_n_d_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__uunnlloocckk__iinnddeexx__bbuuffffeerr ********** │ │ │ │ │ void al_unlock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ +void al_unlock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Unlocks a previously locked index buffer. │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ See also: _A_L_L_E_G_R_O___I_N_D_E_X___B_U_F_F_E_R, _a_l___l_o_c_k___i_n_d_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** aall__ggeett__iinnddeexx__bbuuffffeerr__ssiizzee ********** │ │ │ │ │ int al_get_index_buffer_size(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ +int al_get_index_buffer_size(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the size of the index buffer │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ See also: _A_L_L_E_G_R_O___I_N_D_E_X___B_U_F_F_E_R │ │ │ │ │ ************ PPoollyyggoonn rroouuttiinneess ************ │ │ │ │ │ ********** aall__ddrraaww__ppoollyylliinnee ********** │ │ │ │ │ void al_draw_polyline(const float* vertices, int vertex_stride, │ │ │ │ │ int vertex_count, int join_style, int cap_style, │ │ │ │ │ ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ │ +void al_draw_polyline(const float* vertices, int vertex_stride, │ │ │ │ │ + int vertex_count, int join_style, int cap_style, │ │ │ │ │ + ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draw a series of line segments. │ │ │ │ │ * vertices - Interleaved array of (x, y) vertex coordinates │ │ │ │ │ * vertex_stride - the number of bytes between pairs of vertices (the │ │ │ │ │ stride) │ │ │ │ │ * vertex_count - Number of vertices in the array │ │ │ │ │ * join_style - Member of _A_L_L_E_G_R_O___L_I_N_E___J_O_I_N specifying how to render the │ │ │ │ │ @@ -932,14 +1016,16 @@ │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___d_r_a_w___p_o_l_y_g_o_n, _A_L_L_E_G_R_O___L_I_N_E___J_O_I_N, _A_L_L_E_G_R_O___L_I_N_E___C_A_P │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_o_l_y_g_o_n_._c │ │ │ │ │ ********** aall__ddrraaww__ppoollyyggoonn ********** │ │ │ │ │ void al_draw_polygon(const float *vertices, int vertex_count, │ │ │ │ │ int join_style, ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ │ +void al_draw_polygon(const float *vertices, int vertex_count, │ │ │ │ │ + int join_style, ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draw an unfilled polygon. This is the same as passing ALLEGRO_LINE_CAP_CLOSED │ │ │ │ │ to _a_l___d_r_a_w___p_o_l_y_l_i_n_e. │ │ │ │ │ * vertex - Interleaved array of (x, y) vertex coordinates │ │ │ │ │ * vertex_count - Number of vertices in the array │ │ │ │ │ * join_style - Member of _A_L_L_E_G_R_O___L_I_N_E___J_O_I_N specifying how to render the │ │ │ │ │ joins between line segments │ │ │ │ │ @@ -947,15 +1033,18 @@ │ │ │ │ │ * thickness - Thickness of the line, pass <= 0 to draw hairline lines │ │ │ │ │ * miter_limit - Parameter for miter join style │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___d_r_a_w___f_i_l_l_e_d___p_o_l_y_g_o_n, _a_l___d_r_a_w___p_o_l_y_l_i_n_e, _A_L_L_E_G_R_O___L_I_N_E___J_O_I_N │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_o_l_y_g_o_n_._c │ │ │ │ │ ********** aall__ddrraaww__ffiilllleedd__ppoollyyggoonn ********** │ │ │ │ │ -void al_draw_filled_polygon(const float *vertices, int vertex_count, │ │ │ │ │ +void al_draw_filled_polygon(const float *vertices, int vertex_cou │ │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_polygon(const float *vertices, int vertex_court, int end, │ │ │ │ │ +int type) │ │ │ │ │ ALLEGRO_COLOR color) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draw a filled, simple polygon. Simple means it does not have to be convex but │ │ │ │ │ must not be self-overlapping. │ │ │ │ │ * vertices - Interleaved array of (x, y) vertex coordinates │ │ │ │ │ * vertex_count - Number of vertices in the array │ │ │ │ │ * color - Color of the filled polygon │ │ │ │ │ @@ -964,14 +1053,16 @@ │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___d_r_a_w___p_o_l_y_g_o_n, _a_l___d_r_a_w___f_i_l_l_e_d___p_o_l_y_g_o_n___w_i_t_h___h_o_l_e_s │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_o_l_y_g_o_n_._c │ │ │ │ │ ********** aall__ddrraaww__ffiilllleedd__ppoollyyggoonn__wwiitthh__hhoolleess ********** │ │ │ │ │ void al_draw_filled_polygon_with_holes(const float *vertices, │ │ │ │ │ const int *vertex_counts, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_polygon_with_holes(const float *vertices, │ │ │ │ │ + const int *vertex_counts, ALLEGRO_COLOR color) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Draws a filled simple polygon with zero or more other simple polygons │ │ │ │ │ subtracted from it - the holes. The holes cannot touch or intersect with the │ │ │ │ │ outline of the filled polygon. │ │ │ │ │ * vertices - Interleaved array of (x, y) vertex coordinates for each of the │ │ │ │ │ polygons, including holes. │ │ │ │ │ * vertex_counts - Number of vertices for each polygon. The number of │ │ │ │ │ @@ -1007,14 +1098,17 @@ │ │ │ │ │ _a_l___t_r_i_a_n_g_u_l_a_t_e___p_o_l_y_g_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_o_l_y_g_o_n_._c │ │ │ │ │ ********** aall__ttrriiaanngguullaattee__ppoollyyggoonn ********** │ │ │ │ │ bool al_triangulate_polygon( │ │ │ │ │ const float* vertices, size_t vertex_stride, const int* vertex_counts, │ │ │ │ │ void (*emit_triangle)(int, int, int, void*), void* userdata) │ │ │ │ │ +bool al_triangulate_polygon( │ │ │ │ │ + const float* vertices, size_t vertex_stride, const int* vertex_counts, │ │ │ │ │ + void (*emit_triangle)(int, int, int, void*), void* userdata) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Divides a simple polygon into triangles, with zero or more other simple │ │ │ │ │ polygons subtracted from it - the holes. The holes cannot touch or intersect │ │ │ │ │ with the outline of the main polygon. Simple means the polygon does not have to │ │ │ │ │ be convex but must not be self-overlapping. │ │ │ │ │ PPaarraammeetteerrss:: │ │ │ │ │ * vertices - Interleaved array of (x, y) vertex coordinates for each of the │ │ │ │ │ @@ -1030,14 +1124,15 @@ │ │ │ │ │ vertices and userdata. │ │ │ │ │ * userdata - arbitrary data to be passed to emit_triangle. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___d_r_a_w___f_i_l_l_e_d___p_o_l_y_g_o_n___w_i_t_h___h_o_l_e_s │ │ │ │ │ ************ SSttrruuccttuurreess aanndd ttyyppeess ************ │ │ │ │ │ ********** AALLLLEEGGRROO__VVEERRTTEEXX ********** │ │ │ │ │ typedef struct ALLEGRO_VERTEX ALLEGRO_VERTEX; │ │ │ │ │ +typedef struct ALLEGRO_VERTEX ALLEGRO_VERTEX; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Defines the generic vertex type, with a 3D position, color and texture │ │ │ │ │ coordinates for a single texture. Note that at this time, the software driver │ │ │ │ │ for this addon cannot render 3D primitives. If you want a 2D only primitive, │ │ │ │ │ set z to 0. Note that you must initialize all members of this struct when │ │ │ │ │ you’re using it. One exception to this rule are the u and v variables which can │ │ │ │ │ be left uninitialized when you are not using textures. │ │ │ │ │ @@ -1045,27 +1140,29 @@ │ │ │ │ │ * x, y, z - Position of the vertex (float) │ │ │ │ │ * u, v - Texture coordinates measured in pixels (float) │ │ │ │ │ * color - _A_L_L_E_G_R_O___C_O_L_O_R structure, storing the color of the vertex │ │ │ │ │ See also: _A_L_L_E_G_R_O___P_R_I_M___A_T_T_R │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ********** AALLLLEEGGRROO__VVEERRTTEEXX__DDEECCLL ********** │ │ │ │ │ typedef struct ALLEGRO_VERTEX_DECL ALLEGRO_VERTEX_DECL; │ │ │ │ │ +typedef struct ALLEGRO_VERTEX_DECL ALLEGRO_VERTEX_DECL; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A vertex declaration. This opaque structure is responsible for describing the │ │ │ │ │ format and layout of a user defined custom vertex. It is created and destroyed │ │ │ │ │ by specialized functions. │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___v_e_r_t_e_x___d_e_c_l, _a_l___d_e_s_t_r_o_y___v_e_r_t_e_x___d_e_c_l, _A_L_L_E_G_R_O___V_E_R_T_E_X___E_L_E_M_E_N_T │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** AALLLLEEGGRROO__VVEERRTTEEXX__EELLEEMMEENNTT ********** │ │ │ │ │ typedef struct ALLEGRO_VERTEX_ELEMENT ALLEGRO_VERTEX_ELEMENT; │ │ │ │ │ +typedef struct ALLEGRO_VERTEX_ELEMENT ALLEGRO_VERTEX_ELEMENT; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A small structure describing a certain element of a vertex. E.g. the position │ │ │ │ │ of the vertex, or its color. These structures are used by the │ │ │ │ │ _a_l___c_r_e_a_t_e___v_e_r_t_e_x___d_e_c_l function to create the vertex declaration. For that they │ │ │ │ │ generally occur in an array. The last element of such an array should have the │ │ │ │ │ attribute field equal to 0, to signify that it is the end of the array. Here is │ │ │ │ │ an example code that would create a declaration describing the _A_L_L_E_G_R_O___V_E_R_T_E_X │ │ │ │ │ @@ -1093,14 +1190,15 @@ │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___v_e_r_t_e_x___d_e_c_l, _A_L_L_E_G_R_O___V_E_R_T_E_X___D_E_C_L, _A_L_L_E_G_R_O___P_R_I_M___A_T_T_R, │ │ │ │ │ _A_L_L_E_G_R_O___P_R_I_M___S_T_O_R_A_G_E │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** AALLLLEEGGRROO__PPRRIIMM__TTYYPPEE ********** │ │ │ │ │ typedef enum ALLEGRO_PRIM_TYPE │ │ │ │ │ +typedef enum ALLEGRO_PRIM_TYPE │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Enumerates the types of primitives this addon can draw. │ │ │ │ │ * ALLEGRO_PRIM_POINT_LIST - A list of points, each vertex defines a point │ │ │ │ │ * ALLEGRO_PRIM_LINE_LIST - A list of lines, sequential pairs of vertices │ │ │ │ │ define disjointed lines │ │ │ │ │ * ALLEGRO_PRIM_LINE_STRIP - A strip of lines, sequential vertices define a │ │ │ │ │ strip of lines │ │ │ │ │ @@ -1110,14 +1208,15 @@ │ │ │ │ │ vertices define disjointed triangles │ │ │ │ │ * ALLEGRO_PRIM_TRIANGLE_STRIP - A strip of triangles, sequential vertices │ │ │ │ │ define a strip of triangles │ │ │ │ │ * ALLEGRO_PRIM_TRIANGLE_FAN - A fan of triangles, all triangles share the │ │ │ │ │ first vertex │ │ │ │ │ ********** AALLLLEEGGRROO__PPRRIIMM__AATTTTRR ********** │ │ │ │ │ typedef enum ALLEGRO_PRIM_ATTR │ │ │ │ │ +typedef enum ALLEGRO_PRIM_ATTR │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Enumerates the types of vertex attributes that a custom vertex may have. │ │ │ │ │ * ALLEGRO_PRIM_POSITION - Position information, can be stored only in │ │ │ │ │ ALLEGRO_PRIM_SHORT_2, ALLEGRO_PRIM_FLOAT_2 and ALLEGRO_PRIM_FLOAT_3. │ │ │ │ │ * ALLEGRO_PRIM_COLOR_ATTR - Color information, stored in an _A_L_L_E_G_R_O___C_O_L_O_R. │ │ │ │ │ The storage field of ALLEGRO_VERTEX_ELEMENT is ignored │ │ │ │ │ * ALLEGRO_PRIM_TEX_COORD - Texture coordinate information, can be stored │ │ │ │ │ @@ -1155,14 +1254,15 @@ │ │ │ │ │ parameter with the following semantics: TEXCOORD{# + 2} where # is the │ │ │ │ │ index of the attribute. E.g. the first attribute can be accessed via │ │ │ │ │ TEXCOORD2, second via TEXCOORD3 and so on. │ │ │ │ │ Since: 5.1.6 │ │ │ │ │ See also: _A_L_L_E_G_R_O___V_E_R_T_E_X___D_E_C_L, _A_L_L_E_G_R_O___P_R_I_M___S_T_O_R_A_G_E, _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e │ │ │ │ │ ********** AALLLLEEGGRROO__PPRRIIMM__SSTTOORRAAGGEE ********** │ │ │ │ │ typedef enum ALLEGRO_PRIM_STORAGE │ │ │ │ │ +typedef enum ALLEGRO_PRIM_STORAGE │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Enumerates the types of storage an attribute of a custom vertex may be stored │ │ │ │ │ in. Many of these can only be used for ALLEGRO_PRIM_USER_ATTR attributes and │ │ │ │ │ can only be accessed via shaders. Usually no matter what the storage is │ │ │ │ │ specified the attribute gets converted to single precision floating point when │ │ │ │ │ the shader is run. Despite that, it may be advantageous to use more dense │ │ │ │ │ storage formats (e.g. ALLEGRO_PRIM_NORMALIZED_UBYTE_4 instead of │ │ │ │ │ @@ -1206,29 +1306,32 @@ │ │ │ │ │ * ALLEGRO_PRIM_HALF_FLOAT_4 - A quad of half-precision floats. Note that │ │ │ │ │ this storage format is not supported on all platforms. │ │ │ │ │ _a_l___c_r_e_a_t_e___v_e_r_t_e_x___d_e_c_l will return NULL if you use it on those platforms. │ │ │ │ │ Since: 5.1.6 │ │ │ │ │ See also: _A_L_L_E_G_R_O___P_R_I_M___A_T_T_R │ │ │ │ │ ********** AALLLLEEGGRROO__VVEERRTTEEXX__CCAACCHHEE__SSIIZZEE ********** │ │ │ │ │ #define ALLEGRO_VERTEX_CACHE_SIZE 256 │ │ │ │ │ +#define ALLEGRO_VERTEX_CACHE_SIZE 256 │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Defines the size of the transformation vertex cache for the software renderer. │ │ │ │ │ If you pass less than this many vertices to the primitive rendering functions │ │ │ │ │ you will get a speed boost. This also defines the size of the cache vertex │ │ │ │ │ buffer, used for the high-level primitives. This corresponds to the maximum │ │ │ │ │ number of line segments that will be used to form them. │ │ │ │ │ ********** AALLLLEEGGRROO__PPRRIIMM__QQUUAALLIITTYY ********** │ │ │ │ │ #define ALLEGRO_PRIM_QUALITY 10 │ │ │ │ │ +#define ALLEGRO_PRIM_QUALITY 10 │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Controls the quality of the approximation of curved primitives (e.g. circles). │ │ │ │ │ Curved primitives are drawn by approximating them with a sequence of line │ │ │ │ │ segments. By default, this roughly corresponds to error of less than half of a │ │ │ │ │ pixel. │ │ │ │ │ ********** AALLLLEEGGRROO__LLIINNEE__JJOOIINN ********** │ │ │ │ │ typedef enum ALLEGRO_LINE_JOIN │ │ │ │ │ +typedef enum ALLEGRO_LINE_JOIN │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ * ALLEGRO_LINE_JOIN_NONE │ │ │ │ │ * ALLEGRO_LINE_JOIN_BEVEL │ │ │ │ │ * ALLEGRO_LINE_JOIN_ROUND │ │ │ │ │ * ALLEGRO_LINE_JOIN_MITER │ │ │ │ │ [ALLEGRO_LINE_JOIN styles]AALLLLEEGGRROO__LLIINNEE__JJOOIINN ssttyylleess │ │ │ │ │ See the picture for the difference. │ │ │ │ │ @@ -1236,14 +1339,15 @@ │ │ │ │ │ parameter to the polygon functions. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___d_r_a_w___p_o_l_y_g_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_o_l_y_g_o_n_._c │ │ │ │ │ ********** AALLLLEEGGRROO__LLIINNEE__CCAAPP ********** │ │ │ │ │ typedef enum ALLEGRO_LINE_CAP │ │ │ │ │ +typedef enum ALLEGRO_LINE_CAP │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ * ALLEGRO_LINE_CAP_NONE │ │ │ │ │ * ALLEGRO_LINE_CAP_SQUARE │ │ │ │ │ * ALLEGRO_LINE_CAP_ROUND │ │ │ │ │ * ALLEGRO_LINE_CAP_TRIANGLE │ │ │ │ │ * ALLEGRO_LINE_CAP_CLOSED │ │ │ │ │ [ALLEGRO_LINE_CAP styles]AALLLLEEGGRROO__LLIINNEE__CCAAPP ssttyylleess │ │ │ │ │ @@ -1253,34 +1357,37 @@ │ │ │ │ │ looks.) │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___d_r_a_w___p_o_l_y_g_o_n │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_o_l_y_g_o_n_._c │ │ │ │ │ ********** AALLLLEEGGRROO__VVEERRTTEEXX__BBUUFFFFEERR ********** │ │ │ │ │ typedef struct ALLEGRO_VERTEX_BUFFER ALLEGRO_VERTEX_BUFFER; │ │ │ │ │ +typedef struct ALLEGRO_VERTEX_BUFFER ALLEGRO_VERTEX_BUFFER; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A GPU vertex buffer that you can use to store vertices on the GPU instead of │ │ │ │ │ uploading them afresh during every drawing operation. │ │ │ │ │ Since: 5.1.3 │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___v_e_r_t_e_x___b_u_f_f_e_r, _a_l___d_e_s_t_r_o_y___v_e_r_t_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_e_r_t_e_x___b_u_f_f_e_r_._c │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** AALLLLEEGGRROO__IINNDDEEXX__BBUUFFFFEERR ********** │ │ │ │ │ typedef struct ALLEGRO_INDEX_BUFFER ALLEGRO_INDEX_BUFFER; │ │ │ │ │ +typedef struct ALLEGRO_INDEX_BUFFER ALLEGRO_INDEX_BUFFER; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ A GPU index buffer that you can use to store indices of vertices in a vertex │ │ │ │ │ buffer on the GPU instead of uploading them afresh during every drawing │ │ │ │ │ operation. │ │ │ │ │ Since: 5.1.8 │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___i_n_d_e_x___b_u_f_f_e_r, _a_l___d_e_s_t_r_o_y___i_n_d_e_x___b_u_f_f_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___p_r_i_m_._c │ │ │ │ │ ********** AALLLLEEGGRROO__PPRRIIMM__BBUUFFFFEERR__FFLLAAGGSS ********** │ │ │ │ │ typedef enum ALLEGRO_PRIM_BUFFER_FLAGS │ │ │ │ │ +typedef enum ALLEGRO_PRIM_BUFFER_FLAGS │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Flags to specify how to create a vertex or an index buffer. │ │ │ │ │ * ALLEGRO_PRIM_BUFFER_STREAM - Hints to the driver that the buffer is │ │ │ │ │ written to often, but used only a few times per frame │ │ │ │ │ * ALLEGRO_PRIM_BUFFER_STATIC - Hints to the driver that the buffer is │ │ │ │ │ written to once and is used often │ │ │ │ │ * ALLEGRO_PRIM_BUFFER_DYNAMIC - Hints to the driver that the buffer is │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/shader.html │ │ │ │ @@ -214,15 +214,16 @@ │ │ │ │
              • al_get_default_shader_source
                • │ │ │ │
              │ │ │ │ │ │ │ │

              These functions are declared in the main Allegro header file:

              │ │ │ │ 
               #include <allegro5/allegro.h>
              │ │ │ │

              ALLEGRO_SHADER

              │ │ │ │ -
              typedef struct ALLEGRO_SHADER ALLEGRO_SHADER;
              │ │ │ │ +
              typedef struct ALLEGRO_SHADER ALLEGRO_SHADER;
│ │ │ │ +typedef struct ALLEGRO_SHADER ALLEGRO_SHADER;
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              An ALLEGRO_SHADER is a │ │ │ │ program that runs on the GPU. It combines both a vertex and a pixel │ │ │ │ shader. (In OpenGL terms, an ALLEGRO_SHADER is actually a │ │ │ │ @@ -236,18 +237,19 @@ │ │ │ │

              Examples:

              │ │ │ │
                │ │ │ │
              • ex_shader.cpp
                • │ │ │ │
              • ex_shader_target.c
                • │ │ │ │
              • ex_prim_shader.c
                • │ │ │ │ +href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_multitex.c#L25">ex_shader_multitex.c │ │ │ │
              │ │ │ │

              ALLEGRO_SHADER_TYPE

              │ │ │ │ -
              typedef enum ALLEGRO_SHADER_TYPE ALLEGRO_SHADER_TYPE;
              │ │ │ │ +
              typedef enum ALLEGRO_SHADER_TYPE ALLEGRO_SHADER_TYPE;
│ │ │ │ +typedef enum ALLEGRO_SHADER_TYPE ALLEGRO_SHADER_TYPE;
              │ │ │ │

              Source │ │ │ │ Code

              │ │ │ │

              Used with al_attach_shader_source │ │ │ │ and al_attach_shader_source_file │ │ │ │ @@ -273,15 +275,16 @@ │ │ │ │ one final pixel in the target bitmap is not necessarily composed of only │ │ │ │ a single output but of multiple fragments (for example when │ │ │ │ multi-sampling is being used).

              │ │ │ │ │ │ │ │
    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    ALLEGRO_SHADER_PLATFORM

    │ │ │ │ -
    typedef enum ALLEGRO_SHADER_PLATFORM ALLEGRO_SHADER_PLATFORM;
    │ │ │ │ +
    typedef enum ALLEGRO_SHADER_PLATFORM ALLEGRO_SHADER_PLATFORM;
│ │ │ │ +typedef enum ALLEGRO_SHADER_PLATFORM ALLEGRO_SHADER_PLATFORM;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    The underlying platform which the ALLEGRO_SHADER is built on top of, │ │ │ │ which dictates the language used to program the shader.

    │ │ │ │ │ │ │ │ - │ │ │ │ +

    │ │ │ │ +Allegro version 5.2.10 │ │ │ │ + - Last updated: 2025-01-09 13:52:42 UTC │ │ │ │ +

    │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -63,28 +63,30 @@ │ │ │ │ │ * _a_l___s_e_t___s_h_a_d_e_r___i_n_t___v_e_c_t_o_r │ │ │ │ │ * _a_l___s_e_t___s_h_a_d_e_r___f_l_o_a_t___v_e_c_t_o_r │ │ │ │ │ * _a_l___g_e_t___d_e_f_a_u_l_t___s_h_a_d_e_r___s_o_u_r_c_e │ │ │ │ │ These functions are declared in the main Allegro header file: │ │ │ │ │ #include │ │ │ │ │ ************ AALLLLEEGGRROO__SSHHAADDEERR ************ │ │ │ │ │ typedef struct ALLEGRO_SHADER ALLEGRO_SHADER; │ │ │ │ │ +typedef struct ALLEGRO_SHADER ALLEGRO_SHADER; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An _A_L_L_E_G_R_O___S_H_A_D_E_R is a program that runs on the GPU. It combines both a vertex │ │ │ │ │ and a pixel shader. (In OpenGL terms, an _A_L_L_E_G_R_O___S_H_A_D_E_R is actually a pprrooggrraamm │ │ │ │ │ which has one or more sshhaaddeerrss attached. This can be confusing.) │ │ │ │ │ The source code for the underlying vertex or pixel shader can be provided │ │ │ │ │ either as GLSL or HLSL, depending on the value of _A_L_L_E_G_R_O___S_H_A_D_E_R___P_L_A_T_F_O_R_M used │ │ │ │ │ when creating it. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ AALLLLEEGGRROO__SSHHAADDEERR__TTYYPPEE ************ │ │ │ │ │ typedef enum ALLEGRO_SHADER_TYPE ALLEGRO_SHADER_TYPE; │ │ │ │ │ +typedef enum ALLEGRO_SHADER_TYPE ALLEGRO_SHADER_TYPE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Used with _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e and _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e___f_i_l_e to specify │ │ │ │ │ how to interpret the attached source. │ │ │ │ │ ALLEGRO_VERTEX_SHADER │ │ │ │ │ A vertex shader is executed for each vertex it is used with. The program │ │ │ │ │ will output exactly one vertex at a time. │ │ │ │ │ When Allegro’s graphics are being used then in addition to all vertices │ │ │ │ │ @@ -100,14 +102,15 @@ │ │ │ │ │ A more accurate term for pixel shader would be fragment shader since one │ │ │ │ │ final pixel in the target bitmap is not necessarily composed of only a │ │ │ │ │ single output but of multiple fragments (for example when multi-sampling │ │ │ │ │ is being used). │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ ************ AALLLLEEGGRROO__SSHHAADDEERR__PPLLAATTFFOORRMM ************ │ │ │ │ │ typedef enum ALLEGRO_SHADER_PLATFORM ALLEGRO_SHADER_PLATFORM; │ │ │ │ │ +typedef enum ALLEGRO_SHADER_PLATFORM ALLEGRO_SHADER_PLATFORM; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ The underlying platform which the _A_L_L_E_G_R_O___S_H_A_D_E_R is built on top of, which │ │ │ │ │ dictates the language used to program the shader. │ │ │ │ │ * ALLEGRO_SHADER_AUTO - Pick a platform automatically given the current │ │ │ │ │ display flags. │ │ │ │ │ * ALLEGRO_SHADER_GLSL - OpenGL Shading Language │ │ │ │ │ * ALLEGRO_SHADER_HLSL - High Level Shader Language (for Direct3D) │ │ │ │ │ @@ -137,15 +140,15 @@ │ │ │ │ │ Returns the shader object on success. Otherwise, returns NULL. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e, _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e___f_i_l_e, │ │ │ │ │ _a_l___b_u_i_l_d___s_h_a_d_e_r, _a_l___u_s_e___s_h_a_d_e_r, _a_l___d_e_s_t_r_o_y___s_h_a_d_e_r, _a_l___g_e_t___s_h_a_d_e_r___p_l_a_t_f_o_r_m │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ aall__aattttaacchh__sshhaaddeerr__ssoouurrccee ************ │ │ │ │ │ bool al_attach_shader_source(ALLEGRO_SHADER *shader, ALLEGRO_SHADER_TYPE type, │ │ │ │ │ const char *source) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Attaches the shader’s source code to the shader object and compiles it. Passing │ │ │ │ │ NULL deletes the underlying (OpenGL or DirectX) shader. See also │ │ │ │ │ _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e___f_i_l_e if you prefer to obtain your shader source from an │ │ │ │ │ @@ -227,29 +230,29 @@ │ │ │ │ │ updated. The error log can be retrieved with _a_l___g_e_t___s_h_a_d_e_r___l_o_g. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e___f_i_l_e, _a_l___b_u_i_l_d___s_h_a_d_e_r, │ │ │ │ │ _a_l___g_e_t___d_e_f_a_u_l_t___s_h_a_d_e_r___s_o_u_r_c_e, _a_l___g_e_t___s_h_a_d_e_r___l_o_g, _A_L_L_E_G_R_O___P_R_I_M___A_T_T_R │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ aall__aattttaacchh__sshhaaddeerr__ssoouurrccee__ffiillee ************ │ │ │ │ │ bool al_attach_shader_source_file(ALLEGRO_SHADER *shader, │ │ │ │ │ ALLEGRO_SHADER_TYPE type, const char *filename) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e but reads the source code for the shader from the │ │ │ │ │ named file. │ │ │ │ │ Returns true on success and false on error, in which case the error log is │ │ │ │ │ updated. The error log can be retrieved with _a_l___g_e_t___s_h_a_d_e_r___l_o_g. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e, _a_l___b_u_i_l_d___s_h_a_d_e_r, _a_l___g_e_t___s_h_a_d_e_r___l_o_g │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ aall__bbuuiilldd__sshhaaddeerr ************ │ │ │ │ │ bool al_build_shader(ALLEGRO_SHADER *shader) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This is required before the shader can be used with _a_l___u_s_e___s_h_a_d_e_r. It should be │ │ │ │ │ called after successfully attaching the pixel and/or vertex shaders with │ │ │ │ │ _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e or _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e___f_i_l_e. │ │ │ │ │ Returns true on success and false on error, in which case the error log is │ │ │ │ │ @@ -258,55 +261,55 @@ │ │ │ │ │ you must specify both a pixel and a vertex shader sources for │ │ │ │ │ anything to be rendered. │ │ │ │ │ Since: 5.1.6 │ │ │ │ │ See also: _a_l___u_s_e___s_h_a_d_e_r, _a_l___g_e_t___s_h_a_d_e_r___l_o_g │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ aall__ggeett__sshhaaddeerr__lloogg ************ │ │ │ │ │ const char *al_get_shader_log(ALLEGRO_SHADER *shader) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return a read-only string containing the information log for a shader program. │ │ │ │ │ The log is updated by certain functions, such as _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e or │ │ │ │ │ _a_l___b_u_i_l_d___s_h_a_d_e_r when there is an error. │ │ │ │ │ This function never returns NULL. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e, _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e___f_i_l_e, │ │ │ │ │ _a_l___b_u_i_l_d___s_h_a_d_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ aall__ggeett__sshhaaddeerr__ppllaattffoorrmm ************ │ │ │ │ │ ALLEGRO_SHADER_PLATFORM al_get_shader_platform(ALLEGRO_SHADER *shader) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the platform the shader was created with (either ALLEGRO_SHADER_HLSL or │ │ │ │ │ ALLEGRO_SHADER_GLSL). │ │ │ │ │ Since: 5.1.6 │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___s_h_a_d_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ aall__uussee__sshhaaddeerr ************ │ │ │ │ │ bool al_use_shader(ALLEGRO_SHADER *shader) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Uses the shader for subsequent drawing operations on the current target bitmap. │ │ │ │ │ Pass NULL to stop using any shader on the current target bitmap. │ │ │ │ │ Returns true on success. Otherwise returns false, e.g. because the shader is │ │ │ │ │ incompatible with the target bitmap. │ │ │ │ │ Since: 5.1.6 │ │ │ │ │ See also: _a_l___d_e_s_t_r_o_y___s_h_a_d_e_r, _a_l___s_e_t___s_h_a_d_e_r___s_a_m_p_l_e_r, _a_l___s_e_t___s_h_a_d_e_r___m_a_t_r_i_x, │ │ │ │ │ _a_l___s_e_t___s_h_a_d_e_r___i_n_t, _a_l___s_e_t___s_h_a_d_e_r___f_l_o_a_t, _a_l___s_e_t___s_h_a_d_e_r___b_o_o_l, │ │ │ │ │ _a_l___s_e_t___s_h_a_d_e_r___i_n_t___v_e_c_t_o_r, _a_l___s_e_t___s_h_a_d_e_r___f_l_o_a_t___v_e_c_t_o_r, _a_l___g_e_t___c_u_r_r_e_n_t___s_h_a_d_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ aall__ggeett__ccuurrrreenntt__sshhaaddeerr ************ │ │ │ │ │ ALLEGRO_SHADER *al_get_current_shader() │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Return the shader of the target bitmap, or NULL if one isn’t being used. │ │ │ │ │ Since: 5.2.9 │ │ │ │ │ See also: _a_l___u_s_e___s_h_a_d_e_r │ │ │ │ │ ************ aall__ddeessttrrooyy__sshhaaddeerr ************ │ │ │ │ │ @@ -319,15 +322,15 @@ │ │ │ │ │ shader then the shader is implicitly unused before being destroyed. │ │ │ │ │ This function does nothing if the shader argument is NULL. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___c_r_e_a_t_e___s_h_a_d_e_r │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r_._c_p_p │ │ │ │ │ * _e_x___s_h_a_d_e_r___t_a_r_g_e_t_._c │ │ │ │ │ - * _e_x___p_r_i_m___s_h_a_d_e_r_._c │ │ │ │ │ + * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ ************ aall__sseett__sshhaaddeerr__ssaammpplleerr ************ │ │ │ │ │ bool al_set_shader_sampler(const char *name, │ │ │ │ │ ALLEGRO_BITMAP *bitmap, int unit) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Sets a texture sampler uniform and texture unit of the current target bitmap’s │ │ │ │ │ shader. The given bitmap must be a video bitmap. │ │ │ │ │ Different samplers should use different units. The bitmap passed to Allegro’s │ │ │ │ │ @@ -429,7 +432,8 @@ │ │ │ │ │ the selected platform. │ │ │ │ │ Since: 5.1.6 │ │ │ │ │ See also: _a_l___a_t_t_a_c_h___s_h_a_d_e_r___s_o_u_r_c_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___s_h_a_d_e_r___m_u_l_t_i_t_e_x_._c │ │ │ │ │ * _e_x___p_a_l_e_t_t_e_._c │ │ │ │ │ * _e_x___p_r_i_m___w_r_a_p_._c │ │ │ │ │ +Allegro version 5.2.10 - Last updated: 2025-01-09 13:52:42 UTC │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/state.html │ │ │ │ @@ -184,15 +184,16 @@ │ │ │ │
  • al_get_errno
    • │ │ │ │
  • al_set_errno
    • │ │ │ │ │ │ │ │ │ │ │ │

    These functions are declared in the main Allegro header file:

    │ │ │ │ 
     #include <allegro5/allegro.h>
    │ │ │ │

    ALLEGRO_STATE

    │ │ │ │ -
    typedef struct ALLEGRO_STATE ALLEGRO_STATE;
    │ │ │ │ +
    typedef struct ALLEGRO_STATE ALLEGRO_STATE;
│ │ │ │ +typedef struct ALLEGRO_STATE ALLEGRO_STATE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Opaque type which is passed to al_store_state/al_restore_state.

    │ │ │ │

    The various state kept internally by Allegro can be displayed like │ │ │ │ @@ -228,15 +229,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend_bench.c#L65">ex_blend_bench.c │ │ │ │

  • ex_blend2.cpp
    • │ │ │ │
  • nihgui.cpp
    • │ │ │ │ │ │ │ │

    ALLEGRO_STATE_FLAGS

    │ │ │ │ -
    typedef enum ALLEGRO_STATE_FLAGS
    │ │ │ │ +
    typedef enum ALLEGRO_STATE_FLAGS
│ │ │ │ +typedef enum ALLEGRO_STATE_FLAGS
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Flags which can be passed to al_store_state/al_restore_state as bit │ │ │ │ combinations. See al_store_state │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -49,14 +49,15 @@ │ │ │ │ │ * _a_l___s_t_o_r_e___s_t_a_t_e │ │ │ │ │ * _a_l___g_e_t___e_r_r_n_o │ │ │ │ │ * _a_l___s_e_t___e_r_r_n_o │ │ │ │ │ These functions are declared in the main Allegro header file: │ │ │ │ │ #include │ │ │ │ │ ************ AALLLLEEGGRROO__SSTTAATTEE ************ │ │ │ │ │ typedef struct ALLEGRO_STATE ALLEGRO_STATE; │ │ │ │ │ +typedef struct ALLEGRO_STATE ALLEGRO_STATE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Opaque type which is passed to _a_l___s_t_o_r_e___s_t_a_t_e/_a_l___r_e_s_t_o_r_e___s_t_a_t_e. │ │ │ │ │ The various state kept internally by Allegro can be displayed like this: │ │ │ │ │ global │ │ │ │ │ active system driver │ │ │ │ │ current config │ │ │ │ │ per thread │ │ │ │ │ @@ -82,14 +83,15 @@ │ │ │ │ │ thread communication.) │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___b_l_e_n_d___b_e_n_c_h_._c │ │ │ │ │ * _e_x___b_l_e_n_d_2_._c_p_p │ │ │ │ │ * _n_i_h_g_u_i_._c_p_p │ │ │ │ │ ************ AALLLLEEGGRROO__SSTTAATTEE__FFLLAAGGSS ************ │ │ │ │ │ typedef enum ALLEGRO_STATE_FLAGS │ │ │ │ │ +typedef enum ALLEGRO_STATE_FLAGS │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Flags which can be passed to _a_l___s_t_o_r_e___s_t_a_t_e/_a_l___r_e_s_t_o_r_e___s_t_a_t_e as bit │ │ │ │ │ combinations. See _a_l___s_t_o_r_e___s_t_a_t_e for the list of flags. │ │ │ │ │ ************ aall__rreessttoorree__ssttaattee ************ │ │ │ │ │ void al_restore_state(ALLEGRO_STATE const *state) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Restores part of the state of the current thread from the given _A_L_L_E_G_R_O___S_T_A_T_E │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/system.html │ │ │ │ @@ -232,15 +232,16 @@ │ │ │ │ be the version of Allegro you compiled with, and B = xb.yb.zb.* be the │ │ │ │ version of Allegro found in the system shared library.

    │ │ │ │

    If you defined ALLEGRO_UNSTABLE before including Allegro │ │ │ │ headers, then version A is compatible with B only if xa.ya.za = │ │ │ │ xb.yb.zb. Otherwise, A is compatible with B only if xa.ya = xb.yb.

    │ │ │ │

    See also: al_init

    │ │ │ │

    al_init

    │ │ │ │ -
    #define al_init()    (al_install_system(ALLEGRO_VERSION_INT, atexit))
    │ │ │ │ +
    #define al_init()    (al_install_system(ALLEGRO_VERSION_INT, atexit))
│ │ │ │ +#define al_init()    (al_install_system(ALLEGRO_VERSION_INT, atexit))
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_install_system, │ │ │ │ but automatically passes in the version and uses the atexit function │ │ │ │ visible in the current binary.

    │ │ │ │
    │ │ │ │ @@ -848,15 +849,16 @@ │ │ │ │

    Since: 5.1.12

    │ │ │ │

    Examples:

    │ │ │ │
      │ │ │ │
    • ex_cpu.c
      • │ │ │ │
    │ │ │ │

    ALLEGRO_SYSTEM_ID

    │ │ │ │ -
    enum ALLEGRO_SYSTEM_ID {
    │ │ │ │ +
    enum ALLEGRO_SYSTEM_ID {
│ │ │ │ +enum ALLEGRO_SYSTEM_ID {
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    The system Allegro is running on.

    │ │ │ │ │ │ │ │ │ │ │ │

    These functions are declared in the main Allegro header file:

    │ │ │ │ 
     #include <allegro5/allegro.h>
    │ │ │ │

    ALLEGRO_TOUCH_INPUT

    │ │ │ │ -
    typedef struct ALLEGRO_TOUCH_INPUT ALLEGRO_TOUCH_INPUT;
    │ │ │ │ +
    typedef struct ALLEGRO_TOUCH_INPUT ALLEGRO_TOUCH_INPUT;
│ │ │ │ +typedef struct ALLEGRO_TOUCH_INPUT ALLEGRO_TOUCH_INPUT;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An abstract data type representing a physical touch screen or touch │ │ │ │ pad.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT

    │ │ │ │ -
    #define ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT        16
    │ │ │ │ +
    #define ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT        16
│ │ │ │ +#define ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT        16
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    The maximum amount of simultaneous touches that can be detected.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    ALLEGRO_TOUCH_STATE

    │ │ │ │ -
    typedef struct ALLEGRO_TOUCH_STATE ALLEGRO_TOUCH_STATE;
    │ │ │ │ +
    typedef struct ALLEGRO_TOUCH_STATE ALLEGRO_TOUCH_STATE;
│ │ │ │ +typedef struct ALLEGRO_TOUCH_STATE ALLEGRO_TOUCH_STATE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This is a structure that is used to hold a “snapshot” of a touch at a │ │ │ │ particular instant.

    │ │ │ │

    Public fields (read only):

    │ │ │ │
      │ │ │ │ @@ -238,28 +241,30 @@ │ │ │ │ one). │ │ │ │
    • display - The ALLEGRO_DISPLAY that was │ │ │ │ touched.
      • │ │ │ │
    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    ALLEGRO_TOUCH_INPUT_STATE

    │ │ │ │ -
    typedef struct ALLEGRO_TOUCH_INPUT_STATE ALLEGRO_TOUCH_INPUT_STATE;
    │ │ │ │ +
    typedef struct ALLEGRO_TOUCH_INPUT_STATE ALLEGRO_TOUCH_INPUT_STATE;
│ │ │ │ +typedef struct ALLEGRO_TOUCH_INPUT_STATE ALLEGRO_TOUCH_INPUT_STATE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This is a structure that holds a snapshot of all simultaneous touches │ │ │ │ at a particular instant.

    │ │ │ │

    Public fields (read only):

    │ │ │ │ │ │ │ │

    Since: 5.1.0

    │ │ │ │

    ALLEGRO_MOUSE_EMULATION_MODE

    │ │ │ │ -
    typedef enum ALLEGRO_MOUSE_EMULATION_MODE
    │ │ │ │ +
    typedef enum ALLEGRO_MOUSE_EMULATION_MODE
│ │ │ │ +typedef enum ALLEGRO_MOUSE_EMULATION_MODE
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Type of mouse emulation to apply.

    │ │ │ │
    │ │ │ │
    ALLEGRO_MOUSE_EMULATION_NONE
    │ │ │ │
    │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -56,46 +56,51 @@ │ │ │ │ │ * _a_l___g_e_t___m_o_u_s_e___e_m_u_l_a_t_i_o_n___m_o_d_e │ │ │ │ │ * _a_l___g_e_t___t_o_u_c_h___i_n_p_u_t___e_v_e_n_t___s_o_u_r_c_e │ │ │ │ │ * _a_l___g_e_t___t_o_u_c_h___i_n_p_u_t___m_o_u_s_e___e_m_u_l_a_t_i_o_n___e_v_e_n_t___s_o_u_r_c_e │ │ │ │ │ These functions are declared in the main Allegro header file: │ │ │ │ │ #include │ │ │ │ │ ************ AALLLLEEGGRROO__TTOOUUCCHH__IINNPPUUTT ************ │ │ │ │ │ typedef struct ALLEGRO_TOUCH_INPUT ALLEGRO_TOUCH_INPUT; │ │ │ │ │ +typedef struct ALLEGRO_TOUCH_INPUT ALLEGRO_TOUCH_INPUT; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ An abstract data type representing a physical touch screen or touch pad. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ ************ AALLLLEEGGRROO__TTOOUUCCHH__IINNPPUUTT__MMAAXX__TTOOUUCCHH__CCOOUUNNTT ************ │ │ │ │ │ #define ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT 16 │ │ │ │ │ +#define ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT 16 │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ The maximum amount of simultaneous touches that can be detected. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ ************ AALLLLEEGGRROO__TTOOUUCCHH__SSTTAATTEE ************ │ │ │ │ │ typedef struct ALLEGRO_TOUCH_STATE ALLEGRO_TOUCH_STATE; │ │ │ │ │ +typedef struct ALLEGRO_TOUCH_STATE ALLEGRO_TOUCH_STATE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This is a structure that is used to hold a “snapshot” of a touch at a │ │ │ │ │ particular instant. │ │ │ │ │ Public fields (read only): │ │ │ │ │ * id - identifier of the touch. If the touch is valid, this is positive. │ │ │ │ │ * x - touch x position │ │ │ │ │ * y - touch y position │ │ │ │ │ * dx - touch relative x position │ │ │ │ │ * dy - touch relative y position │ │ │ │ │ * primary - TRUE if this touch is the primary one (usually the first one). │ │ │ │ │ * display - The _A_L_L_E_G_R_O___D_I_S_P_L_A_Y that was touched. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ ************ AALLLLEEGGRROO__TTOOUUCCHH__IINNPPUUTT__SSTTAATTEE ************ │ │ │ │ │ typedef struct ALLEGRO_TOUCH_INPUT_STATE ALLEGRO_TOUCH_INPUT_STATE; │ │ │ │ │ +typedef struct ALLEGRO_TOUCH_INPUT_STATE ALLEGRO_TOUCH_INPUT_STATE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This is a structure that holds a snapshot of all simultaneous touches at a │ │ │ │ │ particular instant. │ │ │ │ │ Public fields (read only): │ │ │ │ │ * touches - an array of _A_L_L_E_G_R_O___T_O_U_C_H___S_T_A_T_E │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ ************ AALLLLEEGGRROO__MMOOUUSSEE__EEMMUULLAATTIIOONN__MMOODDEE ************ │ │ │ │ │ typedef enum ALLEGRO_MOUSE_EMULATION_MODE │ │ │ │ │ +typedef enum ALLEGRO_MOUSE_EMULATION_MODE │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Type of mouse emulation to apply. │ │ │ │ │ ALLEGRO_MOUSE_EMULATION_NONE │ │ │ │ │ Disables mouse emulation. │ │ │ │ │ ALLEGRO_MOUSE_EMULATION_TRANSPARENT │ │ │ │ │ Enables transparent mouse emulation. │ │ │ │ │ ALLEGRO_MOUSE_EMULATION_INCLUSIVE │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/transformations.html │ │ │ │ @@ -301,15 +301,16 @@ │ │ │ │ al_use_transform(&T); │ │ │ │

    it does exactly the same as:

    │ │ │ │ 
    al_identity_transform(&T);
│ │ │ │  al_scale_transform(&T, 2, 2);
│ │ │ │  al_translate_transform(&T, 100, 0);
│ │ │ │  al_use_transform(&T);
    │ │ │ │

    ALLEGRO_TRANSFORM

    │ │ │ │ -
    typedef struct ALLEGRO_TRANSFORM ALLEGRO_TRANSFORM;
    │ │ │ │ +
    typedef struct ALLEGRO_TRANSFORM ALLEGRO_TRANSFORM;
│ │ │ │ +typedef struct ALLEGRO_TRANSFORM ALLEGRO_TRANSFORM;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Defines the generic transformation type, a 4x4 matrix. 2D transforms │ │ │ │ use only a small subsection of this matrix, namely the top left 2x2 │ │ │ │ matrix, and the right most 2x1 matrix, for a total of 6 values.

    │ │ │ │

    Fields:

    │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -130,14 +130,15 @@ │ │ │ │ │ it does exactly the same as: │ │ │ │ │ al_identity_transform(&T); │ │ │ │ │ al_scale_transform(&T, 2, 2); │ │ │ │ │ al_translate_transform(&T, 100, 0); │ │ │ │ │ al_use_transform(&T); │ │ │ │ │ ************ AALLLLEEGGRROO__TTRRAANNSSFFOORRMM ************ │ │ │ │ │ typedef struct ALLEGRO_TRANSFORM ALLEGRO_TRANSFORM; │ │ │ │ │ +typedef struct ALLEGRO_TRANSFORM ALLEGRO_TRANSFORM; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Defines the generic transformation type, a 4x4 matrix. 2D transforms use only a │ │ │ │ │ small subsection of this matrix, namely the top left 2x2 matrix, and the right │ │ │ │ │ most 2x1 matrix, for a total of 6 values. │ │ │ │ │ FFiieellddss:: │ │ │ │ │ * m - A 4x4 float matrix │ │ │ │ │ Examples: │ │ │ ├── ./usr/share/doc/allegro5-doc/refman/utf8.html │ │ │ │ @@ -437,15 +437,16 @@ │ │ │ │

    For actual text processing, where you want to specify positions with │ │ │ │ code point indices, you should use al_ustr_offset to find the code unit │ │ │ │ offset position. However, most of the time you would probably just work │ │ │ │ with byte offsets.

    │ │ │ │

    UTF-8 string types

    │ │ │ │

    ALLEGRO_USTR

    │ │ │ │ -
    typedef struct _al_tagbstring ALLEGRO_USTR;
    │ │ │ │ +
    typedef struct _al_tagbstring ALLEGRO_USTR;
│ │ │ │ +typedef struct _al_tagbstring ALLEGRO_USTR;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    An opaque type representing a string. ALLEGRO_USTRs normally contain │ │ │ │ UTF-8 encoded strings, but they may be used to hold any byte sequences, │ │ │ │ including NULs.

    │ │ │ │

    Examples:

    │ │ │ │ @@ -454,15 +455,16 @@ │ │ │ │ href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_multiline.cpp#L248">ex_font_multiline.cpp │ │ │ │
  • nihgui.cpp
    • │ │ │ │
  • ex_blend.c
    • │ │ │ │ │ │ │ │

    ALLEGRO_USTR_INFO

    │ │ │ │ -
    typedef struct _al_tagbstring ALLEGRO_USTR_INFO;
    │ │ │ │ +
    typedef struct _al_tagbstring ALLEGRO_USTR_INFO;
│ │ │ │ +typedef struct _al_tagbstring ALLEGRO_USTR_INFO;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    A type that holds additional information for an ALLEGRO_USTR that references an │ │ │ │ external memory buffer. You can convert it back to ALLEGRO_USTR via │ │ │ │ 

     #include <allegro5/allegro_video.h>
    │ │ │ │

    Currently we have an Ogg backend (Theora + Vorbis). See http://xiph.org/ for │ │ │ │ installation instructions, licensing information and supported video │ │ │ │ formats.

    │ │ │ │

    ALLEGRO_VIDEO_EVENT_TYPE

    │ │ │ │ -
    enum ALLEGRO_VIDEO_EVENT_TYPE
    │ │ │ │ +
    enum ALLEGRO_VIDEO_EVENT_TYPE
│ │ │ │ +enum ALLEGRO_VIDEO_EVENT_TYPE
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Events sent by al_get_video_event_source.

    │ │ │ │

    ALLEGRO_EVENT_VIDEO_FRAME_SHOW

    │ │ │ │ @@ -262,15 +263,16 @@ │ │ │ │
    user.data1 (ALLEGRO_VIDEO *)
    │ │ │ │
    │ │ │ │ The video which generated the event. │ │ │ │
    │ │ │ │
    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    ALLEGRO_VIDEO_POSITION_TYPE

    │ │ │ │ -
    typedef enum ALLEGRO_VIDEO_POSITION_TYPE ALLEGRO_VIDEO_POSITION_TYPE;
    │ │ │ │ +
    typedef enum ALLEGRO_VIDEO_POSITION_TYPE ALLEGRO_VIDEO_POSITION_TYPE;
│ │ │ │ +typedef enum ALLEGRO_VIDEO_POSITION_TYPE ALLEGRO_VIDEO_POSITION_TYPE;
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Used with al_get_video_position to │ │ │ │ specify which position to retrieve. If these get out of sync, audio and │ │ │ │ video may be out of sync in the display of the video.

    │ │ │ │ @@ -284,79 +286,86 @@ │ │ │ │

  • ALLEGRO_VIDEO_POSITION_AUDIO_DECODE - The amount of audio that │ │ │ │ has been decoded. This may be the same as ALLEGRO_VIDEO_POSITION_ACTUAL │ │ │ │ if audio decode is driving the position, which is common to keep audio │ │ │ │ and video in sync.

    • │ │ │ │ │ │ │ │

    Since: 5.1.11

    │ │ │ │

    al_init_video_addon

    │ │ │ │ -
    bool al_init_video_addon(void)
    │ │ │ │ +
    bool al_init_video_addon(void)
│ │ │ │ +bool al_init_video_addon(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Initializes the video addon.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_is_video_addon_initialized

    │ │ │ │ -
    bool al_is_video_addon_initialized(void)
    │ │ │ │ +
    bool al_is_video_addon_initialized(void)
│ │ │ │ +bool al_is_video_addon_initialized(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if the video addon is initialized, otherwise returns │ │ │ │ false.

    │ │ │ │

    Since: 5.2.6

    │ │ │ │

    al_shutdown_video_addon

    │ │ │ │ -
    void al_shutdown_video_addon(void)
    │ │ │ │ +
    void al_shutdown_video_addon(void)
│ │ │ │ +void al_shutdown_video_addon(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Shut down the video addon. This is done automatically at program │ │ │ │ exit, but can be called any time the user wishes as well.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │

    al_get_allegro_video_version

    │ │ │ │ -
    uint32_t al_get_allegro_video_version(void)
    │ │ │ │ +
    uint32_t al_get_allegro_video_version(void)
│ │ │ │ +uint32_t al_get_allegro_video_version(void)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the (compiled) version of the addon, in the same format as al_get_allegro_version.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │

    al_open_video

    │ │ │ │ -
    ALLEGRO_VIDEO *al_open_video(char const *filename)
    │ │ │ │ +
    ALLEGRO_VIDEO *al_open_video(char const *filename)
│ │ │ │ +ALLEGRO_VIDEO *al_open_video(char const *filename)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Reads a video file. This does not start playing yet but reads the │ │ │ │ meta info so you can query e.g. the size or audio rate.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_identify_video

    │ │ │ │ -
    char const *al_identify_video(char const *filename)
    │ │ │ │ +
    char const *al_identify_video(char const *filename)
│ │ │ │ +char const *al_identify_video(char const *filename)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    This works exactly as al_identify_video_f but you │ │ │ │ specify the filename of the file for which to detect the type and not a │ │ │ │ file handle. The extension, if any, of the passed filename is not taken │ │ │ │ into account - only the file contents.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    See also: al_init_video_addon, al_identify_video_f

    │ │ │ │

    al_identify_video_f

    │ │ │ │ -
    char const *al_identify_video_f(ALLEGRO_FILE *fp)
    │ │ │ │ +
    char const *al_identify_video_f(ALLEGRO_FILE *fp)
│ │ │ │ +char const *al_identify_video_f(ALLEGRO_FILE *fp)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Tries to guess the video file type of the open ALLEGRO_FILE by │ │ │ │ reading the first few bytes. By default Allegro cannot recognize any │ │ │ │ file types, but calling al_init_video_addon will add │ │ │ │ @@ -365,111 +374,120 @@ │ │ │ │ type, including the leading dot. For example “.ogv”. Returns NULL if the │ │ │ │ video type cannot be determined.

    │ │ │ │

    Since: 5.2.8

    │ │ │ │

    See also: al_init_video_addon, al_identify_video

    │ │ │ │

    al_close_video

    │ │ │ │ -
    void al_close_video(ALLEGRO_VIDEO *video)
    │ │ │ │ +
    void al_close_video(ALLEGRO_VIDEO *video)
│ │ │ │ +void al_close_video(ALLEGRO_VIDEO *video)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Closes the video and frees all allocated resources. The video pointer │ │ │ │ is invalid after the function returns.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_start_video

    │ │ │ │ -
    void al_start_video(ALLEGRO_VIDEO *video, ALLEGRO_MIXER *mixer)
    │ │ │ │ +
    void al_start_video(ALLEGRO_VIDEO *video, ALLEGRO_MIXER *mixer)
│ │ │ │ +void al_start_video(ALLEGRO_VIDEO *video, ALLEGRO_MIXER *mixer)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Starts playing the video from the beginning.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_start_video_with_voice

    │ │ │ │ -
    void al_start_video_with_voice(ALLEGRO_VIDEO *video, ALLEGRO_VOICE *voice)
    │ │ │ │ +
    void al_start_video_with_voice(ALLEGRO_VIDEO *video, ALLEGRO_VOICE *voice)
│ │ │ │ +void al_start_video_with_voice(ALLEGRO_VIDEO *video, ALLEGRO_VOICE *voice)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Like al_start_video but audio │ │ │ │ is routed to the provided voice.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    al_get_video_event_source

    │ │ │ │ -
    ALLEGRO_EVENT_SOURCE *al_get_video_event_source(ALLEGRO_VIDEO *video)
    │ │ │ │ +
    ALLEGRO_EVENT_SOURCE *al_get_video_event_source(ALLEGRO_VIDEO *video)
│ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_video_event_source(ALLEGRO_VIDEO *video)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Get an event source for the video. The possible events are described │ │ │ │ under ALLEGRO_VIDEO_EVENT_TYPE.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_set_video_playing

    │ │ │ │ -
    void al_set_video_playing(ALLEGRO_VIDEO *video, bool play)
    │ │ │ │ +
    void al_set_video_playing(ALLEGRO_VIDEO *video, bool play)
│ │ │ │ +void al_set_video_playing(ALLEGRO_VIDEO *video, bool play)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Paused or resumes playback.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_is_video_playing

    │ │ │ │ -
    bool al_is_video_playing(ALLEGRO_VIDEO *video)
    │ │ │ │ +
    bool al_is_video_playing(ALLEGRO_VIDEO *video)
│ │ │ │ +bool al_is_video_playing(ALLEGRO_VIDEO *video)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns true if the video is currently playing.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_video_audio_rate

    │ │ │ │ -
    double al_get_video_audio_rate(ALLEGRO_VIDEO *video)
    │ │ │ │ +
    double al_get_video_audio_rate(ALLEGRO_VIDEO *video)
│ │ │ │ +double al_get_video_audio_rate(ALLEGRO_VIDEO *video)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the audio rate of the video, in Hz.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_video_fps

    │ │ │ │ -
    double al_get_video_fps(ALLEGRO_VIDEO *video)
    │ │ │ │ +
    double al_get_video_fps(ALLEGRO_VIDEO *video)
│ │ │ │ +double al_get_video_fps(ALLEGRO_VIDEO *video)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the speed of the video in frames per second. Often this will │ │ │ │ not be an integer value.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_video_scaled_width

    │ │ │ │ -
    float al_get_video_scaled_width(ALLEGRO_VIDEO *video)
    │ │ │ │ +
    float al_get_video_scaled_width(ALLEGRO_VIDEO *video)
│ │ │ │ +float al_get_video_scaled_width(ALLEGRO_VIDEO *video)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the width with which the video frame should be drawn. Videos │ │ │ │ often do not use square pixels, so this will may return a value larger │ │ │ │ than the width of the frame bitmap.

    │ │ │ │

    Since: 5.1.12

    │ │ │ │ @@ -477,15 +495,16 @@ │ │ │ │ href="video.html#al_get_video_frame">al_get_video_frame

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_video_scaled_height

    │ │ │ │ -
    float al_get_video_scaled_height(ALLEGRO_VIDEO *video)
    │ │ │ │ +
    float al_get_video_scaled_height(ALLEGRO_VIDEO *video)
│ │ │ │ +float al_get_video_scaled_height(ALLEGRO_VIDEO *video)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the height with which the video frame should be drawn. Videos │ │ │ │ often do not use square pixels, so this will may return a value larger │ │ │ │ than the height of the frame bitmap.

    │ │ │ │

    See also: Since: 5.1.12

    │ │ │ │

    Examples:

    │ │ │ │     │ │ │ │

    al_get_video_frame

    │ │ │ │ -
    ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video)
    │ │ │ │ +
    ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video)
│ │ │ │ +ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the current video frame. The bitmap is owned by the video so │ │ │ │ do not attempt to free it. The bitmap will stay valid until the next │ │ │ │ call to al_get_video_frame.

    │ │ │ │

    Videos often do not use square pixels so the recommended way to draw │ │ │ │ @@ -520,30 +540,32 @@ │ │ │ │ href="video.html#al_get_video_scaled_height">al_get_video_scaled_height

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_get_video_position

    │ │ │ │ -
    double al_get_video_position(ALLEGRO_VIDEO *video, ALLEGRO_VIDEO_POSITION_TYPE which)
    │ │ │ │ +
    double al_get_video_position(ALLEGRO_VIDEO *video, ALLEGRO_VIDEO_POSITION_TYPE which)
│ │ │ │ +double al_get_video_position(ALLEGRO_VIDEO *video, ALLEGRO_VIDEO_POSITION_TYPE which)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Returns the current position of the video stream in seconds since the │ │ │ │ beginning. The parameter is one of the ALLEGRO_VIDEO_POSITION_TYPE │ │ │ │ constants.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    Examples:

    │ │ │ │ │ │ │ │

    al_seek_video

    │ │ │ │ -
    bool al_seek_video(ALLEGRO_VIDEO *video, double pos_in_seconds)
    │ │ │ │ +
    bool al_seek_video(ALLEGRO_VIDEO *video, double pos_in_seconds)
│ │ │ │ +bool al_seek_video(ALLEGRO_VIDEO *video, double pos_in_seconds)
    │ │ │ │

    Source │ │ │ │ Code

    │ │ │ │

    Seek to a different position in the video. Currently only seeking to │ │ │ │ the beginning of the video is supported.

    │ │ │ │

    Since: 5.1.0

    │ │ │ │

    Examples:

    │ │ │ │ ├── html2text {} │ │ │ │ │ @@ -70,14 +70,15 @@ │ │ │ │ │ These functions are declared in the following header file. Link with │ │ │ │ │ allegro_video. │ │ │ │ │ #include │ │ │ │ │ Currently we have an Ogg backend (Theora + Vorbis). See _h_t_t_p_:_/_/_x_i_p_h_._o_r_g_/ for │ │ │ │ │ installation instructions, licensing information and supported video formats. │ │ │ │ │ ************ AALLLLEEGGRROO__VVIIDDEEOO__EEVVEENNTT__TTYYPPEE ************ │ │ │ │ │ enum ALLEGRO_VIDEO_EVENT_TYPE │ │ │ │ │ +enum ALLEGRO_VIDEO_EVENT_TYPE │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Events sent by _a_l___g_e_t___v_i_d_e_o___e_v_e_n_t___s_o_u_r_c_e. │ │ │ │ │ ********** AALLLLEEGGRROO__EEVVEENNTT__VVIIDDEEOO__FFRRAAMMEE__SSHHOOWW ********** │ │ │ │ │ This event is sent when it is time to show a new frame. Once you receive this │ │ │ │ │ event, you can draw the current frame (as returned by _a_l___g_e_t___v_i_d_e_o___f_r_a_m_e). │ │ │ │ │ _a_l___g_e_t___v_i_d_e_o___f_r_a_m_e will continue returning the same frame until the next │ │ │ │ │ ALLEGRO_EVENT_VIDEO_FRAME_SHOW is sent. │ │ │ │ │ @@ -89,14 +90,15 @@ │ │ │ │ │ be possible to seek to an earlier part of the video and set the video to play │ │ │ │ │ to resume playback. │ │ │ │ │ user.data1 (ALLEGRO_VIDEO *) │ │ │ │ │ The video which generated the event. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ ************ AALLLLEEGGRROO__VVIIDDEEOO__PPOOSSIITTIIOONN__TTYYPPEE ************ │ │ │ │ │ typedef enum ALLEGRO_VIDEO_POSITION_TYPE ALLEGRO_VIDEO_POSITION_TYPE; │ │ │ │ │ +typedef enum ALLEGRO_VIDEO_POSITION_TYPE ALLEGRO_VIDEO_POSITION_TYPE; │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Used with _a_l___g_e_t___v_i_d_e_o___p_o_s_i_t_i_o_n to specify which position to retrieve. If these │ │ │ │ │ get out of sync, audio and video may be out of sync in the display of the │ │ │ │ │ video. │ │ │ │ │ * ALLEGRO_VIDEO_POSITION_ACTUAL - The amount of time the video has been │ │ │ │ │ playing. If the video has audio then this value can be ahead of │ │ │ │ │ ALLEGRO_VIDEO_POSITION_VIDEO_DECODE when video decoding lags. │ │ │ │ │ @@ -106,142 +108,160 @@ │ │ │ │ │ * ALLEGRO_VIDEO_POSITION_AUDIO_DECODE - The amount of audio that has been │ │ │ │ │ decoded. This may be the same as ALLEGRO_VIDEO_POSITION_ACTUAL if audio │ │ │ │ │ decode is driving the position, which is common to keep audio and video │ │ │ │ │ in sync. │ │ │ │ │ Since: 5.1.11 │ │ │ │ │ ************ aall__iinniitt__vviiddeeoo__aaddddoonn ************ │ │ │ │ │ bool al_init_video_addon(void) │ │ │ │ │ +bool al_init_video_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Initializes the video addon. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__iiss__vviiddeeoo__aaddddoonn__iinniittiiaalliizzeedd ************ │ │ │ │ │ bool al_is_video_addon_initialized(void) │ │ │ │ │ +bool al_is_video_addon_initialized(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the video addon is initialized, otherwise returns false. │ │ │ │ │ Since: 5.2.6 │ │ │ │ │ ************ aall__sshhuuttddoowwnn__vviiddeeoo__aaddddoonn ************ │ │ │ │ │ void al_shutdown_video_addon(void) │ │ │ │ │ +void al_shutdown_video_addon(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Shut down the video addon. This is done automatically at program exit, but can │ │ │ │ │ be called any time the user wishes as well. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ ************ aall__ggeett__aalllleeggrroo__vviiddeeoo__vveerrssiioonn ************ │ │ │ │ │ uint32_t al_get_allegro_video_version(void) │ │ │ │ │ +uint32_t al_get_allegro_video_version(void) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ _a_l___g_e_t___a_l_l_e_g_r_o___v_e_r_s_i_o_n. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ ************ aall__ooppeenn__vviiddeeoo ************ │ │ │ │ │ ALLEGRO_VIDEO *al_open_video(char const *filename) │ │ │ │ │ +ALLEGRO_VIDEO *al_open_video(char const *filename) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Reads a video file. This does not start playing yet but reads the meta info so │ │ │ │ │ you can query e.g. the size or audio rate. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__iiddeennttiiffyy__vviiddeeoo ************ │ │ │ │ │ char const *al_identify_video(char const *filename) │ │ │ │ │ +char const *al_identify_video(char const *filename) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ This works exactly as _a_l___i_d_e_n_t_i_f_y___v_i_d_e_o___f but you specify the filename of the │ │ │ │ │ file for which to detect the type and not a file handle. The extension, if any, │ │ │ │ │ of the passed filename is not taken into account - only the file contents. │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ See also: _a_l___i_n_i_t___v_i_d_e_o___a_d_d_o_n, _a_l___i_d_e_n_t_i_f_y___v_i_d_e_o___f │ │ │ │ │ ************ aall__iiddeennttiiffyy__vviiddeeoo__ff ************ │ │ │ │ │ char const *al_identify_video_f(ALLEGRO_FILE *fp) │ │ │ │ │ +char const *al_identify_video_f(ALLEGRO_FILE *fp) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Tries to guess the video file type of the open ALLEGRO_FILE by reading the │ │ │ │ │ first few bytes. By default Allegro cannot recognize any file types, but │ │ │ │ │ calling _a_l___i_n_i_t___v_i_d_e_o___a_d_d_o_n will add detection of the types it can read. │ │ │ │ │ Returns a pointer to a static string with a file extension for the type, │ │ │ │ │ including the leading dot. For example “.ogv”. Returns NULL if the video type │ │ │ │ │ cannot be determined. │ │ │ │ │ Since: 5.2.8 │ │ │ │ │ See also: _a_l___i_n_i_t___v_i_d_e_o___a_d_d_o_n, _a_l___i_d_e_n_t_i_f_y___v_i_d_e_o │ │ │ │ │ ************ aall__cclloossee__vviiddeeoo ************ │ │ │ │ │ void al_close_video(ALLEGRO_VIDEO *video) │ │ │ │ │ +void al_close_video(ALLEGRO_VIDEO *video) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Closes the video and frees all allocated resources. The video pointer is │ │ │ │ │ invalid after the function returns. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__ssttaarrtt__vviiddeeoo ************ │ │ │ │ │ void al_start_video(ALLEGRO_VIDEO *video, ALLEGRO_MIXER *mixer) │ │ │ │ │ +void al_start_video(ALLEGRO_VIDEO *video, ALLEGRO_MIXER *mixer) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Starts playing the video from the beginning. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__ssttaarrtt__vviiddeeoo__wwiitthh__vvooiiccee ************ │ │ │ │ │ void al_start_video_with_voice(ALLEGRO_VIDEO *video, ALLEGRO_VOICE *voice) │ │ │ │ │ +void al_start_video_with_voice(ALLEGRO_VIDEO *video, ALLEGRO_VOICE *voice) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Like _a_l___s_t_a_r_t___v_i_d_e_o but audio is routed to the provided voice. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ ************ aall__ggeett__vviiddeeoo__eevveenntt__ssoouurrccee ************ │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_video_event_source(ALLEGRO_VIDEO *video) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_video_event_source(ALLEGRO_VIDEO *video) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Get an event source for the video. The possible events are described under │ │ │ │ │ _A_L_L_E_G_R_O___V_I_D_E_O___E_V_E_N_T___T_Y_P_E. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__sseett__vviiddeeoo__ppllaayyiinngg ************ │ │ │ │ │ void al_set_video_playing(ALLEGRO_VIDEO *video, bool play) │ │ │ │ │ +void al_set_video_playing(ALLEGRO_VIDEO *video, bool play) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Paused or resumes playback. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__iiss__vviiddeeoo__ppllaayyiinngg ************ │ │ │ │ │ bool al_is_video_playing(ALLEGRO_VIDEO *video) │ │ │ │ │ +bool al_is_video_playing(ALLEGRO_VIDEO *video) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns true if the video is currently playing. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__ggeett__vviiddeeoo__aauuddiioo__rraattee ************ │ │ │ │ │ double al_get_video_audio_rate(ALLEGRO_VIDEO *video) │ │ │ │ │ +double al_get_video_audio_rate(ALLEGRO_VIDEO *video) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the audio rate of the video, in Hz. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__ggeett__vviiddeeoo__ffppss ************ │ │ │ │ │ double al_get_video_fps(ALLEGRO_VIDEO *video) │ │ │ │ │ +double al_get_video_fps(ALLEGRO_VIDEO *video) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the speed of the video in frames per second. Often this will not be an │ │ │ │ │ integer value. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__ggeett__vviiddeeoo__ssccaalleedd__wwiiddtthh ************ │ │ │ │ │ float al_get_video_scaled_width(ALLEGRO_VIDEO *video) │ │ │ │ │ +float al_get_video_scaled_width(ALLEGRO_VIDEO *video) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the width with which the video frame should be drawn. Videos often do │ │ │ │ │ not use square pixels, so this will may return a value larger than the width of │ │ │ │ │ the frame bitmap. │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ See also: _a_l___g_e_t___v_i_d_e_o___f_r_a_m_e │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__ggeett__vviiddeeoo__ssccaalleedd__hheeiigghhtt ************ │ │ │ │ │ float al_get_video_scaled_height(ALLEGRO_VIDEO *video) │ │ │ │ │ +float al_get_video_scaled_height(ALLEGRO_VIDEO *video) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the height with which the video frame should be drawn. Videos often do │ │ │ │ │ not use square pixels, so this will may return a value larger than the height │ │ │ │ │ of the frame bitmap. │ │ │ │ │ See also: _a_l___g_e_t___v_i_d_e_o___f_r_a_m_e │ │ │ │ │ Since: 5.1.12 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__ggeett__vviiddeeoo__ffrraammee ************ │ │ │ │ │ ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video) │ │ │ │ │ +ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the current video frame. The bitmap is owned by the video so do not │ │ │ │ │ attempt to free it. The bitmap will stay valid until the next call to │ │ │ │ │ al_get_video_frame. │ │ │ │ │ Videos often do not use square pixels so the recommended way to draw a video │ │ │ │ │ frame would be using code like this: │ │ │ │ │ float scale = 1.0; /* Adjust this to fit your target bitmap dimensions. */ │ │ │ │ │ @@ -254,22 +274,25 @@ │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ See also: _a_l___g_e_t___v_i_d_e_o___s_c_a_l_e_d___w_i_d_t_h, _a_l___g_e_t___v_i_d_e_o___s_c_a_l_e_d___h_e_i_g_h_t │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__ggeett__vviiddeeoo__ppoossiittiioonn ************ │ │ │ │ │ double al_get_video_position(ALLEGRO_VIDEO *video, ALLEGRO_VIDEO_POSITION_TYPE │ │ │ │ │ which) │ │ │ │ │ +double al_get_video_position(ALLEGRO_VIDEO *video, ALLEGRO_VIDEO_POSITION_TYPE │ │ │ │ │ +which) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Returns the current position of the video stream in seconds since the │ │ │ │ │ beginning. The parameter is one of the _A_L_L_E_G_R_O___V_I_D_E_O___P_O_S_I_T_I_O_N___T_Y_P_E constants. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ ************ aall__sseeeekk__vviiddeeoo ************ │ │ │ │ │ bool al_seek_video(ALLEGRO_VIDEO *video, double pos_in_seconds) │ │ │ │ │ +bool al_seek_video(ALLEGRO_VIDEO *video, double pos_in_seconds) │ │ │ │ │ _S_o_u_r_c_e_ _C_o_d_e │ │ │ │ │ Seek to a different position in the video. Currently only seeking to the │ │ │ │ │ beginning of the video is supported. │ │ │ │ │ Since: 5.1.0 │ │ │ │ │ Examples: │ │ │ │ │ * _e_x___v_i_d_e_o_._c │ │ │ │ │ Allegro version 5.2.10 - Last updated: 2025-01-09 13:52:42 UTC │ │ │ ├── ./usr/share/man/man3/ALLEGRO_AUDIO_DEPTH.3alleg5.gz │ │ │ │ ├── ALLEGRO_AUDIO_DEPTH.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_AUDIO_DEPTH \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_AUDIO_DEPTH │ │ │ │ │ +enum ALLEGRO_AUDIO_DEPTH │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sample depth and type as well as signedness. │ │ │ │ │ Mixers only use 32\-bit signed float (\-1..+1), or 16\-bit signed │ │ │ │ │ integers. │ │ │ │ │ Signedness is determined by an \[lq]unsigned\[rq] bit\-flag applied to │ │ │ │ │ the depth value. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_AUDIO_DEVICE.3alleg5.gz │ │ │ │ ├── ALLEGRO_AUDIO_DEVICE.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_AUDIO_DEVICE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE; │ │ │ │ │ +typedef struct ALLEGRO_AUDIO_DEVICE ALLEGRO_AUDIO_DEVICE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque datatype that represents an audio device. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_AUDIO_EVENT_TYPE.3alleg5.gz │ │ │ │ ├── ALLEGRO_AUDIO_EVENT_TYPE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_AUDIO_EVENT_TYPE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_AUDIO_EVENT_TYPE │ │ │ │ │ +enum ALLEGRO_AUDIO_EVENT_TYPE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Events sent by al_get_audio_stream_event_source(3alleg5) or │ │ │ │ │ al_get_audio_recorder_event_source(3alleg5). │ │ │ │ │ .SS ALLEGRO_EVENT_AUDIO_STREAM_FRAGMENT │ │ │ │ │ Sent when a stream fragment is ready to be filled in. │ │ │ │ │ See al_get_audio_stream_fragment(3alleg5). │ │ │ ├── ./usr/share/man/man3/ALLEGRO_AUDIO_PAN_NONE.3alleg5.gz │ │ │ │ ├── ALLEGRO_AUDIO_PAN_NONE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_AUDIO_PAN_NONE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_AUDIO_PAN_NONE (\-1000.0f) │ │ │ │ │ +#define ALLEGRO_AUDIO_PAN_NONE (\-1000.0f) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A special value for the pan property of sample instances and audio │ │ │ │ │ streams. │ │ │ │ │ Use this value to disable panning on sample instances and audio streams, │ │ │ │ │ and play them without attentuation implied by panning support. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/ALLEGRO_AUDIO_RECORDER.3alleg5.gz │ │ │ │ ├── ALLEGRO_AUDIO_RECORDER.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_AUDIO_RECORDER \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER; │ │ │ │ │ +typedef struct ALLEGRO_AUDIO_RECORDER ALLEGRO_AUDIO_RECORDER; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque datatype that represents a recording device. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.1 │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/ALLEGRO_AUDIO_RECORDER_EVENT.3alleg5.gz │ │ │ │ ├── ALLEGRO_AUDIO_RECORDER_EVENT.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_AUDIO_RECORDER_EVENT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT; │ │ │ │ │ +typedef struct ALLEGRO_AUDIO_RECORDER_EVENT ALLEGRO_AUDIO_RECORDER_EVENT; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Structure that holds the audio recorder event data. │ │ │ │ │ Every event type will contain: │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ \&.source: pointer to the audio recorder │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/ALLEGRO_AUDIO_STREAM.3alleg5.gz │ │ │ │ ├── ALLEGRO_AUDIO_STREAM.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_AUDIO_STREAM \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM; │ │ │ │ │ +typedef struct ALLEGRO_AUDIO_STREAM ALLEGRO_AUDIO_STREAM; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An ALLEGRO_AUDIO_STREAM object is used to stream generated audio to the │ │ │ │ │ sound device, in real\-time. │ │ │ │ │ This is done by reading from a buffer, which is split into a number of │ │ │ │ │ fragments. │ │ │ │ │ Whenever a fragment has finished playing, the user can refill it with │ │ │ ├── ./usr/share/man/man3/ALLEGRO_BITMAP.3alleg5.gz │ │ │ │ ├── ALLEGRO_BITMAP.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_BITMAP \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_BITMAP ALLEGRO_BITMAP; │ │ │ │ │ +typedef struct ALLEGRO_BITMAP ALLEGRO_BITMAP; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Abstract type representing a bitmap (2D image). │ │ │ ├── ./usr/share/man/man3/ALLEGRO_BITMAP_WRAP.3alleg5.gz │ │ │ │ ├── ALLEGRO_BITMAP_WRAP.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_BITMAP_WRAP \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_BITMAP_WRAP { │ │ │ │ │ +typedef enum ALLEGRO_BITMAP_WRAP { │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Controls the how the pixel color is determined from a texture querying │ │ │ │ │ the texture coordinates are outside the usual bounds. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_BITMAP_WRAP_DEFAULT \- The default behavior. │ │ │ │ │ This corresponds to ALLEGRO_BITMAP_WRAP_REPEAT when using the primitives │ │ │ ├── ./usr/share/man/man3/ALLEGRO_BPM_TO_SECS.3alleg5.gz │ │ │ │ ├── ALLEGRO_BPM_TO_SECS.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_BPM_TO_SECS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_BPM_TO_SECS(x) (60.0 / (x)) │ │ │ │ │ +#define ALLEGRO_BPM_TO_SECS(x) (60.0 / (x)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert beats per minute to seconds. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_BPS_TO_SECS.3alleg5.gz │ │ │ │ ├── ALLEGRO_BPS_TO_SECS.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_BPS_TO_SECS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_BPS_TO_SECS(x) (1.0 / (x)) │ │ │ │ │ +#define ALLEGRO_BPS_TO_SECS(x) (1.0 / (x)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert beats per second to seconds. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_CHANNEL_CONF.3alleg5.gz │ │ │ │ ├── ALLEGRO_CHANNEL_CONF.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_CHANNEL_CONF \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_CHANNEL_CONF │ │ │ │ │ +enum ALLEGRO_CHANNEL_CONF │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Speaker configuration (mono, stereo, 2.1, etc). │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_CHANNEL_CONF_1 │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_CHANNEL_CONF_2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_COLOR.3alleg5.gz │ │ │ │ ├── ALLEGRO_COLOR.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ ALLEGRO_COLOR \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_COLOR ALLEGRO_COLOR; │ │ │ │ │ +typedef struct ALLEGRO_COLOR ALLEGRO_COLOR; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An ALLEGRO_COLOR structure describes a color in a device independent │ │ │ │ │ way. │ │ │ │ │ Use al_map_rgb(3alleg5) et al.\ and al_unmap_rgb(3alleg5) et al.\ to │ │ │ │ │ translate from and to various color representations. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_COND.3alleg5.gz │ │ │ │ ├── ALLEGRO_COND.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_COND \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_COND ALLEGRO_COND; │ │ │ │ │ +typedef struct ALLEGRO_COND ALLEGRO_COND; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque structure representing a condition variable. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_CONFIG.3alleg5.gz │ │ │ │ ├── ALLEGRO_CONFIG.3alleg5 │ │ │ │ │ @@ -3,10 +3,13 @@ │ │ │ │ │ .TH "ALLEGRO_CONFIG" "3alleg5" "" "Allegro reference manual" "" │ │ │ │ │ .SH NAME │ │ │ │ │ ALLEGRO_CONFIG \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ + │ │ │ │ │ +typedef struct ALLEGRO_CONFIG ALLEGRO_CONFIG; │ │ │ │ │ +typedef struct ALLEGRO_CONFIG ALLEGRO_CONFIG; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An abstract configuration structure. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_CONFIG_ENTRY.3alleg5.gz │ │ │ │ ├── ALLEGRO_CONFIG_ENTRY.3alleg5 │ │ │ │ │ @@ -3,13 +3,16 @@ │ │ │ │ │ .TH "ALLEGRO_CONFIG_ENTRY" "3alleg5" "" "Allegro reference manual" "" │ │ │ │ │ .SH NAME │ │ │ │ │ ALLEGRO_CONFIG_ENTRY \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ + │ │ │ │ │ +typedef struct ALLEGRO_CONFIG_ENTRY ALLEGRO_CONFIG_ENTRY; │ │ │ │ │ +typedef struct ALLEGRO_CONFIG_ENTRY ALLEGRO_CONFIG_ENTRY; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque structure used for iterating across entries in a configuration │ │ │ │ │ section. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_first_config_entry(3alleg5), al_get_next_config_entry(3alleg5) │ │ │ ├── ./usr/share/man/man3/ALLEGRO_CONFIG_SECTION.3alleg5.gz │ │ │ │ ├── ALLEGRO_CONFIG_SECTION.3alleg5 │ │ │ │ │ @@ -3,14 +3,17 @@ │ │ │ │ │ .TH "ALLEGRO_CONFIG_SECTION" "3alleg5" "" "Allegro reference manual" "" │ │ │ │ │ .SH NAME │ │ │ │ │ ALLEGRO_CONFIG_SECTION \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ + │ │ │ │ │ +typedef struct ALLEGRO_CONFIG_SECTION ALLEGRO_CONFIG_SECTION; │ │ │ │ │ +typedef struct ALLEGRO_CONFIG_SECTION ALLEGRO_CONFIG_SECTION; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque structure used for iterating across sections in a │ │ │ │ │ configuration structure. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_first_config_section(3alleg5), │ │ │ │ │ al_get_next_config_section(3alleg5) │ │ │ ├── ./usr/share/man/man3/ALLEGRO_DISPLAY.3alleg5.gz │ │ │ │ ├── ALLEGRO_DISPLAY.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_DISPLAY \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_DISPLAY ALLEGRO_DISPLAY; │ │ │ │ │ +typedef struct ALLEGRO_DISPLAY ALLEGRO_DISPLAY; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque type representing an open display or window. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_DISPLAY_MODE.3alleg5.gz │ │ │ │ ├── ALLEGRO_DISPLAY_MODE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_DISPLAY_MODE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_DISPLAY_MODE │ │ │ │ │ +typedef struct ALLEGRO_DISPLAY_MODE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Used for fullscreen mode queries. │ │ │ │ │ Contains information about a supported fullscreen modes. │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ typedef struct ALLEGRO_DISPLAY_MODE { │ │ │ ├── ./usr/share/man/man3/ALLEGRO_EVENT.3alleg5.gz │ │ │ │ ├── ALLEGRO_EVENT.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_EVENT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef union ALLEGRO_EVENT ALLEGRO_EVENT; │ │ │ │ │ +typedef union ALLEGRO_EVENT ALLEGRO_EVENT; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An ALLEGRO_EVENT is a union of all builtin event structures, i.e.\ it is │ │ │ │ │ an object large enough to hold the data of any event type. │ │ │ │ │ All events have the following fields in common: │ │ │ │ │ .TP │ │ │ │ │ type (ALLEGRO_EVENT_TYPE) │ │ │ ├── ./usr/share/man/man3/ALLEGRO_EVENT_QUEUE.3alleg5.gz │ │ │ │ ├── ALLEGRO_EVENT_QUEUE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_EVENT_QUEUE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_EVENT_QUEUE ALLEGRO_EVENT_QUEUE; │ │ │ │ │ +typedef struct ALLEGRO_EVENT_QUEUE ALLEGRO_EVENT_QUEUE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An event queue holds events that have been generated by event sources │ │ │ │ │ that are registered with the queue. │ │ │ │ │ Events are stored in the order they are generated. │ │ │ │ │ Access is in a strictly FIFO (first\-in\-first\-out) order. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/ALLEGRO_EVENT_SOURCE.3alleg5.gz │ │ │ │ ├── ALLEGRO_EVENT_SOURCE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_EVENT_SOURCE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_EVENT_SOURCE ALLEGRO_EVENT_SOURCE; │ │ │ │ │ +typedef struct ALLEGRO_EVENT_SOURCE ALLEGRO_EVENT_SOURCE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An event source is any object which can generate events. │ │ │ │ │ For example, an ALLEGRO_DISPLAY can generate events, and you can get the │ │ │ │ │ ALLEGRO_EVENT_SOURCE pointer from an ALLEGRO_DISPLAY with │ │ │ │ │ al_get_display_event_source(3alleg5). │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/ALLEGRO_EVENT_TYPE.3alleg5.gz │ │ │ │ ├── ALLEGRO_EVENT_TYPE.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ ALLEGRO_EVENT_TYPE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef unsigned int ALLEGRO_EVENT_TYPE; │ │ │ │ │ +typedef unsigned int ALLEGRO_EVENT_TYPE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An integer used to distinguish between different types of events. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_EVENT(3alleg5), ALLEGRO_GET_EVENT_TYPE(3alleg5), │ │ │ │ │ ALLEGRO_EVENT_TYPE_IS_USER(3alleg5) │ │ │ ├── ./usr/share/man/man3/ALLEGRO_EVENT_TYPE_IS_USER.3alleg5.gz │ │ │ │ ├── ALLEGRO_EVENT_TYPE_IS_USER.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ ALLEGRO_EVENT_TYPE_IS_USER \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_EVENT_TYPE_IS_USER(t) ((t) >= 512) │ │ │ │ │ +#define ALLEGRO_EVENT_TYPE_IS_USER(t) ((t) >= 512) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A macro which evaluates to true if the event type is not a builtin event │ │ │ │ │ type, i.e.\ one of those described in ALLEGRO_EVENT_TYPE(3alleg5). │ │ │ ├── ./usr/share/man/man3/ALLEGRO_FILE.3alleg5.gz │ │ │ │ ├── ALLEGRO_FILE.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ ALLEGRO_FILE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_FILE ALLEGRO_FILE; │ │ │ │ │ +typedef struct ALLEGRO_FILE ALLEGRO_FILE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque object representing an open file. │ │ │ │ │ This could be a real file on disk or a virtual file. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_FILECHOOSER.3alleg5.gz │ │ │ │ ├── ALLEGRO_FILECHOOSER.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_FILECHOOSER \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_FILECHOOSER ALLEGRO_FILECHOOSER; │ │ │ │ │ +typedef struct ALLEGRO_FILECHOOSER ALLEGRO_FILECHOOSER; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Opaque handle to a native file dialog. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_FILE_INTERFACE.3alleg5.gz │ │ │ │ ├── ALLEGRO_FILE_INTERFACE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_FILE_INTERFACE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_FILE_INTERFACE │ │ │ │ │ +typedef struct ALLEGRO_FILE_INTERFACE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A structure containing function pointers to handle a type of │ │ │ │ │ \[lq]file\[rq], real or virtual. │ │ │ │ │ See the full discussion in al_set_new_file_interface(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ The fields are: │ │ │ ├── ./usr/share/man/man3/ALLEGRO_FILE_MODE.3alleg5.gz │ │ │ │ ├── ALLEGRO_FILE_MODE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_FILE_MODE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_FILE_MODE │ │ │ │ │ +typedef enum ALLEGRO_FILE_MODE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Filesystem modes/types │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_FILEMODE_READ \- Readable │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_FILEMODE_WRITE \- Writable │ │ │ ├── ./usr/share/man/man3/ALLEGRO_FONT.3alleg5.gz │ │ │ │ ├── ALLEGRO_FONT.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_FONT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_FONT ALLEGRO_FONT; │ │ │ │ │ +typedef struct ALLEGRO_FONT ALLEGRO_FONT; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A handle identifying any kind of font. │ │ │ │ │ Usually you will create it with al_load_font(3alleg5) which supports │ │ │ │ │ loading all kinds of TrueType fonts supported by the FreeType library. │ │ │ │ │ If you instead pass the filename of a bitmap file, it will be loaded │ │ │ │ │ with al_load_bitmap(3alleg5) and a font in Allegro\[cq]s bitmap font │ │ │ ├── ./usr/share/man/man3/ALLEGRO_FOR_EACH_FS_ENTRY_RESULT.3alleg5.gz │ │ │ │ ├── ALLEGRO_FOR_EACH_FS_ENTRY_RESULT.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_FOR_EACH_FS_ENTRY_RESULT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_FOR_EACH_FS_ENTRY_RESULT { │ │ │ │ │ +typedef enum ALLEGRO_FOR_EACH_FS_ENTRY_RESULT { │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return values for the callbacks of al_for_each_fs_entry(3alleg5) and for │ │ │ │ │ that function itself. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_FOR_EACH_FS_ENTRY_ERROR \- An error ocurred. │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_FS_ENTRY.3alleg5.gz │ │ │ │ ├── ALLEGRO_FS_ENTRY.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ ALLEGRO_FS_ENTRY \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_FS_ENTRY ALLEGRO_FS_ENTRY; │ │ │ │ │ +typedef struct ALLEGRO_FS_ENTRY ALLEGRO_FS_ENTRY; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Opaque filesystem entry object. │ │ │ │ │ Represents a file or a directory (check with │ │ │ │ │ al_get_fs_entry_mode(3alleg5)). │ │ │ │ │ There are no user accessible member variables. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_FS_INTERFACE.3alleg5.gz │ │ │ │ ├── ALLEGRO_FS_INTERFACE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_FS_INTERFACE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_FS_INTERFACE ALLEGRO_FS_INTERFACE; │ │ │ │ │ +typedef struct ALLEGRO_FS_INTERFACE ALLEGRO_FS_INTERFACE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ The available functions you can provide for a filesystem. │ │ │ │ │ They are: │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ ALLEGRO_FS_ENTRY * fs_create_entry (const char *path); │ │ │ ├── ./usr/share/man/man3/ALLEGRO_GET_EVENT_TYPE.3alleg5.gz │ │ │ │ ├── ALLEGRO_GET_EVENT_TYPE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_GET_EVENT_TYPE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_GET_EVENT_TYPE(a, b, c, d) AL_ID(a, b, c, d) │ │ │ │ │ +#define ALLEGRO_GET_EVENT_TYPE(a, b, c, d) AL_ID(a, b, c, d) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Make an event type identifier, which is a 32\-bit integer. │ │ │ │ │ Usually, but not necessarily, this will be made from four 8\-bit │ │ │ │ │ character codes, for example: │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ ├── ./usr/share/man/man3/ALLEGRO_GLYPH.3alleg5.gz │ │ │ │ ├── ALLEGRO_GLYPH.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_GLYPH \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_GLYPH ALLEGRO_GLYPH; │ │ │ │ │ +typedef struct ALLEGRO_GLYPH ALLEGRO_GLYPH; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A structure containing the properties of a character in a font. │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ typedef struct ALLEGRO_GLYPH { │ │ │ │ │ ALLEGRO_BITMAP *bitmap; // the bitmap the character is on │ │ │ ├── ./usr/share/man/man3/ALLEGRO_HAPTIC.3alleg5.gz │ │ │ │ ├── ALLEGRO_HAPTIC.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_HAPTIC \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_HAPTIC ALLEGRO_HAPTIC; │ │ │ │ │ +typedef struct ALLEGRO_HAPTIC ALLEGRO_HAPTIC; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This is an abstract data type representing a haptic device that supports │ │ │ │ │ force feedback or vibration. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.8 │ │ │ │ │ .RS │ │ │ ├── ./usr/share/man/man3/ALLEGRO_HAPTIC_CONSTANTS.3alleg5.gz │ │ │ │ ├── ALLEGRO_HAPTIC_CONSTANTS.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_HAPTIC_CONSTANTS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_HAPTIC_CONSTANTS │ │ │ │ │ +enum ALLEGRO_HAPTIC_CONSTANTS │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This enum contains flags that are used to define haptic effects and │ │ │ │ │ capabilities. │ │ │ │ │ If the flag is set in the return value of │ │ │ │ │ al_get_haptic_capabilities(3alleg5), it means the device supports the │ │ │ │ │ given effect. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_HAPTIC_EFFECT.3alleg5.gz │ │ │ │ ├── ALLEGRO_HAPTIC_EFFECT.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_HAPTIC_EFFECT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ struct ALLEGRO_HAPTIC_EFFECT │ │ │ │ │ +struct ALLEGRO_HAPTIC_EFFECT │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This struct models a particular haptic or vibration effect. │ │ │ │ │ It needs to be filled in correctly and uploaded to a haptic device │ │ │ │ │ before the device can play it back. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Fields:\f[R] │ │ │ ├── ./usr/share/man/man3/ALLEGRO_HAPTIC_EFFECT_ID.3alleg5.gz │ │ │ │ ├── ALLEGRO_HAPTIC_EFFECT_ID.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_HAPTIC_EFFECT_ID \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_HAPTIC_EFFECT_ID ALLEGRO_HAPTIC_EFFECT_ID; │ │ │ │ │ +typedef struct ALLEGRO_HAPTIC_EFFECT_ID ALLEGRO_HAPTIC_EFFECT_ID; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This struct is used as a handle to control playback of a haptic effect │ │ │ │ │ and should be considered opaque. │ │ │ │ │ Its implementation is visible merely to allow allocation by the users of │ │ │ │ │ the Allegro library. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/ALLEGRO_INDEX_BUFFER.3alleg5.gz │ │ │ │ ├── ALLEGRO_INDEX_BUFFER.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_INDEX_BUFFER \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_INDEX_BUFFER ALLEGRO_INDEX_BUFFER; │ │ │ │ │ +typedef struct ALLEGRO_INDEX_BUFFER ALLEGRO_INDEX_BUFFER; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A GPU index buffer that you can use to store indices of vertices in a │ │ │ │ │ vertex buffer on the GPU instead of uploading them afresh during every │ │ │ │ │ drawing operation. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.8 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_JOYFLAGS.3alleg5.gz │ │ │ │ ├── ALLEGRO_JOYFLAGS.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_JOYFLAGS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_JOYFLAGS │ │ │ │ │ +enum ALLEGRO_JOYFLAGS │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_JOYFLAG_DIGITAL \- the stick provides digital input │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_JOYFLAG_ANALOGUE \- the stick provides analogue input │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/ALLEGRO_JOYSTICK.3alleg5.gz │ │ │ │ ├── ALLEGRO_JOYSTICK.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ ALLEGRO_JOYSTICK \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_JOYSTICK ALLEGRO_JOYSTICK; │ │ │ │ │ +typedef struct ALLEGRO_JOYSTICK ALLEGRO_JOYSTICK; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This is an abstract data type representing a physical joystick. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_joystick(3alleg5) │ │ │ ├── ./usr/share/man/man3/ALLEGRO_JOYSTICK_STATE.3alleg5.gz │ │ │ │ ├── ALLEGRO_JOYSTICK_STATE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_JOYSTICK_STATE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_JOYSTICK_STATE ALLEGRO_JOYSTICK_STATE; │ │ │ │ │ +typedef struct ALLEGRO_JOYSTICK_STATE ALLEGRO_JOYSTICK_STATE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This is a structure that is used to hold a \[lq]snapshot\[rq] of a │ │ │ │ │ joystick\[cq]s axes and buttons at a particular instant. │ │ │ │ │ All fields public and read\-only. │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ ├── ./usr/share/man/man3/ALLEGRO_KEYBOARD_STATE.3alleg5.gz │ │ │ │ ├── ALLEGRO_KEYBOARD_STATE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_KEYBOARD_STATE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_KEYBOARD_STATE ALLEGRO_KEYBOARD_STATE; │ │ │ │ │ +typedef struct ALLEGRO_KEYBOARD_STATE ALLEGRO_KEYBOARD_STATE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This is a structure that is used to hold a \[lq]snapshot\[rq] of a │ │ │ │ │ keyboard\[cq]s state at a particular instant. │ │ │ │ │ It contains the following publically readable fields: │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ display \- points to the display that had keyboard focus at the time the │ │ │ ├── ./usr/share/man/man3/ALLEGRO_LINE_CAP.3alleg5.gz │ │ │ │ ├── ALLEGRO_LINE_CAP.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_LINE_CAP \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_LINE_CAP │ │ │ │ │ +typedef enum ALLEGRO_LINE_CAP │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_LINE_CAP_NONE │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_LINE_CAP_SQUARE │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_LINE_JOIN.3alleg5.gz │ │ │ │ ├── ALLEGRO_LINE_JOIN.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_LINE_JOIN \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_LINE_JOIN │ │ │ │ │ +typedef enum ALLEGRO_LINE_JOIN │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_LINE_JOIN_NONE │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_LINE_JOIN_BEVEL │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_LOCKED_REGION.3alleg5.gz │ │ │ │ ├── ALLEGRO_LOCKED_REGION.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_LOCKED_REGION \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_LOCKED_REGION ALLEGRO_LOCKED_REGION; │ │ │ │ │ +typedef struct ALLEGRO_LOCKED_REGION ALLEGRO_LOCKED_REGION; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Users who wish to manually edit or read from a bitmap are required to │ │ │ │ │ lock it first. │ │ │ │ │ The ALLEGRO_LOCKED_REGION structure represents the locked region of the │ │ │ │ │ bitmap. │ │ │ │ │ This call will work with any bitmap, including memory bitmaps. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MEMORY_INTERFACE.3alleg5.gz │ │ │ │ ├── ALLEGRO_MEMORY_INTERFACE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_MEMORY_INTERFACE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_MEMORY_INTERFACE ALLEGRO_MEMORY_INTERFACE; │ │ │ │ │ +typedef struct ALLEGRO_MEMORY_INTERFACE ALLEGRO_MEMORY_INTERFACE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This structure has the following fields. │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ void *(*mi_malloc)(size_t n, int line, const char *file, const char *func); │ │ │ │ │ void (*mi_free)(void *ptr, int line, const char *file, const char *func); │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MENU.3alleg5.gz │ │ │ │ ├── ALLEGRO_MENU.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ ALLEGRO_MENU \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_MENU ALLEGRO_MENU; │ │ │ │ │ +typedef struct ALLEGRO_MENU ALLEGRO_MENU; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque data type that represents a menu that contains menu items. │ │ │ │ │ Each of the menu items may optionally include a sub\-menu. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MENU_INFO.3alleg5.gz │ │ │ │ ├── ALLEGRO_MENU_INFO.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_MENU_INFO \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_MENU_INFO { │ │ │ │ │ +typedef struct ALLEGRO_MENU_INFO { │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A structure that defines how to create a complete menu system. │ │ │ │ │ For standard menu items, the following format is used: │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ { caption, id, flags, icon } │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MIXER.3alleg5.gz │ │ │ │ ├── ALLEGRO_MIXER.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_MIXER \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_MIXER ALLEGRO_MIXER; │ │ │ │ │ +typedef struct ALLEGRO_MIXER ALLEGRO_MIXER; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A mixer mixes together attached streams into a single buffer. │ │ │ │ │ In the process, it converts channel configurations, sample frequencies │ │ │ │ │ and audio depths of the attached sample instances and audio streams │ │ │ │ │ accordingly. │ │ │ │ │ You can control the quality of this conversion using │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MIXER_QUALITY.3alleg5.gz │ │ │ │ ├── ALLEGRO_MIXER_QUALITY.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_MIXER_QUALITY \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_MIXER_QUALITY │ │ │ │ │ +enum ALLEGRO_MIXER_QUALITY │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_MIXER_QUALITY_POINT \- point sampling │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_MIXER_QUALITY_LINEAR \- linear interpolation │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MONITOR_INFO.3alleg5.gz │ │ │ │ ├── ALLEGRO_MONITOR_INFO.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_MONITOR_INFO \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_MONITOR_INFO │ │ │ │ │ +typedef struct ALLEGRO_MONITOR_INFO │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Describes a monitor\[cq]s size and position relative to other monitors. │ │ │ │ │ x1, y1 will be 0, 0 on the primary display. │ │ │ │ │ Other monitors can have negative values if they are to the left or above │ │ │ │ │ the primary display. │ │ │ │ │ x2, y2 are the coordinates one beyond the bottom right pixel, so that │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MOUSE_EMULATION_MODE.3alleg5.gz │ │ │ │ ├── ALLEGRO_MOUSE_EMULATION_MODE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_MOUSE_EMULATION_MODE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_MOUSE_EMULATION_MODE │ │ │ │ │ +typedef enum ALLEGRO_MOUSE_EMULATION_MODE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Type of mouse emulation to apply. │ │ │ │ │ .TP │ │ │ │ │ ALLEGRO_MOUSE_EMULATION_NONE │ │ │ │ │ Disables mouse emulation. │ │ │ │ │ .TP │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MOUSE_STATE.3alleg5.gz │ │ │ │ ├── ALLEGRO_MOUSE_STATE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_MOUSE_STATE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_MOUSE_STATE ALLEGRO_MOUSE_STATE; │ │ │ │ │ +typedef struct ALLEGRO_MOUSE_STATE ALLEGRO_MOUSE_STATE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Public fields (read only): │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ x \- mouse x position │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ y \- mouse y position │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MSECS_TO_SECS.3alleg5.gz │ │ │ │ ├── ALLEGRO_MSECS_TO_SECS.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_MSECS_TO_SECS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_MSECS_TO_SECS(x) ((x) / 1000.0) │ │ │ │ │ +#define ALLEGRO_MSECS_TO_SECS(x) ((x) / 1000.0) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert milliseconds to seconds. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_MUTEX.3alleg5.gz │ │ │ │ ├── ALLEGRO_MUTEX.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_MUTEX \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_MUTEX ALLEGRO_MUTEX; │ │ │ │ │ +typedef struct ALLEGRO_MUTEX ALLEGRO_MUTEX; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque structure representing a mutex. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE.3alleg5.gz │ │ │ │ ├── ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE 255 │ │ │ │ │ +#define ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE 255 │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This is the maximum size of the title that can be set with │ │ │ │ │ al_set_new_window_title(3alleg5). │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_new_window_title(3alleg5) │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/ALLEGRO_PI.3alleg5.gz │ │ │ │ ├── ALLEGRO_PI.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ ALLEGRO_PI \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_PI 3.14159265358979323846 │ │ │ │ │ +#define ALLEGRO_PI 3.14159265358979323846 │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ C99 compilers have no predefined value like M_PI for the constant π, but │ │ │ │ │ you can use this one instead. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_PIXEL_FORMAT.3alleg5.gz │ │ │ │ ├── ALLEGRO_PIXEL_FORMAT.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_PIXEL_FORMAT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_PIXEL_FORMAT │ │ │ │ │ +typedef enum ALLEGRO_PIXEL_FORMAT │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Pixel formats. │ │ │ │ │ Each pixel format specifies the exact size and bit layout of a pixel in │ │ │ │ │ memory. │ │ │ │ │ Components are specified from high bits to low bits, so for example a │ │ │ │ │ fully opaque red pixel in ARGB_8888 format is 0xFFFF0000. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_PLAYMODE.3alleg5.gz │ │ │ │ ├── ALLEGRO_PLAYMODE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_PLAYMODE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_PLAYMODE │ │ │ │ │ +enum ALLEGRO_PLAYMODE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sample and stream playback mode. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_PLAYMODE_ONCE \- the sample/stream is played from start to │ │ │ │ │ finish an then it stops. │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_PRIM_ATTR.3alleg5.gz │ │ │ │ ├── ALLEGRO_PRIM_ATTR.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_PRIM_ATTR \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_PRIM_ATTR │ │ │ │ │ +typedef enum ALLEGRO_PRIM_ATTR │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Enumerates the types of vertex attributes that a custom vertex may have. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_PRIM_POSITION \- Position information, can be stored only in │ │ │ │ │ ALLEGRO_PRIM_SHORT_2, ALLEGRO_PRIM_FLOAT_2 and ALLEGRO_PRIM_FLOAT_3. │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_PRIM_BUFFER_FLAGS.3alleg5.gz │ │ │ │ ├── ALLEGRO_PRIM_BUFFER_FLAGS.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_PRIM_BUFFER_FLAGS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_PRIM_BUFFER_FLAGS │ │ │ │ │ +typedef enum ALLEGRO_PRIM_BUFFER_FLAGS │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Flags to specify how to create a vertex or an index buffer. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_PRIM_BUFFER_STREAM \- Hints to the driver that the buffer is │ │ │ │ │ written to often, but used only a few times per frame │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_PRIM_QUALITY.3alleg5.gz │ │ │ │ ├── ALLEGRO_PRIM_QUALITY.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_PRIM_QUALITY \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_PRIM_QUALITY 10 │ │ │ │ │ +#define ALLEGRO_PRIM_QUALITY 10 │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Controls the quality of the approximation of curved primitives │ │ │ │ │ (e.g.\ circles). │ │ │ │ │ Curved primitives are drawn by approximating them with a sequence of │ │ │ │ │ line segments. │ │ │ │ │ By default, this roughly corresponds to error of less than half of a │ │ │ ├── ./usr/share/man/man3/ALLEGRO_PRIM_STORAGE.3alleg5.gz │ │ │ │ ├── ALLEGRO_PRIM_STORAGE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_PRIM_STORAGE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_PRIM_STORAGE │ │ │ │ │ +typedef enum ALLEGRO_PRIM_STORAGE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Enumerates the types of storage an attribute of a custom vertex may be │ │ │ │ │ stored in. │ │ │ │ │ Many of these can only be used for ALLEGRO_PRIM_USER_ATTR attributes and │ │ │ │ │ can only be accessed via shaders. │ │ │ │ │ Usually no matter what the storage is specified the attribute gets │ │ │ ├── ./usr/share/man/man3/ALLEGRO_PRIM_TYPE.3alleg5.gz │ │ │ │ ├── ALLEGRO_PRIM_TYPE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_PRIM_TYPE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_PRIM_TYPE │ │ │ │ │ +typedef enum ALLEGRO_PRIM_TYPE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Enumerates the types of primitives this addon can draw. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_PRIM_POINT_LIST \- A list of points, each vertex defines a point │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_PRIM_LINE_LIST \- A list of lines, sequential pairs of vertices │ │ │ ├── ./usr/share/man/man3/ALLEGRO_RENDER_FUNCTION.3alleg5.gz │ │ │ │ ├── ALLEGRO_RENDER_FUNCTION.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_RENDER_FUNCTION \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_RENDER_FUNCTION { │ │ │ │ │ +typedef enum ALLEGRO_RENDER_FUNCTION { │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Possible functions are: │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_RENDER_NEVER │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_RENDER_ALWAYS │ │ │ ├── ./usr/share/man/man3/ALLEGRO_RENDER_STATE.3alleg5.gz │ │ │ │ ├── ALLEGRO_RENDER_STATE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_RENDER_STATE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_RENDER_STATE { │ │ │ │ │ +typedef enum ALLEGRO_RENDER_STATE { │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Possible render states which can be set with │ │ │ │ │ al_set_render_state(3alleg5): │ │ │ │ │ .TP │ │ │ │ │ ALLEGRO_ALPHA_TEST │ │ │ │ │ If this is set to 1, the values of ALLEGRO_ALPHA_FUNCTION and │ │ │ ├── ./usr/share/man/man3/ALLEGRO_SAMPLE.3alleg5.gz │ │ │ │ ├── ALLEGRO_SAMPLE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_SAMPLE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE; │ │ │ │ │ +typedef struct ALLEGRO_SAMPLE ALLEGRO_SAMPLE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An ALLEGRO_SAMPLE object stores the data necessary for playing │ │ │ │ │ pre\-defined digital audio. │ │ │ │ │ It holds a user\-specified PCM data buffer and information about its │ │ │ │ │ format (data length, depth, frequency, channel configuration). │ │ │ │ │ You can have the same ALLEGRO_SAMPLE playing multiple times │ │ │ ├── ./usr/share/man/man3/ALLEGRO_SAMPLE_ID.3alleg5.gz │ │ │ │ ├── ALLEGRO_SAMPLE_ID.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_SAMPLE_ID \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID; │ │ │ │ │ +typedef struct ALLEGRO_SAMPLE_ID ALLEGRO_SAMPLE_ID; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An ALLEGRO_SAMPLE_ID represents a sample being played via │ │ │ │ │ al_play_sample(3alleg5). │ │ │ │ │ It can be used to later stop the sample with al_stop_sample(3alleg5). │ │ │ │ │ The underlying ALLEGRO_SAMPLE_INSTANCE can be extracted using │ │ │ │ │ al_lock_sample_id(3alleg5). │ │ │ ├── ./usr/share/man/man3/ALLEGRO_SAMPLE_INSTANCE.3alleg5.gz │ │ │ │ ├── ALLEGRO_SAMPLE_INSTANCE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_SAMPLE_INSTANCE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE; │ │ │ │ │ +typedef struct ALLEGRO_SAMPLE_INSTANCE ALLEGRO_SAMPLE_INSTANCE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An ALLEGRO_SAMPLE_INSTANCE object represents a playable instance of a │ │ │ │ │ predefined sound effect. │ │ │ │ │ It holds information about how the effect should be played: These │ │ │ │ │ playback parameters consist of the looping mode, loop start/end points, │ │ │ │ │ playing position, speed, gain, pan and the playmode. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_SEEK.3alleg5.gz │ │ │ │ ├── ALLEGRO_SEEK.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_SEEK \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_SEEK │ │ │ │ │ +typedef enum ALLEGRO_SEEK │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_SEEK_SET \- seek relative to beginning of file │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_SEEK_CUR \- seek relative to current file position │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_SHADER.3alleg5.gz │ │ │ │ ├── ALLEGRO_SHADER.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_SHADER \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_SHADER ALLEGRO_SHADER; │ │ │ │ │ +typedef struct ALLEGRO_SHADER ALLEGRO_SHADER; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An ALLEGRO_SHADER(3alleg5) is a program that runs on the GPU. │ │ │ │ │ It combines both a vertex and a pixel shader. │ │ │ │ │ (In OpenGL terms, an ALLEGRO_SHADER(3alleg5) is actually a │ │ │ │ │ \f[I]program\f[R] which has one or more \f[I]shaders\f[R] attached. │ │ │ │ │ This can be confusing.) │ │ │ ├── ./usr/share/man/man3/ALLEGRO_SHADER_PLATFORM.3alleg5.gz │ │ │ │ ├── ALLEGRO_SHADER_PLATFORM.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_SHADER_PLATFORM \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_SHADER_PLATFORM ALLEGRO_SHADER_PLATFORM; │ │ │ │ │ +typedef enum ALLEGRO_SHADER_PLATFORM ALLEGRO_SHADER_PLATFORM; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ The underlying platform which the ALLEGRO_SHADER(3alleg5) is built on │ │ │ │ │ top of, which dictates the language used to program the shader. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_SHADER_AUTO \- Pick a platform automatically given the current │ │ │ │ │ display flags. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_SHADER_TYPE.3alleg5.gz │ │ │ │ ├── ALLEGRO_SHADER_TYPE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_SHADER_TYPE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_SHADER_TYPE ALLEGRO_SHADER_TYPE; │ │ │ │ │ +typedef enum ALLEGRO_SHADER_TYPE ALLEGRO_SHADER_TYPE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Used with al_attach_shader_source(3alleg5) and │ │ │ │ │ al_attach_shader_source_file(3alleg5) to specify how to interpret the │ │ │ │ │ attached source. │ │ │ │ │ .TP │ │ │ │ │ ALLEGRO_VERTEX_SHADER │ │ │ ├── ./usr/share/man/man3/ALLEGRO_STATE.3alleg5.gz │ │ │ │ ├── ALLEGRO_STATE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_STATE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_STATE ALLEGRO_STATE; │ │ │ │ │ +typedef struct ALLEGRO_STATE ALLEGRO_STATE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Opaque type which is passed to │ │ │ │ │ al_store_state(3alleg5)/al_restore_state(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ The various state kept internally by Allegro can be displayed like this: │ │ │ │ │ .IP │ │ │ ├── ./usr/share/man/man3/ALLEGRO_STATE_FLAGS.3alleg5.gz │ │ │ │ ├── ALLEGRO_STATE_FLAGS.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ ALLEGRO_STATE_FLAGS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_STATE_FLAGS │ │ │ │ │ +typedef enum ALLEGRO_STATE_FLAGS │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Flags which can be passed to │ │ │ │ │ al_store_state(3alleg5)/al_restore_state(3alleg5) as bit combinations. │ │ │ │ │ See al_store_state(3alleg5) for the list of flags. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_SYSTEM_ID.3alleg5.gz │ │ │ │ ├── ALLEGRO_SYSTEM_ID.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_SYSTEM_ID \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_SYSTEM_ID { │ │ │ │ │ +enum ALLEGRO_SYSTEM_ID { │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ The system Allegro is running on. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_SYSTEM_ID_UNKNOWN \- Unknown system. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_SYSTEM_ID_XGLX \- Xglx │ │ │ ├── ./usr/share/man/man3/ALLEGRO_TEXTLOG.3alleg5.gz │ │ │ │ ├── ALLEGRO_TEXTLOG.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_TEXTLOG \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_TEXTLOG ALLEGRO_TEXTLOG; │ │ │ │ │ +typedef struct ALLEGRO_TEXTLOG ALLEGRO_TEXTLOG; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Opaque handle to a text log window. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_THREAD.3alleg5.gz │ │ │ │ ├── ALLEGRO_THREAD.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_THREAD \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_THREAD ALLEGRO_THREAD; │ │ │ │ │ +typedef struct ALLEGRO_THREAD ALLEGRO_THREAD; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque structure representing a thread. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_TIMER.3alleg5.gz │ │ │ │ ├── ALLEGRO_TIMER.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_TIMER \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_TIMER ALLEGRO_TIMER; │ │ │ │ │ +typedef struct ALLEGRO_TIMER ALLEGRO_TIMER; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This is an abstract data type representing a timer object. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT.3alleg5.gz │ │ │ │ ├── ALLEGRO_TOUCH_INPUT.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ ALLEGRO_TOUCH_INPUT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_TOUCH_INPUT ALLEGRO_TOUCH_INPUT; │ │ │ │ │ +typedef struct ALLEGRO_TOUCH_INPUT ALLEGRO_TOUCH_INPUT; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An abstract data type representing a physical touch screen or touch pad. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT.3alleg5.gz │ │ │ │ ├── ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT 16 │ │ │ │ │ +#define ALLEGRO_TOUCH_INPUT_MAX_TOUCH_COUNT 16 │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ The maximum amount of simultaneous touches that can be detected. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_TOUCH_INPUT_STATE.3alleg5.gz │ │ │ │ ├── ALLEGRO_TOUCH_INPUT_STATE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_TOUCH_INPUT_STATE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_TOUCH_INPUT_STATE ALLEGRO_TOUCH_INPUT_STATE; │ │ │ │ │ +typedef struct ALLEGRO_TOUCH_INPUT_STATE ALLEGRO_TOUCH_INPUT_STATE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This is a structure that holds a snapshot of all simultaneous touches at │ │ │ │ │ a particular instant. │ │ │ │ │ .PP │ │ │ │ │ Public fields (read only): │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_TOUCH_STATE.3alleg5.gz │ │ │ │ ├── ALLEGRO_TOUCH_STATE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_TOUCH_STATE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_TOUCH_STATE ALLEGRO_TOUCH_STATE; │ │ │ │ │ +typedef struct ALLEGRO_TOUCH_STATE ALLEGRO_TOUCH_STATE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This is a structure that is used to hold a \[lq]snapshot\[rq] of a touch │ │ │ │ │ at a particular instant. │ │ │ │ │ .PP │ │ │ │ │ Public fields (read only): │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_TRANSFORM.3alleg5.gz │ │ │ │ ├── ALLEGRO_TRANSFORM.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_TRANSFORM \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_TRANSFORM ALLEGRO_TRANSFORM; │ │ │ │ │ +typedef struct ALLEGRO_TRANSFORM ALLEGRO_TRANSFORM; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Defines the generic transformation type, a 4x4 matrix. │ │ │ │ │ 2D transforms use only a small subsection of this matrix, namely the top │ │ │ │ │ left 2x2 matrix, and the right most 2x1 matrix, for a total of 6 values. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Fields:\f[R] │ │ │ ├── ./usr/share/man/man3/ALLEGRO_USECS_TO_SECS.3alleg5.gz │ │ │ │ ├── ALLEGRO_USECS_TO_SECS.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ ALLEGRO_USECS_TO_SECS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_USECS_TO_SECS(x) ((x) / 1000000.0) │ │ │ │ │ +#define ALLEGRO_USECS_TO_SECS(x) ((x) / 1000000.0) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert microseconds to seconds. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_USER_EVENT.3alleg5.gz │ │ │ │ ├── ALLEGRO_USER_EVENT.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_USER_EVENT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_USER_EVENT ALLEGRO_USER_EVENT; │ │ │ │ │ +typedef struct ALLEGRO_USER_EVENT ALLEGRO_USER_EVENT; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An event structure that can be emitted by user event sources. │ │ │ │ │ These are the public fields: │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_EVENT_SOURCE *source; │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_USTR.3alleg5.gz │ │ │ │ ├── ALLEGRO_USTR.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ ALLEGRO_USTR \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct _al_tagbstring ALLEGRO_USTR; │ │ │ │ │ +typedef struct _al_tagbstring ALLEGRO_USTR; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ An opaque type representing a string. │ │ │ │ │ ALLEGRO_USTRs normally contain UTF\-8 encoded strings, but they may be │ │ │ │ │ used to hold any byte sequences, including NULs. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_USTR_INFO.3alleg5.gz │ │ │ │ ├── ALLEGRO_USTR_INFO.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_USTR_INFO \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct _al_tagbstring ALLEGRO_USTR_INFO; │ │ │ │ │ +typedef struct _al_tagbstring ALLEGRO_USTR_INFO; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A type that holds additional information for an ALLEGRO_USTR(3alleg5) │ │ │ │ │ that references an external memory buffer. │ │ │ │ │ You can convert it back to ALLEGRO_USTR(3alleg5) via │ │ │ │ │ al_ref_info(3alleg5). │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/ALLEGRO_VERTEX.3alleg5.gz │ │ │ │ ├── ALLEGRO_VERTEX.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_VERTEX \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_VERTEX ALLEGRO_VERTEX; │ │ │ │ │ +typedef struct ALLEGRO_VERTEX ALLEGRO_VERTEX; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Defines the generic vertex type, with a 3D position, color and texture │ │ │ │ │ coordinates for a single texture. │ │ │ │ │ Note that at this time, the software driver for this addon cannot render │ │ │ │ │ 3D primitives. │ │ │ │ │ If you want a 2D only primitive, set z to 0. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_VERTEX_BUFFER.3alleg5.gz │ │ │ │ ├── ALLEGRO_VERTEX_BUFFER.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_VERTEX_BUFFER \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_VERTEX_BUFFER ALLEGRO_VERTEX_BUFFER; │ │ │ │ │ +typedef struct ALLEGRO_VERTEX_BUFFER ALLEGRO_VERTEX_BUFFER; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A GPU vertex buffer that you can use to store vertices on the GPU │ │ │ │ │ instead of uploading them afresh during every drawing operation. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.3 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/ALLEGRO_VERTEX_CACHE_SIZE.3alleg5.gz │ │ │ │ ├── ALLEGRO_VERTEX_CACHE_SIZE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_VERTEX_CACHE_SIZE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define ALLEGRO_VERTEX_CACHE_SIZE 256 │ │ │ │ │ +#define ALLEGRO_VERTEX_CACHE_SIZE 256 │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Defines the size of the transformation vertex cache for the software │ │ │ │ │ renderer. │ │ │ │ │ If you pass less than this many vertices to the primitive rendering │ │ │ │ │ functions you will get a speed boost. │ │ │ │ │ This also defines the size of the cache vertex buffer, used for the │ │ │ ├── ./usr/share/man/man3/ALLEGRO_VERTEX_DECL.3alleg5.gz │ │ │ │ ├── ALLEGRO_VERTEX_DECL.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_VERTEX_DECL \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_VERTEX_DECL ALLEGRO_VERTEX_DECL; │ │ │ │ │ +typedef struct ALLEGRO_VERTEX_DECL ALLEGRO_VERTEX_DECL; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A vertex declaration. │ │ │ │ │ This opaque structure is responsible for describing the format and │ │ │ │ │ layout of a user defined custom vertex. │ │ │ │ │ It is created and destroyed by specialized functions. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/ALLEGRO_VERTEX_ELEMENT.3alleg5.gz │ │ │ │ ├── ALLEGRO_VERTEX_ELEMENT.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_VERTEX_ELEMENT \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_VERTEX_ELEMENT ALLEGRO_VERTEX_ELEMENT; │ │ │ │ │ +typedef struct ALLEGRO_VERTEX_ELEMENT ALLEGRO_VERTEX_ELEMENT; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A small structure describing a certain element of a vertex. │ │ │ │ │ E.g. │ │ │ │ │ the position of the vertex, or its color. │ │ │ │ │ These structures are used by the al_create_vertex_decl(3alleg5) function │ │ │ │ │ to create the vertex declaration. │ │ │ ├── ./usr/share/man/man3/ALLEGRO_VIDEO_EVENT_TYPE.3alleg5.gz │ │ │ │ ├── ALLEGRO_VIDEO_EVENT_TYPE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_VIDEO_EVENT_TYPE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ enum ALLEGRO_VIDEO_EVENT_TYPE │ │ │ │ │ +enum ALLEGRO_VIDEO_EVENT_TYPE │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Events sent by al_get_video_event_source(3alleg5). │ │ │ │ │ .SS ALLEGRO_EVENT_VIDEO_FRAME_SHOW │ │ │ │ │ This event is sent when it is time to show a new frame. │ │ │ │ │ Once you receive this event, you can draw the current frame (as returned │ │ │ │ │ by al_get_video_frame(3alleg5)). │ │ │ ├── ./usr/share/man/man3/ALLEGRO_VIDEO_POSITION_TYPE.3alleg5.gz │ │ │ │ ├── ALLEGRO_VIDEO_POSITION_TYPE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_VIDEO_POSITION_TYPE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_VIDEO_POSITION_TYPE ALLEGRO_VIDEO_POSITION_TYPE; │ │ │ │ │ +typedef enum ALLEGRO_VIDEO_POSITION_TYPE ALLEGRO_VIDEO_POSITION_TYPE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Used with al_get_video_position(3alleg5) to specify which position to │ │ │ │ │ retrieve. │ │ │ │ │ If these get out of sync, audio and video may be out of sync in the │ │ │ │ │ display of the video. │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/ALLEGRO_VOICE.3alleg5.gz │ │ │ │ ├── ALLEGRO_VOICE.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_VOICE \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef struct ALLEGRO_VOICE ALLEGRO_VOICE; │ │ │ │ │ +typedef struct ALLEGRO_VOICE ALLEGRO_VOICE; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A voice represents an audio device on the system, which may be a real │ │ │ │ │ device, or an abstract device provided by the operating system. │ │ │ │ │ To play back audio, you would attach a mixer, sample instance or audio │ │ │ │ │ stream to a voice. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/ALLEGRO_WRITE_MASK_FLAGS.3alleg5.gz │ │ │ │ ├── ALLEGRO_WRITE_MASK_FLAGS.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ ALLEGRO_WRITE_MASK_FLAGS \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef enum ALLEGRO_WRITE_MASK_FLAGS { │ │ │ │ │ +typedef enum ALLEGRO_WRITE_MASK_FLAGS { │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Each enabled bit means the corresponding value is written, a disabled │ │ │ │ │ bit means it is not. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ ALLEGRO_MASK_RED │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/al_append_menu_item.3alleg5.gz │ │ │ │ ├── al_append_menu_item.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_append_menu_item(ALLEGRO_MENU *parent, char const *title, uint16_t id, │ │ │ │ │ int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ │ +int al_append_menu_item(ALLEGRO_MENU *parent, char const *title, uint16_t id, │ │ │ │ │ + int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Appends a menu item to the end of the menu. │ │ │ │ │ See al_insert_menu_item(3alleg5) for more information. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_append_native_text_log.3alleg5.gz │ │ │ │ ├── al_append_native_text_log.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_append_native_text_log(ALLEGRO_TEXTLOG *textlog, │ │ │ │ │ char const *format, ...) │ │ │ │ │ +void al_append_native_text_log(ALLEGRO_TEXTLOG *textlog, │ │ │ │ │ + char const *format, ...) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Appends a line of text to the message log window and scrolls to the │ │ │ │ │ bottom (if the line would not be visible otherwise). │ │ │ │ │ This works like printf. │ │ │ │ │ A line is continued until you add a newline character. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_attach_audio_stream_to_mixer.3alleg5.gz │ │ │ │ ├── al_attach_audio_stream_to_mixer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_attach_audio_stream_to_mixer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_attach_audio_stream_to_mixer(ALLEGRO_AUDIO_STREAM *stream, ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Attach an audio stream to a mixer. │ │ │ │ │ The stream must not already be attached to anything. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_attach_audio_stream_to_voice.3alleg5.gz │ │ │ │ ├── al_attach_audio_stream_to_voice.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ ALLEGRO_VOICE *voice) │ │ │ │ │ +bool al_attach_audio_stream_to_voice(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ + ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Attaches an audio stream to a voice. │ │ │ │ │ The same rules as al_attach_sample_instance_to_voice(3alleg5) apply. │ │ │ │ │ This may fail if the driver can\[cq]t create a voice with the buffer │ │ │ │ │ count and buffer size the stream uses. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_attach_mixer_to_mixer.3alleg5.gz │ │ │ │ ├── al_attach_mixer_to_mixer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_attach_mixer_to_mixer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_attach_mixer_to_mixer(ALLEGRO_MIXER *stream, ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Attaches the mixer passed as the first argument onto the mixer passed as │ │ │ │ │ the second argument. │ │ │ │ │ The first mixer (that is going to be attached) must not already be │ │ │ │ │ attached to anything. │ │ │ │ │ Both mixers must use the same frequency, audio depth and channel │ │ │ ├── ./usr/share/man/man3/al_attach_mixer_to_voice.3alleg5.gz │ │ │ │ ├── al_attach_mixer_to_voice.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_attach_mixer_to_voice \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice) │ │ │ │ │ +bool al_attach_mixer_to_voice(ALLEGRO_MIXER *mixer, ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Attaches a mixer to a voice. │ │ │ │ │ It must have the same frequency and channel configuration, but the depth │ │ │ │ │ may be different. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ ├── ./usr/share/man/man3/al_attach_sample_instance_to_mixer.3alleg5.gz │ │ │ │ ├── al_attach_sample_instance_to_mixer.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_attach_sample_instance_to_mixer(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Attach a sample instance to a mixer. │ │ │ │ │ The instance must not already be attached to anything. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_attach_sample_instance_to_voice.3alleg5.gz │ │ │ │ ├── al_attach_sample_instance_to_voice.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ ALLEGRO_VOICE *voice) │ │ │ │ │ +bool al_attach_sample_instance_to_voice(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Attaches a sample instance to a voice, and allows it to play. │ │ │ │ │ The instance\[cq]s gain and loop mode will be ignored, and it must have │ │ │ │ │ the same frequency, channel configuration and depth (including │ │ │ │ │ signed\-ness) as the voice. │ │ │ │ │ This function may fail if the selected driver doesn\[cq]t support │ │ │ ├── ./usr/share/man/man3/al_build_menu.3alleg5.gz │ │ │ │ ├── al_build_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_build_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MENU *al_build_menu(ALLEGRO_MENU_INFO *info) │ │ │ │ │ +ALLEGRO_MENU *al_build_menu(ALLEGRO_MENU_INFO *info) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Builds a menu based on the specifications of a sequence of │ │ │ │ │ \f[CR]ALLEGRO_MENU_INFO\f[R] elements. │ │ │ │ │ .PP │ │ │ │ │ Returns a pointer to the root \f[CR]ALLEGRO_MENU\f[R], or │ │ │ │ │ \f[CR]NULL\f[R] on failure. │ │ │ ├── ./usr/share/man/man3/al_calculate_arc.3alleg5.gz │ │ │ │ ├── al_calculate_arc.3alleg5 │ │ │ │ │ @@ -5,14 +5,16 @@ │ │ │ │ │ al_calculate_arc \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_calculate_arc(float* dest, int stride, float cx, float cy, │ │ │ │ │ + int num_points) │ │ │ │ │ +void al_calculate_arc(float* dest, int stride, float cx, float cy, │ │ │ │ │ float rx, float ry, float start_theta, float delta_theta, float thickness, │ │ │ │ │ int num_points) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ When \f[CR]thickness <= 0\f[R] this function computes positions of │ │ │ │ │ \f[CR]num_points\f[R] regularly spaced points on an elliptical arc. │ │ │ │ │ When \f[CR]thickness > 0\f[R] this function computes two sets of points, │ │ │ ├── ./usr/share/man/man3/al_calculate_ribbon.3alleg5.gz │ │ │ │ ├── al_calculate_ribbon.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_calculate_ribbon(float* dest, int dest_stride, const float *points, │ │ │ │ │ int points_stride, float thickness, int num_segments) │ │ │ │ │ +void al_calculate_ribbon(float* dest, int dest_stride, const float *points, │ │ │ │ │ + int points_stride, float thickness, int num_segments) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Calculates a ribbon given an array of points. │ │ │ │ │ The ribbon will go through all of the passed points. │ │ │ │ │ If \f[CR]thickness <= 0\f[R], then \f[CR]num_segments\f[R] of points are │ │ │ │ │ required in the destination buffer, otherwise twice as many are needed. │ │ │ │ │ The destination and the points buffer should consist of regularly spaced │ │ │ ├── ./usr/share/man/man3/al_calculate_spline.3alleg5.gz │ │ │ │ ├── al_calculate_spline.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_calculate_spline(float* dest, int stride, const float points[8], │ │ │ │ │ float thickness, int num_segments) │ │ │ │ │ +void al_calculate_spline(float* dest, int stride, const float points[8], │ │ │ │ │ + float thickness, int num_segments) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Calculates a Bézier spline given 4 control points. │ │ │ │ │ If \f[CR]thickness <= 0\f[R], then \f[CR]num_segments\f[R] of points are │ │ │ │ │ required in the destination, otherwise twice as many are needed. │ │ │ │ │ The destination buffer should consist of regularly spaced (by distance │ │ │ │ │ of stride bytes) doublets of floats, corresponding to x and y │ │ │ ├── ./usr/share/man/man3/al_calloc.3alleg5.gz │ │ │ │ ├── al_calloc.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define al_calloc(c, n) \[rs] │ │ │ │ │ (al_calloc_with_context((c), (n), __LINE__, __FILE__, __func__)) │ │ │ │ │ +#define al_calloc(c, n) \[rs] │ │ │ │ │ + (al_calloc_with_context((c), (n), __LINE__, __FILE__, __func__)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like calloc() in the C standard library, but the implementation may be │ │ │ │ │ overridden. │ │ │ │ │ .PP │ │ │ │ │ This is a macro. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_clone_menu.3alleg5.gz │ │ │ │ ├── al_clone_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_clone_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MENU *al_clone_menu(ALLEGRO_MENU *menu) │ │ │ │ │ +ALLEGRO_MENU *al_clone_menu(ALLEGRO_MENU *menu) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Makes a copy of a menu so that it can be reused on another display. │ │ │ │ │ The menu being cloned can be anything: a regular menu, a popup menu, or │ │ │ │ │ a sub\-menu. │ │ │ │ │ .PP │ │ │ │ │ Returns the cloned menu. │ │ │ ├── ./usr/share/man/man3/al_clone_menu_for_popup.3alleg5.gz │ │ │ │ ├── al_clone_menu_for_popup.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_clone_menu_for_popup \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MENU *al_clone_menu_for_popup(ALLEGRO_MENU *menu) │ │ │ │ │ +ALLEGRO_MENU *al_clone_menu_for_popup(ALLEGRO_MENU *menu) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Exactly like al_clone_menu(3alleg5), except that the copy is for a popup │ │ │ │ │ menu. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_close_native_text_log.3alleg5.gz │ │ │ │ ├── al_close_native_text_log.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_close_native_text_log \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_close_native_text_log(ALLEGRO_TEXTLOG *textlog) │ │ │ │ │ +void al_close_native_text_log(ALLEGRO_TEXTLOG *textlog) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Closes a message log window opened with al_open_native_text_log(3alleg5) │ │ │ │ │ earlier. │ │ │ │ │ .PP │ │ │ │ │ Does nothing if passed NULL. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_close_video.3alleg5.gz │ │ │ │ ├── al_close_video.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_close_video \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_close_video(ALLEGRO_VIDEO *video) │ │ │ │ │ +void al_close_video(ALLEGRO_VIDEO *video) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Closes the video and frees all allocated resources. │ │ │ │ │ The video pointer is invalid after the function returns. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_color_cmyk.3alleg5.gz │ │ │ │ ├── al_color_cmyk.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_color_cmyk \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_cmyk(float c, float m, float y, float k) │ │ │ │ │ +ALLEGRO_COLOR al_color_cmyk(float c, float m, float y, float k) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from CMYK values (cyan, │ │ │ │ │ magenta, yellow, black). │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_cmyk_to_rgb(3alleg5), al_color_rgb_to_cmyk(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_cmyk_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_cmyk_to_rgb.3alleg5 │ │ │ │ │ @@ -6,12 +6,14 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_cmyk_to_rgb(float cyan, float magenta, float yellow, │ │ │ │ │ float key, float *red, float *green, float *blue) │ │ │ │ │ +void al_color_cmyk_to_rgb(float cyan, float magenta, float yellow, │ │ │ │ │ + float key, float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert CMYK values to RGB values. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_cmyk(3alleg5), al_color_rgb_to_cmyk(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_distance_ciede2000.3alleg5.gz │ │ │ │ ├── al_color_distance_ciede2000.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ double al_color_distance_ciede2000(ALLEGRO_COLOR color1, │ │ │ │ │ ALLEGRO_COLOR color2) { │ │ │ │ │ +double al_color_distance_ciede2000(ALLEGRO_COLOR color1, │ │ │ │ │ + ALLEGRO_COLOR color2) { │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This function computes the CIEDE2000 color difference between two RGB │ │ │ │ │ colors. │ │ │ │ │ This is a visually uniform color difference, unlike for example the RGB │ │ │ │ │ distance. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_color_hsl.3alleg5.gz │ │ │ │ ├── al_color_hsl.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_hsl \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_hsl(float h, float s, float l) │ │ │ │ │ +ALLEGRO_COLOR al_color_hsl(float h, float s, float l) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from HSL (hue, saturation, │ │ │ │ │ lightness) values. │ │ │ │ │ .PP │ │ │ │ │ Parameters: │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/al_color_hsl_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_hsl_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_hsl_to_rgb(float hue, float saturation, float lightness, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_hsl_to_rgb(float hue, float saturation, float lightness, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert values in HSL color model to RGB color model. │ │ │ │ │ .PP │ │ │ │ │ Parameters: │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ hue \- Color hue angle in the range 0..360 │ │ │ ├── ./usr/share/man/man3/al_color_hsv.3alleg5.gz │ │ │ │ ├── al_color_hsv.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_hsv \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_hsv(float h, float s, float v) │ │ │ │ │ +ALLEGRO_COLOR al_color_hsv(float h, float s, float v) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from HSV (hue, saturation, │ │ │ │ │ value) values. │ │ │ │ │ .PP │ │ │ │ │ Parameters: │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/al_color_hsv_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_hsv_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_hsv_to_rgb(float hue, float saturation, float value, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_hsv_to_rgb(float hue, float saturation, float value, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert values in HSV color model to RGB color model. │ │ │ │ │ .PP │ │ │ │ │ Parameters: │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ hue \- Color hue angle in the range 0..360 │ │ │ ├── ./usr/share/man/man3/al_color_html.3alleg5.gz │ │ │ │ ├── al_color_html.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_html \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_html(char const *string) │ │ │ │ │ +ALLEGRO_COLOR al_color_html(char const *string) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Interprets an HTML\-style hex number (e.g.\ #00faff) as a color. │ │ │ │ │ The accepted format is the same as al_color_html_to_rgb(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ Returns the interpreted color, or \f[CR]al_map_rgba(0, 0, 0, 0)\f[R] if │ │ │ │ │ the string could not be parsed. │ │ │ ├── ./usr/share/man/man3/al_color_html_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_html_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_color_html_to_rgb(char const *string, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +bool al_color_html_to_rgb(char const *string, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Interprets an HTML\-style hex number (e.g.\ #00faff) as a color. │ │ │ │ │ The only accepted formats are \[lq]#RRGGBB\[rq] and \[lq]RRGGBB\[rq] │ │ │ │ │ where R, G, B are hexadecimal digits [0\-9A\-Fa\-f]. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ ├── ./usr/share/man/man3/al_color_lab.3alleg5.gz │ │ │ │ ├── al_color_lab.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_lab \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_lab(float l, float a, float b) │ │ │ │ │ +ALLEGRO_COLOR al_color_lab(float l, float a, float b) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from CIE L*a*b* values. │ │ │ │ │ The L* component corresponds to luminance from 0..1. │ │ │ │ │ The a* and b* components are in the range \-1..+1. │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_color_lab_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_lab_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_lab_to_rgb(float l, float a, float b, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_lab_to_rgb(float l, float a, float b, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert CIE L*a*b* color values to RGB color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_lab(3alleg5), al_color_rgb_to_lab(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_lch.3alleg5.gz │ │ │ │ ├── al_color_lch.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_lch \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_lch(float l, float c, float h) │ │ │ │ │ +ALLEGRO_COLOR al_color_lch(float l, float c, float h) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from CIE LCH values. │ │ │ │ │ LCH colors are very similar to HSL, with the same meaning of L and H and │ │ │ │ │ C corresponding to S. However LCH is more visually uniform. │ │ │ │ │ Furthermore, this function expects the angle for H in radians and not in │ │ │ │ │ degree. │ │ │ ├── ./usr/share/man/man3/al_color_lch_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_lch_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_lch_to_rgb(float l, float c, float h, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_lch_to_rgb(float l, float c, float h, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert CIE LCH color values to RGB color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_lch(3alleg5), al_color_rgb_to_lch(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_linear.3alleg5.gz │ │ │ │ ├── al_color_linear.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_linear \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_linear(float r, float g, float b) │ │ │ │ │ +ALLEGRO_COLOR al_color_linear(float r, float g, float b) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from linear sRGB values. │ │ │ │ │ Allegro RGB values are assumed to be sRGB. │ │ │ │ │ The sRGB standard is in wide use by various display devices. │ │ │ │ │ It accounts for a standard gamma correction applied to RGB colors before │ │ │ │ │ they get displayed. │ │ │ ├── ./usr/share/man/man3/al_color_linear_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_linear_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_linear_to_rgb(float r, float g, float b, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_linear_to_rgb(float r, float g, float b, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert linear sRGB color values to gamma corrected (i.e.\ normal) RGB │ │ │ │ │ values. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.8 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_color_name.3alleg5.gz │ │ │ │ ├── al_color_name.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_color_name \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_name(char const *name) │ │ │ │ │ +ALLEGRO_COLOR al_color_name(char const *name) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) with the given name. │ │ │ │ │ If the color is not found then black is returned. │ │ │ │ │ .PP │ │ │ │ │ See al_color_name_to_rgb(3alleg5) for the list of names. │ │ │ ├── ./usr/share/man/man3/al_color_name_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_name_to_rgb.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_name_to_rgb \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_color_name_to_rgb(char const *name, float *r, float *g, float *b) │ │ │ │ │ +bool al_color_name_to_rgb(char const *name, float *r, float *g, float *b) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Parameters: │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ name \- The (lowercase) name of the color. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ r, g, b \- If one of the recognized color names below is passed, the │ │ │ ├── ./usr/share/man/man3/al_color_oklab.3alleg5.gz │ │ │ │ ├── al_color_oklab.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_oklab \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_oklab(float l, float a, float b) │ │ │ │ │ +ALLEGRO_COLOR al_color_oklab(float l, float a, float b) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from Oklab values. │ │ │ │ │ The L component corresponds to luminance from 0..1. │ │ │ │ │ The a and b components are in the range \-1..+1. │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_color_oklab_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_oklab_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_oklab_to_rgb(float ol, float oa, float ob, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_oklab_to_rgb(float ol, float oa, float ob, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert Oklab color values to RGB. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.8 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_oklab(3alleg5), al_color_rgb_to_oklab(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_cmyk.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_cmyk.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_cmyk(float red, float green, float blue, │ │ │ │ │ float *cyan, float *magenta, float *yellow, float *key) │ │ │ │ │ +void al_color_rgb_to_cmyk(float red, float green, float blue, │ │ │ │ │ + float *cyan, float *magenta, float *yellow, float *key) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Each RGB color can be represented in CMYK with a K component of 0 with │ │ │ │ │ the following formula: │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ C = 1 \- R │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_hsl.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_hsl.3alleg5 │ │ │ │ │ @@ -6,13 +6,15 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_hsl(float red, float green, float blue, │ │ │ │ │ float *hue, float *saturation, float *lightness) │ │ │ │ │ +void al_color_rgb_to_hsl(float red, float green, float blue, │ │ │ │ │ + float *hue, float *saturation, float *lightness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Given an RGB triplet with components in the range 0..1, return the hue │ │ │ │ │ in degrees from 0..360 and saturation and lightness in the range 0..1. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_hsl_to_rgb(3alleg5), al_color_hsl(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_hsv.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_hsv.3alleg5 │ │ │ │ │ @@ -6,13 +6,15 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_hsv(float red, float green, float blue, │ │ │ │ │ float *hue, float *saturation, float *value) │ │ │ │ │ +void al_color_rgb_to_hsv(float red, float green, float blue, │ │ │ │ │ + float *hue, float *saturation, float *value) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Given an RGB triplet with components in the range 0..1, return the hue │ │ │ │ │ in degrees from 0..360 and saturation and value in the range 0..1. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_hsv_to_rgb(3alleg5), al_color_hsv(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_html.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_html.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_html(float red, float green, float blue, │ │ │ │ │ char *string) │ │ │ │ │ +void al_color_rgb_to_html(float red, float green, float blue, │ │ │ │ │ + char *string) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Create an HTML\-style string representation of an │ │ │ │ │ ALLEGRO_COLOR(3alleg5), e.g.\ #00faff. │ │ │ │ │ .PP │ │ │ │ │ Parameters: │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_lab.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_lab.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_lab(float red, float green, float blue, │ │ │ │ │ float *l, float *a, float *b) │ │ │ │ │ +void al_color_rgb_to_lab(float red, float green, float blue, │ │ │ │ │ + float *l, float *a, float *b) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert RGB values to L*a*b* color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_lab(3alleg5), al_color_lab_to_rgb(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_lch.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_lch.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_lch(float red, float green, float blue, │ │ │ │ │ float *l, float *c, float *h) │ │ │ │ │ +void al_color_rgb_to_lch(float red, float green, float blue, │ │ │ │ │ + float *l, float *c, float *h) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert RGB values to CIE LCH color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_lch(3alleg5), al_color_lch_to_rgb(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_linear.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_linear.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_linear(float red, float green, float blue, │ │ │ │ │ float *r, float *g, float *b) │ │ │ │ │ +void al_color_rgb_to_linear(float red, float green, float blue, │ │ │ │ │ + float *r, float *g, float *b) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert gamma corrected sRGB values (i.e.\ normal RGB) to linear sRGB │ │ │ │ │ space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.8 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_name.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_name.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_color_rgb_to_name \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ char const *al_color_rgb_to_name(float r, float g, float b) │ │ │ │ │ +char const *al_color_rgb_to_name(float r, float g, float b) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Given an RGB triplet with components in the range 0..1, find a color │ │ │ │ │ name describing it approximately. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_name_to_rgb(3alleg5), al_color_name(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_oklab.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_oklab.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_oklab(float red, float green, float blue, │ │ │ │ │ float *ol, float *oa, float *ob) │ │ │ │ │ +void al_color_rgb_to_oklab(float red, float green, float blue, │ │ │ │ │ + float *ol, float *oa, float *ob) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert RGB values to the Oklab color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.8 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_oklab(3alleg5), al_color_oklab_to_rgb(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_xyy.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_xyy.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_xyy(float red, float green, float blue, │ │ │ │ │ float *x, float *y, float *y2) │ │ │ │ │ +void al_color_rgb_to_xyy(float red, float green, float blue, │ │ │ │ │ + float *x, float *y, float *y2) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert RGB values to xyY color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_xyy(3alleg5), al_color_xyy_to_rgb(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_xyz.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_xyz.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_xyz(float red, float green, float blue, │ │ │ │ │ float *x, float *y, float *z) │ │ │ │ │ +void al_color_rgb_to_xyz(float red, float green, float blue, │ │ │ │ │ + float *x, float *y, float *z) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert RGB values to XYZ color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_xyz(3alleg5), al_color_xyz_to_rgb(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_rgb_to_yuv.3alleg5.gz │ │ │ │ ├── al_color_rgb_to_yuv.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_color_rgb_to_yuv \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_rgb_to_yuv(float red, float green, float blue, │ │ │ │ │ +void al_color_rgb_to_yuv(float red, float green, float blue, │ │ │ │ │ float *y, float *u, float *v) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert RGB values to YUV color space. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_yuv(3alleg5), al_color_yuv_to_rgb(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_xyy.3alleg5.gz │ │ │ │ ├── al_color_xyy.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_xyy \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_xyy(float x, float y, float y2) │ │ │ │ │ +ALLEGRO_COLOR al_color_xyy(float x, float y, float y2) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from xyY values. │ │ │ │ │ The Y component in the xyY color space is the same as the Y in XYZ. │ │ │ │ │ .PP │ │ │ │ │ However the x and y values are computed from XYZ like this: │ │ │ │ │ .IP │ │ │ ├── ./usr/share/man/man3/al_color_xyy_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_xyy_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_xyy_to_rgb(float x, float y, float y2, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_xyy_to_rgb(float x, float y, float y2, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert xyY color values to RGB color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_xyy(3alleg5), al_color_rgb_to_xyy(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_xyz.3alleg5.gz │ │ │ │ ├── al_color_xyz.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_color_xyz \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_xyz(float x, float y, float z) │ │ │ │ │ +ALLEGRO_COLOR al_color_xyz(float x, float y, float z) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from XYZ values. │ │ │ │ │ The CIE 1931 XYZ color space consists of three components in the range │ │ │ │ │ 0..1. │ │ │ │ │ The Y component corresponds to luminance and the X and Z components │ │ │ │ │ define the color. │ │ │ ├── ./usr/share/man/man3/al_color_xyz_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_xyz_to_rgb.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_xyz_to_rgb(float x, float y, float z, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_xyz_to_rgb(float x, float y, float z, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert XYZ color values to RGB color space. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_xyz(3alleg5), al_color_rgb_to_xyz(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_yuv.3alleg5.gz │ │ │ │ ├── al_color_yuv.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_color_yuv \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_COLOR al_color_yuv(float y, float u, float v) │ │ │ │ │ +ALLEGRO_COLOR al_color_yuv(float y, float u, float v) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return an ALLEGRO_COLOR(3alleg5) structure from YUV values. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_yuv_to_rgb(3alleg5), al_color_rgb_to_yuv(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_color_yuv_to_rgb.3alleg5.gz │ │ │ │ ├── al_color_yuv_to_rgb.3alleg5 │ │ │ │ │ @@ -6,12 +6,14 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_color_yuv_to_rgb(float y, float u, float v, │ │ │ │ │ float *red, float *green, float *blue) │ │ │ │ │ +void al_color_yuv_to_rgb(float y, float u, float v, │ │ │ │ │ + float *red, float *green, float *blue) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Convert YUV color values to RGB color space. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_color_yuv(3alleg5), al_color_rgb_to_yuv(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_create_audio_recorder.3alleg5.gz │ │ │ │ ├── al_create_audio_recorder.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count, │ │ │ │ │ unsigned int samples, unsigned int frequency, │ │ │ │ │ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +ALLEGRO_AUDIO_RECORDER *al_create_audio_recorder(size_t fragment_count, │ │ │ │ │ + unsigned int samples, unsigned int frequency, │ │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates an audio recorder using the system\[cq]s default recording │ │ │ │ │ device. │ │ │ │ │ (So if the returned device does not work, try updating the system\[cq]s │ │ │ │ │ default recording device.) │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_create_audio_stream.3alleg5.gz │ │ │ │ ├── al_create_audio_stream.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count, │ │ │ │ │ unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ │ ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_create_audio_stream(size_t fragment_count, │ │ │ │ │ + unsigned int frag_samples, unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ │ + ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates an ALLEGRO_AUDIO_STREAM(3alleg5). │ │ │ │ │ The stream will be set to play by default. │ │ │ │ │ It will feed audio data from a buffer, which is split into a number of │ │ │ │ │ fragments. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_create_builtin_font.3alleg5.gz │ │ │ │ ├── al_create_builtin_font.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_create_builtin_font \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_create_builtin_font(void) │ │ │ │ │ +ALLEGRO_FONT *al_create_builtin_font(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a monochrome bitmap font (8x8 pixels per character). │ │ │ │ │ .PP │ │ │ │ │ This font is primarily intended to be used for displaying information in │ │ │ │ │ environments or during early runtime states where no external font data │ │ │ │ │ is available or loaded (e.g.\ for debugging). │ │ │ ├── ./usr/share/man/man3/al_create_index_buffer.3alleg5.gz │ │ │ │ ├── al_create_index_buffer.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_INDEX_BUFFER* al_create_index_buffer(int index_size, │ │ │ │ │ const void* initial_data, int num_indices, int flags) │ │ │ │ │ +ALLEGRO_INDEX_BUFFER* al_create_index_buffer(int index_size, │ │ │ │ │ + const void* initial_data, int num_indices, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a index buffer. │ │ │ │ │ Can return NULL if the buffer could not be created (e.g.\ the system │ │ │ │ │ only supports write\-only buffers). │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_create_menu.3alleg5.gz │ │ │ │ ├── al_create_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_create_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MENU *al_create_menu(void) │ │ │ │ │ +ALLEGRO_MENU *al_create_menu(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a menu container that can hold menu items. │ │ │ │ │ .PP │ │ │ │ │ Returns \f[CR]NULL\f[R] on failure. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_create_mixer.3alleg5.gz │ │ │ │ ├── al_create_mixer.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MIXER *al_create_mixer(unsigned int freq, │ │ │ │ │ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +ALLEGRO_MIXER *al_create_mixer(unsigned int freq, │ │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a mixer to attach sample instances, audio streams, or other │ │ │ │ │ mixers to. │ │ │ │ │ It will mix into a buffer at the requested frequency (in Hz) and channel │ │ │ │ │ count. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_create_native_file_dialog.3alleg5.gz │ │ │ │ ├── al_create_native_file_dialog.3alleg5 │ │ │ │ │ @@ -9,14 +9,19 @@ │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FILECHOOSER *al_create_native_file_dialog( │ │ │ │ │ char const *initial_path, │ │ │ │ │ char const *title, │ │ │ │ │ char const *patterns, │ │ │ │ │ int mode) │ │ │ │ │ +ALLEGRO_FILECHOOSER *al_create_native_file_dialog( │ │ │ │ │ + char const *initial_path, │ │ │ │ │ + char const *title, │ │ │ │ │ + char const *patterns,eta, float delta_theta, float thickness, │ │ │ │ │ + int mode) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a new native file dialog. │ │ │ │ │ You should only have one such dialog opened at a time. │ │ │ │ │ .PP │ │ │ │ │ Parameters: │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/al_create_popup_menu.3alleg5.gz │ │ │ │ ├── al_create_popup_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_create_popup_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MENU *al_create_popup_menu(void) │ │ │ │ │ +ALLEGRO_MENU *al_create_popup_menu(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a menu container for popup menus. │ │ │ │ │ Only the root (outermost) menu should be created with this function. │ │ │ │ │ Sub menus of popups should be created with al_create_menu(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ Returns \f[CR]NULL\f[R] on failure. │ │ │ ├── ./usr/share/man/man3/al_create_sample.3alleg5.gz │ │ │ │ ├── al_create_sample.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples, │ │ │ │ │ unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ │ ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf) │ │ │ │ │ +ALLEGRO_SAMPLE *al_create_sample(void *buf, unsigned int samples, │ │ │ │ │ + unsigned int freq, ALLEGRO_AUDIO_DEPTH depth, │ │ │ │ │ + ALLEGRO_CHANNEL_CONF chan_conf, bool free_buf) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Create a sample data structure from the supplied buffer. │ │ │ │ │ If \f[CR]free_buf\f[R] is true then the buffer will be freed with │ │ │ │ │ al_free(3alleg5) when the sample data structure is destroyed. │ │ │ │ │ For portability (especially Windows), the buffer should have been │ │ │ │ │ allocated with al_malloc(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_create_sample_instance.3alleg5.gz │ │ │ │ ├── al_create_sample_instance.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_create_sample_instance \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data) │ │ │ │ │ +ALLEGRO_SAMPLE_INSTANCE *al_create_sample_instance(ALLEGRO_SAMPLE *sample_data) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a sample instance, using the supplied sample data. │ │ │ │ │ The instance must be attached to a mixer (or voice) in order to actually │ │ │ │ │ produce output. │ │ │ │ │ .PP │ │ │ │ │ The argument may be NULL. │ │ │ ├── ./usr/share/man/man3/al_create_vertex_buffer.3alleg5.gz │ │ │ │ ├── al_create_vertex_buffer.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_VERTEX_BUFFER* al_create_vertex_buffer(ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ const void* initial_data, int num_vertices, int flags) │ │ │ │ │ +ALLEGRO_VERTEX_BUFFER* al_create_vertex_buffer(ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ + const void* initial_data, int num_vertices, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a vertex buffer. │ │ │ │ │ Can return NULL if the buffer could not be created (e.g.\ the system │ │ │ │ │ only supports write\-only buffers). │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_create_vertex_decl.3alleg5.gz │ │ │ │ ├── al_create_vertex_decl.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_create_vertex_decl \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_VERTEX_DECL* al_create_vertex_decl(const ALLEGRO_VERTEX_ELEMENT* elements, int stride) │ │ │ │ │ +ALLEGRO_VERTEX_DECL* al_create_vertex_decl(const ALLEGRO_VERTEX_ELEMENT* elements, int stride) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a vertex declaration, which describes a custom vertex format. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ elements \- An array of ALLEGRO_VERTEX_ELEMENT(3alleg5) structures. │ │ │ ├── ./usr/share/man/man3/al_create_voice.3alleg5.gz │ │ │ │ ├── al_create_voice.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_VOICE *al_create_voice(unsigned int freq, │ │ │ │ │ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +ALLEGRO_VOICE *al_create_voice(unsigned int freq, │ │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a voice structure and allocates a voice from the digital sound │ │ │ │ │ driver. │ │ │ │ │ The passed frequency (in Hz), sample format and channel configuration │ │ │ │ │ are used as a hint to what kind of data will be sent to the voice. │ │ │ │ │ However, the underlying sound driver is free to use non\-matching │ │ │ ├── ./usr/share/man/man3/al_destroy_audio_recorder.3alleg5.gz │ │ │ │ ├── al_destroy_audio_recorder.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_destroy_audio_recorder \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +void al_destroy_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Destroys the audio recorder and frees all resources associated with it. │ │ │ │ │ It is safe to destroy a recorder that is recording. │ │ │ │ │ .PP │ │ │ │ │ You may receive events after the recorder has been destroyed. │ │ │ │ │ They must be ignored, as the fragment buffer will no longer be valid. │ │ │ ├── ./usr/share/man/man3/al_destroy_audio_stream.3alleg5.gz │ │ │ │ ├── al_destroy_audio_stream.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_destroy_audio_stream \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +void al_destroy_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Destroy an audio stream which was created with │ │ │ │ │ al_create_audio_stream(3alleg5) or al_load_audio_stream(3alleg5). │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ │ │ \f[I]Note:\f[R] If the stream is still attached to a mixer or voice, │ │ │ ├── ./usr/share/man/man3/al_destroy_font.3alleg5.gz │ │ │ │ ├── al_destroy_font.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_destroy_font \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_font(ALLEGRO_FONT *f) │ │ │ │ │ +void al_destroy_font(ALLEGRO_FONT *f) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Frees the memory being used by a font structure. │ │ │ │ │ Does nothing if passed NULL. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_load_font(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_destroy_index_buffer.3alleg5.gz │ │ │ │ ├── al_destroy_index_buffer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_destroy_index_buffer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_index_buffer(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ +void al_destroy_index_buffer(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Destroys a index buffer. │ │ │ │ │ Does nothing if passed NULL. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.8 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_destroy_menu.3alleg5.gz │ │ │ │ ├── al_destroy_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_destroy_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_menu(ALLEGRO_MENU *menu) │ │ │ │ │ +void al_destroy_menu(ALLEGRO_MENU *menu) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Destroys an entire menu, including its sub\-menus. │ │ │ │ │ Any references to it or a sub\-menu are no longer valid. │ │ │ │ │ It is safe to call this on a menu that is currently being displayed. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_destroy_mixer.3alleg5.gz │ │ │ │ ├── al_destroy_mixer.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_destroy_mixer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ +void al_destroy_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Destroys the mixer. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_create_mixer(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_destroy_native_file_dialog.3alleg5.gz │ │ │ │ ├── al_destroy_native_file_dialog.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ al_destroy_native_file_dialog \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ +void al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Frees up all resources used by the file dialog. │ │ │ ├── ./usr/share/man/man3/al_destroy_sample.3alleg5.gz │ │ │ │ ├── al_destroy_sample.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_destroy_sample \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_sample(ALLEGRO_SAMPLE *spl) │ │ │ │ │ +void al_destroy_sample(ALLEGRO_SAMPLE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Free the sample data structure. │ │ │ │ │ If it was created with the \f[CR]free_buf\f[R] parameter set to true, │ │ │ │ │ then the buffer will be freed with al_free(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ This function will stop any sample instances which may be playing the │ │ │ ├── ./usr/share/man/man3/al_destroy_sample_instance.3alleg5.gz │ │ │ │ ├── al_destroy_sample_instance.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_destroy_sample_instance \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +void al_destroy_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Detaches the sample instance from anything it may be attached to and │ │ │ │ │ frees it (the sample data, i.e.\ its ALLEGRO_SAMPLE, is \f[I]not\f[R] │ │ │ │ │ freed!). │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_create_sample_instance(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_destroy_vertex_buffer.3alleg5.gz │ │ │ │ ├── al_destroy_vertex_buffer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_destroy_vertex_buffer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ +void al_destroy_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Destroys a vertex buffer. │ │ │ │ │ Does nothing if passed NULL. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.3 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_destroy_vertex_decl.3alleg5.gz │ │ │ │ ├── al_destroy_vertex_decl.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_destroy_vertex_decl \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_vertex_decl(ALLEGRO_VERTEX_DECL* decl) │ │ │ │ │ +void al_destroy_vertex_decl(ALLEGRO_VERTEX_DECL* decl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Destroys a vertex declaration. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ decl \- Vertex declaration to destroy │ │ │ ├── ./usr/share/man/man3/al_destroy_voice.3alleg5.gz │ │ │ │ ├── al_destroy_voice.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_destroy_voice \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_destroy_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ +void al_destroy_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Destroys the voice and deallocates it from the digital driver. │ │ │ │ │ Does nothing if the voice is NULL. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_create_voice(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_detach_audio_stream.3alleg5.gz │ │ │ │ ├── al_detach_audio_stream.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_detach_audio_stream \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +bool al_detach_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Detach the stream from whatever it\[cq]s attached to, if anything. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_attach_audio_stream_to_mixer(3alleg5), │ │ │ │ │ al_attach_audio_stream_to_voice(3alleg5), │ │ │ │ │ al_get_audio_stream_attached(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_detach_mixer.3alleg5.gz │ │ │ │ ├── al_detach_mixer.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_detach_mixer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_detach_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_detach_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Detach the mixer from whatever it is attached to, if anything. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_attach_mixer_to_mixer(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_detach_sample_instance.3alleg5.gz │ │ │ │ ├── al_detach_sample_instance.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_detach_sample_instance \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_detach_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Detach the sample instance from whatever it\[cq]s attached to, if │ │ │ │ │ anything. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_detach_voice.3alleg5.gz │ │ │ │ ├── al_detach_voice.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_detach_voice \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_detach_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ +void al_detach_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Detaches the mixer, sample instance or audio stream from the voice. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_attach_mixer_to_voice(3alleg5), │ │ │ │ │ al_attach_sample_instance_to_voice(3alleg5), │ │ │ │ │ al_attach_audio_stream_to_voice(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_disable_menu_event_source.3alleg5.gz │ │ │ │ ├── al_disable_menu_event_source.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_disable_menu_event_source \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_disable_menu_event_source(ALLEGRO_MENU *menu) │ │ │ │ │ +void al_disable_menu_event_source(ALLEGRO_MENU *menu) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Disables a unique event source for the menu, causing it to use the │ │ │ │ │ default event source. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_do_multiline_text.3alleg5.gz │ │ │ │ ├── al_do_multiline_text.3alleg5 │ │ │ │ │ @@ -8,14 +8,18 @@ │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_do_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ │ float max_width, const char *text, │ │ │ │ │ bool (*cb)(int line_num, const char *line, int size, void *extra), │ │ │ │ │ void *extra) │ │ │ │ │ +void al_do_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ │ + float max_width, const char *text, │ │ │ │ │ + bool (*cb)(int line_num, const char *line, int size, void *extra), │ │ │ │ │ + void *extra) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This function processes the \f[CR]text\f[R] and splits it into lines as │ │ │ │ │ al_draw_multiline_text(3alleg5) would, and then calls the callback │ │ │ │ │ \f[CR]cb\f[R] once for every line. │ │ │ │ │ This is useful for custom drawing of multiline text, or for calculating │ │ │ │ │ the size of multiline text ahead of time. │ │ │ ├── ./usr/share/man/man3/al_do_multiline_ustr.3alleg5.gz │ │ │ │ ├── al_do_multiline_ustr.3alleg5 │ │ │ │ │ @@ -8,14 +8,18 @@ │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_do_multiline_ustr(const ALLEGRO_FONT *font, float max_width, │ │ │ │ │ const ALLEGRO_USTR *ustr, │ │ │ │ │ bool (*cb)(int line_num, const ALLEGRO_USTR * line, void *extra), │ │ │ │ │ void *extra) │ │ │ │ │ +void al_do_multiline_ustr(const ALLEGRO_FONT *font, float max_width, │ │ │ │ │ + const ALLEGRO_USTR *ustr, │ │ │ │ │ + bool (*cb)(int line_num, const ALLEGRO_USTR * line, void *extra), │ │ │ │ │ + void *extra) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_do_multiline_text(3alleg5), but using ALLEGRO_USTR instead of a │ │ │ │ │ NUL\-terminated char array for text. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.9 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_drain_audio_stream.3alleg5.gz │ │ │ │ ├── al_drain_audio_stream.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_drain_audio_stream \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +void al_drain_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ You should call this to finalise an audio stream that you will no longer │ │ │ │ │ be feeding, to wait for all pending buffers to finish playing. │ │ │ │ │ The stream\[cq]s playing state will change to false. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_destroy_audio_stream(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_draw_arc.3alleg5.gz │ │ │ │ ├── al_draw_arc.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_arc(float cx, float cy, float r, float start_theta, │ │ │ │ │ float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_arc(float cx, float cy, float r, float start_theta, │ │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws an arc. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ cx, cy \- Center of the arc │ │ │ ├── ./usr/share/man/man3/al_draw_circle.3alleg5.gz │ │ │ │ ├── al_draw_circle.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_circle(float cx, float cy, float r, ALLEGRO_COLOR color, │ │ │ │ │ float thickness) │ │ │ │ │ +void al_draw_circle(float cx, float cy, float r, ALLEGRO_COLOR color, │ │ │ │ │ + float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws an outlined circle. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ cx, cy \- Center of the circle │ │ │ ├── ./usr/share/man/man3/al_draw_ellipse.3alleg5.gz │ │ │ │ ├── al_draw_ellipse.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ │ ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws an outlined ellipse. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ cx, cy \- Center of the ellipse │ │ │ ├── ./usr/share/man/man3/al_draw_elliptical_arc.3alleg5.gz │ │ │ │ ├── al_draw_elliptical_arc.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_elliptical_arc(float cx, float cy, float rx, float ry, float start_theta, │ │ │ │ │ float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_elliptical_arc(float cx, float cy, float rx, float ry, float start_theta, │ │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws an elliptical arc. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ cx, cy \- Center of the arc │ │ │ ├── ./usr/share/man/man3/al_draw_filled_circle.3alleg5.gz │ │ │ │ ├── al_draw_filled_circle.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_draw_filled_circle \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_filled_circle(float cx, float cy, float r, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_circle(float cx, float cy, float r, ALLEGRO_COLOR color) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a filled circle. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ cx, cy \- Center of the circle │ │ │ ├── ./usr/share/man/man3/al_draw_filled_ellipse.3alleg5.gz │ │ │ │ ├── al_draw_filled_ellipse.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_filled_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ │ ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_ellipse(float cx, float cy, float rx, float ry, │ │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a filled ellipse. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ cx, cy \- Center of the ellipse │ │ │ ├── ./usr/share/man/man3/al_draw_filled_pieslice.3alleg5.gz │ │ │ │ ├── al_draw_filled_pieslice.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_filled_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ │ float delta_theta, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ │ + float delta_theta, ALLEGRO_COLOR color) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a filled pieslice (filled circular sector). │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ cx, cy \- Center of the pieslice │ │ │ ├── ./usr/share/man/man3/al_draw_filled_polygon.3alleg5.gz │ │ │ │ ├── al_draw_filled_polygon.3alleg5 │ │ │ │ │ @@ -4,15 +4,17 @@ │ │ │ │ │ .SH NAME │ │ │ │ │ al_draw_filled_polygon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ -void al_draw_filled_polygon(const float *vertices, int vertex_count, │ │ │ │ │ +void al_draw_filled_polygon(const float *vertices, int vertex_cou │ │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_polygon(const float *vertices, int vertex_court, int end, int type) │ │ │ │ │ ALLEGRO_COLOR color) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draw a filled, simple polygon. │ │ │ │ │ Simple means it does not have to be convex but must not be │ │ │ │ │ self\-overlapping. │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/al_draw_filled_polygon_with_holes.3alleg5.gz │ │ │ │ ├── al_draw_filled_polygon_with_holes.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_filled_polygon_with_holes(const float *vertices, │ │ │ │ │ const int *vertex_counts, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_polygon_with_holes(const float *vertices, │ │ │ │ │ + const int *vertex_counts, ALLEGRO_COLOR color) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a filled simple polygon with zero or more other simple polygons │ │ │ │ │ subtracted from it \- the holes. │ │ │ │ │ The holes cannot touch or intersect with the outline of the filled │ │ │ │ │ polygon. │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/al_draw_filled_rectangle.3alleg5.gz │ │ │ │ ├── al_draw_filled_rectangle.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_filled_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + ALLEGRO_COLOR color) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a filled rectangle. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ x1, y1, x2, y2 \- Upper left and lower right points of the rectangle │ │ │ ├── ./usr/share/man/man3/al_draw_filled_rounded_rectangle.3alleg5.gz │ │ │ │ ├── al_draw_filled_rounded_rectangle.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_filled_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ float rx, float ry, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + float rx, float ry, ALLEGRO_COLOR color) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws an filled rounded rectangle. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ x1, y1, x2, y2 \- Upper left and lower right points of the rectangle │ │ │ ├── ./usr/share/man/man3/al_draw_filled_triangle.3alleg5.gz │ │ │ │ ├── al_draw_filled_triangle.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_filled_triangle(float x1, float y1, float x2, float y2, │ │ │ │ │ float x3, float y3, ALLEGRO_COLOR color) │ │ │ │ │ +void al_draw_filled_triangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + float x3, float y3, ALLEGRO_COLOR color) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a filled triangle. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ x1, y1, x2, y2, x3, y3 \- Three points of the triangle │ │ │ ├── ./usr/share/man/man3/al_draw_glyph.3alleg5.gz │ │ │ │ ├── al_draw_glyph.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_glyph(const ALLEGRO_FONT *f, ALLEGRO_COLOR color, float x, float y, │ │ │ │ │ int codepoint) │ │ │ │ │ +void al_draw_glyph(const ALLEGRO_FONT *f, ALLEGRO_COLOR color, float x, float y, │ │ │ │ │ + int codepoint) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws the glyph that corresponds with \f[CR]codepoint\f[R] in the given │ │ │ │ │ \f[CR]color\f[R] using the given \f[CR]font\f[R]. │ │ │ │ │ If \f[CR]font\f[R] does not have such a glyph, nothing will be drawn. │ │ │ │ │ .PP │ │ │ │ │ To draw a string as left to right horizontal text you will need to use │ │ │ ├── ./usr/share/man/man3/al_draw_indexed_buffer.3alleg5.gz │ │ │ │ ├── al_draw_indexed_buffer.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_draw_indexed_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ │ ALLEGRO_BITMAP* texture, ALLEGRO_INDEX_BUFFER* index_buffer, │ │ │ │ │ int start, int end, int type) │ │ │ │ │ +int al_draw_indexed_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ │ + ALLEGRO_BITMAP* texture, ALLEGRO_INDEX_BUFFER* index_buffer, │ │ │ │ │ + int start, int end, int type) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a subset of the passed vertex buffer. │ │ │ │ │ This function uses an index buffer to specify which vertices to use. │ │ │ │ │ Both buffers must not be locked. │ │ │ │ │ Additionally, to draw onto memory bitmaps or with memory bitmap textures │ │ │ │ │ both buffers must support reading (i.e.\ they must be created with the │ │ │ ├── ./usr/share/man/man3/al_draw_indexed_prim.3alleg5.gz │ │ │ │ ├── al_draw_indexed_prim.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_draw_indexed_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ ALLEGRO_BITMAP* texture, const int* indices, int num_vtx, int type) │ │ │ │ │ +int al_draw_indexed_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ + ALLEGRO_BITMAP* texture, const int* indices, int num_vtx, int type) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a subset of the passed vertex array. │ │ │ │ │ This function uses an index array to specify which vertices to use. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ ├── ./usr/share/man/man3/al_draw_justified_text.3alleg5.gz │ │ │ │ ├── al_draw_justified_text.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_justified_text(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ │ float y, float diff, int flags, const char *text) │ │ │ │ │ +void al_draw_justified_text(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ │ + float y, float diff, int flags, const char *text) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_draw_text(3alleg5), but justifies the string to the region │ │ │ │ │ x1\-x2. │ │ │ │ │ .PP │ │ │ │ │ The \f[CR]diff\f[R] parameter is the maximum amount of horizontal space │ │ │ │ │ to allow between words. │ │ │ ├── ./usr/share/man/man3/al_draw_justified_textf.3alleg5.gz │ │ │ │ ├── al_draw_justified_textf.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_justified_textf(const ALLEGRO_FONT *f, │ │ │ │ │ ALLEGRO_COLOR color, float x1, float x2, float y, │ │ │ │ │ float diff, int flags, const char *format, ...) │ │ │ │ │ +void al_draw_justified_textf(const ALLEGRO_FONT *f, │ │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, float y, │ │ │ │ │ + float diff, int flags, const char *format, ...) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Formatted text output, using a printf() style format string. │ │ │ │ │ All parameters have the same meaning as with │ │ │ │ │ al_draw_justified_text(3alleg5) otherwise. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_draw_justified_text(3alleg5), al_draw_justified_ustr(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_draw_justified_ustr.3alleg5.gz │ │ │ │ ├── al_draw_justified_ustr.3alleg5 │ │ │ │ │ @@ -7,13 +7,16 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_justified_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ │ float y, float diff, int flags, const ALLEGRO_USTR *ustr) │ │ │ │ │ +void al_draw_justified_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x1, float x2, │ │ │ │ │ + float y, float diff, int flags, const ALLEGRO_USTR *ustr) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_draw_justified_text(3alleg5), except the text is passed as an │ │ │ │ │ ALLEGRO_USTR instead of a NUL\-terminated char array. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_draw_justified_text(3alleg5), al_draw_justified_textf(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_draw_line.3alleg5.gz │ │ │ │ ├── al_draw_line.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_line(float x1, float y1, float x2, float y2, │ │ │ │ │ ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_line(float x1, float y1, float x2, float y2, │ │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a line segment between two points. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ x1, y1, x2, y2 \- Start and end points of the line │ │ │ ├── ./usr/share/man/man3/al_draw_multiline_text.3alleg5.gz │ │ │ │ ├── al_draw_multiline_text.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ int flags, const char *text) │ │ │ │ │ +void al_draw_multiline_text(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ + int flags, const char *text) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_draw_text(3alleg5), but this function supports drawing multiple │ │ │ │ │ lines of text. │ │ │ │ │ It will break \f[CR]text\f[R] in lines based on its contents and the │ │ │ │ │ \f[CR]max_width\f[R] parameter. │ │ │ │ │ The lines are then layed out vertically depending on the │ │ │ ├── ./usr/share/man/man3/al_draw_multiline_textf.3alleg5.gz │ │ │ │ ├── al_draw_multiline_textf.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_multiline_textf(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ int flags, const char *format, ...) │ │ │ │ │ +void al_draw_multiline_textf(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ + int flags, const char *format, ...) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Formatted text output, using a printf() style format string. │ │ │ │ │ All parameters have the same meaning as with │ │ │ │ │ al_draw_multiline_text(3alleg5) otherwise. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.9 │ │ │ ├── ./usr/share/man/man3/al_draw_multiline_ustr.3alleg5.gz │ │ │ │ ├── al_draw_multiline_ustr.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_multiline_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ int flags, const ALLEGRO_USTR *ustr) │ │ │ │ │ +void al_draw_multiline_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, float max_width, float line_height, │ │ │ │ │ + int flags, const ALLEGRO_USTR *ustr) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_draw_multiline_text(3alleg5), except the text is passed as an │ │ │ │ │ ALLEGRO_USTR instead of a NUL\-terminated char array. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.9 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_draw_pieslice.3alleg5.gz │ │ │ │ ├── al_draw_pieslice.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ │ float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_pieslice(float cx, float cy, float r, float start_theta, │ │ │ │ │ + float delta_theta, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a pieslice (outlined circular sector). │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ cx, cy \- Center of the pieslice │ │ │ ├── ./usr/share/man/man3/al_draw_polygon.3alleg5.gz │ │ │ │ ├── al_draw_polygon.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_polygon(const float *vertices, int vertex_count, │ │ │ │ │ int join_style, ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ │ +void al_draw_polygon(const float *vertices, int vertex_count, │ │ │ │ │ + int join_style, ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draw an unfilled polygon. │ │ │ │ │ This is the same as passing \f[CR]ALLEGRO_LINE_CAP_CLOSED\f[R] to │ │ │ │ │ al_draw_polyline(3alleg5). │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ vertex \- Interleaved array of (x, y) vertex coordinates │ │ │ ├── ./usr/share/man/man3/al_draw_polyline.3alleg5.gz │ │ │ │ ├── al_draw_polyline.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_polyline(const float* vertices, int vertex_stride, │ │ │ │ │ int vertex_count, int join_style, int cap_style, │ │ │ │ │ ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ │ +void al_draw_polyline(const float* vertices, int vertex_stride, │ │ │ │ │ + int vertex_count, int join_style, int cap_style, │ │ │ │ │ + ALLEGRO_COLOR color, float thickness, float miter_limit) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draw a series of line segments. │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ vertices \- Interleaved array of (x, y) vertex coordinates │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ vertex_stride \- the number of bytes between pairs of vertices (the │ │ │ ├── ./usr/share/man/man3/al_draw_prim.3alleg5.gz │ │ │ │ ├── al_draw_prim.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_draw_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │ │ +int al_draw_prim(const void* vtxs, const ALLEGRO_VERTEX_DECL* decl, │ │ │ │ │ + ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a subset of the passed vertex array. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ texture \- Texture to use, pass NULL to use only color shaded primitves │ │ │ ├── ./usr/share/man/man3/al_draw_rectangle.3alleg5.gz │ │ │ │ ├── al_draw_rectangle.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws an outlined rectangle. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ x1, y1, x2, y2 \- Upper left and lower right points of the rectangle │ │ │ ├── ./usr/share/man/man3/al_draw_ribbon.3alleg5.gz │ │ │ │ ├── al_draw_ribbon.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_ribbon(const float *points, int points_stride, ALLEGRO_COLOR color, │ │ │ │ │ float thickness, int num_segments) │ │ │ │ │ +void al_draw_ribbon(const float *points, int points_stride, ALLEGRO_COLOR color, │ │ │ │ │ + float thickness, int num_segments) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a ribbon given an array of points. │ │ │ │ │ The ribbon will go through all of the passed points. │ │ │ │ │ The points buffer should consist of regularly spaced doublets of floats, │ │ │ │ │ corresponding to x and y coordinates of the vertices. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_draw_rounded_rectangle.3alleg5.gz │ │ │ │ ├── al_draw_rounded_rectangle.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ float rx, float ry, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_rounded_rectangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + float rx, float ry, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws an outlined rounded rectangle. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ x1, y1, x2, y2 \- Upper left and lower right points of the rectangle │ │ │ ├── ./usr/share/man/man3/al_draw_soft_line.3alleg5.gz │ │ │ │ ├── al_draw_soft_line.3alleg5 │ │ │ │ │ @@ -8,14 +8,18 @@ │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_soft_line(ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, uintptr_t state, │ │ │ │ │ void (*first)(uintptr_t, int, int, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ │ void (*step)(uintptr_t, int), │ │ │ │ │ void (*draw)(uintptr_t, int, int)) │ │ │ │ │ +void al_draw_soft_line(ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, uintptr_t state, │ │ │ │ │ + void (*first)(uintptr_t, int, int, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ │ + void (*step)(uintptr_t, int), │ │ │ │ │ + void (*draw)(uintptr_t, int, int)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a line using the software rasterizer and user supplied pixel │ │ │ │ │ functions. │ │ │ │ │ For help in understanding what these functions do, see the │ │ │ │ │ implementation of the various shading routines in │ │ │ │ │ addons/primitives/line_soft.c. │ │ │ ├── ./usr/share/man/man3/al_draw_soft_triangle.3alleg5.gz │ │ │ │ ├── al_draw_soft_triangle.3alleg5 │ │ │ │ │ @@ -10,14 +10,20 @@ │ │ │ │ │ │ │ │ │ │ void al_draw_soft_triangle( │ │ │ │ │ ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, ALLEGRO_VERTEX* v3, uintptr_t state, │ │ │ │ │ void (*init)(uintptr_t, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ │ void (*first)(uintptr_t, int, int, int, int), │ │ │ │ │ void (*step)(uintptr_t, int), │ │ │ │ │ void (*draw)(uintptr_t, int, int, int)) │ │ │ │ │ +void al_draw_soft_triangle( │ │ │ │ │ + ALLEGRO_VERTEX* v1, ALLEGRO_VERTEX* v2, ALLEGRO_VERTEX* v3, uintptr_t state, │ │ │ │ │ + void (*init)(uintptr_t, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*, ALLEGRO_VERTEX*), │ │ │ │ │ + void (*first)(uintptr_t, int, int, int, int), │ │ │ │ │ + void (*step)(uintptr_t, int), │ │ │ │ │ + void (*draw)(uintptr_t, int, int, int)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a triangle using the software rasterizer and user supplied pixel │ │ │ │ │ functions. │ │ │ │ │ For help in understanding what these functions do, see the │ │ │ │ │ implementation of the various shading routines in │ │ │ │ │ addons/primitives/tri_soft.c. │ │ │ ├── ./usr/share/man/man3/al_draw_spline.3alleg5.gz │ │ │ │ ├── al_draw_spline.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_draw_spline \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_spline(const float points[8], ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_spline(const float points[8], ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a Bézier spline given 4 control points. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ points \- An array of 4 pairs of coordinates of the 4 control points │ │ │ ├── ./usr/share/man/man3/al_draw_text.3alleg5.gz │ │ │ │ ├── al_draw_text.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_text(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ │ char const *text) │ │ │ │ │ +void al_draw_text(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ │ + char const *text) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Writes the NUL\-terminated string \f[CR]text\f[R] onto the target bitmap │ │ │ │ │ at position \f[CR]x\f[R], \f[CR]y\f[R], using the specified │ │ │ │ │ \f[CR]font\f[R]. │ │ │ │ │ .PP │ │ │ │ │ The \f[CR]flags\f[R] parameter can be 0 or one of the following flags: │ │ │ ├── ./usr/share/man/man3/al_draw_textf.3alleg5.gz │ │ │ │ ├── al_draw_textf.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_textf(const ALLEGRO_FONT *font, ALLEGRO_COLOR color, │ │ │ │ │ float x, float y, int flags, │ │ │ │ │ const char *format, ...) │ │ │ │ │ +void al_draw_textf(const ALLEGRO_FONT *font, ALLEGRO_COLOR color, │ │ │ │ │ + float x, float y, int flags, │ │ │ │ │ + const char *format, ...) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Formatted text output, using a printf() style format string. │ │ │ │ │ All parameters have the same meaning as with al_draw_text(3alleg5) │ │ │ │ │ otherwise. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_draw_text(3alleg5), al_draw_ustr(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_draw_triangle.3alleg5.gz │ │ │ │ ├── al_draw_triangle.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_triangle(float x1, float y1, float x2, float y2, │ │ │ │ │ float x3, float y3, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ +void al_draw_triangle(float x1, float y1, float x2, float y2, │ │ │ │ │ + float x3, float y3, ALLEGRO_COLOR color, float thickness) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws an outlined triangle. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ │ │ .IP \[bu] 2 │ │ │ │ │ x1, y1, x2, y2, x3, y3 \- Three points of the triangle │ │ │ ├── ./usr/share/man/man3/al_draw_ustr.3alleg5.gz │ │ │ │ ├── al_draw_ustr.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_draw_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ │ const ALLEGRO_USTR *ustr) │ │ │ │ │ +void al_draw_ustr(const ALLEGRO_FONT *font, │ │ │ │ │ + ALLEGRO_COLOR color, float x, float y, int flags, │ │ │ │ │ + const ALLEGRO_USTR *ustr) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_draw_text(3alleg5), except the text is passed as an ALLEGRO_USTR │ │ │ │ │ instead of a NUL\-terminated char array. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_draw_text(3alleg5), al_draw_justified_ustr(3alleg5), │ │ │ │ │ al_draw_multiline_ustr(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_draw_vertex_buffer.3alleg5.gz │ │ │ │ ├── al_draw_vertex_buffer.3alleg5 │ │ │ │ │ @@ -5,14 +5,16 @@ │ │ │ │ │ al_draw_vertex_buffer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_draw_vertex_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ │ + ALLEGRO_BITMAP* texture, int sta) │ │ │ │ │ +int al_draw_vertex_buffer(ALLEGRO_VERTEX_BUFFER* vertex_buffer, │ │ │ │ │ ALLEGRO_BITMAP* texture, int start, int end, int type) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Draws a subset of the passed vertex buffer. │ │ │ │ │ The vertex buffer must not be locked. │ │ │ │ │ Additionally, to draw onto memory bitmaps or with memory bitmap textures │ │ │ │ │ the vertex buffer must support reading (i.e. │ │ │ ├── ./usr/share/man/man3/al_enable_menu_event_source.3alleg5.gz │ │ │ │ ├── al_enable_menu_event_source.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_enable_menu_event_source \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_enable_menu_event_source(ALLEGRO_MENU *menu) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_enable_menu_event_source(ALLEGRO_MENU *menu) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Enables a unique event source for this menu. │ │ │ │ │ It and all of its sub\-menus will use this event source. │ │ │ │ │ (It is safe to call this multiple times on the same menu.) │ │ │ │ │ .PP │ │ │ │ │ Returns the event source. │ │ │ ├── ./usr/share/man/man3/al_fill_silence.3alleg5.gz │ │ │ │ ├── al_fill_silence.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_fill_silence(void *buf, unsigned int samples, │ │ │ │ │ ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ +void al_fill_silence(void *buf, unsigned int samples, │ │ │ │ │ + ALLEGRO_AUDIO_DEPTH depth, ALLEGRO_CHANNEL_CONF chan_conf) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Fill a buffer with silence, for the given format and channel │ │ │ │ │ configuration. │ │ │ │ │ The buffer must have enough space for the given number of samples, and │ │ │ │ │ be properly aligned. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/al_find_menu.3alleg5.gz │ │ │ │ ├── al_find_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_find_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MENU *al_find_menu(ALLEGRO_MENU *haystack, uint16_t id) │ │ │ │ │ +ALLEGRO_MENU *al_find_menu(ALLEGRO_MENU *haystack, uint16_t id) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Searches in the \f[CR]haystack\f[R] menu for any submenu with the given │ │ │ │ │ \f[CR]id\f[R]. │ │ │ │ │ (Note that this only represents a literal ID, and cannot be used as an │ │ │ │ │ index.) │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_find_menu_item.3alleg5.gz │ │ │ │ ├── al_find_menu_item.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_find_menu_item(ALLEGRO_MENU *haystack, uint16_t id, ALLEGRO_MENU **menu, │ │ │ │ │ int *index) │ │ │ │ │ +bool al_find_menu_item(ALLEGRO_MENU *haystack, uint16_t id, ALLEGRO_MENU **menu, │ │ │ │ │ + int *index) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Searches in the \f[CR]haystack\f[R] menu for an item with the given │ │ │ │ │ \f[CR]id\f[R]. │ │ │ │ │ (Note that this only represents a literal ID, and cannot be used as an │ │ │ │ │ index.) │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_fixed.3alleg5.gz │ │ │ │ ├── al_fixed.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_fixed \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ typedef int32_t al_fixed; │ │ │ │ │ +typedef int32_t al_fixed; │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ A fixed point number. │ │ │ │ │ .PP │ │ │ │ │ Allegro provides some routines for working with fixed point numbers, and │ │ │ │ │ defines the type \f[CR]al_fixed\f[R] to be a signed 32\-bit integer. │ │ │ │ │ The high word is used for the integer part and the low word for the │ │ │ ├── ./usr/share/man/man3/al_free.3alleg5.gz │ │ │ │ ├── al_free.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define al_free(p) \[rs] │ │ │ │ │ (al_free_with_context((p), __LINE__, __FILE__, __func__)) │ │ │ │ │ +#define al_free(p) \[rs] │ │ │ │ │ + (al_free_with_context((p), __LINE__, __FILE__, __func__)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like free() in the C standard library, but the implementation may be │ │ │ │ │ overridden. │ │ │ │ │ .PP │ │ │ │ │ Additionally, on Windows, a memory block allocated by one DLL must be │ │ │ │ │ freed from the same DLL. │ │ │ ├── ./usr/share/man/man3/al_get_allegro_audio_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_audio_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_audio_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_audio_version(void) │ │ │ │ │ +uint32_t al_get_allegro_audio_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_color_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_color_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_color_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_color_version(void) │ │ │ │ │ +uint32_t al_get_allegro_color_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_font_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_font_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_font_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_font_version(void) │ │ │ │ │ +uint32_t al_get_allegro_font_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_image_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_image_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_image_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_image_version(void) │ │ │ │ │ +uint32_t al_get_allegro_image_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_memfile_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_memfile_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_memfile_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_memfile_version(void) │ │ │ │ │ +uint32_t al_get_allegro_memfile_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_native_dialog_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_native_dialog_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_native_dialog_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_native_dialog_version(void) │ │ │ │ │ +uint32_t al_get_allegro_native_dialog_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_physfs_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_physfs_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_physfs_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_physfs_version(void) │ │ │ │ │ +uint32_t al_get_allegro_physfs_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_primitives_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_primitives_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_primitives_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_primitives_version(void) │ │ │ │ │ +uint32_t al_get_allegro_primitives_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_ttf_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_ttf_version.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_allegro_ttf_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_ttf_version(void) │ │ │ │ │ +uint32_t al_get_allegro_ttf_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_allegro_video_version.3alleg5.gz │ │ │ │ ├── al_get_allegro_video_version.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_allegro_video_version \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint32_t al_get_allegro_video_version(void) │ │ │ │ │ +uint32_t al_get_allegro_video_version(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the (compiled) version of the addon, in the same format as │ │ │ │ │ al_get_allegro_version(3alleg5). │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.12 │ │ │ ├── ./usr/share/man/man3/al_get_audio_depth_size.3alleg5.gz │ │ │ │ ├── al_get_audio_depth_size.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_audio_depth_size \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth) │ │ │ │ │ +size_t al_get_audio_depth_size(ALLEGRO_AUDIO_DEPTH depth) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the size of a sample, in bytes, for the given format. │ │ │ │ │ The format is one of the values listed under │ │ │ │ │ ALLEGRO_AUDIO_DEPTH(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_audio_device_name.3alleg5.gz │ │ │ │ ├── al_get_audio_device_name.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_audio_device_name \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device) │ │ │ │ │ +const char* al_get_audio_device_name(const ALLEGRO_AUDIO_DEVICE * device) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get the user friendly display name of the device. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.8 │ │ │ ├── ./usr/share/man/man3/al_get_audio_output_device.3alleg5.gz │ │ │ │ ├── al_get_audio_output_device.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_audio_output_device \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index) │ │ │ │ │ +const ALLEGRO_AUDIO_DEVICE* al_get_audio_output_device(int index) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get the output audio device of the specified index. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.8 │ │ │ ├── ./usr/share/man/man3/al_get_audio_recorder_event.3alleg5.gz │ │ │ │ ├── al_get_audio_recorder_event.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_audio_recorder_event \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event) │ │ │ │ │ +ALLEGRO_AUDIO_RECORDER_EVENT *al_get_audio_recorder_event(ALLEGRO_EVENT *event) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the event as an ALLEGRO_AUDIO_RECORDER_EVENT(3alleg5). │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.1 │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_get_audio_recorder_event_source.3alleg5.gz │ │ │ │ ├── al_get_audio_recorder_event_source.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_audio_recorder_event_source \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_audio_recorder_event_source(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the event source for the recorder that generates the various │ │ │ │ │ recording events. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.1 │ │ │ │ │ .RS │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_attached.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_attached.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_audio_stream_attached \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +bool al_get_audio_stream_attached(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return whether the stream is attached to something. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_attach_audio_stream_to_mixer(3alleg5), │ │ │ │ │ al_attach_audio_stream_to_voice(3alleg5), │ │ │ │ │ al_detach_audio_stream(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_channels.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_channels.3alleg5 │ │ │ │ │ @@ -6,12 +6,14 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels( │ │ │ │ │ const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_audio_stream_channels( │ │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the stream channel configuration. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_CHANNEL_CONF(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_depth.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_depth.3alleg5 │ │ │ │ │ @@ -6,12 +6,14 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth( │ │ │ │ │ const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_audio_stream_depth( │ │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the stream audio depth. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_AUDIO_DEPTH(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_event_source.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_event_source.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source( │ │ │ │ │ ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_audio_stream_event_source( │ │ │ │ │ + ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Retrieve the associated event source. │ │ │ │ │ .PP │ │ │ │ │ See al_get_audio_stream_fragment(3alleg5) for a description of the │ │ │ │ │ ALLEGRO_EVENT_AUDIO_STREAM_FRAGMENT(3alleg5) event that audio streams │ │ │ │ │ emit. │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_fragment.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_fragment.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_audio_stream_fragment \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +void *al_get_audio_stream_fragment(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ When using Allegro\[cq]s audio streaming, you will use this function to │ │ │ │ │ continuously provide new sample data to a stream. │ │ │ │ │ .PP │ │ │ │ │ If the stream is ready for new data, the function will return the │ │ │ │ │ address of an internal buffer to be filled with audio data. │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_fragments.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_fragments.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_audio_stream_fragments \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +unsigned int al_get_audio_stream_fragments(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the number of fragments this stream uses. │ │ │ │ │ This is the same value as passed to al_create_audio_stream(3alleg5) when │ │ │ │ │ a new stream is created. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_available_audio_stream_fragments(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_frequency.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_frequency.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ al_get_audio_stream_frequency \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +unsigned int al_get_audio_stream_frequency(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the stream frequency (in Hz). │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_gain.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_gain.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_audio_stream_gain \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +float al_get_audio_stream_gain(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the playback gain of the stream. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_audio_stream_gain(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_length.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_length.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ al_get_audio_stream_length \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +unsigned int al_get_audio_stream_length(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the stream length in samples. │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_length_secs.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_length_secs.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_audio_stream_length_secs \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +double al_get_audio_stream_length_secs(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the length of the stream in seconds, if known. │ │ │ │ │ Otherwise returns zero. │ │ │ │ │ .PP │ │ │ │ │ Currently this can only be called on streams created with │ │ │ │ │ al_load_audio_stream(3alleg5), al_play_audio_stream(3alleg5), │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_pan.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_pan.3alleg5 │ │ │ │ │ @@ -4,13 +4,14 @@ │ │ │ │ │ .SH NAME │ │ │ │ │ al_get_audio_stream_pan \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ +float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *streamR *mixer, ALLEGRO_MIXER_QUALITY new_quality) │ │ │ │ │ float al_get_audio_stream_pan(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get the pan value of the stream. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_audio_stream_pan(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_played_samples.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_played_samples.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_audio_stream_played_samples \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +uint64_t al_get_audio_stream_played_samples(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get the number of samples consumed by the parent since the audio stream │ │ │ │ │ was started. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.8 │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_playing.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_playing.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_audio_stream_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +bool al_get_audio_stream_playing(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return true if the stream is playing. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_audio_stream_playing(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_playmode.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_playmode.3alleg5 │ │ │ │ │ @@ -6,12 +6,14 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_PLAYMODE al_get_audio_stream_playmode( │ │ │ │ │ const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +ALLEGRO_PLAYMODE al_get_audio_stream_playmode( │ │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the playback mode of the stream. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_PLAYMODE(3alleg5), al_set_audio_stream_playmode(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_position_secs.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_position_secs.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_audio_stream_position_secs \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +double al_get_audio_stream_position_secs(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the position of the stream in seconds. │ │ │ │ │ Currently this can only be called on streams created with │ │ │ │ │ al_load_audio_stream(3alleg5), al_play_audio_stream(3alleg5), │ │ │ │ │ al_load_audio_stream_f(3alleg5) or al_play_audio_stream_f(3alleg5). │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_get_audio_stream_speed.3alleg5.gz │ │ │ │ ├── al_get_audio_stream_speed.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_audio_stream_speed \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +float al_get_audio_stream_speed(const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the relative playback speed of the stream. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_audio_stream_speed(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_available_audio_stream_fragments.3alleg5.gz │ │ │ │ ├── al_get_available_audio_stream_fragments.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_available_audio_stream_fragments( │ │ │ │ │ const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +unsigned int al_get_available_audio_stream_fragments( │ │ │ │ │ + const ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the number of available fragments in the stream, that is, │ │ │ │ │ fragments which are not currently filled with data for playback. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_audio_stream_fragment(3alleg5), │ │ │ │ │ al_get_audio_stream_fragments(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_channel_count.3alleg5.gz │ │ │ │ ├── al_get_channel_count.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_get_channel_count \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf) │ │ │ │ │ +size_t al_get_channel_count(ALLEGRO_CHANNEL_CONF conf) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the number of channels for the given channel configuration, which │ │ │ │ │ is one of the values listed under ALLEGRO_CHANNEL_CONF(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_default_menu_event_source.3alleg5.gz │ │ │ │ ├── al_get_default_menu_event_source.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_default_menu_event_source \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_default_menu_event_source(void) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_default_menu_event_source(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the default event source used for menu clicks. │ │ │ │ │ If a menu was not given its own event source via │ │ │ │ │ al_enable_menu_event_source(3alleg5), then it will use this default │ │ │ │ │ source. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/al_get_default_mixer.3alleg5.gz │ │ │ │ ├── al_get_default_mixer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_default_mixer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MIXER *al_get_default_mixer(void) │ │ │ │ │ +ALLEGRO_MIXER *al_get_default_mixer(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the default mixer, or NULL if one has not been set. │ │ │ │ │ Although different configurations of mixers and voices can be used, in │ │ │ │ │ most cases a single mixer attached to a voice is what you want. │ │ │ │ │ The default mixer is used by al_play_sample(3alleg5). │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_get_default_voice.3alleg5.gz │ │ │ │ ├── al_get_default_voice.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_default_voice \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_VOICE *al_get_default_voice(void) │ │ │ │ │ +ALLEGRO_VOICE *al_get_default_voice(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the default voice or NULL if there is none. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.13 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_default_mixer(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_display_menu.3alleg5.gz │ │ │ │ ├── al_get_display_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_display_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MENU *al_get_display_menu(ALLEGRO_DISPLAY *display) │ │ │ │ │ +ALLEGRO_MENU *al_get_display_menu(ALLEGRO_DISPLAY *displaynt, │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the menu associated with the \f[CR]display\f[R], or │ │ │ │ │ \f[CR]NULL\f[R] if it does not have a menu. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_get_fallback_font.3alleg5.gz │ │ │ │ ├── al_get_fallback_font.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_fallback_font \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_get_fallback_font(ALLEGRO_FONT *font) │ │ │ │ │ +ALLEGRO_FONT *al_get_fallback_font(ALLEGRO_FONT *font) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Retrieves the fallback font for this font or NULL. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.12 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_fallback_font(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_font_ascent.3alleg5.gz │ │ │ │ ├── al_get_font_ascent.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_font_ascent \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_font_ascent(const ALLEGRO_FONT *f) │ │ │ │ │ +int al_get_font_ascent(const ALLEGRO_FONT *f) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the ascent of the specified font. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_font_descent(3alleg5), al_get_font_line_height(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_font_descent.3alleg5.gz │ │ │ │ ├── al_get_font_descent.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_font_descent \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_font_descent(const ALLEGRO_FONT *f) │ │ │ │ │ +int al_get_font_descent(const ALLEGRO_FONT *f) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the descent of the specified font. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_font_ascent(3alleg5), al_get_font_line_height(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_font_line_height.3alleg5.gz │ │ │ │ ├── al_get_font_line_height.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_font_line_height \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_font_line_height(const ALLEGRO_FONT *f) │ │ │ │ │ +int al_get_font_line_height(const ALLEGRO_FONT *f) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the usual height of a line of text in the specified font. │ │ │ │ │ For bitmap fonts this is simply the height of all glyph bitmaps. │ │ │ │ │ For truetype fonts it is whatever the font file specifies. │ │ │ │ │ In particular, some special glyphs may be higher than the height │ │ │ │ │ returned here. │ │ │ ├── ./usr/share/man/man3/al_get_font_ranges.3alleg5.gz │ │ │ │ ├── al_get_font_ranges.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_font_ranges \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_font_ranges(ALLEGRO_FONT *f, int ranges_count, int *ranges) │ │ │ │ │ +int al_get_font_ranges(ALLEGRO_FONT *f, int ranges_count, int *ranges) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Gets information about all glyphs contained in a font, as a list of │ │ │ │ │ ranges. │ │ │ │ │ Ranges have the same format as with al_grab_font_from_bitmap(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ \f[CR]ranges_count\f[R] is the maximum number of ranges that will be │ │ │ ├── ./usr/share/man/man3/al_get_glyph.3alleg5.gz │ │ │ │ ├── al_get_glyph.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_glyph \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_glyph(const ALLEGRO_FONT *f, int prev_codepoint, int codepoint, ALLEGRO_GLYPH *glyph) │ │ │ │ │ +bool al_get_glyph(const ALLEGRO_FONT *f, int prev_codepoint, int codepoint, ALLEGRO_GLYPH *glyph) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Gets all the information about a glyph, including the bitmap, needed to │ │ │ │ │ draw it yourself. │ │ │ │ │ prev_codepoint is the codepoint in the string before the one you want to │ │ │ │ │ draw and is used for kerning. │ │ │ │ │ codepoint is the character you want to get info about. │ │ │ ├── ./usr/share/man/man3/al_get_glyph_advance.3alleg5.gz │ │ │ │ ├── al_get_glyph_advance.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_glyph_advance \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_glyph_advance(const ALLEGRO_FONT *f, int codepoint1, int codepoint2) │ │ │ │ │ +int al_get_glyph_advance(const ALLEGRO_FONT *f, int codepoint1, int codepoint2) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This function returns by how much the x position should be advanced for │ │ │ │ │ left to right text drawing when the glyph that corresponds to codepoint1 │ │ │ │ │ has been drawn, and the glyph that corresponds to codepoint2 will be the │ │ │ │ │ next to be drawn. │ │ │ │ │ This takes into consideration the horizontal advance width of the glyph │ │ │ ├── ./usr/share/man/man3/al_get_glyph_dimensions.3alleg5.gz │ │ │ │ ├── al_get_glyph_dimensions.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_glyph_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ int codepoint, int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ +bool al_get_glyph_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ + int codepoint, int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sometimes, the al_get_glyph_width(3alleg5) or │ │ │ │ │ al_get_glyph_advance(3alleg5) functions are not enough for exact glyph │ │ │ │ │ placement, so this function returns some additional information, │ │ │ │ │ particularly if you want to draw the font vertically. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_get_glyph_width.3alleg5.gz │ │ │ │ ├── al_get_glyph_width.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_glyph_width \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_glyph_width(const ALLEGRO_FONT *f, int codepoint) │ │ │ │ │ +int al_get_glyph_width(const ALLEGRO_FONT *f, int codepoint) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This function returns the width in pixels of the glyph that corresponds │ │ │ │ │ with \f[CR]codepoint\f[R] in the font \f[CR]font\f[R]. │ │ │ │ │ Returns zero if the font does not have such a glyph. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.12 │ │ │ ├── ./usr/share/man/man3/al_get_index_buffer_size.3alleg5.gz │ │ │ │ ├── al_get_index_buffer_size.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_index_buffer_size \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_index_buffer_size(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ +int al_get_index_buffer_size(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the size of the index buffer │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.8 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_INDEX_BUFFER(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_menu_item_caption.3alleg5.gz │ │ │ │ ├── al_get_menu_item_caption.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_menu_item_caption \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ const char *al_get_menu_item_caption(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ +const char *al_get_menu_item_caption(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the caption associated with the menu item. │ │ │ │ │ It is valid as long as the caption is not modified. │ │ │ │ │ .PP │ │ │ │ │ Returns \f[CR]NULL\f[R] if the item was not found. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/al_get_menu_item_flags.3alleg5.gz │ │ │ │ ├── al_get_menu_item_flags.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_menu_item_flags \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_menu_item_flags(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ +int al_get_menu_item_flags(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the currently set flags. │ │ │ │ │ See al_insert_menu_item(3alleg5) for a description of the available │ │ │ │ │ flags. │ │ │ │ │ .PP │ │ │ │ │ Returns \-1 if the item was not found. │ │ │ ├── ./usr/share/man/man3/al_get_menu_item_icon.3alleg5.gz │ │ │ │ ├── al_get_menu_item_icon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_menu_item_icon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_BITMAP *al_get_menu_item_icon(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ +ALLEGRO_BITMAP *al_get_menu_item_icon(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the icon associated with the menu. │ │ │ │ │ It is safe to draw to the returned bitmap, but you must call │ │ │ │ │ al_set_menu_item_icon(3alleg5) in order for the changes to be applied. │ │ │ │ │ .PP │ │ │ │ │ Returns \f[CR]NULL\f[R] if the item was not found or if it has no icon. │ │ │ ├── ./usr/share/man/man3/al_get_mixer_attached.3alleg5.gz │ │ │ │ ├── al_get_mixer_attached.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_mixer_attached \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_get_mixer_attached(const ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return true if the mixer is attached to something. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_mixer_has_attachments(3alleg5), │ │ │ │ │ al_attach_sample_instance_to_mixer(3alleg5), │ │ │ │ │ al_attach_audio_stream_to_mixer(3alleg5), │ │ │ ├── ./usr/share/man/man3/al_get_mixer_channels.3alleg5.gz │ │ │ │ ├── al_get_mixer_channels.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_mixer_channels \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_mixer_channels(const ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the mixer channel configuration. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_CHANNEL_CONF(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_mixer_depth.3alleg5.gz │ │ │ │ ├── al_get_mixer_depth.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_mixer_depth \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_mixer_depth(const ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the mixer audio depth. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_AUDIO_DEPTH(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_mixer_frequency.3alleg5.gz │ │ │ │ ├── al_get_mixer_frequency.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_mixer_frequency \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +unsigned int al_get_mixer_frequency(const ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the mixer frequency (in Hz). │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_mixer_frequency(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_mixer_gain.3alleg5.gz │ │ │ │ ├── al_get_mixer_gain.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_mixer_gain \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_mixer_gain(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +float al_get_mixer_gain(const ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the mixer gain (amplification factor). │ │ │ │ │ The default is 1.0. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.0.6, 5.1.0 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_get_mixer_playing.3alleg5.gz │ │ │ │ ├── al_get_mixer_playing.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_mixer_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_get_mixer_playing(const ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return true if the mixer is playing. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_mixer_playing(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_mixer_quality.3alleg5.gz │ │ │ │ ├── al_get_mixer_quality.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_mixer_quality \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer) │ │ │ │ │ +ALLEGRO_MIXER_QUALITY al_get_mixer_quality(const ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the mixer quality. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_MIXER_QUALITY(3alleg5), al_set_mixer_quality(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_native_file_dialog_count.3alleg5.gz │ │ │ │ ├── al_get_native_file_dialog_count.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ al_get_native_file_dialog_count \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_native_file_dialog_count(const ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ +int al_get_native_file_dialog_count(const ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the number of files selected, or 0 if the dialog was cancelled. │ │ │ ├── ./usr/share/man/man3/al_get_native_file_dialog_path.3alleg5.gz │ │ │ │ ├── al_get_native_file_dialog_path.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ const char *al_get_native_file_dialog_path( │ │ │ │ │ const ALLEGRO_FILECHOOSER *dialog, size_t i) │ │ │ │ │ +const char *al_get_native_file_dialog_path( │ │ │ │ │ + const ALLEGRO_FILECHOOSER *dialog, size_t i) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns one of the selected paths with index \f[CR]i\f[R]. │ │ │ │ │ The index should range from \f[CR]0\f[R] to the return value of │ │ │ │ │ al_get_native_file_dialog_count(3alleg5) \f[CR]\-1\f[R]. │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_get_native_text_log_event_source.3alleg5.gz │ │ │ │ ├── al_get_native_text_log_event_source.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_native_text_log_event_source( │ │ │ │ │ ALLEGRO_TEXTLOG *textlog) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_native_text_log_event_source( │ │ │ │ │ + ALLEGRO_TEXTLOG *textlog) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get an event source for a text log window. │ │ │ │ │ The possible events are: │ │ │ │ │ .TP │ │ │ │ │ ALLEGRO_EVENT_NATIVE_DIALOG_CLOSE │ │ │ │ │ The window was requested to be closed, either by pressing the close │ │ │ ├── ./usr/share/man/man3/al_get_num_audio_output_devices.3alleg5.gz │ │ │ │ ├── al_get_num_audio_output_devices.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_num_audio_output_devices \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_num_audio_output_devices() │ │ │ │ │ +int al_get_num_audio_output_devices() │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get the number of available audio output devices on the system. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.8 │ │ │ │ │ .PP │ │ │ │ │ return \-1 for unsupported drivers. │ │ │ ├── ./usr/share/man/man3/al_get_sample.3alleg5.gz │ │ │ │ ├── al_get_sample.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_sample \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +ALLEGRO_SAMPLE *al_get_sample(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the sample data that the sample instance plays. │ │ │ │ │ .PP │ │ │ │ │ Note this returns a pointer to an internal structure, \f[I]not\f[R] the │ │ │ │ │ ALLEGRO_SAMPLE(3alleg5) that you may have passed to │ │ │ │ │ al_set_sample(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_sample_channels.3alleg5.gz │ │ │ │ ├── al_get_sample_channels.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_sample_channels \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_sample_channels(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the channel configuration of the sample. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_CHANNEL_CONF(3alleg5), al_get_sample_depth(3alleg5), │ │ │ │ │ al_get_sample_frequency(3alleg5), al_get_sample_length(3alleg5), │ │ │ │ │ al_get_sample_data(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_data.3alleg5.gz │ │ │ │ ├── al_get_sample_data.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_sample_data \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void *al_get_sample_data(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +void *al_get_sample_data(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return a pointer to the raw sample data. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_sample_channels(3alleg5), al_get_sample_depth(3alleg5), │ │ │ │ │ al_get_sample_frequency(3alleg5), al_get_sample_length(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_depth.3alleg5.gz │ │ │ │ ├── al_get_sample_depth.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_sample_depth \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_sample_depth(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the audio depth of the sample. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_AUDIO_DEPTH(3alleg5), al_get_sample_channels(3alleg5), │ │ │ │ │ al_get_sample_frequency(3alleg5), al_get_sample_length(3alleg5), │ │ │ │ │ al_get_sample_data(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_frequency.3alleg5.gz │ │ │ │ ├── al_get_sample_frequency.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_sample_frequency \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +unsigned int al_get_sample_frequency(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the frequency (in Hz) of the sample. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_sample_channels(3alleg5), al_get_sample_depth(3alleg5), │ │ │ │ │ al_get_sample_length(3alleg5), al_get_sample_data(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_attached.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_attached.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_sample_instance_attached \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_get_sample_instance_attached(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return whether the sample instance is attached to something. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_attach_sample_instance_to_mixer(3alleg5), │ │ │ │ │ al_attach_sample_instance_to_voice(3alleg5), │ │ │ │ │ al_detach_sample_instance(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_channels.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_channels.3alleg5 │ │ │ │ │ @@ -6,13 +6,15 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels( │ │ │ │ │ const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_sample_instance_channels( │ │ │ │ │ + const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the channel configuration of the sample instance\[cq]s sample │ │ │ │ │ data. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_CHANNEL_CONF(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_depth.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_depth.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_sample_instance_depth \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_sample_instance_depth(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the audio depth of the sample instance\[cq]s sample data. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_AUDIO_DEPTH(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_frequency.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_frequency.3alleg5 │ │ │ │ │ @@ -5,10 +5,11 @@ │ │ │ │ │ al_get_sample_instance_frequency \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +unsigned int al_get_sample_instance_frequency(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the frequency (in Hz) of the sample instance\[cq]s sample data. │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_gain.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_gain.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_sample_instance_gain \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +float al_get_sample_instance_gain(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the playback gain of the sample instance. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_sample_instance_gain(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_length.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_length.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_sample_instance_length \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +unsigned int al_get_sample_instance_length(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the length of the sample instance in sample values. │ │ │ │ │ This property may differ from the length of the instance\[cq]s sample │ │ │ │ │ data. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_sample_instance_length(3alleg5), │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_pan.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_pan.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_sample_instance_pan \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +float al_get_sample_instance_pan(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get the pan value of the sample instance. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_sample_instance_pan(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_playing.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_playing.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_sample_instance_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_get_sample_instance_playing(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return true if the sample instance is in the playing state. │ │ │ │ │ This may be true even if the instance is not attached to anything. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_sample_instance_playing(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_playmode.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_playmode.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_sample_instance_playmode \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +ALLEGRO_PLAYMODE al_get_sample_instance_playmode(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the playback mode of the sample instance. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_PLAYMODE(3alleg5), al_set_sample_instance_playmode(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_position.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_position.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_sample_instance_position \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +unsigned int al_get_sample_instance_position(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get the playback position of a sample instance. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_sample_instance_position(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_speed.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_speed.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_sample_instance_speed \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +float al_get_sample_instance_speed(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the relative playback speed of the sample instance. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_sample_instance_speed(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_instance_time.3alleg5.gz │ │ │ │ ├── al_get_sample_instance_time.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_sample_instance_time \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +float al_get_sample_instance_time(const ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the length of the sample instance in seconds, assuming a playback │ │ │ │ │ speed of 1.0. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_sample_instance_length(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_sample_length.3alleg5.gz │ │ │ │ ├── al_get_sample_length.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_sample_length \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ +unsigned int al_get_sample_length(const ALLEGRO_SAMPLE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the length of the sample in sample values. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_sample_channels(3alleg5), al_get_sample_depth(3alleg5), │ │ │ │ │ al_get_sample_frequency(3alleg5), al_get_sample_data(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_text_dimensions.3alleg5.gz │ │ │ │ ├── al_get_text_dimensions.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_get_text_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ char const *text, │ │ │ │ │ int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ +void al_get_text_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ + char const *text, │ │ │ │ │ + int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sometimes, the al_get_text_width(3alleg5) and │ │ │ │ │ al_get_font_line_height(3alleg5) functions are not enough for exact text │ │ │ │ │ placement, so this function returns some additional information. │ │ │ │ │ .PP │ │ │ │ │ Returned variables (all in pixels): │ │ │ ├── ./usr/share/man/man3/al_get_text_width.3alleg5.gz │ │ │ │ ├── al_get_text_width.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_text_width \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_text_width(const ALLEGRO_FONT *f, const char *str) │ │ │ │ │ +int al_get_text_width(const ALLEGRO_FONT *f, const char *str) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Calculates the length of a string in a particular font, in pixels. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_ustr_width(3alleg5), al_get_font_line_height(3alleg5), │ │ │ │ │ al_get_text_dimensions(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_ustr_dimensions.3alleg5.gz │ │ │ │ ├── al_get_ustr_dimensions.3alleg5 │ │ │ │ │ @@ -7,13 +7,16 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_get_ustr_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ ALLEGRO_USTR const *ustr, │ │ │ │ │ int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ +void al_get_ustr_dimensions(const ALLEGRO_FONT *f, │ │ │ │ │ + ALLEGRO_USTR const *ustr, │ │ │ │ │ + int *bbx, int *bby, int *bbw, int *bbh) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_get_text_dimensions(3alleg5), except the text is passed as an │ │ │ │ │ ALLEGRO_USTR instead of a NUL\-terminated char array. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_text_dimensions(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_ustr_width.3alleg5.gz │ │ │ │ ├── al_get_ustr_width.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_ustr_width \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_ustr_width(const ALLEGRO_FONT *f, ALLEGRO_USTR const *ustr) │ │ │ │ │ +int al_get_ustr_width(const ALLEGRO_FONT *f, ALLEGRO_USTR const *ustr) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_get_text_width(3alleg5) but expects an ALLEGRO_USTR. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_text_width(3alleg5), al_get_ustr_dimensions(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_vertex_buffer_size.3alleg5.gz │ │ │ │ ├── al_get_vertex_buffer_size.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_vertex_buffer_size \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_get_vertex_buffer_size(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ +int al_get_vertex_buffer_size(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the size of the vertex buffer │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.8 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_VERTEX_BUFFER(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_video_audio_rate.3alleg5.gz │ │ │ │ ├── al_get_video_audio_rate.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_video_audio_rate \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ double al_get_video_audio_rate(ALLEGRO_VIDEO *video) │ │ │ │ │ +double al_get_video_audio_rate(ALLEGRO_VIDEO *video) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the audio rate of the video, in Hz. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_get_video_event_source.3alleg5.gz │ │ │ │ ├── al_get_video_event_source.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_video_event_source \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_EVENT_SOURCE *al_get_video_event_source(ALLEGRO_VIDEO *video) │ │ │ │ │ +ALLEGRO_EVENT_SOURCE *al_get_video_event_source(ALLEGRO_VIDEO *video) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Get an event source for the video. │ │ │ │ │ The possible events are described under │ │ │ │ │ ALLEGRO_VIDEO_EVENT_TYPE(3alleg5). │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_get_video_fps.3alleg5.gz │ │ │ │ ├── al_get_video_fps.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_get_video_fps \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ double al_get_video_fps(ALLEGRO_VIDEO *video) │ │ │ │ │ +double al_get_video_fps(ALLEGRO_VIDEO *video) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the speed of the video in frames per second. │ │ │ │ │ Often this will not be an integer value. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_get_video_frame.3alleg5.gz │ │ │ │ ├── al_get_video_frame.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_video_frame \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video) │ │ │ │ │ +ALLEGRO_BITMAP *al_get_video_frame(ALLEGRO_VIDEO *video) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the current video frame. │ │ │ │ │ The bitmap is owned by the video so do not attempt to free it. │ │ │ │ │ The bitmap will stay valid until the next call to al_get_video_frame. │ │ │ │ │ .PP │ │ │ │ │ Videos often do not use square pixels so the recommended way to draw a │ │ │ ├── ./usr/share/man/man3/al_get_video_position.3alleg5.gz │ │ │ │ ├── al_get_video_position.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_video_position \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ double al_get_video_position(ALLEGRO_VIDEO *video, ALLEGRO_VIDEO_POSITION_TYPE which) │ │ │ │ │ +double al_get_video_position(ALLEGRO_VIDEO *video, ALLEGRO_VIDEO_POSITION_TYPE which) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the current position of the video stream in seconds since the │ │ │ │ │ beginning. │ │ │ │ │ The parameter is one of the ALLEGRO_VIDEO_POSITION_TYPE(3alleg5) │ │ │ │ │ constants. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/al_get_video_scaled_height.3alleg5.gz │ │ │ │ ├── al_get_video_scaled_height.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_video_scaled_height \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_video_scaled_height(ALLEGRO_VIDEO *video) │ │ │ │ │ +float al_get_video_scaled_height(ALLEGRO_VIDEO *video) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the height with which the video frame should be drawn. │ │ │ │ │ Videos often do not use square pixels, so this will may return a value │ │ │ │ │ larger than the height of the frame bitmap. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_video_frame(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_video_scaled_width.3alleg5.gz │ │ │ │ ├── al_get_video_scaled_width.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_video_scaled_width \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ float al_get_video_scaled_width(ALLEGRO_VIDEO *video) │ │ │ │ │ +float al_get_video_scaled_width(ALLEGRO_VIDEO *video) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns the width with which the video frame should be drawn. │ │ │ │ │ Videos often do not use square pixels, so this will may return a value │ │ │ │ │ larger than the width of the frame bitmap. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.12 │ │ │ ├── ./usr/share/man/man3/al_get_voice_channels.3alleg5.gz │ │ │ │ ├── al_get_voice_channels.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_voice_channels \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice) │ │ │ │ │ +ALLEGRO_CHANNEL_CONF al_get_voice_channels(const ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the channel configuration of the voice. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_CHANNEL_CONF(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_voice_depth.3alleg5.gz │ │ │ │ ├── al_get_voice_depth.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_voice_depth \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice) │ │ │ │ │ +ALLEGRO_AUDIO_DEPTH al_get_voice_depth(const ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the audio depth of the voice. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_AUDIO_DEPTH(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_get_voice_frequency.3alleg5.gz │ │ │ │ ├── al_get_voice_frequency.3alleg5 │ │ │ │ │ @@ -4,11 +4,12 @@ │ │ │ │ │ .SH NAME │ │ │ │ │ al_get_voice_frequency \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ +unsigned int al_get_voic) │ │ │ │ │ unsigned int al_get_voice_frequency(const ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return the frequency of the voice (in Hz), e.g.\ 44100. │ │ │ ├── ./usr/share/man/man3/al_get_voice_playing.3alleg5.gz │ │ │ │ ├── al_get_voice_playing.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_get_voice_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_get_voice_playing(const ALLEGRO_VOICE *voice) │ │ │ │ │ +bool al_get_voice_playing(const ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Return true if the voice is currently playing. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_voice_playing(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_get_voice_position.3alleg5.gz │ │ │ │ ├── al_get_voice_position.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_get_voice_position \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice) │ │ │ │ │ +unsigned int al_get_voice_position(const ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ When the voice has a non\-streaming object attached to it, e.g.\ a │ │ │ │ │ sample, returns the voice\[cq]s current sample position. │ │ │ │ │ Otherwise, returns zero. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_set_voice_position(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_grab_font_from_bitmap.3alleg5.gz │ │ │ │ ├── al_grab_font_from_bitmap.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_grab_font_from_bitmap(ALLEGRO_BITMAP *bmp, │ │ │ │ │ int ranges_n, const int ranges[]) │ │ │ │ │ +ALLEGRO_FONT *al_grab_font_from_bitmap(ALLEGRO_BITMAP *bmp, │ │ │ │ │ + int ranges_n, const int ranges[]) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Creates a new font from an Allegro bitmap. │ │ │ │ │ You can delete the bitmap after the function returns as the font will │ │ │ │ │ contain a copy for itself. │ │ │ │ │ .PP │ │ │ │ │ Parameters: │ │ │ ├── ./usr/share/man/man3/al_identify_sample.3alleg5.gz │ │ │ │ ├── al_identify_sample.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_identify_sample \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ char const *al_identify_sample(char const *filename) │ │ │ │ │ +char const *al_identify_sample(char const *filename) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This works exactly as al_identify_sample_f(3alleg5) but you specify the │ │ │ │ │ filename of the file for which to detect the type and not a file handle. │ │ │ │ │ The extension, if any, of the passed filename is not taken into account │ │ │ │ │ \- only the file contents. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/al_identify_sample_f.3alleg5.gz │ │ │ │ ├── al_identify_sample_f.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_identify_sample_f \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ char const *al_identify_sample_f(ALLEGRO_FILE *fp) │ │ │ │ │ +char const *al_identify_sample_f(ALLEGRO_FILE *fp) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Tries to guess the audio file type of the open ALLEGRO_FILE by reading │ │ │ │ │ the first few bytes. │ │ │ │ │ By default Allegro cannot recognize any file types, but calling │ │ │ │ │ al_init_acodec_addon(3alleg5) will add detection of the types it can │ │ │ │ │ read. │ │ │ ├── ./usr/share/man/man3/al_identify_video.3alleg5.gz │ │ │ │ ├── al_identify_video.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_identify_video \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ char const *al_identify_video(char const *filename) │ │ │ │ │ +char const *al_identify_video(char const *filename) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This works exactly as al_identify_video_f(3alleg5) but you specify the │ │ │ │ │ filename of the file for which to detect the type and not a file handle. │ │ │ │ │ The extension, if any, of the passed filename is not taken into account │ │ │ │ │ \- only the file contents. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/al_identify_video_f.3alleg5.gz │ │ │ │ ├── al_identify_video_f.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_identify_video_f \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ char const *al_identify_video_f(ALLEGRO_FILE *fp) │ │ │ │ │ +char const *al_identify_video_f(ALLEGRO_FILE *fp) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Tries to guess the video file type of the open ALLEGRO_FILE by reading │ │ │ │ │ the first few bytes. │ │ │ │ │ By default Allegro cannot recognize any file types, but calling │ │ │ │ │ al_init_video_addon(3alleg5) will add detection of the types it can │ │ │ │ │ read. │ │ │ ├── ./usr/share/man/man3/al_init.3alleg5.gz │ │ │ │ ├── al_init.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_init \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define al_init() (al_install_system(ALLEGRO_VERSION_INT, atexit)) │ │ │ │ │ +#define al_init() (al_install_system(ALLEGRO_VERSION_INT, atexit)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_install_system(3alleg5), but automatically passes in the version │ │ │ │ │ and uses the atexit function visible in the current binary. │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ │ │ Note: It is typically wrong to call al_init anywhere except the final │ │ │ ├── ./usr/share/man/man3/al_init_acodec_addon.3alleg5.gz │ │ │ │ ├── al_init_acodec_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_init_acodec_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_init_acodec_addon(void) │ │ │ │ │ +bool al_init_acodec_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This function registers all the known audio file type handlers for │ │ │ │ │ al_load_sample(3alleg5), al_save_sample(3alleg5), │ │ │ │ │ al_load_audio_stream(3alleg5), etc. │ │ │ │ │ .PP │ │ │ │ │ Depending on what libraries are available, the full set of recognised │ │ │ ├── ./usr/share/man/man3/al_init_font_addon.3alleg5.gz │ │ │ │ ├── al_init_font_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_init_font_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_init_font_addon(void) │ │ │ │ │ +bool al_init_font_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Initialise the font addon. │ │ │ │ │ .PP │ │ │ │ │ Note that if you intend to load bitmap fonts, you will need to │ │ │ │ │ initialise allegro_image separately (unless you are using another │ │ │ │ │ library to load images). │ │ │ ├── ./usr/share/man/man3/al_init_image_addon.3alleg5.gz │ │ │ │ ├── al_init_image_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_init_image_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_init_image_addon(void) │ │ │ │ │ +bool al_init_image_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Initializes the image addon. │ │ │ │ │ This registers bitmap format handlers for al_load_bitmap(3alleg5), │ │ │ │ │ al_load_bitmap_f(3alleg5), al_save_bitmap(3alleg5), │ │ │ │ │ al_save_bitmap_f(3alleg5). │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_init_native_dialog_addon.3alleg5.gz │ │ │ │ ├── al_init_native_dialog_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_init_native_dialog_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_init_native_dialog_addon(void) │ │ │ │ │ +bool al_init_native_dialog_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Initialise the native dialog addon. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on error. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.0.9, 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_init_primitives_addon.3alleg5.gz │ │ │ │ ├── al_init_primitives_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_init_primitives_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_init_primitives_addon(void) │ │ │ │ │ +bool al_init_primitives_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Initializes the primitives addon. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Returns:\f[R] True on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_shutdown_primitives_addon(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_init_ttf_addon.3alleg5.gz │ │ │ │ ├── al_init_ttf_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_init_ttf_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_init_ttf_addon(void) │ │ │ │ │ +bool al_init_ttf_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Call this after al_init_font_addon(3alleg5) to make │ │ │ │ │ al_load_font(3alleg5) recognize \[lq].ttf\[rq] and other formats │ │ │ │ │ supported by al_load_ttf_font(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ ├── ./usr/share/man/man3/al_init_video_addon.3alleg5.gz │ │ │ │ ├── al_init_video_addon.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_init_video_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_init_video_addon(void) │ │ │ │ │ +bool al_init_video_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Initializes the video addon. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.12 │ │ │ ├── ./usr/share/man/man3/al_insert_menu_item.3alleg5.gz │ │ │ │ ├── al_insert_menu_item.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_insert_menu_item(ALLEGRO_MENU *parent, int pos, char const *title, │ │ │ │ │ uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ │ +int al_insert_menu_item(ALLEGRO_MENU *parent, int pos, char const *title, │ │ │ │ │ + uint16_t id, int flags, ALLEGRO_BITMAP *icon, ALLEGRO_MENU *submenu) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Inserts a menu item at the spot specified. │ │ │ │ │ See the introductory text for a detailed explanation of how the │ │ │ │ │ \f[CR]pos\f[R] parameter is interpreted. │ │ │ │ │ .PP │ │ │ │ │ The \f[CR]parent\f[R] menu can be a popup menu or a regular menu. │ │ │ ├── ./usr/share/man/man3/al_install_audio.3alleg5.gz │ │ │ │ ├── al_install_audio.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_install_audio \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_install_audio(void) │ │ │ │ │ +bool al_install_audio(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Install the audio subsystem. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .RS │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_is_acodec_addon_initialized.3alleg5.gz │ │ │ │ ├── al_is_acodec_addon_initialized.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_is_acodec_addon_initialized \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_acodec_addon_initialized(void) │ │ │ │ │ +bool al_is_acodec_addon_initialized(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the acodec addon is initialized, otherwise returns │ │ │ │ │ false. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.6 │ │ │ ├── ./usr/share/man/man3/al_is_audio_installed.3alleg5.gz │ │ │ │ ├── al_is_audio_installed.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_is_audio_installed \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_audio_installed(void) │ │ │ │ │ +bool al_is_audio_installed(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if al_install_audio(3alleg5) was called previously and │ │ │ │ │ returned successfully. │ │ │ ├── ./usr/share/man/man3/al_is_audio_recorder_recording.3alleg5.gz │ │ │ │ ├── al_is_audio_recorder_recording.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_is_audio_recorder_recording \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +bool al_is_audio_recorder_recording(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the audio recorder is currently capturing data and │ │ │ │ │ generating events. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.1 │ │ │ │ │ .RS │ │ │ ├── ./usr/share/man/man3/al_is_font_addon_initialized.3alleg5.gz │ │ │ │ ├── al_is_font_addon_initialized.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_is_font_addon_initialized \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_font_addon_initialized(void) │ │ │ │ │ +bool al_is_font_addon_initialized(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the font addon is initialized, otherwise returns false. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.6 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_init_font_addon(3alleg5), al_shutdown_font_addon(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_is_image_addon_initialized.3alleg5.gz │ │ │ │ ├── al_is_image_addon_initialized.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_is_image_addon_initialized \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_image_addon_initialized(void) │ │ │ │ │ +bool al_is_image_addon_initialized(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the image addon is initialized, otherwise returns false. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.6 │ │ │ ├── ./usr/share/man/man3/al_is_native_dialog_addon_initialized.3alleg5.gz │ │ │ │ ├── al_is_native_dialog_addon_initialized.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_is_native_dialog_addon_initialized \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_native_dialog_addon_initialized(void) │ │ │ │ │ +bool al_is_native_dialog_addon_initialized(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the native dialog addon is initialized, otherwise │ │ │ │ │ returns false. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.6 │ │ │ ├── ./usr/share/man/man3/al_is_primitives_addon_initialized.3alleg5.gz │ │ │ │ ├── al_is_primitives_addon_initialized.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_is_primitives_addon_initialized \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_primitives_addon_initialized(void) │ │ │ │ │ +bool al_is_primitives_addon_initialized(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the primitives addon is initialized, otherwise returns │ │ │ │ │ false. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.6 │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_is_ttf_addon_initialized.3alleg5.gz │ │ │ │ ├── al_is_ttf_addon_initialized.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_is_ttf_addon_initialized \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_ttf_addon_initialized(void) │ │ │ │ │ +bool al_is_ttf_addon_initialized(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the TTF addon is initialized, otherwise returns false. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.6 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_init_ttf_addon(3alleg5), al_shutdown_ttf_addon(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_is_video_addon_initialized.3alleg5.gz │ │ │ │ ├── al_is_video_addon_initialized.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_is_video_addon_initialized \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_video_addon_initialized(void) │ │ │ │ │ +bool al_is_video_addon_initialized(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the video addon is initialized, otherwise returns false. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.2.6 │ │ │ ├── ./usr/share/man/man3/al_is_video_playing.3alleg5.gz │ │ │ │ ├── al_is_video_playing.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_is_video_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_is_video_playing(ALLEGRO_VIDEO *video) │ │ │ │ │ +bool al_is_video_playing(ALLEGRO_VIDEO *video) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the video is currently playing. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.12 │ │ │ ├── ./usr/share/man/man3/al_load_audio_stream.3alleg5.gz │ │ │ │ ├── al_load_audio_stream.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename, │ │ │ │ │ size_t buffer_count, unsigned int samples) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_load_audio_stream(const char *filename, │ │ │ │ │ + size_t buffer_count, unsigned int samples) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Loads an audio file from disk as it is needed. │ │ │ │ │ .PP │ │ │ │ │ Unlike regular streams, the one returned by this function need not be │ │ │ │ │ fed by the user; the library will automatically read more of the file as │ │ │ │ │ it is needed. │ │ │ ├── ./usr/share/man/man3/al_load_audio_stream_f.3alleg5.gz │ │ │ │ ├── al_load_audio_stream_f.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident, │ │ │ │ │ size_t buffer_count, unsigned int samples) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_load_audio_stream_f(ALLEGRO_FILE* fp, const char *ident, │ │ │ │ │ + size_t buffer_count, unsigned int samples) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Loads an audio file from ALLEGRO_FILE(3alleg5) stream as it is needed. │ │ │ │ │ .PP │ │ │ │ │ Unlike regular streams, the one returned by this function need not be │ │ │ │ │ fed by the user; the library will automatically read more of the file as │ │ │ │ │ it is needed. │ │ │ ├── ./usr/share/man/man3/al_load_bitmap_font.3alleg5.gz │ │ │ │ ├── al_load_bitmap_font.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_load_bitmap_font \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_load_bitmap_font(const char *fname) │ │ │ │ │ +ALLEGRO_FONT *al_load_bitmap_font(const char *fname) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Load a bitmap font from a file. │ │ │ │ │ This is done by first calling al_load_bitmap_flags(3alleg5) and then │ │ │ │ │ al_grab_font_from_bitmap(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ If you wanted to load an old A4 font, for example, it would be better to │ │ │ ├── ./usr/share/man/man3/al_load_bitmap_font_flags.3alleg5.gz │ │ │ │ ├── al_load_bitmap_font_flags.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_load_bitmap_font_flags \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_load_bitmap_font_flags(const char *fname, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_bitmap_font_flags(const char *fname, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_load_bitmap_font(3alleg5) but additionally takes a flags │ │ │ │ │ parameter which is a bitfield containing a combination of the following: │ │ │ │ │ .TP │ │ │ │ │ ALLEGRO_NO_PREMULTIPLIED_ALPHA │ │ │ │ │ The same meaning as for al_load_bitmap_flags(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_load_font.3alleg5.gz │ │ │ │ ├── al_load_font.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_load_font \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_load_font(char const *filename, int size, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_font(char const *filename, int size, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Loads a font from disk. │ │ │ │ │ This will use al_load_bitmap_font_flags(3alleg5) if you pass the name of │ │ │ │ │ a known bitmap format, or else al_load_ttf_font(3alleg5). │ │ │ │ │ .PP │ │ │ │ │ The flags parameter is passed through to either of those functions. │ │ │ ├── ./usr/share/man/man3/al_load_sample.3alleg5.gz │ │ │ │ ├── al_load_sample.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_load_sample \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_SAMPLE *al_load_sample(const char *filename) │ │ │ │ │ +ALLEGRO_SAMPLE *al_load_sample(const char *filename) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Loads a few different audio file formats based on their extension. │ │ │ │ │ .PP │ │ │ │ │ Note that this stores the entire file in memory at once, which may be │ │ │ │ │ time consuming. │ │ │ │ │ To read the file as it is needed, use al_load_audio_stream(3alleg5) or │ │ │ ├── ./usr/share/man/man3/al_load_sample_f.3alleg5.gz │ │ │ │ ├── al_load_sample_f.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_load_sample_f \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident) │ │ │ │ │ +ALLEGRO_SAMPLE *al_load_sample_f(ALLEGRO_FILE* fp, const char *ident) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Loads an audio file from an ALLEGRO_FILE(3alleg5) stream into an │ │ │ │ │ ALLEGRO_SAMPLE(3alleg5). │ │ │ │ │ The file type is determined by the passed `ident' parameter, which is a │ │ │ │ │ file name extension including the leading dot. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_load_ttf_font.3alleg5.gz │ │ │ │ ├── al_load_ttf_font.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_load_ttf_font \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font(char const *filename, int size, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Loads a TrueType font from a file using the FreeType library. │ │ │ │ │ Quoting from the FreeType FAQ this means support for many different font │ │ │ │ │ formats: │ │ │ │ │ .PP │ │ │ │ │ \f[I]TrueType, OpenType, Type1, CID, CFF, Windows FON/FNT, X11 PCF, and │ │ │ ├── ./usr/share/man/man3/al_load_ttf_font_f.3alleg5.gz │ │ │ │ ├── al_load_ttf_font_f.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_load_ttf_font_f(ALLEGRO_FILE *file, │ │ │ │ │ char const *filename, int size, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_f(ALLEGRO_FILE *file, │ │ │ │ │ + char const *filename, int size, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_load_ttf_font(3alleg5), but the font is read from the file │ │ │ │ │ handle. │ │ │ │ │ The filename is only used to find possible additional files next to a │ │ │ │ │ font file. │ │ │ │ │ .RS │ │ │ ├── ./usr/share/man/man3/al_load_ttf_font_stretch.3alleg5.gz │ │ │ │ ├── al_load_ttf_font_stretch.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h, │ │ │ │ │ int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_stretch(char const *filename, int w, int h, │ │ │ │ │ + int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_load_ttf_font(3alleg5), except it takes separate width and │ │ │ │ │ height parameters instead of a single size parameter. │ │ │ │ │ .PP │ │ │ │ │ If the height is a positive value, and the width zero or positive, then │ │ │ │ │ font will be stretched according to those parameters. │ │ │ ├── ./usr/share/man/man3/al_load_ttf_font_stretch_f.3alleg5.gz │ │ │ │ ├── al_load_ttf_font_stretch_f.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FONT *al_load_ttf_font_stretch_f(ALLEGRO_FILE *file, │ │ │ │ │ char const *filename, int w, int h, int flags) │ │ │ │ │ +ALLEGRO_FONT *al_load_ttf_font_stretch_f(ALLEGRO_FILE *file, │ │ │ │ │ + char const *filename, int w, int h, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_load_ttf_font_stretch(3alleg5), but the font is read from the │ │ │ │ │ file handle. │ │ │ │ │ The filename is only used to find possible additional files next to a │ │ │ │ │ font file. │ │ │ │ │ .RS │ │ │ ├── ./usr/share/man/man3/al_lock_index_buffer.3alleg5.gz │ │ │ │ ├── al_lock_index_buffer.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void* al_lock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer, int offset, │ │ │ │ │ int length, int flags) │ │ │ │ │ +void* al_lock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer, int offset, │ │ │ │ │ + int length, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Locks a index buffer so you can access its data. │ │ │ │ │ Will return NULL if the parameters are invalid, if reading is requested │ │ │ │ │ from a write only buffer and if the buffer is already locked. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ ├── ./usr/share/man/man3/al_lock_sample_id.3alleg5.gz │ │ │ │ ├── al_lock_sample_id.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_lock_sample_id \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ +ALLEGRO_SAMPLE_INSTANCE* al_lock_sample_id(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Locks a ALLEGRO_SAMPLE_ID(3alleg5), returning the underlying │ │ │ │ │ ALLEGRO_SAMPLE_INSTANCE(3alleg5). │ │ │ │ │ This allows you to adjust the various properties of the instance (such │ │ │ │ │ as volume, pan, etc) while the sound is playing. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_lock_vertex_buffer.3alleg5.gz │ │ │ │ ├── al_lock_vertex_buffer.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void* al_lock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer, int offset, │ │ │ │ │ int length, int flags) │ │ │ │ │ +void* al_lock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer, int offset, │ │ │ │ │ + int length, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Locks a vertex buffer so you can access its data. │ │ │ │ │ Will return NULL if the parameters are invalid, if reading is requested │ │ │ │ │ from a write only buffer, or if the buffer is already locked. │ │ │ │ │ .PP │ │ │ │ │ \f[I]Parameters:\f[R] │ │ │ ├── ./usr/share/man/man3/al_malloc.3alleg5.gz │ │ │ │ ├── al_malloc.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define al_malloc(n) \[rs] │ │ │ │ │ (al_malloc_with_context((n), __LINE__, __FILE__, __func__)) │ │ │ │ │ +#define al_malloc(n) \[rs] │ │ │ │ │ + (al_malloc_with_context((n), __LINE__, __FILE__, __func__)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like malloc() in the C standard library, but the implementation may be │ │ │ │ │ overridden. │ │ │ │ │ .PP │ │ │ │ │ This is a macro. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_mixer_has_attachments.3alleg5.gz │ │ │ │ ├── al_mixer_has_attachments.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_mixer_has_attachments \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer) │ │ │ │ │ +bool al_mixer_has_attachments(const ALLEGRO_MIXER* mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the mixer has something attached to it. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_mixer_attached(3alleg5), │ │ │ │ │ al_attach_sample_instance_to_mixer(3alleg5), │ │ │ │ │ al_attach_audio_stream_to_mixer(3alleg5), │ │ │ ├── ./usr/share/man/man3/al_open_memfile.3alleg5.gz │ │ │ │ ├── al_open_memfile.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_open_memfile \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_FILE *al_open_memfile(void *mem, int64_t size, const char *mode) │ │ │ │ │ +ALLEGRO_FILE *al_open_memfile(void *mem, int64_t size, const char *mode) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns a file handle to the block of memory. │ │ │ │ │ All read and write operations act upon the memory directly, so it must │ │ │ │ │ not be freed while the file remains open. │ │ │ │ │ .PP │ │ │ │ │ The mode can be any combination of \[lq]r\[rq] (readable) and │ │ │ ├── ./usr/share/man/man3/al_open_native_text_log.3alleg5.gz │ │ │ │ ├── al_open_native_text_log.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_open_native_text_log \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_TEXTLOG *al_open_native_text_log(char const *title, int flags) │ │ │ │ │ +ALLEGRO_TEXTLOG *al_open_native_text_log(char const *title, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Opens a window to which you can append log messages with │ │ │ │ │ al_append_native_text_log(3alleg5). │ │ │ │ │ This can be useful for debugging if you don\[cq]t want to depend on a │ │ │ │ │ console being available. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_open_video.3alleg5.gz │ │ │ │ ├── al_open_video.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_open_video \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_VIDEO *al_open_video(char const *filename) │ │ │ │ │ +ALLEGRO_VIDEO *al_open_video(char const *filename) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Reads a video file. │ │ │ │ │ This does not start playing yet but reads the meta info so you can query │ │ │ │ │ e.g.\ the size or audio rate. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_play_audio_stream.3alleg5.gz │ │ │ │ ├── al_play_audio_stream.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_play_audio_stream \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_play_audio_stream(const char *filename) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Loads and plays an audio file, streaming from disk as it is needed. │ │ │ │ │ This API can only play one audio stream at a time. │ │ │ │ │ This requires a default mixer to be set, which is typically done via │ │ │ │ │ al_reserve_samples(3alleg5), but can also be done via │ │ │ │ │ al_set_default_mixer(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_play_audio_stream_f.3alleg5.gz │ │ │ │ ├── al_play_audio_stream_f.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_play_audio_stream_f \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident) │ │ │ │ │ +ALLEGRO_AUDIO_STREAM *al_play_audio_stream_f(ALLEGRO_FILE *fp, const char *ident) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Loads and plays an audio file from ALLEGRO_FILE(3alleg5) stream, │ │ │ │ │ streaming it is needed. │ │ │ │ │ This API can only play one audio stream at a time. │ │ │ │ │ This requires a default mixer to be set, which is typically done via │ │ │ │ │ al_reserve_samples(3alleg5), but can also be done via │ │ │ ├── ./usr/share/man/man3/al_play_sample.3alleg5.gz │ │ │ │ ├── al_play_sample.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed, │ │ │ │ │ ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id) │ │ │ │ │ +bool al_play_sample(ALLEGRO_SAMPLE *spl, float gain, float pan, float speed, │ │ │ │ │ + ALLEGRO_PLAYMODE loop, ALLEGRO_SAMPLE_ID *ret_id) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Plays a sample on one of the sample instances created by │ │ │ │ │ al_reserve_samples(3alleg5). │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ Playback may fail because all the reserved sample instances are │ │ │ │ │ currently used. │ │ │ ├── ./usr/share/man/man3/al_play_sample_instance.3alleg5.gz │ │ │ │ ├── al_play_sample_instance.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_play_sample_instance \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_play_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Play the sample instance. │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_stop_sample_instance(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_popup_menu.3alleg5.gz │ │ │ │ ├── al_popup_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_popup_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display) │ │ │ │ │ +bool al_popup_menu(ALLEGRO_MENU *popup, ALLEGRO_DISPLAY *display) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Displays a context menu next to the mouse cursor. │ │ │ │ │ The menu must have been created with al_create_popup_menu(3alleg5). │ │ │ │ │ It generates events just like a regular display menu does. │ │ │ │ │ It is possible that the menu will be canceled without any selection │ │ │ │ │ being made. │ │ │ ├── ./usr/share/man/man3/al_realloc.3alleg5.gz │ │ │ │ ├── al_realloc.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ #define al_realloc(p, n) \[rs] │ │ │ │ │ (al_realloc_with_context((p), (n), __LINE__, __FILE__, __func__)) │ │ │ │ │ +#define al_realloc(p, n) \[rs] │ │ │ │ │ + (al_realloc_with_context((p), (n), __LINE__, __FILE__, __func__)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like realloc() in the C standard library, but the implementation may be │ │ │ │ │ overridden. │ │ │ │ │ .PP │ │ │ │ │ This is a macro. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_register_audio_stream_loader.3alleg5.gz │ │ │ │ ├── al_register_audio_stream_loader.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_register_audio_stream_loader(const char *ext, │ │ │ │ │ ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename, │ │ │ │ │ +bool al_register_audio_stream_loader(const char *ext, │ │ │ │ │ + ALLEGRO_AUDIO_STREAM *(*stream_loader)(const char *filename, │ │ │ │ │ size_t buffer_count, unsigned int samples)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Register a handler for al_load_audio_stream(3alleg5) and │ │ │ │ │ al_play_audio_stream(3alleg5). │ │ │ │ │ The given function will be used to open streams from files with the │ │ │ │ │ given extension. │ │ │ ├── ./usr/share/man/man3/al_register_audio_stream_loader_f.3alleg5.gz │ │ │ │ ├── al_register_audio_stream_loader_f.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_register_audio_stream_loader_f(const char *ext, │ │ │ │ │ ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp, │ │ │ │ │ size_t buffer_count, unsigned int samples)) │ │ │ │ │ +bool al_register_audio_stream_loader_f(const char *ext, │ │ │ │ │ + ALLEGRO_AUDIO_STREAM *(*stream_loader)(ALLEGRO_FILE* fp, │ │ │ │ │ + size_t buffer_count, unsigned int samples)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Register a handler for al_load_audio_stream_f(3alleg5) and │ │ │ │ │ al_play_audio_stream_f(3alleg5). │ │ │ │ │ The given function will be used to open streams from files with the │ │ │ │ │ given extension. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_register_font_loader.3alleg5.gz │ │ │ │ ├── al_register_font_loader.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_register_font_loader(char const *extension, │ │ │ │ │ ALLEGRO_FONT *(*load_font)(char const *filename, int size, int flags)) │ │ │ │ │ +bool al_register_font_loader(char const *extension, │ │ │ │ │ + ALLEGRO_FONT *(*load_font)(char const *filename, int size, int flags)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Informs Allegro of a new font file type, telling it how to load files of │ │ │ │ │ this format. │ │ │ │ │ .PP │ │ │ │ │ The \f[CR]extension\f[R] should include the leading dot (`.') character. │ │ │ │ │ It will be matched case\-insensitively. │ │ │ ├── ./usr/share/man/man3/al_register_sample_identifier.3alleg5.gz │ │ │ │ ├── al_register_sample_identifier.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_register_sample_identifier(const char *ext, │ │ │ │ │ bool (*identifier)(ALLEGRO_FILE* fp)) │ │ │ │ │ +bool al_register_sample_identifier(const char *ext, │ │ │ │ │ + bool (*identifier)(ALLEGRO_FILE* fp)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Register an identify handler for al_identify_sample(3alleg5). │ │ │ │ │ The given function will be used to detect files for the given extension. │ │ │ │ │ It will be called with a single argument of type ALLEGRO_FILE(3alleg5) │ │ │ │ │ which is a file handle opened for reading and located at the first byte │ │ │ │ │ of the file. │ │ │ ├── ./usr/share/man/man3/al_register_sample_loader.3alleg5.gz │ │ │ │ ├── al_register_sample_loader.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_register_sample_loader(const char *ext, │ │ │ │ │ ALLEGRO_SAMPLE *(*loader)(const char *filename)) │ │ │ │ │ +bool al_register_sample_loader(const char *ext, │ │ │ │ │ + ALLEGRO_SAMPLE *(*loader)(const char *filename)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Register a handler for al_load_sample(3alleg5). │ │ │ │ │ The given function will be used to handle the loading of sample files │ │ │ │ │ with the given extension. │ │ │ │ │ .PP │ │ │ │ │ The extension should include the leading dot (`.') character. │ │ │ ├── ./usr/share/man/man3/al_register_sample_loader_f.3alleg5.gz │ │ │ │ ├── al_register_sample_loader_f.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_register_sample_loader_f(const char *ext, │ │ │ │ │ ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp)) │ │ │ │ │ +bool al_register_sample_loader_f(const char *ext, │ │ │ │ │ + ALLEGRO_SAMPLE *(*loader)(ALLEGRO_FILE* fp)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Register a handler for al_load_sample_f(3alleg5). │ │ │ │ │ The given function will be used to handle the loading of sample files │ │ │ │ │ with the given extension. │ │ │ │ │ .PP │ │ │ │ │ The extension should include the leading dot (`.') character. │ │ │ ├── ./usr/share/man/man3/al_register_sample_saver.3alleg5.gz │ │ │ │ ├── al_register_sample_saver.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_register_sample_saver(const char *ext, │ │ │ │ │ bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl)) │ │ │ │ │ +bool al_register_sample_saver(const char *ext, │ │ │ │ │ + bool (*saver)(const char *filename, ALLEGRO_SAMPLE *spl)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Register a handler for al_save_sample(3alleg5). │ │ │ │ │ The given function will be used to handle the saving of sample files │ │ │ │ │ with the given extension. │ │ │ │ │ .PP │ │ │ │ │ The extension should include the leading dot (`.') character. │ │ │ ├── ./usr/share/man/man3/al_register_sample_saver_f.3alleg5.gz │ │ │ │ ├── al_register_sample_saver_f.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_register_sample_saver_f(const char *ext, │ │ │ │ │ bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl)) │ │ │ │ │ +bool al_register_sample_saver_f(const char *ext, │ │ │ │ │ + bool (*saver)(ALLEGRO_FILE* fp, ALLEGRO_SAMPLE *spl)) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Register a handler for al_save_sample_f(3alleg5). │ │ │ │ │ The given function will be used to handle the saving of sample files │ │ │ │ │ with the given extension. │ │ │ │ │ .PP │ │ │ │ │ The extension should include the leading dot (`.') character. │ │ │ ├── ./usr/share/man/man3/al_remove_display_menu.3alleg5.gz │ │ │ │ ├── al_remove_display_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_remove_display_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ ALLEGRO_MENU *al_remove_display_menu(ALLEGRO_DISPLAY *display) │ │ │ │ │ +ALLEGRO_MENU *al_remove_display_menu(ALLEGRO_DISPLAY *display) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Detaches the menu associated with the display and returns it. │ │ │ │ │ The menu can then be used on a different display. │ │ │ │ │ .PP │ │ │ │ │ If you simply want to destroy the active menu, you can call │ │ │ │ │ al_set_display_menu(3alleg5) with a \f[CR]NULL\f[R] menu. │ │ │ ├── ./usr/share/man/man3/al_remove_menu_item.3alleg5.gz │ │ │ │ ├── al_remove_menu_item.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_remove_menu_item \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ +bool al_remove_menu_item(ALLEGRO_MENU *menu, int pos) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Removes the specified item from the menu and destroys it. │ │ │ │ │ If the item contains a sub\-menu, it too is destroyed. │ │ │ │ │ Any references to it are invalidated. │ │ │ │ │ If you want to preserve that sub\-menu, you should first make a copy │ │ │ │ │ with al_clone_menu(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_reserve_samples.3alleg5.gz │ │ │ │ ├── al_reserve_samples.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_reserve_samples \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_reserve_samples(int reserve_samples) │ │ │ │ │ +bool al_reserve_samples(int reserve_samples) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Reserves a number of sample instances, attaching them to the default │ │ │ │ │ mixer. │ │ │ │ │ If no default mixer is set when this function is called, then it will │ │ │ │ │ create one and attach it to the default voice. │ │ │ │ │ If no default voice has been set, it, too, will be created. │ │ │ ├── ./usr/share/man/man3/al_restore_default_mixer.3alleg5.gz │ │ │ │ ├── al_restore_default_mixer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_restore_default_mixer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_restore_default_mixer(void) │ │ │ │ │ +bool al_restore_default_mixer(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Restores Allegro\[cq]s default mixer and attaches it to the default │ │ │ │ │ voice. │ │ │ │ │ If the default mixer hasn\[cq]t been created before, it will be created. │ │ │ │ │ If the default voice hasn\[cq]t been set via │ │ │ │ │ al_set_default_voice(3alleg5) or created before, it will also be │ │ │ ├── ./usr/share/man/man3/al_rewind_audio_stream.3alleg5.gz │ │ │ │ ├── al_rewind_audio_stream.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_rewind_audio_stream \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ +bool al_rewind_audio_stream(ALLEGRO_AUDIO_STREAM *stream) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the streaming file playing position to the beginning. │ │ │ │ │ Returns true on success. │ │ │ │ │ Currently this can only be called on streams created with │ │ │ │ │ al_load_audio_stream(3alleg5), al_play_audio_stream(3alleg5), │ │ │ │ │ al_load_audio_stream_f(3alleg5) or al_play_audio_stream_f(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_save_sample.3alleg5.gz │ │ │ │ ├── al_save_sample.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_save_sample \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl) │ │ │ │ │ +bool al_save_sample(const char *filename, ALLEGRO_SAMPLE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Writes a sample into a file. │ │ │ │ │ Currently, wav is the only supported format, and the extension must be │ │ │ │ │ \[lq].wav\[rq]. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on error. │ │ │ ├── ./usr/share/man/man3/al_save_sample_f.3alleg5.gz │ │ │ │ ├── al_save_sample_f.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_save_sample_f \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl) │ │ │ │ │ +bool al_save_sample_f(ALLEGRO_FILE *fp, const char *ident, ALLEGRO_SAMPLE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Writes a sample into a ALLEGRO_FILE(3alleg5) filestream. │ │ │ │ │ Currently, wav is the only supported format, and the extension must be │ │ │ │ │ \[lq].wav\[rq]. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on error. │ │ │ ├── ./usr/share/man/man3/al_seek_audio_stream_secs.3alleg5.gz │ │ │ │ ├── al_seek_audio_stream_secs.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_seek_audio_stream_secs \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time) │ │ │ │ │ +bool al_seek_audio_stream_secs(ALLEGRO_AUDIO_STREAM *stream, double time) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the streaming file playing position to time. │ │ │ │ │ Returns true on success. │ │ │ │ │ Currently this can only be called on streams created with │ │ │ │ │ al_load_audio_stream(3alleg5), al_play_audio_stream(3alleg5), │ │ │ │ │ al_load_audio_stream_f(3alleg5) or al_play_audio_stream_f(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_seek_video.3alleg5.gz │ │ │ │ ├── al_seek_video.3alleg5 │ │ │ │ │ @@ -5,13 +5,14 @@ │ │ │ │ │ al_seek_video \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_seek_video(ALLEGRO_VIDEO *video, double pos_in_seconds) │ │ │ │ │ +bool al_seek_video(ALLEGRO_VIDEO *video, double pos_in_seconds) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Seek to a different position in the video. │ │ │ │ │ Currently only seeking to the beginning of the video is supported. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_set_audio_stream_fragment.3alleg5.gz │ │ │ │ ├── al_set_audio_stream_fragment.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_audio_stream_fragment \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val) │ │ │ │ │ +bool al_set_audio_stream_fragment(ALLEGRO_AUDIO_STREAM *stream, void *val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This function needs to be called for every successful call of │ │ │ │ │ al_get_audio_stream_fragment(3alleg5) to indicate that the buffer │ │ │ │ │ (pointed to by \f[CR]val\f[R]) is filled with new data. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_audio_stream_fragment(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_set_audio_stream_gain.3alleg5.gz │ │ │ │ ├── al_set_audio_stream_gain.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_audio_stream_gain \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ +bool al_set_audio_stream_gain(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the playback gain of the stream. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ Will fail if the audio stream is attached directly to a voice. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_set_audio_stream_loop_secs.3alleg5.gz │ │ │ │ ├── al_set_audio_stream_loop_secs.3alleg5 │ │ │ │ │ @@ -6,13 +6,15 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ double start, double end) │ │ │ │ │ +bool al_set_audio_stream_loop_secs(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ + double start, double end) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sets the loop points for the stream in seconds. │ │ │ │ │ Currently this can only be called on streams created with │ │ │ │ │ al_load_audio_stream(3alleg5), al_play_audio_stream(3alleg5), │ │ │ │ │ al_load_audio_stream_f(3alleg5) or al_play_audio_stream_f(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_set_audio_stream_pan.3alleg5.gz │ │ │ │ ├── al_set_audio_stream_pan.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_audio_stream_pan \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ +bool al_set_audio_stream_pan(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the pan value on an audio stream. │ │ │ │ │ A value of \-1.0 means to play the stream only through the left speaker; │ │ │ │ │ +1.0 means only through the right speaker; 0.0 means the sample is │ │ │ │ │ centre balanced. │ │ │ │ │ A special value ALLEGRO_AUDIO_PAN_NONE(3alleg5) disables panning and │ │ │ ├── ./usr/share/man/man3/al_set_audio_stream_playing.3alleg5.gz │ │ │ │ ├── al_set_audio_stream_playing.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_audio_stream_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val) │ │ │ │ │ +bool al_set_audio_stream_playing(ALLEGRO_AUDIO_STREAM *stream, bool val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Change whether the stream is playing. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_audio_stream_playing(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_set_audio_stream_playmode.3alleg5.gz │ │ │ │ ├── al_set_audio_stream_playmode.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ ALLEGRO_PLAYMODE val) │ │ │ │ │ +bool al_set_audio_stream_playmode(ALLEGRO_AUDIO_STREAM *stream, │ │ │ │ │ + ALLEGRO_PLAYMODE val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the playback mode of the stream. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_PLAYMODE(3alleg5), al_get_audio_stream_playmode(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_set_audio_stream_speed.3alleg5.gz │ │ │ │ ├── al_set_audio_stream_speed.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_audio_stream_speed \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ +bool al_set_audio_stream_speed(ALLEGRO_AUDIO_STREAM *stream, float val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the relative playback speed of the stream. │ │ │ │ │ 1.0 means normal speed. │ │ │ │ │ .PP │ │ │ │ │ Return true on success, false on failure. │ │ │ │ │ Will fail if the audio stream is attached directly to a voice. │ │ │ ├── ./usr/share/man/man3/al_set_default_mixer.3alleg5.gz │ │ │ │ ├── al_set_default_mixer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_default_mixer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_default_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ +bool al_set_default_mixer(ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sets the default mixer. │ │ │ │ │ All samples started with al_play_sample(3alleg5) will be stopped and all │ │ │ │ │ sample instances returned by al_lock_sample_id(3alleg5) will be │ │ │ │ │ invalidated. │ │ │ │ │ If you are using your own mixer, this should be called before │ │ │ ├── ./usr/share/man/man3/al_set_default_voice.3alleg5.gz │ │ │ │ ├── al_set_default_voice.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_default_voice \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_set_default_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ +void al_set_default_voice(ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ You can call this before calling al_restore_default_mixer to provide the │ │ │ │ │ voice which should be used. │ │ │ │ │ Any previous voice will be destroyed. │ │ │ │ │ You can also pass NULL to destroy the current default voice. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/al_set_display_menu.3alleg5.gz │ │ │ │ ├── al_set_display_menu.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_display_menu \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu) │ │ │ │ │ +bool al_set_display_menu(ALLEGRO_DISPLAY *display, ALLEGRO_MENU *menu) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Associates the \f[CR]menu\f[R] with the \f[CR]display\f[R] and shows it. │ │ │ │ │ If there was a previous menu associated with the display, it will be │ │ │ │ │ destroyed. │ │ │ │ │ If you don\[cq]t want that to happen, you should first remove the menu │ │ │ │ │ with al_remove_display_menu(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_set_fallback_font.3alleg5.gz │ │ │ │ ├── al_set_fallback_font.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_fallback_font \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_set_fallback_font(ALLEGRO_FONT *font, ALLEGRO_FONT *fallback) │ │ │ │ │ +void al_set_fallback_font(ALLEGRO_FONT *font, ALLEGRO_FONT *fallback) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sets a font which is used instead if a character is not present. │ │ │ │ │ Can be chained, but make sure there is no loop as that would crash the │ │ │ │ │ application! │ │ │ │ │ Pass NULL to remove a fallback font again. │ │ │ │ │ .SH SINCE │ │ │ ├── ./usr/share/man/man3/al_set_menu_item_caption.3alleg5.gz │ │ │ │ ├── al_set_menu_item_caption.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_menu_item_caption \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_set_menu_item_caption(ALLEGRO_MENU *menu, int pos, const char *caption) │ │ │ │ │ +void al_set_menu_item_caption(ALLEGRO_MENU *menu, int pos, const char *caption) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Updates the menu item caption with the new \f[CR]caption\f[R]. │ │ │ │ │ This will invalidate any previous calls to │ │ │ │ │ al_get_menu_item_caption(3alleg5). │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_set_menu_item_flags.3alleg5.gz │ │ │ │ ├── al_set_menu_item_flags.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_menu_item_flags \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_set_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags) │ │ │ │ │ +void al_set_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Updates the menu item\[cq]s flags. │ │ │ │ │ See al_insert_menu_item(3alleg5) for a description of the available │ │ │ │ │ flags. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_set_menu_item_icon.3alleg5.gz │ │ │ │ ├── al_set_menu_item_icon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_menu_item_icon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_set_menu_item_icon(ALLEGRO_MENU *menu, int pos, ALLEGRO_BITMAP *icon) │ │ │ │ │ +void al_set_menu_item_icon(ALLEGRO_MENU *menu, int pos, ALLEGRO_BITMAP *icon) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sets the icon for the specified menu item. │ │ │ │ │ The menu assumes ownership of the \f[CR]ALLEGRO_BITMAP\f[R] and may │ │ │ │ │ invalidate the pointer, so you must clone it if you wish to continue │ │ │ │ │ using it. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_set_mixer_frequency.3alleg5.gz │ │ │ │ ├── al_set_mixer_frequency.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_mixer_frequency \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val) │ │ │ │ │ +bool al_set_mixer_frequency(ALLEGRO_MIXER *mixer, unsigned int val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the mixer frequency (in Hz). │ │ │ │ │ This will only work if the mixer is not attached to anything. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_set_mixer_gain.3alleg5.gz │ │ │ │ ├── al_set_mixer_gain.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_mixer_gain \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain) │ │ │ │ │ +bool al_set_mixer_gain(ALLEGRO_MIXER *mixer, float new_gain) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the mixer gain (amplification factor). │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.0.6, 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_set_mixer_playing.3alleg5.gz │ │ │ │ ├── al_set_mixer_playing.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_mixer_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val) │ │ │ │ │ +bool al_set_mixer_playing(ALLEGRO_MIXER *mixer, bool val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Change whether the mixer is playing. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_mixer_playing(3alleg5). │ │ │ ├── ./usr/share/man/man3/al_set_mixer_postprocess_callback.3alleg5.gz │ │ │ │ ├── al_set_mixer_postprocess_callback.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer, │ │ │ │ │ void (*pp_callback)(void *buf, unsigned int samples, void *data), │ │ │ │ │ void *pp_callback_userdata) │ │ │ │ │ +bool al_set_mixer_postprocess_callback(ALLEGRO_MIXER *mixer, │ │ │ │ │ + void (*pp_callback)(void *buf, unsigned int samples, void *data), │ │ │ │ │ + void *pp_callback_userdata) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Sets a post\-processing filter function that\[cq]s called after the │ │ │ │ │ attached streams have been mixed. │ │ │ │ │ The buffer\[cq]s format will be whatever the mixer was created with. │ │ │ │ │ The sample count and user\-data pointer is also passed. │ │ │ │ │ .RS │ │ │ ├── ./usr/share/man/man3/al_set_physfs_file_interface.3alleg5.gz │ │ │ │ ├── al_set_physfs_file_interface.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_physfs_file_interface \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_set_physfs_file_interface(void) │ │ │ │ │ +void al_set_physfs_file_interface(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ This function sets \f[I]both\f[R] the ALLEGRO_FILE_INTERFACE(3alleg5) │ │ │ │ │ and ALLEGRO_FS_INTERFACE(3alleg5) for the calling thread. │ │ │ │ │ .PP │ │ │ │ │ Subsequent calls to al_fopen(3alleg5) on the calling thread will be │ │ │ │ │ handled by PHYSFS_open(). │ │ │ ├── ./usr/share/man/man3/al_set_sample.3alleg5.gz │ │ │ │ ├── al_set_sample.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_sample \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data) │ │ │ │ │ +bool al_set_sample(ALLEGRO_SAMPLE_INSTANCE *spl, ALLEGRO_SAMPLE *data) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Change the sample data that a sample instance plays. │ │ │ │ │ This can be quite an involved process. │ │ │ │ │ .PP │ │ │ │ │ First, the sample is stopped if it is not already. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_set_sample_instance_channel_matrix.3alleg5.gz │ │ │ │ ├── al_set_sample_instance_channel_matrix.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_sample_instance_channel_matrix \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const float *matrix) │ │ │ │ │ +bool al_set_sample_instance_channel_matrix(ALLEGRO_SAMPLE_INSTANCE *spl, const float *matrix) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the matrix used to mix the channels coming from this instance into │ │ │ │ │ the mixer it is attached to. │ │ │ │ │ Normally Allegro derives the values of this matrix from the gain and pan │ │ │ │ │ settings, as well as the channel configurations of this instance and the │ │ │ │ │ mixer it is attached to, but this allows you override that default │ │ │ ├── ./usr/share/man/man3/al_set_sample_instance_gain.3alleg5.gz │ │ │ │ ├── al_set_sample_instance_gain.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_sample_instance_gain \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ +bool al_set_sample_instance_gain(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the playback gain of the sample instance. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ Will fail if the sample instance is attached directly to a voice. │ │ │ │ │ .SH SEE ALSO │ │ │ ├── ./usr/share/man/man3/al_set_sample_instance_length.3alleg5.gz │ │ │ │ ├── al_set_sample_instance_length.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ unsigned int val) │ │ │ │ │ +bool al_set_sample_instance_length(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + unsigned int val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the length of the sample instance in sample values. │ │ │ │ │ This can be used to play only parts of the underlying sample. │ │ │ │ │ Be careful not to exceed the actual length of the sample data, though. │ │ │ │ │ .PP │ │ │ │ │ Return true on success, false on failure. │ │ │ ├── ./usr/share/man/man3/al_set_sample_instance_pan.3alleg5.gz │ │ │ │ ├── al_set_sample_instance_pan.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_sample_instance_pan \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ +bool al_set_sample_instance_pan(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the pan value on a sample instance. │ │ │ │ │ A value of \-1.0 means to play the sample only through the left speaker; │ │ │ │ │ +1.0 means only through the right speaker; 0.0 means the sample is │ │ │ │ │ centre balanced. │ │ │ │ │ A special value ALLEGRO_AUDIO_PAN_NONE(3alleg5) disables panning and │ │ │ ├── ./usr/share/man/man3/al_set_sample_instance_playing.3alleg5.gz │ │ │ │ ├── al_set_sample_instance_playing.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_sample_instance_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val) │ │ │ │ │ +bool al_set_sample_instance_playing(ALLEGRO_SAMPLE_INSTANCE *spl, bool val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Change whether the sample instance is playing. │ │ │ │ │ .PP │ │ │ │ │ The instance does not need to be attached to anything (since: 5.1.8). │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ ├── ./usr/share/man/man3/al_set_sample_instance_playmode.3alleg5.gz │ │ │ │ ├── al_set_sample_instance_playmode.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ ALLEGRO_PLAYMODE val) │ │ │ │ │ +bool al_set_sample_instance_playmode(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + ALLEGRO_PLAYMODE val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the playback mode of the sample instance. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_PLAYMODE(3alleg5), al_get_sample_instance_playmode(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_set_sample_instance_position.3alleg5.gz │ │ │ │ ├── al_set_sample_instance_position.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ unsigned int val) │ │ │ │ │ +bool al_set_sample_instance_position(ALLEGRO_SAMPLE_INSTANCE *spl, │ │ │ │ │ + unsigned int val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the playback position of a sample instance. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_get_sample_instance_position(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_set_sample_instance_speed.3alleg5.gz │ │ │ │ ├── al_set_sample_instance_speed.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_sample_instance_speed \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ +bool al_set_sample_instance_speed(ALLEGRO_SAMPLE_INSTANCE *spl, float val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the relative playback speed of the sample instance. │ │ │ │ │ 1.0 means normal speed. │ │ │ │ │ .PP │ │ │ │ │ Return true on success, false on failure. │ │ │ │ │ Will fail if the sample instance is attached directly to a voice. │ │ │ ├── ./usr/share/man/man3/al_set_video_playing.3alleg5.gz │ │ │ │ ├── al_set_video_playing.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_set_video_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_set_video_playing(ALLEGRO_VIDEO *video, bool play) │ │ │ │ │ +void al_set_video_playing(ALLEGRO_VIDEO *video, bool play) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Paused or resumes playback. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.12 │ │ │ ├── ./usr/share/man/man3/al_set_voice_playing.3alleg5.gz │ │ │ │ ├── al_set_voice_playing.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_voice_playing \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val) │ │ │ │ │ +bool al_set_voice_playing(ALLEGRO_VOICE *voice, bool val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Change whether a voice is playing or not. │ │ │ │ │ This can only work if the voice has a non\-streaming object attached to │ │ │ │ │ it, e.g.\ a sample instance. │ │ │ │ │ On success the voice\[cq]s current sample position is reset. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_set_voice_position.3alleg5.gz │ │ │ │ ├── al_set_voice_position.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_set_voice_position \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val) │ │ │ │ │ +bool al_set_voice_position(ALLEGRO_VOICE *voice, unsigned int val) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Set the voice position. │ │ │ │ │ This can only work if the voice has a non\-streaming object attached to │ │ │ │ │ it, e.g.\ a sample instance. │ │ │ │ │ .PP │ │ │ │ │ Returns true on success, false on failure. │ │ │ ├── ./usr/share/man/man3/al_show_native_file_dialog.3alleg5.gz │ │ │ │ ├── al_show_native_file_dialog.3alleg5 │ │ │ │ │ @@ -6,14 +6,16 @@ │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display, │ │ │ │ │ ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ +bool al_show_native_file_dialog(ALLEGRO_DISPLAY *display, │ │ │ │ │ + ALLEGRO_FILECHOOSER *dialog) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Show the dialog window. │ │ │ │ │ The display may be NULL, otherwise the given display is treated as the │ │ │ │ │ parent if possible. │ │ │ │ │ .PP │ │ │ │ │ This function blocks the calling thread until it returns, so you may │ │ │ ├── ./usr/share/man/man3/al_show_native_message_box.3alleg5.gz │ │ │ │ ├── al_show_native_message_box.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_show_native_message_box(ALLEGRO_DISPLAY *display, │ │ │ │ │ char const *title, char const *heading, char const *text, │ │ │ │ │ char const *buttons, int flags) │ │ │ │ │ +int al_show_native_message_box(ALLEGRO_DISPLAY *display, │ │ │ │ │ + char const *title, char const *heading, char const *text, │ │ │ │ │ + char const *buttons, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Show a native GUI message box. │ │ │ │ │ This can be used for example to display an error message if creation of │ │ │ │ │ an initial display fails. │ │ │ │ │ The display may be NULL, otherwise the given display is treated as the │ │ │ │ │ parent if possible. │ │ │ ├── ./usr/share/man/man3/al_shutdown_font_addon.3alleg5.gz │ │ │ │ ├── al_shutdown_font_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_shutdown_font_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_shutdown_font_addon(void) │ │ │ │ │ +void al_shutdown_font_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Shut down the font addon. │ │ │ │ │ This is done automatically at program exit, but can be called any time │ │ │ │ │ the user wishes as well. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_init_font_addon(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_shutdown_image_addon.3alleg5.gz │ │ │ │ ├── al_shutdown_image_addon.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_shutdown_image_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_shutdown_image_addon(void) │ │ │ │ │ +void al_shutdown_image_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Shut down the image addon. │ │ │ │ │ This is done automatically at program exit, but can be called any time │ │ │ │ │ the user wishes as well. │ │ │ ├── ./usr/share/man/man3/al_shutdown_native_dialog_addon.3alleg5.gz │ │ │ │ ├── al_shutdown_native_dialog_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_shutdown_native_dialog_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_shutdown_native_dialog_addon(void) │ │ │ │ │ +void al_shutdown_native_dialog_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Shut down the native dialog addon. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.0.9, 5.1.5 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_init_native_dialog_addon(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_shutdown_primitives_addon.3alleg5.gz │ │ │ │ ├── al_shutdown_primitives_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_shutdown_primitives_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_shutdown_primitives_addon(void) │ │ │ │ │ +void al_shutdown_primitives_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Shut down the primitives addon. │ │ │ │ │ This is done automatically at program exit, but can be called any time │ │ │ │ │ the user wishes as well. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_init_primitives_addon(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_shutdown_ttf_addon.3alleg5.gz │ │ │ │ ├── al_shutdown_ttf_addon.3alleg5 │ │ │ │ │ @@ -5,11 +5,12 @@ │ │ │ │ │ al_shutdown_ttf_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_shutdown_ttf_addon(void) │ │ │ │ │ +void al_shutdown_ttf_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Unloads the ttf addon again. │ │ │ │ │ You normally don\[cq]t need to call this. │ │ │ ├── ./usr/share/man/man3/al_shutdown_video_addon.3alleg5.gz │ │ │ │ ├── al_shutdown_video_addon.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_shutdown_video_addon \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_shutdown_video_addon(void) │ │ │ │ │ +void al_shutdown_video_addon(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Shut down the video addon. │ │ │ │ │ This is done automatically at program exit, but can be called any time │ │ │ │ │ the user wishes as well. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.12 │ │ │ ├── ./usr/share/man/man3/al_start_audio_recorder.3alleg5.gz │ │ │ │ ├── al_start_audio_recorder.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_start_audio_recorder \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +bool al_start_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Begin recording into the fragment buffer. │ │ │ │ │ Once a complete fragment has been captured (as specified in │ │ │ │ │ al_create_audio_recorder(3alleg5)), an │ │ │ │ │ ALLEGRO_EVENT_AUDIO_RECORDER_FRAGMENT(3alleg5) event will be triggered. │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_start_video.3alleg5.gz │ │ │ │ ├── al_start_video.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_start_video \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_start_video(ALLEGRO_VIDEO *video, ALLEGRO_MIXER *mixer) │ │ │ │ │ +void al_start_video(ALLEGRO_VIDEO *video, ALLEGRO_MIXER *mixer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Starts playing the video from the beginning. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_start_video_with_voice.3alleg5.gz │ │ │ │ ├── al_start_video_with_voice.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_start_video_with_voice \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_start_video_with_voice(ALLEGRO_VIDEO *video, ALLEGRO_VOICE *voice) │ │ │ │ │ +void al_start_video_with_voice(ALLEGRO_VIDEO *video, ALLEGRO_VOICE *voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Like al_start_video(3alleg5) but audio is routed to the provided voice. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.0 │ │ │ ├── ./usr/share/man/man3/al_stop_audio_recorder.3alleg5.gz │ │ │ │ ├── al_stop_audio_recorder.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_stop_audio_recorder \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ +void al_stop_audio_recorder(ALLEGRO_AUDIO_RECORDER *r) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Stop capturing audio data. │ │ │ │ │ Note that the audio recorder is still active and consuming resources, so │ │ │ │ │ if you are finished recording you should destroy it with │ │ │ │ │ al_destroy_audio_recorder(3alleg5). │ │ │ │ │ .PP │ │ │ ├── ./usr/share/man/man3/al_stop_sample.3alleg5.gz │ │ │ │ ├── al_stop_sample.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_stop_sample \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ +void al_stop_sample(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Stop the sample started by al_play_sample(3alleg5). │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_stop_samples(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_stop_sample_instance.3alleg5.gz │ │ │ │ ├── al_stop_sample_instance.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_stop_sample_instance \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ +bool al_stop_sample_instance(ALLEGRO_SAMPLE_INSTANCE *spl) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Stop an sample instance playing. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_play_sample_instance(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_stop_samples.3alleg5.gz │ │ │ │ ├── al_stop_samples.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_stop_samples \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_stop_samples(void) │ │ │ │ │ +void al_stop_samples(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Stop all samples started by al_play_sample(3alleg5). │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_stop_sample(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_toggle_menu_item_flags.3alleg5.gz │ │ │ │ ├── al_toggle_menu_item_flags.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_toggle_menu_item_flags \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ int al_toggle_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags) │ │ │ │ │ +int al_toggle_menu_item_flags(ALLEGRO_MENU *menu, int pos, int flags) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Toggles the specified menu item\[cq]s flags. │ │ │ │ │ See al_insert_menu_item(3alleg5) for a description of the available │ │ │ │ │ flags. │ │ │ │ │ .PP │ │ │ │ │ Returns a bitfield of only the specified flags that are set after the │ │ │ ├── ./usr/share/man/man3/al_triangulate_polygon.3alleg5.gz │ │ │ │ ├── al_triangulate_polygon.3alleg5 │ │ │ │ │ @@ -7,14 +7,17 @@ │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_triangulate_polygon( │ │ │ │ │ const float* vertices, size_t vertex_stride, const int* vertex_counts, │ │ │ │ │ void (*emit_triangle)(int, int, int, void*), void* userdata) │ │ │ │ │ +bool al_triangulate_polygon( │ │ │ │ │ + const float* vertices, size_t vertex_stride, const int* vertex_counts, │ │ │ │ │ + void (*emit_triangle)(int, int, int, void*), void* userdata) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Divides a simple polygon into triangles, with zero or more other simple │ │ │ │ │ polygons subtracted from it \- the holes. │ │ │ │ │ The holes cannot touch or intersect with the outline of the main │ │ │ │ │ polygon. │ │ │ │ │ Simple means the polygon does not have to be convex but must not be │ │ │ ├── ./usr/share/man/man3/al_uninstall_audio.3alleg5.gz │ │ │ │ ├── al_uninstall_audio.3alleg5 │ │ │ │ │ @@ -5,12 +5,13 @@ │ │ │ │ │ al_uninstall_audio \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_uninstall_audio(void) │ │ │ │ │ +void al_uninstall_audio(void) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Uninstalls the audio subsystem. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_install_audio(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_unlock_index_buffer.3alleg5.gz │ │ │ │ ├── al_unlock_index_buffer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_unlock_index_buffer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_unlock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ +void al_unlock_index_buffer(ALLEGRO_INDEX_BUFFER* buffer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Unlocks a previously locked index buffer. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.8 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_INDEX_BUFFER(3alleg5), al_lock_index_buffer(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_unlock_sample_id.3alleg5.gz │ │ │ │ ├── al_unlock_sample_id.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_unlock_sample_id \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ +void al_unlock_sample_id(ALLEGRO_SAMPLE_ID *spl_id) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Unlocks a ALLEGRO_SAMPLE_ID(3alleg5), allowing future calls to │ │ │ │ │ al_play_sample(3alleg5) to reuse it if possible. │ │ │ │ │ Note that after the id is unlocked, the ALLEGRO_SAMPLE_INSTANCE(3alleg5) │ │ │ │ │ that was previously returned by al_lock_sample_id(3alleg5) will possibly │ │ │ │ │ be playing a different sound, so you should only use it after locking │ │ │ ├── ./usr/share/man/man3/al_unlock_vertex_buffer.3alleg5.gz │ │ │ │ ├── al_unlock_vertex_buffer.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_unlock_vertex_buffer \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ void al_unlock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ +void al_unlock_vertex_buffer(ALLEGRO_VERTEX_BUFFER* buffer) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Unlocks a previously locked vertex buffer. │ │ │ │ │ .SH SINCE │ │ │ │ │ 5.1.3 │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ ALLEGRO_VERTEX_BUFFER(3alleg5), al_lock_vertex_buffer(3alleg5) │ │ │ ├── ./usr/share/man/man3/al_voice_has_attachments.3alleg5.gz │ │ │ │ ├── al_voice_has_attachments.3alleg5 │ │ │ │ │ @@ -5,14 +5,15 @@ │ │ │ │ │ al_voice_has_attachments \- Allegro 5 API │ │ │ │ │ .SH SYNOPSIS │ │ │ │ │ .IP │ │ │ │ │ .EX │ │ │ │ │ #include │ │ │ │ │ │ │ │ │ │ bool al_voice_has_attachments(const ALLEGRO_VOICE* voice) │ │ │ │ │ +bool al_voice_has_attachments(const ALLEGRO_VOICE* voice) │ │ │ │ │ .EE │ │ │ │ │ .SH DESCRIPTION │ │ │ │ │ Returns true if the voice has something attached to it. │ │ │ │ │ .SH SEE ALSO │ │ │ │ │ al_attach_mixer_to_voice(3alleg5), │ │ │ │ │ al_attach_sample_instance_to_voice(3alleg5), │ │ │ │ │ al_attach_audio_stream_to_voice(3alleg5)