1.29 MB
/srv/reproducible-results/rbuild-debian/r-b-build.RFUgmbQ1/b1/allegro5_5.2.10.1+dfsg-1_amd64.changes vs.
/srv/reproducible-results/rbuild-debian/r-b-build.RFUgmbQ1/b2/allegro5_5.2.10.1+dfsg-1_amd64.changes
2.1 KB
Files
    
Offset 1, 9 lines modifiedOffset 1, 9 lines modified
  
1 ·f0fb76f630cbf62ccd37e26feb2d31f5·1393864·doc·optional·allegro5-doc_5.2.10.1+dfsg-1_all.deb1 ·3876bcbc6994306720a221bf8bd4eae6·1399868·doc·optional·allegro5-doc_5.2.10.1+dfsg-1_all.deb
2 ·0d0f0e36c802263571c8a4a4d37986e6·19388·libdevel·optional·liballegro-acodec5-dev_5.2.10.1+dfsg-1_amd64.deb2 ·0d0f0e36c802263571c8a4a4d37986e6·19388·libdevel·optional·liballegro-acodec5-dev_5.2.10.1+dfsg-1_amd64.deb
3 ·1b59d111a67aa58c866f6e3e5907a5ca·62612·debug·optional·liballegro-acodec5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb3 ·1b59d111a67aa58c866f6e3e5907a5ca·62612·debug·optional·liballegro-acodec5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb
4 ·2a1daa81c64c1269f26fd44c9d8cc91f·38436·libs·optional·liballegro-acodec5.2t64_5.2.10.1+dfsg-1_amd64.deb4 ·2a1daa81c64c1269f26fd44c9d8cc91f·38436·libs·optional·liballegro-acodec5.2t64_5.2.10.1+dfsg-1_amd64.deb
5 ·88c48ff68fbc70f244e6289381910e53·22164·libdevel·optional·liballegro-audio5-dev_5.2.10.1+dfsg-1_amd64.deb5 ·88c48ff68fbc70f244e6289381910e53·22164·libdevel·optional·liballegro-audio5-dev_5.2.10.1+dfsg-1_amd64.deb
6 ·4ca7fef020bdb90a295c2c53845ec064·110732·debug·optional·liballegro-audio5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb6 ·4ca7fef020bdb90a295c2c53845ec064·110732·debug·optional·liballegro-audio5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb
7 ·48aebe1c77f74fd70e66a5223b3b3b97·62260·libs·optional·liballegro-audio5.2t64_5.2.10.1+dfsg-1_amd64.deb7 ·48aebe1c77f74fd70e66a5223b3b3b97·62260·libs·optional·liballegro-audio5.2t64_5.2.10.1+dfsg-1_amd64.deb
8 ·1392e795640f5aea611fc0be61a01f49·20432·libdevel·optional·liballegro-dialog5-dev_5.2.10.1+dfsg-1_amd64.deb8 ·1392e795640f5aea611fc0be61a01f49·20432·libdevel·optional·liballegro-dialog5-dev_5.2.10.1+dfsg-1_amd64.deb
Offset 17, 10 lines modifiedOffset 17, 10 lines modified
17 ·1399e259e49d926a90ec19b73119cb5c·23612·libs·optional·liballegro-physfs5.2t64_5.2.10.1+dfsg-1_amd64.deb17 ·1399e259e49d926a90ec19b73119cb5c·23612·libs·optional·liballegro-physfs5.2t64_5.2.10.1+dfsg-1_amd64.deb
18 ·da9f68d4e67494231657f1fe069ad829·19488·libdevel·optional·liballegro-ttf5-dev_5.2.10.1+dfsg-1_amd64.deb18 ·da9f68d4e67494231657f1fe069ad829·19488·libdevel·optional·liballegro-ttf5-dev_5.2.10.1+dfsg-1_amd64.deb
19 ·9bc8a671bc38e276a037c4d049eb1cf1·32396·debug·optional·liballegro-ttf5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb19 ·9bc8a671bc38e276a037c4d049eb1cf1·32396·debug·optional·liballegro-ttf5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb
20 ·0556795a2ded2b346fca63b90043c78b·29048·libs·optional·liballegro-ttf5.2t64_5.2.10.1+dfsg-1_amd64.deb20 ·0556795a2ded2b346fca63b90043c78b·29048·libs·optional·liballegro-ttf5.2t64_5.2.10.1+dfsg-1_amd64.deb
21 ·69c5613595a2d5ef9e3f8db6ae2395b6·19768·libdevel·optional·liballegro-video5-dev_5.2.10.1+dfsg-1_amd64.deb21 ·69c5613595a2d5ef9e3f8db6ae2395b6·19768·libdevel·optional·liballegro-video5-dev_5.2.10.1+dfsg-1_amd64.deb
22 ·96d6690bc5ba332a19c5dcd81daf155b·40224·debug·optional·liballegro-video5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb22 ·96d6690bc5ba332a19c5dcd81daf155b·40224·debug·optional·liballegro-video5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb
23 ·22a94022c3dd9ab579ab777308895e7b·32968·libs·optional·liballegro-video5.2t64_5.2.10.1+dfsg-1_amd64.deb23 ·22a94022c3dd9ab579ab777308895e7b·32968·libs·optional·liballegro-video5.2t64_5.2.10.1+dfsg-1_amd64.deb
24 ·0c66871380d3de3b82916dcdf4dc4aaa·117028·libdevel·optional·liballegro5-dev_5.2.10.1+dfsg-1_amd64.deb24 ·539c5b7b4d3254281f7ffdddf394ff97·117028·libdevel·optional·liballegro5-dev_5.2.10.1+dfsg-1_amd64.deb
25 ·de3482df569e4459d70ab6eff7e54d6a·1318364·debug·optional·liballegro5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb25 ·de3482df569e4459d70ab6eff7e54d6a·1318364·debug·optional·liballegro5.2t64-dbgsym_5.2.10.1+dfsg-1_amd64.deb
26 ·0f981c3c9df61e91bdf05a79338618f5·439832·libs·optional·liballegro5.2t64_5.2.10.1+dfsg-1_amd64.deb26 ·0f981c3c9df61e91bdf05a79338618f5·439832·libs·optional·liballegro5.2t64_5.2.10.1+dfsg-1_amd64.deb
1.29 MB
allegro5-doc_5.2.10.1+dfsg-1_all.deb
452 B
file list
    
Offset 1, 3 lines modifiedOffset 1, 3 lines modified
1 -rw-r--r--···0········0········0········4·2025-01-09·13:52:42.000000·debian-binary1 -rw-r--r--···0········0········0········4·2025-01-09·13:52:42.000000·debian-binary
2 -rw-r--r--···0········0········0····31656·2025-01-09·13:52:42.000000·control.tar.xz2 -rw-r--r--···0········0········0····31688·2025-01-09·13:52:42.000000·control.tar.xz
3 -rw-r--r--···0········0········0··1362016·2025-01-09·13:52:42.000000·data.tar.xz3 -rw-r--r--···0········0········0··1367988·2025-01-09·13:52:42.000000·data.tar.xz
579 B
control.tar.xz
551 B
control.tar
481 B
./control
    
Offset 1, 13 lines modifiedOffset 1, 13 lines modified
1 Package:·allegro5-doc1 Package:·allegro5-doc
2 Source:·allegro52 Source:·allegro5
3 Version:·2:5.2.10.1+dfsg-13 Version:·2:5.2.10.1+dfsg-1
4 Architecture:·all4 Architecture:·all
5 Maintainer:·Debian·Games·Team·<pkg-games-devel@lists.alioth.debian.org>5 Maintainer:·Debian·Games·Team·<pkg-games-devel@lists.alioth.debian.org>
6 Installed-Size:·54986 Installed-Size:·5628
7 Depends:·fonts-dejavu-core7 Depends:·fonts-dejavu-core
8 Section:·doc8 Section:·doc
9 Priority:·optional9 Priority:·optional
10 Multi-Arch:·foreign10 Multi-Arch:·foreign
11 Homepage:·https://liballeg.org/11 Homepage:·https://liballeg.org/
12 Description:·documentation·for·the·Allegro·5·library12 Description:·documentation·for·the·Allegro·5·library
13 ·This·package·contains·the·Allegro·documentation·in·various·formats,13 ·This·package·contains·the·Allegro·documentation·in·various·formats,
48.0 B
./md5sums
30.0 B
./md5sums
Files differ
1.28 MB
data.tar.xz
1.28 MB
data.tar
61.7 KB
file list
    
Offset 198, 65 lines modifiedOffset 198, 65 lines modified
198 -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.c198 -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
199 -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.c199 -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
200 -rw-r--r--···0·root·········(0)·root·········(0)·····6511·2024-12-29·03:52:10.000000·./usr/share/doc/allegro5-doc/examples/ex_windows.c200 -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
201 -rw-r--r--···0·root·········(0)·root·········(0)·····1674·2024-12-29·03:52:10.000000·./usr/share/doc/allegro5-doc/examples/ex_winfull.c201 -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
202 -rw-r--r--···0·root·········(0)·root·········(0)····19521·2024-12-29·03:52:10.000000·./usr/share/doc/allegro5-doc/examples/nihgui.cpp202 -rw-r--r--···0·root·········(0)·root·········(0)····19521·2024-12-29·03:52:10.000000·./usr/share/doc/allegro5-doc/examples/nihgui.cpp
203 -rw-r--r--···0·root·········(0)·root·········(0)·····6456·2024-12-29·03:52:10.000000·./usr/share/doc/allegro5-doc/examples/nihgui.hpp203 -rw-r--r--···0·root·········(0)·root·········(0)·····6456·2024-12-29·03:52:10.000000·./usr/share/doc/allegro5-doc/examples/nihgui.hpp
204 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/204 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/
205 -rw-r--r--···0·root·········(0)·root·········(0)····11397·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/acodec.html205 -rw-r--r--···0·root·········(0)·root·········(0)····11782·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/acodec.html
206 -rw-r--r--···0·root·········(0)·root·········(0)···206673·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/audio.html206 -rw-r--r--···0·root·········(0)·root·········(0)···234053·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/audio.html
207 -rw-r--r--···0·root·········(0)·root·········(0)····36350·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/autosuggest.js207 -rw-r--r--···0·root·········(0)·root·········(0)····36350·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/autosuggest.js
208 -rw-r--r--···0·root·········(0)·root·········(0)····62104·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/color.html208 -rw-r--r--···0·root·········(0)·root·········(0)····66987·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/color.html
209 -rw-r--r--···0·root·········(0)·root·········(0)····37137·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/config.html209 -rw-r--r--···0·root·········(0)·root·········(0)····37698·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/config.html
210 -rw-r--r--···0·root·········(0)·root·········(0)····17577·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/direct3d.html210 -rw-r--r--···0·root·········(0)·root·········(0)····17712·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/direct3d.html
211 -rw-r--r--···0·root·········(0)·root·········(0)····87216·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/display.html211 -rw-r--r--···0·root·········(0)·root·········(0)····89023·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/display.html
212 -rw-r--r--···0·root·········(0)·root·········(0)····79697·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/events.html212 -rw-r--r--···0·root·········(0)·root·········(0)····81982·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/events.html
213 -rw-r--r--···0·root·········(0)·root·········(0)····61321·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/file.html213 -rw-r--r--···0·root·········(0)·root·········(0)····62308·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/file.html
214 -rw-r--r--···0·root·········(0)·root·········(0)····56556·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/fixed.html214 -rw-r--r--···0·root·········(0)·root·········(0)····56556·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/fixed.html
215 -rw-r--r--···0·root·········(0)·root·········(0)····87416·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/font.html215 -rw-r--r--···0·root·········(0)·root·········(0)····95359·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/font.html
216 -rw-r--r--···0·root·········(0)·root·········(0)····42130·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/fshook.html216 -rw-r--r--···0·root·········(0)·root·········(0)····42369·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/fshook.html
217 -rw-r--r--···0·root·········(0)·root·········(0)····13123·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/fullscreen_mode.html217 -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
218 -rw-r--r--···0·root·········(0)·root·········(0)····17055·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/getting_started.html218 -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
219 -rw-r--r--···0·root·········(0)·root·········(0)···215583·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/graphics.html219 -rw-r--r--···0·root·········(0)·root·········(0)···224378·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/graphics.html
220 -rw-r--r--···0·root·········(0)·root·········(0)····68519·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/haptic.html220 -rw-r--r--···0·root·········(0)·root·········(0)····69780·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/haptic.html
221 -rw-r--r--···0·root·········(0)·root·········(0)····12034·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/image.html221 -rw-r--r--···0·root·········(0)·root·········(0)····12423·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/image.html
222 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/images/222 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/images/
223 -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.png223 -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
224 -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.png224 -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
225 -rw-r--r--···0·root·········(0)·root·········(0)····65065·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/images/audio.png225 -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
226 -rw-r--r--···0·root·········(0)·root·········(0)····16058·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/images/primitives1.png226 -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
227 -rw-r--r--···0·root·········(0)·root·········(0)····25805·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/images/primitives2.png227 -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
228 -rw-r--r--···0·root·········(0)·root·········(0)·····6773·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/index.html228 -rw-r--r--···0·root·········(0)·root·········(0)·····6683·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/index.html
229 -rw-r--r--···0·root·········(0)·root·········(0)···110785·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/index_all.html229 -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
230 -rw-r--r--···0·root·········(0)·root·········(0)····29831·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/joystick.html230 -rw-r--r--···0·root·········(0)·root·········(0)····35289·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/joystick.html
231 -rw-r--r--···0·root·········(0)·root·········(0)····21928·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/keyboard.html231 -rw-r--r--···0·root·········(0)·root·········(0)····24132·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/keyboard.html
232 -rw-r--r--···0·root·········(0)·root·········(0)·····9013·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/main.html232 -rw-r--r--···0·root·········(0)·root·········(0)·····9013·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/main.html
233 -rw-r--r--···0·root·········(0)·root·········(0)····10382·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/memfile.html233 -rw-r--r--···0·root·········(0)·root·········(0)····10431·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/memfile.html
234 -rw-r--r--···0·root·········(0)·root·········(0)····23336·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/memory.html234 -rw-r--r--···0·root·········(0)·root·········(0)····24142·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/memory.html
235 -rw-r--r--···0·root·········(0)·root·········(0)····10027·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/misc.html235 -rw-r--r--···0·root·········(0)·root·········(0)····10394·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/misc.html
236 -rw-r--r--···0·root·········(0)·root·········(0)····14086·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/monitor.html236 -rw-r--r--···0·root·········(0)·root·········(0)····15363·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/monitor.html
237 -rw-r--r--···0·root·········(0)·root·········(0)····40213·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/mouse.html237 -rw-r--r--···0·root·········(0)·root·········(0)····43913·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/mouse.html
238 -rw-r--r--···0·root·········(0)·root·········(0)····74745·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/native_dialog.html238 -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
239 -rw-r--r--···0·root·········(0)·root·········(0)····26550·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/opengl.html239 -rw-r--r--···0·root·········(0)·root·········(0)····27143·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/opengl.html
240 -rw-r--r--···0·root·········(0)·root·········(0)·····3973·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/pandoc.css240 -rw-r--r--···0·root·········(0)·root·········(0)·····3973·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/pandoc.css
241 -rw-r--r--···0·root·········(0)·root·········(0)····33068·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/path.html241 -rw-r--r--···0·root·········(0)·root·········(0)····38119·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/path.html
242 -rw-r--r--···0·root·········(0)·root·········(0)····11716·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/physfs.html242 -rw-r--r--···0·root·········(0)·root·········(0)····11854·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/physfs.html
243 -rw-r--r--···0·root·········(0)·root·········(0)····31348·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/platform.html243 -rw-r--r--···0·root·········(0)·root·········(0)····31535·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/platform.html
244 -rw-r--r--···0·root·········(0)·root·········(0)···136297·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/primitives.html244 -rw-r--r--···0·root·········(0)·root·········(0)···145966·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/primitives.html
245 -rw-r--r--···0·root·········(0)·root·········(0)····72292·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/search_index.js245 -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
246 -rw-r--r--···0·root·········(0)·root·········(0)····40657·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/shader.html246 -rw-r--r--···0·root·········(0)·root·········(0)····45830·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/shader.html
247 -rw-r--r--···0·root·········(0)·root·········(0)····14393·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/state.html247 -rw-r--r--···0·root·········(0)·root·········(0)····15871·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/state.html
248 -rw-r--r--···0·root·········(0)·root·········(0)····70428·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/system.html248 -rw-r--r--···0·root·········(0)·root·········(0)····72351·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/system.html
249 -rw-r--r--···0·root·········(0)·root·········(0)····31348·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/threads.html249 -rw-r--r--···0·root·········(0)·root·········(0)····35452·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/threads.html
250 -rw-r--r--···0·root·········(0)·root·········(0)····11589·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/time.html 
251 -rw-r--r--···0·root·········(0)·root·········(0)····23515·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/timer.html250 -rw-r--r--···0·root·········(0)·root·········(0)····12633·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/time.html
 251 -rw-r--r--···0·root·········(0)·root·········(0)····26749·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/timer.html
252 -rw-r--r--···0·root·········(0)·root·········(0)····20528·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/touch.html252 -rw-r--r--···0·root·········(0)·root·········(0)····22267·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/touch.html
253 -rw-r--r--···0·root·········(0)·root·········(0)····76968·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/transformations.html253 -rw-r--r--···0·root·········(0)·root·········(0)····82433·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/transformations.html
254 -rw-r--r--···0·root·········(0)·root·········(0)····91582·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/utf8.html254 -rw-r--r--···0·root·········(0)·root·········(0)···104422·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/utf8.html
255 -rw-r--r--···0·root·········(0)·root·········(0)····29995·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/video.html255 -rw-r--r--···0·root·········(0)·root·········(0)····31892·2025-01-09·13:52:42.000000·./usr/share/doc/allegro5-doc/refman/video.html
256 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/doc-base/256 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/doc-base/
257 -rw-r--r--···0·root·········(0)·root·········(0)······300·2025-01-01·19:45:12.000000·./usr/share/doc-base/allegro5-doc.allegro5257 -rw-r--r--···0·root·········(0)·root·········(0)······300·2025-01-01·19:45:12.000000·./usr/share/doc-base/allegro5-doc.allegro5
258 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/man/258 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/man/
259 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/man/man3/259 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/share/man/man3/
260 -rw-r--r--···0·root·········(0)·root·········(0)······405·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_AUDIO_DEPTH.3alleg5.gz260 -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
261 -rw-r--r--···0·root·········(0)·root·········(0)······254·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_AUDIO_DEVICE.3alleg5.gz261 -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
262 -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.gz262 -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
Offset 267, 33 lines modifiedOffset 267, 33 lines modified
267 -rw-r--r--···0·root·········(0)·root·········(0)······247·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_BITMAP.3alleg5.gz267 -rw-r--r--···0·root·········(0)·root·········(0)······247·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_BITMAP.3alleg5.gz
268 -rw-r--r--···0·root·········(0)·root·········(0)······459·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_BITMAP_WRAP.3alleg5.gz268 -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
269 -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.gz269 -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
270 -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.gz270 -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
271 -rw-r--r--···0·root·········(0)·root·········(0)······281·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_CHANNEL_CONF.3alleg5.gz271 -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
272 -rw-r--r--···0·root·········(0)·root·········(0)······313·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_COLOR.3alleg5.gz272 -rw-r--r--···0·root·········(0)·root·········(0)······313·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_COLOR.3alleg5.gz
273 -rw-r--r--···0·root·········(0)·root·········(0)······244·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_COND.3alleg5.gz273 -rw-r--r--···0·root·········(0)·root·········(0)······244·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_COND.3alleg5.gz
274 -rw-r--r--···0·root·········(0)·root·········(0)······235·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_CONFIG.3alleg5.gz274 -rw-r--r--···0·root·········(0)·root·········(0)······220·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_CONFIG.3alleg5.gz
275 -rw-r--r--···0·root·········(0)·root·········(0)······303·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_CONFIG_ENTRY.3alleg5.gz275 -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
276 -rw-r--r--···0·root·········(0)·root·········(0)······300·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_CONFIG_SECTION.3alleg5.gz276 -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
277 -rw-r--r--···0·root·········(0)·root·········(0)······247·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_DISPLAY.3alleg5.gz277 -rw-r--r--···0·root·········(0)·root·········(0)······232·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_DISPLAY.3alleg5.gz
278 -rw-r--r--···0·root·········(0)·root·········(0)······458·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_DISPLAY_MODE.3alleg5.gz278 -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
279 -rw-r--r--···0·root·········(0)·root·········(0)·····5117·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT.3alleg5.gz279 -rw-r--r--···0·root·········(0)·root·········(0)·····5105·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT.3alleg5.gz
280 -rw-r--r--···0·root·········(0)·root·········(0)······364·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT_QUEUE.3alleg5.gz280 -rw-r--r--···0·root·········(0)·root·········(0)······347·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT_QUEUE.3alleg5.gz
281 -rw-r--r--···0·root·········(0)·root·········(0)······398·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT_SOURCE.3alleg5.gz281 -rw-r--r--···0·root·········(0)·root·········(0)······382·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT_SOURCE.3alleg5.gz
282 -rw-r--r--···0·root·········(0)·root·········(0)······295·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT_TYPE.3alleg5.gz282 -rw-r--r--···0·root·········(0)·root·········(0)······278·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT_TYPE.3alleg5.gz
283 -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.gz283 -rw-r--r--···0·root·········(0)·root·········(0)······282·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_EVENT_TYPE_IS_USER.3alleg5.gz
284 -rw-r--r--···0·root·········(0)·root·········(0)······268·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FILE.3alleg5.gz284 -rw-r--r--···0·root·········(0)·root·········(0)······252·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FILE.3alleg5.gz
285 -rw-r--r--···0·root·········(0)·root·········(0)······248·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FILECHOOSER.3alleg5.gz285 -rw-r--r--···0·root·········(0)·root·········(0)······248·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FILECHOOSER.3alleg5.gz
286 -rw-r--r--···0·root·········(0)·root·········(0)······772·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FILE_INTERFACE.3alleg5.gz286 -rw-r--r--···0·root·········(0)·root·········(0)······762·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FILE_INTERFACE.3alleg5.gz
287 -rw-r--r--···0·root·········(0)·root·········(0)······312·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FILE_MODE.3alleg5.gz287 -rw-r--r--···0·root·········(0)·root·········(0)······300·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FILE_MODE.3alleg5.gz
288 -rw-r--r--···0·root·········(0)·root·········(0)······409·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FONT.3alleg5.gz288 -rw-r--r--···0·root·········(0)·root·········(0)······409·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FONT.3alleg5.gz
289 -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.gz289 -rw-r--r--···0·root·········(0)·root·········(0)······403·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FOR_EACH_FS_ENTRY_RESULT.3alleg5.gz
290 -rw-r--r--···0·root·········(0)·root·········(0)······314·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FS_ENTRY.3alleg5.gz290 -rw-r--r--···0·root·········(0)·root·········(0)······296·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FS_ENTRY.3alleg5.gz
291 -rw-r--r--···0·root·········(0)·root·········(0)······509·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FS_INTERFACE.3alleg5.gz291 -rw-r--r--···0·root·········(0)·root·········(0)······492·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_FS_INTERFACE.3alleg5.gz
292 -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.gz292 -rw-r--r--···0·root·········(0)·root·········(0)······668·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_GET_EVENT_TYPE.3alleg5.gz
293 -rw-r--r--···0·root·········(0)·root·········(0)······786·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_GLYPH.3alleg5.gz293 -rw-r--r--···0·root·········(0)·root·········(0)······786·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_GLYPH.3alleg5.gz
294 -rw-r--r--···0·root·········(0)·root·········(0)······426·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_HAPTIC.3alleg5.gz294 -rw-r--r--···0·root·········(0)·root·········(0)······426·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_HAPTIC.3alleg5.gz
295 -rw-r--r--···0·root·········(0)·root·········(0)······813·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_HAPTIC_CONSTANTS.3alleg5.gz295 -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
296 -rw-r--r--···0·root·········(0)·root·········(0)·····3142·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_HAPTIC_EFFECT.3alleg5.gz296 -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
297 -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.gz297 -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
298 -rw-r--r--···0·root·········(0)·root·········(0)······362·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_INDEX_BUFFER.3alleg5.gz298 -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
299 -rw-r--r--···0·root·········(0)·root·········(0)······335·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_JOYFLAGS.3alleg5.gz299 -rw-r--r--···0·root·········(0)·root·········(0)······335·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_JOYFLAGS.3alleg5.gz
Offset 309, 29 lines modifiedOffset 309, 29 lines modified
309 -rw-r--r--···0·root·········(0)·root·········(0)······502·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_MIXER.3alleg5.gz309 -rw-r--r--···0·root·········(0)·root·········(0)······502·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_MIXER.3alleg5.gz
310 -rw-r--r--···0·root·········(0)·root·········(0)······296·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_MIXER_QUALITY.3alleg5.gz310 -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
311 -rw-r--r--···0·root·········(0)·root·········(0)······461·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_MONITOR_INFO.3alleg5.gz311 -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
312 -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.gz312 -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
313 -rw-r--r--···0·root·········(0)·root·········(0)······455·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_MOUSE_STATE.3alleg5.gz313 -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
314 -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.gz314 -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
315 -rw-r--r--···0·root·········(0)·root·········(0)······236·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_MUTEX.3alleg5.gz315 -rw-r--r--···0·root·········(0)·root·········(0)······236·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_MUTEX.3alleg5.gz
316 -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.gz316 -rw-r--r--···0·root·········(0)·root·········(0)······287·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE.3alleg5.gz
317 -rw-r--r--···0·root·········(0)·root·········(0)······290·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PI.3alleg5.gz317 -rw-r--r--···0·root·········(0)·root·········(0)······290·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PI.3alleg5.gz
318 -rw-r--r--···0·root·········(0)·root·········(0)·····2159·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PIXEL_FORMAT.3alleg5.gz318 -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
319 -rw-r--r--···0·root·········(0)·root·········(0)······467·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PLAYMODE.3alleg5.gz319 -rw-r--r--···0·root·········(0)·root·········(0)······467·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PLAYMODE.3alleg5.gz
320 -rw-r--r--···0·root·········(0)·root·········(0)·····1138·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PRIM_ATTR.3alleg5.gz320 -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
321 -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.gz321 -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
322 -rw-r--r--···0·root·········(0)·root·········(0)······358·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PRIM_QUALITY.3alleg5.gz322 -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
323 -rw-r--r--···0·root·········(0)·root·········(0)······902·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PRIM_STORAGE.3alleg5.gz323 -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
324 -rw-r--r--···0·root·········(0)·root·········(0)······484·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_PRIM_TYPE.3alleg5.gz324 -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
325 -rw-r--r--···0·root·········(0)·root·········(0)······334·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_RENDER_FUNCTION.3alleg5.gz325 -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
326 -rw-r--r--···0·root·········(0)·root·········(0)······859·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_RENDER_STATE.3alleg5.gz326 -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
327 -rw-r--r--···0·root·········(0)·root·········(0)······407·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SAMPLE.3alleg5.gz327 -rw-r--r--···0·root·········(0)·root·········(0)······407·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SAMPLE.3alleg5.gz
328 -rw-r--r--···0·root·········(0)·root·········(0)······332·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SAMPLE_ID.3alleg5.gz328 -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
329 -rw-r--r--···0·root·········(0)·root·········(0)······597·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SAMPLE_INSTANCE.3alleg5.gz329 -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
330 -rw-r--r--···0·root·········(0)·root·········(0)······295·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SEEK.3alleg5.gz330 -rw-r--r--···0·root·········(0)·root·········(0)······282·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SEEK.3alleg5.gz
331 -rw-r--r--···0·root·········(0)·root·········(0)······456·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SHADER.3alleg5.gz331 -rw-r--r--···0·root·········(0)·root·········(0)······456·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SHADER.3alleg5.gz
332 -rw-r--r--···0·root·········(0)·root·········(0)······510·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SHADER_PLATFORM.3alleg5.gz332 -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
333 -rw-r--r--···0·root·········(0)·root·········(0)······699·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_SHADER_TYPE.3alleg5.gz333 -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
334 -rw-r--r--···0·root·········(0)·root·········(0)······680·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_STATE.3alleg5.gz334 -rw-r--r--···0·root·········(0)·root·········(0)······680·2025-01-09·13:52:42.000000·./usr/share/man/man3/ALLEGRO_STATE.3alleg5.gz
Max diff block lines reached; 38494/63160 bytes (60.95%) of diff not shown.
2.6 KB
./usr/share/doc/allegro5-doc/refman/acodec.html
    
Offset 209, 14 lines modifiedOffset 209, 23 lines modified
209 href="audio.html#al_load_sample_f">al_load_sample_f</a>·and·must·be209 href="audio.html#al_load_sample_f">al_load_sample_f</a>·and·must·be
210 streamed·with·<a210 streamed·with·<a
211 href="audio.html#al_load_audio_stream">al_load_audio_stream</a>·or·<a211 href="audio.html#al_load_audio_stream">al_load_audio_stream</a>·or·<a
212 href="audio.html#al_load_audio_stream_f">al_load_audio_stream_f</a>.</p></li>212 href="audio.html#al_load_audio_stream_f">al_load_audio_stream_f</a>.</p></li>
213 <li><p>.voc·file·streaming·is·unimplemented.</p></li>213 <li><p>.voc·file·streaming·is·unimplemented.</p></li>
214 </ul>214 </ul>
215 <p>Return·true·on·success.</p>215 <p>Return·true·on·success.</p>
 216 <p>Examples:</p>
 217 <ul>
 218 <li><a
 219 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_file.c#L51">ex_stream_file.c</a></li>
 220 <li><a
 221 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L39">ex_acodec_multi.c</a></li>
 222 <li><a
 223 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_kcm_direct.c#L30">ex_kcm_direct.c</a></li>
 224 </ul>
216 <h1225 <h1
217 id="al_is_acodec_addon_initialized">al_is_acodec_addon_initialized</h1>226 id="al_is_acodec_addon_initialized">al_is_acodec_addon_initialized</h1>
218 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_acodec_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>227 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_acodec_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
219 <p><a228 <p><a
220 href="https://github.com/liballeg/allegro5/blob/master/addons/acodec/acodec.c#L99">Source229 href="https://github.com/liballeg/allegro5/blob/master/addons/acodec/acodec.c#L99">Source
221 Code</a></p>230 Code</a></p>
222 <p>Returns·true·if·the·acodec·addon·is·initialized,·otherwise·returns231 <p>Returns·true·if·the·acodec·addon·is·initialized,·otherwise·returns
1.21 KB
html2text {}
    
Offset 64, 14 lines modifiedOffset 64, 18 lines modified
64 ····*·Module·files·(.it,·.mod,·.s3m,·.xm)·are·often·composed·with·streaming·in64 ····*·Module·files·(.it,·.mod,·.s3m,·.xm)·are·often·composed·with·streaming·in
65 ······mind,·and·sometimes·cannot·be·easily·rendered·into·a·finite·length65 ······mind,·and·sometimes·cannot·be·easily·rendered·into·a·finite·length
66 ······sample.·Therefore·they·cannot·be·loaded·with·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e/66 ······sample.·Therefore·they·cannot·be·loaded·with·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e/
67 ······_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8f·and·must·be·streamed·with·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m·or67 ······_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8f·and·must·be·streamed·with·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m·or
68 ······_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f.68 ······_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f.
69 ····*·.voc·file·streaming·is·unimplemented.69 ····*·.voc·file·streaming·is·unimplemented.
70 Return·true·on·success.70 Return·true·on·success.
 71 Examples:
 72 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c
 73 ····*·_\x8e_\x8x_\x8__\x8a_\x8c_\x8o_\x8d_\x8e_\x8c_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8._\x8c
 74 ····*·_\x8e_\x8x_\x8__\x8k_\x8c_\x8m_\x8__\x8d_\x8i_\x8r_\x8e_\x8c_\x8t_\x8._\x8c
71 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_a\x8ac\x8co\x8od\x8de\x8ec\x8c_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*75 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_a\x8ac\x8co\x8od\x8de\x8ec\x8c_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
72 bool·al_is_acodec_addon_initialized(void)76 bool·al_is_acodec_addon_initialized(void)
73 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e77 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
74 Returns·true·if·the·acodec·addon·is·initialized,·otherwise·returns·false.78 Returns·true·if·the·acodec·addon·is·initialized,·otherwise·returns·false.
75 Since:·5.2.679 Since:·5.2.6
76 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8al\x8ll\x8le\x8eg\x8gr\x8ro\x8o_\x8_a\x8ac\x8co\x8od\x8de\x8ec\x8c_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*80 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8al\x8ll\x8le\x8eg\x8gr\x8ro\x8o_\x8_a\x8ac\x8co\x8od\x8de\x8ec\x8c_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
77 uint32_t·al_get_allegro_acodec_version(void)81 uint32_t·al_get_allegro_acodec_version(void)
203 KB
./usr/share/doc/allegro5-doc/refman/audio.html
    
Offset 564, 14 lines modifiedOffset 564, 19 lines modified
564 Code</a></p>564 Code</a></p>
565 <p>An·ALLEGRO_SAMPLE_ID·represents·a·sample·being·played·via·<a565 <p>An·ALLEGRO_SAMPLE_ID·represents·a·sample·being·played·via·<a
566 href="audio.html#al_play_sample">al_play_sample</a>.·It·can·be·used·to566 href="audio.html#al_play_sample">al_play_sample</a>.·It·can·be·used·to
567 later·stop·the·sample·with·<a567 later·stop·the·sample·with·<a
568 href="audio.html#al_stop_sample">al_stop_sample</a>.·The·underlying568 href="audio.html#al_stop_sample">al_stop_sample</a>.·The·underlying
569 ALLEGRO_SAMPLE_INSTANCE·can·be·extracted·using·<a569 ALLEGRO_SAMPLE_INSTANCE·can·be·extracted·using·<a
570 href="audio.html#al_lock_sample_id">al_lock_sample_id</a>.</p>570 href="audio.html#al_lock_sample_id">al_lock_sample_id</a>.</p>
 571 <p>Examples:</p>
 572 <ul>
 573 <li><a
 574 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_simple.c#L33">ex_audio_simple.c</a></li>
 575 </ul>
571 <h2·id="al_install_audio">al_install_audio</h2>576 <h2·id="al_install_audio">al_install_audio</h2>
572 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_install_audio<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>577 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_install_audio<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
573 <p><a578 <p><a
574 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/audio.c#L422">Source579 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/audio.c#L422">Source
575 Code</a></p>580 Code</a></p>
576 <p>Install·the·audio·subsystem.</p>581 <p>Install·the·audio·subsystem.</p>
577 <p>Returns·true·on·success,·false·on·failure.</p>582 <p>Returns·true·on·success,·false·on·failure.</p>
Offset 582, 22 lines modifiedOffset 587, 40 lines modified
582 this.</p>587 this.</p>
583 </blockquote>588 </blockquote>
584 <p>See·also:·<a589 <p>See·also:·<a
585 href="audio.html#al_reserve_samples">al_reserve_samples</a>,·<a590 href="audio.html#al_reserve_samples">al_reserve_samples</a>,·<a
586 href="audio.html#al_uninstall_audio">al_uninstall_audio</a>,·<a591 href="audio.html#al_uninstall_audio">al_uninstall_audio</a>,·<a
587 href="audio.html#al_is_audio_installed">al_is_audio_installed</a>,·<a592 href="audio.html#al_is_audio_installed">al_is_audio_installed</a>,·<a
588 href="acodec.html#al_init_acodec_addon">al_init_acodec_addon</a></p>593 href="acodec.html#al_init_acodec_addon">al_init_acodec_addon</a></p>
 594 <p>Examples:</p>
 595 <ul>
 596 <li><a
 597 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_devices.c#L20">ex_audio_devices.c</a></li>
 598 <li><a
 599 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_saw.c#L95">ex_saw.c</a></li>
 600 <li><a
 601 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_file.c#L53">ex_stream_file.c</a></li>
 602 </ul>
589 <h2·id="al_uninstall_audio">al_uninstall_audio</h2>603 <h2·id="al_uninstall_audio">al_uninstall_audio</h2>
590 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_uninstall_audio<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>604 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_uninstall_audio<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
591 <p><a605 <p><a
592 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/audio.c#L441">Source606 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/audio.c#L441">Source
593 Code</a></p>607 Code</a></p>
594 <p>Uninstalls·the·audio·subsystem.</p>608 <p>Uninstalls·the·audio·subsystem.</p>
595 <p>See·also:·<a609 <p>See·also:·<a
596 href="audio.html#al_install_audio">al_install_audio</a></p>610 href="audio.html#al_install_audio">al_install_audio</a></p>
 611 <p>Examples:</p>
 612 <ul>
 613 <li><a
 614 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_saw.c#L123">ex_saw.c</a></li>
 615 <li><a
 616 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_file.c#L133">ex_stream_file.c</a></li>
 617 <li><a
 618 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L134">ex_acodec_multi.c</a></li>
 619 </ul>
597 <h2·id="al_is_audio_installed">al_is_audio_installed</h2>620 <h2·id="al_is_audio_installed">al_is_audio_installed</h2>
598 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_audio_installed<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>621 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_audio_installed<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
599 <p><a622 <p><a
600 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/audio.c#L456">Source623 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/audio.c#L456">Source
601 Code</a></p>624 Code</a></p>
602 <p>Returns·true·if·<a625 <p>Returns·true·if·<a
603 href="audio.html#al_install_audio">al_install_audio</a>·was·called626 href="audio.html#al_install_audio">al_install_audio</a>·was·called
Offset 624, 14 lines modifiedOffset 647, 23 lines modified
624 ······································sample·instance·N</code></pre>647 ······································sample·instance·N</code></pre>
625 <p>Returns·true·on·success,·false·on·error.·<a648 <p>Returns·true·on·success,·false·on·error.·<a
626 href="audio.html#al_install_audio">al_install_audio</a>·must·have·been649 href="audio.html#al_install_audio">al_install_audio</a>·must·have·been
627 called·first.</p>650 called·first.</p>
628 <p>See·also:·<a651 <p>See·also:·<a
629 href="audio.html#al_set_default_mixer">al_set_default_mixer</a>,·<a652 href="audio.html#al_set_default_mixer">al_set_default_mixer</a>,·<a
630 href="audio.html#al_play_sample">al_play_sample</a></p>653 href="audio.html#al_play_sample">al_play_sample</a></p>
 654 <p>Examples:</p>
 655 <ul>
 656 <li><a
 657 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_saw.c#L98">ex_saw.c</a></li>
 658 <li><a
 659 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_props.cpp#L167">ex_audio_props.cpp</a></li>
 660 <li><a
 661 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_resample_test.c#L182">ex_resample_test.c</a></li>
 662 </ul>
631 <h2·id="al_play_sample">al_play_sample</h2>663 <h2·id="al_play_sample">al_play_sample</h2>
632 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_play_sample<span·class="op">(</span>ALLEGRO_SAMPLE·<span·class="op">*</span>spl<span·class="op">,</span>·<span·class="dt">float</span>·gain<span·class="op">,</span>·<span·class="dt">float</span>·pan<span·class="op">,</span>·<span·class="dt">float</span>·speed<span·class="op">,</span></span>664 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_play_sample<span·class="op">(</span>ALLEGRO_SAMPLE·<span·class="op">*</span>spl<span·class="op">,</span>·<span·class="dt">float</span>·gain<span·class="op">,</span>·<span·class="dt">float</span>·pan<span·class="op">,</span>·<span·class="dt">float</span>·speed<span·class="op">,</span></span>
633 <span·id="cb8-2"><a·href="#cb8-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_PLAYMODE·loop<span·class="op">,</span>·ALLEGRO_SAMPLE_ID·<span·class="op">*</span>ret_id<span·class="op">)</span></span></code></pre></div>665 <span·id="cb8-2"><a·href="#cb8-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_PLAYMODE·loop<span·class="op">,</span>·ALLEGRO_SAMPLE_ID·<span·class="op">*</span>ret_id<span·class="op">)</span></span></code></pre></div>
634 <p><a666 <p><a
635 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_sample.c#L342">Source667 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_sample.c#L342">Source
636 Code</a></p>668 Code</a></p>
637 <p>Plays·a·sample·on·one·of·the·sample·instances·created·by·<a669 <p>Plays·a·sample·on·one·of·the·sample·instances·created·by·<a
Offset 657, 31 lines modifiedOffset 689, 54 lines modified
657 <p>See·also:·<a·href="audio.html#al_load_sample">al_load_sample</a>,·<a689 <p>See·also:·<a·href="audio.html#al_load_sample">al_load_sample</a>,·<a
658 href="audio.html#allegro_playmode">ALLEGRO_PLAYMODE</a>,·<a690 href="audio.html#allegro_playmode">ALLEGRO_PLAYMODE</a>,·<a
659 href="audio.html#allegro_audio_pan_none">ALLEGRO_AUDIO_PAN_NONE</a>,·<a691 href="audio.html#allegro_audio_pan_none">ALLEGRO_AUDIO_PAN_NONE</a>,·<a
660 href="audio.html#allegro_sample_id">ALLEGRO_SAMPLE_ID</a>,·<a692 href="audio.html#allegro_sample_id">ALLEGRO_SAMPLE_ID</a>,·<a
661 href="audio.html#al_stop_sample">al_stop_sample</a>,·<a693 href="audio.html#al_stop_sample">al_stop_sample</a>,·<a
662 href="audio.html#al_stop_samples">al_stop_samples</a>,·<a694 href="audio.html#al_stop_samples">al_stop_samples</a>,·<a
663 href="audio.html#al_lock_sample_id">al_lock_sample_id</a>.</p>695 href="audio.html#al_lock_sample_id">al_lock_sample_id</a>.</p>
 696 <p>Examples:</p>
 697 <ul>
 698 <li><a
 699 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L107">ex_acodec_multi.c</a></li>
 700 <li><a
 701 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_kcm_direct.c#L80">ex_kcm_direct.c</a></li>
 702 <li><a
 703 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mixer_chain.c#L90">ex_mixer_chain.c</a></li>
 704 </ul>
664 <h2·id="al_stop_sample">al_stop_sample</h2>705 <h2·id="al_stop_sample">al_stop_sample</h2>
665 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_stop_sample<span·class="op">(</span>ALLEGRO_SAMPLE_ID·<span·class="op">*</span>spl_id<span·class="op">)</span></span></code></pre></div>706 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_stop_sample<span·class="op">(</span>ALLEGRO_SAMPLE_ID·<span·class="op">*</span>spl_id<span·class="op">)</span></span></code></pre></div>
666 <p><a707 <p><a
667 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_sample.c#L401">Source708 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_sample.c#L401">Source
668 Code</a></p>709 Code</a></p>
669 <p>Stop·the·sample·started·by·<a710 <p>Stop·the·sample·started·by·<a
670 href="audio.html#al_play_sample">al_play_sample</a>.</p>711 href="audio.html#al_play_sample">al_play_sample</a>.</p>
671 <p>See·also:·<a712 <p>See·also:·<a
672 href="audio.html#al_stop_samples">al_stop_samples</a></p>713 href="audio.html#al_stop_samples">al_stop_samples</a></p>
 714 <p>Examples:</p>
 715 <ul>
 716 <li><a
 717 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_acodec_multi.c#L123">ex_acodec_multi.c</a></li>
 718 <li><a
 719 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_kcm_direct.c#L88">ex_kcm_direct.c</a></li>
 720 <li><a
 721 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mixer_chain.c#L108">ex_mixer_chain.c</a></li>
 722 </ul>
673 <h2·id="al_stop_samples">al_stop_samples</h2>723 <h2·id="al_stop_samples">al_stop_samples</h2>
674 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_stop_samples<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>724 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_stop_samples<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
675 <p><a725 <p><a
676 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_sample.c#L451">Source726 href="https://github.com/liballeg/allegro5/blob/master/addons/audio/kcm_sample.c#L451">Source
677 Code</a></p>727 Code</a></p>
678 <p>Stop·all·samples·started·by·<a728 <p>Stop·all·samples·started·by·<a
679 href="audio.html#al_play_sample">al_play_sample</a>.</p>729 href="audio.html#al_play_sample">al_play_sample</a>.</p>
680 <p>See·also:·<a·href="audio.html#al_stop_sample">al_stop_sample</a></p>730 <p>See·also:·<a·href="audio.html#al_stop_sample">al_stop_sample</a></p>
Max diff block lines reached; 115523/123344 bytes (93.66%) of diff not shown.
82.0 KB
html2text {}
    
Offset 232, 28 lines modifiedOffset 232, 38 lines modified
232 the·basic·API·only·supports·one·such·audio·stream·playing·at·once.232 the·basic·API·only·supports·one·such·audio·stream·playing·at·once.
233 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_S\x8SA\x8AM\x8MP\x8PL\x8LE\x8E_\x8_I\x8ID\x8D·*\x8**\x8**\x8**\x8**\x8*233 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_S\x8SA\x8AM\x8MP\x8PL\x8LE\x8E_\x8_I\x8ID\x8D·*\x8**\x8**\x8**\x8**\x8*
234 typedef·struct·ALLEGRO_SAMPLE_ID·ALLEGRO_SAMPLE_ID;234 typedef·struct·ALLEGRO_SAMPLE_ID·ALLEGRO_SAMPLE_ID;
235 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e235 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
236 An·ALLEGRO_SAMPLE_ID·represents·a·sample·being·played·via·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e.·It236 An·ALLEGRO_SAMPLE_ID·represents·a·sample·being·played·via·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e.·It
237 can·be·used·to·later·stop·the·sample·with·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e.·The·underlying237 can·be·used·to·later·stop·the·sample·with·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e.·The·underlying
238 ALLEGRO_SAMPLE_INSTANCE·can·be·extracted·using·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d.238 ALLEGRO_SAMPLE_INSTANCE·can·be·extracted·using·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d.
 239 Examples:
 240 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8i_\x8m_\x8p_\x8l_\x8e_\x8._\x8c
239 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_a\x8au\x8ud\x8di\x8io\x8o·*\x8**\x8**\x8**\x8**\x8*241 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_a\x8au\x8ud\x8di\x8io\x8o·*\x8**\x8**\x8**\x8**\x8*
240 bool·al_install_audio(void)242 bool·al_install_audio(void)
241 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e243 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
242 Install·the·audio·subsystem.244 Install·the·audio·subsystem.
243 Returns·true·on·success,·false·on·failure.245 Returns·true·on·success,·false·on·failure.
244 ·····Note:·most·users·will·call·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8e_\x8r_\x8v_\x8e_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s·and246 ·····Note:·most·users·will·call·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8e_\x8r_\x8v_\x8e_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s·and
245 ·····_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8a_\x8c_\x8o_\x8d_\x8e_\x8c_\x8__\x8a_\x8d_\x8d_\x8o_\x8n·after·this.247 ·····_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8a_\x8c_\x8o_\x8d_\x8e_\x8c_\x8__\x8a_\x8d_\x8d_\x8o_\x8n·after·this.
246 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8e_\x8r_\x8v_\x8e_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8a_\x8u_\x8d_\x8i_\x8o,·_\x8a_\x8l_\x8__\x8i_\x8s_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8e_\x8d,248 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8e_\x8r_\x8v_\x8e_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8a_\x8u_\x8d_\x8i_\x8o,·_\x8a_\x8l_\x8__\x8i_\x8s_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8e_\x8d,
247 _\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8a_\x8c_\x8o_\x8d_\x8e_\x8c_\x8__\x8a_\x8d_\x8d_\x8o_\x8n249 _\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8a_\x8c_\x8o_\x8d_\x8e_\x8c_\x8__\x8a_\x8d_\x8d_\x8o_\x8n
 250 Examples:
 251 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8d_\x8e_\x8v_\x8i_\x8c_\x8e_\x8s_\x8._\x8c
 252 ····*·_\x8e_\x8x_\x8__\x8s_\x8a_\x8w_\x8._\x8c
 253 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c
248 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_a\x8au\x8ud\x8di\x8io\x8o·*\x8**\x8**\x8**\x8**\x8*254 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_a\x8au\x8ud\x8di\x8io\x8o·*\x8**\x8**\x8**\x8**\x8*
249 void·al_uninstall_audio(void)255 void·al_uninstall_audio(void)
250 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e256 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
251 Uninstalls·the·audio·subsystem.257 Uninstalls·the·audio·subsystem.
252 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8a_\x8u_\x8d_\x8i_\x8o258 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8a_\x8u_\x8d_\x8i_\x8o
 259 Examples:
 260 ····*·_\x8e_\x8x_\x8__\x8s_\x8a_\x8w_\x8._\x8c
 261 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c
 262 ····*·_\x8e_\x8x_\x8__\x8a_\x8c_\x8o_\x8d_\x8e_\x8c_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8._\x8c
253 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_a\x8au\x8ud\x8di\x8io\x8o_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8*263 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_a\x8au\x8ud\x8di\x8io\x8o_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8*
254 bool·al_is_audio_installed(void)264 bool·al_is_audio_installed(void)
255 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e265 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
256 Returns·true·if·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8a_\x8u_\x8d_\x8i_\x8o·was·called·previously·and·returned266 Returns·true·if·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8a_\x8u_\x8d_\x8i_\x8o·was·called·previously·and·returned
257 successfully.267 successfully.
258 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8se\x8er\x8rv\x8ve\x8e_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8es\x8s·*\x8**\x8**\x8**\x8**\x8*268 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8se\x8er\x8rv\x8ve\x8e_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8es\x8s·*\x8**\x8**\x8**\x8**\x8*
259 bool·al_reserve_samples(int·reserve_samples)269 bool·al_reserve_samples(int·reserve_samples)
Offset 270, 14 lines modifiedOffset 280, 18 lines modified
270 ····································/·sample·instance·2280 ····································/·sample·instance·2
271 default·voice·<--·default·mixer·<---·········.281 default·voice·<--·default·mixer·<---·········.
272 ····································\········.282 ····································\········.
273 ······································sample·instance·N283 ······································sample·instance·N
274 Returns·true·on·success,·false·on·error.·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8a_\x8u_\x8d_\x8i_\x8o·must·have·been·called284 Returns·true·on·success,·false·on·error.·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8a_\x8u_\x8d_\x8i_\x8o·must·have·been·called
275 first.285 first.
276 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8d_\x8e_\x8f_\x8a_\x8u_\x8l_\x8t_\x8__\x8m_\x8i_\x8x_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e286 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8d_\x8e_\x8f_\x8a_\x8u_\x8l_\x8t_\x8__\x8m_\x8i_\x8x_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e
 287 Examples:
 288 ····*·_\x8e_\x8x_\x8__\x8s_\x8a_\x8w_\x8._\x8c
 289 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8p_\x8r_\x8o_\x8p_\x8s_\x8._\x8c_\x8p_\x8p
 290 ····*·_\x8e_\x8x_\x8__\x8r_\x8e_\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
277 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_p\x8pl\x8la\x8ay\x8y_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*291 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_p\x8pl\x8la\x8ay\x8y_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
278 bool·al_play_sample(ALLEGRO_SAMPLE·*spl,·float·gain,·float·pan,·float·speed,292 bool·al_play_sample(ALLEGRO_SAMPLE·*spl,·float·gain,·float·pan,·float·speed,
279 ···ALLEGRO_PLAYMODE·loop,·ALLEGRO_SAMPLE_ID·*ret_id)293 ···ALLEGRO_PLAYMODE·loop,·ALLEGRO_SAMPLE_ID·*ret_id)
280 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e294 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
281 Plays·a·sample·on·one·of·the·sample·instances·created·by·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8e_\x8r_\x8v_\x8e_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s.295 Plays·a·sample·on·one·of·the·sample·instances·created·by·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8e_\x8r_\x8v_\x8e_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s.
282 Returns·true·on·success,·false·on·failure.·Playback·may·fail·because·all·the296 Returns·true·on·success,·false·on·failure.·Playback·may·fail·because·all·the
283 reserved·sample·instances·are·currently·used.297 reserved·sample·instances·are·currently·used.
Offset 290, 24 lines modifiedOffset 304, 34 lines modified
290 ······ALLEGRO_PLAYMODE_BIDIR304 ······ALLEGRO_PLAYMODE_BIDIR
291 ····*·ret_id·-·if·non-NULL·the·variable·which·this·points·to·will·be·assigned305 ····*·ret_id·-·if·non-NULL·the·variable·which·this·points·to·will·be·assigned
292 ······an·id·representing·the·sample·being·played.·If·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e·returns306 ······an·id·representing·the·sample·being·played.·If·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e·returns
293 ······false,·then·the·contents·of·ret_id·are·invalid·and·must·not·be·used·as307 ······false,·then·the·contents·of·ret_id·are·invalid·and·must·not·be·used·as
294 ······argument·to·other·functions.308 ······argument·to·other·functions.
295 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8P_\x8L_\x8A_\x8Y_\x8M_\x8O_\x8D_\x8E,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8A_\x8U_\x8D_\x8I_\x8O_\x8__\x8P_\x8A_\x8N_\x8__\x8N_\x8O_\x8N_\x8E,309 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8P_\x8L_\x8A_\x8Y_\x8M_\x8O_\x8D_\x8E,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8A_\x8U_\x8D_\x8I_\x8O_\x8__\x8P_\x8A_\x8N_\x8__\x8N_\x8O_\x8N_\x8E,
296 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8D,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d.310 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8D,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d.
 311 Examples:
 312 ····*·_\x8e_\x8x_\x8__\x8a_\x8c_\x8o_\x8d_\x8e_\x8c_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8._\x8c
 313 ····*·_\x8e_\x8x_\x8__\x8k_\x8c_\x8m_\x8__\x8d_\x8i_\x8r_\x8e_\x8c_\x8t_\x8._\x8c
 314 ····*·_\x8e_\x8x_\x8__\x8m_\x8i_\x8x_\x8e_\x8r_\x8__\x8c_\x8h_\x8a_\x8i_\x8n_\x8._\x8c
297 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8to\x8op\x8p_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*315 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8to\x8op\x8p_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
298 void·al_stop_sample(ALLEGRO_SAMPLE_ID·*spl_id)316 void·al_stop_sample(ALLEGRO_SAMPLE_ID·*spl_id)
299 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e317 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
300 Stop·the·sample·started·by·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e.318 Stop·the·sample·started·by·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e.
301 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s319 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s
 320 Examples:
 321 ····*·_\x8e_\x8x_\x8__\x8a_\x8c_\x8o_\x8d_\x8e_\x8c_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8._\x8c
 322 ····*·_\x8e_\x8x_\x8__\x8k_\x8c_\x8m_\x8__\x8d_\x8i_\x8r_\x8e_\x8c_\x8t_\x8._\x8c
 323 ····*·_\x8e_\x8x_\x8__\x8m_\x8i_\x8x_\x8e_\x8r_\x8__\x8c_\x8h_\x8a_\x8i_\x8n_\x8._\x8c
302 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8to\x8op\x8p_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8es\x8s·*\x8**\x8**\x8**\x8**\x8*324 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8to\x8op\x8p_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8es\x8s·*\x8**\x8**\x8**\x8**\x8*
303 void·al_stop_samples(void)325 void·al_stop_samples(void)
304 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e326 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
305 Stop·all·samples·started·by·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e.327 Stop·all·samples·started·by·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e.
306 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e328 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e
 329 Examples:
 330 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8i_\x8m_\x8p_\x8l_\x8e_\x8._\x8c
307 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_l\x8lo\x8oc\x8ck\x8k_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8e_\x8_i\x8id\x8d·*\x8**\x8**\x8**\x8**\x8*331 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_l\x8lo\x8oc\x8ck\x8k_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8e_\x8_i\x8id\x8d·*\x8**\x8**\x8**\x8**\x8*
308 ALLEGRO_SAMPLE_INSTANCE*·al_lock_sample_id(ALLEGRO_SAMPLE_ID·*spl_id)332 ALLEGRO_SAMPLE_INSTANCE*·al_lock_sample_id(ALLEGRO_SAMPLE_ID·*spl_id)
309 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e333 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
310 Locks·a·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8D,·returning·the·underlying·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8N_\x8S_\x8T_\x8A_\x8N_\x8C_\x8E.334 Locks·a·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8D,·returning·the·underlying·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8N_\x8S_\x8T_\x8A_\x8N_\x8C_\x8E.
311 This·allows·you·to·adjust·the·various·properties·of·the·instance·(such·as335 This·allows·you·to·adjust·the·various·properties·of·the·instance·(such·as
312 volume,·pan,·etc)·while·the·sound·is·playing.336 volume,·pan,·etc)·while·the·sound·is·playing.
313 This·function·will·return·NULL·if·the·sound·corresponding·to·the·id·is·no337 This·function·will·return·NULL·if·the·sound·corresponding·to·the·id·is·no
Offset 315, 24 lines modifiedOffset 339, 28 lines modified
315 While·locked,·ALLEGRO_SAMPLE_ID·will·be·unavailable·to·additional·calls·to339 While·locked,·ALLEGRO_SAMPLE_ID·will·be·unavailable·to·additional·calls·to
316 _\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·even·if·the·sound·stops·while·locked.·To·put·the340 _\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·even·if·the·sound·stops·while·locked.·To·put·the
317 ALLEGRO_SAMPLE_ID·back·into·the·pool·for·reuse,·make·sure·to·call341 ALLEGRO_SAMPLE_ID·back·into·the·pool·for·reuse,·make·sure·to·call
318 al_unlock_sample_id·when·you’re·done·with·the·instance.342 al_unlock_sample_id·when·you’re·done·with·the·instance.
319 See·also:·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d343 See·also:·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d
320 Since:·5.2.3344 Since:·5.2.3
321 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·New·API.345 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·New·API.
 346 Examples:
 347 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8i_\x8m_\x8p_\x8l_\x8e_\x8._\x8c
322 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nl\x8lo\x8oc\x8ck\x8k_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8e_\x8_i\x8id\x8d·*\x8**\x8**\x8**\x8**\x8*348 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nl\x8lo\x8oc\x8ck\x8k_\x8_s\x8sa\x8am\x8mp\x8pl\x8le\x8e_\x8_i\x8id\x8d·*\x8**\x8**\x8**\x8**\x8*
323 void·al_unlock_sample_id(ALLEGRO_SAMPLE_ID·*spl_id)349 void·al_unlock_sample_id(ALLEGRO_SAMPLE_ID·*spl_id)
324 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e350 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
325 Unlocks·a·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8D,·allowing·future·calls·to·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e·to·reuse351 Unlocks·a·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8D,·allowing·future·calls·to·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e·to·reuse
326 it·if·possible.·Note·that·after·the·id·is·unlocked,·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8N_\x8S_\x8T_\x8A_\x8N_\x8C_\x8E352 it·if·possible.·Note·that·after·the·id·is·unlocked,·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8A_\x8M_\x8P_\x8L_\x8E_\x8__\x8I_\x8N_\x8S_\x8T_\x8A_\x8N_\x8C_\x8E
327 that·was·previously·returned·by·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d·will·possibly·be·playing·a353 that·was·previously·returned·by·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d·will·possibly·be·playing·a
328 different·sound,·so·you·should·only·use·it·after·locking·the·id·again.354 different·sound,·so·you·should·only·use·it·after·locking·the·id·again.
329 See·also:·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d355 See·also:·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8i_\x8d
330 Since:·5.2.3356 Since:·5.2.3
331 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·New·API.357 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·New·API.
 358 Examples:
 359 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8i_\x8m_\x8p_\x8l_\x8e_\x8._\x8c
332 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_p\x8pl\x8la\x8ay\x8y_\x8_a\x8au\x8ud\x8di\x8io\x8o_\x8_s\x8st\x8tr\x8re\x8ea\x8am\x8m·*\x8**\x8**\x8**\x8**\x8*360 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_p\x8pl\x8la\x8ay\x8y_\x8_a\x8au\x8ud\x8di\x8io\x8o_\x8_s\x8st\x8tr\x8re\x8ea\x8am\x8m·*\x8**\x8**\x8**\x8**\x8*
333 ALLEGRO_AUDIO_STREAM·*al_play_audio_stream(const·char·*filename)361 ALLEGRO_AUDIO_STREAM·*al_play_audio_stream(const·char·*filename)
334 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e362 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
335 Loads·and·plays·an·audio·file,·streaming·from·disk·as·it·is·needed.·This·API363 Loads·and·plays·an·audio·file,·streaming·from·disk·as·it·is·needed.·This·API
336 can·only·play·one·audio·stream·at·a·time.·This·requires·a·default·mixer·to·be364 can·only·play·one·audio·stream·at·a·time.·This·requires·a·default·mixer·to·be
337 set,·which·is·typically·done·via·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8e_\x8r_\x8v_\x8e_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s,·but·can·also·be·done·via365 set,·which·is·typically·done·via·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8e_\x8r_\x8v_\x8e_\x8__\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8s,·but·can·also·be·done·via
338 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8d_\x8e_\x8f_\x8a_\x8u_\x8l_\x8t_\x8__\x8m_\x8i_\x8x_\x8e_\x8r.366 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8d_\x8e_\x8f_\x8a_\x8u_\x8l_\x8t_\x8__\x8m_\x8i_\x8x_\x8e_\x8r.
Offset 341, 14 lines modifiedOffset 369, 16 lines modified
341 down.369 down.
342 ·····N\x8No\x8ot\x8te\x8e:\x8:·the·allegro_audio·library·does·not·support·any·audio·file370 ·····N\x8No\x8ot\x8te\x8e:\x8:·the·allegro_audio·library·does·not·support·any·audio·file
343 ·····formats·by·default.·You·must·use·the·allegro_acodec·addon,·or371 ·····formats·by·default.·You·must·use·the·allegro_acodec·addon,·or
344 ·····register·your·own·format·handler.372 ·····register·your·own·format·handler.
345 See·also:·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m373 See·also:·_\x8a_\x8l_\x8__\x8p_\x8l_\x8a_\x8y_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m
Max diff block lines reached; 75900/83925 bytes (90.44%) of diff not shown.
52.8 KB
./usr/share/doc/allegro5-doc/refman/color.html
    
Offset 272, 23 lines modifiedOffset 272, 33 lines modified
272 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L480">Source272 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L480">Source
273 Code</a></p>273 Code</a></p>
274 <p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>274 <p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>
275 structure·from·CMYK·values·(cyan,·magenta,·yellow,·black).</p>275 structure·from·CMYK·values·(cyan,·magenta,·yellow,·black).</p>
276 <p>See·also:·<a276 <p>See·also:·<a
277 href="color.html#al_color_cmyk_to_rgb">al_color_cmyk_to_rgb</a>,·<a277 href="color.html#al_color_cmyk_to_rgb">al_color_cmyk_to_rgb</a>,·<a
278 href="color.html#al_color_rgb_to_cmyk">al_color_rgb_to_cmyk</a></p>278 href="color.html#al_color_rgb_to_cmyk">al_color_rgb_to_cmyk</a></p>
 279 <p>Examples:</p>
 280 <ul>
 281 <li><a
 282 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color.cpp#L124">ex_color.cpp</a></li>
 283 </ul>
279 <h1·id="al_color_cmyk_to_rgb">al_color_cmyk_to_rgb</h1>284 <h1·id="al_color_cmyk_to_rgb">al_color_cmyk_to_rgb</h1>
280 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_color_cmyk_to_rgb<span·class="op">(</span><span·class="dt">float</span>·cyan<span·class="op">,</span>·<span·class="dt">float</span>·magenta<span·class="op">,</span>·<span·class="dt">float</span>·yellow<span·class="op">,</span></span>285 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_color_cmyk_to_rgb<span·class="op">(</span><span·class="dt">float</span>·cyan<span·class="op">,</span>·<span·class="dt">float</span>·magenta<span·class="op">,</span>·<span·class="dt">float</span>·yellow<span·class="op">,</span></span>
281 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a>····<span·class="dt">float</span>·key<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>red<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>green<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>blue<span·class="op">)</span></span></code></pre></div>286 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a>····<span·class="dt">float</span>·key<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>red<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>green<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>blue<span·class="op">)</span></span></code></pre></div>
282 <p><a287 <p><a
283 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L446">Source288 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L446">Source
284 Code</a></p>289 Code</a></p>
285 <p>Convert·CMYK·values·to·RGB·values.</p>290 <p>Convert·CMYK·values·to·RGB·values.</p>
286 <p>See·also:·<a·href="color.html#al_color_cmyk">al_color_cmyk</a>,·<a291 <p>See·also:·<a·href="color.html#al_color_cmyk">al_color_cmyk</a>,·<a
287 href="color.html#al_color_rgb_to_cmyk">al_color_rgb_to_cmyk</a></p>292 href="color.html#al_color_rgb_to_cmyk">al_color_rgb_to_cmyk</a></p>
 293 <p>Examples:</p>
 294 <ul>
 295 <li><a
 296 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color.cpp#L124">ex_color.cpp</a></li>
 297 </ul>
288 <h1·id="al_color_hsl">al_color_hsl</h1>298 <h1·id="al_color_hsl">al_color_hsl</h1>
289 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_color_hsl<span·class="op">(</span><span·class="dt">float</span>·h<span·class="op">,</span>·<span·class="dt">float</span>·s<span·class="op">,</span>·<span·class="dt">float</span>·l<span·class="op">)</span></span></code></pre></div>299 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_color_hsl<span·class="op">(</span><span·class="dt">float</span>·h<span·class="op">,</span>·<span·class="dt">float</span>·s<span·class="op">,</span>·<span·class="dt">float</span>·l<span·class="op">)</span></span></code></pre></div>
290 <p><a300 <p><a
291 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L436">Source301 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L436">Source
292 Code</a></p>302 Code</a></p>
293 <p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>303 <p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>
294 structure·from·HSL·(hue,·saturation,·lightness)·values.</p>304 structure·from·HSL·(hue,·saturation,·lightness)·values.</p>
Offset 297, 14 lines modifiedOffset 307, 23 lines modified
297 <li>hue·-·Color·hue·angle·in·the·range·0..360</li>307 <li>hue·-·Color·hue·angle·in·the·range·0..360</li>
298 <li>saturation·-·Color·saturation·in·the·range·0..1</li>308 <li>saturation·-·Color·saturation·in·the·range·0..1</li>
299 <li>lightness·-·Color·lightness·in·the·range·0..1</li>309 <li>lightness·-·Color·lightness·in·the·range·0..1</li>
300 </ul>310 </ul>
301 <p>See·also:·<a311 <p>See·also:·<a
302 href="color.html#al_color_hsl_to_rgb">al_color_hsl_to_rgb</a>,·<a312 href="color.html#al_color_hsl_to_rgb">al_color_hsl_to_rgb</a>,·<a
303 href="color.html#al_color_hsv">al_color_hsv</a></p>313 href="color.html#al_color_hsv">al_color_hsv</a></p>
 314 <p>Examples:</p>
 315 <ul>
 316 <li><a
 317 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color.cpp#L101">ex_color.cpp</a></li>
 318 <li><a
 319 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_clip.c#L50">ex_clip.c</a></li>
 320 <li><a
 321 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_palette.c#L89">ex_palette.c</a></li>
 322 </ul>
304 <h1·id="al_color_hsl_to_rgb">al_color_hsl_to_rgb</h1>323 <h1·id="al_color_hsl_to_rgb">al_color_hsl_to_rgb</h1>
305 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_color_hsl_to_rgb<span·class="op">(</span><span·class="dt">float</span>·hue<span·class="op">,</span>·<span·class="dt">float</span>·saturation<span·class="op">,</span>·<span·class="dt">float</span>·lightness<span·class="op">,</span></span>324 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_color_hsl_to_rgb<span·class="op">(</span><span·class="dt">float</span>·hue<span·class="op">,</span>·<span·class="dt">float</span>·saturation<span·class="op">,</span>·<span·class="dt">float</span>·lightness<span·class="op">,</span></span>
306 <span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·<span·class="op">*</span>red<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>green<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>blue<span·class="op">)</span></span></code></pre></div>325 <span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·<span·class="op">*</span>red<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>green<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>blue<span·class="op">)</span></span></code></pre></div>
307 <p><a326 <p><a
308 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L367">Source327 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L367">Source
309 Code</a></p>328 Code</a></p>
310 <p>Convert·values·in·HSL·color·model·to·RGB·color·model.</p>329 <p>Convert·values·in·HSL·color·model·to·RGB·color·model.</p>
Offset 315, 14 lines modifiedOffset 334, 21 lines modified
315 <li>lightness·-·Color·lightness·in·the·range·0..1</li>334 <li>lightness·-·Color·lightness·in·the·range·0..1</li>
316 <li>red,·green,·blue·-·returned·RGB·values·in·the·range·0..1</li>335 <li>red,·green,·blue·-·returned·RGB·values·in·the·range·0..1</li>
317 </ul>336 </ul>
318 <p>See·also:·<a337 <p>See·also:·<a
319 href="color.html#al_color_rgb_to_hsl">al_color_rgb_to_hsl</a>,·<a338 href="color.html#al_color_rgb_to_hsl">al_color_rgb_to_hsl</a>,·<a
320 href="color.html#al_color_hsl">al_color_hsl</a>,·<a339 href="color.html#al_color_hsl">al_color_hsl</a>,·<a
321 href="color.html#al_color_hsv_to_rgb">al_color_hsv_to_rgb</a></p>340 href="color.html#al_color_hsv_to_rgb">al_color_hsv_to_rgb</a></p>
 341 <p>Examples:</p>
 342 <ul>
 343 <li><a
 344 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color.cpp#L101">ex_color.cpp</a></li>
 345 <li><a
 346 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_palette.c#L89">ex_palette.c</a></li>
 347 </ul>
322 <h1·id="al_color_hsv">al_color_hsv</h1>348 <h1·id="al_color_hsv">al_color_hsv</h1>
323 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_color_hsv<span·class="op">(</span><span·class="dt">float</span>·h<span·class="op">,</span>·<span·class="dt">float</span>·s<span·class="op">,</span>·<span·class="dt">float</span>·v<span·class="op">)</span></span></code></pre></div>349 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_color_hsv<span·class="op">(</span><span·class="dt">float</span>·h<span·class="op">,</span>·<span·class="dt">float</span>·s<span·class="op">,</span>·<span·class="dt">float</span>·v<span·class="op">)</span></span></code></pre></div>
324 <p><a350 <p><a
325 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L339">Source351 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L339">Source
326 Code</a></p>352 Code</a></p>
327 <p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>353 <p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>
328 structure·from·HSV·(hue,·saturation,·value)·values.</p>354 structure·from·HSV·(hue,·saturation,·value)·values.</p>
Offset 331, 14 lines modifiedOffset 357, 23 lines modified
331 <li>hue·-·Color·hue·angle·in·the·range·0..360</li>357 <li>hue·-·Color·hue·angle·in·the·range·0..360</li>
332 <li>saturation·-·Color·saturation·in·the·range·0..1</li>358 <li>saturation·-·Color·saturation·in·the·range·0..1</li>
333 <li>value·-·Color·value·in·the·range·0..1</li>359 <li>value·-·Color·value·in·the·range·0..1</li>
334 </ul>360 </ul>
335 <p>See·also:·<a361 <p>See·also:·<a
336 href="color.html#al_color_hsv_to_rgb">al_color_hsv_to_rgb</a>,·<a362 href="color.html#al_color_hsv_to_rgb">al_color_hsv_to_rgb</a>,·<a
337 href="color.html#al_color_hsl">al_color_hsl</a></p>363 href="color.html#al_color_hsl">al_color_hsl</a></p>
 364 <p>Examples:</p>
 365 <ul>
 366 <li><a
 367 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_multiline.cpp#L250">ex_font_multiline.cpp</a></li>
 368 <li><a
 369 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color.cpp#L92">ex_color.cpp</a></li>
 370 <li><a
 371 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_multisample.c#L95">ex_multisample.c</a></li>
 372 </ul>
338 <h1·id="al_color_hsv_to_rgb">al_color_hsv_to_rgb</h1>373 <h1·id="al_color_hsv_to_rgb">al_color_hsv_to_rgb</h1>
339 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_color_hsv_to_rgb<span·class="op">(</span><span·class="dt">float</span>·hue<span·class="op">,</span>·<span·class="dt">float</span>·saturation<span·class="op">,</span>·<span·class="dt">float</span>·value<span·class="op">,</span></span>374 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_color_hsv_to_rgb<span·class="op">(</span><span·class="dt">float</span>·hue<span·class="op">,</span>·<span·class="dt">float</span>·saturation<span·class="op">,</span>·<span·class="dt">float</span>·value<span·class="op">,</span></span>
340 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·<span·class="op">*</span>red<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>green<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>blue<span·class="op">)</span></span></code></pre></div>375 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·<span·class="op">*</span>red<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>green<span·class="op">,</span>·<span·class="dt">float</span>·<span·class="op">*</span>blue<span·class="op">)</span></span></code></pre></div>
341 <p><a376 <p><a
342 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L266">Source377 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L266">Source
343 Code</a></p>378 Code</a></p>
344 <p>Convert·values·in·HSV·color·model·to·RGB·color·model.</p>379 <p>Convert·values·in·HSV·color·model·to·RGB·color·model.</p>
Offset 349, 14 lines modifiedOffset 384, 19 lines modified
349 <li>value·-·Color·value·in·the·range·0..1</li>384 <li>value·-·Color·value·in·the·range·0..1</li>
350 <li>red,·green,·blue·-·returned·RGB·values·in·the·range·0..1</li>385 <li>red,·green,·blue·-·returned·RGB·values·in·the·range·0..1</li>
351 </ul>386 </ul>
352 <p>See·also:·<a387 <p>See·also:·<a
353 href="color.html#al_color_rgb_to_hsv">al_color_rgb_to_hsv</a>,·<a388 href="color.html#al_color_rgb_to_hsv">al_color_rgb_to_hsv</a>,·<a
354 href="color.html#al_color_hsv">al_color_hsv</a>,·<a389 href="color.html#al_color_hsv">al_color_hsv</a>,·<a
355 href="color.html#al_color_hsl_to_rgb">al_color_hsl_to_rgb</a></p>390 href="color.html#al_color_hsl_to_rgb">al_color_hsl_to_rgb</a></p>
 391 <p>Examples:</p>
 392 <ul>
 393 <li><a
 394 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color.cpp#L92">ex_color.cpp</a></li>
 395 </ul>
356 <h1·id="al_color_html">al_color_html</h1>396 <h1·id="al_color_html">al_color_html</h1>
357 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_color_html<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>string<span·class="op">)</span></span></code></pre></div>397 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_color_html<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>string<span·class="op">)</span></span></code></pre></div>
358 <p><a398 <p><a
359 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L568">Source399 href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L568">Source
360 Code</a></p>400 Code</a></p>
361 <p>Interprets·an·HTML-style·hex·number·(e.g. #00faff)·as·a·color.·The401 <p>Interprets·an·HTML-style·hex·number·(e.g. #00faff)·as·a·color.·The
362 accepted·format·is·the·same·as·<a402 accepted·format·is·the·same·as·<a
Offset 404, 25 lines modifiedOffset 444, 39 lines modified
404 </ul>444 </ul>
405 <p>Example:</p>445 <p>Example:</p>
406 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">char</span>·html<span·class="op">[</span><span·class="dv">8</span><span·class="op">];</span></span>446 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">char</span>·html<span·class="op">[</span><span·class="dv">8</span><span·class="op">];</span></span>
Max diff block lines reached; 26602/35681 bytes (74.56%) of diff not shown.
17.8 KB
html2text {}
    
Offset 103, 60 lines modifiedOffset 103, 77 lines modified
103 output·of·the·monitor·will·be·less·than·half).103 output·of·the·monitor·will·be·less·than·half).
104 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_c\x8cm\x8my\x8yk\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*104 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_c\x8cm\x8my\x8yk\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*
105 ALLEGRO_COLOR·al_color_cmyk(float·c,·float·m,·float·y,·float·k)105 ALLEGRO_COLOR·al_color_cmyk(float·c,·float·m,·float·y,·float·k)
106 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e106 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
107 Return·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R·structure·from·CMYK·values·(cyan,·magenta,·yellow,107 Return·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R·structure·from·CMYK·values·(cyan,·magenta,·yellow,
108 black).108 black).
109 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8c_\x8m_\x8y_\x8k_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8r_\x8g_\x8b_\x8__\x8t_\x8o_\x8__\x8c_\x8m_\x8y_\x8k109 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8c_\x8m_\x8y_\x8k_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8r_\x8g_\x8b_\x8__\x8t_\x8o_\x8__\x8c_\x8m_\x8y_\x8k
 110 Examples:
 111 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
110 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_c\x8cm\x8my\x8yk\x8k_\x8_t\x8to\x8o_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8**\x8*112 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_c\x8cm\x8my\x8yk\x8k_\x8_t\x8to\x8o_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8**\x8*
111 void·al_color_cmyk_to_rgb(float·cyan,·float·magenta,·float·yellow,113 void·al_color_cmyk_to_rgb(float·cyan,·float·magenta,·float·yellow,
112 ····float·key,·float·*red,·float·*green,·float·*blue)114 ····float·key,·float·*red,·float·*green,·float·*blue)
113 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e115 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
114 Convert·CMYK·values·to·RGB·values.116 Convert·CMYK·values·to·RGB·values.
115 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8c_\x8m_\x8y_\x8k,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8r_\x8g_\x8b_\x8__\x8t_\x8o_\x8__\x8c_\x8m_\x8y_\x8k117 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8c_\x8m_\x8y_\x8k,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8r_\x8g_\x8b_\x8__\x8t_\x8o_\x8__\x8c_\x8m_\x8y_\x8k
 118 Examples:
 119 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
116 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8hs\x8sl\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*120 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8hs\x8sl\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*
117 ALLEGRO_COLOR·al_color_hsl(float·h,·float·s,·float·l)121 ALLEGRO_COLOR·al_color_hsl(float·h,·float·s,·float·l)
118 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e122 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
119 Return·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R·structure·from·HSL·(hue,·saturation,·lightness)·values.123 Return·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R·structure·from·HSL·(hue,·saturation,·lightness)·values.
120 Parameters:124 Parameters:
121 ····*·hue·-·Color·hue·angle·in·the·range·0..360125 ····*·hue·-·Color·hue·angle·in·the·range·0..360
122 ····*·saturation·-·Color·saturation·in·the·range·0..1126 ····*·saturation·-·Color·saturation·in·the·range·0..1
123 ····*·lightness·-·Color·lightness·in·the·range·0..1127 ····*·lightness·-·Color·lightness·in·the·range·0..1
124 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8v128 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8v
 129 Examples:
 130 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
 131 ····*·_\x8e_\x8x_\x8__\x8c_\x8l_\x8i_\x8p_\x8._\x8c
 132 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8l_\x8e_\x8t_\x8t_\x8e_\x8._\x8c
125 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8hs\x8sl\x8l_\x8_t\x8to\x8o_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8**\x8*133 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8hs\x8sl\x8l_\x8_t\x8to\x8o_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8**\x8*
126 void·al_color_hsl_to_rgb(float·hue,·float·saturation,·float·lightness,134 void·al_color_hsl_to_rgb(float·hue,·float·saturation,·float·lightness,
127 ···float·*red,·float·*green,·float·*blue)135 ···float·*red,·float·*green,·float·*blue)
128 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e136 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
129 Convert·values·in·HSL·color·model·to·RGB·color·model.137 Convert·values·in·HSL·color·model·to·RGB·color·model.
130 Parameters:138 Parameters:
131 ····*·hue·-·Color·hue·angle·in·the·range·0..360139 ····*·hue·-·Color·hue·angle·in·the·range·0..360
132 ····*·saturation·-·Color·saturation·in·the·range·0..1140 ····*·saturation·-·Color·saturation·in·the·range·0..1
133 ····*·lightness·-·Color·lightness·in·the·range·0..1141 ····*·lightness·-·Color·lightness·in·the·range·0..1
134 ····*·red,·green,·blue·-·returned·RGB·values·in·the·range·0..1142 ····*·red,·green,·blue·-·returned·RGB·values·in·the·range·0..1
135 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8r_\x8g_\x8b_\x8__\x8t_\x8o_\x8__\x8h_\x8s_\x8l,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8v_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b143 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8r_\x8g_\x8b_\x8__\x8t_\x8o_\x8__\x8h_\x8s_\x8l,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8v_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b
 144 Examples:
 145 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
 146 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8l_\x8e_\x8t_\x8t_\x8e_\x8._\x8c
136 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8hs\x8sv\x8v·*\x8**\x8**\x8**\x8**\x8**\x8*147 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8hs\x8sv\x8v·*\x8**\x8**\x8**\x8**\x8**\x8*
137 ALLEGRO_COLOR·al_color_hsv(float·h,·float·s,·float·v)148 ALLEGRO_COLOR·al_color_hsv(float·h,·float·s,·float·v)
138 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e149 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
139 Return·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R·structure·from·HSV·(hue,·saturation,·value)·values.150 Return·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R·structure·from·HSV·(hue,·saturation,·value)·values.
140 Parameters:151 Parameters:
141 ····*·hue·-·Color·hue·angle·in·the·range·0..360152 ····*·hue·-·Color·hue·angle·in·the·range·0..360
142 ····*·saturation·-·Color·saturation·in·the·range·0..1153 ····*·saturation·-·Color·saturation·in·the·range·0..1
143 ····*·value·-·Color·value·in·the·range·0..1154 ····*·value·-·Color·value·in·the·range·0..1
144 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8v_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l155 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8v_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l
 156 Examples:
 157 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8l_\x8i_\x8n_\x8e_\x8._\x8c_\x8p_\x8p
 158 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
 159 ····*·_\x8e_\x8x_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8._\x8c
145 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8hs\x8sv\x8v_\x8_t\x8to\x8o_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8**\x8*160 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8hs\x8sv\x8v_\x8_t\x8to\x8o_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8**\x8*
146 void·al_color_hsv_to_rgb(float·hue,·float·saturation,·float·value,161 void·al_color_hsv_to_rgb(float·hue,·float·saturation,·float·value,
147 ···float·*red,·float·*green,·float·*blue)162 ···float·*red,·float·*green,·float·*blue)
148 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e163 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
149 Convert·values·in·HSV·color·model·to·RGB·color·model.164 Convert·values·in·HSV·color·model·to·RGB·color·model.
150 Parameters:165 Parameters:
151 ····*·hue·-·Color·hue·angle·in·the·range·0..360166 ····*·hue·-·Color·hue·angle·in·the·range·0..360
152 ····*·saturation·-·Color·saturation·in·the·range·0..1167 ····*·saturation·-·Color·saturation·in·the·range·0..1
153 ····*·value·-·Color·value·in·the·range·0..1168 ····*·value·-·Color·value·in·the·range·0..1
154 ····*·red,·green,·blue·-·returned·RGB·values·in·the·range·0..1169 ····*·red,·green,·blue·-·returned·RGB·values·in·the·range·0..1
155 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8r_\x8g_\x8b_\x8__\x8t_\x8o_\x8__\x8h_\x8s_\x8v,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8v,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b170 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8r_\x8g_\x8b_\x8__\x8t_\x8o_\x8__\x8h_\x8s_\x8v,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8v,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b
 171 Examples:
 172 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
156 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8ht\x8tm\x8ml\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*173 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_h\x8ht\x8tm\x8ml\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*
157 ALLEGRO_COLOR·al_color_html(char·const·*string)174 ALLEGRO_COLOR·al_color_html(char·const·*string)
158 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e175 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
159 Interprets·an·HTML-style·hex·number·(e.g. #00faff)·as·a·color.·The·accepted176 Interprets·an·HTML-style·hex·number·(e.g. #00faff)·as·a·color.·The·accepted
160 format·is·the·same·as·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8t_\x8m_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b.177 format·is·the·same·as·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8t_\x8m_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b.
161 Returns·the·interpreted·color,·or·al_map_rgba(0,·0,·0,·0)·if·the·string·could178 Returns·the·interpreted·color,·or·al_map_rgba(0,·0,·0,·0)·if·the·string·could
162 not·be·parsed.179 not·be·parsed.
Offset 185, 20 lines modifiedOffset 202, 26 lines modified
185 ····*·string·-·A·pointer·to·a·buffer·of·at·least·8·bytes,·into·which·the·result202 ····*·string·-·A·pointer·to·a·buffer·of·at·least·8·bytes,·into·which·the·result
186 ······will·be·written·(including·the·NUL·terminator).203 ······will·be·written·(including·the·NUL·terminator).
187 Example:204 Example:
188 char·html[8];205 char·html[8];
189 al_color_rgb_to_html(1,·0,·0,·html);206 al_color_rgb_to_html(1,·0,·0,·html);
190 Now·html·will·contain·“#ff0000”.207 Now·html·will·contain·“#ff0000”.
191 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8t_\x8m_\x8l,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8t_\x8m_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b208 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8t_\x8m_\x8l,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8t_\x8m_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b
 209 Examples:
 210 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
192 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*211 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
193 ALLEGRO_COLOR·al_color_name(char·const·*name)212 ALLEGRO_COLOR·al_color_name(char·const·*name)
194 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e213 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
195 Return·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R·with·the·given·name.·If·the·color·is·not·found·then214 Return·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R·with·the·given·name.·If·the·color·is·not·found·then
196 black·is·returned.215 black·is·returned.
197 See·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8n_\x8a_\x8m_\x8e_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b·for·the·list·of·names.216 See·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8n_\x8a_\x8m_\x8e_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b·for·the·list·of·names.
 217 Examples:
 218 ····*·_\x8e_\x8x_\x8__\x8d_\x8r_\x8a_\x8g_\x8__\x8a_\x8n_\x8d_\x8__\x8d_\x8r_\x8o_\x8p_\x8._\x8c
 219 ····*·_\x8e_\x8x_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8s_\x8a_\x8m_\x8p_\x8l_\x8e_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 220 ····*·_\x8e_\x8x_\x8__\x8c_\x8l_\x8i_\x8p_\x8._\x8c
198 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_n\x8na\x8am\x8me\x8e_\x8_t\x8to\x8o_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8**\x8*221 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_n\x8na\x8am\x8me\x8e_\x8_t\x8to\x8o_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8**\x8*
199 bool·al_color_name_to_rgb(char·const·*name,·float·*r,·float·*g,·float·*b)222 bool·al_color_name_to_rgb(char·const·*name,·float·*r,·float·*g,·float·*b)
200 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e223 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
201 Parameters:224 Parameters:
202 ····*·name·-·The·(lowercase)·name·of·the·color.225 ····*·name·-·The·(lowercase)·name·of·the·color.
203 ····*·r,·g,·b·-·If·one·of·the·recognized·color·names·below·is·passed,·the226 ····*·r,·g,·b·-·If·one·of·the·recognized·color·names·below·is·passed,·the
204 ······corresponding·RGB·values·in·the·range·0..1·are·written.227 ······corresponding·RGB·values·in·the·range·0..1·are·written.
Offset 243, 34 lines modifiedOffset 266, 44 lines modified
243 C·=·1·-·R266 C·=·1·-·R
244 M·=·1·-·G267 M·=·1·-·G
245 Y·=·1·-·B268 Y·=·1·-·B
246 K·=·0269 K·=·0
247 This·function·will·instead·find·the·representation·with·the·maximal·value·for·K270 This·function·will·instead·find·the·representation·with·the·maximal·value·for·K
248 and·minimal·color·components.271 and·minimal·color·components.
249 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8c_\x8m_\x8y_\x8k,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8c_\x8m_\x8y_\x8k_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b272 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8c_\x8m_\x8y_\x8k,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8c_\x8m_\x8y_\x8k_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b
 273 Examples:
 274 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
250 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_r\x8rg\x8gb\x8b_\x8_t\x8to\x8o_\x8_h\x8hs\x8sl\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*275 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_r\x8rg\x8gb\x8b_\x8_t\x8to\x8o_\x8_h\x8hs\x8sl\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*
251 void·al_color_rgb_to_hsl(float·red,·float·green,·float·blue,276 void·al_color_rgb_to_hsl(float·red,·float·green,·float·blue,
252 ···float·*hue,·float·*saturation,·float·*lightness)277 ···float·*hue,·float·*saturation,·float·*lightness)
253 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e278 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
254 Given·an·RGB·triplet·with·components·in·the·range·0..1,·return·the·hue·in279 Given·an·RGB·triplet·with·components·in·the·range·0..1,·return·the·hue·in
255 degrees·from·0..360·and·saturation·and·lightness·in·the·range·0..1.280 degrees·from·0..360·and·saturation·and·lightness·in·the·range·0..1.
256 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l281 See·also:·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l_\x8__\x8t_\x8o_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8h_\x8s_\x8l
 282 Examples:
 283 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8._\x8c_\x8p_\x8p
 284 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8l_\x8e_\x8t_\x8t_\x8e_\x8._\x8c
257 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_r\x8rg\x8gb\x8b_\x8_t\x8to\x8o_\x8_h\x8hs\x8sv\x8v·*\x8**\x8**\x8**\x8**\x8**\x8*285 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8ol\x8lo\x8or\x8r_\x8_r\x8rg\x8gb\x8b_\x8_t\x8to\x8o_\x8_h\x8hs\x8sv\x8v·*\x8**\x8**\x8**\x8**\x8**\x8*
258 void·al_color_rgb_to_hsv(float·red,·float·green,·float·blue,286 void·al_color_rgb_to_hsv(float·red,·float·green,·float·blue,
259 ···float·*hue,·float·*saturation,·float·*value)287 ···float·*hue,·float·*saturation,·float·*value)
Max diff block lines reached; 11297/18251 bytes (61.90%) of diff not shown.
15.4 KB
./usr/share/doc/allegro5-doc/refman/config.html
    
Offset 258, 36 lines modifiedOffset 258, 55 lines modified
258 <span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"·tabindex="-1"></a>al_destroy_config<span·class="op">(</span>cfg<span·class="op">);</span></span></code></pre></div>258 <span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"·tabindex="-1"></a>al_destroy_config<span·class="op">(</span>cfg<span·class="op">);</span></span></code></pre></div>
259 <h1·id="allegro_config">ALLEGRO_CONFIG</h1>259 <h1·id="allegro_config">ALLEGRO_CONFIG</h1>
260 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG·ALLEGRO_CONFIG<span·class="op">;</span></span></code></pre></div>260 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG·ALLEGRO_CONFIG<span·class="op">;</span></span></code></pre></div>
261 <p><a261 <p><a
262 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L12">Source262 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L12">Source
263 Code</a></p>263 Code</a></p>
264 <p>An·abstract·configuration·structure.</p>264 <p>An·abstract·configuration·structure.</p>
 265 <p>Examples:</p>
 266 <ul>
 267 <li><a
 268 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L26">ex_config.c</a></li>
 269 <li><a
 270 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_vsync.c#L14">ex_vsync.c</a></li>
 271 <li><a
 272 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_seek.c#L239">ex_stream_seek.c</a></li>
 273 </ul>
265 <h1·id="allegro_config_section">ALLEGRO_CONFIG_SECTION</h1>274 <h1·id="allegro_config_section">ALLEGRO_CONFIG_SECTION</h1>
266 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION<span·class="op">;</span></span></code></pre></div>275 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION<span·class="op">;</span></span></code></pre></div>
267 <p><a276 <p><a
268 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L16">Source277 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L16">Source
269 Code</a></p>278 Code</a></p>
270 <p>An·opaque·structure·used·for·iterating·across·sections·in·a279 <p>An·opaque·structure·used·for·iterating·across·sections·in·a
271 configuration·structure.</p>280 configuration·structure.</p>
272 <p>See·also:·<a281 <p>See·also:·<a
273 href="config.html#al_get_first_config_section">al_get_first_config_section</a>,282 href="config.html#al_get_first_config_section">al_get_first_config_section</a>,
274 <a283 <a
275 href="config.html#al_get_next_config_section">al_get_next_config_section</a></p>284 href="config.html#al_get_next_config_section">al_get_next_config_section</a></p>
 285 <p>Examples:</p>
 286 <ul>
 287 <li><a
 288 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L28">ex_config.c</a></li>
 289 </ul>
276 <h1·id="allegro_config_entry">ALLEGRO_CONFIG_ENTRY</h1>290 <h1·id="allegro_config_entry">ALLEGRO_CONFIG_ENTRY</h1>
277 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY<span·class="op">;</span></span></code></pre></div>291 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY<span·class="op">;</span></span></code></pre></div>
278 <p><a292 <p><a
279 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L20">Source293 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L20">Source
280 Code</a></p>294 Code</a></p>
281 <p>An·opaque·structure·used·for·iterating·across·entries·in·a295 <p>An·opaque·structure·used·for·iterating·across·entries·in·a
282 configuration·section.</p>296 configuration·section.</p>
283 <p>See·also:·<a297 <p>See·also:·<a
284 href="config.html#al_get_first_config_entry">al_get_first_config_entry</a>,298 href="config.html#al_get_first_config_entry">al_get_first_config_entry</a>,
285 <a299 <a
286 href="config.html#al_get_next_config_entry">al_get_next_config_entry</a></p>300 href="config.html#al_get_next_config_entry">al_get_next_config_entry</a></p>
 301 <p>Examples:</p>
 302 <ul>
 303 <li><a
 304 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L29">ex_config.c</a></li>
 305 </ul>
287 <h1·id="al_create_config">al_create_config</h1>306 <h1·id="al_create_config">al_create_config</h1>
288 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_CONFIG·<span·class="op">*</span>al_create_config<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>307 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_CONFIG·<span·class="op">*</span>al_create_config<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
289 <p><a308 <p><a
290 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L37">Source309 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L37">Source
291 Code</a></p>310 Code</a></p>
292 <p>Create·an·empty·configuration·structure.</p>311 <p>Create·an·empty·configuration·structure.</p>
293 <p>See·also:·<a312 <p>See·also:·<a
Offset 313, 17 lines modifiedOffset 332, 17 lines modified
313 href="config.html#al_create_config">al_create_config</a>,·<a332 href="config.html#al_create_config">al_create_config</a>,·<a
314 href="config.html#al_load_config_file">al_load_config_file</a></p>333 href="config.html#al_load_config_file">al_load_config_file</a></p>
315 <p>Examples:</p>334 <p>Examples:</p>
316 <ul>335 <ul>
317 <li><a336 <li><a
318 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L112">ex_config.c</a></li>337 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L112">ex_config.c</a></li>
319 <li><a338 <li><a
320 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_seek.c#L273">ex_stream_seek.c</a></li>339 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_vsync.c#L122">ex_vsync.c</a></li>
321 <li><a340 <li><a
322 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_ttf.c#L354">ex_ttf.c</a></li>341 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_seek.c#L273">ex_stream_seek.c</a></li>
323 </ul>342 </ul>
324 <h1·id="al_load_config_file">al_load_config_file</h1>343 <h1·id="al_load_config_file">al_load_config_file</h1>
325 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_CONFIG·<span·class="op">*</span>al_load_config_file<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>filename<span·class="op">)</span></span></code></pre></div>344 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_CONFIG·<span·class="op">*</span>al_load_config_file<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>filename<span·class="op">)</span></span></code></pre></div>
326 <p><a345 <p><a
327 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L311">Source346 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L311">Source
328 Code</a></p>347 Code</a></p>
329 <p>Read·a·configuration·file·from·disk.·Returns·NULL·on·error.·The348 <p>Read·a·configuration·file·from·disk.·Returns·NULL·on·error.·The
Offset 333, 17 lines modifiedOffset 352, 17 lines modified
333 href="config.html#al_load_config_file_f">al_load_config_file_f</a>,·<a352 href="config.html#al_load_config_file_f">al_load_config_file_f</a>,·<a
334 href="config.html#al_save_config_file">al_save_config_file</a></p>353 href="config.html#al_save_config_file">al_save_config_file</a></p>
335 <p>Examples:</p>354 <p>Examples:</p>
336 <ul>355 <ul>
337 <li><a356 <li><a
338 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L39">ex_config.c</a></li>357 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L39">ex_config.c</a></li>
339 <li><a358 <li><a
340 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_seek.c#L254">ex_stream_seek.c</a></li>359 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_vsync.c#L102">ex_vsync.c</a></li>
341 <li><a360 <li><a
342 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_ttf.c#L309">ex_ttf.c</a></li>361 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_seek.c#L254">ex_stream_seek.c</a></li>
343 </ul>362 </ul>
344 <h1·id="al_load_config_file_f">al_load_config_file_f</h1>363 <h1·id="al_load_config_file_f">al_load_config_file_f</h1>
345 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_CONFIG·<span·class="op">*</span>al_load_config_file_f<span·class="op">(</span>ALLEGRO_FILE·<span·class="op">*</span>file<span·class="op">)</span></span></code></pre></div>364 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_CONFIG·<span·class="op">*</span>al_load_config_file_f<span·class="op">(</span>ALLEGRO_FILE·<span·class="op">*</span>file<span·class="op">)</span></span></code></pre></div>
346 <p><a365 <p><a
347 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L328">Source366 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L328">Source
348 Code</a></p>367 Code</a></p>
349 <p>Read·a·configuration·file·from·an·already·open·file.</p>368 <p>Read·a·configuration·file·from·an·already·open·file.</p>
Offset 429, 17 lines modifiedOffset 448, 17 lines modified
429 <p>See·also:·<a448 <p>See·also:·<a
430 href="config.html#al_set_config_value">al_set_config_value</a></p>449 href="config.html#al_set_config_value">al_set_config_value</a></p>
431 <p>Examples:</p>450 <p>Examples:</p>
432 <ul>451 <ul>
433 <li><a452 <li><a
434 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L44">ex_config.c</a></li>453 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L44">ex_config.c</a></li>
435 <li><a454 <li><a
436 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_seek.c#L256">ex_stream_seek.c</a></li>455 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_vsync.c#L18">ex_vsync.c</a></li>
437 <li><a456 <li><a
438 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_ttf.c#L41">ex_ttf.c</a></li>457 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_seek.c#L256">ex_stream_seek.c</a></li>
439 </ul>458 </ul>
440 <h1·id="al_set_config_value">al_set_config_value</h1>459 <h1·id="al_set_config_value">al_set_config_value</h1>
441 <div·class="sourceCode"·id="cb17"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb17-1"><a·href="#cb17-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_config_value<span·class="op">(</span>ALLEGRO_CONFIG·<span·class="op">*</span>config<span·class="op">,</span></span>460 <div·class="sourceCode"·id="cb17"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb17-1"><a·href="#cb17-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_config_value<span·class="op">(</span>ALLEGRO_CONFIG·<span·class="op">*</span>config<span·class="op">,</span></span>
442 <span·id="cb17-2"><a·href="#cb17-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>section<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>key<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>value<span·class="op">)</span></span></code></pre></div>461 <span·id="cb17-2"><a·href="#cb17-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>section<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>key<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>value<span·class="op">)</span></span></code></pre></div>
443 <p><a462 <p><a
444 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L164">Source463 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L164">Source
445 Code</a></p>464 Code</a></p>
Offset 454, 17 lines modifiedOffset 473, 17 lines modified
454 <p>See·also:·<a473 <p>See·also:·<a
455 href="config.html#al_get_config_value">al_get_config_value</a></p>474 href="config.html#al_get_config_value">al_get_config_value</a></p>
456 <p>Examples:</p>475 <p>Examples:</p>
457 <ul>476 <ul>
458 <li><a477 <li><a
459 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L54">ex_config.c</a></li>478 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_config.c#L54">ex_config.c</a></li>
460 <li><a479 <li><a
461 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_vsync.c#L22">ex_vsync.c</a></li>480 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_resize2.c#L35">ex_resize2.c</a></li>
462 <li><a481 <li><a
463 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_camera.c#L493">ex_camera.c</a></li>482 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_vsync.c#L22">ex_vsync.c</a></li>
464 </ul>483 </ul>
465 <h1·id="al_remove_config_key">al_remove_config_key</h1>484 <h1·id="al_remove_config_key">al_remove_config_key</h1>
466 <div·class="sourceCode"·id="cb18"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb18-1"><a·href="#cb18-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_remove_config_key<span·class="op">(</span>ALLEGRO_CONFIG·<span·class="op">*</span>config<span·class="op">,</span>·<span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>section<span·class="op">,</span></span>485 <div·class="sourceCode"·id="cb18"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb18-1"><a·href="#cb18-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_remove_config_key<span·class="op">(</span>ALLEGRO_CONFIG·<span·class="op">*</span>config<span·class="op">,</span>·<span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>section<span·class="op">,</span></span>
467 <span·id="cb18-2"><a·href="#cb18-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>key<span·class="op">)</span></span></code></pre></div>486 <span·id="cb18-2"><a·href="#cb18-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>key<span·class="op">)</span></span></code></pre></div>
468 <p><a487 <p><a
469 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L700">Source488 href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L700">Source
470 Code</a></p>489 Code</a></p>
Max diff block lines reached; 472/9667 bytes (4.88%) of diff not shown.
5.84 KB
html2text {}
    
Offset 103, 26 lines modifiedOffset 103, 34 lines modified
103 printf("%s\n",·al_get_config_value(cfg,·"weapon·1",·"damage"));·/*·Prints:·503103 printf("%s\n",·al_get_config_value(cfg,·"weapon·1",·"damage"));·/*·Prints:·503
104 */104 */
105 al_destroy_config(cfg);105 al_destroy_config(cfg);
106 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8ON\x8NF\x8FI\x8IG\x8G·*\x8**\x8**\x8**\x8**\x8**\x8*106 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8ON\x8NF\x8FI\x8IG\x8G·*\x8**\x8**\x8**\x8**\x8**\x8*
107 typedef·struct·ALLEGRO_CONFIG·ALLEGRO_CONFIG;107 typedef·struct·ALLEGRO_CONFIG·ALLEGRO_CONFIG;
108 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e108 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
109 An·abstract·configuration·structure.109 An·abstract·configuration·structure.
 110 Examples:
 111 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c
 112 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c
 113 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8s_\x8e_\x8e_\x8k_\x8._\x8c
110 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8ON\x8NF\x8FI\x8IG\x8G_\x8_S\x8SE\x8EC\x8CT\x8TI\x8IO\x8ON\x8N·*\x8**\x8**\x8**\x8**\x8**\x8*114 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8ON\x8NF\x8FI\x8IG\x8G_\x8_S\x8SE\x8EC\x8CT\x8TI\x8IO\x8ON\x8N·*\x8**\x8**\x8**\x8**\x8**\x8*
111 typedef·struct·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION;115 typedef·struct·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION;
112 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e116 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
113 An·opaque·structure·used·for·iterating·across·sections·in·a·configuration117 An·opaque·structure·used·for·iterating·across·sections·in·a·configuration
114 structure.118 structure.
115 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8i_\x8r_\x8s_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8s_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8e_\x8x_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8s_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n119 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8i_\x8r_\x8s_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8s_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8e_\x8x_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8s_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n
 120 Examples:
 121 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c
116 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8ON\x8NF\x8FI\x8IG\x8G_\x8_E\x8EN\x8NT\x8TR\x8RY\x8Y·*\x8**\x8**\x8**\x8**\x8**\x8*122 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8ON\x8NF\x8FI\x8IG\x8G_\x8_E\x8EN\x8NT\x8TR\x8RY\x8Y·*\x8**\x8**\x8**\x8**\x8**\x8*
117 typedef·struct·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY;123 typedef·struct·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY;
118 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e124 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
119 An·opaque·structure·used·for·iterating·across·entries·in·a·configuration125 An·opaque·structure·used·for·iterating·across·entries·in·a·configuration
120 section.126 section.
121 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8i_\x8r_\x8s_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8e_\x8n_\x8t_\x8r_\x8y,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8e_\x8x_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8e_\x8n_\x8t_\x8r_\x8y127 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8i_\x8r_\x8s_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8e_\x8n_\x8t_\x8r_\x8y,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8e_\x8x_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8e_\x8n_\x8t_\x8r_\x8y
 128 Examples:
 129 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c
122 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*130 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*
123 ALLEGRO_CONFIG·*al_create_config(void)131 ALLEGRO_CONFIG·*al_create_config(void)
124 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e132 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
125 Create·an·empty·configuration·structure.133 Create·an·empty·configuration·structure.
126 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g134 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g
127 Examples:135 Examples:
128 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c136 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c
Offset 132, 26 lines modifiedOffset 140, 26 lines modified
132 void·al_destroy_config(ALLEGRO_CONFIG·*config)140 void·al_destroy_config(ALLEGRO_CONFIG·*config)
133 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e141 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
134 Free·the·resources·used·by·a·configuration·structure.·Does·nothing·if·passed142 Free·the·resources·used·by·a·configuration·structure.·Does·nothing·if·passed
135 NULL.143 NULL.
136 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e144 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e
137 Examples:145 Examples:
138 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c146 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c
 147 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c
139 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8s_\x8e_\x8e_\x8k_\x8._\x8c148 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8s_\x8e_\x8e_\x8k_\x8._\x8c
140 ····*·_\x8e_\x8x_\x8__\x8t_\x8t_\x8f_\x8._\x8c 
141 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_l\x8lo\x8oa\x8ad\x8d_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_f\x8fi\x8il\x8le\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*149 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_l\x8lo\x8oa\x8ad\x8d_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_f\x8fi\x8il\x8le\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
142 ALLEGRO_CONFIG·*al_load_config_file(const·char·*filename)150 ALLEGRO_CONFIG·*al_load_config_file(const·char·*filename)
143 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e151 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
144 Read·a·configuration·file·from·disk.·Returns·NULL·on·error.·The·configuration152 Read·a·configuration·file·from·disk.·Returns·NULL·on·error.·The·configuration
145 structure·should·be·destroyed·with·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g.153 structure·should·be·destroyed·with·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g.
146 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8f,·_\x8a_\x8l_\x8__\x8s_\x8a_\x8v_\x8e_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e154 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8f,·_\x8a_\x8l_\x8__\x8s_\x8a_\x8v_\x8e_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e
147 Examples:155 Examples:
148 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c156 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c
 157 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c
149 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8s_\x8e_\x8e_\x8k_\x8._\x8c158 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8s_\x8e_\x8e_\x8k_\x8._\x8c
150 ····*·_\x8e_\x8x_\x8__\x8t_\x8t_\x8f_\x8._\x8c 
151 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_l\x8lo\x8oa\x8ad\x8d_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_f\x8fi\x8il\x8le\x8e_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8**\x8*159 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_l\x8lo\x8oa\x8ad\x8d_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_f\x8fi\x8il\x8le\x8e_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8**\x8*
152 ALLEGRO_CONFIG·*al_load_config_file_f(ALLEGRO_FILE·*file)160 ALLEGRO_CONFIG·*al_load_config_file_f(ALLEGRO_FILE·*file)
153 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e161 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
154 Read·a·configuration·file·from·an·already·open·file.162 Read·a·configuration·file·from·an·already·open·file.
155 Returns·NULL·on·error.·The·configuration·structure·should·be·destroyed·with163 Returns·NULL·on·error.·The·configuration·structure·should·be·destroyed·with
156 _\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g.·The·file·remains·open·afterwards.164 _\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g.·The·file·remains·open·afterwards.
157 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e165 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8f_\x8i_\x8l_\x8e
Offset 201, 32 lines modifiedOffset 209, 32 lines modified
201 Gets·a·pointer·to·an·internal·character·buffer·that·will·only·remain·valid·as209 Gets·a·pointer·to·an·internal·character·buffer·that·will·only·remain·valid·as
202 long·as·the·ALLEGRO_CONFIG·structure·is·not·destroyed.·Copy·the·value·if·you210 long·as·the·ALLEGRO_CONFIG·structure·is·not·destroyed.·Copy·the·value·if·you
203 need·a·copy.·The·section·can·be·NULL·or·“”·for·the·global·section.·Returns·NULL211 need·a·copy.·The·section·can·be·NULL·or·“”·for·the·global·section.·Returns·NULL
204 if·the·section·or·key·do·not·exist.212 if·the·section·or·key·do·not·exist.
205 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8v_\x8a_\x8l_\x8u_\x8e213 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8v_\x8a_\x8l_\x8u_\x8e
206 Examples:214 Examples:
207 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c215 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c
 216 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c
208 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8s_\x8e_\x8e_\x8k_\x8._\x8c217 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8s_\x8e_\x8e_\x8k_\x8._\x8c
209 ····*·_\x8e_\x8x_\x8__\x8t_\x8t_\x8f_\x8._\x8c 
210 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_v\x8va\x8al\x8lu\x8ue\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*218 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_v\x8va\x8al\x8lu\x8ue\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
211 void·al_set_config_value(ALLEGRO_CONFIG·*config,219 void·al_set_config_value(ALLEGRO_CONFIG·*config,
212 ···const·char·*section,·const·char·*key,·const·char·*value)220 ···const·char·*section,·const·char·*key,·const·char·*value)
213 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e221 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
214 Set·a·value·in·a·section·of·a·configuration.·If·the·section·doesn’t·yet·exist,222 Set·a·value·in·a·section·of·a·configuration.·If·the·section·doesn’t·yet·exist,
215 it·will·be·created.·If·a·value·already·existed·for·the·given·key,·it·will·be223 it·will·be·created.·If·a·value·already·existed·for·the·given·key,·it·will·be
216 overwritten.·The·section·can·be·NULL·or·“”·for·the·global·section.224 overwritten.·The·section·can·be·NULL·or·“”·for·the·global·section.
217 For·consistency·with·the·on-disk·format·of·config·files,·any·leading·and225 For·consistency·with·the·on-disk·format·of·config·files,·any·leading·and
218 trailing·whitespace·will·be·stripped·from·the·value.·If·you·have·significant226 trailing·whitespace·will·be·stripped·from·the·value.·If·you·have·significant
219 whitespace·you·wish·to·preserve,·you·should·add·your·own·quote·characters·and227 whitespace·you·wish·to·preserve,·you·should·add·your·own·quote·characters·and
220 remove·them·when·reading·the·values·back·in.228 remove·them·when·reading·the·values·back·in.
221 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8v_\x8a_\x8l_\x8u_\x8e229 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8__\x8v_\x8a_\x8l_\x8u_\x8e
222 Examples:230 Examples:
223 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c231 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8._\x8c
 232 ····*·_\x8e_\x8x_\x8__\x8r_\x8e_\x8s_\x8i_\x8z_\x8e_\x82_\x8._\x8c
224 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c233 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c
225 ····*·_\x8e_\x8x_\x8__\x8c_\x8a_\x8m_\x8e_\x8r_\x8a_\x8._\x8c 
226 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8em\x8mo\x8ov\x8ve\x8e_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_k\x8ke\x8ey\x8y·*\x8**\x8**\x8**\x8**\x8**\x8*234 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8em\x8mo\x8ov\x8ve\x8e_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_k\x8ke\x8ey\x8y·*\x8**\x8**\x8**\x8**\x8**\x8*
227 bool·al_remove_config_key(ALLEGRO_CONFIG·*config,·char·const·*section,235 bool·al_remove_config_key(ALLEGRO_CONFIG·*config,·char·const·*section,
228 ···char·const·*key)236 ···char·const·*key)
229 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e237 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
230 Remove·a·key·and·its·associated·value·in·a·section·of·a·configuration.238 Remove·a·key·and·its·associated·value·in·a·section·of·a·configuration.
231 Returns·true·if·the·entry·was·removed,·or·false·if·the·entry·did·not·exist.239 Returns·true·if·the·entry·was·removed,·or·false·if·the·entry·did·not·exist.
232 Since:·5.1.5240 Since:·5.1.5
Offset 285, 8 lines modifiedOffset 293, 7 lines modified
285 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8me\x8er\x8rg\x8ge\x8e_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_i\x8in\x8nt\x8to\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*293 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8me\x8er\x8rg\x8ge\x8e_\x8_c\x8co\x8on\x8nf\x8fi\x8ig\x8g_\x8_i\x8in\x8nt\x8to\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*
286 void·al_merge_config_into(ALLEGRO_CONFIG·*master,·const·ALLEGRO_CONFIG·*add)294 void·al_merge_config_into(ALLEGRO_CONFIG·*master,·const·ALLEGRO_CONFIG·*add)
287 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e295 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
288 Merge·one·configuration·structure·into·another.·Values·in·configuration·‘add’296 Merge·one·configuration·structure·into·another.·Values·in·configuration·‘add’
289 override·those·in·‘master’.·‘master’·is·modified.·Comments·from·‘add’·are·not297 override·those·in·‘master’.·‘master’·is·modified.·Comments·from·‘add’·are·not
290 retained.298 retained.
291 See·also:·_\x8a_\x8l_\x8__\x8m_\x8e_\x8r_\x8g_\x8e_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g299 See·also:·_\x8a_\x8l_\x8__\x8m_\x8e_\x8r_\x8g_\x8e_\x8__\x8c_\x8o_\x8n_\x8f_\x8i_\x8g
292 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC 
2.52 KB
./usr/share/doc/allegro5-doc/refman/direct3d.html
    
Offset 201, 14 lines modifiedOffset 201, 19 lines modified
201 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a>LPDIRECT3DDEVICE9·al_get_d3d_device<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">)</span></span></code></pre></div>201 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a>LPDIRECT3DDEVICE9·al_get_d3d_device<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">)</span></span></code></pre></div>
202 <p><a202 <p><a
203 href="https://github.com/liballeg/allegro5/blob/master/src/win/d3d_disp.cpp#L2570">Source203 href="https://github.com/liballeg/allegro5/blob/master/src/win/d3d_disp.cpp#L2570">Source
204 Code</a></p>204 Code</a></p>
205 <p>Returns·the·Direct3D·device·of·the·display.·The·return·value·is205 <p>Returns·the·Direct3D·device·of·the·display.·The·return·value·is
206 undefined·if·the·display·was·not·created·with·the·Direct3D·flag.</p>206 undefined·if·the·display·was·not·created·with·the·Direct3D·flag.</p>
207 <p><em>Returns:</em>·A·pointer·to·the·Direct3D·device.</p>207 <p><em>Returns:</em>·A·pointer·to·the·Direct3D·device.</p>
 208 <p>Examples:</p>
 209 <ul>
 210 <li><a
 211 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L44">ex_d3d.cpp</a></li>
 212 </ul>
208 <h1·id="al_get_d3d_system_texture">al_get_d3d_system_texture</h1>213 <h1·id="al_get_d3d_system_texture">al_get_d3d_system_texture</h1>
209 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a>LPDIRECT3DTEXTURE9·al_get_d3d_system_texture<span·class="op">(</span>ALLEGRO_BITMAP·<span·class="op">*</span>bitmap<span·class="op">)</span></span></code></pre></div>214 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a>LPDIRECT3DTEXTURE9·al_get_d3d_system_texture<span·class="op">(</span>ALLEGRO_BITMAP·<span·class="op">*</span>bitmap<span·class="op">)</span></span></code></pre></div>
210 <p><a215 <p><a
211 href="https://github.com/liballeg/allegro5/blob/master/src/win/d3d_disp.cpp#L2578">Source216 href="https://github.com/liballeg/allegro5/blob/master/src/win/d3d_disp.cpp#L2578">Source
212 Code</a></p>217 Code</a></p>
213 <p>Returns·the·system·texture·(stored·with·the·D3DPOOL_SYSTEMMEM·flags).218 <p>Returns·the·system·texture·(stored·with·the·D3DPOOL_SYSTEMMEM·flags).
214 This·texture·is·used·for·the·render-to-texture·feature·set.</p>219 This·texture·is·used·for·the·render-to-texture·feature·set.</p>
1.02 KB
html2text {}
    
Offset 57, 14 lines modifiedOffset 57, 16 lines modified
57 ·#include·<allegro5/allegro_direct3d.h>57 ·#include·<allegro5/allegro_direct3d.h>
58 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_d\x8d3\x83d\x8d_\x8_d\x8de\x8ev\x8vi\x8ic\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*58 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_d\x8d3\x83d\x8d_\x8_d\x8de\x8ev\x8vi\x8ic\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
59 LPDIRECT3DDEVICE9·al_get_d3d_device(ALLEGRO_DISPLAY·*display)59 LPDIRECT3DDEVICE9·al_get_d3d_device(ALLEGRO_DISPLAY·*display)
60 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e60 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
61 Returns·the·Direct3D·device·of·the·display.·The·return·value·is·undefined·if61 Returns·the·Direct3D·device·of·the·display.·The·return·value·is·undefined·if
62 the·display·was·not·created·with·the·Direct3D·flag.62 the·display·was·not·created·with·the·Direct3D·flag.
63 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·A·pointer·to·the·Direct3D·device.63 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·A·pointer·to·the·Direct3D·device.
 64 Examples:
 65 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
64 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_d\x8d3\x83d\x8d_\x8_s\x8sy\x8ys\x8st\x8te\x8em\x8m_\x8_t\x8te\x8ex\x8xt\x8tu\x8ur\x8re\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*66 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_d\x8d3\x83d\x8d_\x8_s\x8sy\x8ys\x8st\x8te\x8em\x8m_\x8_t\x8te\x8ex\x8xt\x8tu\x8ur\x8re\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
65 LPDIRECT3DTEXTURE9·al_get_d3d_system_texture(ALLEGRO_BITMAP·*bitmap)67 LPDIRECT3DTEXTURE9·al_get_d3d_system_texture(ALLEGRO_BITMAP·*bitmap)
66 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e68 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
67 Returns·the·system·texture·(stored·with·the·D3DPOOL_SYSTEMMEM·flags).·This69 Returns·the·system·texture·(stored·with·the·D3DPOOL_SYSTEMMEM·flags).·This
68 texture·is·used·for·the·render-to-texture·feature·set.70 texture·is·used·for·the·render-to-texture·feature·set.
69 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·A·pointer·to·the·Direct3D·system·texture.71 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·A·pointer·to·the·Direct3D·system·texture.
70 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_d\x8d3\x83d\x8d_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_t\x8te\x8ex\x8xt\x8tu\x8ur\x8re\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*72 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_d\x8d3\x83d\x8d_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_t\x8te\x8ex\x8xt\x8tu\x8ur\x8re\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
57.2 KB
./usr/share/doc/allegro5-doc/refman/display.html
    
Offset 345, 14 lines modifiedOffset 345, 23 lines modified
345 <h1·id="display-creation">Display·creation</h1>345 <h1·id="display-creation">Display·creation</h1>
346 <h2·id="allegro_display">ALLEGRO_DISPLAY</h2>346 <h2·id="allegro_display">ALLEGRO_DISPLAY</h2>
347 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY<span·class="op">;</span></span></code></pre></div>347 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY<span·class="op">;</span></span></code></pre></div>
348 <p><a348 <p><a
349 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/display.h#L113">Source349 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/display.h#L113">Source
350 Code</a></p>350 Code</a></p>
351 <p>An·opaque·type·representing·an·open·display·or·window.</p>351 <p>An·opaque·type·representing·an·open·display·or·window.</p>
 352 <p>Examples:</p>
 353 <ul>
 354 <li><a
 355 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L33">ex_monitorinfo.c</a></li>
 356 <li><a
 357 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L24">ex_d3d.cpp</a></li>
 358 <li><a
 359 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L12">ex_keyboard_focus.c</a></li>
 360 </ul>
352 <h2·id="al_create_display">al_create_display</h2>361 <h2·id="al_create_display">al_create_display</h2>
353 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_DISPLAY·<span·class="op">*</span>al_create_display<span·class="op">(</span><span·class="dt">int</span>·w<span·class="op">,</span>·<span·class="dt">int</span>·h<span·class="op">)</span></span></code></pre></div>362 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_DISPLAY·<span·class="op">*</span>al_create_display<span·class="op">(</span><span·class="dt">int</span>·w<span·class="op">,</span>·<span·class="dt">int</span>·h<span·class="op">)</span></span></code></pre></div>
354 <p><a363 <p><a
355 href="https://github.com/liballeg/allegro5/blob/master/src/display.c#L38">Source364 href="https://github.com/liballeg/allegro5/blob/master/src/display.c#L38">Source
356 Code</a></p>365 Code</a></p>
357 <p>Create·a·display,·or·window,·with·the·specified·dimensions.·The366 <p>Create·a·display,·or·window,·with·the·specified·dimensions.·The
358 parameters·of·the·display·are·determined·by·the·last·calls·to367 parameters·of·the·display·are·determined·by·the·last·calls·to
Offset 375, 19 lines modifiedOffset 384, 19 lines modified
375 <a384 <a
376 href="display.html#al_set_new_window_title">al_set_new_window_title</a>385 href="display.html#al_set_new_window_title">al_set_new_window_title</a>
377 <a386 <a
378 href="display.html#al_set_window_position">al_set_window_position</a></p>387 href="display.html#al_set_window_position">al_set_window_position</a></p>
379 <p>Examples:</p>388 <p>Examples:</p>
380 <ul>389 <ul>
381 <li><a390 <li><a
382 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_props.cpp#L177">ex_audio_props.cpp</a></li>391 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L37">ex_d3d.cpp</a></li>
383 <li><a392 <li><a
384 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L43">ex_keyboard_focus.c</a></li>393 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L43">ex_keyboard_focus.c</a></li>
385 <li><a394 <li><a
386 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L37">ex_d3d.cpp</a></li>395 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L48">ex_mouse_focus.c</a></li>
387 </ul>396 </ul>
388 <h2·id="al_destroy_display">al_destroy_display</h2>397 <h2·id="al_destroy_display">al_destroy_display</h2>
389 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_display<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">)</span></span></code></pre></div>398 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_display<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">)</span></span></code></pre></div>
390 <p><a399 <p><a
391 href="https://github.com/liballeg/allegro5/blob/master/src/display.c#L142">Source400 href="https://github.com/liballeg/allegro5/blob/master/src/display.c#L142">Source
392 Code</a></p>401 Code</a></p>
393 <p>Destroy·a·display.</p>402 <p>Destroy·a·display.</p>
Offset 402, 15 lines modifiedOffset 411, 15 lines modified
402 <p>Examples:</p>411 <p>Examples:</p>
403 <ul>412 <ul>
404 <li><a413 <li><a
405 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L115">ex_d3d.cpp</a></li>414 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L115">ex_d3d.cpp</a></li>
406 <li><a415 <li><a
407 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L51">ex_mouse_focus.c</a></li>416 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L51">ex_mouse_focus.c</a></li>
408 <li><a417 <li><a
409 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_simple.c#L249">ex_audio_simple.c</a></li>418 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl.c#L173">ex_opengl.c</a></li>
410 </ul>419 </ul>
411 <h2·id="al_get_new_display_flags">al_get_new_display_flags</h2>420 <h2·id="al_get_new_display_flags">al_get_new_display_flags</h2>
412 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_new_display_flags<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>421 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_new_display_flags<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
413 <p><a422 <p><a
414 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L253">Source423 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L253">Source
415 Code</a></p>424 Code</a></p>
416 <p>Get·the·display·flags·to·be·used·when·creating·new·displays·on·the425 <p>Get·the·display·flags·to·be·used·when·creating·new·displays·on·the
Offset 564, 14 lines modifiedOffset 573, 23 lines modified
564 </dl>573 </dl>
565 <p>0·can·be·used·for·default·values.</p>574 <p>0·can·be·used·for·default·values.</p>
566 <p>See·also:·<a575 <p>See·also:·<a
567 href="display.html#al_set_new_display_option">al_set_new_display_option</a>,576 href="display.html#al_set_new_display_option">al_set_new_display_option</a>,
568 <a·href="display.html#al_get_display_option">al_get_display_option</a>,577 <a·href="display.html#al_get_display_option">al_get_display_option</a>,
569 <a578 <a
570 href="display.html#al_set_display_option">al_set_display_option</a></p>579 href="display.html#al_set_display_option">al_set_display_option</a></p>
 580 <p>Examples:</p>
 581 <ul>
 582 <li><a
 583 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L35">ex_d3d.cpp</a></li>
 584 <li><a
 585 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl.c#L138">ex_opengl.c</a></li>
 586 <li><a
 587 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl_pixel_shader.c#L55">ex_opengl_pixel_shader.c</a></li>
 588 </ul>
571 <h2·id="al_get_new_display_option">al_get_new_display_option</h2>589 <h2·id="al_get_new_display_option">al_get_new_display_option</h2>
572 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_new_display_option<span·class="op">(</span><span·class="dt">int</span>·option<span·class="op">,</span>·<span·class="dt">int</span>·<span·class="op">*</span>importance<span·class="op">)</span></span></code></pre></div>590 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_new_display_option<span·class="op">(</span><span·class="dt">int</span>·option<span·class="op">,</span>·<span·class="dt">int</span>·<span·class="op">*</span>importance<span·class="op">)</span></span></code></pre></div>
573 <p><a591 <p><a
574 href="https://github.com/liballeg/allegro5/blob/master/src/display_settings.c#L64">Source592 href="https://github.com/liballeg/allegro5/blob/master/src/display_settings.c#L64">Source
575 Code</a></p>593 Code</a></p>
576 <p>Retrieve·an·extra·display·setting·which·was·previously·set·with·<a594 <p>Retrieve·an·extra·display·setting·which·was·previously·set·with·<a
577 href="display.html#al_set_new_display_option">al_set_new_display_option</a>.</p>595 href="display.html#al_set_new_display_option">al_set_new_display_option</a>.</p>
Offset 773, 17 lines modifiedOffset 791, 17 lines modified
773 <a791 <a
774 href="display.html#al_get_display_option">al_get_display_option</a></p>792 href="display.html#al_get_display_option">al_get_display_option</a></p>
775 <p>Examples:</p>793 <p>Examples:</p>
776 <ul>794 <ul>
777 <li><a795 <li><a
778 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L36">ex_d3d.cpp</a></li>796 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L36">ex_d3d.cpp</a></li>
779 <li><a797 <li><a
780 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color_gradient.c#L231">ex_color_gradient.c</a></li> 
781 <li><a 
782 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_glext.c#L216">ex_glext.c</a></li>798 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_glext.c#L216">ex_glext.c</a></li>
 799 <li><a
 800 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_expose.c#L29">ex_expose.c</a></li>
783 </ul>801 </ul>
784 <h2·id="al_reset_new_display_options">al_reset_new_display_options</h2>802 <h2·id="al_reset_new_display_options">al_reset_new_display_options</h2>
785 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_reset_new_display_options<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>803 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_reset_new_display_options<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
786 <p><a804 <p><a
787 href="https://github.com/liballeg/allegro5/blob/master/src/display_settings.c#L104">Source805 href="https://github.com/liballeg/allegro5/blob/master/src/display_settings.c#L104">Source
788 Code</a></p>806 Code</a></p>
789 <p>This·undoes·any·previous·call·to·<a807 <p>This·undoes·any·previous·call·to·<a
Offset 806, 14 lines modifiedOffset 824, 19 lines modified
806 <p>Sets·where·the·top·left·pixel·of·the·client·area·of·newly·created824 <p>Sets·where·the·top·left·pixel·of·the·client·area·of·newly·created
807 windows·(non-fullscreen)·will·be·on·screen,·for·displays·created·by·the825 windows·(non-fullscreen)·will·be·on·screen,·for·displays·created·by·the
808 calling·thread.·Negative·values·are·allowed·on·some·multihead826 calling·thread.·Negative·values·are·allowed·on·some·multihead
809 systems.</p>827 systems.</p>
810 <p>To·reset·to·the·default·behaviour,·pass·(INT_MAX,·INT_MAX).</p>828 <p>To·reset·to·the·default·behaviour,·pass·(INT_MAX,·INT_MAX).</p>
811 <p>See·also:·<a829 <p>See·also:·<a
812 href="display.html#al_get_new_window_position">al_get_new_window_position</a></p>830 href="display.html#al_get_new_window_position">al_get_new_window_position</a></p>
 831 <p>Examples:</p>
 832 <ul>
 833 <li><a
 834 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_windows.c#L61">ex_windows.c</a></li>
 835 </ul>
813 <h2836 <h2
814 id="al_get_new_display_refresh_rate">al_get_new_display_refresh_rate</h2>837 id="al_get_new_display_refresh_rate">al_get_new_display_refresh_rate</h2>
815 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_new_display_refresh_rate<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>838 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_new_display_refresh_rate<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
816 <p><a839 <p><a
817 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L279">Source840 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L279">Source
818 Code</a></p>841 Code</a></p>
819 <p>Get·the·requested·refresh·rate·to·be·used·when·creating·new·displays842 <p>Get·the·requested·refresh·rate·to·be·used·when·creating·new·displays
Offset 832, 14 lines modifiedOffset 855, 19 lines modified
832 list·of·modes·with·refresh·rates·can·be·found·with·<a855 list·of·modes·with·refresh·rates·can·be·found·with·<a
833 href="fullscreen_mode.html#al_get_num_display_modes">al_get_num_display_modes</a>856 href="fullscreen_mode.html#al_get_num_display_modes">al_get_num_display_modes</a>
834 and·<a857 and·<a
Max diff block lines reached; 24814/32788 bytes (75.68%) of diff not shown.
25.1 KB
html2text {}
    
Offset 128, 14 lines modifiedOffset 128, 18 lines modified
128 In·order·to·write·a·well-behaved·application,·it·is·necessary·to·remember·that128 In·order·to·write·a·well-behaved·application,·it·is·necessary·to·remember·that
129 displays·will·also·inform·you·about·important·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s·via·their·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8s.129 displays·will·also·inform·you·about·important·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s·via·their·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8·_\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8s.
130 *\x8**\x8**\x8**\x8**\x8**\x8*·D\x8Di\x8is\x8sp\x8pl\x8la\x8ay\x8y·c\x8cr\x8re\x8ea\x8at\x8ti\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*130 *\x8**\x8**\x8**\x8**\x8**\x8*·D\x8Di\x8is\x8sp\x8pl\x8la\x8ay\x8y·c\x8cr\x8re\x8ea\x8at\x8ti\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
131 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_D\x8DI\x8IS\x8SP\x8PL\x8LA\x8AY\x8Y·*\x8**\x8**\x8**\x8**\x8*131 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_D\x8DI\x8IS\x8SP\x8PL\x8LA\x8AY\x8Y·*\x8**\x8**\x8**\x8**\x8*
132 typedef·struct·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY;132 typedef·struct·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY;
133 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e133 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
134 An·opaque·type·representing·an·open·display·or·window.134 An·opaque·type·representing·an·open·display·or·window.
 135 Examples:
 136 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c
 137 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
 138 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
135 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y·*\x8**\x8**\x8**\x8**\x8*139 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y·*\x8**\x8**\x8**\x8**\x8*
136 ALLEGRO_DISPLAY·*al_create_display(int·w,·int·h)140 ALLEGRO_DISPLAY·*al_create_display(int·w,·int·h)
137 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e141 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
138 Create·a·display,·or·window,·with·the·specified·dimensions.·The·parameters·of142 Create·a·display,·or·window,·with·the·specified·dimensions.·The·parameters·of
139 the·display·are·determined·by·the·last·calls·to·al_set_new_display_*.·Default143 the·display·are·determined·by·the·last·calls·to·al_set_new_display_*.·Default
140 parameters·are·used·if·none·are·set·explicitly.·Creating·a·new·display·will144 parameters·are·used·if·none·are·set·explicitly.·Creating·a·new·display·will
141 automatically·make·it·the·active·one,·with·the·backbuffer·selected·for·drawing.145 automatically·make·it·the·active·one,·with·the·backbuffer·selected·for·drawing.
Offset 143, 32 lines modifiedOffset 147, 32 lines modified
143 Each·display·that·uses·OpenGL·as·a·backend·has·a·distinct·OpenGL·rendering147 Each·display·that·uses·OpenGL·as·a·backend·has·a·distinct·OpenGL·rendering
144 context·associated·with·it.·See·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p·for·the·discussion·about148 context·associated·with·it.·See·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p·for·the·discussion·about
145 rendering·contexts.149 rendering·contexts.
146 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n,150 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n,
147 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8r_\x8e_\x8f_\x8r_\x8e_\x8s_\x8h_\x8__\x8r_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r,151 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8r_\x8e_\x8f_\x8r_\x8e_\x8s_\x8h_\x8__\x8r_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r,
148 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8t_\x8i_\x8t_\x8l_\x8e·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8p_\x8o_\x8s_\x8i_\x8t_\x8i_\x8o_\x8n152 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8t_\x8i_\x8t_\x8l_\x8e·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8p_\x8o_\x8s_\x8i_\x8t_\x8i_\x8o_\x8n
149 Examples:153 Examples:
150 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8p_\x8r_\x8o_\x8p_\x8s_\x8._\x8c_\x8p_\x8p 
151 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c 
152 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p154 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
 155 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 156 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
153 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y·*\x8**\x8**\x8**\x8**\x8*157 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y·*\x8**\x8**\x8**\x8**\x8*
154 void·al_destroy_display(ALLEGRO_DISPLAY·*display)158 void·al_destroy_display(ALLEGRO_DISPLAY·*display)
155 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e159 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
156 Destroy·a·display.160 Destroy·a·display.
157 If·the·target·bitmap·of·the·calling·thread·is·tied·to·the·display,·then·it161 If·the·target·bitmap·of·the·calling·thread·is·tied·to·the·display,·then·it
158 implies·a·call·to·“al_set_target_bitmap(NULL);”·before·the·display·is162 implies·a·call·to·“al_set_target_bitmap(NULL);”·before·the·display·is
159 destroyed.163 destroyed.
160 That·special·case·notwithstanding,·you·should·make·sure·no·threads·are164 That·special·case·notwithstanding,·you·should·make·sure·no·threads·are
161 currently·targeting·a·bitmap·which·is·tied·to·the·display·before·you·destroy165 currently·targeting·a·bitmap·which·is·tied·to·the·display·before·you·destroy
162 it.166 it.
163 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p167 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p
164 Examples:168 Examples:
165 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p169 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
166 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c170 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
167 ····*·_\x8e_\x8x_\x8__\x8a_.u_.d_.i_.o_.__.s_.i_.m_.p_.l_.e_\x8._\x8c171 ····*·_\x8e_\x8x_\x8__\x8o_.p_.e_.n_.g_.l_\x8._\x8c
168 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_f\x8fl\x8la\x8ag\x8gs\x8s·*\x8**\x8**\x8**\x8**\x8*172 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_f\x8fl\x8la\x8ag\x8gs\x8s·*\x8**\x8**\x8**\x8**\x8*
169 int·al_get_new_display_flags(void)173 int·al_get_new_display_flags(void)
170 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e174 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
171 Get·the·display·flags·to·be·used·when·creating·new·displays·on·the·calling175 Get·the·display·flags·to·be·used·when·creating·new·displays·on·the·calling
172 thread.176 thread.
173 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g177 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g
174 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_f\x8fl\x8la\x8ag\x8gs\x8s·*\x8**\x8**\x8**\x8**\x8*178 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_f\x8fl\x8la\x8ag\x8gs\x8s·*\x8**\x8**\x8**\x8**\x8*
Offset 263, 14 lines modifiedOffset 267, 18 lines modified
263 ······the·display.267 ······the·display.
264 ···········_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·This·is·an·experimental·feature·and·currently268 ···········_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·This·is·an·experimental·feature·and·currently
265 ···········only·works·for·the·X11·backend.269 ···········only·works·for·the·X11·backend.
266 ······Since:·5.2.9270 ······Since:·5.2.9
267 0·can·be·used·for·default·values.271 0·can·be·used·for·default·values.
268 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n,272 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n,
269 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n273 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n
 274 Examples:
 275 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
 276 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8._\x8c
 277 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8i_\x8x_\x8e_\x8l_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
270 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_o\x8op\x8pt\x8ti\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*278 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_o\x8op\x8pt\x8ti\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*
271 int·al_get_new_display_option(int·option,·int·*importance)279 int·al_get_new_display_option(int·option,·int·*importance)
272 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e280 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
273 Retrieve·an·extra·display·setting·which·was·previously·set·with281 Retrieve·an·extra·display·setting·which·was·previously·set·with
274 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n.282 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n.
275 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_o\x8op\x8pt\x8ti\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*283 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_o\x8op\x8pt\x8ti\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*
276 void·al_set_new_display_option(int·option,·int·value,·int·importance)284 void·al_set_new_display_option(int·option,·int·value,·int·importance)
Offset 387, 16 lines modifiedOffset 395, 16 lines modified
387 ··ALLEGRO_DEFAULT_SHADER_PLATFORM395 ··ALLEGRO_DEFAULT_SHADER_PLATFORM
388 ······Specify·the·shader·platform·to·use·for·the·default·shader.·See396 ······Specify·the·shader·platform·to·use·for·the·default·shader.·See
389 ······_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R_\x8__\x8P_\x8L_\x8A_\x8T_\x8F_\x8O_\x8R_\x8M.·The·default·is·ALLEGRO_SHADER_AUTO.397 ······_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R_\x8__\x8P_\x8L_\x8A_\x8T_\x8F_\x8O_\x8R_\x8M.·The·default·is·ALLEGRO_SHADER_AUTO.
390 ······Since:·5.2.8398 ······Since:·5.2.8
391 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n399 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n
392 Examples:400 Examples:
393 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p401 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
394 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8g_\x8r_\x8a_\x8d_\x8i_\x8e_\x8n_\x8t_\x8._\x8c 
395 ····*·_\x8e_\x8x_\x8__\x8g_\x8l_\x8e_\x8x_\x8t_\x8._\x8c402 ····*·_\x8e_\x8x_\x8__\x8g_\x8l_\x8e_\x8x_\x8t_\x8._\x8c
 403 ····*·_\x8e_\x8x_\x8__\x8e_\x8x_\x8p_\x8o_\x8s_\x8e_\x8._\x8c
396 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_o\x8op\x8pt\x8ti\x8io\x8on\x8ns\x8s·*\x8**\x8**\x8**\x8**\x8*404 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_o\x8op\x8pt\x8ti\x8io\x8on\x8ns\x8s·*\x8**\x8**\x8**\x8**\x8*
397 void·al_reset_new_display_options(void)405 void·al_reset_new_display_options(void)
398 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e406 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
399 This·undoes·any·previous·call·to·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n·on·the·calling407 This·undoes·any·previous·call·to·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n·on·the·calling
400 thread.408 thread.
401 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_w\x8wi\x8in\x8nd\x8do\x8ow\x8w_\x8_p\x8po\x8os\x8si\x8it\x8ti\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*409 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_w\x8wi\x8in\x8nd\x8do\x8ow\x8w_\x8_p\x8po\x8os\x8si\x8it\x8ti\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*
402 void·al_get_new_window_position(int·*x,·int·*y)410 void·al_get_new_window_position(int·*x,·int·*y)
Offset 408, 14 lines modifiedOffset 416, 16 lines modified
408 void·al_set_new_window_position(int·x,·int·y)416 void·al_set_new_window_position(int·x,·int·y)
409 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e417 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
410 Sets·where·the·top·left·pixel·of·the·client·area·of·newly·created·windows·(non-418 Sets·where·the·top·left·pixel·of·the·client·area·of·newly·created·windows·(non-
411 fullscreen)·will·be·on·screen,·for·displays·created·by·the·calling·thread.419 fullscreen)·will·be·on·screen,·for·displays·created·by·the·calling·thread.
412 Negative·values·are·allowed·on·some·multihead·systems.420 Negative·values·are·allowed·on·some·multihead·systems.
413 To·reset·to·the·default·behaviour,·pass·(INT_MAX,·INT_MAX).421 To·reset·to·the·default·behaviour,·pass·(INT_MAX,·INT_MAX).
414 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8p_\x8o_\x8s_\x8i_\x8t_\x8i_\x8o_\x8n422 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8p_\x8o_\x8s_\x8i_\x8t_\x8i_\x8o_\x8n
 423 Examples:
 424 ····*·_\x8e_\x8x_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8s_\x8._\x8c
415 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_r\x8re\x8ef\x8fr\x8re\x8es\x8sh\x8h_\x8_r\x8ra\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8*425 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_r\x8re\x8ef\x8fr\x8re\x8es\x8sh\x8h_\x8_r\x8ra\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8*
416 int·al_get_new_display_refresh_rate(void)426 int·al_get_new_display_refresh_rate(void)
417 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e427 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
418 Get·the·requested·refresh·rate·to·be·used·when·creating·new·displays·on·the428 Get·the·requested·refresh·rate·to·be·used·when·creating·new·displays·on·the
419 calling·thread.429 calling·thread.
420 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8r_\x8e_\x8f_\x8r_\x8e_\x8s_\x8h_\x8__\x8r_\x8a_\x8t_\x8e430 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8r_\x8e_\x8f_\x8r_\x8e_\x8s_\x8h_\x8__\x8r_\x8a_\x8t_\x8e
421 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_r\x8re\x8ef\x8fr\x8re\x8es\x8sh\x8h_\x8_r\x8ra\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8*431 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_r\x8re\x8ef\x8fr\x8re\x8es\x8sh\x8h_\x8_r\x8ra\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8*
Offset 423, 14 lines modifiedOffset 433, 16 lines modified
423 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e433 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
424 Sets·the·refresh·rate·to·use·when·creating·new·displays·on·the·calling·thread.434 Sets·the·refresh·rate·to·use·when·creating·new·displays·on·the·calling·thread.
425 If·the·refresh·rate·is·not·available,·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y·will·fail.·A·list·of435 If·the·refresh·rate·is·not·available,·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y·will·fail.·A·list·of
426 modes·with·refresh·rates·can·be·found·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e_\x8s·and436 modes·with·refresh·rates·can·be·found·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e_\x8s·and
427 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e.437 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e.
428 The·default·setting·is·zero·(don’t·care).438 The·default·setting·is·zero·(don’t·care).
429 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8r_\x8e_\x8f_\x8r_\x8e_\x8s_\x8h_\x8__\x8r_\x8a_\x8t_\x8e439 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8r_\x8e_\x8f_\x8r_\x8e_\x8s_\x8h_\x8__\x8r_\x8a_\x8t_\x8e
 440 Examples:
 441 ····*·_\x8e_\x8x_\x8__\x8v_\x8s_\x8y_\x8n_\x8c_\x8._\x8c
430 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_a\x8ad\x8da\x8ap\x8pt\x8te\x8er\x8r·*\x8**\x8**\x8**\x8**\x8*442 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_a\x8ad\x8da\x8ap\x8pt\x8te\x8er\x8r·*\x8**\x8**\x8**\x8**\x8*
431 int·al_get_new_display_adapter(void)443 int·al_get_new_display_adapter(void)
432 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e444 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
433 Gets·the·video·adapter·index·where·new·displays·will·be·created·by·the·calling445 Gets·the·video·adapter·index·where·new·displays·will·be·created·by·the·calling
434 thread,·if·previously·set·with·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r.·Otherwise·returns446 thread,·if·previously·set·with·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r.·Otherwise·returns
435 ALLEGRO_DEFAULT_DISPLAY_ADAPTER.447 ALLEGRO_DEFAULT_DISPLAY_ADAPTER.
436 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r448 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r
Offset 438, 24 lines modifiedOffset 450, 28 lines modified
438 void·al_set_new_display_adapter(int·adapter)450 void·al_set_new_display_adapter(int·adapter)
439 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e451 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
Max diff block lines reached; 17537/25672 bytes (68.31%) of diff not shown.
25.7 KB
./usr/share/doc/allegro5-doc/refman/events.html
    
Offset 344, 14 lines modifiedOffset 344, 23 lines modified
344 type-specific·fields.·The·<code>any.source</code>·field·tells·you·which344 type-specific·fields.·The·<code>any.source</code>·field·tells·you·which
345 event·source·generated·that·particular·event.·The345 event·source·generated·that·particular·event.·The
346 <code>any.timestamp</code>·field·tells·you·when·the·event·was·generated.346 <code>any.timestamp</code>·field·tells·you·when·the·event·was·generated.
347 The·time·is·referenced·to·the·same·starting·point·as·<a347 The·time·is·referenced·to·the·same·starting·point·as·<a
348 href="time.html#al_get_time">al_get_time</a>.</p>348 href="time.html#al_get_time">al_get_time</a>.</p>
349 <p>Each·event·is·of·one·of·the·following·types,·with·the·usable·fields349 <p>Each·event·is·of·one·of·the·following·types,·with·the·usable·fields
350 given.</p>350 given.</p>
 351 <p>Examples:</p>
 352 <ul>
 353 <li><a
 354 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_inject_events.c#L17">ex_inject_events.c</a></li>
 355 <li><a
 356 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L189">ex_enet_server.c</a></li>
 357 <li><a
 358 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L24">ex_timer_pause.c</a></li>
 359 </ul>
351 <h2·id="allegro_event_joystick_axis">ALLEGRO_EVENT_JOYSTICK_AXIS</h2>360 <h2·id="allegro_event_joystick_axis">ALLEGRO_EVENT_JOYSTICK_AXIS</h2>
352 <p>A·joystick·axis·value·changed.</p>361 <p>A·joystick·axis·value·changed.</p>
353 <dl>362 <dl>
354 <dt>joystick.id·(ALLEGRO_JOYSTICK·*)</dt>363 <dt>joystick.id·(ALLEGRO_JOYSTICK·*)</dt>
355 <dd>364 <dd>
356 The·joystick·which·generated·the·event.·This·is·not·the·same·as·the365 The·joystick·which·generated·the·event.·This·is·not·the·same·as·the
357 event·source·<code>joystick.source</code>.366 event·source·<code>joystick.source</code>.
Offset 1049, 40 lines modifiedOffset 1058, 63 lines modified
1049 Please·see·the·documentation·for·<a1058 Please·see·the·documentation·for·<a
1050 href="events.html#allegro_get_event_type">ALLEGRO_GET_EVENT_TYPE</a>·for1059 href="events.html#allegro_get_event_type">ALLEGRO_GET_EVENT_TYPE</a>·for
1051 the·rules·you·should·follow·when·assigning·identifiers.</p>1060 the·rules·you·should·follow·when·assigning·identifiers.</p>
1052 <p>See·also:·<a1061 <p>See·also:·<a
1053 href="events.html#al_emit_user_event">al_emit_user_event</a>,·<a1062 href="events.html#al_emit_user_event">al_emit_user_event</a>,·<a
1054 href="events.html#allegro_get_event_type">ALLEGRO_GET_EVENT_TYPE</a>,·<a1063 href="events.html#allegro_get_event_type">ALLEGRO_GET_EVENT_TYPE</a>,·<a
1055 href="events.html#al_init_user_event_source">al_init_user_event_source</a></p>1064 href="events.html#al_init_user_event_source">al_init_user_event_source</a></p>
 1065 <p>Examples:</p>
 1066 <ul>
 1067 <li><a
 1068 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_user_events.c#L37">ex_user_events.c</a></li>
 1069 </ul>
1056 <h1·id="allegro_event_queue">ALLEGRO_EVENT_QUEUE</h1>1070 <h1·id="allegro_event_queue">ALLEGRO_EVENT_QUEUE</h1>
1057 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_EVENT_QUEUE·ALLEGRO_EVENT_QUEUE<span·class="op">;</span></span></code></pre></div>1071 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_EVENT_QUEUE·ALLEGRO_EVENT_QUEUE<span·class="op">;</span></span></code></pre></div>
1058 <p><a1072 <p><a
1059 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L258">Source1073 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L258">Source
1060 Code</a></p>1074 Code</a></p>
1061 <p>An·event·queue·holds·events·that·have·been·generated·by·event·sources1075 <p>An·event·queue·holds·events·that·have·been·generated·by·event·sources
1062 that·are·registered·with·the·queue.·Events·are·stored·in·the·order·they1076 that·are·registered·with·the·queue.·Events·are·stored·in·the·order·they
1063 are·generated.·Access·is·in·a·strictly·FIFO·(first-in-first-out)1077 are·generated.·Access·is·in·a·strictly·FIFO·(first-in-first-out)
1064 order.</p>1078 order.</p>
1065 <p>See·also:·<a1079 <p>See·also:·<a
1066 href="events.html#al_create_event_queue">al_create_event_queue</a>,·<a1080 href="events.html#al_create_event_queue">al_create_event_queue</a>,·<a
1067 href="events.html#al_destroy_event_queue">al_destroy_event_queue</a></p>1081 href="events.html#al_destroy_event_queue">al_destroy_event_queue</a></p>
 1082 <p>Examples:</p>
 1083 <ul>
 1084 <li><a
 1085 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_inject_events.c#L18">ex_inject_events.c</a></li>
 1086 <li><a
 1087 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L189">ex_enet_server.c</a></li>
 1088 <li><a
 1089 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L24">ex_timer_pause.c</a></li>
 1090 </ul>
1068 <h1·id="allegro_event_source">ALLEGRO_EVENT_SOURCE</h1>1091 <h1·id="allegro_event_source">ALLEGRO_EVENT_SOURCE</h1>
1069 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_EVENT_SOURCE·ALLEGRO_EVENT_SOURCE<span·class="op">;</span></span></code></pre></div>1092 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_EVENT_SOURCE·ALLEGRO_EVENT_SOURCE<span·class="op">;</span></span></code></pre></div>
1070 <p><a1093 <p><a
1071 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L74">Source1094 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L74">Source
1072 Code</a></p>1095 Code</a></p>
1073 <p>An·event·source·is·any·object·which·can·generate·events.·For·example,1096 <p>An·event·source·is·any·object·which·can·generate·events.·For·example,
1074 an·ALLEGRO_DISPLAY·can·generate·events,·and·you·can·get·the1097 an·ALLEGRO_DISPLAY·can·generate·events,·and·you·can·get·the
1075 ALLEGRO_EVENT_SOURCE·pointer·from·an·ALLEGRO_DISPLAY·with·<a1098 ALLEGRO_EVENT_SOURCE·pointer·from·an·ALLEGRO_DISPLAY·with·<a
1076 href="display.html#al_get_display_event_source">al_get_display_event_source</a>.</p>1099 href="display.html#al_get_display_event_source">al_get_display_event_source</a>.</p>
1077 <p>You·may·create·your·own·“user”·event·sources·that·emit·custom1100 <p>You·may·create·your·own·“user”·event·sources·that·emit·custom
1078 events.</p>1101 events.</p>
1079 <p>See·also:·<a·href="events.html#allegro_event">ALLEGRO_EVENT</a>,·<a1102 <p>See·also:·<a·href="events.html#allegro_event">ALLEGRO_EVENT</a>,·<a
1080 href="events.html#al_init_user_event_source">al_init_user_event_source</a>,1103 href="events.html#al_init_user_event_source">al_init_user_event_source</a>,
1081 <a·href="events.html#al_emit_user_event">al_emit_user_event</a></p>1104 <a·href="events.html#al_emit_user_event">al_emit_user_event</a></p>
 1105 <p>Examples:</p>
 1106 <ul>
 1107 <li><a
 1108 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_inject_events.c#L17">ex_inject_events.c</a></li>
 1109 <li><a
 1110 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_user_events.c#L47">ex_user_events.c</a></li>
 1111 <li><a
 1112 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L364">nihgui.cpp</a></li>
 1113 </ul>
1082 <h1·id="allegro_event_type">ALLEGRO_EVENT_TYPE</h1>1114 <h1·id="allegro_event_type">ALLEGRO_EVENT_TYPE</h1>
1083 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="dt">unsigned</span>·<span·class="dt">int</span>·ALLEGRO_EVENT_TYPE<span·class="op">;</span></span></code></pre></div>1115 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="dt">unsigned</span>·<span·class="dt">int</span>·ALLEGRO_EVENT_TYPE<span·class="op">;</span></span></code></pre></div>
1084 <p><a1116 <p><a
1085 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L13">Source1117 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L13">Source
1086 Code</a></p>1118 Code</a></p>
1087 <p>An·integer·used·to·distinguish·between·different·types·of·events.</p>1119 <p>An·integer·used·to·distinguish·between·different·types·of·events.</p>
1088 <p>See·also:·<a·href="events.html#allegro_event">ALLEGRO_EVENT</a>,·<a1120 <p>See·also:·<a·href="events.html#allegro_event">ALLEGRO_EVENT</a>,·<a
Offset 1092, 15 lines modifiedOffset 1124, 20 lines modified
1092 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_GET_EVENT_TYPE</span><span·class="op">(</span><span·class="pp">a</span><span·class="op">,</span><span·class="pp">·b</span><span·class="op">,</span><span·class="pp">·c</span><span·class="op">,</span><span·class="pp">·d</span><span·class="op">)</span><span·class="pp">···AL_ID</span><span·class="op">(</span><span·class="pp">a</span><span·class="op">,</span><span·class="pp">·b</span><span·class="op">,</span><span·class="pp">·c</span><span·class="op">,</span><span·class="pp">·d</span><span·class="op">)</span></span></code></pre></div>1124 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_GET_EVENT_TYPE</span><span·class="op">(</span><span·class="pp">a</span><span·class="op">,</span><span·class="pp">·b</span><span·class="op">,</span><span·class="pp">·c</span><span·class="op">,</span><span·class="pp">·d</span><span·class="op">)</span><span·class="pp">···AL_ID</span><span·class="op">(</span><span·class="pp">a</span><span·class="op">,</span><span·class="pp">·b</span><span·class="op">,</span><span·class="pp">·c</span><span·class="op">,</span><span·class="pp">·d</span><span·class="op">)</span></span></code></pre></div>
1093 <p><a1125 <p><a
1094 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L69">Source1126 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L69">Source
1095 Code</a></p>1127 Code</a></p>
1096 <p>Make·an·event·type·identifier,·which·is·a·32-bit·integer.·Usually,1128 <p>Make·an·event·type·identifier,·which·is·a·32-bit·integer.·Usually,
1097 but·not·necessarily,·this·will·be·made·from·four·8-bit·character·codes,1129 but·not·necessarily,·this·will·be·made·from·four·8-bit·character·codes,
1098 for·example:</p>1130 for·example:</p>
 1131 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a>Examples<span·class="op">:</span></span>
 1132 <span·id="cb9-2"><a·href="#cb9-2"·aria-hidden="true"·tabindex="-1"></a></span>
 1133 <span·id="cb9-3"><a·href="#cb9-3"·aria-hidden="true"·tabindex="-1"></a><span·class="op">*</span>·<span·class="op">[</span>ex_user_events<span·class="op">.</span>c<span·class="op">](</span>https<span·class="op">:</span><span·class="co">//github.com/liballeg/allegro5/blob/master/examples/ex_user_events.c#L10)</span></span>
 1134 <span·id="cb9-4"><a·href="#cb9-4"·aria-hidden="true"·tabindex="-1"></a><span·class="op">*</span>·<span·class="op">[</span>ex_native_filechooser<span·class="op">.</span>c<span·class="op">](</span>https<span·class="op">:</span><span·class="co">//github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L24)</span></span>
 1135 <span·id="cb9-5"><a·href="#cb9-5"·aria-hidden="true"·tabindex="-1"></a></span>
1099 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#</span><span·class="er">defin··MY_EVENT_TYPE···ALLEGRO_GET_EVENT_TYPE(&#39;M&#39;,&#39;I&#39;,&#39;N&#39;,&#39;E&#39;)</span></span></code></pre></div>1136 <span·id="cb9-6"><a·href="#cb9-6"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#</span><span·class="er">defin··MY_EVENT_TYPE···ALLEGRO_GET_EVENT_TYPE(&#39;M&#39;,&#39;I&#39;,&#39;N&#39;,&#39;E&#39;)</span></span></code></pre></div>
1100 <p>IDs·less·than·1024·are·reserved·for·Allegro·or·its·addons.·Don’t·use1137 <p>IDs·less·than·1024·are·reserved·for·Allegro·or·its·addons.·Don’t·use
1101 anything·lower·than·<code>ALLEGRO_GET_EVENT_TYPE(0,·0,·4,·0)</code>.</p>1138 anything·lower·than·<code>ALLEGRO_GET_EVENT_TYPE(0,·0,·4,·0)</code>.</p>
1102 <p>You·should·try·to·make·your·IDs·unique·so·they·don’t·clash·with·any1139 <p>You·should·try·to·make·your·IDs·unique·so·they·don’t·clash·with·any
1103 3rd·party·code·you·may·be·using.·Be·creative.·Numbering·from·1024·is·not1140 3rd·party·code·you·may·be·using.·Be·creative.·Numbering·from·1024·is·not
1104 creative.</p>1141 creative.</p>
1105 <p>If·you·need·multiple·identifiers,·you·could·define·them·like1142 <p>If·you·need·multiple·identifiers,·you·could·define·them·like
1106 this:</p>1143 this:</p>
Offset 1136, 19 lines modifiedOffset 1173, 19 lines modified
1136 <p>See·also:·<a1173 <p>See·also:·<a
1137 href="events.html#al_register_event_source">al_register_event_source</a>,1174 href="events.html#al_register_event_source">al_register_event_source</a>,
1138 <a·href="events.html#al_destroy_event_queue">al_destroy_event_queue</a>,1175 <a·href="events.html#al_destroy_event_queue">al_destroy_event_queue</a>,
1139 <a·href="events.html#allegro_event_queue">ALLEGRO_EVENT_QUEUE</a></p>1176 <a·href="events.html#allegro_event_queue">ALLEGRO_EVENT_QUEUE</a></p>
1140 <p>Examples:</p>1177 <p>Examples:</p>
1141 <ul>1178 <ul>
1142 <li><a1179 <li><a
1143 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L213">ex_enet_server.c</a></li>1180 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_inject_events.c#L33">ex_inject_events.c</a></li>
1144 <li><a1181 <li><a
1145 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_saw.c#L23">ex_saw.c</a></li>1182 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L213">ex_enet_server.c</a></li>
1146 <li><a1183 <li><a
1147 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_stream_file.c#L83">ex_stream_file.c</a></li>1184 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L36">ex_timer_pause.c</a></li>
1148 </ul>1185 </ul>
1149 <h1·id="al_destroy_event_queue">al_destroy_event_queue</h1>1186 <h1·id="al_destroy_event_queue">al_destroy_event_queue</h1>
1150 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_event_queue<span·class="op">(</span>ALLEGRO_EVENT_QUEUE·<span·class="op">*</span>queue<span·class="op">)</span></span></code></pre></div>1187 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_event_queue<span·class="op">(</span>ALLEGRO_EVENT_QUEUE·<span·class="op">*</span>queue<span·class="op">)</span></span></code></pre></div>
1151 <p><a1188 <p><a
1152 href="https://github.com/liballeg/allegro5/blob/master/src/events.c#L120">Source1189 href="https://github.com/liballeg/allegro5/blob/master/src/events.c#L120">Source
1153 Code</a></p>1190 Code</a></p>
Max diff block lines reached; 6389/15978 bytes (39.99%) of diff not shown.
10.0 KB
html2text {}
    
Offset 133, 14 lines modifiedOffset 133, 18 lines modified
133 ··any.timestamp·(double)133 ··any.timestamp·(double)
134 ······When·the·event·was·generated.134 ······When·the·event·was·generated.
135 By·examining·the·type·field·you·can·then·access·type-specific·fields.·The135 By·examining·the·type·field·you·can·then·access·type-specific·fields.·The
136 any.source·field·tells·you·which·event·source·generated·that·particular·event.136 any.source·field·tells·you·which·event·source·generated·that·particular·event.
137 The·any.timestamp·field·tells·you·when·the·event·was·generated.·The·time·is137 The·any.timestamp·field·tells·you·when·the·event·was·generated.·The·time·is
138 referenced·to·the·same·starting·point·as·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e.138 referenced·to·the·same·starting·point·as·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e.
139 Each·event·is·of·one·of·the·following·types,·with·the·usable·fields·given.139 Each·event·is·of·one·of·the·following·types,·with·the·usable·fields·given.
 140 Examples:
 141 ····*·_\x8e_\x8x_\x8__\x8i_\x8n_\x8j_\x8e_\x8c_\x8t_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 142 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 143 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
140 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_J\x8JO\x8OY\x8YS\x8ST\x8TI\x8IC\x8CK\x8K_\x8_A\x8AX\x8XI\x8IS\x8S·*\x8**\x8**\x8**\x8**\x8*144 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_J\x8JO\x8OY\x8YS\x8ST\x8TI\x8IC\x8CK\x8K_\x8_A\x8AX\x8XI\x8IS\x8S·*\x8**\x8**\x8**\x8**\x8*
141 A·joystick·axis·value·changed.145 A·joystick·axis·value·changed.
142 ··joystick.id·(ALLEGRO_JOYSTICK·*)146 ··joystick.id·(ALLEGRO_JOYSTICK·*)
143 ······The·joystick·which·generated·the·event.·This·is·not·the·same·as·the·event147 ······The·joystick·which·generated·the·event.·This·is·not·the·same·as·the·event
144 ······source·joystick.source.148 ······source·joystick.source.
145 ··joystick.stick·(int)149 ··joystick.stick·(int)
146 ······The·stick·number,·counting·from·zero.·Axes·on·a·joystick·are·grouped·into150 ······The·stick·number,·counting·from·zero.·Axes·on·a·joystick·are·grouped·into
Offset 523, 39 lines modifiedOffset 527, 56 lines modified
523 my_event.user.data2·=·&some_var;527 my_event.user.data2·=·&some_var;
  
524 al_emit_user_event(&my_event_source,·&my_event,·NULL);528 al_emit_user_event(&my_event_source,·&my_event,·NULL);
525 Event·type·identifiers·for·user·events·are·assigned·by·the·user.·Please·see·the529 Event·type·identifiers·for·user·events·are·assigned·by·the·user.·Please·see·the
526 documentation·for·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8G_\x8E_\x8T_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E·for·the·rules·you·should·follow·when530 documentation·for·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8G_\x8E_\x8T_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E·for·the·rules·you·should·follow·when
527 assigning·identifiers.531 assigning·identifiers.
528 See·also:·_\x8a_\x8l_\x8__\x8e_\x8m_\x8i_\x8t_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8G_\x8E_\x8T_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E,·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e532 See·also:·_\x8a_\x8l_\x8__\x8e_\x8m_\x8i_\x8t_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8G_\x8E_\x8T_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E,·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e
 533 Examples:
 534 ····*·_\x8e_\x8x_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
529 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_Q\x8QU\x8UE\x8EU\x8UE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*535 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_Q\x8QU\x8UE\x8EU\x8UE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
530 typedef·struct·ALLEGRO_EVENT_QUEUE·ALLEGRO_EVENT_QUEUE;536 typedef·struct·ALLEGRO_EVENT_QUEUE·ALLEGRO_EVENT_QUEUE;
531 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e537 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
532 An·event·queue·holds·events·that·have·been·generated·by·event·sources·that·are538 An·event·queue·holds·events·that·have·been·generated·by·event·sources·that·are
533 registered·with·the·queue.·Events·are·stored·in·the·order·they·are·generated.539 registered·with·the·queue.·Events·are·stored·in·the·order·they·are·generated.
534 Access·is·in·a·strictly·FIFO·(first-in-first-out)·order.540 Access·is·in·a·strictly·FIFO·(first-in-first-out)·order.
535 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8q_\x8u_\x8e_\x8u_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8q_\x8u_\x8e_\x8u_\x8e541 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8q_\x8u_\x8e_\x8u_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8q_\x8u_\x8e_\x8u_\x8e
 542 Examples:
 543 ····*·_\x8e_\x8x_\x8__\x8i_\x8n_\x8j_\x8e_\x8c_\x8t_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 544 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 545 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
536 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_S\x8SO\x8OU\x8UR\x8RC\x8CE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*546 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_S\x8SO\x8OU\x8UR\x8RC\x8CE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
537 typedef·struct·ALLEGRO_EVENT_SOURCE·ALLEGRO_EVENT_SOURCE;547 typedef·struct·ALLEGRO_EVENT_SOURCE·ALLEGRO_EVENT_SOURCE;
538 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e548 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
539 An·event·source·is·any·object·which·can·generate·events.·For·example,·an549 An·event·source·is·any·object·which·can·generate·events.·For·example,·an
540 ALLEGRO_DISPLAY·can·generate·events,·and·you·can·get·the·ALLEGRO_EVENT_SOURCE550 ALLEGRO_DISPLAY·can·generate·events,·and·you·can·get·the·ALLEGRO_EVENT_SOURCE
541 pointer·from·an·ALLEGRO_DISPLAY·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e.551 pointer·from·an·ALLEGRO_DISPLAY·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e.
542 You·may·create·your·own·“user”·event·sources·that·emit·custom·events.552 You·may·create·your·own·“user”·event·sources·that·emit·custom·events.
543 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T,·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8e_\x8m_\x8i_\x8t_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t553 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T,·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8e_\x8m_\x8i_\x8t_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t
 554 Examples:
 555 ····*·_\x8e_\x8x_\x8__\x8i_\x8n_\x8j_\x8e_\x8c_\x8t_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 556 ····*·_\x8e_\x8x_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 557 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
544 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_T\x8TY\x8YP\x8PE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*558 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_T\x8TY\x8YP\x8PE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
545 typedef·unsigned·int·ALLEGRO_EVENT_TYPE;559 typedef·unsigned·int·ALLEGRO_EVENT_TYPE;
546 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e560 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
547 An·integer·used·to·distinguish·between·different·types·of·events.561 An·integer·used·to·distinguish·between·different·types·of·events.
548 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8G_\x8E_\x8T_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E_\x8__\x8I_\x8S_\x8__\x8U_\x8S_\x8E_\x8R562 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8G_\x8E_\x8T_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E_\x8__\x8I_\x8S_\x8__\x8U_\x8S_\x8E_\x8R
549 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_G\x8GE\x8ET\x8T_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_T\x8TY\x8YP\x8PE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*563 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_G\x8GE\x8ET\x8T_\x8_E\x8EV\x8VE\x8EN\x8NT\x8T_\x8_T\x8TY\x8YP\x8PE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
550 #define·ALLEGRO_GET_EVENT_TYPE(a,·b,·c,·d)···AL_ID(a,·b,·c,·d)564 #define·ALLEGRO_GET_EVENT_TYPE(a,·b,·c,·d)···AL_ID(a,·b,·c,·d)
551 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e565 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
552 Make·an·event·type·identifier,·which·is·a·32-bit·integer.·Usually,·but·not566 Make·an·event·type·identifier,·which·is·a·32-bit·integer.·Usually,·but·not
553 necessarily,·this·will·be·made·from·four·8-bit·character·codes,·for·example:567 necessarily,·this·will·be·made·from·four·8-bit·character·codes,·for·example:
 568 Examples:
  
 569 *·[ex_user_events.c](https://github.com/liballeg/allegro5/blob/master/examples/
 570 ex_user_events.c#L10)
 571 *·[ex_native_filechooser.c](https://github.com/liballeg/allegro5/blob/master/
 572 examples/ex_native_filechooser.c#L24)
  
554 #defin··MY_EVENT_TYPE···ALLEGRO_GET_EVENT_TYPE('M','I','N','E')573 #defin··MY_EVENT_TYPE···ALLEGRO_GET_EVENT_TYPE('M','I','N','E')
555 IDs·less·than·1024·are·reserved·for·Allegro·or·its·addons.·Don’t·use·anything574 IDs·less·than·1024·are·reserved·for·Allegro·or·its·addons.·Don’t·use·anything
556 lower·than·ALLEGRO_GET_EVENT_TYPE(0,·0,·4,·0).575 lower·than·ALLEGRO_GET_EVENT_TYPE(0,·0,·4,·0).
557 You·should·try·to·make·your·IDs·unique·so·they·don’t·clash·with·any·3rd·party576 You·should·try·to·make·your·IDs·unique·so·they·don’t·clash·with·any·3rd·party
558 code·you·may·be·using.·Be·creative.·Numbering·from·1024·is·not·creative.577 code·you·may·be·using.·Be·creative.·Numbering·from·1024·is·not·creative.
559 If·you·need·multiple·identifiers,·you·could·define·them·like·this:578 If·you·need·multiple·identifiers,·you·could·define·them·like·this:
560 #defin··BASE_EVENT···ALLEGRO_GET_EVENT_TYPE('M','I','N','E')579 #defin··BASE_EVENT···ALLEGRO_GET_EVENT_TYPE('M','I','N','E')
Offset 578, 41 lines modifiedOffset 599, 41 lines modified
578 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_q\x8qu\x8ue\x8eu\x8ue\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*599 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_q\x8qu\x8ue\x8eu\x8ue\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
579 ALLEGRO_EVENT_QUEUE·*al_create_event_queue(void)600 ALLEGRO_EVENT_QUEUE·*al_create_event_queue(void)
580 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e601 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
581 Create·a·new,·empty·event·queue,·returning·a·pointer·to·the·newly·created602 Create·a·new,·empty·event·queue,·returning·a·pointer·to·the·newly·created
582 object·if·successful.·Returns·NULL·on·error.603 object·if·successful.·Returns·NULL·on·error.
583 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8q_\x8u_\x8e_\x8u_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8Q_\x8U_\x8E_\x8U_\x8E604 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8q_\x8u_\x8e_\x8u_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8Q_\x8U_\x8E_\x8U_\x8E
584 Examples:605 Examples:
 606 ····*·_\x8e_\x8x_\x8__\x8i_\x8n_\x8j_\x8e_\x8c_\x8t_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
585 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c607 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 608 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
586 ····*·_\x8e_\x8x_\x8__\x8s_\x8a_\x8w_\x8._\x8c 
587 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c 
588 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_q\x8qu\x8ue\x8eu\x8ue\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*609 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_q\x8qu\x8ue\x8eu\x8ue\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
589 void·al_destroy_event_queue(ALLEGRO_EVENT_QUEUE·*queue)610 void·al_destroy_event_queue(ALLEGRO_EVENT_QUEUE·*queue)
590 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e611 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
591 Destroy·the·event·queue·specified.·All·event·sources·currently·registered·with612 Destroy·the·event·queue·specified.·All·event·sources·currently·registered·with
592 the·queue·will·be·automatically·unregistered·before·the·queue·is·destroyed.613 the·queue·will·be·automatically·unregistered·before·the·queue·is·destroyed.
593 This·function·does·nothing·if·queue·is·NULL.·(since·5.2.9)614 This·function·does·nothing·if·queue·is·NULL.·(since·5.2.9)
594 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8q_\x8u_\x8e_\x8u_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8Q_\x8U_\x8E_\x8U_\x8E615 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8q_\x8u_\x8e_\x8u_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8Q_\x8U_\x8E_\x8U_\x8E
595 Examples:616 Examples:
 617 ····*·_\x8e_\x8x_\x8__\x8i_\x8n_\x8j_\x8e_\x8c_\x8t_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
596 ····*·_\x8e_\x8x_\x8__\x8s_\x8a_\x8w_\x8._\x8c 
597 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c 
598 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c618 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
 619 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c
599 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8eg\x8gi\x8is\x8st\x8te\x8er\x8r_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*620 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8eg\x8gi\x8is\x8st\x8te\x8er\x8r_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
600 void·al_register_event_source(ALLEGRO_EVENT_QUEUE·*queue,621 void·al_register_event_source(ALLEGRO_EVENT_QUEUE·*queue,
601 ···ALLEGRO_EVENT_SOURCE·*source)622 ···ALLEGRO_EVENT_SOURCE·*source)
602 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e623 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
603 Register·the·event·source·with·the·event·queue·specified.·An·event·source·may624 Register·the·event·source·with·the·event·queue·specified.·An·event·source·may
604 be·registered·with·any·number·of·event·queues·simultaneously,·or·none.·Trying625 be·registered·with·any·number·of·event·queues·simultaneously,·or·none.·Trying
605 to·register·an·event·source·with·the·same·event·queue·more·than·once·does626 to·register·an·event·source·with·the·same·event·queue·more·than·once·does
606 nothing.627 nothing.
607 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8S_\x8O_\x8U_\x8R_\x8C_\x8E628 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8S_\x8O_\x8U_\x8R_\x8C_\x8E
608 Examples:629 Examples:
 630 ····*·_\x8e_\x8x_\x8__\x8i_\x8n_\x8j_\x8e_\x8c_\x8t_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
609 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c631 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 632 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
610 ····*·_\x8e_\x8x_\x8__\x8s_\x8a_\x8w_\x8._\x8c 
611 ····*·_\x8e_\x8x_\x8__\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c 
612 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nr\x8re\x8eg\x8gi\x8is\x8st\x8te\x8er\x8r_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*633 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nr\x8re\x8eg\x8gi\x8is\x8st\x8te\x8er\x8r_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
613 void·al_unregister_event_source(ALLEGRO_EVENT_QUEUE·*queue,634 void·al_unregister_event_source(ALLEGRO_EVENT_QUEUE·*queue,
614 ···ALLEGRO_EVENT_SOURCE·*source)635 ···ALLEGRO_EVENT_SOURCE·*source)
615 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e636 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
616 Unregister·an·event·source·with·an·event·queue.·If·the·event·source·is·not637 Unregister·an·event·source·with·an·event·queue.·If·the·event·source·is·not
617 actually·registered·with·the·event·queue,·nothing·happens.638 actually·registered·with·the·event·queue,·nothing·happens.
618 If·the·queue·had·any·events·in·it·which·originated·from·the·event·source,·they639 If·the·queue·had·any·events·in·it·which·originated·from·the·event·source,·they
Offset 646, 17 lines modifiedOffset 667, 17 lines modified
646 Since:·5.1.0667 Since:·5.1.0
647 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_q\x8qu\x8ue\x8eu\x8ue\x8e_\x8_e\x8em\x8mp\x8pt\x8ty\x8y·*\x8**\x8**\x8**\x8**\x8**\x8*668 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_q\x8qu\x8ue\x8eu\x8ue\x8e_\x8_e\x8em\x8mp\x8pt\x8ty\x8y·*\x8**\x8**\x8**\x8**\x8**\x8*
648 bool·al_is_event_queue_empty(ALLEGRO_EVENT_QUEUE·*queue)669 bool·al_is_event_queue_empty(ALLEGRO_EVENT_QUEUE·*queue)
Max diff block lines reached; 2216/10246 bytes (21.63%) of diff not shown.
15.5 KB
./usr/share/doc/allegro5-doc/refman/file.html
    
Offset 242, 14 lines modifiedOffset 242, 23 lines modified
242 <h1·id="allegro_file">ALLEGRO_FILE</h1>242 <h1·id="allegro_file">ALLEGRO_FILE</h1>
243 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE·ALLEGRO_FILE<span·class="op">;</span></span></code></pre></div>243 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE·ALLEGRO_FILE<span·class="op">;</span></span></code></pre></div>
244 <p><a244 <p><a
245 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L15">Source245 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L15">Source
246 Code</a></p>246 Code</a></p>
247 <p>An·opaque·object·representing·an·open·file.·This·could·be·a·real·file247 <p>An·opaque·object·representing·an·open·file.·This·could·be·a·real·file
248 on·disk·or·a·virtual·file.</p>248 on·disk·or·a·virtual·file.</p>
 249 <p>Examples:</p>
 250 <ul>
 251 <li><a
 252 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file.c#L23">ex_file.c</a></li>
 253 <li><a
 254 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_dir.c#L18">ex_dir.c</a></li>
 255 <li><a
 256 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_memfile.c#L19">ex_memfile.c</a></li>
 257 </ul>
249 <h1·id="allegro_file_interface">ALLEGRO_FILE_INTERFACE</h1>258 <h1·id="allegro_file_interface">ALLEGRO_FILE_INTERFACE</h1>
250 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE_INTERFACE</span></code></pre></div>259 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE_INTERFACE</span></code></pre></div>
251 <p><a260 <p><a
252 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L20">Source261 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L20">Source
253 Code</a></p>262 Code</a></p>
254 <p>A·structure·containing·function·pointers·to·handle·a·type·of·“file”,263 <p>A·structure·containing·function·pointers·to·handle·a·type·of·“file”,
255 real·or·virtual.·See·the·full·discussion·in·<a264 real·or·virtual.·See·the·full·discussion·in·<a
Offset 276, 25 lines modifiedOffset 285, 39 lines modified
276 file·handle.·If·fi_open·returns·NULL·then·<a285 file·handle.·If·fi_open·returns·NULL·then·<a
277 href="file.html#al_fopen">al_fopen</a>·will·also·return·NULL.</p>286 href="file.html#al_fopen">al_fopen</a>·will·also·return·NULL.</p>
278 <p>The·fi_fclose·function·must·clean·up·and·free·the·userdata,·but287 <p>The·fi_fclose·function·must·clean·up·and·free·the·userdata,·but
279 Allegro·will·free·the·<a·href="file.html#allegro_file">ALLEGRO_FILE</a>288 Allegro·will·free·the·<a·href="file.html#allegro_file">ALLEGRO_FILE</a>
280 handle.</p>289 handle.</p>
281 <p>If·fi_fungetc·is·NULL,·then·Allegro’s·default·implementation·of·a·16290 <p>If·fi_fungetc·is·NULL,·then·Allegro’s·default·implementation·of·a·16
282 char·long·buffer·will·be·used.</p>291 char·long·buffer·will·be·used.</p>
 292 <p>Examples:</p>
 293 <ul>
 294 <li><a
 295 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_curl.c#L65">ex_curl.c</a></li>
 296 </ul>
283 <h1·id="allegro_seek">ALLEGRO_SEEK</h1>297 <h1·id="allegro_seek">ALLEGRO_SEEK</h1>
284 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_SEEK</span></code></pre></div>298 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_SEEK</span></code></pre></div>
285 <p><a299 <p><a
286 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L40">Source300 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L40">Source
287 Code</a></p>301 Code</a></p>
288 <ul>302 <ul>
289 <li>ALLEGRO_SEEK_SET·-·seek·relative·to·beginning·of·file</li>303 <li>ALLEGRO_SEEK_SET·-·seek·relative·to·beginning·of·file</li>
290 <li>ALLEGRO_SEEK_CUR·-·seek·relative·to·current·file·position</li>304 <li>ALLEGRO_SEEK_CUR·-·seek·relative·to·current·file·position</li>
291 <li>ALLEGRO_SEEK_END·-·seek·relative·to·end·of·file</li>305 <li>ALLEGRO_SEEK_END·-·seek·relative·to·end·of·file</li>
292 </ul>306 </ul>
293 <p>See·also:·<a·href="file.html#al_fseek">al_fseek</a></p>307 <p>See·also:·<a·href="file.html#al_fseek">al_fseek</a></p>
 308 <p>Examples:</p>
 309 <ul>
 310 <li><a
 311 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file.c#L60">ex_file.c</a></li>
 312 <li><a
 313 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_memfile.c#L50">ex_memfile.c</a></li>
 314 <li><a
 315 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file_slice.c#L59">ex_file_slice.c</a></li>
 316 </ul>
294 <h1·id="al_fopen">al_fopen</h1>317 <h1·id="al_fopen">al_fopen</h1>
295 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_FILE·<span·class="op">*</span>al_fopen<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>path<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>mode<span·class="op">)</span></span></code></pre></div>318 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_FILE·<span·class="op">*</span>al_fopen<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>path<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>mode<span·class="op">)</span></span></code></pre></div>
296 <p><a319 <p><a
297 href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L24">Source320 href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L24">Source
298 Code</a></p>321 Code</a></p>
299 <p>Creates·and·opens·a·file·(real·or·virtual)·given·the·path·and·mode.322 <p>Creates·and·opens·a·file·(real·or·virtual)·given·the·path·and·mode.
300 The·current·file·interface·is·used·to·open·the·file.</p>323 The·current·file·interface·is·used·to·open·the·file.</p>
Offset 318, 19 lines modifiedOffset 341, 19 lines modified
318 <p>Returns·a·file·handle·on·success,·or·NULL·on·error.</p>341 <p>Returns·a·file·handle·on·success,·or·NULL·on·error.</p>
319 <p>See·also:·<a342 <p>See·also:·<a
320 href="file.html#al_set_new_file_interface">al_set_new_file_interface</a>,343 href="file.html#al_set_new_file_interface">al_set_new_file_interface</a>,
321 <a·href="file.html#al_fclose">al_fclose</a>.</p>344 <a·href="file.html#al_fclose">al_fclose</a>.</p>
322 <p>Examples:</p>345 <p>Examples:</p>
323 <ul>346 <ul>
324 <li><a347 <li><a
325 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_synth.cpp#L313">ex_synth.cpp</a></li> 
326 <li><a 
327 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file.c#L27">ex_file.c</a></li>348 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file.c#L27">ex_file.c</a></li>
328 <li><a349 <li><a
329 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file_slice.c#L29">ex_file_slice.c</a></li>350 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file_slice.c#L29">ex_file_slice.c</a></li>
 351 <li><a
 352 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_bitmap_file.c#L80">ex_bitmap_file.c</a></li>
330 </ul>353 </ul>
331 <h1·id="al_fopen_interface">al_fopen_interface</h1>354 <h1·id="al_fopen_interface">al_fopen_interface</h1>
332 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_FILE·<span·class="op">*</span>al_fopen_interface<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_FILE_INTERFACE·<span·class="op">*</span>drv<span·class="op">,</span></span>355 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_FILE·<span·class="op">*</span>al_fopen_interface<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_FILE_INTERFACE·<span·class="op">*</span>drv<span·class="op">,</span></span>
333 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>path<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>mode<span·class="op">)</span></span></code></pre></div>356 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>path<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>mode<span·class="op">)</span></span></code></pre></div>
334 <p><a357 <p><a
335 href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L32">Source358 href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L32">Source
336 Code</a></p>359 Code</a></p>
Offset 389, 19 lines modifiedOffset 412, 19 lines modified
389 Code</a></p>412 Code</a></p>
390 <p>Close·the·given·file,·writing·any·buffered·output·data·(if·any).</p>413 <p>Close·the·given·file,·writing·any·buffered·output·data·(if·any).</p>
391 <p>Returns·true·on·success,·false·on·failure.·errno·is·set·to·indicate414 <p>Returns·true·on·success,·false·on·failure.·errno·is·set·to·indicate
392 the·error.</p>415 the·error.</p>
393 <p>Examples:</p>416 <p>Examples:</p>
394 <ul>417 <ul>
395 <li><a418 <li><a
396 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_synth.cpp#L506">ex_synth.cpp</a></li> 
397 <li><a 
398 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file.c#L130">ex_file.c</a></li>419 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file.c#L130">ex_file.c</a></li>
399 <li><a420 <li><a
400 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_memfile.c#L104">ex_memfile.c</a></li>421 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_memfile.c#L104">ex_memfile.c</a></li>
 422 <li><a
 423 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file_slice.c#L77">ex_file_slice.c</a></li>
401 </ul>424 </ul>
402 <h1·id="al_fread">al_fread</h1>425 <h1·id="al_fread">al_fread</h1>
403 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">size_t</span>·al_fread<span·class="op">(</span>ALLEGRO_FILE·<span·class="op">*</span>f<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">*</span>ptr<span·class="op">,</span>·<span·class="dt">size_t</span>·size<span·class="op">)</span></span></code></pre></div>426 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">size_t</span>·al_fread<span·class="op">(</span>ALLEGRO_FILE·<span·class="op">*</span>f<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">*</span>ptr<span·class="op">,</span>·<span·class="dt">size_t</span>·size<span·class="op">)</span></span></code></pre></div>
404 <p><a427 <p><a
405 href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L101">Source428 href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L101">Source
406 Code</a></p>429 Code</a></p>
407 <p>Read·‘size’·bytes·into·the·buffer·pointed·to·by·‘ptr’,·from·the·given430 <p>Read·‘size’·bytes·into·the·buffer·pointed·to·by·‘ptr’,·from·the·given
Offset 441, 19 lines modifiedOffset 464, 19 lines modified
441 href="file.html#al_fwrite16be">al_fwrite16be</a>,·<a464 href="file.html#al_fwrite16be">al_fwrite16be</a>,·<a
442 href="file.html#al_fwrite16le">al_fwrite16le</a>,·<a465 href="file.html#al_fwrite16le">al_fwrite16le</a>,·<a
443 href="file.html#al_fwrite32be">al_fwrite32be</a>,·<a466 href="file.html#al_fwrite32be">al_fwrite32be</a>,·<a
444 href="file.html#al_fwrite32le">al_fwrite32le</a></p>467 href="file.html#al_fwrite32le">al_fwrite32le</a></p>
445 <p>Examples:</p>468 <p>Examples:</p>
446 <ul>469 <ul>
447 <li><a470 <li><a
448 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_synth.cpp#L165">ex_synth.cpp</a></li> 
449 <li><a 
450 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_memfile.c#L44">ex_memfile.c</a></li>471 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_memfile.c#L44">ex_memfile.c</a></li>
451 <li><a472 <li><a
452 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file_slice.c#L20">ex_file_slice.c</a></li>473 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_file_slice.c#L20">ex_file_slice.c</a></li>
 474 <li><a
 475 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_synth.cpp#L165">ex_synth.cpp</a></li>
453 </ul>476 </ul>
454 <h1·id="al_fflush">al_fflush</h1>477 <h1·id="al_fflush">al_fflush</h1>
455 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_fflush<span·class="op">(</span>ALLEGRO_FILE·<span·class="op">*</span>f<span·class="op">)</span></span></code></pre></div>478 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_fflush<span·class="op">(</span>ALLEGRO_FILE·<span·class="op">*</span>f<span·class="op">)</span></span></code></pre></div>
456 <p><a479 <p><a
457 href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L138">Source480 href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L138">Source
Max diff block lines reached; 1157/9067 bytes (12.76%) of diff not shown.
6.56 KB
html2text {}
    
Offset 88, 14 lines modifiedOffset 88, 18 lines modified
88 These·functions·are·declared·in·the·main·Allegro·header·file:88 These·functions·are·declared·in·the·main·Allegro·header·file:
89 ·#include·<allegro5/allegro.h>89 ·#include·<allegro5/allegro.h>
90 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FI\x8IL\x8LE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*90 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FI\x8IL\x8LE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
91 typedef·struct·ALLEGRO_FILE·ALLEGRO_FILE;91 typedef·struct·ALLEGRO_FILE·ALLEGRO_FILE;
92 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e92 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
93 An·opaque·object·representing·an·open·file.·This·could·be·a·real·file·on·disk93 An·opaque·object·representing·an·open·file.·This·could·be·a·real·file·on·disk
94 or·a·virtual·file.94 or·a·virtual·file.
 95 Examples:
 96 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c
 97 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8r_\x8._\x8c
 98 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8._\x8c
95 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FI\x8IL\x8LE\x8E_\x8_I\x8IN\x8NT\x8TE\x8ER\x8RF\x8FA\x8AC\x8CE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*99 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FI\x8IL\x8LE\x8E_\x8_I\x8IN\x8NT\x8TE\x8ER\x8RF\x8FA\x8AC\x8CE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
96 typedef·struct·ALLEGRO_FILE_INTERFACE100 typedef·struct·ALLEGRO_FILE_INTERFACE
97 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e101 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
98 A·structure·containing·function·pointers·to·handle·a·type·of·“file”,·real·or102 A·structure·containing·function·pointers·to·handle·a·type·of·“file”,·real·or
99 virtual.·See·the·full·discussion·in·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e.103 virtual.·See·the·full·discussion·in·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e.
100 The·fields·are:104 The·fields·are:
101 void*·········(*fi_fopen)(const·char·*path,·const·char·*mode);105 void*·········(*fi_fopen)(const·char·*path,·const·char·*mode);
Offset 116, 21 lines modifiedOffset 120, 27 lines modified
116 with·the·file.·The·other·functions·can·access·that·data·by·calling120 with·the·file.·The·other·functions·can·access·that·data·by·calling
117 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8u_\x8s_\x8e_\x8r_\x8d_\x8a_\x8t_\x8a·on·the·file·handle.·If·fi_open·returns·NULL·then·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n121 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8u_\x8s_\x8e_\x8r_\x8d_\x8a_\x8t_\x8a·on·the·file·handle.·If·fi_open·returns·NULL·then·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n
118 will·also·return·NULL.122 will·also·return·NULL.
119 The·fi_fclose·function·must·clean·up·and·free·the·userdata,·but·Allegro·will123 The·fi_fclose·function·must·clean·up·and·free·the·userdata,·but·Allegro·will
120 free·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E·handle.124 free·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E·handle.
121 If·fi_fungetc·is·NULL,·then·Allegro’s·default·implementation·of·a·16·char·long125 If·fi_fungetc·is·NULL,·then·Allegro’s·default·implementation·of·a·16·char·long
122 buffer·will·be·used.126 buffer·will·be·used.
 127 Examples:
 128 ····*·_\x8e_\x8x_\x8__\x8c_\x8u_\x8r_\x8l_\x8._\x8c
123 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_S\x8SE\x8EE\x8EK\x8K·*\x8**\x8**\x8**\x8**\x8**\x8*129 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_S\x8SE\x8EE\x8EK\x8K·*\x8**\x8**\x8**\x8**\x8**\x8*
124 typedef·enum·ALLEGRO_SEEK130 typedef·enum·ALLEGRO_SEEK
125 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e131 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
126 ····*·ALLEGRO_SEEK_SET·-·seek·relative·to·beginning·of·file132 ····*·ALLEGRO_SEEK_SET·-·seek·relative·to·beginning·of·file
127 ····*·ALLEGRO_SEEK_CUR·-·seek·relative·to·current·file·position133 ····*·ALLEGRO_SEEK_CUR·-·seek·relative·to·current·file·position
128 ····*·ALLEGRO_SEEK_END·-·seek·relative·to·end·of·file134 ····*·ALLEGRO_SEEK_END·-·seek·relative·to·end·of·file
129 See·also:·_\x8a_\x8l_\x8__\x8f_\x8s_\x8e_\x8e_\x8k135 See·also:·_\x8a_\x8l_\x8__\x8f_\x8s_\x8e_\x8e_\x8k
 136 Examples:
 137 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c
 138 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8._\x8c
 139 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8s_\x8l_\x8i_\x8c_\x8e_\x8._\x8c
130 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fo\x8op\x8pe\x8en\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*140 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fo\x8op\x8pe\x8en\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
131 ALLEGRO_FILE·*al_fopen(const·char·*path,·const·char·*mode)141 ALLEGRO_FILE·*al_fopen(const·char·*path,·const·char·*mode)
132 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e142 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
133 Creates·and·opens·a·file·(real·or·virtual)·given·the·path·and·mode.·The·current143 Creates·and·opens·a·file·(real·or·virtual)·given·the·path·and·mode.·The·current
134 file·interface·is·used·to·open·the·file.144 file·interface·is·used·to·open·the·file.
135 Parameters:145 Parameters:
136 ····*·path·-·path·to·the·file·to·open146 ····*·path·-·path·to·the·file·to·open
Offset 144, 17 lines modifiedOffset 154, 17 lines modified
144 defined·to·be·equal·to·LF·either.)154 defined·to·be·equal·to·LF·either.)
145 Newline·translations·can·be·useful·for·text·files·but·is·disastrous·for·binary155 Newline·translations·can·be·useful·for·text·files·but·is·disastrous·for·binary
146 files.·To·avoid·this·behaviour·you·need·to·open·file·streams·in·binary·mode·by156 files.·To·avoid·this·behaviour·you·need·to·open·file·streams·in·binary·mode·by
147 using·a·mode·argument·containing·a·“b”,·e.g. “rb”,·“wb”.157 using·a·mode·argument·containing·a·“b”,·e.g. “rb”,·“wb”.
148 Returns·a·file·handle·on·success,·or·NULL·on·error.158 Returns·a·file·handle·on·success,·or·NULL·on·error.
149 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8f_\x8c_\x8l_\x8o_\x8s_\x8e.159 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8f_\x8c_\x8l_\x8o_\x8s_\x8e.
150 Examples:160 Examples:
151 ····*·_\x8e_\x8x_\x8__\x8s_\x8y_\x8n_\x8t_\x8h_\x8._\x8c_\x8p_\x8p 
152 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c161 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c
153 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8s_\x8l_\x8i_\x8c_\x8e_\x8._\x8c162 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8s_\x8l_\x8i_\x8c_\x8e_\x8._\x8c
 163 ····*·_\x8e_\x8x_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c
154 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fo\x8op\x8pe\x8en\x8n_\x8_i\x8in\x8nt\x8te\x8er\x8rf\x8fa\x8ac\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*164 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fo\x8op\x8pe\x8en\x8n_\x8_i\x8in\x8nt\x8te\x8er\x8rf\x8fa\x8ac\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
155 ALLEGRO_FILE·*al_fopen_interface(const·ALLEGRO_FILE_INTERFACE·*drv,165 ALLEGRO_FILE·*al_fopen_interface(const·ALLEGRO_FILE_INTERFACE·*drv,
156 ···const·char·*path,·const·char·*mode)166 ···const·char·*path,·const·char·*mode)
157 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e167 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
158 Opens·a·file·using·the·specified·interface,·instead·of·the·interface·set·with168 Opens·a·file·using·the·specified·interface,·instead·of·the·interface·set·with
159 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e.169 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e.
160 See·also:·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n170 See·also:·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n
Offset 194, 17 lines modifiedOffset 204, 17 lines modified
194 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8s_\x8l_\x8i_\x8c_\x8e_\x8._\x8c204 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8s_\x8l_\x8i_\x8c_\x8e_\x8._\x8c
195 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fc\x8cl\x8lo\x8os\x8se\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*205 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fc\x8cl\x8lo\x8os\x8se\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
196 bool·al_fclose(ALLEGRO_FILE·*f)206 bool·al_fclose(ALLEGRO_FILE·*f)
197 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e207 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
198 Close·the·given·file,·writing·any·buffered·output·data·(if·any).208 Close·the·given·file,·writing·any·buffered·output·data·(if·any).
199 Returns·true·on·success,·false·on·failure.·errno·is·set·to·indicate·the·error.209 Returns·true·on·success,·false·on·failure.·errno·is·set·to·indicate·the·error.
200 Examples:210 Examples:
201 ····*·_\x8e_\x8x_\x8__\x8s_\x8y_\x8n_\x8t_\x8h_\x8._\x8c_\x8p_\x8p 
202 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c211 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8._\x8c
203 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8._\x8c212 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8._\x8c
 213 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8s_\x8l_\x8i_\x8c_\x8e_\x8._\x8c
204 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*214 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
205 size_t·al_fread(ALLEGRO_FILE·*f,·void·*ptr,·size_t·size)215 size_t·al_fread(ALLEGRO_FILE·*f,·void·*ptr,·size_t·size)
206 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e216 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
207 Read·‘size’·bytes·into·the·buffer·pointed·to·by·‘ptr’,·from·the·given·file.217 Read·‘size’·bytes·into·the·buffer·pointed·to·by·‘ptr’,·from·the·given·file.
208 Returns·the·number·of·bytes·actually·read.·If·an·error·occurs,·or·the·end-of-218 Returns·the·number·of·bytes·actually·read.·If·an·error·occurs,·or·the·end-of-
209 file·is·reached,·the·return·value·is·a·short·byte·count·(or·zero).219 file·is·reached,·the·return·value·is·a·short·byte·count·(or·zero).
210 al_fread()·does·not·distinguish·between·EOF·and·other·errors.·Use·_\x8a_\x8l_\x8__\x8f_\x8e_\x8o_\x8f·and220 al_fread()·does·not·distinguish·between·EOF·and·other·errors.·Use·_\x8a_\x8l_\x8__\x8f_\x8e_\x8o_\x8f·and
Offset 219, 17 lines modifiedOffset 229, 17 lines modified
219 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e229 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
220 Write·‘size’·bytes·from·the·buffer·pointed·to·by·‘ptr’·into·the·given·file.230 Write·‘size’·bytes·from·the·buffer·pointed·to·by·‘ptr’·into·the·given·file.
221 Returns·the·number·of·bytes·actually·written.·If·an·error·occurs,·the·return231 Returns·the·number·of·bytes·actually·written.·If·an·error·occurs,·the·return
222 value·is·a·short·byte·count·(or·zero).232 value·is·a·short·byte·count·(or·zero).
223 See·also:·_\x8a_\x8l_\x8__\x8f_\x8p_\x8u_\x8t_\x8c,·_\x8a_\x8l_\x8__\x8f_\x8p_\x8u_\x8t_\x8s,·_\x8a_\x8l_\x8__\x8f_\x8w_\x8r_\x8i_\x8t_\x8e_\x81_\x86_\x8b_\x8e,·_\x8a_\x8l_\x8__\x8f_\x8w_\x8r_\x8i_\x8t_\x8e_\x81_\x86_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8f_\x8w_\x8r_\x8i_\x8t_\x8e_\x83_\x82_\x8b_\x8e,233 See·also:·_\x8a_\x8l_\x8__\x8f_\x8p_\x8u_\x8t_\x8c,·_\x8a_\x8l_\x8__\x8f_\x8p_\x8u_\x8t_\x8s,·_\x8a_\x8l_\x8__\x8f_\x8w_\x8r_\x8i_\x8t_\x8e_\x81_\x86_\x8b_\x8e,·_\x8a_\x8l_\x8__\x8f_\x8w_\x8r_\x8i_\x8t_\x8e_\x81_\x86_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8f_\x8w_\x8r_\x8i_\x8t_\x8e_\x83_\x82_\x8b_\x8e,
224 _\x8a_\x8l_\x8__\x8f_\x8w_\x8r_\x8i_\x8t_\x8e_\x83_\x82_\x8l_\x8e234 _\x8a_\x8l_\x8__\x8f_\x8w_\x8r_\x8i_\x8t_\x8e_\x83_\x82_\x8l_\x8e
225 Examples:235 Examples:
226 ····*·_\x8e_\x8x_\x8__\x8s_\x8y_\x8n_\x8t_\x8h_\x8._\x8c_\x8p_\x8p 
227 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8._\x8c236 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8._\x8c
228 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8s_\x8l_\x8i_\x8c_\x8e_\x8._\x8c237 ····*·_\x8e_\x8x_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8s_\x8l_\x8i_\x8c_\x8e_\x8._\x8c
 238 ····*·_\x8e_\x8x_\x8__\x8s_\x8y_\x8n_\x8t_\x8h_\x8._\x8c_\x8p_\x8p
229 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8ff\x8fl\x8lu\x8us\x8sh\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*239 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8ff\x8fl\x8lu\x8us\x8sh\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*
230 bool·al_fflush(ALLEGRO_FILE·*f)240 bool·al_fflush(ALLEGRO_FILE·*f)
231 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e241 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
232 Flush·any·pending·writes·to·the·given·file.242 Flush·any·pending·writes·to·the·given·file.
233 Returns·true·on·success,·false·otherwise.·errno·is·set·to·indicate·the·error.243 Returns·true·on·success,·false·otherwise.·errno·is·set·to·indicate·the·error.
234 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8e_\x8r_\x8r_\x8n_\x8o244 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8e_\x8r_\x8r_\x8n_\x8o
235 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8ft\x8te\x8el\x8ll\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*245 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8ft\x8te\x8el\x8ll\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*
Offset 502, 14 lines modifiedOffset 512, 16 lines modified
502 will·handle·the·following·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n·calls·for·the·current·thread.512 will·handle·the·following·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n·calls·for·the·current·thread.
503 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_f\x8fi\x8il\x8le\x8e_\x8_i\x8in\x8nt\x8te\x8er\x8rf\x8fa\x8ac\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8*513 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_n\x8ne\x8ew\x8w_\x8_f\x8fi\x8il\x8le\x8e_\x8_i\x8in\x8nt\x8te\x8er\x8rf\x8fa\x8ac\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8*
504 void·al_set_new_file_interface(const·ALLEGRO_FILE_INTERFACE·*file_interface)514 void·al_set_new_file_interface(const·ALLEGRO_FILE_INTERFACE·*file_interface)
505 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e515 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
506 Set·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E·table·for·the·calling·thread.·This·will·change516 Set·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E·table·for·the·calling·thread.·This·will·change
507 the·handler·for·later·calls·to·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n.517 the·handler·for·later·calls·to·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n.
508 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e.518 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e.
 519 Examples:
 520 ····*·_\x8e_\x8x_\x8__\x8c_\x8u_\x8r_\x8l_\x8._\x8c
509 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_s\x8st\x8ta\x8an\x8nd\x8da\x8ar\x8rd\x8d_\x8_f\x8fi\x8il\x8le\x8e_\x8_i\x8in\x8nt\x8te\x8er\x8rf\x8fa\x8ac\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8*521 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_s\x8st\x8ta\x8an\x8nd\x8da\x8ar\x8rd\x8d_\x8_f\x8fi\x8il\x8le\x8e_\x8_i\x8in\x8nt\x8te\x8er\x8rf\x8fa\x8ac\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8*
510 void·al_set_standard_file_interface(void)522 void·al_set_standard_file_interface(void)
511 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e523 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
512 Set·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E·table·to·the·default,·for·the·calling·thread.524 Set·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E·table·to·the·default,·for·the·calling·thread.
513 This·will·change·the·handler·for·later·calls·to·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n.525 This·will·change·the·handler·for·later·calls·to·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n.
514 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e526 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e
515 Examples:527 Examples:
67.0 KB
./usr/share/doc/allegro5-doc/refman/font.html
    
Offset 294, 14 lines modifiedOffset 294, 23 lines modified
294 <p>A·handle·identifying·any·kind·of·font.·Usually·you·will·create·it294 <p>A·handle·identifying·any·kind·of·font.·Usually·you·will·create·it
295 with·<a·href="font.html#al_load_font">al_load_font</a>·which·supports295 with·<a·href="font.html#al_load_font">al_load_font</a>·which·supports
296 loading·all·kinds·of·TrueType·fonts·supported·by·the·FreeType·library.296 loading·all·kinds·of·TrueType·fonts·supported·by·the·FreeType·library.
297 If·you·instead·pass·the·filename·of·a·bitmap·file,·it·will·be·loaded297 If·you·instead·pass·the·filename·of·a·bitmap·file,·it·will·be·loaded
298 with·<a·href="graphics.html#al_load_bitmap">al_load_bitmap</a>·and·a298 with·<a·href="graphics.html#al_load_bitmap">al_load_bitmap</a>·and·a
299 font·in·Allegro’s·bitmap·font·format·will·be·created·from·it·with·<a299 font·in·Allegro’s·bitmap·font·format·will·be·created·from·it·with·<a
300 href="font.html#al_grab_font_from_bitmap">al_grab_font_from_bitmap</a>.</p>300 href="font.html#al_grab_font_from_bitmap">al_grab_font_from_bitmap</a>.</p>
 301 <p>Examples:</p>
 302 <ul>
 303 <li><a
 304 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_disable_screensaver.c#L10">ex_disable_screensaver.c</a></li>
 305 <li><a
 306 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L17">ex_font_justify.cpp</a></li>
 307 <li><a
 308 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timedwait.c#L13">ex_timedwait.c</a></li>
 309 </ul>
301 <h2·id="allegro_glyph">ALLEGRO_GLYPH</h2>310 <h2·id="allegro_glyph">ALLEGRO_GLYPH</h2>
302 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_GLYPH·ALLEGRO_GLYPH<span·class="op">;</span></span></code></pre></div>311 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_GLYPH·ALLEGRO_GLYPH<span·class="op">;</span></span></code></pre></div>
303 <p><a312 <p><a
304 href="https://github.com/liballeg/allegro5/blob/master/addons/font/allegro5/allegro_font.h#L53">Source313 href="https://github.com/liballeg/allegro5/blob/master/addons/font/allegro5/allegro_font.h#L53">Source
305 Code</a></p>314 Code</a></p>
306 <p>A·structure·containing·the·properties·of·a·character·in·a·font.</p>315 <p>A·structure·containing·the·properties·of·a·character·in·a·font.</p>
307 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_GLYPH·<span·class="op">{</span></span>316 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_GLYPH·<span·class="op">{</span></span>
Offset 328, 14 lines modifiedOffset 337, 19 lines modified
328 to·the·next·character·in·a·string·and·includes·kerning.</p>337 to·the·next·character·in·a·string·and·includes·kerning.</p>
329 <p>Since:·5.2.1</p>338 <p>Since:·5.2.1</p>
330 <blockquote>339 <blockquote>
331 <p><em><a·href="getting_started.html#unstable-api">Unstable340 <p><em><a·href="getting_started.html#unstable-api">Unstable
332 API</a>:</em>·This·API·is·new·and·subject·to·refinement.</p>341 API</a>:</em>·This·API·is·new·and·subject·to·refinement.</p>
333 </blockquote>342 </blockquote>
334 <p>See·also:·<a·href="font.html#al_get_glyph">al_get_glyph</a></p>343 <p>See·also:·<a·href="font.html#al_get_glyph">al_get_glyph</a></p>
 344 <p>Examples:</p>
 345 <ul>
 346 <li><a
 347 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_ttf.c#L91">ex_ttf.c</a></li>
 348 </ul>
335 <h2·id="al_init_font_addon">al_init_font_addon</h2>349 <h2·id="al_init_font_addon">al_init_font_addon</h2>
336 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_init_font_addon<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>350 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_init_font_addon<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
337 <p><a351 <p><a
338 href="https://github.com/liballeg/allegro5/blob/master/addons/font/font.c#L367">Source352 href="https://github.com/liballeg/allegro5/blob/master/addons/font/font.c#L367">Source
339 Code</a></p>353 Code</a></p>
340 <p>Initialise·the·font·addon.</p>354 <p>Initialise·the·font·addon.</p>
341 <p>Note·that·if·you·intend·to·load·bitmap·fonts,·you·will·need·to355 <p>Note·that·if·you·intend·to·load·bitmap·fonts,·you·will·need·to
Offset 347, 14 lines modifiedOffset 361, 23 lines modified
347 function·has·no·return·value.·You·may·wish·to·avoid·checking·the·return361 function·has·no·return·value.·You·may·wish·to·avoid·checking·the·return
348 value·if·your·code·needs·to·be·compatible·with·Allegro·5.0.·Currently,362 value·if·your·code·needs·to·be·compatible·with·Allegro·5.0.·Currently,
349 the·function·will·never·return·false.</p>363 the·function·will·never·return·false.</p>
350 <p>See·also:·<a364 <p>See·also:·<a
351 href="image.html#al_init_image_addon">al_init_image_addon</a>,·<a365 href="image.html#al_init_image_addon">al_init_image_addon</a>,·<a
352 href="font.html#al_init_ttf_addon">al_init_ttf_addon</a>,·<a366 href="font.html#al_init_ttf_addon">al_init_ttf_addon</a>,·<a
353 href="font.html#al_shutdown_font_addon">al_shutdown_font_addon</a></p>367 href="font.html#al_shutdown_font_addon">al_shutdown_font_addon</a></p>
 368 <p>Examples:</p>
 369 <ul>
 370 <li><a
 371 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_disable_screensaver.c#L28">ex_disable_screensaver.c</a></li>
 372 <li><a
 373 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L104">ex_font_justify.cpp</a></li>
 374 <li><a
 375 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timedwait.c#L30">ex_timedwait.c</a></li>
 376 </ul>
354 <h2·id="al_is_font_addon_initialized">al_is_font_addon_initialized</h2>377 <h2·id="al_is_font_addon_initialized">al_is_font_addon_initialized</h2>
355 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_font_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>378 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_font_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
356 <p><a379 <p><a
357 href="https://github.com/liballeg/allegro5/blob/master/addons/font/font.c#L393">Source380 href="https://github.com/liballeg/allegro5/blob/master/addons/font/font.c#L393">Source
358 Code</a></p>381 Code</a></p>
359 <p>Returns·true·if·the·font·addon·is·initialized,·otherwise·returns382 <p>Returns·true·if·the·font·addon·is·initialized,·otherwise·returns
360 false.</p>383 false.</p>
Offset 385, 22 lines modifiedOffset 408, 40 lines modified
385 href="graphics.html#al_set_new_bitmap_flags">bitmap·flags</a>·at·the408 href="graphics.html#al_set_new_bitmap_flags">bitmap·flags</a>·at·the
386 time·the·font·is·loaded.</p>409 time·the·font·is·loaded.</p>
387 <p>See·also:·<a·href="font.html#al_destroy_font">al_destroy_font</a>,·<a410 <p>See·also:·<a·href="font.html#al_destroy_font">al_destroy_font</a>,·<a
388 href="font.html#al_init_font_addon">al_init_font_addon</a>,·<a411 href="font.html#al_init_font_addon">al_init_font_addon</a>,·<a
389 href="font.html#al_register_font_loader">al_register_font_loader</a>,·<a412 href="font.html#al_register_font_loader">al_register_font_loader</a>,·<a
390 href="font.html#al_load_bitmap_font_flags">al_load_bitmap_font_flags</a>,413 href="font.html#al_load_bitmap_font_flags">al_load_bitmap_font_flags</a>,
391 <a·href="font.html#al_load_ttf_font">al_load_ttf_font</a></p>414 <a·href="font.html#al_load_ttf_font">al_load_ttf_font</a></p>
 415 <p>Examples:</p>
 416 <ul>
 417 <li><a
 418 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L116">ex_font_justify.cpp</a></li>
 419 <li><a
 420 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_membmp.c#L104">ex_membmp.c</a></li>
 421 <li><a
 422 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_window_title.c#L60">ex_window_title.c</a></li>
 423 </ul>
392 <h2·id="al_destroy_font">al_destroy_font</h2>424 <h2·id="al_destroy_font">al_destroy_font</h2>
393 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_font<span·class="op">(</span>ALLEGRO_FONT·<span·class="op">*</span>f<span·class="op">)</span></span></code></pre></div>425 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_font<span·class="op">(</span>ALLEGRO_FONT·<span·class="op">*</span>f<span·class="op">)</span></span></code></pre></div>
394 <p><a426 <p><a
395 href="https://github.com/liballeg/allegro5/blob/master/addons/font/text.c#L357">Source427 href="https://github.com/liballeg/allegro5/blob/master/addons/font/text.c#L357">Source
396 Code</a></p>428 Code</a></p>
397 <p>Frees·the·memory·being·used·by·a·font·structure.·Does·nothing·if429 <p>Frees·the·memory·being·used·by·a·font·structure.·Does·nothing·if
398 passed·NULL.</p>430 passed·NULL.</p>
399 <p>See·also:·<a·href="font.html#al_load_font">al_load_font</a></p>431 <p>See·also:·<a·href="font.html#al_load_font">al_load_font</a></p>
 432 <p>Examples:</p>
 433 <ul>
 434 <li><a
 435 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_disable_screensaver.c#L67">ex_disable_screensaver.c</a></li>
 436 <li><a
 437 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L139">ex_font_justify.cpp</a></li>
 438 <li><a
 439 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_cpu.c#L86">ex_cpu.c</a></li>
 440 </ul>
400 <h2·id="al_register_font_loader">al_register_font_loader</h2>441 <h2·id="al_register_font_loader">al_register_font_loader</h2>
401 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_register_font_loader<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>extension<span·class="op">,</span></span>442 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_register_font_loader<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>extension<span·class="op">,</span></span>
402 <span·id="cb10-2"><a·href="#cb10-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_FONT·<span·class="op">*(*</span>load_font<span·class="op">)(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>filename<span·class="op">,</span>·<span·class="dt">int</span>·size<span·class="op">,</span>·<span·class="dt">int</span>·flags<span·class="op">))</span></span></code></pre></div>443 <span·id="cb10-2"><a·href="#cb10-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_FONT·<span·class="op">*(*</span>load_font<span·class="op">)(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>filename<span·class="op">,</span>·<span·class="dt">int</span>·size<span·class="op">,</span>·<span·class="dt">int</span>·flags<span·class="op">))</span></span></code></pre></div>
403 <p><a444 <p><a
404 href="https://github.com/liballeg/allegro5/blob/master/addons/font/font.c#L426">Source445 href="https://github.com/liballeg/allegro5/blob/master/addons/font/font.c#L426">Source
405 Code</a></p>446 Code</a></p>
406 <p>Informs·Allegro·of·a·new·font·file·type,·telling·it·how·to·load·files447 <p>Informs·Allegro·of·a·new·font·file·type,·telling·it·how·to·load·files
Offset 434, 53 lines modifiedOffset 475, 86 lines modified
434 ···············|········|475 ···············|········|
435 ···············descent··|476 ···············descent··|
436 ···············|········|477 ···············|········|
437 -------------------------</code></pre>478 -------------------------</code></pre>
438 <p>See·also:·<a479 <p>See·also:·<a
439 href="font.html#al_get_text_width">al_get_text_width</a>,·<a480 href="font.html#al_get_text_width">al_get_text_width</a>,·<a
440 href="font.html#al_get_text_dimensions">al_get_text_dimensions</a></p>481 href="font.html#al_get_text_dimensions">al_get_text_dimensions</a></p>
 482 <p>Examples:</p>
 483 <ul>
 484 <li><a
 485 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L78">ex_font_justify.cpp</a></li>
 486 <li><a
 487 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_membmp.c#L66">ex_membmp.c</a></li>
 488 <li><a
 489 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_warp.c#L54">ex_mouse_warp.c</a></li>
 490 </ul>
441 <h2·id="al_get_font_ascent">al_get_font_ascent</h2>491 <h2·id="al_get_font_ascent">al_get_font_ascent</h2>
442 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_font_ascent<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_FONT·<span·class="op">*</span>f<span·class="op">)</span></span></code></pre></div>492 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_font_ascent<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_FONT·<span·class="op">*</span>f<span·class="op">)</span></span></code></pre></div>
Max diff block lines reached; 33922/42137 bytes (80.50%) of diff not shown.
25.8 KB
html2text {}
    
Offset 103, 14 lines modifiedOffset 103, 18 lines modified
103 typedef·struct·ALLEGRO_FONT·ALLEGRO_FONT;103 typedef·struct·ALLEGRO_FONT·ALLEGRO_FONT;
104 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e104 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
105 A·handle·identifying·any·kind·of·font.·Usually·you·will·create·it·with105 A·handle·identifying·any·kind·of·font.·Usually·you·will·create·it·with
106 _\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8f_\x8o_\x8n_\x8t·which·supports·loading·all·kinds·of·TrueType·fonts·supported·by106 _\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8f_\x8o_\x8n_\x8t·which·supports·loading·all·kinds·of·TrueType·fonts·supported·by
107 the·FreeType·library.·If·you·instead·pass·the·filename·of·a·bitmap·file,·it107 the·FreeType·library.·If·you·instead·pass·the·filename·of·a·bitmap·file,·it
108 will·be·loaded·with·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p·and·a·font·in·Allegro’s·bitmap·font·format108 will·be·loaded·with·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p·and·a·font·in·Allegro’s·bitmap·font·format
109 will·be·created·from·it·with·_\x8a_\x8l_\x8__\x8g_\x8r_\x8a_\x8b_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p.109 will·be·created·from·it·with·_\x8a_\x8l_\x8__\x8g_\x8r_\x8a_\x8b_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p.
 110 Examples:
 111 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8s_\x8a_\x8b_\x8l_\x8e_\x8__\x8s_\x8c_\x8r_\x8e_\x8e_\x8n_\x8s_\x8a_\x8v_\x8e_\x8r_\x8._\x8c
 112 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8j_\x8u_\x8s_\x8t_\x8i_\x8f_\x8y_\x8._\x8c_\x8p_\x8p
 113 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8d_\x8w_\x8a_\x8i_\x8t_\x8._\x8c
110 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_G\x8GL\x8LY\x8YP\x8PH\x8H·*\x8**\x8**\x8**\x8**\x8*114 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_G\x8GL\x8LY\x8YP\x8PH\x8H·*\x8**\x8**\x8**\x8**\x8*
111 typedef·struct·ALLEGRO_GLYPH·ALLEGRO_GLYPH;115 typedef·struct·ALLEGRO_GLYPH·ALLEGRO_GLYPH;
112 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e116 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
113 A·structure·containing·the·properties·of·a·character·in·a·font.117 A·structure·containing·the·properties·of·a·character·in·a·font.
114 typedef·struct·ALLEGRO_GLYPH·{118 typedef·struct·ALLEGRO_GLYPH·{
115 ···ALLEGRO_BITMAP·*bitmap;···//·the·bitmap·the·character·is·on119 ···ALLEGRO_BITMAP·*bitmap;···//·the·bitmap·the·character·is·on
116 ···int·x;····················//·the·x·position·of·the·glyph·on·bitmap120 ···int·x;····················//·the·x·position·of·the·glyph·on·bitmap
Offset 131, 27 lines modifiedOffset 135, 33 lines modified
131 Glyphs·are·tightly·packed·onto·the·bitmap,·so·you·need·to·add·offset_x·and135 Glyphs·are·tightly·packed·onto·the·bitmap,·so·you·need·to·add·offset_x·and
132 offset_y·to·your·draw·position·for·the·text·to·look·right.136 offset_y·to·your·draw·position·for·the·text·to·look·right.
133 advance·is·the·number·of·pixels·to·add·to·your·x·position·to·advance·to·the137 advance·is·the·number·of·pixels·to·add·to·your·x·position·to·advance·to·the
134 next·character·in·a·string·and·includes·kerning.138 next·character·in·a·string·and·includes·kerning.
135 Since:·5.2.1139 Since:·5.2.1
136 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·This·API·is·new·and·subject·to·refinement.140 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·This·API·is·new·and·subject·to·refinement.
137 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8g_\x8l_\x8y_\x8p_\x8h141 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8g_\x8l_\x8y_\x8p_\x8h
 142 Examples:
 143 ····*·_\x8e_\x8x_\x8__\x8t_\x8t_\x8f_\x8._\x8c
138 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_f\x8fo\x8on\x8nt\x8t_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*144 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_f\x8fo\x8on\x8nt\x8t_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*
139 bool·al_init_font_addon(void)145 bool·al_init_font_addon(void)
140 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e146 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
141 Initialise·the·font·addon.147 Initialise·the·font·addon.
142 Note·that·if·you·intend·to·load·bitmap·fonts,·you·will·need·to·initialise148 Note·that·if·you·intend·to·load·bitmap·fonts,·you·will·need·to·initialise
143 allegro_image·separately·(unless·you·are·using·another·library·to·load·images).149 allegro_image·separately·(unless·you·are·using·another·library·to·load·images).
144 Similarly,·if·you·wish·to·load·truetype-fonts,·do·not·forget·to·also·call150 Similarly,·if·you·wish·to·load·truetype-fonts,·do·not·forget·to·also·call
145 _\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8t_\x8t_\x8f_\x8__\x8a_\x8d_\x8d_\x8o_\x8n.151 _\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8t_\x8t_\x8f_\x8__\x8a_\x8d_\x8d_\x8o_\x8n.
146 Returns·true·on·success,·false·on·failure.·On·the·5.0·branch,·this·function·has152 Returns·true·on·success,·false·on·failure.·On·the·5.0·branch,·this·function·has
147 no·return·value.·You·may·wish·to·avoid·checking·the·return·value·if·your·code153 no·return·value.·You·may·wish·to·avoid·checking·the·return·value·if·your·code
148 needs·to·be·compatible·with·Allegro·5.0.·Currently,·the·function·will·never154 needs·to·be·compatible·with·Allegro·5.0.·Currently,·the·function·will·never
149 return·false.155 return·false.
150 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8i_\x8m_\x8a_\x8g_\x8e_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8t_\x8t_\x8f_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8d_\x8d_\x8o_\x8n156 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8i_\x8m_\x8a_\x8g_\x8e_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8t_\x8t_\x8f_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8d_\x8d_\x8o_\x8n
 157 Examples:
 158 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8s_\x8a_\x8b_\x8l_\x8e_\x8__\x8s_\x8c_\x8r_\x8e_\x8e_\x8n_\x8s_\x8a_\x8v_\x8e_\x8r_\x8._\x8c
 159 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8j_\x8u_\x8s_\x8t_\x8i_\x8f_\x8y_\x8._\x8c_\x8p_\x8p
 160 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8d_\x8w_\x8a_\x8i_\x8t_\x8._\x8c
151 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_f\x8fo\x8on\x8nt\x8t_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8*161 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_f\x8fo\x8on\x8nt\x8t_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8*
152 bool·al_is_font_addon_initialized(void)162 bool·al_is_font_addon_initialized(void)
153 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e163 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
154 Returns·true·if·the·font·addon·is·initialized,·otherwise·returns·false.164 Returns·true·if·the·font·addon·is·initialized,·otherwise·returns·false.
155 Since:·5.2.6165 Since:·5.2.6
156 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8d_\x8d_\x8o_\x8n166 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8d_\x8d_\x8o_\x8n
157 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_f\x8fo\x8on\x8nt\x8t_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*167 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_f\x8fo\x8on\x8nt\x8t_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*
Offset 166, 19 lines modifiedOffset 176, 27 lines modified
166 Loads·a·font·from·disk.·This·will·use·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·if·you·pass·the176 Loads·a·font·from·disk.·This·will·use·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·if·you·pass·the
167 name·of·a·known·bitmap·format,·or·else·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8t_\x8t_\x8f_\x8__\x8f_\x8o_\x8n_\x8t.177 name·of·a·known·bitmap·format,·or·else·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8t_\x8t_\x8f_\x8__\x8f_\x8o_\x8n_\x8t.
168 The·flags·parameter·is·passed·through·to·either·of·those·functions.·Bitmap·and178 The·flags·parameter·is·passed·through·to·either·of·those·functions.·Bitmap·and
169 TTF·fonts·are·also·affected·by·the·current·_\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8·_\x8f_\x8l_\x8a_\x8g_\x8s·at·the·time·the·font·is179 TTF·fonts·are·also·affected·by·the·current·_\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8·_\x8f_\x8l_\x8a_\x8g_\x8s·at·the·time·the·font·is
170 loaded.180 loaded.
171 See·also:·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8f_\x8o_\x8n_\x8t,·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8l_\x8o_\x8a_\x8d_\x8e_\x8r,181 See·also:·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8f_\x8o_\x8n_\x8t,·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8l_\x8o_\x8a_\x8d_\x8e_\x8r,
172 _\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8f_\x8l_\x8a_\x8g_\x8s,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8t_\x8t_\x8f_\x8__\x8f_\x8o_\x8n_\x8t182 _\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8f_\x8l_\x8a_\x8g_\x8s,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8t_\x8t_\x8f_\x8__\x8f_\x8o_\x8n_\x8t
 183 Examples:
 184 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8j_\x8u_\x8s_\x8t_\x8i_\x8f_\x8y_\x8._\x8c_\x8p_\x8p
 185 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8b_\x8m_\x8p_\x8._\x8c
 186 ····*·_\x8e_\x8x_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8t_\x8i_\x8t_\x8l_\x8e_\x8._\x8c
173 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_f\x8fo\x8on\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8*187 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_f\x8fo\x8on\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8*
174 void·al_destroy_font(ALLEGRO_FONT·*f)188 void·al_destroy_font(ALLEGRO_FONT·*f)
175 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e189 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
176 Frees·the·memory·being·used·by·a·font·structure.·Does·nothing·if·passed·NULL.190 Frees·the·memory·being·used·by·a·font·structure.·Does·nothing·if·passed·NULL.
177 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8f_\x8o_\x8n_\x8t191 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8f_\x8o_\x8n_\x8t
 192 Examples:
 193 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8s_\x8a_\x8b_\x8l_\x8e_\x8__\x8s_\x8c_\x8r_\x8e_\x8e_\x8n_\x8s_\x8a_\x8v_\x8e_\x8r_\x8._\x8c
 194 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8j_\x8u_\x8s_\x8t_\x8i_\x8f_\x8y_\x8._\x8c_\x8p_\x8p
 195 ····*·_\x8e_\x8x_\x8__\x8c_\x8p_\x8u_\x8._\x8c
178 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8eg\x8gi\x8is\x8st\x8te\x8er\x8r_\x8_f\x8fo\x8on\x8nt\x8t_\x8_l\x8lo\x8oa\x8ad\x8de\x8er\x8r·*\x8**\x8**\x8**\x8**\x8*196 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8eg\x8gi\x8is\x8st\x8te\x8er\x8r_\x8_f\x8fo\x8on\x8nt\x8t_\x8_l\x8lo\x8oa\x8ad\x8de\x8er\x8r·*\x8**\x8**\x8**\x8**\x8*
179 bool·al_register_font_loader(char·const·*extension,197 bool·al_register_font_loader(char·const·*extension,
180 ···ALLEGRO_FONT·*(*load_font)(char·const·*filename,·int·size,·int·flags))198 ···ALLEGRO_FONT·*(*load_font)(char·const·*filename,·int·size,·int·flags))
181 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e199 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
182 Informs·Allegro·of·a·new·font·file·type,·telling·it·how·to·load·files·of·this200 Informs·Allegro·of·a·new·font·file·type,·telling·it·how·to·load·files·of·this
183 format.201 format.
184 The·extension·should·include·the·leading·dot·(‘.’)·character.·It·will·be202 The·extension·should·include·the·leading·dot·(‘.’)·character.·It·will·be
Offset 204, 34 lines modifiedOffset 222, 48 lines modified
204 /········\·····|········height222 /········\·····|········height
205 ----------------········|223 ----------------········|
206 ···············|········|224 ···············|········|
207 ···············descent··|225 ···············descent··|
208 ···············|········|226 ···············|········|
209 -------------------------227 -------------------------
210 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8w_\x8i_\x8d_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8d_\x8i_\x8m_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n_\x8s228 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8w_\x8i_\x8d_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8d_\x8i_\x8m_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n_\x8s
 229 Examples:
 230 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8j_\x8u_\x8s_\x8t_\x8i_\x8f_\x8y_\x8._\x8c_\x8p_\x8p
 231 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8b_\x8m_\x8p_\x8._\x8c
 232 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w_\x8a_\x8r_\x8p_\x8._\x8c
211 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_f\x8fo\x8on\x8nt\x8t_\x8_a\x8as\x8sc\x8ce\x8en\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8*233 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_f\x8fo\x8on\x8nt\x8t_\x8_a\x8as\x8sc\x8ce\x8en\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8*
212 int·al_get_font_ascent(const·ALLEGRO_FONT·*f)234 int·al_get_font_ascent(const·ALLEGRO_FONT·*f)
213 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e235 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
214 Returns·the·ascent·of·the·specified·font.236 Returns·the·ascent·of·the·specified·font.
215 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8d_\x8e_\x8s_\x8c_\x8e_\x8n_\x8t,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8l_\x8i_\x8n_\x8e_\x8__\x8h_\x8e_\x8i_\x8g_\x8h_\x8t237 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8d_\x8e_\x8s_\x8c_\x8e_\x8n_\x8t,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8l_\x8i_\x8n_\x8e_\x8__\x8h_\x8e_\x8i_\x8g_\x8h_\x8t
 238 Examples:
 239 ····*·_\x8e_\x8x_\x8__\x8t_\x8t_\x8f_\x8._\x8c
216 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_f\x8fo\x8on\x8nt\x8t_\x8_d\x8de\x8es\x8sc\x8ce\x8en\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8*240 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_f\x8fo\x8on\x8nt\x8t_\x8_d\x8de\x8es\x8sc\x8ce\x8en\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8*
217 int·al_get_font_descent(const·ALLEGRO_FONT·*f)241 int·al_get_font_descent(const·ALLEGRO_FONT·*f)
218 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e242 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
219 Returns·the·descent·of·the·specified·font.243 Returns·the·descent·of·the·specified·font.
220 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8s_\x8c_\x8e_\x8n_\x8t,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8l_\x8i_\x8n_\x8e_\x8__\x8h_\x8e_\x8i_\x8g_\x8h_\x8t244 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8a_\x8s_\x8c_\x8e_\x8n_\x8t,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8l_\x8i_\x8n_\x8e_\x8__\x8h_\x8e_\x8i_\x8g_\x8h_\x8t
 245 Examples:
 246 ····*·_\x8e_\x8x_\x8__\x8t_\x8t_\x8f_\x8._\x8c
221 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8te\x8ex\x8xt\x8t_\x8_w\x8wi\x8id\x8dt\x8th\x8h·*\x8**\x8**\x8**\x8**\x8*247 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8te\x8ex\x8xt\x8t_\x8_w\x8wi\x8id\x8dt\x8th\x8h·*\x8**\x8**\x8**\x8**\x8*
222 int·al_get_text_width(const·ALLEGRO_FONT·*f,·const·char·*str)248 int·al_get_text_width(const·ALLEGRO_FONT·*f,·const·char·*str)
223 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e249 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
224 Calculates·the·length·of·a·string·in·a·particular·font,·in·pixels.250 Calculates·the·length·of·a·string·in·a·particular·font,·in·pixels.
225 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8w_\x8i_\x8d_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8l_\x8i_\x8n_\x8e_\x8__\x8h_\x8e_\x8i_\x8g_\x8h_\x8t,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8d_\x8i_\x8m_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n_\x8s251 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8w_\x8i_\x8d_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8l_\x8i_\x8n_\x8e_\x8__\x8h_\x8e_\x8i_\x8g_\x8h_\x8t,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8d_\x8i_\x8m_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n_\x8s
 252 Examples:
 253 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n_\x8s_\x8._\x8c
 254 ····*·_\x8e_\x8x_\x8__\x8r_\x8e_\x8c_\x8o_\x8r_\x8d_\x8__\x8n_\x8a_\x8m_\x8e_\x8._\x8c
 255 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8g_\x8r_\x8a_\x8d_\x8i_\x8e_\x8n_\x8t_\x8._\x8c
226 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_u\x8us\x8st\x8tr\x8r_\x8_w\x8wi\x8id\x8dt\x8th\x8h·*\x8**\x8**\x8**\x8**\x8*256 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_u\x8us\x8st\x8tr\x8r_\x8_w\x8wi\x8id\x8dt\x8th\x8h·*\x8**\x8**\x8**\x8**\x8*
227 int·al_get_ustr_width(const·ALLEGRO_FONT·*f,·ALLEGRO_USTR·const·*ustr)257 int·al_get_ustr_width(const·ALLEGRO_FONT·*f,·ALLEGRO_USTR·const·*ustr)
228 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e258 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
229 Like·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8w_\x8i_\x8d_\x8t_\x8h·but·expects·an·ALLEGRO_USTR.259 Like·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8w_\x8i_\x8d_\x8t_\x8h·but·expects·an·ALLEGRO_USTR.
230 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8w_\x8i_\x8d_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8d_\x8i_\x8m_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n_\x8s260 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8w_\x8i_\x8d_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8d_\x8i_\x8m_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n_\x8s
 261 Examples:
 262 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
231 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_t\x8te\x8ex\x8xt\x8t·*\x8**\x8**\x8**\x8**\x8*263 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_t\x8te\x8ex\x8xt\x8t·*\x8**\x8**\x8**\x8**\x8*
232 void·al_draw_text(const·ALLEGRO_FONT·*font,264 void·al_draw_text(const·ALLEGRO_FONT·*font,
233 ···ALLEGRO_COLOR·color,·float·x,·float·y,·int·flags,265 ···ALLEGRO_COLOR·color,·float·x,·float·y,·int·flags,
234 ···char·const·*text)266 ···char·const·*text)
235 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e267 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
Max diff block lines reached; 18591/26398 bytes (70.43%) of diff not shown.
2.02 KB
./usr/share/doc/allegro5-doc/refman/fshook.html
    
Offset 250, 14 lines modifiedOffset 250, 21 lines modified
250 <p><a250 <p><a
251 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L37">Source251 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L37">Source
252 Code</a></p>252 Code</a></p>
253 <p>Opaque·filesystem·entry·object.·Represents·a·file·or·a·directory253 <p>Opaque·filesystem·entry·object.·Represents·a·file·or·a·directory
254 (check·with·<a254 (check·with·<a
255 href="fshook.html#al_get_fs_entry_mode">al_get_fs_entry_mode</a>).·There255 href="fshook.html#al_get_fs_entry_mode">al_get_fs_entry_mode</a>).·There
256 are·no·user·accessible·member·variables.</p>256 are·no·user·accessible·member·variables.</p>
 257 <p>Examples:</p>
 258 <ul>
 259 <li><a
 260 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_dir.c#L6">ex_dir.c</a></li>
 261 <li><a
 262 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_physfs.c#L37">ex_physfs.c</a></li>
 263 </ul>
257 <h1·id="allegro_file_mode">ALLEGRO_FILE_MODE</h1>264 <h1·id="allegro_file_mode">ALLEGRO_FILE_MODE</h1>
258 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_FILE_MODE</span></code></pre></div>265 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_FILE_MODE</span></code></pre></div>
259 <p><a266 <p><a
260 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L46">Source267 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L46">Source
261 Code</a></p>268 Code</a></p>
262 <p>Filesystem·modes/types</p>269 <p>Filesystem·modes/types</p>
263 <ul>270 <ul>
925 B
html2text {}
    
Offset 79, 14 lines modifiedOffset 79, 17 lines modified
79 filesystem·like·your·harddrive,·or·a·virtual·filesystem·like·a·.zip·archive·(or79 filesystem·like·your·harddrive,·or·a·virtual·filesystem·like·a·.zip·archive·(or
80 whatever·else·you·or·an·addon·makes·it·do).80 whatever·else·you·or·an·addon·makes·it·do).
81 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FS\x8S_\x8_E\x8EN\x8NT\x8TR\x8RY\x8Y·*\x8**\x8**\x8**\x8**\x8**\x8*81 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FS\x8S_\x8_E\x8EN\x8NT\x8TR\x8RY\x8Y·*\x8**\x8**\x8**\x8**\x8**\x8*
82 typedef·struct·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY;82 typedef·struct·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY;
83 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e83 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
84 Opaque·filesystem·entry·object.·Represents·a·file·or·a·directory·(check·with84 Opaque·filesystem·entry·object.·Represents·a·file·or·a·directory·(check·with
85 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8s_\x8__\x8e_\x8n_\x8t_\x8r_\x8y_\x8__\x8m_\x8o_\x8d_\x8e).·There·are·no·user·accessible·member·variables.85 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8f_\x8s_\x8__\x8e_\x8n_\x8t_\x8r_\x8y_\x8__\x8m_\x8o_\x8d_\x8e).·There·are·no·user·accessible·member·variables.
 86 Examples:
 87 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8r_\x8._\x8c
 88 ····*·_\x8e_\x8x_\x8__\x8p_\x8h_\x8y_\x8s_\x8f_\x8s_\x8._\x8c
86 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FI\x8IL\x8LE\x8E_\x8_M\x8MO\x8OD\x8DE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*89 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FI\x8IL\x8LE\x8E_\x8_M\x8MO\x8OD\x8DE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
87 typedef·enum·ALLEGRO_FILE_MODE90 typedef·enum·ALLEGRO_FILE_MODE
88 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e91 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
89 Filesystem·modes/types92 Filesystem·modes/types
90 ····*·ALLEGRO_FILEMODE_READ·-·Readable93 ····*·ALLEGRO_FILEMODE_READ·-·Readable
91 ····*·ALLEGRO_FILEMODE_WRITE·-·Writable94 ····*·ALLEGRO_FILEMODE_WRITE·-·Writable
92 ····*·ALLEGRO_FILEMODE_EXECUTE·-·Executable95 ····*·ALLEGRO_FILEMODE_EXECUTE·-·Executable
3.81 KB
./usr/share/doc/allegro5-doc/refman/fullscreen_mode.html
    
Offset 197, 14 lines modifiedOffset 197, 21 lines modified
197 <span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·refresh_rate<span·class="op">;</span>···<span·class="co">//·The·refresh·rate·of·the·mode</span></span>197 <span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·refresh_rate<span·class="op">;</span>···<span·class="co">//·The·refresh·rate·of·the·mode</span></span>
198 <span·id="cb3-6"><a·href="#cb3-6"·aria-hidden="true"·tabindex="-1"></a><span·class="op">}</span>·ALLEGRO_DISPLAY_MODE<span·class="op">;</span></span></code></pre></div>198 <span·id="cb3-6"><a·href="#cb3-6"·aria-hidden="true"·tabindex="-1"></a><span·class="op">}</span>·ALLEGRO_DISPLAY_MODE<span·class="op">;</span></span></code></pre></div>
199 <p>The·<code>refresh_rate</code>·may·be·zero·if·unknown.</p>199 <p>The·<code>refresh_rate</code>·may·be·zero·if·unknown.</p>
200 <p>For·an·explanation·of·what·<code>format</code>·means,·see·<a200 <p>For·an·explanation·of·what·<code>format</code>·means,·see·<a
201 href="graphics.html#allegro_pixel_format">ALLEGRO_PIXEL_FORMAT</a>.</p>201 href="graphics.html#allegro_pixel_format">ALLEGRO_PIXEL_FORMAT</a>.</p>
202 <p>See·also:·<a202 <p>See·also:·<a
203 href="fullscreen_mode.html#al_get_display_mode">al_get_display_mode</a></p>203 href="fullscreen_mode.html#al_get_display_mode">al_get_display_mode</a></p>
 204 <p>Examples:</p>
 205 <ul>
 206 <li><a
 207 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L33">ex_monitorinfo.c</a></li>
 208 <li><a
 209 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_display_options.c#L100">ex_display_options.c</a></li>
 210 </ul>
204 <h1·id="al_get_display_mode">al_get_display_mode</h1>211 <h1·id="al_get_display_mode">al_get_display_mode</h1>
205 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_DISPLAY_MODE·<span·class="op">*</span>al_get_display_mode<span·class="op">(</span><span·class="dt">int</span>·index<span·class="op">,</span>·ALLEGRO_DISPLAY_MODE·<span·class="op">*</span>mode<span·class="op">)</span></span></code></pre></div>212 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_DISPLAY_MODE·<span·class="op">*</span>al_get_display_mode<span·class="op">(</span><span·class="dt">int</span>·index<span·class="op">,</span>·ALLEGRO_DISPLAY_MODE·<span·class="op">*</span>mode<span·class="op">)</span></span></code></pre></div>
206 <p><a213 <p><a
207 href="https://github.com/liballeg/allegro5/blob/master/src/fullscreen_mode.c#L32">Source214 href="https://github.com/liballeg/allegro5/blob/master/src/fullscreen_mode.c#L32">Source
208 Code</a></p>215 Code</a></p>
209 <p>Retrieves·a·fullscreen·mode.·Display·parameters·should·not·be·changed216 <p>Retrieves·a·fullscreen·mode.·Display·parameters·should·not·be·changed
210 between·a·call·of·<a217 between·a·call·of·<a
Offset 244, 11 lines modifiedOffset 251, 14 lines modified
244 <p>Examples:</p>251 <p>Examples:</p>
245 <ul>252 <ul>
246 <li><a253 <li><a
247 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L32">ex_monitorinfo.c</a></li>254 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L32">ex_monitorinfo.c</a></li>
248 <li><a255 <li><a
249 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_display_options.c#L93">ex_display_options.c</a></li>256 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_display_options.c#L93">ex_display_options.c</a></li>
250 </ul>257 </ul>
 258 <p·class="timestamp">
 259 Allegro·version·5.2.10
 260 ·-·Last·updated:·2025-01-09·13:52:42·UTC
 261 </p>
251 </div>262 </div>
252 </body>263 </body>
253 </html>264 </html>
1.67 KB
html2text {}
    
Offset 58, 14 lines modifiedOffset 58, 17 lines modified
58 ···int·height;·········//·Screen·height58 ···int·height;·········//·Screen·height
59 ···int·format;·········//·The·pixel·format·of·the·mode59 ···int·format;·········//·The·pixel·format·of·the·mode
60 ···int·refresh_rate;···//·The·refresh·rate·of·the·mode60 ···int·refresh_rate;···//·The·refresh·rate·of·the·mode
61 }·ALLEGRO_DISPLAY_MODE;61 }·ALLEGRO_DISPLAY_MODE;
62 The·refresh_rate·may·be·zero·if·unknown.62 The·refresh_rate·may·be·zero·if·unknown.
63 For·an·explanation·of·what·format·means,·see·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8P_\x8I_\x8X_\x8E_\x8L_\x8__\x8F_\x8O_\x8R_\x8M_\x8A_\x8T.63 For·an·explanation·of·what·format·means,·see·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8P_\x8I_\x8X_\x8E_\x8L_\x8__\x8F_\x8O_\x8R_\x8M_\x8A_\x8T.
64 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e64 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e
 65 Examples:
 66 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c
 67 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n_\x8s_\x8._\x8c
65 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_m\x8mo\x8od\x8de\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*68 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_d\x8di\x8is\x8sp\x8pl\x8la\x8ay\x8y_\x8_m\x8mo\x8od\x8de\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
66 ALLEGRO_DISPLAY_MODE·*al_get_display_mode(int·index,·ALLEGRO_DISPLAY_MODE69 ALLEGRO_DISPLAY_MODE·*al_get_display_mode(int·index,·ALLEGRO_DISPLAY_MODE
67 *mode)70 *mode)
68 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e71 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
69 Retrieves·a·fullscreen·mode.·Display·parameters·should·not·be·changed·between·a72 Retrieves·a·fullscreen·mode.·Display·parameters·should·not·be·changed·between·a
70 call·of·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e_\x8s·and·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e.·index·must·be·between73 call·of·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e_\x8s·and·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e.·index·must·be·between
71 0·and·the·number·returned·from·al_get_num_display_modes-1.·mode·must·be·an74 0·and·the·number·returned·from·al_get_num_display_modes-1.·mode·must·be·an
Offset 83, 7 lines modifiedOffset 86, 8 lines modified
83 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8r_\x8e_\x8f_\x8r_\x8e_\x8s_\x8h_\x8__\x8r_\x8a_\x8t_\x8e,·and·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·to·find·the86 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8r_\x8e_\x8f_\x8r_\x8e_\x8s_\x8h_\x8__\x8r_\x8a_\x8t_\x8e,·and·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·to·find·the
84 number·of·modes·that·match.·Settings·the·new·display·parameters·to·zero·will87 number·of·modes·that·match.·Settings·the·new·display·parameters·to·zero·will
85 give·a·list·of·all·modes·for·the·default·driver.88 give·a·list·of·all·modes·for·the·default·driver.
86 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e89 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8m_\x8o_\x8d_\x8e
87 Examples:90 Examples:
88 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c91 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c
89 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n_\x8s_\x8._\x8c92 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8o_\x8p_\x8t_\x8i_\x8o_\x8n_\x8s_\x8._\x8c
 93 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC
132 KB
./usr/share/doc/allegro5-doc/refman/graphics.html
    
Offset 449, 51 lines modifiedOffset 449, 87 lines modified
449 <p><a449 <p><a
450 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/color.h#L13">Source450 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/color.h#L13">Source
451 Code</a></p>451 Code</a></p>
452 <p>An·ALLEGRO_COLOR·structure·describes·a·color·in·a·device·independent452 <p>An·ALLEGRO_COLOR·structure·describes·a·color·in·a·device·independent
453 way.·Use·<a·href="graphics.html#al_map_rgb">al_map_rgb</a>·et·al. and·<a453 way.·Use·<a·href="graphics.html#al_map_rgb">al_map_rgb</a>·et·al. and·<a
454 href="graphics.html#al_unmap_rgb">al_unmap_rgb</a>·et·al. to·translate454 href="graphics.html#al_unmap_rgb">al_unmap_rgb</a>·et·al. to·translate
455 from·and·to·various·color·representations.</p>455 from·and·to·various·color·representations.</p>
 456 <p>Examples:</p>
 457 <ul>
 458 <li><a
 459 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L15">ex_keyboard_focus.c</a></li>
 460 <li><a
 461 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_nodisplay.c#L13">ex_nodisplay.c</a></li>
 462 <li><a
 463 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L16">ex_mouse_focus.c</a></li>
 464 </ul>
456 <h2·id="al_map_rgb">al_map_rgb</h2>465 <h2·id="al_map_rgb">al_map_rgb</h2>
457 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_map_rgb<span·class="op">(</span></span>466 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_map_rgb<span·class="op">(</span></span>
458 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">unsigned</span>·<span·class="dt">char</span>·r<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·g<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·b<span·class="op">)</span></span></code></pre></div>467 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">unsigned</span>·<span·class="dt">char</span>·r<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·g<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·b<span·class="op">)</span></span></code></pre></div>
459 <p><a468 <p><a
460 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L575">Source469 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L575">Source
461 Code</a></p>470 Code</a></p>
462 <p>Convert·r,·g,·b·(ranging·from·0-255)·into·an·<a471 <p>Convert·r,·g,·b·(ranging·from·0-255)·into·an·<a
463 href="graphics.html#allegro_color">ALLEGRO_COLOR</a>,·using·255·for472 href="graphics.html#allegro_color">ALLEGRO_COLOR</a>,·using·255·for
464 alpha.</p>473 alpha.</p>
465 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>474 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>
466 <p>See·also:·<a·href="graphics.html#al_map_rgba">al_map_rgba</a>,·<a475 <p>See·also:·<a·href="graphics.html#al_map_rgba">al_map_rgba</a>,·<a
467 href="graphics.html#al_map_rgba_f">al_map_rgba_f</a>,·<a476 href="graphics.html#al_map_rgba_f">al_map_rgba_f</a>,·<a
468 href="graphics.html#al_map_rgb_f">al_map_rgb_f</a></p>477 href="graphics.html#al_map_rgb_f">al_map_rgb_f</a></p>
 478 <p>Examples:</p>
 479 <ul>
 480 <li><a
 481 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L33">ex_enet_server.c</a></li>
 482 <li><a
 483 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L49">ex_keyboard_focus.c</a></li>
 484 <li><a
 485 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_nodisplay.c#L37">ex_nodisplay.c</a></li>
 486 </ul>
469 <h2·id="al_map_rgb_f">al_map_rgb_f</h2>487 <h2·id="al_map_rgb_f">al_map_rgb_f</h2>
470 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_map_rgb_f<span·class="op">(</span><span·class="dt">float</span>·r<span·class="op">,</span>·<span·class="dt">float</span>·g<span·class="op">,</span>·<span·class="dt">float</span>·b<span·class="op">)</span></span></code></pre></div>488 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_map_rgb_f<span·class="op">(</span><span·class="dt">float</span>·r<span·class="op">,</span>·<span·class="dt">float</span>·g<span·class="op">,</span>·<span·class="dt">float</span>·b<span·class="op">)</span></span></code></pre></div>
471 <p><a489 <p><a
472 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L610">Source490 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L610">Source
473 Code</a></p>491 Code</a></p>
474 <p>Convert·r,·g,·b,·(ranging·from·0.0f-1.0f)·into·an·<a492 <p>Convert·r,·g,·b,·(ranging·from·0.0f-1.0f)·into·an·<a
475 href="graphics.html#allegro_color">ALLEGRO_COLOR</a>,·using·1.0f·for493 href="graphics.html#allegro_color">ALLEGRO_COLOR</a>,·using·1.0f·for
476 alpha.</p>494 alpha.</p>
477 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>495 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>
478 <p>See·also:·<a·href="graphics.html#al_map_rgba">al_map_rgba</a>,·<a496 <p>See·also:·<a·href="graphics.html#al_map_rgba">al_map_rgba</a>,·<a
479 href="graphics.html#al_map_rgb">al_map_rgb</a>,·<a497 href="graphics.html#al_map_rgb">al_map_rgb</a>,·<a
480 href="graphics.html#al_map_rgba_f">al_map_rgba_f</a></p>498 href="graphics.html#al_map_rgba_f">al_map_rgba_f</a></p>
 499 <p>Examples:</p>
 500 <ul>
 501 <li><a
 502 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L33">ex_enet_server.c</a></li>
 503 <li><a
 504 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_events.c#L128">ex_keyboard_events.c</a></li>
 505 <li><a
 506 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_drawpixels.c#L93">ex_drawpixels.c</a></li>
 507 </ul>
481 <h2·id="al_map_rgba">al_map_rgba</h2>508 <h2·id="al_map_rgba">al_map_rgba</h2>
482 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_map_rgba<span·class="op">(</span></span>509 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_map_rgba<span·class="op">(</span></span>
483 <span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">unsigned</span>·<span·class="dt">char</span>·r<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·g<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·b<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·a<span·class="op">)</span></span></code></pre></div>510 <span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">unsigned</span>·<span·class="dt">char</span>·r<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·g<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·b<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·a<span·class="op">)</span></span></code></pre></div>
484 <p><a511 <p><a
485 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L553">Source512 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L553">Source
486 Code</a></p>513 Code</a></p>
487 <p>Convert·r,·g,·b,·a·(ranging·from·0-255)·into·an·<a514 <p>Convert·r,·g,·b,·a·(ranging·from·0-255)·into·an·<a
488 href="graphics.html#allegro_color">ALLEGRO_COLOR</a>.</p>515 href="graphics.html#allegro_color">ALLEGRO_COLOR</a>.</p>
489 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>516 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>
490 <p>See·also:·<a·href="graphics.html#al_map_rgb">al_map_rgb</a>,·<a517 <p>See·also:·<a·href="graphics.html#al_map_rgb">al_map_rgb</a>,·<a
491 href="graphics.html#al_premul_rgba">al_premul_rgba</a>,·<a518 href="graphics.html#al_premul_rgba">al_premul_rgba</a>,·<a
492 href="graphics.html#al_map_rgb_f">al_map_rgb_f</a></p>519 href="graphics.html#al_map_rgb_f">al_map_rgb_f</a></p>
 520 <p>Examples:</p>
 521 <ul>
 522 <li><a
 523 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_nodisplay.c#L41">ex_nodisplay.c</a></li>
 524 <li><a
 525 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_drawpixels.c#L47">ex_drawpixels.c</a></li>
 526 <li><a
 527 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timedwait.c#L88">ex_timedwait.c</a></li>
 528 </ul>
493 <h2·id="al_premul_rgba">al_premul_rgba</h2>529 <h2·id="al_premul_rgba">al_premul_rgba</h2>
494 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_premul_rgba<span·class="op">(</span></span>530 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_premul_rgba<span·class="op">(</span></span>
495 <span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">unsigned</span>·<span·class="dt">char</span>·r<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·g<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·b<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·a<span·class="op">)</span></span></code></pre></div>531 <span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">unsigned</span>·<span·class="dt">char</span>·r<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·g<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·b<span·class="op">,</span>·<span·class="dt">unsigned</span>·<span·class="dt">char</span>·a<span·class="op">)</span></span></code></pre></div>
496 <p><a532 <p><a
497 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L564">Source533 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L564">Source
498 Code</a></p>534 Code</a></p>
499 <p>This·is·a·shortcut·for·<a535 <p>This·is·a·shortcut·for·<a
Offset 524, 14 lines modifiedOffset 560, 23 lines modified
524 Code</a></p>560 Code</a></p>
525 <p>Convert·r,·g,·b,·a·(ranging·from·0.0f-1.0f)·into·an·<a561 <p>Convert·r,·g,·b,·a·(ranging·from·0.0f-1.0f)·into·an·<a
526 href="graphics.html#allegro_color">ALLEGRO_COLOR</a>.</p>562 href="graphics.html#allegro_color">ALLEGRO_COLOR</a>.</p>
527 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>563 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>
528 <p>See·also:·<a·href="graphics.html#al_map_rgba">al_map_rgba</a>,·<a564 <p>See·also:·<a·href="graphics.html#al_map_rgba">al_map_rgba</a>,·<a
529 href="graphics.html#al_premul_rgba_f">al_premul_rgba_f</a>,·<a565 href="graphics.html#al_premul_rgba_f">al_premul_rgba_f</a>,·<a
530 href="graphics.html#al_map_rgb_f">al_map_rgb_f</a></p>566 href="graphics.html#al_map_rgb_f">al_map_rgb_f</a></p>
 567 <p>Examples:</p>
 568 <ul>
 569 <li><a
 570 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timedwait.c#L88">ex_timedwait.c</a></li>
 571 <li><a
 572 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_resize.c#L11">ex_resize.c</a></li>
 573 <li><a
 574 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_rotate.c#L127">ex_rotate.c</a></li>
 575 </ul>
531 <h2·id="al_premul_rgba_f">al_premul_rgba_f</h2>576 <h2·id="al_premul_rgba_f">al_premul_rgba_f</h2>
532 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_premul_rgba_f<span·class="op">(</span><span·class="dt">float</span>·r<span·class="op">,</span>·<span·class="dt">float</span>·g<span·class="op">,</span>·<span·class="dt">float</span>·b<span·class="op">,</span>·<span·class="dt">float</span>·a<span·class="op">)</span></span></code></pre></div>577 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_COLOR·al_premul_rgba_f<span·class="op">(</span><span·class="dt">float</span>·r<span·class="op">,</span>·<span·class="dt">float</span>·g<span·class="op">,</span>·<span·class="dt">float</span>·b<span·class="op">,</span>·<span·class="dt">float</span>·a<span·class="op">)</span></span></code></pre></div>
533 <p><a578 <p><a
534 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L597">Source579 href="https://github.com/liballeg/allegro5/blob/master/src/pixels.c#L597">Source
535 Code</a></p>580 Code</a></p>
536 <p>This·is·a·shortcut·for·<a581 <p>This·is·a·shortcut·for·<a
537 href="graphics.html#al_map_rgba_f">al_map_rgba_f</a>(r·*·a,·g·*·a,·b·*582 href="graphics.html#al_map_rgba_f">al_map_rgba_f</a>(r·*·a,·g·*·a,·b·*
Offset 562, 52 lines modifiedOffset 607, 82 lines modified
562 Code</a></p>607 Code</a></p>
563 <p>Retrieves·components·of·an·ALLEGRO_COLOR,·ignoring·alpha.·Components608 <p>Retrieves·components·of·an·ALLEGRO_COLOR,·ignoring·alpha.·Components
564 will·range·from·0-255.</p>609 will·range·from·0-255.</p>
565 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>610 <p>This·function·can·be·called·before·Allegro·is·initialized.</p>
566 <p>See·also:·<a·href="graphics.html#al_unmap_rgba">al_unmap_rgba</a>,·<a611 <p>See·also:·<a·href="graphics.html#al_unmap_rgba">al_unmap_rgba</a>,·<a
567 href="graphics.html#al_unmap_rgba_f">al_unmap_rgba_f</a>,·<a612 href="graphics.html#al_unmap_rgba_f">al_unmap_rgba_f</a>,·<a
568 href="graphics.html#al_unmap_rgb_f">al_unmap_rgb_f</a></p>613 href="graphics.html#al_unmap_rgb_f">al_unmap_rgb_f</a></p>
 614 <p>Examples:</p>
 615 <ul>
 616 <li><a
 617 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend_test.c#L16">ex_blend_test.c</a></li>
 618 <li><a
 619 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haiku.c#L399">ex_haiku.c</a></li>
 620 <li><a
 621 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color_gradient.c#L107">ex_color_gradient.c</a></li>
Max diff block lines reached; 70960/79353 bytes (89.42%) of diff not shown.
54.0 KB
html2text {}
    
Offset 175, 36 lines modifiedOffset 175, 52 lines modified
175 *\x8**\x8**\x8**\x8**\x8**\x8*·C\x8Co\x8ol\x8lo\x8or\x8rs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*175 *\x8**\x8**\x8**\x8**\x8**\x8*·C\x8Co\x8ol\x8lo\x8or\x8rs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
176 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8OL\x8LO\x8OR\x8R·*\x8**\x8**\x8**\x8**\x8*176 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8OL\x8LO\x8OR\x8R·*\x8**\x8**\x8**\x8**\x8*
177 typedef·struct·ALLEGRO_COLOR·ALLEGRO_COLOR;177 typedef·struct·ALLEGRO_COLOR·ALLEGRO_COLOR;
178 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e178 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
179 An·ALLEGRO_COLOR·structure·describes·a·color·in·a·device·independent·way.·Use179 An·ALLEGRO_COLOR·structure·describes·a·color·in·a·device·independent·way.·Use
180 _\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b·et·al. and·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b·et·al. to·translate·from·and·to·various180 _\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b·et·al. and·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b·et·al. to·translate·from·and·to·various
181 color·representations.181 color·representations.
 182 Examples:
 183 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 184 ····*·_\x8e_\x8x_\x8__\x8n_\x8o_\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8._\x8c
 185 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
182 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8*186 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8b·*\x8**\x8**\x8**\x8**\x8*
183 ALLEGRO_COLOR·al_map_rgb(187 ALLEGRO_COLOR·al_map_rgb(
184 ···unsigned·char·r,·unsigned·char·g,·unsigned·char·b)188 ···unsigned·char·r,·unsigned·char·g,·unsigned·char·b)
185 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e189 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
186 Convert·r,·g,·b·(ranging·from·0-255)·into·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R,·using·255·for190 Convert·r,·g,·b·(ranging·from·0-255)·into·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R,·using·255·for
187 alpha.191 alpha.
188 This·function·can·be·called·before·Allegro·is·initialized.192 This·function·can·be·called·before·Allegro·is·initialized.
189 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f193 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f
 194 Examples:
 195 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 196 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 197 ····*·_\x8e_\x8x_\x8__\x8n_\x8o_\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8._\x8c
190 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8b_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*198 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8b_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*
191 ALLEGRO_COLOR·al_map_rgb_f(float·r,·float·g,·float·b)199 ALLEGRO_COLOR·al_map_rgb_f(float·r,·float·g,·float·b)
192 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e200 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
193 Convert·r,·g,·b,·(ranging·from·0.0f-1.0f)·into·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R,·using·1.0f·for201 Convert·r,·g,·b,·(ranging·from·0.0f-1.0f)·into·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R,·using·1.0f·for
194 alpha.202 alpha.
195 This·function·can·be·called·before·Allegro·is·initialized.203 This·function·can·be·called·before·Allegro·is·initialized.
196 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f204 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f
 205 Examples:
 206 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 207 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 208 ····*·_\x8e_\x8x_\x8__\x8d_\x8r_\x8a_\x8w_\x8p_\x8i_\x8x_\x8e_\x8l_\x8s_\x8._\x8c
197 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8ba\x8a·*\x8**\x8**\x8**\x8**\x8*209 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8ba\x8a·*\x8**\x8**\x8**\x8**\x8*
198 ALLEGRO_COLOR·al_map_rgba(210 ALLEGRO_COLOR·al_map_rgba(
199 ···unsigned·char·r,·unsigned·char·g,·unsigned·char·b,·unsigned·char·a)211 ···unsigned·char·r,·unsigned·char·g,·unsigned·char·b,·unsigned·char·a)
200 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e212 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
201 Convert·r,·g,·b,·a·(ranging·from·0-255)·into·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R.213 Convert·r,·g,·b,·a·(ranging·from·0-255)·into·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R.
202 This·function·can·be·called·before·Allegro·is·initialized.214 This·function·can·be·called·before·Allegro·is·initialized.
203 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8p_\x8r_\x8e_\x8m_\x8u_\x8l_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f215 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8p_\x8r_\x8e_\x8m_\x8u_\x8l_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f
 216 Examples:
 217 ····*·_\x8e_\x8x_\x8__\x8n_\x8o_\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8._\x8c
 218 ····*·_\x8e_\x8x_\x8__\x8d_\x8r_\x8a_\x8w_\x8p_\x8i_\x8x_\x8e_\x8l_\x8s_\x8._\x8c
 219 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8d_\x8w_\x8a_\x8i_\x8t_\x8._\x8c
204 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_p\x8pr\x8re\x8em\x8mu\x8ul\x8l_\x8_r\x8rg\x8gb\x8ba\x8a·*\x8**\x8**\x8**\x8**\x8*220 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_p\x8pr\x8re\x8em\x8mu\x8ul\x8l_\x8_r\x8rg\x8gb\x8ba\x8a·*\x8**\x8**\x8**\x8**\x8*
205 ALLEGRO_COLOR·al_premul_rgba(221 ALLEGRO_COLOR·al_premul_rgba(
206 ···unsigned·char·r,·unsigned·char·g,·unsigned·char·b,·unsigned·char·a)222 ···unsigned·char·r,·unsigned·char·g,·unsigned·char·b,·unsigned·char·a)
207 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e223 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
208 This·is·a·shortcut·for·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a(r·*·a·/·255,·g·*·a·/·255,·b·*·a·/·255,·a).224 This·is·a·shortcut·for·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a(r·*·a·/·255,·g·*·a·/·255,·b·*·a·/·255,·a).
209 By·default·Allegro·uses·pre-multiplied·alpha·for·transparent·blending·of225 By·default·Allegro·uses·pre-multiplied·alpha·for·transparent·blending·of
210 bitmaps·and·primitives·(see·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·for·a·discussion·of·that226 bitmaps·and·primitives·(see·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·for·a·discussion·of·that
Offset 223, 14 lines modifiedOffset 239, 18 lines modified
223 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8p_\x8r_\x8e_\x8m_\x8u_\x8l_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f239 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8p_\x8r_\x8e_\x8m_\x8u_\x8l_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f
224 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8ba\x8a_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*240 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8ba\x8a_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*
225 ALLEGRO_COLOR·al_map_rgba_f(float·r,·float·g,·float·b,·float·a)241 ALLEGRO_COLOR·al_map_rgba_f(float·r,·float·g,·float·b,·float·a)
226 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e242 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
227 Convert·r,·g,·b,·a·(ranging·from·0.0f-1.0f)·into·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R.243 Convert·r,·g,·b,·a·(ranging·from·0.0f-1.0f)·into·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R.
228 This·function·can·be·called·before·Allegro·is·initialized.244 This·function·can·be·called·before·Allegro·is·initialized.
229 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8p_\x8r_\x8e_\x8m_\x8u_\x8l_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f245 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8p_\x8r_\x8e_\x8m_\x8u_\x8l_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f
 246 Examples:
 247 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8d_\x8w_\x8a_\x8i_\x8t_\x8._\x8c
 248 ····*·_\x8e_\x8x_\x8__\x8r_\x8e_\x8s_\x8i_\x8z_\x8e_\x8._\x8c
 249 ····*·_\x8e_\x8x_\x8__\x8r_\x8o_\x8t_\x8a_\x8t_\x8e_\x8._\x8c
230 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_p\x8pr\x8re\x8em\x8mu\x8ul\x8l_\x8_r\x8rg\x8gb\x8ba\x8a_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*250 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_p\x8pr\x8re\x8em\x8mu\x8ul\x8l_\x8_r\x8rg\x8gb\x8ba\x8a_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*
231 ALLEGRO_COLOR·al_premul_rgba_f(float·r,·float·g,·float·b,·float·a)251 ALLEGRO_COLOR·al_premul_rgba_f(float·r,·float·g,·float·b,·float·a)
232 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e252 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
233 This·is·a·shortcut·for·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f(r·*·a,·g·*·a,·b·*·a,·a).253 This·is·a·shortcut·for·_\x8a_\x8l_\x8__\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f(r·*·a,·g·*·a,·b·*·a,·a).
234 By·default·Allegro·uses·pre-multiplied·alpha·for·transparent·blending·of254 By·default·Allegro·uses·pre-multiplied·alpha·for·transparent·blending·of
235 bitmaps·and·primitives·(see·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·for·a·discussion·of·that255 bitmaps·and·primitives·(see·_\x8a_\x8l_\x8__\x8l_\x8o_\x8a_\x8d_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·for·a·discussion·of·that
236 feature).·This·means·that·if·you·want·to·tint·a·bitmap·or·primitive·to·be256 feature).·This·means·that·if·you·want·to·tint·a·bitmap·or·primitive·to·be
Offset 250, 35 lines modifiedOffset 270, 48 lines modified
250 void·al_unmap_rgb(ALLEGRO_COLOR·color,270 void·al_unmap_rgb(ALLEGRO_COLOR·color,
251 ···unsigned·char·*r,·unsigned·char·*g,·unsigned·char·*b)271 ···unsigned·char·*r,·unsigned·char·*g,·unsigned·char·*b)
252 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e272 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
253 Retrieves·components·of·an·ALLEGRO_COLOR,·ignoring·alpha.·Components·will·range273 Retrieves·components·of·an·ALLEGRO_COLOR,·ignoring·alpha.·Components·will·range
254 from·0-255.274 from·0-255.
255 This·function·can·be·called·before·Allegro·is·initialized.275 This·function·can·be·called·before·Allegro·is·initialized.
256 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f276 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f
 277 Examples:
 278 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
 279 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8i_\x8k_\x8u_\x8._\x8c
 280 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8g_\x8r_\x8a_\x8d_\x8i_\x8e_\x8n_\x8t_\x8._\x8c
257 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nm\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8b_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*281 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nm\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8b_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*
258 void·al_unmap_rgb_f(ALLEGRO_COLOR·color,·float·*r,·float·*g,·float·*b)282 void·al_unmap_rgb_f(ALLEGRO_COLOR·color,·float·*r,·float·*g,·float·*b)
259 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e283 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
260 Retrieves·components·of·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R,·ignoring·alpha.·Components·will·range284 Retrieves·components·of·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R,·ignoring·alpha.·Components·will·range
261 from·0.0f-1.0f.285 from·0.0f-1.0f.
262 This·function·can·be·called·before·Allegro·is·initialized.286 This·function·can·be·called·before·Allegro·is·initialized.
263 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f287 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f
 288 Examples:
 289 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8i_\x8k_\x8u_\x8._\x8c
 290 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8g_\x8r_\x8a_\x8d_\x8i_\x8e_\x8n_\x8t_\x8._\x8c
264 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nm\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8ba\x8a·*\x8**\x8**\x8**\x8**\x8*291 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nm\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8ba\x8a·*\x8**\x8**\x8**\x8**\x8*
265 void·al_unmap_rgba(ALLEGRO_COLOR·color,292 void·al_unmap_rgba(ALLEGRO_COLOR·color,
266 ···unsigned·char·*r,·unsigned·char·*g,·unsigned·char·*b,·unsigned·char·*a)293 ···unsigned·char·*r,·unsigned·char·*g,·unsigned·char·*b,·unsigned·char·*a)
267 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e294 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
268 Retrieves·components·of·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R.·Components·will·range·from·0-255.295 Retrieves·components·of·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R.·Components·will·range·from·0-255.
269 This·function·can·be·called·before·Allegro·is·initialized.296 This·function·can·be·called·before·Allegro·is·initialized.
270 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f297 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a_\x8__\x8f,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f
 298 Examples:
 299 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
 300 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8g_\x8o_\x8._\x8c
271 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nm\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8ba\x8a_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*301 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8nm\x8ma\x8ap\x8p_\x8_r\x8rg\x8gb\x8ba\x8a_\x8_f\x8f·*\x8**\x8**\x8**\x8**\x8*
272 void·al_unmap_rgba_f(ALLEGRO_COLOR·color,302 void·al_unmap_rgba_f(ALLEGRO_COLOR·color,
273 ···float·*r,·float·*g,·float·*b,·float·*a)303 ···float·*r,·float·*g,·float·*b,·float·*a)
274 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e304 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
275 Retrieves·components·of·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R.·Components·will·range·from·0.0f-1.0f.305 Retrieves·components·of·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8C_\x8O_\x8L_\x8O_\x8R.·Components·will·range·from·0.0f-1.0f.
276 This·function·can·be·called·before·Allegro·is·initialized.306 This·function·can·be·called·before·Allegro·is·initialized.
277 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f307 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8a,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8m_\x8a_\x8p_\x8__\x8r_\x8g_\x8b_\x8__\x8f
 308 Examples:
 309 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
 310 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8g_\x8o_\x8._\x8c
278 *\x8**\x8**\x8**\x8**\x8**\x8*·L\x8Lo\x8oc\x8ck\x8ki\x8in\x8ng\x8g·a\x8an\x8nd\x8d·p\x8pi\x8ix\x8xe\x8el\x8l·f\x8fo\x8or\x8rm\x8ma\x8at\x8ts\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*311 *\x8**\x8**\x8**\x8**\x8**\x8*·L\x8Lo\x8oc\x8ck\x8ki\x8in\x8ng\x8g·a\x8an\x8nd\x8d·p\x8pi\x8ix\x8xe\x8el\x8l·f\x8fo\x8or\x8rm\x8ma\x8at\x8ts\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
279 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_L\x8LO\x8OC\x8CK\x8KE\x8ED\x8D_\x8_R\x8RE\x8EG\x8GI\x8IO\x8ON\x8N·*\x8**\x8**\x8**\x8**\x8*312 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_L\x8LO\x8OC\x8CK\x8KE\x8ED\x8D_\x8_R\x8RE\x8EG\x8GI\x8IO\x8ON\x8N·*\x8**\x8**\x8**\x8**\x8*
280 typedef·struct·ALLEGRO_LOCKED_REGION·ALLEGRO_LOCKED_REGION;313 typedef·struct·ALLEGRO_LOCKED_REGION·ALLEGRO_LOCKED_REGION;
281 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e314 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
282 Users·who·wish·to·manually·edit·or·read·from·a·bitmap·are·required·to·lock·it315 Users·who·wish·to·manually·edit·or·read·from·a·bitmap·are·required·to·lock·it
283 first.·The·ALLEGRO_LOCKED_REGION·structure·represents·the·locked·region·of·the316 first.·The·ALLEGRO_LOCKED_REGION·structure·represents·the·locked·region·of·the
284 bitmap.·This·call·will·work·with·any·bitmap,·including·memory·bitmaps.317 bitmap.·This·call·will·work·with·any·bitmap,·including·memory·bitmaps.
Offset 300, 14 lines modifiedOffset 333, 18 lines modified
300 ····*·p\x8pi\x8ix\x8xe\x8el\x8l_\x8_s\x8si\x8iz\x8ze\x8e·is·the·number·of·bytes·used·to·represent·a·single·block·of333 ····*·p\x8pi\x8ix\x8xe\x8el\x8l_\x8_s\x8si\x8iz\x8ze\x8e·is·the·number·of·bytes·used·to·represent·a·single·block·of
301 ······pixels·for·the·pixel·format·of·this·locked·region.·For·most·formats·(and334 ······pixels·for·the·pixel·format·of·this·locked·region.·For·most·formats·(and
302 ······historically,·this·used·to·be·true·for·all·formats),·this·is·just·the335 ······historically,·this·used·to·be·true·for·all·formats),·this·is·just·the
303 ······size·of·a·single·pixel,·but·for·blocked·pixel·formats·this·value·is336 ······size·of·a·single·pixel,·but·for·blocked·pixel·formats·this·value·is
304 ······different.337 ······different.
305 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8r_\x8e_\x8g_\x8i_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8l_\x8o_\x8c_\x8k_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p,338 See·also:·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p,·_\x8a_\x8l_\x8__\x8l_\x8o_\x8c_\x8k_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8__\x8r_\x8e_\x8g_\x8i_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8u_\x8n_\x8l_\x8o_\x8c_\x8k_\x8__\x8b_\x8i_\x8t_\x8m_\x8a_\x8p,
Max diff block lines reached; 47363/55295 bytes (85.66%) of diff not shown.
10.7 KB
./usr/share/doc/allegro5-doc/refman/haptic.html
    
Offset 265, 14 lines modifiedOffset 265, 21 lines modified
265 <p><em><a·href="getting_started.html#unstable-api">Unstable265 <p><em><a·href="getting_started.html#unstable-api">Unstable
266 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all266 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all
267 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from267 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from
268 users.</p>268 users.</p>
269 </blockquote>269 </blockquote>
270 <p>See·also:·<a270 <p>See·also:·<a
271 href="haptic.html#al_get_haptic_from_joystick">al_get_haptic_from_joystick</a></p>271 href="haptic.html#al_get_haptic_from_joystick">al_get_haptic_from_joystick</a></p>
 272 <p>Examples:</p>
 273 <ul>
 274 <li><a
 275 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L16">ex_haptic.c</a></li>
 276 <li><a
 277 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic2.cpp#L21">ex_haptic2.cpp</a></li>
 278 </ul>
272 <h1·id="allegro_haptic_constants">ALLEGRO_HAPTIC_CONSTANTS</h1>279 <h1·id="allegro_haptic_constants">ALLEGRO_HAPTIC_CONSTANTS</h1>
273 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">enum</span>·ALLEGRO_HAPTIC_CONSTANTS</span></code></pre></div>280 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">enum</span>·ALLEGRO_HAPTIC_CONSTANTS</span></code></pre></div>
274 <p><a281 <p><a
275 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L37">Source282 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L37">Source
276 Code</a></p>283 Code</a></p>
277 <p>This·enum·contains·flags·that·are·used·to·define·haptic·effects·and284 <p>This·enum·contains·flags·that·are·used·to·define·haptic·effects·and
278 capabilities.·If·the·flag·is·set·in·the·return·value·of·<a285 capabilities.·If·the·flag·is·set·in·the·return·value·of·<a
Offset 516, 14 lines modifiedOffset 523, 21 lines modified
516 <p>Since:·5.1.8</p>523 <p>Since:·5.1.8</p>
517 <blockquote>524 <blockquote>
518 <p><em><a·href="getting_started.html#unstable-api">Unstable525 <p><em><a·href="getting_started.html#unstable-api">Unstable
519 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all526 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all
520 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from527 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from
521 users.</p>528 users.</p>
522 </blockquote>529 </blockquote>
 530 <p>Examples:</p>
 531 <ul>
 532 <li><a
 533 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L16">ex_haptic.c</a></li>
 534 <li><a
 535 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic2.cpp#L22">ex_haptic2.cpp</a></li>
 536 </ul>
523 <h1·id="allegro_haptic_effect_id">ALLEGRO_HAPTIC_EFFECT_ID</h1>537 <h1·id="allegro_haptic_effect_id">ALLEGRO_HAPTIC_EFFECT_ID</h1>
524 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID<span·class="op">;</span></span></code></pre></div>538 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID<span·class="op">;</span></span></code></pre></div>
525 <p><a539 <p><a
526 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L183">Source540 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L183">Source
527 Code</a></p>541 Code</a></p>
528 <p>This·struct·is·used·as·a·handle·to·control·playback·of·a·haptic542 <p>This·struct·is·used·as·a·handle·to·control·playback·of·a·haptic
529 effect·and·should·be·considered·opaque.·Its·implementation·is·visible543 effect·and·should·be·considered·opaque.·Its·implementation·is·visible
Offset 531, 14 lines modifiedOffset 545, 21 lines modified
531 <p>Since:·5.1.8</p>545 <p>Since:·5.1.8</p>
532 <blockquote>546 <blockquote>
533 <p><em><a·href="getting_started.html#unstable-api">Unstable547 <p><em><a·href="getting_started.html#unstable-api">Unstable
534 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all548 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all
535 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from549 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from
536 users.</p>550 users.</p>
537 </blockquote>551 </blockquote>
 552 <p>Examples:</p>
 553 <ul>
 554 <li><a
 555 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L16">ex_haptic.c</a></li>
 556 <li><a
 557 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic2.cpp#L23">ex_haptic2.cpp</a></li>
 558 </ul>
538 <h1·id="al_install_haptic">al_install_haptic</h1>559 <h1·id="al_install_haptic">al_install_haptic</h1>
539 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_install_haptic<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>560 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_install_haptic<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
540 <p><a561 <p><a
541 href="https://github.com/liballeg/allegro5/blob/master/src/haptic.c#L34">Source562 href="https://github.com/liballeg/allegro5/blob/master/src/haptic.c#L34">Source
542 Code</a></p>563 Code</a></p>
543 <p>Installs·the·haptic·(force·feedback)·device·subsystem.·This·must·be564 <p>Installs·the·haptic·(force·feedback)·device·subsystem.·This·must·be
544 called·before·using·any·other·haptic-related·functions.·Returns·true·if565 called·before·using·any·other·haptic-related·functions.·Returns·true·if
Offset 792, 14 lines modifiedOffset 813, 21 lines modified
792 <p>Since:·5.1.8</p>813 <p>Since:·5.1.8</p>
793 <blockquote>814 <blockquote>
794 <p><em><a·href="getting_started.html#unstable-api">Unstable815 <p><em><a·href="getting_started.html#unstable-api">Unstable
795 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all816 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all
796 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from817 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from
797 users.</p>818 users.</p>
798 </blockquote>819 </blockquote>
 820 <p>Examples:</p>
 821 <ul>
 822 <li><a
 823 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L77">ex_haptic.c</a></li>
 824 <li><a
 825 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic2.cpp#L37">ex_haptic2.cpp</a></li>
 826 </ul>
799 <h1·id="al_is_haptic_active">al_is_haptic_active</h1>827 <h1·id="al_is_haptic_active">al_is_haptic_active</h1>
800 <div·class="sourceCode"·id="cb20"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb20-1"><a·href="#cb20-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_haptic_active<span·class="op">(</span>ALLEGRO_HAPTIC·<span·class="op">*</span>hap<span·class="op">)</span></span></code></pre></div>828 <div·class="sourceCode"·id="cb20"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb20-1"><a·href="#cb20-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_haptic_active<span·class="op">(</span>ALLEGRO_HAPTIC·<span·class="op">*</span>hap<span·class="op">)</span></span></code></pre></div>
801 <p><a829 <p><a
802 href="https://github.com/liballeg/allegro5/blob/master/src/haptic.c#L192">Source830 href="https://github.com/liballeg/allegro5/blob/master/src/haptic.c#L192">Source
803 Code</a></p>831 Code</a></p>
804 <p>Returns·true·if·the·haptic·device·can·currently·be·used,·false·if832 <p>Returns·true·if·the·haptic·device·can·currently·be·used,·false·if
805 not.</p>833 not.</p>
Offset 1201, 14 lines modifiedOffset 1229, 21 lines modified
1201 <p>Since:·5.1.8</p>1229 <p>Since:·5.1.8</p>
1202 <blockquote>1230 <blockquote>
1203 <p><em><a·href="getting_started.html#unstable-api">Unstable1231 <p><em><a·href="getting_started.html#unstable-api">Unstable
1204 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all1232 API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all
1205 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from1233 the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from
1206 users.</p>1234 users.</p>
1207 </blockquote>1235 </blockquote>
 1236 <p>Examples:</p>
 1237 <ul>
 1238 <li><a
 1239 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L77">ex_haptic.c</a></li>
 1240 <li><a
 1241 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic2.cpp#L456">ex_haptic2.cpp</a></li>
 1242 </ul>
1208 <h1·id="al_rumble_haptic">al_rumble_haptic</h1>1243 <h1·id="al_rumble_haptic">al_rumble_haptic</h1>
1209 <div·class="sourceCode"·id="cb36"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb36-1"><a·href="#cb36-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_rumble_haptic<span·class="op">(</span>ALLEGRO_HAPTIC·<span·class="op">*</span>hap<span·class="op">,</span></span>1244 <div·class="sourceCode"·id="cb36"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb36-1"><a·href="#cb36-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_rumble_haptic<span·class="op">(</span>ALLEGRO_HAPTIC·<span·class="op">*</span>hap<span·class="op">,</span></span>
1210 <span·id="cb36-2"><a·href="#cb36-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">double</span>·intensity<span·class="op">,</span>·<span·class="dt">double</span>·duration<span·class="op">,</span>·ALLEGRO_HAPTIC_EFFECT_ID·<span·class="op">*</span>id<span·class="op">)</span></span></code></pre></div>1245 <span·id="cb36-2"><a·href="#cb36-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">double</span>·intensity<span·class="op">,</span>·<span·class="dt">double</span>·duration<span·class="op">,</span>·ALLEGRO_HAPTIC_EFFECT_ID·<span·class="op">*</span>id<span·class="op">)</span></span></code></pre></div>
1211 <p><a1246 <p><a
1212 href="https://github.com/liballeg/allegro5/blob/master/src/haptic.c#L356">Source1247 href="https://github.com/liballeg/allegro5/blob/master/src/haptic.c#L356">Source
1213 Code</a></p>1248 Code</a></p>
1214 <p>Uploads·a·simple·rumble·effect·to·the·haptic·device·and·starts1249 <p>Uploads·a·simple·rumble·effect·to·the·haptic·device·and·starts
4.75 KB
html2text {}
    
Offset 90, 14 lines modifiedOffset 90, 17 lines modified
90 This·is·an·abstract·data·type·representing·a·haptic·device·that·supports·force90 This·is·an·abstract·data·type·representing·a·haptic·device·that·supports·force
91 feedback·or·vibration.91 feedback·or·vibration.
92 Since:·5.1.892 Since:·5.1.8
93 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for93 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for
94 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting94 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
95 ·····feedback·from·users.95 ·····feedback·from·users.
96 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k96 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k
 97 Examples:
 98 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 99 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x82_\x8._\x8c_\x8p_\x8p
97 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_H\x8HA\x8AP\x8PT\x8TI\x8IC\x8C_\x8_C\x8CO\x8ON\x8NS\x8ST\x8TA\x8AN\x8NT\x8TS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*100 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_H\x8HA\x8AP\x8PT\x8TI\x8IC\x8C_\x8_C\x8CO\x8ON\x8NS\x8ST\x8TA\x8AN\x8NT\x8TS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*
98 enum·ALLEGRO_HAPTIC_CONSTANTS101 enum·ALLEGRO_HAPTIC_CONSTANTS
99 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e102 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
100 This·enum·contains·flags·that·are·used·to·define·haptic·effects·and103 This·enum·contains·flags·that·are·used·to·define·haptic·effects·and
101 capabilities.·If·the·flag·is·set·in·the·return·value·of104 capabilities.·If·the·flag·is·set·in·the·return·value·of
102 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8__\x8c_\x8a_\x8p_\x8a_\x8b_\x8i_\x8l_\x8i_\x8t_\x8i_\x8e_\x8s,·it·means·the·device·supports·the·given·effect.·The105 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8__\x8c_\x8a_\x8p_\x8a_\x8b_\x8i_\x8l_\x8i_\x8t_\x8i_\x8e_\x8s,·it·means·the·device·supports·the·given·effect.·The
103 value·of·these·flags·should·be·set·into·a·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8H_\x8A_\x8P_\x8T_\x8I_\x8C_\x8__\x8E_\x8F_\x8F_\x8E_\x8C_\x8T·struct·to106 value·of·these·flags·should·be·set·into·a·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8H_\x8A_\x8P_\x8T_\x8I_\x8C_\x8__\x8E_\x8F_\x8F_\x8E_\x8C_\x8T·struct·to
Offset 283, 24 lines modifiedOffset 286, 30 lines modified
283 ······If·you·don’t·want·to·use·an·envelope,·then·set·all·four·fields·of286 ······If·you·don’t·want·to·use·an·envelope,·then·set·all·four·fields·of
284 ······data.envelope·to·0.0.·The·effect·will·then·play·back·at·full·intensity287 ······data.envelope·to·0.0.·The·effect·will·then·play·back·at·full·intensity
285 ······throughout·its·playback.288 ······throughout·its·playback.
286 Since:·5.1.8289 Since:·5.1.8
287 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for290 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for
288 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting291 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
289 ·····feedback·from·users.292 ·····feedback·from·users.
 293 Examples:
 294 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 295 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x82_\x8._\x8c_\x8p_\x8p
290 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_H\x8HA\x8AP\x8PT\x8TI\x8IC\x8C_\x8_E\x8EF\x8FF\x8FE\x8EC\x8CT\x8T_\x8_I\x8ID\x8D·*\x8**\x8**\x8**\x8**\x8**\x8*296 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_H\x8HA\x8AP\x8PT\x8TI\x8IC\x8C_\x8_E\x8EF\x8FF\x8FE\x8EC\x8CT\x8T_\x8_I\x8ID\x8D·*\x8**\x8**\x8**\x8**\x8**\x8*
291 typedef·struct·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID;297 typedef·struct·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID;
292 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e298 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
293 This·struct·is·used·as·a·handle·to·control·playback·of·a·haptic·effect·and299 This·struct·is·used·as·a·handle·to·control·playback·of·a·haptic·effect·and
294 should·be·considered·opaque.·Its·implementation·is·visible·merely·to·allow300 should·be·considered·opaque.·Its·implementation·is·visible·merely·to·allow
295 allocation·by·the·users·of·the·Allegro·library.301 allocation·by·the·users·of·the·Allegro·library.
296 Since:·5.1.8302 Since:·5.1.8
297 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for303 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for
298 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting304 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
299 ·····feedback·from·users.305 ·····feedback·from·users.
 306 Examples:
 307 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 308 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x82_\x8._\x8c_\x8p_\x8p
300 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_h\x8ha\x8ap\x8pt\x8ti\x8ic\x8c·*\x8**\x8**\x8**\x8**\x8**\x8*309 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_h\x8ha\x8ap\x8pt\x8ti\x8ic\x8c·*\x8**\x8**\x8**\x8**\x8**\x8*
301 bool·al_install_haptic(void)310 bool·al_install_haptic(void)
302 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e311 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
303 Installs·the·haptic·(force·feedback)·device·subsystem.·This·must·be·called312 Installs·the·haptic·(force·feedback)·device·subsystem.·This·must·be·called
304 before·using·any·other·haptic-related·functions.·Returns·true·if·the·haptics313 before·using·any·other·haptic-related·functions.·Returns·true·if·the·haptics
305 subsystem·could·be·initialized·correctly,·false·in·case·of·error.314 subsystem·could·be·initialized·correctly,·false·in·case·of·error.
306 For·portability·you·should·first·open·a·display·before·calling315 For·portability·you·should·first·open·a·display·before·calling
Offset 447, 14 lines modifiedOffset 456, 17 lines modified
447 Returns·true·on·success·or·false·if·the·haptic·device·couldn’t·be·released·for456 Returns·true·on·success·or·false·if·the·haptic·device·couldn’t·be·released·for
448 any·reason,·such·as·NULL·being·passed,·the·device·not·being·active·or·failure457 any·reason,·such·as·NULL·being·passed,·the·device·not·being·active·or·failure
449 in·the·driver.458 in·the·driver.
450 Since:·5.1.8459 Since:·5.1.8
451 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for460 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for
452 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting461 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
453 ·····feedback·from·users.462 ·····feedback·from·users.
 463 Examples:
 464 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 465 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x82_\x8._\x8c_\x8p_\x8p
454 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_h\x8ha\x8ap\x8pt\x8ti\x8ic\x8c_\x8_a\x8ac\x8ct\x8ti\x8iv\x8ve\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*466 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_h\x8ha\x8ap\x8pt\x8ti\x8ic\x8c_\x8_a\x8ac\x8ct\x8ti\x8iv\x8ve\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
455 bool·al_is_haptic_active(ALLEGRO_HAPTIC·*hap)467 bool·al_is_haptic_active(ALLEGRO_HAPTIC·*hap)
456 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e468 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
457 Returns·true·if·the·haptic·device·can·currently·be·used,·false·if·not.469 Returns·true·if·the·haptic·device·can·currently·be·used,·false·if·not.
458 Since:·5.1.8470 Since:·5.1.8
459 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for471 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for
460 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting472 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
Offset 682, 14 lines modifiedOffset 694, 17 lines modified
682 Returns·true·on·success,·false·if·the·effect·couldn’t·be·released·for·any694 Returns·true·on·success,·false·if·the·effect·couldn’t·be·released·for·any
683 reason·such·as·when·NULL·is·passed,·the·effect·is·not·active·or·failure·to695 reason·such·as·when·NULL·is·passed,·the·effect·is·not·active·or·failure·to
684 release·the·effect·by·the·driver.696 release·the·effect·by·the·driver.
685 Since:·5.1.8697 Since:·5.1.8
686 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for698 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Perhaps·could·be·simplified·due·to·limited·support·for
687 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting699 ·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
688 ·····feedback·from·users.700 ·····feedback·from·users.
 701 Examples:
 702 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 703 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x82_\x8._\x8c_\x8p_\x8p
689 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8ru\x8um\x8mb\x8bl\x8le\x8e_\x8_h\x8ha\x8ap\x8pt\x8ti\x8ic\x8c·*\x8**\x8**\x8**\x8**\x8**\x8*704 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8ru\x8um\x8mb\x8bl\x8le\x8e_\x8_h\x8ha\x8ap\x8pt\x8ti\x8ic\x8c·*\x8**\x8**\x8**\x8**\x8**\x8*
690 bool·al_rumble_haptic(ALLEGRO_HAPTIC·*hap,705 bool·al_rumble_haptic(ALLEGRO_HAPTIC·*hap,
691 ···double·intensity,·double·duration,·ALLEGRO_HAPTIC_EFFECT_ID·*id)706 ···double·intensity,·double·duration,·ALLEGRO_HAPTIC_EFFECT_ID·*id)
692 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e707 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
693 Uploads·a·simple·rumble·effect·to·the·haptic·device·and·starts·playback708 Uploads·a·simple·rumble·effect·to·the·haptic·device·and·starts·playback
694 immediately.·The·parameter·intensity·is·a·relative·magnitude·between·0.0·and709 immediately.·The·parameter·intensity·is·a·relative·magnitude·between·0.0·and
695 1.0·that·determines·the·intensity·of·the·rumble·effect.·The·duration·determines710 1.0·that·determines·the·intensity·of·the·rumble·effect.·The·duration·determines
2.55 KB
./usr/share/doc/allegro5-doc/refman/image.html
    
Offset 207, 14 lines modifiedOffset 207, 23 lines modified
207 installed·libraries,·but·are·not·guaranteed·and·should·not·be·assumed·to207 installed·libraries,·but·are·not·guaranteed·and·should·not·be·assumed·to
208 be·universally·available.</p>208 be·universally·available.</p>
209 <p>The·DDS·format·is·only·supported·to·load·from,·and·only·if·the·DDS209 <p>The·DDS·format·is·only·supported·to·load·from,·and·only·if·the·DDS
210 file·contains·textures·compressed·in·the·DXT1,·DXT3·and·DXT5·formats.210 file·contains·textures·compressed·in·the·DXT1,·DXT3·and·DXT5·formats.
211 Note·that·when·loading·a·DDS·file,·the·created·bitmap·will·always·be·a211 Note·that·when·loading·a·DDS·file,·the·created·bitmap·will·always·be·a
212 video·bitmap·and·will·have·the·pixel·format·matching·the·format·in·the212 video·bitmap·and·will·have·the·pixel·format·matching·the·format·in·the
213 file.</p>213 file.</p>
 214 <p>Examples:</p>
 215 <ul>
 216 <li><a
 217 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_convert.c#L29">ex_convert.c</a></li>
 218 <li><a
 219 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_nodisplay.c#L22">ex_nodisplay.c</a></li>
 220 <li><a
 221 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl_pixel_shader.c#L53">ex_opengl_pixel_shader.c</a></li>
 222 </ul>
214 <h1223 <h1
215 id="al_is_image_addon_initialized">al_is_image_addon_initialized</h1>224 id="al_is_image_addon_initialized">al_is_image_addon_initialized</h1>
216 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_image_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>225 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_image_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
217 <p><a226 <p><a
218 href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L169">Source227 href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L169">Source
219 Code</a></p>228 Code</a></p>
220 <p>Returns·true·if·the·image·addon·is·initialized,·otherwise·returns229 <p>Returns·true·if·the·image·addon·is·initialized,·otherwise·returns
1.1 KB
html2text {}
    
Offset 64, 14 lines modifiedOffset 64, 18 lines modified
64 Other·formats·may·be·available·depending·on·the·operating·system·and·installed64 Other·formats·may·be·available·depending·on·the·operating·system·and·installed
65 libraries,·but·are·not·guaranteed·and·should·not·be·assumed·to·be·universally65 libraries,·but·are·not·guaranteed·and·should·not·be·assumed·to·be·universally
66 available.66 available.
67 The·DDS·format·is·only·supported·to·load·from,·and·only·if·the·DDS·file67 The·DDS·format·is·only·supported·to·load·from,·and·only·if·the·DDS·file
68 contains·textures·compressed·in·the·DXT1,·DXT3·and·DXT5·formats.·Note·that·when68 contains·textures·compressed·in·the·DXT1,·DXT3·and·DXT5·formats.·Note·that·when
69 loading·a·DDS·file,·the·created·bitmap·will·always·be·a·video·bitmap·and·will69 loading·a·DDS·file,·the·created·bitmap·will·always·be·a·video·bitmap·and·will
70 have·the·pixel·format·matching·the·format·in·the·file.70 have·the·pixel·format·matching·the·format·in·the·file.
 71 Examples:
 72 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8v_\x8e_\x8r_\x8t_\x8._\x8c
 73 ····*·_\x8e_\x8x_\x8__\x8n_\x8o_\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8._\x8c
 74 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8i_\x8x_\x8e_\x8l_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
71 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_i\x8im\x8ma\x8ag\x8ge\x8e_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*75 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_i\x8im\x8ma\x8ag\x8ge\x8e_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
72 bool·al_is_image_addon_initialized(void)76 bool·al_is_image_addon_initialized(void)
73 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e77 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
74 Returns·true·if·the·image·addon·is·initialized,·otherwise·returns·false.78 Returns·true·if·the·image·addon·is·initialized,·otherwise·returns·false.
75 Since:·5.2.679 Since:·5.2.6
76 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_i\x8im\x8ma\x8ag\x8ge\x8e_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*80 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_i\x8im\x8ma\x8ag\x8ge\x8e_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
77 void·al_shutdown_image_addon(void)81 void·al_shutdown_image_addon(void)
1.04 KB
./usr/share/doc/allegro5-doc/refman/index.html
    
Offset 160, 14 lines modifiedOffset 160, 11 lines modified
160 <li><a·href="main.html">Main·addon</a></li>160 <li><a·href="main.html">Main·addon</a></li>
161 <li><a·href="memfile.html">Memfile·addon</a></li>161 <li><a·href="memfile.html">Memfile·addon</a></li>
162 <li><a·href="native_dialog.html">Native·dialogs·addon</a></li>162 <li><a·href="native_dialog.html">Native·dialogs·addon</a></li>
163 <li><a·href="physfs.html">PhysicsFS·addon</a></li>163 <li><a·href="physfs.html">PhysicsFS·addon</a></li>
164 <li><a·href="primitives.html">Primitives·addon</a></li>164 <li><a·href="primitives.html">Primitives·addon</a></li>
165 <li><a·href="video.html">Video·streaming·addon</a></li>165 <li><a·href="video.html">Video·streaming·addon</a></li>
166 </ul>166 </ul>
  
167 <p·class="timestamp"> 
168 Allegro·version·5.2.10 
169 ·-·Last·updated:·2025-01-09·13:52:42·UTC 
170 </p> 
171 </div>167 </div>
172 </body>168 </body>
173 </html>169 </html>
492 B
html2text {}
    
Offset 83, 8 lines modifiedOffset 83, 7 lines modified
83 ····*·_\x8I_\x8m_\x8a_\x8g_\x8e_\x8·_\x8I_\x8/_\x8O_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n83 ····*·_\x8I_\x8m_\x8a_\x8g_\x8e_\x8·_\x8I_\x8/_\x8O_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n
84 ····*·_\x8M_\x8a_\x8i_\x8n_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n84 ····*·_\x8M_\x8a_\x8i_\x8n_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n
85 ····*·_\x8M_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n85 ····*·_\x8M_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n
86 ····*·_\x8N_\x8a_\x8t_\x8i_\x8v_\x8e_\x8·_\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8s_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n86 ····*·_\x8N_\x8a_\x8t_\x8i_\x8v_\x8e_\x8·_\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8s_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n
87 ····*·_\x8P_\x8h_\x8y_\x8s_\x8i_\x8c_\x8s_\x8F_\x8S_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n87 ····*·_\x8P_\x8h_\x8y_\x8s_\x8i_\x8c_\x8s_\x8F_\x8S_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n
88 ····*·_\x8P_\x8r_\x8i_\x8m_\x8i_\x8t_\x8i_\x8v_\x8e_\x8s_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n88 ····*·_\x8P_\x8r_\x8i_\x8m_\x8i_\x8t_\x8i_\x8v_\x8e_\x8s_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n
89 ····*·_\x8V_\x8i_\x8d_\x8e_\x8o_\x8·_\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8i_\x8n_\x8g_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n89 ····*·_\x8V_\x8i_\x8d_\x8e_\x8o_\x8·_\x8s_\x8t_\x8r_\x8e_\x8a_\x8m_\x8i_\x8n_\x8g_\x8·_\x8a_\x8d_\x8d_\x8o_\x8n
90 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC 
32.8 KB
./usr/share/doc/allegro5-doc/refman/joystick.html
    
Offset 230, 28 lines modifiedOffset 230, 44 lines modified
230 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK·ALLEGRO_JOYSTICK<span·class="op">;</span></span></code></pre></div>230 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK·ALLEGRO_JOYSTICK<span·class="op">;</span></span></code></pre></div>
231 <p><a231 <p><a
232 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L39">Source232 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L39">Source
233 Code</a></p>233 Code</a></p>
234 <p>This·is·an·abstract·data·type·representing·a·physical·joystick.</p>234 <p>This·is·an·abstract·data·type·representing·a·physical·joystick.</p>
235 <p>See·also:·<a235 <p>See·also:·<a
236 href="joystick.html#al_get_joystick">al_get_joystick</a></p>236 href="joystick.html#al_get_joystick">al_get_joystick</a></p>
 237 <p>Examples:</p>
 238 <ul>
 239 <li><a
 240 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L14">ex_haptic.c</a></li>
 241 <li><a
 242 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_hotplugging.c#L7">ex_joystick_hotplugging.c</a></li>
 243 <li><a
 244 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_events.c#L32">ex_joystick_events.c</a></li>
 245 </ul>
237 <h1·id="allegro_joystick_state">ALLEGRO_JOYSTICK_STATE</h1>246 <h1·id="allegro_joystick_state">ALLEGRO_JOYSTICK_STATE</h1>
238 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK_STATE·ALLEGRO_JOYSTICK_STATE<span·class="op">;</span></span></code></pre></div>247 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK_STATE·ALLEGRO_JOYSTICK_STATE<span·class="op">;</span></span></code></pre></div>
239 <p><a248 <p><a
240 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L45">Source249 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L45">Source
241 Code</a></p>250 Code</a></p>
242 <p>This·is·a·structure·that·is·used·to·hold·a·“snapshot”·of·a·joystick’s251 <p>This·is·a·structure·that·is·used·to·hold·a·“snapshot”·of·a·joystick’s
243 axes·and·buttons·at·a·particular·instant.·All·fields·public·and252 axes·and·buttons·at·a·particular·instant.·All·fields·public·and
244 read-only.</p>253 read-only.</p>
245 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">struct</span>·<span·class="op">{</span></span>254 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">struct</span>·<span·class="op">{</span></span>
246 <span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·axis<span·class="op">[</span>num_axes<span·class="op">];</span>·············<span·class="co">//·-1.0·to·1.0</span></span>255 <span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·axis<span·class="op">[</span>num_axes<span·class="op">];</span>·············<span·class="co">//·-1.0·to·1.0</span></span>
247 <span·id="cb4-3"><a·href="#cb4-3"·aria-hidden="true"·tabindex="-1"></a><span·class="op">}</span>·stick<span·class="op">[</span>num_sticks<span·class="op">];</span></span>256 <span·id="cb4-3"><a·href="#cb4-3"·aria-hidden="true"·tabindex="-1"></a><span·class="op">}</span>·stick<span·class="op">[</span>num_sticks<span·class="op">];</span></span>
248 <span·id="cb4-4"><a·href="#cb4-4"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·button<span·class="op">[</span>num_buttons<span·class="op">];</span>·············<span·class="co">//·0·to·32767</span></span></code></pre></div>257 <span·id="cb4-4"><a·href="#cb4-4"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·button<span·class="op">[</span>num_buttons<span·class="op">];</span>·············<span·class="co">//·0·to·32767</span></span></code></pre></div>
249 <p>See·also:·<a258 <p>See·also:·<a
250 href="joystick.html#al_get_joystick_state">al_get_joystick_state</a></p>259 href="joystick.html#al_get_joystick_state">al_get_joystick_state</a></p>
 260 <p>Examples:</p>
 261 <ul>
 262 <li><a
 263 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_hotplugging.c#L38">ex_joystick_hotplugging.c</a></li>
 264 <li><a
 265 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_events.c#L34">ex_joystick_events.c</a></li>
 266 </ul>
251 <h1·id="allegro_joyflags">ALLEGRO_JOYFLAGS</h1>267 <h1·id="allegro_joyflags">ALLEGRO_JOYFLAGS</h1>
252 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">enum</span>·ALLEGRO_JOYFLAGS</span></code></pre></div>268 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">enum</span>·ALLEGRO_JOYFLAGS</span></code></pre></div>
253 <p><a269 <p><a
254 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L58">Source270 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L58">Source
255 Code</a></p>271 Code</a></p>
256 <ul>272 <ul>
257 <li>ALLEGRO_JOYFLAG_DIGITAL·-·the·stick·provides·digital·input</li>273 <li>ALLEGRO_JOYFLAG_DIGITAL·-·the·stick·provides·digital·input</li>
Offset 265, 14 lines modifiedOffset 281, 23 lines modified
265 <p><a281 <p><a
266 href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L40">Source282 href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L40">Source
267 Code</a></p>283 Code</a></p>
268 <p>Install·a·joystick·driver,·returning·true·if·successful.·If·a284 <p>Install·a·joystick·driver,·returning·true·if·successful.·If·a
269 joystick·driver·was·already·installed,·returns·true·immediately.</p>285 joystick·driver·was·already·installed,·returns·true·immediately.</p>
270 <p>See·also:·<a286 <p>See·also:·<a
271 href="joystick.html#al_uninstall_joystick">al_uninstall_joystick</a></p>287 href="joystick.html#al_uninstall_joystick">al_uninstall_joystick</a></p>
 288 <p>Examples:</p>
 289 <ul>
 290 <li><a
 291 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L101">ex_haptic.c</a></li>
 292 <li><a
 293 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_hotplugging.c#L77">ex_joystick_hotplugging.c</a></li>
 294 <li><a
 295 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_events.c#L239">ex_joystick_events.c</a></li>
 296 </ul>
272 <h1·id="al_uninstall_joystick">al_uninstall_joystick</h1>297 <h1·id="al_uninstall_joystick">al_uninstall_joystick</h1>
273 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_uninstall_joystick<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>298 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_uninstall_joystick<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
274 <p><a299 <p><a
275 href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L73">Source300 href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L73">Source
276 Code</a></p>301 Code</a></p>
277 <p>Uninstalls·the·active·joystick·driver.·All·outstanding·<a302 <p>Uninstalls·the·active·joystick·driver.·All·outstanding·<a
278 href="joystick.html#allegro_joystick">ALLEGRO_JOYSTICK</a>·structures303 href="joystick.html#allegro_joystick">ALLEGRO_JOYSTICK</a>·structures
Offset 319, 27 lines modifiedOffset 344, 45 lines modified
319 your·game·has·an·input·configuration·screen·or·similar,·you·may·wish·to344 your·game·has·an·input·configuration·screen·or·similar,·you·may·wish·to
320 call·<a345 call·<a
321 href="joystick.html#al_reconfigure_joysticks">al_reconfigure_joysticks</a>346 href="joystick.html#al_reconfigure_joysticks">al_reconfigure_joysticks</a>
322 when·entering·that·screen.</p>347 when·entering·that·screen.</p>
323 <p>See·also:·<a348 <p>See·also:·<a
324 href="joystick.html#al_get_joystick_event_source">al_get_joystick_event_source</a>,349 href="joystick.html#al_get_joystick_event_source">al_get_joystick_event_source</a>,
325 <a·href="events.html#allegro_event">ALLEGRO_EVENT</a></p>350 <a·href="events.html#allegro_event">ALLEGRO_EVENT</a></p>
 351 <p>Examples:</p>
 352 <ul>
 353 <li><a
 354 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_hotplugging.c#L127">ex_joystick_hotplugging.c</a></li>
 355 <li><a
 356 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_events.c#L199">ex_joystick_events.c</a></li>
 357 <li><a
 358 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic2.cpp#L470">ex_haptic2.cpp</a></li>
 359 </ul>
326 <h1·id="al_get_num_joysticks">al_get_num_joysticks</h1>360 <h1·id="al_get_num_joysticks">al_get_num_joysticks</h1>
327 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_num_joysticks<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>361 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_num_joysticks<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
328 <p><a362 <p><a
329 href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L138">Source363 href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L138">Source
330 Code</a></p>364 Code</a></p>
331 <p>Return·the·number·of·joysticks·currently·on·the·system·(or365 <p>Return·the·number·of·joysticks·currently·on·the·system·(or
332 potentially·on·the·system).·This·number·can·change·after·<a366 potentially·on·the·system).·This·number·can·change·after·<a
333 href="joystick.html#al_reconfigure_joysticks">al_reconfigure_joysticks</a>367 href="joystick.html#al_reconfigure_joysticks">al_reconfigure_joysticks</a>
334 is·called,·in·order·to·support·hotplugging.</p>368 is·called,·in·order·to·support·hotplugging.</p>
335 <p>Returns·0·if·there·is·no·joystick·driver·installed.</p>369 <p>Returns·0·if·there·is·no·joystick·driver·installed.</p>
336 <p>See·also:·<a370 <p>See·also:·<a
337 href="joystick.html#al_get_joystick">al_get_joystick</a>,·<a371 href="joystick.html#al_get_joystick">al_get_joystick</a>,·<a
338 href="joystick.html#al_get_joystick_active">al_get_joystick_active</a></p>372 href="joystick.html#al_get_joystick_active">al_get_joystick_active</a></p>
 373 <p>Examples:</p>
 374 <ul>
 375 <li><a
 376 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L110">ex_haptic.c</a></li>
 377 <li><a
 378 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_joystick_hotplugging.c#L95">ex_joystick_hotplugging.c</a></li>
 379 <li><a
 380 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic2.cpp#L56">ex_haptic2.cpp</a></li>
 381 </ul>
339 <h1·id="al_get_joystick">al_get_joystick</h1>382 <h1·id="al_get_joystick">al_get_joystick</h1>
340 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_JOYSTICK·<span·class="op">*</span>·al_get_joystick<span·class="op">(</span><span·class="dt">int</span>·num<span·class="op">)</span></span></code></pre></div>383 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_JOYSTICK·<span·class="op">*</span>·al_get_joystick<span·class="op">(</span><span·class="dt">int</span>·num<span·class="op">)</span></span></code></pre></div>
341 <p><a384 <p><a
342 href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L150">Source385 href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L150">Source
343 Code</a></p>386 Code</a></p>
344 <p>Get·a·handle·for·a·joystick·on·the·system.·The·number·may·be·from·0387 <p>Get·a·handle·for·a·joystick·on·the·system.·The·number·may·be·from·0
345 to·<a388 to·<a
Offset 352, 81 lines modifiedOffset 395, 130 lines modified
352 may·return·handles·in·a·different·order,·and·handles·which·represent395 may·return·handles·in·a·different·order,·and·handles·which·represent
353 disconnected·devices·will·not·be·returned.</p>396 disconnected·devices·will·not·be·returned.</p>
354 <p>See·also:·<a397 <p>See·also:·<a
355 href="joystick.html#al_get_num_joysticks">al_get_num_joysticks</a>,·<a398 href="joystick.html#al_get_num_joysticks">al_get_num_joysticks</a>,·<a
356 href="joystick.html#al_reconfigure_joysticks">al_reconfigure_joysticks</a>,399 href="joystick.html#al_reconfigure_joysticks">al_reconfigure_joysticks</a>,
357 <a400 <a
358 href="joystick.html#al_get_joystick_active">al_get_joystick_active</a></p>401 href="joystick.html#al_get_joystick_active">al_get_joystick_active</a></p>
 402 <p>Examples:</p>
 403 <ul>
 404 <li><a
 405 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haptic.c#L114">ex_haptic.c</a></li>
 406 <li><a
Max diff block lines reached; 12557/20844 bytes (60.24%) of diff not shown.
12.3 KB
html2text {}
    
Offset 74, 37 lines modifiedOffset 74, 48 lines modified
74 mutually·exclusive.·The·haptics·subsystem·will·use·the·same·driver·as·the74 mutually·exclusive.·The·haptics·subsystem·will·use·the·same·driver·as·the
75 joystick·system·does.75 joystick·system·does.
76 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_J\x8JO\x8OY\x8YS\x8ST\x8TI\x8IC\x8CK\x8K·*\x8**\x8**\x8**\x8**\x8**\x8*76 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_J\x8JO\x8OY\x8YS\x8ST\x8TI\x8IC\x8CK\x8K·*\x8**\x8**\x8**\x8**\x8**\x8*
77 typedef·struct·ALLEGRO_JOYSTICK·ALLEGRO_JOYSTICK;77 typedef·struct·ALLEGRO_JOYSTICK·ALLEGRO_JOYSTICK;
78 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e78 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
79 This·is·an·abstract·data·type·representing·a·physical·joystick.79 This·is·an·abstract·data·type·representing·a·physical·joystick.
80 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k80 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k
 81 Examples:
 82 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 83 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
 84 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
81 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_J\x8JO\x8OY\x8YS\x8ST\x8TI\x8IC\x8CK\x8K_\x8_S\x8ST\x8TA\x8AT\x8TE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*85 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_J\x8JO\x8OY\x8YS\x8ST\x8TI\x8IC\x8CK\x8K_\x8_S\x8ST\x8TA\x8AT\x8TE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
82 typedef·struct·ALLEGRO_JOYSTICK_STATE·ALLEGRO_JOYSTICK_STATE;86 typedef·struct·ALLEGRO_JOYSTICK_STATE·ALLEGRO_JOYSTICK_STATE;
83 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e87 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
84 This·is·a·structure·that·is·used·to·hold·a·“snapshot”·of·a·joystick’s·axes·and88 This·is·a·structure·that·is·used·to·hold·a·“snapshot”·of·a·joystick’s·axes·and
85 buttons·at·a·particular·instant.·All·fields·public·and·read-only.89 buttons·at·a·particular·instant.·All·fields·public·and·read-only.
86 struct·{90 struct·{
87 ···float·axis[num_axes];·············//·-1.0·to·1.091 ···float·axis[num_axes];·············//·-1.0·to·1.0
88 }·stick[num_sticks];92 }·stick[num_sticks];
89 int·button[num_buttons];·············//·0·to·3276793 int·button[num_buttons];·············//·0·to·32767
90 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8s_\x8t_\x8a_\x8t_\x8e94 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8s_\x8t_\x8a_\x8t_\x8e
 95 Examples:
 96 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
 97 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
91 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_J\x8JO\x8OY\x8YF\x8FL\x8LA\x8AG\x8GS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*98 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_J\x8JO\x8OY\x8YF\x8FL\x8LA\x8AG\x8GS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*
92 enum·ALLEGRO_JOYFLAGS99 enum·ALLEGRO_JOYFLAGS
93 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e100 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
94 ····*·ALLEGRO_JOYFLAG_DIGITAL·-·the·stick·provides·digital·input101 ····*·ALLEGRO_JOYFLAG_DIGITAL·-·the·stick·provides·digital·input
95 ····*·ALLEGRO_JOYFLAG_ANALOGUE·-·the·stick·provides·analogue·input102 ····*·ALLEGRO_JOYFLAG_ANALOGUE·-·the·stick·provides·analogue·input
96 (this·enum·is·a·holdover·from·the·old·API·and·may·be·removed)103 (this·enum·is·a·holdover·from·the·old·API·and·may·be·removed)
97 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8f_\x8l_\x8a_\x8g_\x8s104 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8f_\x8l_\x8a_\x8g_\x8s
98 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*105 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*
99 bool·al_install_joystick(void)106 bool·al_install_joystick(void)
100 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e107 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
101 Install·a·joystick·driver,·returning·true·if·successful.·If·a·joystick·driver108 Install·a·joystick·driver,·returning·true·if·successful.·If·a·joystick·driver
102 was·already·installed,·returns·true·immediately.109 was·already·installed,·returns·true·immediately.
103 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k110 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k
 111 Examples:
 112 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 113 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
 114 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
104 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*115 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*
105 void·al_uninstall_joystick(void)116 void·al_uninstall_joystick(void)
106 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e117 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
107 Uninstalls·the·active·joystick·driver.·All·outstanding·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8J_\x8O_\x8Y_\x8S_\x8T_\x8I_\x8C_\x8K118 Uninstalls·the·active·joystick·driver.·All·outstanding·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8J_\x8O_\x8Y_\x8S_\x8T_\x8I_\x8C_\x8K
108 structures·are·invalidated.·If·no·joystick·driver·was·active,·this·function119 structures·are·invalidated.·If·no·joystick·driver·was·active,·this·function
109 does·nothing.120 does·nothing.
110 This·function·is·automatically·called·when·Allegro·is·shut·down.121 This·function·is·automatically·called·when·Allegro·is·shut·down.
Offset 130, 102 lines modifiedOffset 141, 147 lines modified
130 again,·being·reused·to·represent·newly·connected·devices.141 again,·being·reused·to·represent·newly·connected·devices.
131 Returns·true·if·the·joystick·configuration·changed,·otherwise·returns·false.142 Returns·true·if·the·joystick·configuration·changed,·otherwise·returns·false.
132 It·is·possible·that·on·some·systems,·Allegro·won’t·be·able·to·generate143 It·is·possible·that·on·some·systems,·Allegro·won’t·be·able·to·generate
133 ALLEGRO_EVENT_JOYSTICK_CONFIGURATION·events.·If·your·game·has·an·input144 ALLEGRO_EVENT_JOYSTICK_CONFIGURATION·events.·If·your·game·has·an·input
134 configuration·screen·or·similar,·you·may·wish·to·call·_\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s145 configuration·screen·or·similar,·you·may·wish·to·call·_\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s
135 when·entering·that·screen.146 when·entering·that·screen.
136 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T147 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T
 148 Examples:
 149 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
 150 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 151 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x82_\x8._\x8c_\x8p_\x8p
137 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8nu\x8um\x8m_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8ks\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*152 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8nu\x8um\x8m_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8ks\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
138 int·al_get_num_joysticks(void)153 int·al_get_num_joysticks(void)
139 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e154 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
140 Return·the·number·of·joysticks·currently·on·the·system·(or·potentially·on·the155 Return·the·number·of·joysticks·currently·on·the·system·(or·potentially·on·the
141 system).·This·number·can·change·after·_\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s·is·called,·in156 system).·This·number·can·change·after·_\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s·is·called,·in
142 order·to·support·hotplugging.157 order·to·support·hotplugging.
143 Returns·0·if·there·is·no·joystick·driver·installed.158 Returns·0·if·there·is·no·joystick·driver·installed.
144 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8a_\x8c_\x8t_\x8i_\x8v_\x8e159 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8a_\x8c_\x8t_\x8i_\x8v_\x8e
 160 Examples:
 161 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 162 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
 163 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x82_\x8._\x8c_\x8p_\x8p
145 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*164 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*
146 ALLEGRO_JOYSTICK·*·al_get_joystick(int·num)165 ALLEGRO_JOYSTICK·*·al_get_joystick(int·num)
147 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e166 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
148 Get·a·handle·for·a·joystick·on·the·system.·The·number·may·be·from·0·to167 Get·a·handle·for·a·joystick·on·the·system.·The·number·may·be·from·0·to
149 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s-1.·If·successful·a·pointer·to·a·joystick·object·is168 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s-1.·If·successful·a·pointer·to·a·joystick·object·is
150 returned,·which·represents·a·physical·device.·Otherwise·NULL·is·returned.169 returned,·which·represents·a·physical·device.·Otherwise·NULL·is·returned.
151 The·handle·and·the·index·are·only·incidentally·linked.·After170 The·handle·and·the·index·are·only·incidentally·linked.·After
152 _\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s·is·called,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k·may·return·handles·in·a171 _\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s·is·called,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k·may·return·handles·in·a
153 different·order,·and·handles·which·represent·disconnected·devices·will·not·be172 different·order,·and·handles·which·represent·disconnected·devices·will·not·be
154 returned.173 returned.
155 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s,174 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s,
156 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8a_\x8c_\x8t_\x8i_\x8v_\x8e175 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8a_\x8c_\x8t_\x8i_\x8v_\x8e
 176 Examples:
 177 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 178 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
 179 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
157 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8el\x8le\x8ea\x8as\x8se\x8e_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*180 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8el\x8le\x8ea\x8as\x8se\x8e_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8**\x8*
158 void·al_release_joystick(ALLEGRO_JOYSTICK·*joy)181 void·al_release_joystick(ALLEGRO_JOYSTICK·*joy)
159 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e182 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
160 This·function·currently·does·nothing.183 This·function·currently·does·nothing.
161 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k184 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k
 185 Examples:
 186 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
162 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k_\x8_a\x8ac\x8ct\x8ti\x8iv\x8ve\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*187 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k_\x8_a\x8ac\x8ct\x8ti\x8iv\x8ve\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
163 bool·al_get_joystick_active(ALLEGRO_JOYSTICK·*joy)188 bool·al_get_joystick_active(ALLEGRO_JOYSTICK·*joy)
164 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e189 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
165 Return·if·the·joystick·handle·is·“active”,·i.e. in·the·current·configuration,190 Return·if·the·joystick·handle·is·“active”,·i.e. in·the·current·configuration,
166 the·handle·represents·some·physical·device·plugged·into·the·system.191 the·handle·represents·some·physical·device·plugged·into·the·system.
167 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k·returns·active·handles.·After·reconfiguration,·active·handles192 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k·returns·active·handles.·After·reconfiguration,·active·handles
168 may·become·inactive,·and·vice·versa.193 may·become·inactive,·and·vice·versa.
169 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s194 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8c_\x8o_\x8n_\x8f_\x8i_\x8g_\x8u_\x8r_\x8e_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8s
 195 Examples:
 196 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
170 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*197 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
171 const·char·*al_get_joystick_name(ALLEGRO_JOYSTICK·*joy)198 const·char·*al_get_joystick_name(ALLEGRO_JOYSTICK·*joy)
172 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e199 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
173 Return·the·name·of·the·given·joystick.200 Return·the·name·of·the·given·joystick.
174 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8a_\x8x_\x8i_\x8s_\x8__\x8n_\x8a_\x8m_\x8e,201 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8a_\x8x_\x8i_\x8s_\x8__\x8n_\x8a_\x8m_\x8e,
175 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8n_\x8a_\x8m_\x8e202 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8n_\x8a_\x8m_\x8e
 203 Examples:
 204 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8p_\x8t_\x8i_\x8c_\x8._\x8c
 205 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
 206 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
176 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k_\x8_s\x8st\x8ti\x8ic\x8ck\x8k_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*207 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k_\x8_s\x8st\x8ti\x8ic\x8ck\x8k_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
177 const·char·*al_get_joystick_stick_name(ALLEGRO_JOYSTICK·*joy,·int·stick)208 const·char·*al_get_joystick_stick_name(ALLEGRO_JOYSTICK·*joy,·int·stick)
178 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e209 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
179 Return·the·name·of·the·given·“stick”.·If·the·stick·doesn’t·exist,·NULL·is210 Return·the·name·of·the·given·“stick”.·If·the·stick·doesn’t·exist,·NULL·is
180 returned.211 returned.
181 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8a_\x8x_\x8i_\x8s_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8n_\x8u_\x8m_\x8__\x8s_\x8t_\x8i_\x8c_\x8k_\x8s212 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8a_\x8x_\x8i_\x8s_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8n_\x8u_\x8m_\x8__\x8s_\x8t_\x8i_\x8c_\x8k_\x8s
 213 Examples:
 214 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8h_\x8o_\x8t_\x8p_\x8l_\x8u_\x8g_\x8g_\x8i_\x8n_\x8g_\x8._\x8c
 215 ····*·_\x8e_\x8x_\x8__\x8j_\x8o_\x8y_\x8s_\x8t_\x8i_\x8c_\x8k_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
182 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k_\x8_a\x8ax\x8xi\x8is\x8s_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*216 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_j\x8jo\x8oy\x8ys\x8st\x8ti\x8ic\x8ck\x8k_\x8_a\x8ax\x8xi\x8is\x8s_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
183 const·char·*al_get_joystick_axis_name(ALLEGRO_JOYSTICK·*joy,·int·stick,·int217 const·char·*al_get_joystick_axis_name(ALLEGRO_JOYSTICK·*joy,·int·stick,·int
184 axis)218 axis)
Max diff block lines reached; 4543/12610 bytes (36.03%) of diff not shown.
14.0 KB
./usr/share/doc/allegro5-doc/refman/keyboard.html
    
Offset 212, 14 lines modifiedOffset 212, 23 lines modified
212 <ul>212 <ul>
213 <li>display·-·points·to·the·display·that·had·keyboard·focus·at·the·time213 <li>display·-·points·to·the·display·that·had·keyboard·focus·at·the·time
214 the·state·was·saved.·If·no·display·was·focused,·this·points·to214 the·state·was·saved.·If·no·display·was·focused,·this·points·to
215 NULL.</li>215 NULL.</li>
216 </ul>216 </ul>
217 <p>You·cannot·read·the·state·of·keys·directly.·Use·the·function·<a217 <p>You·cannot·read·the·state·of·keys·directly.·Use·the·function·<a
218 href="keyboard.html#al_key_down">al_key_down</a>.</p>218 href="keyboard.html#al_key_down">al_key_down</a>.</p>
 219 <p>Examples:</p>
 220 <ul>
 221 <li><a
 222 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L42">ex_d3d.cpp</a></li>
 223 <li><a
 224 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L4">ex_keyboard_focus.c</a></li>
 225 <li><a
 226 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L33">ex_mouse_focus.c</a></li>
 227 </ul>
219 <h1·id="key-codes">Key·codes</h1>228 <h1·id="key-codes">Key·codes</h1>
220 <p>The·constant·ALLEGRO_KEY_MAX·is·always·one·higher·than·the·highest229 <p>The·constant·ALLEGRO_KEY_MAX·is·always·one·higher·than·the·highest
221 key·code.·So·if·you·want·to·use·the·key·code·as·array·index·you·can·do230 key·code.·So·if·you·want·to·use·the·key·code·as·array·index·you·can·do
222 something·like·this:</p>231 something·like·this:</p>
223 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·pressed_keys<span·class="op">[</span>ALLEGRO_KEY_MAX<span·class="op">];</span></span>232 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·pressed_keys<span·class="op">[</span>ALLEGRO_KEY_MAX<span·class="op">];</span></span>
224 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a><span·class="co">//...</span></span>233 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a><span·class="co">//...</span></span>
225 <span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"·tabindex="-1"></a>pressed_keys<span·class="op">[</span>key_code<span·class="op">]</span>·<span·class="op">=</span>·<span·class="kw">true</span><span·class="op">;</span></span></code></pre></div>234 <span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"·tabindex="-1"></a>pressed_keys<span·class="op">[</span>key_code<span·class="op">]</span>·<span·class="op">=</span>·<span·class="kw">true</span><span·class="op">;</span></span></code></pre></div>
Offset 341, 14 lines modifiedOffset 350, 23 lines modified
341 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L121">Source350 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L121">Source
342 Code</a></p>351 Code</a></p>
343 <p>Install·a·keyboard·driver.·Returns·true·if·successful.·If·a·driver352 <p>Install·a·keyboard·driver.·Returns·true·if·successful.·If·a·driver
344 was·already·installed,·nothing·happens·and·true·is·returned.</p>353 was·already·installed,·nothing·happens·and·true·is·returned.</p>
345 <p>See·also:·<a354 <p>See·also:·<a
346 href="keyboard.html#al_uninstall_keyboard">al_uninstall_keyboard</a>,·<a355 href="keyboard.html#al_uninstall_keyboard">al_uninstall_keyboard</a>,·<a
347 href="keyboard.html#al_is_keyboard_installed">al_is_keyboard_installed</a></p>356 href="keyboard.html#al_is_keyboard_installed">al_is_keyboard_installed</a></p>
 357 <p>Examples:</p>
 358 <ul>
 359 <li><a
 360 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L34">ex_d3d.cpp</a></li>
 361 <li><a
 362 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L39">ex_keyboard_focus.c</a></li>
 363 <li><a
 364 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L44">ex_mouse_focus.c</a></li>
 365 </ul>
348 <h1·id="al_is_keyboard_installed">al_is_keyboard_installed</h1>366 <h1·id="al_is_keyboard_installed">al_is_keyboard_installed</h1>
349 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_keyboard_installed<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>367 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_keyboard_installed<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
350 <p><a368 <p><a
351 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L112">Source369 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L112">Source
352 Code</a></p>370 Code</a></p>
353 <p>Returns·true·if·<a371 <p>Returns·true·if·<a
354 href="keyboard.html#al_install_keyboard">al_install_keyboard</a>·was372 href="keyboard.html#al_install_keyboard">al_install_keyboard</a>·was
Offset 371, 14 lines modifiedOffset 389, 23 lines modified
371 Code</a></p>389 Code</a></p>
372 <p>Save·the·state·of·the·keyboard·specified·at·the·time·the·function·is390 <p>Save·the·state·of·the·keyboard·specified·at·the·time·the·function·is
373 called·into·the·structure·pointed·to·by·<em>ret_state</em>.</p>391 called·into·the·structure·pointed·to·by·<em>ret_state</em>.</p>
374 <p>See·also:·<a·href="keyboard.html#al_key_down">al_key_down</a>,·<a392 <p>See·also:·<a·href="keyboard.html#al_key_down">al_key_down</a>,·<a
375 href="keyboard.html#al_clear_keyboard_state">al_clear_keyboard_state</a>,393 href="keyboard.html#al_clear_keyboard_state">al_clear_keyboard_state</a>,
376 <a394 <a
377 href="keyboard.html#allegro_keyboard_state">ALLEGRO_KEYBOARD_STATE</a></p>395 href="keyboard.html#allegro_keyboard_state">ALLEGRO_KEYBOARD_STATE</a></p>
 396 <p>Examples:</p>
 397 <ul>
 398 <li><a
 399 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L107">ex_d3d.cpp</a></li>
 400 <li><a
 401 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L53">ex_keyboard_focus.c</a></li>
 402 <li><a
 403 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L94">ex_mouse_focus.c</a></li>
 404 </ul>
378 <h1·id="al_clear_keyboard_state">al_clear_keyboard_state</h1>405 <h1·id="al_clear_keyboard_state">al_clear_keyboard_state</h1>
379 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_clear_keyboard_state<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">)</span></span></code></pre></div>406 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_clear_keyboard_state<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">)</span></span></code></pre></div>
380 <p><a407 <p><a
381 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L262">Source408 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L262">Source
382 Code</a></p>409 Code</a></p>
383 <p>Clear·the·state·of·the·keyboard,·emitting·<a410 <p>Clear·the·state·of·the·keyboard,·emitting·<a
384 href="events.html#allegro_event_key_up">ALLEGRO_EVENT_KEY_UP</a>·for411 href="events.html#allegro_event_key_up">ALLEGRO_EVENT_KEY_UP</a>·for
Offset 396, 29 lines modifiedOffset 423, 48 lines modified
396 href="keyboard.html#allegro_keyboard_state">ALLEGRO_KEYBOARD_STATE</a></p>423 href="keyboard.html#allegro_keyboard_state">ALLEGRO_KEYBOARD_STATE</a></p>
397 <p>Since:·5.2.3</p>424 <p>Since:·5.2.3</p>
398 <blockquote>425 <blockquote>
399 <p><em><a·href="getting_started.html#unstable-api">Unstable426 <p><em><a·href="getting_started.html#unstable-api">Unstable
400 API</a>:</em>·This·is·a·new·feature·and·the·exact·semantics·are·still427 API</a>:</em>·This·is·a·new·feature·and·the·exact·semantics·are·still
401 being·decided·upon.</p>428 being·decided·upon.</p>
402 </blockquote>429 </blockquote>
 430 <p>Examples:</p>
 431 <ul>
 432 <li><a
 433 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_events.c#L98">ex_keyboard_events.c</a></li>
 434 </ul>
403 <h1·id="al_key_down">al_key_down</h1>435 <h1·id="al_key_down">al_key_down</h1>
404 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_key_down<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_KEYBOARD_STATE·<span·class="op">*</span>state<span·class="op">,</span>·<span·class="dt">int</span>·keycode<span·class="op">)</span></span></code></pre></div>436 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_key_down<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_KEYBOARD_STATE·<span·class="op">*</span>state<span·class="op">,</span>·<span·class="dt">int</span>·keycode<span·class="op">)</span></span></code></pre></div>
405 <p><a437 <p><a
406 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L295">Source438 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L295">Source
407 Code</a></p>439 Code</a></p>
408 <p>Return·true·if·the·key·specified·was·held·down·in·the·state440 <p>Return·true·if·the·key·specified·was·held·down·in·the·state
409 specified.</p>441 specified.</p>
410 <p>See·also:·<a442 <p>See·also:·<a
411 href="keyboard.html#allegro_keyboard_state">ALLEGRO_KEYBOARD_STATE</a></p>443 href="keyboard.html#allegro_keyboard_state">ALLEGRO_KEYBOARD_STATE</a></p>
 444 <p>Examples:</p>
 445 <ul>
 446 <li><a
 447 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L111">ex_d3d.cpp</a></li>
 448 <li><a
 449 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L54">ex_keyboard_focus.c</a></li>
 450 <li><a
 451 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L95">ex_mouse_focus.c</a></li>
 452 </ul>
412 <h1·id="al_keycode_to_name">al_keycode_to_name</h1>453 <h1·id="al_keycode_to_name">al_keycode_to_name</h1>
413 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>al_keycode_to_name<span·class="op">(</span><span·class="dt">int</span>·keycode<span·class="op">)</span></span></code></pre></div>454 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>al_keycode_to_name<span·class="op">(</span><span·class="dt">int</span>·keycode<span·class="op">)</span></span></code></pre></div>
414 <p><a455 <p><a
415 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L228">Source456 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L228">Source
416 Code</a></p>457 Code</a></p>
417 <p>Converts·the·given·keycode·to·a·description·of·the·key.</p>458 <p>Converts·the·given·keycode·to·a·description·of·the·key.</p>
 459 <p>Examples:</p>
 460 <ul>
 461 <li><a
 462 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_events.c#L31">ex_keyboard_events.c</a></li>
 463 </ul>
418 <h1·id="al_can_set_keyboard_leds">al_can_set_keyboard_leds</h1>464 <h1·id="al_can_set_keyboard_leds">al_can_set_keyboard_leds</h1>
419 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_can_set_keyboard_leds<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>465 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_can_set_keyboard_leds<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
420 <p><a466 <p><a
421 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L203">Source467 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L203">Source
422 Code</a></p>468 Code</a></p>
423 <p>Returns·true·if·setting·the·keyboard·LED·indicators·is·available.</p>469 <p>Returns·true·if·setting·the·keyboard·LED·indicators·is·available.</p>
424 <p>Since:·5.2.9</p>470 <p>Since:·5.2.9</p>
Offset 444, 14 lines modifiedOffset 490, 23 lines modified
444 <p><a490 <p><a
445 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L304">Source491 href="https://github.com/liballeg/allegro5/blob/master/src/keybdnu.c#L304">Source
446 Code</a></p>492 Code</a></p>
447 <p>Retrieve·the·keyboard·event·source.·All·<a493 <p>Retrieve·the·keyboard·event·source.·All·<a
448 href="events.html#allegro_event_key_down">keyboard·events</a>·are494 href="events.html#allegro_event_key_down">keyboard·events</a>·are
449 generated·by·this·event·source.</p>495 generated·by·this·event·source.</p>
Max diff block lines reached; 507/8115 bytes (6.25%) of diff not shown.
6.02 KB
html2text {}
    
Offset 62, 14 lines modifiedOffset 62, 18 lines modified
62 typedef·struct·ALLEGRO_KEYBOARD_STATE·ALLEGRO_KEYBOARD_STATE;62 typedef·struct·ALLEGRO_KEYBOARD_STATE·ALLEGRO_KEYBOARD_STATE;
63 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e63 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
64 This·is·a·structure·that·is·used·to·hold·a·“snapshot”·of·a·keyboard’s·state·at64 This·is·a·structure·that·is·used·to·hold·a·“snapshot”·of·a·keyboard’s·state·at
65 a·particular·instant.·It·contains·the·following·publically·readable·fields:65 a·particular·instant.·It·contains·the·following·publically·readable·fields:
66 ····*·display·-·points·to·the·display·that·had·keyboard·focus·at·the·time·the66 ····*·display·-·points·to·the·display·that·had·keyboard·focus·at·the·time·the
67 ······state·was·saved.·If·no·display·was·focused,·this·points·to·NULL.67 ······state·was·saved.·If·no·display·was·focused,·this·points·to·NULL.
68 You·cannot·read·the·state·of·keys·directly.·Use·the·function·_\x8a_\x8l_\x8__\x8k_\x8e_\x8y_\x8__\x8d_\x8o_\x8w_\x8n.68 You·cannot·read·the·state·of·keys·directly.·Use·the·function·_\x8a_\x8l_\x8__\x8k_\x8e_\x8y_\x8__\x8d_\x8o_\x8w_\x8n.
 69 Examples:
 70 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
 71 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 72 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
69 *\x8**\x8**\x8**\x8**\x8**\x8*·K\x8Ke\x8ey\x8y·c\x8co\x8od\x8de\x8es\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*73 *\x8**\x8**\x8**\x8**\x8**\x8*·K\x8Ke\x8ey\x8y·c\x8co\x8od\x8de\x8es\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
70 The·constant·ALLEGRO_KEY_MAX·is·always·one·higher·than·the·highest·key·code.·So74 The·constant·ALLEGRO_KEY_MAX·is·always·one·higher·than·the·highest·key·code.·So
71 if·you·want·to·use·the·key·code·as·array·index·you·can·do·something·like·this:75 if·you·want·to·use·the·key·code·as·array·index·you·can·do·something·like·this:
72 bool·pressed_keys[ALLEGRO_KEY_MAX];76 bool·pressed_keys[ALLEGRO_KEY_MAX];
73 //...77 //...
74 pressed_keys[key_code]·=·true;78 pressed_keys[key_code]·=·true;
75 These·are·the·list·of·key·codes·used·by·Allegro,·which·are·returned·in·the79 These·are·the·list·of·key·codes·used·by·Allegro,·which·are·returned·in·the
Offset 185, 14 lines modifiedOffset 189, 18 lines modified
185 typed.189 typed.
186 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*190 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
187 bool·al_install_keyboard(void)191 bool·al_install_keyboard(void)
188 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e192 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
189 Install·a·keyboard·driver.·Returns·true·if·successful.·If·a·driver·was·already193 Install·a·keyboard·driver.·Returns·true·if·successful.·If·a·driver·was·already
190 installed,·nothing·happens·and·true·is·returned.194 installed,·nothing·happens·and·true·is·returned.
191 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d,·_\x8a_\x8l_\x8__\x8i_\x8s_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8e_\x8d195 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d,·_\x8a_\x8l_\x8__\x8i_\x8s_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8e_\x8d
 196 Examples:
 197 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
 198 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 199 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
192 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*200 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
193 bool·al_is_keyboard_installed(void)201 bool·al_is_keyboard_installed(void)
194 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e202 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
195 Returns·true·if·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d·was·called·successfully.203 Returns·true·if·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d·was·called·successfully.
196 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*204 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
197 void·al_uninstall_keyboard(void)205 void·al_uninstall_keyboard(void)
198 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e206 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
Offset 202, 14 lines modifiedOffset 210, 18 lines modified
202 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d210 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d
203 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*211 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
204 void·al_get_keyboard_state(ALLEGRO_KEYBOARD_STATE·*ret_state)212 void·al_get_keyboard_state(ALLEGRO_KEYBOARD_STATE·*ret_state)
205 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e213 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
206 Save·the·state·of·the·keyboard·specified·at·the·time·the·function·is·called214 Save·the·state·of·the·keyboard·specified·at·the·time·the·function·is·called
207 into·the·structure·pointed·to·by·r\x8re\x8et\x8t_\x8_s\x8st\x8ta\x8at\x8te\x8e.215 into·the·structure·pointed·to·by·r\x8re\x8et\x8t_\x8_s\x8st\x8ta\x8at\x8te\x8e.
208 See·also:·_\x8a_\x8l_\x8__\x8k_\x8e_\x8y_\x8__\x8d_\x8o_\x8w_\x8n,·_\x8a_\x8l_\x8__\x8c_\x8l_\x8e_\x8a_\x8r_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8K_\x8E_\x8Y_\x8B_\x8O_\x8A_\x8R_\x8D_\x8__\x8S_\x8T_\x8A_\x8T_\x8E216 See·also:·_\x8a_\x8l_\x8__\x8k_\x8e_\x8y_\x8__\x8d_\x8o_\x8w_\x8n,·_\x8a_\x8l_\x8__\x8c_\x8l_\x8e_\x8a_\x8r_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8K_\x8E_\x8Y_\x8B_\x8O_\x8A_\x8R_\x8D_\x8__\x8S_\x8T_\x8A_\x8T_\x8E
 217 Examples:
 218 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
 219 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 220 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
209 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cl\x8le\x8ea\x8ar\x8r_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*221 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cl\x8le\x8ea\x8ar\x8r_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
210 void·al_clear_keyboard_state(ALLEGRO_DISPLAY·*display)222 void·al_clear_keyboard_state(ALLEGRO_DISPLAY·*display)
211 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e223 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
212 Clear·the·state·of·the·keyboard,·emitting·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8K_\x8E_\x8Y_\x8__\x8U_\x8P·for·each224 Clear·the·state·of·the·keyboard,·emitting·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8K_\x8E_\x8Y_\x8__\x8U_\x8P·for·each
213 currently·pressed·key.·The·given·display·is·regarded·as·the·one·which·had·the225 currently·pressed·key.·The·given·display·is·regarded·as·the·one·which·had·the
214 keyboard·focus·when·the·event·occurred.·In·case·display·is·NULL·no·event·is226 keyboard·focus·when·the·event·occurred.·In·case·display·is·NULL·no·event·is
215 emitted.·For·most·keyboard·drivers·Allegro·maintains·its·own·state·of·the227 emitted.·For·most·keyboard·drivers·Allegro·maintains·its·own·state·of·the
Offset 217, 23 lines modifiedOffset 229, 31 lines modified
217 intended·to·remedy·such·situation·by·resetting·Allegro’s·keyboard·state·to·a229 intended·to·remedy·such·situation·by·resetting·Allegro’s·keyboard·state·to·a
218 known·default·(no·key·pressed).·This·is·particularly·useful·in·response·to230 known·default·(no·key·pressed).·This·is·particularly·useful·in·response·to
219 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8D_\x8I_\x8S_\x8P_\x8L_\x8A_\x8Y_\x8__\x8S_\x8W_\x8I_\x8T_\x8C_\x8H_\x8__\x8O_\x8U_\x8T·events.231 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8D_\x8I_\x8S_\x8P_\x8L_\x8A_\x8Y_\x8__\x8S_\x8W_\x8I_\x8T_\x8C_\x8H_\x8__\x8O_\x8U_\x8T·events.
220 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8K_\x8E_\x8Y_\x8B_\x8O_\x8A_\x8R_\x8D_\x8__\x8S_\x8T_\x8A_\x8T_\x8E232 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8K_\x8E_\x8Y_\x8B_\x8O_\x8A_\x8R_\x8D_\x8__\x8S_\x8T_\x8A_\x8T_\x8E
221 Since:·5.2.3233 Since:·5.2.3
222 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·This·is·a·new·feature·and·the·exact·semantics·are·still234 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·This·is·a·new·feature·and·the·exact·semantics·are·still
223 ·····being·decided·upon.235 ·····being·decided·upon.
 236 Examples:
 237 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
224 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_k\x8ke\x8ey\x8y_\x8_d\x8do\x8ow\x8wn\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*238 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_k\x8ke\x8ey\x8y_\x8_d\x8do\x8ow\x8wn\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
225 bool·al_key_down(const·ALLEGRO_KEYBOARD_STATE·*state,·int·keycode)239 bool·al_key_down(const·ALLEGRO_KEYBOARD_STATE·*state,·int·keycode)
226 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e240 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
227 Return·true·if·the·key·specified·was·held·down·in·the·state·specified.241 Return·true·if·the·key·specified·was·held·down·in·the·state·specified.
228 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8K_\x8E_\x8Y_\x8B_\x8O_\x8A_\x8R_\x8D_\x8__\x8S_\x8T_\x8A_\x8T_\x8E242 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8K_\x8E_\x8Y_\x8B_\x8O_\x8A_\x8R_\x8D_\x8__\x8S_\x8T_\x8A_\x8T_\x8E
 243 Examples:
 244 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
 245 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 246 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
229 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_k\x8ke\x8ey\x8yc\x8co\x8od\x8de\x8e_\x8_t\x8to\x8o_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*247 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_k\x8ke\x8ey\x8yc\x8co\x8od\x8de\x8e_\x8_t\x8to\x8o_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
230 const·char·*al_keycode_to_name(int·keycode)248 const·char·*al_keycode_to_name(int·keycode)
231 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e249 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
232 Converts·the·given·keycode·to·a·description·of·the·key.250 Converts·the·given·keycode·to·a·description·of·the·key.
 251 Examples:
 252 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
233 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8ca\x8an\x8n_\x8_s\x8se\x8et\x8t_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_l\x8le\x8ed\x8ds\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*253 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8ca\x8an\x8n_\x8_s\x8se\x8et\x8t_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_l\x8le\x8ed\x8ds\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
234 bool·al_can_set_keyboard_leds(void)254 bool·al_can_set_keyboard_leds(void)
235 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e255 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
236 Returns·true·if·setting·the·keyboard·LED·indicators·is·available.256 Returns·true·if·setting·the·keyboard·LED·indicators·is·available.
237 Since:·5.2.9257 Since:·5.2.9
238 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8l_\x8e_\x8d_\x8s258 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8l_\x8e_\x8d_\x8s
239 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_l\x8le\x8ed\x8ds\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*259 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_l\x8le\x8ed\x8ds\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
Offset 247, 8 lines modifiedOffset 267, 12 lines modified
247 See·also:·_\x8a_\x8l_\x8__\x8c_\x8a_\x8n_\x8__\x8s_\x8e_\x8t_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8l_\x8e_\x8d_\x8s267 See·also:·_\x8a_\x8l_\x8__\x8c_\x8a_\x8n_\x8__\x8s_\x8e_\x8t_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8l_\x8e_\x8d_\x8s
248 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*268 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_k\x8ke\x8ey\x8yb\x8bo\x8oa\x8ar\x8rd\x8d_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
249 ALLEGRO_EVENT_SOURCE·*al_get_keyboard_event_source(void)269 ALLEGRO_EVENT_SOURCE·*al_get_keyboard_event_source(void)
250 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e270 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
251 Retrieve·the·keyboard·event·source.·All·_\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s·are·generated·by·this271 Retrieve·the·keyboard·event·source.·All·_\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s·are·generated·by·this
252 event·source.272 event·source.
253 Returns·NULL·if·the·keyboard·subsystem·was·not·installed.273 Returns·NULL·if·the·keyboard·subsystem·was·not·installed.
 274 Examples:
 275 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 276 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8._\x8c
 277 ····*·_\x8e_\x8x_\x8__\x8w_\x8i_\x8n_\x8f_\x8u_\x8l_\x8l_\x8._\x8c
254 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC278 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC
2.41 KB
./usr/share/doc/allegro5-doc/refman/memfile.html
    
Offset 196, 22 lines modifiedOffset 196, 24 lines modified
196 Regardless·of·the·mode,·the·file·always·opens·at·position·0.·The·file196 Regardless·of·the·mode,·the·file·always·opens·at·position·0.·The·file
197 size·is·fixed·and·cannot·be·expanded.·The·file·is·always·read197 size·is·fixed·and·cannot·be·expanded.·The·file·is·always·read
198 from/written·to·in·binary·mode,·which·means·that·no·newline·translation198 from/written·to·in·binary·mode,·which·means·that·no·newline·translation
199 is·performed.</p>199 is·performed.</p>
200 <p>It·should·be·closed·with·<a·href="file.html#al_fclose">al_fclose</a>.200 <p>It·should·be·closed·with·<a·href="file.html#al_fclose">al_fclose</a>.
201 After·the·file·is·closed,·you·are·responsible·for·freeing·the·memory·(if201 After·the·file·is·closed,·you·are·responsible·for·freeing·the·memory·(if
202 needed).</p>202 needed).</p>
 203 <p>Examples:</p>
 204 <ul>
 205 <li><a
 206 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_memfile.c#L36">ex_memfile.c</a></li>
 207 </ul>
203 <h1208 <h1
204 id="al_get_allegro_memfile_version">al_get_allegro_memfile_version</h1>209 id="al_get_allegro_memfile_version">al_get_allegro_memfile_version</h1>
205 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">uint32_t</span>·al_get_allegro_memfile_version<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>210 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">uint32_t</span>·al_get_allegro_memfile_version<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
206 <p><a211 <p><a
207 href="https://github.com/liballeg/allegro5/blob/master/addons/memfile/memfile.c#L201">Source212 href="https://github.com/liballeg/allegro5/blob/master/addons/memfile/memfile.c#L201">Source
208 Code</a></p>213 Code</a></p>
209 <p>Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as·<a214 <p>Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as·<a
210 href="system.html#al_get_allegro_version">al_get_allegro_version</a>.</p>215 href="system.html#al_get_allegro_version">al_get_allegro_version</a>.</p>
  
211 <p·class="timestamp"> 
212 Allegro·version·5.2.10 
213 ·-·Last·updated:·2025-01-09·13:52:42·UTC 
214 </p> 
215 </div>216 </div>
216 </body>217 </body>
217 </html>218 </html>
1020 B
html2text {}
    
Offset 57, 13 lines modifiedOffset 57, 14 lines modified
57 upon·the·memory·directly,·so·it·must·not·be·freed·while·the·file·remains·open.57 upon·the·memory·directly,·so·it·must·not·be·freed·while·the·file·remains·open.
58 The·mode·can·be·any·combination·of·“r”·(readable)·and·“w”·(writable).58 The·mode·can·be·any·combination·of·“r”·(readable)·and·“w”·(writable).
59 Regardless·of·the·mode,·the·file·always·opens·at·position·0.·The·file·size·is59 Regardless·of·the·mode,·the·file·always·opens·at·position·0.·The·file·size·is
60 fixed·and·cannot·be·expanded.·The·file·is·always·read·from/written·to·in·binary60 fixed·and·cannot·be·expanded.·The·file·is·always·read·from/written·to·in·binary
61 mode,·which·means·that·no·newline·translation·is·performed.61 mode,·which·means·that·no·newline·translation·is·performed.
62 It·should·be·closed·with·_\x8a_\x8l_\x8__\x8f_\x8c_\x8l_\x8o_\x8s_\x8e.·After·the·file·is·closed,·you·are62 It·should·be·closed·with·_\x8a_\x8l_\x8__\x8f_\x8c_\x8l_\x8o_\x8s_\x8e.·After·the·file·is·closed,·you·are
63 responsible·for·freeing·the·memory·(if·needed).63 responsible·for·freeing·the·memory·(if·needed).
 64 Examples:
 65 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8m_\x8f_\x8i_\x8l_\x8e_\x8._\x8c
64 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8al\x8ll\x8le\x8eg\x8gr\x8ro\x8o_\x8_m\x8me\x8em\x8mf\x8fi\x8il\x8le\x8e_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*66 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8al\x8ll\x8le\x8eg\x8gr\x8ro\x8o_\x8_m\x8me\x8em\x8mf\x8fi\x8il\x8le\x8e_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
65 uint32_t·al_get_allegro_memfile_version(void)67 uint32_t·al_get_allegro_memfile_version(void)
66 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e68 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
67 Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as69 Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as
68 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8a_\x8l_\x8l_\x8e_\x8g_\x8r_\x8o_\x8__\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n.70 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8a_\x8l_\x8l_\x8e_\x8g_\x8r_\x8o_\x8__\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n.
69 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC 
7.66 KB
./usr/share/doc/allegro5-doc/refman/memory.html
    
Offset 203, 14 lines modifiedOffset 203, 21 lines modified
203 be·overridden.</p>203 be·overridden.</p>
204 <p>This·is·a·macro.</p>204 <p>This·is·a·macro.</p>
205 <p>See·also:·<a·href="memory.html#al_free">al_free</a>,·<a205 <p>See·also:·<a·href="memory.html#al_free">al_free</a>,·<a
206 href="memory.html#al_realloc">al_realloc</a>,·<a206 href="memory.html#al_realloc">al_realloc</a>,·<a
207 href="memory.html#al_calloc">al_calloc</a>,·<a207 href="memory.html#al_calloc">al_calloc</a>,·<a
208 href="memory.html#al_malloc_with_context">al_malloc_with_context</a>,·<a208 href="memory.html#al_malloc_with_context">al_malloc_with_context</a>,·<a
209 href="memory.html#al_set_memory_interface">al_set_memory_interface</a></p>209 href="memory.html#al_set_memory_interface">al_set_memory_interface</a></p>
 210 <p>Examples:</p>
 211 <ul>
 212 <li><a
 213 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_timer.c#L27">ex_audio_timer.c</a></li>
 214 <li><a
 215 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_vertex_buffer.c#L134">ex_vertex_buffer.c</a></li>
 216 </ul>
210 <h1·id="al_free">al_free</h1>217 <h1·id="al_free">al_free</h1>
211 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·al_free</span><span·class="op">(</span><span·class="pp">p</span><span·class="op">)</span><span·class="pp">·</span><span·class="op">\</span></span>218 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·al_free</span><span·class="op">(</span><span·class="pp">p</span><span·class="op">)</span><span·class="pp">·</span><span·class="op">\</span></span>
212 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">···</span><span·class="op">(</span><span·class="pp">al_free_with_context</span><span·class="op">((</span><span·class="pp">p</span><span·class="op">),</span><span·class="pp">·__LINE__</span><span·class="op">,</span><span·class="pp">·__FILE__</span><span·class="op">,</span><span·class="pp">·__func__</span><span·class="op">))</span></span></code></pre></div>219 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">···</span><span·class="op">(</span><span·class="pp">al_free_with_context</span><span·class="op">((</span><span·class="pp">p</span><span·class="op">),</span><span·class="pp">·__LINE__</span><span·class="op">,</span><span·class="pp">·__FILE__</span><span·class="op">,</span><span·class="pp">·__func__</span><span·class="op">))</span></span></code></pre></div>
213 <p><a220 <p><a
214 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/memory.h#L47">Source221 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/memory.h#L47">Source
215 Code</a></p>222 Code</a></p>
216 <p>Like·free()·in·the·C·standard·library,·but·the·implementation·may·be223 <p>Like·free()·in·the·C·standard·library,·but·the·implementation·may·be
Offset 218, 14 lines modifiedOffset 225, 23 lines modified
218 <p>Additionally,·on·Windows,·a·memory·block·allocated·by·one·DLL·must·be225 <p>Additionally,·on·Windows,·a·memory·block·allocated·by·one·DLL·must·be
219 freed·from·the·same·DLL.·In·the·few·places·where·an·Allegro·function226 freed·from·the·same·DLL.·In·the·few·places·where·an·Allegro·function
220 returns·a·pointer·that·must·be·freed,·you·must·use·<a227 returns·a·pointer·that·must·be·freed,·you·must·use·<a
221 href="memory.html#al_free">al_free</a>·for·portability·to·Windows.</p>228 href="memory.html#al_free">al_free</a>·for·portability·to·Windows.</p>
222 <p>This·is·a·macro.</p>229 <p>This·is·a·macro.</p>
223 <p>See·also:·<a·href="memory.html#al_malloc">al_malloc</a>,·<a230 <p>See·also:·<a·href="memory.html#al_malloc">al_malloc</a>,·<a
224 href="memory.html#al_free_with_context">al_free_with_context</a></p>231 href="memory.html#al_free_with_context">al_free_with_context</a></p>
 232 <p>Examples:</p>
 233 <ul>
 234 <li><a
 235 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_clipboard.c#L67">ex_clipboard.c</a></li>
 236 <li><a
 237 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_drag_and_drop.c#L166">ex_drag_and_drop.c</a></li>
 238 <li><a
 239 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_record_name.c#L254">ex_record_name.c</a></li>
 240 </ul>
225 <h1·id="al_realloc">al_realloc</h1>241 <h1·id="al_realloc">al_realloc</h1>
226 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·al_realloc</span><span·class="op">(</span><span·class="pp">p</span><span·class="op">,</span><span·class="pp">·n</span><span·class="op">)</span><span·class="pp">·</span><span·class="op">\</span></span>242 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·al_realloc</span><span·class="op">(</span><span·class="pp">p</span><span·class="op">,</span><span·class="pp">·n</span><span·class="op">)</span><span·class="pp">·</span><span·class="op">\</span></span>
227 <span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">···</span><span·class="op">(</span><span·class="pp">al_realloc_with_context</span><span·class="op">((</span><span·class="pp">p</span><span·class="op">),</span><span·class="pp">·</span><span·class="op">(</span><span·class="pp">n</span><span·class="op">),</span><span·class="pp">·__LINE__</span><span·class="op">,</span><span·class="pp">·__FILE__</span><span·class="op">,</span><span·class="pp">·__func__</span><span·class="op">))</span></span></code></pre></div>243 <span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">···</span><span·class="op">(</span><span·class="pp">al_realloc_with_context</span><span·class="op">((</span><span·class="pp">p</span><span·class="op">),</span><span·class="pp">·</span><span·class="op">(</span><span·class="pp">n</span><span·class="op">),</span><span·class="pp">·__LINE__</span><span·class="op">,</span><span·class="pp">·__FILE__</span><span·class="op">,</span><span·class="pp">·__func__</span><span·class="op">))</span></span></code></pre></div>
228 <p><a244 <p><a
229 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/memory.h#L52">Source245 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/memory.h#L52">Source
230 Code</a></p>246 Code</a></p>
231 <p>Like·realloc()·in·the·C·standard·library,·but·the·implementation·may247 <p>Like·realloc()·in·the·C·standard·library,·but·the·implementation·may
Offset 240, 14 lines modifiedOffset 256, 19 lines modified
240 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/memory.h#L57">Source256 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/memory.h#L57">Source
241 Code</a></p>257 Code</a></p>
242 <p>Like·calloc()·in·the·C·standard·library,·but·the·implementation·may258 <p>Like·calloc()·in·the·C·standard·library,·but·the·implementation·may
243 be·overridden.</p>259 be·overridden.</p>
244 <p>This·is·a·macro.</p>260 <p>This·is·a·macro.</p>
245 <p>See·also:·<a·href="memory.html#al_malloc">al_malloc</a>,·<a261 <p>See·also:·<a·href="memory.html#al_malloc">al_malloc</a>,·<a
246 href="memory.html#al_calloc_with_context">al_calloc_with_context</a></p>262 href="memory.html#al_calloc_with_context">al_calloc_with_context</a></p>
 263 <p>Examples:</p>
 264 <ul>
 265 <li><a
 266 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_record_name.c#L123">ex_record_name.c</a></li>
 267 </ul>
247 <h1·id="al_malloc_with_context">al_malloc_with_context</h1>268 <h1·id="al_malloc_with_context">al_malloc_with_context</h1>
248 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·<span·class="op">*</span>al_malloc_with_context<span·class="op">(</span><span·class="dt">size_t</span>·n<span·class="op">,</span></span>269 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·<span·class="op">*</span>al_malloc_with_context<span·class="op">(</span><span·class="dt">size_t</span>·n<span·class="op">,</span></span>
249 <span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·line<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>file<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>func<span·class="op">)</span></span></code></pre></div>270 <span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·line<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>file<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>func<span·class="op">)</span></span></code></pre></div>
250 <p><a271 <p><a
251 href="https://github.com/liballeg/allegro5/blob/master/src/memory.c#L38">Source272 href="https://github.com/liballeg/allegro5/blob/master/src/memory.c#L38">Source
252 Code</a></p>273 Code</a></p>
253 <p>This·calls·malloc()·from·the·Allegro·library·(this·matters·on274 <p>This·calls·malloc()·from·the·Allegro·library·(this·matters·on
2.55 KB
html2text {}
    
Offset 60, 25 lines modifiedOffset 60, 32 lines modified
60 ···(al_malloc_with_context((n),·__LINE__,·__FILE__,·__func__))60 ···(al_malloc_with_context((n),·__LINE__,·__FILE__,·__func__))
61 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e61 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
62 Like·malloc()·in·the·C·standard·library,·but·the·implementation·may·be62 Like·malloc()·in·the·C·standard·library,·but·the·implementation·may·be
63 overridden.63 overridden.
64 This·is·a·macro.64 This·is·a·macro.
65 See·also:·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8a_\x8l_\x8l_\x8o_\x8c,·_\x8a_\x8l_\x8__\x8c_\x8a_\x8l_\x8l_\x8o_\x8c,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8l_\x8l_\x8o_\x8c_\x8__\x8w_\x8i_\x8t_\x8h_\x8__\x8c_\x8o_\x8n_\x8t_\x8e_\x8x_\x8t,65 See·also:·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8a_\x8l_\x8l_\x8o_\x8c,·_\x8a_\x8l_\x8__\x8c_\x8a_\x8l_\x8l_\x8o_\x8c,·_\x8a_\x8l_\x8__\x8m_\x8a_\x8l_\x8l_\x8o_\x8c_\x8__\x8w_\x8i_\x8t_\x8h_\x8__\x8c_\x8o_\x8n_\x8t_\x8e_\x8x_\x8t,
66 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8e_\x8m_\x8o_\x8r_\x8y_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e66 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8e_\x8m_\x8o_\x8r_\x8y_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e
 67 Examples:
 68 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8._\x8c
 69 ····*·_\x8e_\x8x_\x8__\x8v_\x8e_\x8r_\x8t_\x8e_\x8x_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r_\x8._\x8c
67 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fr\x8re\x8ee\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*70 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_f\x8fr\x8re\x8ee\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
68 #define·al_free(p)·\71 #define·al_free(p)·\
69 ···(al_free_with_context((p),·__LINE__,·__FILE__,·__func__))72 ···(al_free_with_context((p),·__LINE__,·__FILE__,·__func__))
70 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e73 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
71 Like·free()·in·the·C·standard·library,·but·the·implementation·may·be74 Like·free()·in·the·C·standard·library,·but·the·implementation·may·be
72 overridden.75 overridden.
73 Additionally,·on·Windows,·a·memory·block·allocated·by·one·DLL·must·be·freed76 Additionally,·on·Windows,·a·memory·block·allocated·by·one·DLL·must·be·freed
74 from·the·same·DLL.·In·the·few·places·where·an·Allegro·function·returns·a77 from·the·same·DLL.·In·the·few·places·where·an·Allegro·function·returns·a
75 pointer·that·must·be·freed,·you·must·use·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e·for·portability·to·Windows.78 pointer·that·must·be·freed,·you·must·use·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e·for·portability·to·Windows.
76 This·is·a·macro.79 This·is·a·macro.
77 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8l_\x8l_\x8o_\x8c,·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e_\x8__\x8w_\x8i_\x8t_\x8h_\x8__\x8c_\x8o_\x8n_\x8t_\x8e_\x8x_\x8t80 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8l_\x8l_\x8o_\x8c,·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e_\x8__\x8w_\x8i_\x8t_\x8h_\x8__\x8c_\x8o_\x8n_\x8t_\x8e_\x8x_\x8t
 81 Examples:
 82 ····*·_\x8e_\x8x_\x8__\x8c_\x8l_\x8i_\x8p_\x8b_\x8o_\x8a_\x8r_\x8d_\x8._\x8c
 83 ····*·_\x8e_\x8x_\x8__\x8d_\x8r_\x8a_\x8g_\x8__\x8a_\x8n_\x8d_\x8__\x8d_\x8r_\x8o_\x8p_\x8._\x8c
 84 ····*·_\x8e_\x8x_\x8__\x8r_\x8e_\x8c_\x8o_\x8r_\x8d_\x8__\x8n_\x8a_\x8m_\x8e_\x8._\x8c
78 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8ea\x8al\x8ll\x8lo\x8oc\x8c·*\x8**\x8**\x8**\x8**\x8**\x8*85 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8ea\x8al\x8ll\x8lo\x8oc\x8c·*\x8**\x8**\x8**\x8**\x8**\x8*
79 #define·al_realloc(p,·n)·\86 #define·al_realloc(p,·n)·\
80 ···(al_realloc_with_context((p),·(n),·__LINE__,·__FILE__,·__func__))87 ···(al_realloc_with_context((p),·(n),·__LINE__,·__FILE__,·__func__))
81 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e88 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
82 Like·realloc()·in·the·C·standard·library,·but·the·implementation·may·be89 Like·realloc()·in·the·C·standard·library,·but·the·implementation·may·be
83 overridden.90 overridden.
84 This·is·a·macro.91 This·is·a·macro.
Offset 87, 14 lines modifiedOffset 94, 16 lines modified
87 #define·al_calloc(c,·n)·\94 #define·al_calloc(c,·n)·\
88 ···(al_calloc_with_context((c),·(n),·__LINE__,·__FILE__,·__func__))95 ···(al_calloc_with_context((c),·(n),·__LINE__,·__FILE__,·__func__))
89 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e96 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
90 Like·calloc()·in·the·C·standard·library,·but·the·implementation·may·be97 Like·calloc()·in·the·C·standard·library,·but·the·implementation·may·be
91 overridden.98 overridden.
92 This·is·a·macro.99 This·is·a·macro.
93 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8l_\x8l_\x8o_\x8c,·_\x8a_\x8l_\x8__\x8c_\x8a_\x8l_\x8l_\x8o_\x8c_\x8__\x8w_\x8i_\x8t_\x8h_\x8__\x8c_\x8o_\x8n_\x8t_\x8e_\x8x_\x8t100 See·also:·_\x8a_\x8l_\x8__\x8m_\x8a_\x8l_\x8l_\x8o_\x8c,·_\x8a_\x8l_\x8__\x8c_\x8a_\x8l_\x8l_\x8o_\x8c_\x8__\x8w_\x8i_\x8t_\x8h_\x8__\x8c_\x8o_\x8n_\x8t_\x8e_\x8x_\x8t
 101 Examples:
 102 ····*·_\x8e_\x8x_\x8__\x8r_\x8e_\x8c_\x8o_\x8r_\x8d_\x8__\x8n_\x8a_\x8m_\x8e_\x8._\x8c
94 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8al\x8ll\x8lo\x8oc\x8c_\x8_w\x8wi\x8it\x8th\x8h_\x8_c\x8co\x8on\x8nt\x8te\x8ex\x8xt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*103 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8ma\x8al\x8ll\x8lo\x8oc\x8c_\x8_w\x8wi\x8it\x8th\x8h_\x8_c\x8co\x8on\x8nt\x8te\x8ex\x8xt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
95 void·*al_malloc_with_context(size_t·n,104 void·*al_malloc_with_context(size_t·n,
96 ···int·line,·const·char·*file,·const·char·*func)105 ···int·line,·const·char·*file,·const·char·*func)
97 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e106 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
98 This·calls·malloc()·from·the·Allegro·library·(this·matters·on·Windows),·unless107 This·calls·malloc()·from·the·Allegro·library·(this·matters·on·Windows),·unless
99 overridden·with·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8e_\x8m_\x8o_\x8r_\x8y_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e,108 overridden·with·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8e_\x8m_\x8o_\x8r_\x8y_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e,
100 Generally·you·should·use·the·_\x8a_\x8l_\x8__\x8m_\x8a_\x8l_\x8l_\x8o_\x8c·macro.109 Generally·you·should·use·the·_\x8a_\x8l_\x8__\x8m_\x8a_\x8l_\x8l_\x8o_\x8c·macro.
2.94 KB
./usr/share/doc/allegro5-doc/refman/misc.html
    
Offset 182, 14 lines modifiedOffset 182, 23 lines modified
182 <h1·id="allegro_pi">ALLEGRO_PI</h1>182 <h1·id="allegro_pi">ALLEGRO_PI</h1>
183 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_PI········</span><span·class="fl">3.14159265358979323846</span></span></code></pre></div>183 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_PI········</span><span·class="fl">3.14159265358979323846</span></span></code></pre></div>
184 <p><a184 <p><a
185 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/base.h#L96">Source185 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/base.h#L96">Source
186 Code</a></p>186 Code</a></p>
187 <p>C99·compilers·have·no·predefined·value·like·M_PI·for·the·constant·π,187 <p>C99·compilers·have·no·predefined·value·like·M_PI·for·the·constant·π,
188 but·you·can·use·this·one·instead.</p>188 but·you·can·use·this·one·instead.</p>
 189 <p>Examples:</p>
 190 <ul>
 191 <li><a
 192 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_convert.c#L31">ex_convert.c</a></li>
 193 <li><a
 194 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl.c#L89">ex_opengl.c</a></li>
 195 <li><a
 196 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend_bench.c#L49">ex_blend_bench.c</a></li>
 197 </ul>
189 <h1·id="al_run_main">al_run_main</h1>198 <h1·id="al_run_main">al_run_main</h1>
190 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_run_main<span·class="op">(</span><span·class="dt">int</span>·argc<span·class="op">,</span>·<span·class="dt">char</span>·<span·class="op">**</span>argv<span·class="op">,</span>·<span·class="dt">int</span>·<span·class="op">(*</span>user_main<span·class="op">)(</span><span·class="dt">int</span><span·class="op">,</span>·<span·class="dt">char</span>·<span·class="op">**))</span></span></code></pre></div>199 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_run_main<span·class="op">(</span><span·class="dt">int</span>·argc<span·class="op">,</span>·<span·class="dt">char</span>·<span·class="op">**</span>argv<span·class="op">,</span>·<span·class="dt">int</span>·<span·class="op">(*</span>user_main<span·class="op">)(</span><span·class="dt">int</span><span·class="op">,</span>·<span·class="dt">char</span>·<span·class="op">**))</span></span></code></pre></div>
191 <p><a200 <p><a
192 href="https://github.com/liballeg/allegro5/blob/master/src/allegro.c#L36">Source201 href="https://github.com/liballeg/allegro5/blob/master/src/allegro.c#L36">Source
193 Code</a></p>202 Code</a></p>
194 <p>This·function·is·useful·in·cases·where·you·don’t·have·a·main()203 <p>This·function·is·useful·in·cases·where·you·don’t·have·a·main()
195 function·but·want·to·run·Allegro·(mostly·useful·in·a·wrapper·library).204 function·but·want·to·run·Allegro·(mostly·useful·in·a·wrapper·library).
1.08 KB
html2text {}
    
Offset 48, 14 lines modifiedOffset 48, 18 lines modified
48 These·functions·are·declared·in·the·main·Allegro·header·file:48 These·functions·are·declared·in·the·main·Allegro·header·file:
49 ·#include·<allegro5/allegro.h>49 ·#include·<allegro5/allegro.h>
50 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_P\x8PI\x8I·*\x8**\x8**\x8**\x8**\x8**\x8*50 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_P\x8PI\x8I·*\x8**\x8**\x8**\x8**\x8**\x8*
51 #define·ALLEGRO_PI········3.1415926535897932384651 #define·ALLEGRO_PI········3.14159265358979323846
52 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e52 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
53 C99·compilers·have·no·predefined·value·like·M_PI·for·the·constant·π,·but·you53 C99·compilers·have·no·predefined·value·like·M_PI·for·the·constant·π,·but·you
54 can·use·this·one·instead.54 can·use·this·one·instead.
 55 Examples:
 56 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8v_\x8e_\x8r_\x8t_\x8._\x8c
 57 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8._\x8c
 58 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8__\x8b_\x8e_\x8n_\x8c_\x8h_\x8._\x8c
55 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8ru\x8un\x8n_\x8_m\x8ma\x8ai\x8in\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*59 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8ru\x8un\x8n_\x8_m\x8ma\x8ai\x8in\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
56 int·al_run_main(int·argc,·char·**argv,·int·(*user_main)(int,·char·**))60 int·al_run_main(int·argc,·char·**argv,·int·(*user_main)(int,·char·**))
57 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e61 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
58 This·function·is·useful·in·cases·where·you·don’t·have·a·main()·function·but62 This·function·is·useful·in·cases·where·you·don’t·have·a·main()·function·but
59 want·to·run·Allegro·(mostly·useful·in·a·wrapper·library).·Under·Windows·and63 want·to·run·Allegro·(mostly·useful·in·a·wrapper·library).·Under·Windows·and
60 Linux·this·is·no·problem·because·you·simply·can·call·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m.·But64 Linux·this·is·no·problem·because·you·simply·can·call·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m.·But
61 some·other·system·(like·OSX)·don’t·allow·calling·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m·in·the·main65 some·other·system·(like·OSX)·don’t·allow·calling·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m·in·the·main
8.2 KB
./usr/share/doc/allegro5-doc/refman/monitor.html
    
Offset 202, 14 lines modifiedOffset 202, 23 lines modified
202 <span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·x1<span·class="op">;</span></span>202 <span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·x1<span·class="op">;</span></span>
203 <span·id="cb3-4"><a·href="#cb3-4"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·y1<span·class="op">;</span></span>203 <span·id="cb3-4"><a·href="#cb3-4"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·y1<span·class="op">;</span></span>
204 <span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·x2<span·class="op">;</span></span>204 <span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·x2<span·class="op">;</span></span>
205 <span·id="cb3-6"><a·href="#cb3-6"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·y2<span·class="op">;</span></span>205 <span·id="cb3-6"><a·href="#cb3-6"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">int</span>·y2<span·class="op">;</span></span>
206 <span·id="cb3-7"><a·href="#cb3-7"·aria-hidden="true"·tabindex="-1"></a><span·class="op">}</span>·ALLEGRO_MONITOR_INFO<span·class="op">;</span></span></code></pre></div>206 <span·id="cb3-7"><a·href="#cb3-7"·aria-hidden="true"·tabindex="-1"></a><span·class="op">}</span>·ALLEGRO_MONITOR_INFO<span·class="op">;</span></span></code></pre></div>
207 <p>See·also:·<a207 <p>See·also:·<a
208 href="monitor.html#al_get_monitor_info">al_get_monitor_info</a></p>208 href="monitor.html#al_get_monitor_info">al_get_monitor_info</a></p>
 209 <p>Examples:</p>
 210 <ul>
 211 <li><a
 212 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L8">ex_monitorinfo.c</a></li>
 213 <li><a
 214 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_drag_and_drop.c#L67">ex_drag_and_drop.c</a></li>
 215 <li><a
 216 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_windows.c#L16">ex_windows.c</a></li>
 217 </ul>
209 <h1·id="al_get_monitor_info">al_get_monitor_info</h1>218 <h1·id="al_get_monitor_info">al_get_monitor_info</h1>
210 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_get_monitor_info<span·class="op">(</span><span·class="dt">int</span>·adapter<span·class="op">,</span>·ALLEGRO_MONITOR_INFO·<span·class="op">*</span>info<span·class="op">)</span></span></code></pre></div>219 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_get_monitor_info<span·class="op">(</span><span·class="dt">int</span>·adapter<span·class="op">,</span>·ALLEGRO_MONITOR_INFO·<span·class="op">*</span>info<span·class="op">)</span></span></code></pre></div>
211 <p><a220 <p><a
212 href="https://github.com/liballeg/allegro5/blob/master/src/monitor.c#L52">Source221 href="https://github.com/liballeg/allegro5/blob/master/src/monitor.c#L52">Source
213 Code</a></p>222 Code</a></p>
214 <p>Get·information·about·a·monitor’s·position·on·the·desktop.·adapter·is223 <p>Get·information·about·a·monitor’s·position·on·the·desktop.·adapter·is
215 a·number·from·0·to·al_get_num_video_adapters()-1.</p>224 a·number·from·0·to·al_get_num_video_adapters()-1.</p>
Offset 218, 24 lines modifiedOffset 227, 38 lines modified
218 to·switch·between·Direct3D·and·OpenGL·backends,·which·will·often·have227 to·switch·between·Direct3D·and·OpenGL·backends,·which·will·often·have
219 different·adapters·available.</p>228 different·adapters·available.</p>
220 <p>Returns·<code>true</code>·on·success,·<code>false</code>·on229 <p>Returns·<code>true</code>·on·success,·<code>false</code>·on
221 failure.</p>230 failure.</p>
222 <p>See·also:·<a231 <p>See·also:·<a
223 href="monitor.html#allegro_monitor_info">ALLEGRO_MONITOR_INFO</a>,·<a232 href="monitor.html#allegro_monitor_info">ALLEGRO_MONITOR_INFO</a>,·<a
224 href="monitor.html#al_get_num_video_adapters">al_get_num_video_adapters</a></p>233 href="monitor.html#al_get_num_video_adapters">al_get_num_video_adapters</a></p>
 234 <p>Examples:</p>
 235 <ul>
 236 <li><a
 237 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L26">ex_monitorinfo.c</a></li>
 238 <li><a
 239 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_drag_and_drop.c#L68">ex_drag_and_drop.c</a></li>
 240 <li><a
 241 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_windows.c#L49">ex_windows.c</a></li>
 242 </ul>
225 <h1·id="al_get_monitor_dpi">al_get_monitor_dpi</h1>243 <h1·id="al_get_monitor_dpi">al_get_monitor_dpi</h1>
226 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_monitor_dpi<span·class="op">(</span><span·class="dt">int</span>·adapter<span·class="op">)</span></span></code></pre></div>244 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_monitor_dpi<span·class="op">(</span><span·class="dt">int</span>·adapter<span·class="op">)</span></span></code></pre></div>
227 <p><a245 <p><a
228 href="https://github.com/liballeg/allegro5/blob/master/src/monitor.c#L68">Source246 href="https://github.com/liballeg/allegro5/blob/master/src/monitor.c#L68">Source
229 Code</a></p>247 Code</a></p>
230 <p>Get·the·dots·per·inch·of·a·monitor·attached·to·the·display248 <p>Get·the·dots·per·inch·of·a·monitor·attached·to·the·display
231 adapter.</p>249 adapter.</p>
232 <p>Since:·5.2.5</p>250 <p>Since:·5.2.5</p>
233 <p>See·also:·<a251 <p>See·also:·<a
234 href="monitor.html#al_get_num_video_adapters">al_get_num_video_adapters</a></p>252 href="monitor.html#al_get_num_video_adapters">al_get_num_video_adapters</a></p>
 253 <p>Examples:</p>
 254 <ul>
 255 <li><a
 256 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L28">ex_monitorinfo.c</a></li>
 257 </ul>
235 <h1·id="al_get_num_video_adapters">al_get_num_video_adapters</h1>258 <h1·id="al_get_num_video_adapters">al_get_num_video_adapters</h1>
236 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_num_video_adapters<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>259 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_num_video_adapters<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
237 <p><a260 <p><a
238 href="https://github.com/liballeg/allegro5/blob/master/src/monitor.c#L23">Source261 href="https://github.com/liballeg/allegro5/blob/master/src/monitor.c#L23">Source
239 Code</a></p>262 Code</a></p>
240 <p>Get·the·number·of·video·“adapters”·attached·to·the·computer.·Each263 <p>Get·the·number·of·video·“adapters”·attached·to·the·computer.·Each
241 video·card·attached·to·the·computer·counts·as·one·or·more·adapters.·An264 video·card·attached·to·the·computer·counts·as·one·or·more·adapters.·An
Offset 243, 14 lines modifiedOffset 266, 23 lines modified
243 it.</p>266 it.</p>
244 <p>On·Windows,·use·<a267 <p>On·Windows,·use·<a
245 href="display.html#al_set_new_display_flags">al_set_new_display_flags</a>268 href="display.html#al_set_new_display_flags">al_set_new_display_flags</a>
246 to·switch·between·Direct3D·and·OpenGL·backends,·which·will·often·have269 to·switch·between·Direct3D·and·OpenGL·backends,·which·will·often·have
247 different·adapters·available.</p>270 different·adapters·available.</p>
248 <p>See·also:·<a271 <p>See·also:·<a
249 href="monitor.html#al_get_monitor_info">al_get_monitor_info</a></p>272 href="monitor.html#al_get_monitor_info">al_get_monitor_info</a></p>
 273 <p>Examples:</p>
 274 <ul>
 275 <li><a
 276 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L21">ex_monitorinfo.c</a></li>
 277 <li><a
 278 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_winfull.c#L20">ex_winfull.c</a></li>
 279 <li><a
 280 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_dualies.c#L79">ex_dualies.c</a></li>
 281 </ul>
250 <h1·id="al_get_monitor_refresh_rate">al_get_monitor_refresh_rate</h1>282 <h1·id="al_get_monitor_refresh_rate">al_get_monitor_refresh_rate</h1>
251 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_monitor_refresh_rate<span·class="op">(</span><span·class="dt">int</span>·adapter<span·class="op">)</span></span></code></pre></div>283 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_monitor_refresh_rate<span·class="op">(</span><span·class="dt">int</span>·adapter<span·class="op">)</span></span></code></pre></div>
252 <p><a284 <p><a
253 href="https://github.com/liballeg/allegro5/blob/master/src/monitor.c#L36">Source285 href="https://github.com/liballeg/allegro5/blob/master/src/monitor.c#L36">Source
254 Code</a></p>286 Code</a></p>
255 <p>Returns·the·current·refresh·rate·of·a·monitor·attached·to·the·display287 <p>Returns·the·current·refresh·rate·of·a·monitor·attached·to·the·display
256 adapter.</p>288 adapter.</p>
2.83 KB
html2text {}
    
Offset 62, 38 lines modifiedOffset 62, 52 lines modified
62 {62 {
63 ···int·x1;63 ···int·x1;
64 ···int·y1;64 ···int·y1;
65 ···int·x2;65 ···int·x2;
66 ···int·y2;66 ···int·y2;
67 }·ALLEGRO_MONITOR_INFO;67 }·ALLEGRO_MONITOR_INFO;
68 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8__\x8i_\x8n_\x8f_\x8o68 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8__\x8i_\x8n_\x8f_\x8o
 69 Examples:
 70 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c
 71 ····*·_\x8e_\x8x_\x8__\x8d_\x8r_\x8a_\x8g_\x8__\x8a_\x8n_\x8d_\x8__\x8d_\x8r_\x8o_\x8p_\x8._\x8c
 72 ····*·_\x8e_\x8x_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8s_\x8._\x8c
69 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8on\x8ni\x8it\x8to\x8or\x8r_\x8_i\x8in\x8nf\x8fo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*73 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8on\x8ni\x8it\x8to\x8or\x8r_\x8_i\x8in\x8nf\x8fo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*
70 bool·al_get_monitor_info(int·adapter,·ALLEGRO_MONITOR_INFO·*info)74 bool·al_get_monitor_info(int·adapter,·ALLEGRO_MONITOR_INFO·*info)
71 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e75 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
72 Get·information·about·a·monitor’s·position·on·the·desktop.·adapter·is·a·number76 Get·information·about·a·monitor’s·position·on·the·desktop.·adapter·is·a·number
73 from·0·to·al_get_num_video_adapters()-1.77 from·0·to·al_get_num_video_adapters()-1.
74 On·Windows,·use·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·to·switch·between·Direct3D·and·OpenGL78 On·Windows,·use·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·to·switch·between·Direct3D·and·OpenGL
75 backends,·which·will·often·have·different·adapters·available.79 backends,·which·will·often·have·different·adapters·available.
76 Returns·true·on·success,·false·on·failure.80 Returns·true·on·success,·false·on·failure.
77 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8N_\x8I_\x8T_\x8O_\x8R_\x8__\x8I_\x8N_\x8F_\x8O,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r_\x8s81 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8N_\x8I_\x8T_\x8O_\x8R_\x8__\x8I_\x8N_\x8F_\x8O,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r_\x8s
 82 Examples:
 83 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c
 84 ····*·_\x8e_\x8x_\x8__\x8d_\x8r_\x8a_\x8g_\x8__\x8a_\x8n_\x8d_\x8__\x8d_\x8r_\x8o_\x8p_\x8._\x8c
 85 ····*·_\x8e_\x8x_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8s_\x8._\x8c
78 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8on\x8ni\x8it\x8to\x8or\x8r_\x8_d\x8dp\x8pi\x8i·*\x8**\x8**\x8**\x8**\x8**\x8*86 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8on\x8ni\x8it\x8to\x8or\x8r_\x8_d\x8dp\x8pi\x8i·*\x8**\x8**\x8**\x8**\x8**\x8*
79 int·al_get_monitor_dpi(int·adapter)87 int·al_get_monitor_dpi(int·adapter)
80 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e88 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
81 Get·the·dots·per·inch·of·a·monitor·attached·to·the·display·adapter.89 Get·the·dots·per·inch·of·a·monitor·attached·to·the·display·adapter.
82 Since:·5.2.590 Since:·5.2.5
83 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r_\x8s91 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8u_\x8m_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8a_\x8d_\x8a_\x8p_\x8t_\x8e_\x8r_\x8s
 92 Examples:
 93 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c
84 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8nu\x8um\x8m_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8ad\x8da\x8ap\x8pt\x8te\x8er\x8rs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*94 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8nu\x8um\x8m_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8ad\x8da\x8ap\x8pt\x8te\x8er\x8rs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
85 int·al_get_num_video_adapters(void)95 int·al_get_num_video_adapters(void)
86 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e96 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
87 Get·the·number·of·video·“adapters”·attached·to·the·computer.·Each·video·card97 Get·the·number·of·video·“adapters”·attached·to·the·computer.·Each·video·card
88 attached·to·the·computer·counts·as·one·or·more·adapters.·An·adapter·is·thus98 attached·to·the·computer·counts·as·one·or·more·adapters.·An·adapter·is·thus
89 really·a·video·port·that·can·have·a·monitor·connected·to·it.99 really·a·video·port·that·can·have·a·monitor·connected·to·it.
90 On·Windows,·use·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·to·switch·between·Direct3D·and·OpenGL100 On·Windows,·use·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8f_\x8l_\x8a_\x8g_\x8s·to·switch·between·Direct3D·and·OpenGL
91 backends,·which·will·often·have·different·adapters·available.101 backends,·which·will·often·have·different·adapters·available.
92 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8__\x8i_\x8n_\x8f_\x8o102 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8__\x8i_\x8n_\x8f_\x8o
 103 Examples:
 104 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c
 105 ····*·_\x8e_\x8x_\x8__\x8w_\x8i_\x8n_\x8f_\x8u_\x8l_\x8l_\x8._\x8c
 106 ····*·_\x8e_\x8x_\x8__\x8d_\x8u_\x8a_\x8l_\x8i_\x8e_\x8s_\x8._\x8c
93 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8on\x8ni\x8it\x8to\x8or\x8r_\x8_r\x8re\x8ef\x8fr\x8re\x8es\x8sh\x8h_\x8_r\x8ra\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*107 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8on\x8ni\x8it\x8to\x8or\x8r_\x8_r\x8re\x8ef\x8fr\x8re\x8es\x8sh\x8h_\x8_r\x8ra\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
94 int·al_get_monitor_refresh_rate(int·adapter)108 int·al_get_monitor_refresh_rate(int·adapter)
95 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e109 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
96 Returns·the·current·refresh·rate·of·a·monitor·attached·to·the·display·adapter.110 Returns·the·current·refresh·rate·of·a·monitor·attached·to·the·display·adapter.
97 Since:·5.2.6111 Since:·5.2.6
98 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·This·is·an·experimental·feature·and·currently·only112 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·This·is·an·experimental·feature·and·currently·only
99 ·····works·on·Windows.113 ·····works·on·Windows.
33.9 KB
./usr/share/doc/allegro5-doc/refman/mouse.html
    
Offset 251, 14 lines modifiedOffset 251, 23 lines modified
251 <li><p>pressure·-·pressure,·ranging·from·<code>0.0</code>·to251 <li><p>pressure·-·pressure,·ranging·from·<code>0.0</code>·to
252 <code>1.0</code></p></li>252 <code>1.0</code></p></li>
253 </ul>253 </ul>
254 <p>See·also:·<a254 <p>See·also:·<a
255 href="mouse.html#al_get_mouse_state">al_get_mouse_state</a>,·<a255 href="mouse.html#al_get_mouse_state">al_get_mouse_state</a>,·<a
256 href="mouse.html#al_get_mouse_state_axis">al_get_mouse_state_axis</a>,256 href="mouse.html#al_get_mouse_state_axis">al_get_mouse_state_axis</a>,
257 <a·href="mouse.html#al_mouse_button_down">al_mouse_button_down</a></p>257 <a·href="mouse.html#al_mouse_button_down">al_mouse_button_down</a></p>
 258 <p>Examples:</p>
 259 <ul>
 260 <li><a
 261 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L4">ex_mouse_focus.c</a></li>
 262 <li><a
 263 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse.c#L34">ex_mouse.c</a></li>
 264 <li><a
 265 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L160">nihgui.cpp</a></li>
 266 </ul>
258 <h1·id="mouse-button-constants">Mouse·button·constants</h1>267 <h1·id="mouse-button-constants">Mouse·button·constants</h1>
259 <p>Unlike·other·indexes,·the·first·mouse·button·is·numbered·1·when268 <p>Unlike·other·indexes,·the·first·mouse·button·is·numbered·1·when
260 returned·in·the·event.mouse.button·field·of269 returned·in·the·event.mouse.button·field·of
261 ALLEGRO_EVENT_MOUSE_BUTTON_UP·and·ALLEGRO_EVENT_MOUSE_BUTTON_DOWN270 ALLEGRO_EVENT_MOUSE_BUTTON_UP·and·ALLEGRO_EVENT_MOUSE_BUTTON_DOWN
262 events.</p>271 events.</p>
263 <p>As·a·convenience,·the·following·ALLEGRO_MOUSE_BUTTON·constants·are272 <p>As·a·convenience,·the·following·ALLEGRO_MOUSE_BUTTON·constants·are
264 provided·below.·However,·depending·on·the·hardware·there·may·be·more·or273 provided·below.·However,·depending·on·the·hardware·there·may·be·more·or
Offset 279, 14 lines modifiedOffset 288, 23 lines modified
279 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_install_mouse<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>288 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_install_mouse<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
280 <p><a289 <p><a
281 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L49">Source290 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L49">Source
282 Code</a></p>291 Code</a></p>
283 <p>Install·a·mouse·driver.</p>292 <p>Install·a·mouse·driver.</p>
284 <p>Returns·true·if·successful.·If·a·driver·was·already·installed,293 <p>Returns·true·if·successful.·If·a·driver·was·already·installed,
285 nothing·happens·and·true·is·returned.</p>294 nothing·happens·and·true·is·returned.</p>
 295 <p>Examples:</p>
 296 <ul>
 297 <li><a
 298 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L41">ex_mouse_focus.c</a></li>
 299 <li><a
 300 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse.c#L46">ex_mouse.c</a></li>
 301 <li><a
 302 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L101">ex_font_justify.cpp</a></li>
 303 </ul>
286 <h1·id="al_is_mouse_installed">al_is_mouse_installed</h1>304 <h1·id="al_is_mouse_installed">al_is_mouse_installed</h1>
287 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_mouse_installed<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>305 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_mouse_installed<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
288 <p><a306 <p><a
289 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L40">Source307 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L40">Source
290 Code</a></p>308 Code</a></p>
291 <p>Returns·true·if·<a309 <p>Returns·true·if·<a
292 href="mouse.html#al_install_mouse">al_install_mouse</a>·was·called310 href="mouse.html#al_install_mouse">al_install_mouse</a>·was·called
Offset 311, 14 lines modifiedOffset 329, 19 lines modified
311 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">unsigned</span>·<span·class="dt">int</span>·al_get_mouse_num_buttons<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>329 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">unsigned</span>·<span·class="dt">int</span>·al_get_mouse_num_buttons<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
312 <p><a330 <p><a
313 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L134">Source331 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L134">Source
314 Code</a></p>332 Code</a></p>
315 <p>Return·the·number·of·buttons·on·the·mouse.·The·first·button·is·1.</p>333 <p>Return·the·number·of·buttons·on·the·mouse.·The·first·button·is·1.</p>
316 <p>See·also:·<a334 <p>See·also:·<a
317 href="mouse.html#al_get_mouse_num_axes">al_get_mouse_num_axes</a></p>335 href="mouse.html#al_get_mouse_num_axes">al_get_mouse_num_axes</a></p>
 336 <p>Examples:</p>
 337 <ul>
 338 <li><a
 339 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_events.c#L68">ex_mouse_events.c</a></li>
 340 </ul>
318 <h1·id="al_get_mouse_state">al_get_mouse_state</h1>341 <h1·id="al_get_mouse_state">al_get_mouse_state</h1>
319 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_get_mouse_state<span·class="op">(</span>ALLEGRO_MOUSE_STATE·<span·class="op">*</span>ret_state<span·class="op">)</span></span></code></pre></div>342 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_get_mouse_state<span·class="op">(</span>ALLEGRO_MOUSE_STATE·<span·class="op">*</span>ret_state<span·class="op">)</span></span></code></pre></div>
320 <p><a343 <p><a
321 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L209">Source344 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L209">Source
322 Code</a></p>345 Code</a></p>
323 <p>Save·the·state·of·the·mouse·specified·at·the·time·the·function·is346 <p>Save·the·state·of·the·mouse·specified·at·the·time·the·function·is
324 called·into·the·given·structure.</p>347 called·into·the·given·structure.</p>
Offset 336, 14 lines modifiedOffset 359, 23 lines modified
336 <span·id="cb10-11"><a·href="#cb10-11"·aria-hidden="true"·tabindex="-1"></a><span·class="cf">if</span>·<span·class="op">(</span>state<span·class="op">.</span>buttons·<span·class="op">&amp;</span>·<span·class="dv">4</span><span·class="op">)</span>·<span·class="op">{</span></span>359 <span·id="cb10-11"><a·href="#cb10-11"·aria-hidden="true"·tabindex="-1"></a><span·class="cf">if</span>·<span·class="op">(</span>state<span·class="op">.</span>buttons·<span·class="op">&amp;</span>·<span·class="dv">4</span><span·class="op">)</span>·<span·class="op">{</span></span>
337 <span·id="cb10-12"><a·href="#cb10-12"·aria-hidden="true"·tabindex="-1"></a>····<span·class="co">/*·Tertiary·(e.g.·middle)·mouse·button·is·held.·*/</span></span>360 <span·id="cb10-12"><a·href="#cb10-12"·aria-hidden="true"·tabindex="-1"></a>····<span·class="co">/*·Tertiary·(e.g.·middle)·mouse·button·is·held.·*/</span></span>
338 <span·id="cb10-13"><a·href="#cb10-13"·aria-hidden="true"·tabindex="-1"></a><span·class="op">}</span></span></code></pre></div>361 <span·id="cb10-13"><a·href="#cb10-13"·aria-hidden="true"·tabindex="-1"></a><span·class="op">}</span></span></code></pre></div>
339 <p>See·also:·<a362 <p>See·also:·<a
340 href="mouse.html#allegro_mouse_state">ALLEGRO_MOUSE_STATE</a>,·<a363 href="mouse.html#allegro_mouse_state">ALLEGRO_MOUSE_STATE</a>,·<a
341 href="mouse.html#al_get_mouse_state_axis">al_get_mouse_state_axis</a>,364 href="mouse.html#al_get_mouse_state_axis">al_get_mouse_state_axis</a>,
342 <a·href="mouse.html#al_mouse_button_down">al_mouse_button_down</a></p>365 <a·href="mouse.html#al_mouse_button_down">al_mouse_button_down</a></p>
 366 <p>Examples:</p>
 367 <ul>
 368 <li><a
 369 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L65">ex_mouse_focus.c</a></li>
 370 <li><a
 371 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse.c#L64">ex_mouse.c</a></li>
 372 <li><a
 373 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L161">nihgui.cpp</a></li>
 374 </ul>
343 <h1·id="al_get_mouse_state_axis">al_get_mouse_state_axis</h1>375 <h1·id="al_get_mouse_state_axis">al_get_mouse_state_axis</h1>
344 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_mouse_state_axis<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_MOUSE_STATE·<span·class="op">*</span>state<span·class="op">,</span>·<span·class="dt">int</span>·axis<span·class="op">)</span></span></code></pre></div>376 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_mouse_state_axis<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_MOUSE_STATE·<span·class="op">*</span>state<span·class="op">,</span>·<span·class="dt">int</span>·axis<span·class="op">)</span></span></code></pre></div>
345 <p><a377 <p><a
346 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L221">Source378 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L221">Source
347 Code</a></p>379 Code</a></p>
348 <p>Extract·the·mouse·axis·value·from·the·saved·state.·The·axes·are380 <p>Extract·the·mouse·axis·value·from·the·saved·state.·The·axes·are
349 numbered·from·0,·in·this·order:·x-axis,·y-axis,·z-axis,·w-axis.</p>381 numbered·from·0,·in·this·order:·x-axis,·y-axis,·z-axis,·w-axis.</p>
Offset 365, 27 lines modifiedOffset 397, 39 lines modified
365 buttons.·You·can·check·<a397 buttons.·You·can·check·<a
366 href="mouse.html#al_get_mouse_num_buttons">al_get_mouse_num_buttons</a>398 href="mouse.html#al_get_mouse_num_buttons">al_get_mouse_num_buttons</a>
367 if·you·want·to·be·sure.</p>399 if·you·want·to·be·sure.</p>
368 <p>See·also:·<a400 <p>See·also:·<a
369 href="mouse.html#allegro_mouse_state">ALLEGRO_MOUSE_STATE</a>,·<a401 href="mouse.html#allegro_mouse_state">ALLEGRO_MOUSE_STATE</a>,·<a
370 href="mouse.html#al_get_mouse_state">al_get_mouse_state</a>,·<a402 href="mouse.html#al_get_mouse_state">al_get_mouse_state</a>,·<a
371 href="mouse.html#al_get_mouse_state_axis">al_get_mouse_state_axis</a></p>403 href="mouse.html#al_get_mouse_state_axis">al_get_mouse_state_axis</a></p>
 404 <p>Examples:</p>
 405 <ul>
 406 <li><a
 407 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse.c#L69">ex_mouse.c</a></li>
 408 </ul>
372 <h1·id="al_set_mouse_xy">al_set_mouse_xy</h1>409 <h1·id="al_set_mouse_xy">al_set_mouse_xy</h1>
373 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_set_mouse_xy<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">,</span>·<span·class="dt">int</span>·x<span·class="op">,</span>·<span·class="dt">int</span>·y<span·class="op">)</span></span></code></pre></div>410 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_set_mouse_xy<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">,</span>·<span·class="dt">int</span>·x<span·class="op">,</span>·<span·class="dt">int</span>·y<span·class="op">)</span></span></code></pre></div>
374 <p><a411 <p><a
375 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L156">Source412 href="https://github.com/liballeg/allegro5/blob/master/src/mousenu.c#L156">Source
376 Code</a></p>413 Code</a></p>
377 <p>Try·to·position·the·mouse·at·the·given·coordinates·on·the·given414 <p>Try·to·position·the·mouse·at·the·given·coordinates·on·the·given
378 display.·The·mouse·movement·resulting·from·a·successful·move·will415 display.·The·mouse·movement·resulting·from·a·successful·move·will
379 generate·an·<a416 generate·an·<a
380 href="events.html#allegro_event_mouse_warped">ALLEGRO_EVENT_MOUSE_WARPED</a>417 href="events.html#allegro_event_mouse_warped">ALLEGRO_EVENT_MOUSE_WARPED</a>
381 event.</p>418 event.</p>
382 <p>Returns·true·on·success,·false·on·failure.</p>419 <p>Returns·true·on·success,·false·on·failure.</p>
383 <p>See·also:·<a·href="mouse.html#al_set_mouse_z">al_set_mouse_z</a>,·<a420 <p>See·also:·<a·href="mouse.html#al_set_mouse_z">al_set_mouse_z</a>,·<a
384 href="mouse.html#al_set_mouse_w">al_set_mouse_w</a></p>421 href="mouse.html#al_set_mouse_w">al_set_mouse_w</a></p>
 422 <p>Examples:</p>
 423 <ul>
 424 <li><a
 425 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_warp.c#L92">ex_mouse_warp.c</a></li>
 426 <li><a
 427 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_ogre3d.cpp#L337">ex_ogre3d.cpp</a></li>
 428 </ul>
385 <h1·id="al_set_mouse_z">al_set_mouse_z</h1>429 <h1·id="al_set_mouse_z">al_set_mouse_z</h1>
386 <div·class="sourceCode"·id="cb14"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb14-1"><a·href="#cb14-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_set_mouse_z<span·class="op">(</span><span·class="dt">int</span>·z<span·class="op">)</span></span></code></pre></div>430 <div·class="sourceCode"·id="cb14"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb14-1"><a·href="#cb14-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_set_mouse_z<span·class="op">(</span><span·class="dt">int</span>·z<span·class="op">)</span></span></code></pre></div>
387 <p><a431 <p><a
Max diff block lines reached; 12112/20306 bytes (59.65%) of diff not shown.
14.0 KB
html2text {}
    
Offset 81, 14 lines modifiedOffset 81, 18 lines modified
81 ····*·y·-·mouse·y·position81 ····*·y·-·mouse·y·position
82 ····*·w,·z·-·mouse·wheel·position·(2D·‘ball’)82 ····*·w,·z·-·mouse·wheel·position·(2D·‘ball’)
83 ····*·buttons·-·mouse·buttons·bitfield83 ····*·buttons·-·mouse·buttons·bitfield
84 ······The·zeroth·bit·is·set·if·the·primary·mouse·button·is·held·down,·the·first84 ······The·zeroth·bit·is·set·if·the·primary·mouse·button·is·held·down,·the·first
85 ······bit·is·set·if·the·secondary·mouse·button·is·held·down,·and·so·on.85 ······bit·is·set·if·the·secondary·mouse·button·is·held·down,·and·so·on.
86 ····*·pressure·-·pressure,·ranging·from·0.0·to·1.086 ····*·pressure·-·pressure,·ranging·from·0.0·to·1.0
87 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e_\x8__\x8a_\x8x_\x8i_\x8s,·_\x8a_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8d_\x8o_\x8w_\x8n87 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e_\x8__\x8a_\x8x_\x8i_\x8s,·_\x8a_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8d_\x8o_\x8w_\x8n
 88 Examples:
 89 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 90 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8._\x8c
 91 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
88 *\x8**\x8**\x8**\x8**\x8**\x8*·M\x8Mo\x8ou\x8us\x8se\x8e·b\x8bu\x8ut\x8tt\x8to\x8on\x8n·c\x8co\x8on\x8ns\x8st\x8ta\x8an\x8nt\x8ts\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*92 *\x8**\x8**\x8**\x8**\x8**\x8*·M\x8Mo\x8ou\x8us\x8se\x8e·b\x8bu\x8ut\x8tt\x8to\x8on\x8n·c\x8co\x8on\x8ns\x8st\x8ta\x8an\x8nt\x8ts\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
89 Unlike·other·indexes,·the·first·mouse·button·is·numbered·1·when·returned·in·the93 Unlike·other·indexes,·the·first·mouse·button·is·numbered·1·when·returned·in·the
90 event.mouse.button·field·of·ALLEGRO_EVENT_MOUSE_BUTTON_UP·and94 event.mouse.button·field·of·ALLEGRO_EVENT_MOUSE_BUTTON_UP·and
91 ALLEGRO_EVENT_MOUSE_BUTTON_DOWN·events.95 ALLEGRO_EVENT_MOUSE_BUTTON_DOWN·events.
92 As·a·convenience,·the·following·ALLEGRO_MOUSE_BUTTON·constants·are·provided96 As·a·convenience,·the·following·ALLEGRO_MOUSE_BUTTON·constants·are·provided
93 below.·However,·depending·on·the·hardware·there·may·be·more·or·fewer·mouse97 below.·However,·depending·on·the·hardware·there·may·be·more·or·fewer·mouse
94 buttons.·You·can·check·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8s·if·you·want·to·be·sure.98 buttons.·You·can·check·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8s·if·you·want·to·be·sure.
Offset 102, 14 lines modifiedOffset 106, 18 lines modified
102 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8s,·_\x8a_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8d_\x8o_\x8w_\x8n106 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8s,·_\x8a_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8d_\x8o_\x8w_\x8n
103 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_m\x8mo\x8ou\x8us\x8se\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*107 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_m\x8mo\x8ou\x8us\x8se\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
104 bool·al_install_mouse(void)108 bool·al_install_mouse(void)
105 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e109 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
106 Install·a·mouse·driver.110 Install·a·mouse·driver.
107 Returns·true·if·successful.·If·a·driver·was·already·installed,·nothing·happens111 Returns·true·if·successful.·If·a·driver·was·already·installed,·nothing·happens
108 and·true·is·returned.112 and·true·is·returned.
 113 Examples:
 114 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 115 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8._\x8c
 116 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8j_\x8u_\x8s_\x8t_\x8i_\x8f_\x8y_\x8._\x8c_\x8p_\x8p
109 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*117 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
110 bool·al_is_mouse_installed(void)118 bool·al_is_mouse_installed(void)
111 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e119 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
112 Returns·true·if·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e·was·called·successfully.120 Returns·true·if·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e·was·called·successfully.
113 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_m\x8mo\x8ou\x8us\x8se\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*121 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_m\x8mo\x8ou\x8us\x8se\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
114 void·al_uninstall_mouse(void)122 void·al_uninstall_mouse(void)
115 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e123 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
Offset 122, 14 lines modifiedOffset 130, 16 lines modified
122 Return·the·number·of·axes·on·the·mouse.·The·first·axis·is·0.130 Return·the·number·of·axes·on·the·mouse.·The·first·axis·is·0.
123 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8s131 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8s
124 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_n\x8nu\x8um\x8m_\x8_b\x8bu\x8ut\x8tt\x8to\x8on\x8ns\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*132 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_n\x8nu\x8um\x8m_\x8_b\x8bu\x8ut\x8tt\x8to\x8on\x8ns\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
125 unsigned·int·al_get_mouse_num_buttons(void)133 unsigned·int·al_get_mouse_num_buttons(void)
126 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e134 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
127 Return·the·number·of·buttons·on·the·mouse.·The·first·button·is·1.135 Return·the·number·of·buttons·on·the·mouse.·The·first·button·is·1.
128 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8a_\x8x_\x8e_\x8s136 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8a_\x8x_\x8e_\x8s
 137 Examples:
 138 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
129 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*139 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
130 void·al_get_mouse_state(ALLEGRO_MOUSE_STATE·*ret_state)140 void·al_get_mouse_state(ALLEGRO_MOUSE_STATE·*ret_state)
131 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e141 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
132 Save·the·state·of·the·mouse·specified·at·the·time·the·function·is·called·into142 Save·the·state·of·the·mouse·specified·at·the·time·the·function·is·called·into
133 the·given·structure.143 the·given·structure.
134 Example:144 Example:
135 ALLEGRO_MOUSE_STATE·state;145 ALLEGRO_MOUSE_STATE·state;
Offset 142, 14 lines modifiedOffset 152, 18 lines modified
142 if·(state.buttons·&·2)·{152 if·(state.buttons·&·2)·{
143 ····/*·Secondary·(e.g.·right)·mouse·button·is·held.·*/153 ····/*·Secondary·(e.g.·right)·mouse·button·is·held.·*/
144 }154 }
145 if·(state.buttons·&·4)·{155 if·(state.buttons·&·4)·{
146 ····/*·Tertiary·(e.g.·middle)·mouse·button·is·held.·*/156 ····/*·Tertiary·(e.g.·middle)·mouse·button·is·held.·*/
147 }157 }
148 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8S_\x8T_\x8A_\x8T_\x8E,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e_\x8__\x8a_\x8x_\x8i_\x8s,·_\x8a_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8d_\x8o_\x8w_\x8n158 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8S_\x8T_\x8A_\x8T_\x8E,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e_\x8__\x8a_\x8x_\x8i_\x8s,·_\x8a_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8d_\x8o_\x8w_\x8n
 159 Examples:
 160 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 161 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8._\x8c
 162 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
149 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_s\x8st\x8ta\x8at\x8te\x8e_\x8_a\x8ax\x8xi\x8is\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*163 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_s\x8st\x8ta\x8at\x8te\x8e_\x8_a\x8ax\x8xi\x8is\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
150 int·al_get_mouse_state_axis(const·ALLEGRO_MOUSE_STATE·*state,·int·axis)164 int·al_get_mouse_state_axis(const·ALLEGRO_MOUSE_STATE·*state,·int·axis)
151 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e165 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
152 Extract·the·mouse·axis·value·from·the·saved·state.·The·axes·are·numbered·from166 Extract·the·mouse·axis·value·from·the·saved·state.·The·axes·are·numbered·from
153 0,·in·this·order:·x-axis,·y-axis,·z-axis,·w-axis.167 0,·in·this·order:·x-axis,·y-axis,·z-axis,·w-axis.
154 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8S_\x8T_\x8A_\x8T_\x8E,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8d_\x8o_\x8w_\x8n168 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8S_\x8T_\x8A_\x8T_\x8E,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8__\x8d_\x8o_\x8w_\x8n
155 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_b\x8bu\x8ut\x8tt\x8to\x8on\x8n_\x8_d\x8do\x8ow\x8wn\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*169 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_b\x8bu\x8ut\x8tt\x8to\x8on\x8n_\x8_d\x8do\x8ow\x8wn\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
Offset 158, 48 lines modifiedOffset 172, 59 lines modified
158 Return·true·if·the·mouse·button·specified·was·held·down·in·the·state·specified.172 Return·true·if·the·mouse·button·specified·was·held·down·in·the·state·specified.
159 Unlike·most·things,·the·first·mouse·button·is·numbered·1.·As·a·convenience,·the173 Unlike·most·things,·the·first·mouse·button·is·numbered·1.·As·a·convenience,·the
160 constants·ALLEGRO_MOUSE_BUTTON_LEFT,·ALLEGRO_MOUSE_BUTTON_RIGHT,174 constants·ALLEGRO_MOUSE_BUTTON_LEFT,·ALLEGRO_MOUSE_BUTTON_RIGHT,
161 ALLEGRO_MOUSE_BUTTON_MIDDLE·are·provided.·However,·depending·on·the·hardware175 ALLEGRO_MOUSE_BUTTON_MIDDLE·are·provided.·However,·depending·on·the·hardware
162 there·may·be·more·or·fewer·mouse·buttons.·You·can·check176 there·may·be·more·or·fewer·mouse·buttons.·You·can·check
163 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8s·if·you·want·to·be·sure.177 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8n_\x8u_\x8m_\x8__\x8b_\x8u_\x8t_\x8t_\x8o_\x8n_\x8s·if·you·want·to·be·sure.
164 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8S_\x8T_\x8A_\x8T_\x8E,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e_\x8__\x8a_\x8x_\x8i_\x8s178 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8S_\x8T_\x8A_\x8T_\x8E,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e_\x8__\x8a_\x8x_\x8i_\x8s
 179 Examples:
 180 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8._\x8c
165 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_x\x8xy\x8y·*\x8**\x8**\x8**\x8**\x8**\x8*181 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_x\x8xy\x8y·*\x8**\x8**\x8**\x8**\x8**\x8*
166 bool·al_set_mouse_xy(ALLEGRO_DISPLAY·*display,·int·x,·int·y)182 bool·al_set_mouse_xy(ALLEGRO_DISPLAY·*display,·int·x,·int·y)
167 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e183 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
168 Try·to·position·the·mouse·at·the·given·coordinates·on·the·given·display.·The184 Try·to·position·the·mouse·at·the·given·coordinates·on·the·given·display.·The
169 mouse·movement·resulting·from·a·successful·move·will·generate·an185 mouse·movement·resulting·from·a·successful·move·will·generate·an
170 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8W_\x8A_\x8R_\x8P_\x8E_\x8D·event.186 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8W_\x8A_\x8R_\x8P_\x8E_\x8D·event.
171 Returns·true·on·success,·false·on·failure.187 Returns·true·on·success,·false·on·failure.
172 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8z,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w188 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8z,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w
 189 Examples:
 190 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w_\x8a_\x8r_\x8p_\x8._\x8c
 191 ····*·_\x8e_\x8x_\x8__\x8o_\x8g_\x8r_\x8e_\x83_\x8d_\x8._\x8c_\x8p_\x8p
173 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_z\x8z·*\x8**\x8**\x8**\x8**\x8**\x8*192 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_z\x8z·*\x8**\x8**\x8**\x8**\x8**\x8*
174 bool·al_set_mouse_z(int·z)193 bool·al_set_mouse_z(int·z)
175 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e194 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
176 Set·the·mouse·wheel·position·to·the·given·value.195 Set·the·mouse·wheel·position·to·the·given·value.
177 Returns·true·on·success,·false·on·failure.196 Returns·true·on·success,·false·on·failure.
178 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w197 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w
179 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_w\x8w·*\x8**\x8**\x8**\x8**\x8**\x8*198 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_w\x8w·*\x8**\x8**\x8**\x8**\x8**\x8*
180 bool·al_set_mouse_w(int·w)199 bool·al_set_mouse_w(int·w)
181 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e200 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
182 Set·the·second·mouse·wheel·position·to·the·given·value.201 Set·the·second·mouse·wheel·position·to·the·given·value.
183 Returns·true·on·success,·false·on·failure.202 Returns·true·on·success,·false·on·failure.
184 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8z203 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8z
 204 Examples:
 205 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
185 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_a\x8ax\x8xi\x8is\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*206 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_a\x8ax\x8xi\x8is\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
186 bool·al_set_mouse_axis(int·which,·int·value)207 bool·al_set_mouse_axis(int·which,·int·value)
187 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e208 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
188 Set·the·given·mouse·axis·to·the·given·value.209 Set·the·given·mouse·axis·to·the·given·value.
189 The·axis·number·must·not·be·0·or·1,·which·are·the·X·and·Y·axes.·Use210 The·axis·number·must·not·be·0·or·1,·which·are·the·X·and·Y·axes.·Use
190 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8x_\x8y·for·that.211 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8x_\x8y·for·that.
191 Returns·true·on·success,·false·on·failure.212 Returns·true·on·success,·false·on·failure.
192 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8x_\x8y,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8z,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w213 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8x_\x8y,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8z,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w
193 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*214 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
194 ALLEGRO_EVENT_SOURCE·*al_get_mouse_event_source(void)215 ALLEGRO_EVENT_SOURCE·*al_get_mouse_event_source(void)
195 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e216 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
196 Retrieve·the·mouse·event·source.·All·_\x8m_\x8o_\x8u_\x8s_\x8e_\x8·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s·are·generated·by·this·event217 Retrieve·the·mouse·event·source.·All·_\x8m_\x8o_\x8u_\x8s_\x8e_\x8·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s·are·generated·by·this·event
197 source.218 source.
198 Returns·NULL·if·the·mouse·subsystem·was·not·installed.219 Returns·NULL·if·the·mouse·subsystem·was·not·installed.
 220 Examples:
 221 ····*·_\x8e_\x8x_\x8__\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 222 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w_\x8a_\x8r_\x8p_\x8._\x8c
 223 ····*·_\x8e_\x8x_\x8__\x8n_\x8o_\x8f_\x8r_\x8a_\x8m_\x8e_\x8._\x8c
199 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_w\x8wh\x8he\x8ee\x8el\x8l_\x8_p\x8pr\x8re\x8ec\x8ci\x8is\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*224 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_w\x8wh\x8he\x8ee\x8el\x8l_\x8_p\x8pr\x8re\x8ec\x8ci\x8is\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
Max diff block lines reached; 6609/14272 bytes (46.31%) of diff not shown.
59.5 KB
./usr/share/doc/allegro5-doc/refman/native_dialog.html
    
Offset 267, 20 lines modifiedOffset 267, 32 lines modified
267 <div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"·tabindex="-1"></a>·<span·class="pp">#include·</span><span·class="im">&lt;allegro5/allegro_native_dialog.h&gt;</span></span></code></pre></div>267 <div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"·tabindex="-1"></a>·<span·class="pp">#include·</span><span·class="im">&lt;allegro5/allegro_native_dialog.h&gt;</span></span></code></pre></div>
268 <h1·id="allegro_filechooser">ALLEGRO_FILECHOOSER</h1>268 <h1·id="allegro_filechooser">ALLEGRO_FILECHOOSER</h1>
269 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILECHOOSER·ALLEGRO_FILECHOOSER<span·class="op">;</span></span></code></pre></div>269 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILECHOOSER·ALLEGRO_FILECHOOSER<span·class="op">;</span></span></code></pre></div>
270 <p><a270 <p><a
271 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/allegro5/allegro_native_dialog.h#L38">Source271 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/allegro5/allegro_native_dialog.h#L38">Source
272 Code</a></p>272 Code</a></p>
273 <p>Opaque·handle·to·a·native·file·dialog.</p>273 <p>Opaque·handle·to·a·native·file·dialog.</p>
 274 <p>Examples:</p>
 275 <ul>
 276 <li><a
 277 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L31">ex_native_filechooser.c</a></li>
 278 </ul>
274 <h1·id="allegro_textlog">ALLEGRO_TEXTLOG</h1>279 <h1·id="allegro_textlog">ALLEGRO_TEXTLOG</h1>
275 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_TEXTLOG·ALLEGRO_TEXTLOG<span·class="op">;</span></span></code></pre></div>280 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_TEXTLOG·ALLEGRO_TEXTLOG<span·class="op">;</span></span></code></pre></div>
276 <p><a281 <p><a
277 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/allegro5/allegro_native_dialog.h#L42">Source282 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/allegro5/allegro_native_dialog.h#L42">Source
278 Code</a></p>283 Code</a></p>
279 <p>Opaque·handle·to·a·text·log·window.</p>284 <p>Opaque·handle·to·a·text·log·window.</p>
 285 <p>Examples:</p>
 286 <ul>
 287 <li><a
 288 href="https://github.com/liballeg/allegro5/blob/master/examples/common.c#L27">common.c</a></li>
 289 <li><a
 290 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L36">ex_native_filechooser.c</a></li>
 291 </ul>
280 <h1·id="al_init_native_dialog_addon">al_init_native_dialog_addon</h1>292 <h1·id="al_init_native_dialog_addon">al_init_native_dialog_addon</h1>
281 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_init_native_dialog_addon<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>293 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_init_native_dialog_addon<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
282 <p><a294 <p><a
283 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L18">Source295 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L18">Source
284 Code</a></p>296 Code</a></p>
285 <p>Initialise·the·native·dialog·addon.</p>297 <p>Initialise·the·native·dialog·addon.</p>
286 <p>Returns·true·on·success,·false·on·error.</p>298 <p>Returns·true·on·success,·false·on·error.</p>
Offset 292, 14 lines modifiedOffset 304, 23 lines modified
292 is·<a304 is·<a
293 href="native_dialog.html#al_show_native_message_box">al_show_native_message_box</a>,305 href="native_dialog.html#al_show_native_message_box">al_show_native_message_box</a>,
294 which·may·be·useful·to·show·an·error·message·if·Allegro·fails·to306 which·may·be·useful·to·show·an·error·message·if·Allegro·fails·to
295 initialise.</p>307 initialise.</p>
296 </blockquote>308 </blockquote>
297 <p>See·also:·<a309 <p>See·also:·<a
298 href="native_dialog.html#al_shutdown_native_dialog_addon">al_shutdown_native_dialog_addon</a></p>310 href="native_dialog.html#al_shutdown_native_dialog_addon">al_shutdown_native_dialog_addon</a></p>
 311 <p>Examples:</p>
 312 <ul>
 313 <li><a
 314 href="https://github.com/liballeg/allegro5/blob/master/examples/common.c#L39">common.c</a></li>
 315 <li><a
 316 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_window_maximized.c#L58">ex_window_maximized.c</a></li>
 317 <li><a
 318 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_menu.c#L83">ex_menu.c</a></li>
 319 </ul>
299 <h1320 <h1
300 id="al_is_native_dialog_addon_initialized">al_is_native_dialog_addon_initialized</h1>321 id="al_is_native_dialog_addon_initialized">al_is_native_dialog_addon_initialized</h1>
301 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_native_dialog_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>322 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_native_dialog_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
302 <p><a323 <p><a
303 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L35">Source324 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L35">Source
304 Code</a></p>325 Code</a></p>
305 <p>Returns·true·if·the·native·dialog·addon·is·initialized,·otherwise326 <p>Returns·true·if·the·native·dialog·addon·is·initialized,·otherwise
Offset 406, 14 lines modifiedOffset 427, 19 lines modified
406 and·<a427 and·<a
407 href="native_dialog.html#al_get_native_file_dialog_path">al_get_native_file_dialog_path</a>.428 href="native_dialog.html#al_get_native_file_dialog_path">al_get_native_file_dialog_path</a>.
408 When·you·are·done,·call·<a429 When·you·are·done,·call·<a
409 href="native_dialog.html#al_destroy_native_file_dialog">al_destroy_native_file_dialog</a>430 href="native_dialog.html#al_destroy_native_file_dialog">al_destroy_native_file_dialog</a>
410 on·it.</p>431 on·it.</p>
411 <p>If·a·dialog·window·could·not·be·created·then·this·function·returns432 <p>If·a·dialog·window·could·not·be·created·then·this·function·returns
412 NULL.</p>433 NULL.</p>
 434 <p>Examples:</p>
 435 <ul>
 436 <li><a
 437 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L105">ex_native_filechooser.c</a></li>
 438 </ul>
413 <h1·id="al_show_native_file_dialog">al_show_native_file_dialog</h1>439 <h1·id="al_show_native_file_dialog">al_show_native_file_dialog</h1>
414 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_show_native_file_dialog<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">,</span></span>440 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_show_native_file_dialog<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">,</span></span>
415 <span·id="cb8-2"><a·href="#cb8-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_FILECHOOSER·<span·class="op">*</span>dialog<span·class="op">)</span></span></code></pre></div>441 <span·id="cb8-2"><a·href="#cb8-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_FILECHOOSER·<span·class="op">*</span>dialog<span·class="op">)</span></span></code></pre></div>
416 <p><a442 <p><a
417 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L78">Source443 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L78">Source
418 Code</a></p>444 Code</a></p>
419 <p>Show·the·dialog·window.·The·display·may·be·NULL,·otherwise·the·given445 <p>Show·the·dialog·window.·The·display·may·be·NULL,·otherwise·the·given
Offset 427, 22 lines modifiedOffset 453, 32 lines modified
427 <p><em>Note:</em>·On·Android,·<a453 <p><em>Note:</em>·On·Android,·<a
428 href="events.html#allegro_event_display_halt_drawing">ALLEGRO_EVENT_DISPLAY_HALT_DRAWING</a>454 href="events.html#allegro_event_display_halt_drawing">ALLEGRO_EVENT_DISPLAY_HALT_DRAWING</a>
429 and·<a455 and·<a
430 href="events.html#allegro_event_display_resume_drawing">ALLEGRO_EVENT_DISPLAY_RESUME_DRAWING</a>456 href="events.html#allegro_event_display_resume_drawing">ALLEGRO_EVENT_DISPLAY_RESUME_DRAWING</a>
431 need·to·be·handled·before·this·function·returns.·This·means·that·you457 need·to·be·handled·before·this·function·returns.·This·means·that·you
432 must·call·it·from·a·different·thread.</p>458 must·call·it·from·a·different·thread.</p>
433 </blockquote>459 </blockquote>
 460 <p>Examples:</p>
 461 <ul>
 462 <li><a
 463 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L59">ex_native_filechooser.c</a></li>
 464 </ul>
434 <h1465 <h1
435 id="al_get_native_file_dialog_count">al_get_native_file_dialog_count</h1>466 id="al_get_native_file_dialog_count">al_get_native_file_dialog_count</h1>
436 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_native_file_dialog_count<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_FILECHOOSER·<span·class="op">*</span>dialog<span·class="op">)</span></span></code></pre></div>467 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_native_file_dialog_count<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_FILECHOOSER·<span·class="op">*</span>dialog<span·class="op">)</span></span></code></pre></div>
437 <p><a468 <p><a
438 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L87">Source469 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L87">Source
439 Code</a></p>470 Code</a></p>
440 <p>Returns·the·number·of·files·selected,·or·0·if·the·dialog·was471 <p>Returns·the·number·of·files·selected,·or·0·if·the·dialog·was
441 cancelled.</p>472 cancelled.</p>
 473 <p>Examples:</p>
 474 <ul>
 475 <li><a
 476 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L148">ex_native_filechooser.c</a></li>
 477 </ul>
442 <h1478 <h1
443 id="al_get_native_file_dialog_path">al_get_native_file_dialog_path</h1>479 id="al_get_native_file_dialog_path">al_get_native_file_dialog_path</h1>
444 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>al_get_native_file_dialog_path<span·class="op">(</span></span>480 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>al_get_native_file_dialog_path<span·class="op">(</span></span>
445 <span·id="cb10-2"><a·href="#cb10-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">const</span>·ALLEGRO_FILECHOOSER·<span·class="op">*</span>dialog<span·class="op">,</span>·<span·class="dt">size_t</span>·i<span·class="op">)</span></span></code></pre></div>481 <span·id="cb10-2"><a·href="#cb10-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">const</span>·ALLEGRO_FILECHOOSER·<span·class="op">*</span>dialog<span·class="op">,</span>·<span·class="dt">size_t</span>·i<span·class="op">)</span></span></code></pre></div>
446 <p><a482 <p><a
447 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L95">Source483 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L95">Source
448 Code</a></p>484 Code</a></p>
Offset 452, 21 lines modifiedOffset 488, 31 lines modified
452 <code>-1</code>.</p>488 <code>-1</code>.</p>
453 <blockquote>489 <blockquote>
454 <p><em>Note:</em>·On·Android,·this·function·returns·a·content://490 <p><em>Note:</em>·On·Android,·this·function·returns·a·content://
455 Universal·Resource·Identifier·instead·of·a·file·path·due·to·the491 Universal·Resource·Identifier·instead·of·a·file·path·due·to·the
456 constraints·of·Scoped·Storage.·Selected·files·may·be·accessed·using·<a492 constraints·of·Scoped·Storage.·Selected·files·may·be·accessed·using·<a
457 href="platform.html#al_android_open_fd">al_android_open_fd</a>.</p>493 href="platform.html#al_android_open_fd">al_android_open_fd</a>.</p>
458 </blockquote>494 </blockquote>
 495 <p>Examples:</p>
 496 <ul>
 497 <li><a
 498 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L155">ex_native_filechooser.c</a></li>
 499 </ul>
459 <h1500 <h1
460 id="al_destroy_native_file_dialog">al_destroy_native_file_dialog</h1>501 id="al_destroy_native_file_dialog">al_destroy_native_file_dialog</h1>
461 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_native_file_dialog<span·class="op">(</span>ALLEGRO_FILECHOOSER·<span·class="op">*</span>dialog<span·class="op">)</span></span></code></pre></div>502 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_native_file_dialog<span·class="op">(</span>ALLEGRO_FILECHOOSER·<span·class="op">*</span>dialog<span·class="op">)</span></span></code></pre></div>
462 <p><a503 <p><a
463 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L106">Source504 href="https://github.com/liballeg/allegro5/blob/master/addons/native_dialog/dialog.c#L106">Source
Max diff block lines reached; 29555/37769 bytes (78.25%) of diff not shown.
22.5 KB
html2text {}
    
Offset 90, 30 lines modifiedOffset 90, 39 lines modified
90 These·functions·are·declared·in·the·following·header·file.·Link·with90 These·functions·are·declared·in·the·following·header·file.·Link·with
91 allegro_dialog.91 allegro_dialog.
92 ·#include·<allegro5/allegro_native_dialog.h>92 ·#include·<allegro5/allegro_native_dialog.h>
93 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FI\x8IL\x8LE\x8EC\x8CH\x8HO\x8OO\x8OS\x8SE\x8ER\x8R·*\x8**\x8**\x8**\x8**\x8**\x8*93 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_F\x8FI\x8IL\x8LE\x8EC\x8CH\x8HO\x8OO\x8OS\x8SE\x8ER\x8R·*\x8**\x8**\x8**\x8**\x8**\x8*
94 typedef·struct·ALLEGRO_FILECHOOSER·ALLEGRO_FILECHOOSER;94 typedef·struct·ALLEGRO_FILECHOOSER·ALLEGRO_FILECHOOSER;
95 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e95 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
96 Opaque·handle·to·a·native·file·dialog.96 Opaque·handle·to·a·native·file·dialog.
 97 Examples:
 98 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
97 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_T\x8TE\x8EX\x8XT\x8TL\x8LO\x8OG\x8G·*\x8**\x8**\x8**\x8**\x8**\x8*99 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_T\x8TE\x8EX\x8XT\x8TL\x8LO\x8OG\x8G·*\x8**\x8**\x8**\x8**\x8**\x8*
98 typedef·struct·ALLEGRO_TEXTLOG·ALLEGRO_TEXTLOG;100 typedef·struct·ALLEGRO_TEXTLOG·ALLEGRO_TEXTLOG;
99 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e101 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
100 Opaque·handle·to·a·text·log·window.102 Opaque·handle·to·a·text·log·window.
 103 Examples:
 104 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c
 105 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
101 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*106 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
102 bool·al_init_native_dialog_addon(void)107 bool·al_init_native_dialog_addon(void)
103 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e108 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
104 Initialise·the·native·dialog·addon.109 Initialise·the·native·dialog·addon.
105 Returns·true·on·success,·false·on·error.110 Returns·true·on·success,·false·on·error.
106 Since:·5.0.9,·5.1.0111 Since:·5.0.9,·5.1.0
107 ·····N\x8No\x8ot\x8te\x8e:\x8:·Prior·to·Allegro·5.1.0·native·dialog·functions·could·be·called112 ·····N\x8No\x8ot\x8te\x8e:\x8:·Prior·to·Allegro·5.1.0·native·dialog·functions·could·be·called
108 ·····without·explicit·initialisation,·but·that·is·now·deprecated.·Future113 ·····without·explicit·initialisation,·but·that·is·now·deprecated.·Future
109 ·····functionality·may·require·explicit·initialisation.·An·exception·is114 ·····functionality·may·require·explicit·initialisation.·An·exception·is
110 ·····_\x8a_\x8l_\x8__\x8s_\x8h_\x8o_\x8w_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8m_\x8e_\x8s_\x8s_\x8a_\x8g_\x8e_\x8__\x8b_\x8o_\x8x,·which·may·be·useful·to·show·an·error115 ·····_\x8a_\x8l_\x8__\x8s_\x8h_\x8o_\x8w_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8m_\x8e_\x8s_\x8s_\x8a_\x8g_\x8e_\x8__\x8b_\x8o_\x8x,·which·may·be·useful·to·show·an·error
111 ·····message·if·Allegro·fails·to·initialise.116 ·····message·if·Allegro·fails·to·initialise.
112 See·also:·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8__\x8a_\x8d_\x8d_\x8o_\x8n117 See·also:·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8__\x8a_\x8d_\x8d_\x8o_\x8n
 118 Examples:
 119 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c
 120 ····*·_\x8e_\x8x_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8m_\x8a_\x8x_\x8i_\x8m_\x8i_\x8z_\x8e_\x8d_\x8._\x8c
 121 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8n_\x8u_\x8._\x8c
113 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*122 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
114 bool·al_is_native_dialog_addon_initialized(void)123 bool·al_is_native_dialog_addon_initialized(void)
115 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e124 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
116 Returns·true·if·the·native·dialog·addon·is·initialized,·otherwise·returns125 Returns·true·if·the·native·dialog·addon·is·initialized,·otherwise·returns
117 false.126 false.
118 Since:·5.2.6127 Since:·5.2.6
119 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*128 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
Offset 180, 45 lines modifiedOffset 189, 55 lines modified
180 ······If·supported,·allow·selecting·multiple·files.189 ······If·supported,·allow·selecting·multiple·files.
181 Returns:190 Returns:
182 A·handle·to·the·dialog·which·you·can·pass·to·_\x8a_\x8l_\x8__\x8s_\x8h_\x8o_\x8w_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g·to191 A·handle·to·the·dialog·which·you·can·pass·to·_\x8a_\x8l_\x8__\x8s_\x8h_\x8o_\x8w_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g·to
183 display·it,·and·from·which·you·then·can·query·the·results·using192 display·it,·and·from·which·you·then·can·query·the·results·using
184 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8__\x8c_\x8o_\x8u_\x8n_\x8t·and·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8__\x8p_\x8a_\x8t_\x8h.·When·you193 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8__\x8c_\x8o_\x8u_\x8n_\x8t·and·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8__\x8p_\x8a_\x8t_\x8h.·When·you
185 are·done,·call·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g·on·it.194 are·done,·call·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g·on·it.
186 If·a·dialog·window·could·not·be·created·then·this·function·returns·NULL.195 If·a·dialog·window·could·not·be·created·then·this·function·returns·NULL.
 196 Examples:
 197 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
187 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8ho\x8ow\x8w_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_f\x8fi\x8il\x8le\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*198 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8ho\x8ow\x8w_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_f\x8fi\x8il\x8le\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*
188 bool·al_show_native_file_dialog(ALLEGRO_DISPLAY·*display,199 bool·al_show_native_file_dialog(ALLEGRO_DISPLAY·*display,
189 ···ALLEGRO_FILECHOOSER·*dialog)200 ···ALLEGRO_FILECHOOSER·*dialog)
190 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e201 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
191 Show·the·dialog·window.·The·display·may·be·NULL,·otherwise·the·given·display·is202 Show·the·dialog·window.·The·display·may·be·NULL,·otherwise·the·given·display·is
192 treated·as·the·parent·if·possible.203 treated·as·the·parent·if·possible.
193 This·function·blocks·the·calling·thread·until·it·returns,·so·you·may·want·to204 This·function·blocks·the·calling·thread·until·it·returns,·so·you·may·want·to
194 spawn·a·thread·with·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·and·call·it·from·inside·that·thread.205 spawn·a·thread·with·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·and·call·it·from·inside·that·thread.
195 Returns·true·on·success,·false·on·failure.206 Returns·true·on·success,·false·on·failure.
196 ·····N\x8No\x8ot\x8te\x8e:\x8:·On·Android,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8D_\x8I_\x8S_\x8P_\x8L_\x8A_\x8Y_\x8__\x8H_\x8A_\x8L_\x8T_\x8__\x8D_\x8R_\x8A_\x8W_\x8I_\x8N_\x8G·and207 ·····N\x8No\x8ot\x8te\x8e:\x8:·On·Android,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8D_\x8I_\x8S_\x8P_\x8L_\x8A_\x8Y_\x8__\x8H_\x8A_\x8L_\x8T_\x8__\x8D_\x8R_\x8A_\x8W_\x8I_\x8N_\x8G·and
197 ·····_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8D_\x8I_\x8S_\x8P_\x8L_\x8A_\x8Y_\x8__\x8R_\x8E_\x8S_\x8U_\x8M_\x8E_\x8__\x8D_\x8R_\x8A_\x8W_\x8I_\x8N_\x8G·need·to·be·handled·before·this208 ·····_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8D_\x8I_\x8S_\x8P_\x8L_\x8A_\x8Y_\x8__\x8R_\x8E_\x8S_\x8U_\x8M_\x8E_\x8__\x8D_\x8R_\x8A_\x8W_\x8I_\x8N_\x8G·need·to·be·handled·before·this
198 ·····function·returns.·This·means·that·you·must·call·it·from·a·different209 ·····function·returns.·This·means·that·you·must·call·it·from·a·different
199 ·····thread.210 ·····thread.
 211 Examples:
 212 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
200 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_f\x8fi\x8il\x8le\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_c\x8co\x8ou\x8un\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*213 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_f\x8fi\x8il\x8le\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_c\x8co\x8ou\x8un\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
201 int·al_get_native_file_dialog_count(const·ALLEGRO_FILECHOOSER·*dialog)214 int·al_get_native_file_dialog_count(const·ALLEGRO_FILECHOOSER·*dialog)
202 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e215 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
203 Returns·the·number·of·files·selected,·or·0·if·the·dialog·was·cancelled.216 Returns·the·number·of·files·selected,·or·0·if·the·dialog·was·cancelled.
 217 Examples:
 218 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
204 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_f\x8fi\x8il\x8le\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_p\x8pa\x8at\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*219 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_f\x8fi\x8il\x8le\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g_\x8_p\x8pa\x8at\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*
205 const·char·*al_get_native_file_dialog_path(220 const·char·*al_get_native_file_dialog_path(
206 ···const·ALLEGRO_FILECHOOSER·*dialog,·size_t·i)221 ···const·ALLEGRO_FILECHOOSER·*dialog,·size_t·i)
207 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e222 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
208 Returns·one·of·the·selected·paths·with·index·i.·The·index·should·range·from·0223 Returns·one·of·the·selected·paths·with·index·i.·The·index·should·range·from·0
209 to·the·return·value·of·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8__\x8c_\x8o_\x8u_\x8n_\x8t·-1.224 to·the·return·value·of·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8d_\x8i_\x8a_\x8l_\x8o_\x8g_\x8__\x8c_\x8o_\x8u_\x8n_\x8t·-1.
210 ·····N\x8No\x8ot\x8te\x8e:\x8:·On·Android,·this·function·returns·a·content://·Universal225 ·····N\x8No\x8ot\x8te\x8e:\x8:·On·Android,·this·function·returns·a·content://·Universal
211 ·····Resource·Identifier·instead·of·a·file·path·due·to·the·constraints·of226 ·····Resource·Identifier·instead·of·a·file·path·due·to·the·constraints·of
212 ·····Scoped·Storage.·Selected·files·may·be·accessed·using227 ·····Scoped·Storage.·Selected·files·may·be·accessed·using
213 ·····_\x8a_\x8l_\x8__\x8a_\x8n_\x8d_\x8r_\x8o_\x8i_\x8d_\x8__\x8o_\x8p_\x8e_\x8n_\x8__\x8f_\x8d.228 ·····_\x8a_\x8l_\x8__\x8a_\x8n_\x8d_\x8r_\x8o_\x8i_\x8d_\x8__\x8o_\x8p_\x8e_\x8n_\x8__\x8f_\x8d.
 229 Examples:
 230 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
214 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_f\x8fi\x8il\x8le\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*231 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_f\x8fi\x8il\x8le\x8e_\x8_d\x8di\x8ia\x8al\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*
215 void·al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER·*dialog)232 void·al_destroy_native_file_dialog(ALLEGRO_FILECHOOSER·*dialog)
216 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e233 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
217 Frees·up·all·resources·used·by·the·file·dialog.234 Frees·up·all·resources·used·by·the·file·dialog.
 235 Examples:
 236 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
218 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8ho\x8ow\x8w_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_m\x8me\x8es\x8ss\x8sa\x8ag\x8ge\x8e_\x8_b\x8bo\x8ox\x8x·*\x8**\x8**\x8**\x8**\x8**\x8*237 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8ho\x8ow\x8w_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_m\x8me\x8es\x8ss\x8sa\x8ag\x8ge\x8e_\x8_b\x8bo\x8ox\x8x·*\x8**\x8**\x8**\x8**\x8**\x8*
219 int·al_show_native_message_box(ALLEGRO_DISPLAY·*display,238 int·al_show_native_message_box(ALLEGRO_DISPLAY·*display,
220 ···char·const·*title,·char·const·*heading,·char·const·*text,239 ···char·const·*title,·char·const·*heading,·char·const·*text,
221 ···char·const·*buttons,·int·flags)240 ···char·const·*buttons,·int·flags)
222 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e241 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
223 Show·a·native·GUI·message·box.·This·can·be·used·for·example·to·display·an·error242 Show·a·native·GUI·message·box.·This·can·be·used·for·example·to·display·an·error
224 message·if·creation·of·an·initial·display·fails.·The·display·may·be·NULL,243 message·if·creation·of·an·initial·display·fails.·The·display·may·be·NULL,
Offset 261, 14 lines modifiedOffset 280, 18 lines modified
261 ··"If·you·click·yes·then·you·are·confirming·that·\"Yes\"·"280 ··"If·you·click·yes·then·you·are·confirming·that·\"Yes\"·"
262 ··"is·your·response·to·the·query·which·you·have·"281 ··"is·your·response·to·the·query·which·you·have·"
263 ··"generated·by·the·action·you·took·to·open·this·"282 ··"generated·by·the·action·you·took·to·open·this·"
264 ··"message·box.",283 ··"message·box.",
265 ··NULL,284 ··NULL,
266 ··ALLEGRO_MESSAGEBOX_YES_NO285 ··ALLEGRO_MESSAGEBOX_YES_NO
267 );286 );
 287 Examples:
 288 ····*·_\x8e_\x8x_\x8__\x8n_\x8o_\x8d_\x8i_\x8s_\x8p_\x8l_\x8a_\x8y_\x8._\x8c
 289 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c
 290 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8n_\x8u_\x8._\x8c
268 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_o\x8op\x8pe\x8en\x8n_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_t\x8te\x8ex\x8xt\x8t_\x8_l\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*291 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_o\x8op\x8pe\x8en\x8n_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_t\x8te\x8ex\x8xt\x8t_\x8_l\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*
269 ALLEGRO_TEXTLOG·*al_open_native_text_log(char·const·*title,·int·flags)292 ALLEGRO_TEXTLOG·*al_open_native_text_log(char·const·*title,·int·flags)
270 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e293 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
271 Opens·a·window·to·which·you·can·append·log·messages·with294 Opens·a·window·to·which·you·can·append·log·messages·with
272 _\x8a_\x8l_\x8__\x8a_\x8p_\x8p_\x8e_\x8n_\x8d_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g.·This·can·be·useful·for·debugging·if·you·don’t·want295 _\x8a_\x8l_\x8__\x8a_\x8p_\x8p_\x8e_\x8n_\x8d_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g.·This·can·be·useful·for·debugging·if·you·don’t·want
273 to·depend·on·a·console·being·available.296 to·depend·on·a·console·being·available.
274 Use·_\x8a_\x8l_\x8__\x8c_\x8l_\x8o_\x8s_\x8e_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g·to·close·the·window·again.297 Use·_\x8a_\x8l_\x8__\x8c_\x8l_\x8o_\x8s_\x8e_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g·to·close·the·window·again.
Offset 279, 40 lines modifiedOffset 302, 53 lines modified
279 ······_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e.302 ······_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e.
280 ··ALLEGRO_TEXTLOG_MONOSPACE303 ··ALLEGRO_TEXTLOG_MONOSPACE
281 ······Use·a·monospace·font·to·display·the·text.304 ······Use·a·monospace·font·to·display·the·text.
282 Returns·NULL·if·there·was·an·error·opening·the·window,·or·if·text·log·windows305 Returns·NULL·if·there·was·an·error·opening·the·window,·or·if·text·log·windows
283 are·not·implemented·on·the·platform.306 are·not·implemented·on·the·platform.
284 ·····N\x8No\x8ot\x8te\x8e:\x8:·On·Android,·logs·can·be·viewed·using·logcat.307 ·····N\x8No\x8ot\x8te\x8e:\x8:·On·Android,·logs·can·be·viewed·using·logcat.
285 See·also:·_\x8a_\x8l_\x8__\x8a_\x8p_\x8p_\x8e_\x8n_\x8d_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g,·_\x8a_\x8l_\x8__\x8c_\x8l_\x8o_\x8s_\x8e_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g308 See·also:·_\x8a_\x8l_\x8__\x8a_\x8p_\x8p_\x8e_\x8n_\x8d_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g,·_\x8a_\x8l_\x8__\x8c_\x8l_\x8o_\x8s_\x8e_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8e_\x8x_\x8t_\x8__\x8l_\x8o_\x8g
 309 Examples:
 310 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c
 311 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
286 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cl\x8lo\x8os\x8se\x8e_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_t\x8te\x8ex\x8xt\x8t_\x8_l\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*312 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cl\x8lo\x8os\x8se\x8e_\x8_n\x8na\x8at\x8ti\x8iv\x8ve\x8e_\x8_t\x8te\x8ex\x8xt\x8t_\x8_l\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*
287 void·al_close_native_text_log(ALLEGRO_TEXTLOG·*textlog)313 void·al_close_native_text_log(ALLEGRO_TEXTLOG·*textlog)
Max diff block lines reached; 15170/23047 bytes (65.82%) of diff not shown.
9.21 KB
./usr/share/doc/allegro5-doc/refman/opengl.html
    
Offset 233, 14 lines modifiedOffset 233, 21 lines modified
233 <p><em>Note:</em>·the·exact·extensions·exposed·depend·on·how·Allegro·was233 <p><em>Note:</em>·the·exact·extensions·exposed·depend·on·how·Allegro·was
234 compiled.·It·is·recommended·to·use·<a234 compiled.·It·is·recommended·to·use·<a
235 href="opengl.html#al_have_opengl_extension">al_have_opengl_extension</a>235 href="opengl.html#al_have_opengl_extension">al_have_opengl_extension</a>
236 and·<a236 and·<a
237 href="opengl.html#al_get_opengl_proc_address">al_get_opengl_proc_address</a>237 href="opengl.html#al_get_opengl_proc_address">al_get_opengl_proc_address</a>
238 for·the·most·stable·experience.</p>238 for·the·most·stable·experience.</p>
239 </blockquote>239 </blockquote>
 240 <p>Examples:</p>
 241 <ul>
 242 <li><a
 243 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl.c#L52">ex_opengl.c</a></li>
 244 <li><a
 245 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_glext.c#L245">ex_glext.c</a></li>
 246 </ul>
240 <h1·id="al_get_opengl_proc_address">al_get_opengl_proc_address</h1>247 <h1·id="al_get_opengl_proc_address">al_get_opengl_proc_address</h1>
241 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·<span·class="op">*</span>al_get_opengl_proc_address<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>name<span·class="op">)</span></span></code></pre></div>248 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·<span·class="op">*</span>al_get_opengl_proc_address<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>name<span·class="op">)</span></span></code></pre></div>
242 <p><a249 <p><a
243 href="https://github.com/liballeg/allegro5/blob/master/src/opengl/extensions.c#L578">Source250 href="https://github.com/liballeg/allegro5/blob/master/src/opengl/extensions.c#L578">Source
244 Code</a></p>251 Code</a></p>
245 <p>Helper·to·get·the·address·of·an·OpenGL·symbol</p>252 <p>Helper·to·get·the·address·of·an·OpenGL·symbol</p>
246 <p>Example:</p>253 <p>Example:</p>
Offset 274, 14 lines modifiedOffset 281, 21 lines modified
274 <p>Returns·the·OpenGL·texture·id·internally·used·by·the·given·bitmap·if281 <p>Returns·the·OpenGL·texture·id·internally·used·by·the·given·bitmap·if
275 it·uses·one,·else·0.</p>282 it·uses·one,·else·0.</p>
276 <p>Example:</p>283 <p>Example:</p>
277 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a>bitmap·<span·class="op">=</span>·al_load_bitmap<span·class="op">(</span><span·class="st">&quot;my_texture.png&quot;</span><span·class="op">);</span></span>284 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a>bitmap·<span·class="op">=</span>·al_load_bitmap<span·class="op">(</span><span·class="st">&quot;my_texture.png&quot;</span><span·class="op">);</span></span>
278 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>texture·<span·class="op">=</span>·al_get_opengl_texture<span·class="op">(</span>bitmap<span·class="op">);</span></span>285 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>texture·<span·class="op">=</span>·al_get_opengl_texture<span·class="op">(</span>bitmap<span·class="op">);</span></span>
279 <span·id="cb7-3"><a·href="#cb7-3"·aria-hidden="true"·tabindex="-1"></a><span·class="cf">if</span>·<span·class="op">(</span>texture·<span·class="op">!=</span>·<span·class="dv">0</span><span·class="op">)</span></span>286 <span·id="cb7-3"><a·href="#cb7-3"·aria-hidden="true"·tabindex="-1"></a><span·class="cf">if</span>·<span·class="op">(</span>texture·<span·class="op">!=</span>·<span·class="dv">0</span><span·class="op">)</span></span>
280 <span·id="cb7-4"><a·href="#cb7-4"·aria-hidden="true"·tabindex="-1"></a>····glBindTexture<span·class="op">(</span>GL_TEXTURE_2D<span·class="op">,</span>·texture<span·class="op">);</span></span></code></pre></div>287 <span·id="cb7-4"><a·href="#cb7-4"·aria-hidden="true"·tabindex="-1"></a>····glBindTexture<span·class="op">(</span>GL_TEXTURE_2D<span·class="op">,</span>·texture<span·class="op">);</span></span></code></pre></div>
 288 <p>Examples:</p>
 289 <ul>
 290 <li><a
 291 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl_pixel_shader.c#L81">ex_opengl_pixel_shader.c</a></li>
 292 <li><a
 293 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_gldepth.c#L174">ex_gldepth.c</a></li>
 294 </ul>
281 <h1·id="al_get_opengl_texture_size">al_get_opengl_texture_size</h1>295 <h1·id="al_get_opengl_texture_size">al_get_opengl_texture_size</h1>
282 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_get_opengl_texture_size<span·class="op">(</span>ALLEGRO_BITMAP·<span·class="op">*</span>bitmap<span·class="op">,</span>·<span·class="dt">int</span>·<span·class="op">*</span>w<span·class="op">,</span>·<span·class="dt">int</span>·<span·class="op">*</span>h<span·class="op">)</span></span></code></pre></div>296 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_get_opengl_texture_size<span·class="op">(</span>ALLEGRO_BITMAP·<span·class="op">*</span>bitmap<span·class="op">,</span>·<span·class="dt">int</span>·<span·class="op">*</span>w<span·class="op">,</span>·<span·class="dt">int</span>·<span·class="op">*</span>h<span·class="op">)</span></span></code></pre></div>
283 <p><a297 <p><a
284 href="https://github.com/liballeg/allegro5/blob/master/src/opengl/ogl_bitmap.c#L1228">Source298 href="https://github.com/liballeg/allegro5/blob/master/src/opengl/ogl_bitmap.c#L1228">Source
285 Code</a></p>299 Code</a></p>
286 <p>Retrieves·the·size·of·the·texture·used·for·the·bitmap.·This·can·be300 <p>Retrieves·the·size·of·the·texture·used·for·the·bitmap.·This·can·be
287 different·from·the·bitmap·size·if·OpenGL·only·supports·power-of-two301 different·from·the·bitmap·size·if·OpenGL·only·supports·power-of-two
Offset 348, 14 lines modifiedOffset 362, 19 lines modified
348 <p>This·function·is·a·helper·to·determine·whether·an·OpenGL·extension·is362 <p>This·function·is·a·helper·to·determine·whether·an·OpenGL·extension·is
349 available·on·the·given·display·or·not.</p>363 available·on·the·given·display·or·not.</p>
350 <p>Example:</p>364 <p>Example:</p>
351 <div·class="sourceCode"·id="cb14"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb14-1"><a·href="#cb14-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·packedpixels·<span·class="op">=</span>·al_have_opengl_extension<span·class="op">(</span><span·class="st">&quot;GL_EXT_packed_pixels&quot;</span><span·class="op">);</span></span></code></pre></div>365 <div·class="sourceCode"·id="cb14"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb14-1"><a·href="#cb14-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·packedpixels·<span·class="op">=</span>·al_have_opengl_extension<span·class="op">(</span><span·class="st">&quot;GL_EXT_packed_pixels&quot;</span><span·class="op">);</span></span></code></pre></div>
352 <p>If·<em>packedpixels</em>·is·true·then·you·can·safely·use·the366 <p>If·<em>packedpixels</em>·is·true·then·you·can·safely·use·the
353 constants·related·to·the·packed·pixels·extension.</p>367 constants·related·to·the·packed·pixels·extension.</p>
354 <p>Returns·true·if·the·extension·is·available;·false·otherwise.</p>368 <p>Returns·true·if·the·extension·is·available;·false·otherwise.</p>
 369 <p>Examples:</p>
 370 <ul>
 371 <li><a
 372 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl_pixel_shader.c#L68">ex_opengl_pixel_shader.c</a></li>
 373 </ul>
355 <h1·id="al_get_opengl_version">al_get_opengl_version</h1>374 <h1·id="al_get_opengl_version">al_get_opengl_version</h1>
356 <div·class="sourceCode"·id="cb15"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb15-1"><a·href="#cb15-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">uint32_t</span>·al_get_opengl_version<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>375 <div·class="sourceCode"·id="cb15"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb15-1"><a·href="#cb15-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">uint32_t</span>·al_get_opengl_version<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
357 <p><a376 <p><a
358 href="https://github.com/liballeg/allegro5/blob/master/src/opengl/extensions.c#L216">Source377 href="https://github.com/liballeg/allegro5/blob/master/src/opengl/extensions.c#L216">Source
359 Code</a></p>378 Code</a></p>
360 <p>Returns·the·OpenGL·or·OpenGL·ES·version·number·of·the·client·(the379 <p>Returns·the·OpenGL·or·OpenGL·ES·version·number·of·the·client·(the
361 computer·the·program·is·running·on),·for·the·current·display.·“1.0”·is380 computer·the·program·is·running·on),·for·the·current·display.·“1.0”·is
Offset 411, 14 lines modifiedOffset 430, 11 lines modified
411 <div·class="sourceCode"·id="cb18"><pre430 <div·class="sourceCode"·id="cb18"><pre
412 class="sourceCode·ini"><code·class="sourceCode·ini"><span·id="cb18-1"><a·href="#cb18-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">[opengl_disabled_extensions]</span></span>431 class="sourceCode·ini"><code·class="sourceCode·ini"><span·id="cb18-1"><a·href="#cb18-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">[opengl_disabled_extensions]</span></span>
413 <span·id="cb18-2"><a·href="#cb18-2"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">GL_ARB_texture_non_power_of_two</span><span·class="ot">=</span><span·class="dv">0</span></span>432 <span·id="cb18-2"><a·href="#cb18-2"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">GL_ARB_texture_non_power_of_two</span><span·class="ot">=</span><span·class="dv">0</span></span>
414 <span·id="cb18-3"><a·href="#cb18-3"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">GL_EXT_framebuffer_object</span><span·class="ot">=</span><span·class="dv">0</span></span></code></pre></div>433 <span·id="cb18-3"><a·href="#cb18-3"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">GL_EXT_framebuffer_object</span><span·class="ot">=</span><span·class="dv">0</span></span></code></pre></div>
415 <p>Any·extension·which·appears·in·the·section·is·treated·as·not434 <p>Any·extension·which·appears·in·the·section·is·treated·as·not
416 available·(it·does·not·matter·if·you·set·it·to·0·or·any·other435 available·(it·does·not·matter·if·you·set·it·to·0·or·any·other
417 value).</p>436 value).</p>
  
418 <p·class="timestamp"> 
419 Allegro·version·5.2.10 
420 ·-·Last·updated:·2025-01-09·13:52:42·UTC 
421 </p> 
422 </div>437 </div>
423 </body>438 </body>
424 </html>439 </html>
3.39 KB
html2text {}
    
Offset 78, 14 lines modifiedOffset 78, 17 lines modified
78 In·case·you·want·to·manually·check·for·extensions·and·load·function·pointers78 In·case·you·want·to·manually·check·for·extensions·and·load·function·pointers
79 yourself·(say,·in·case·the·Allegro·developers·did·not·include·it·yet),·you·can79 yourself·(say,·in·case·the·Allegro·developers·did·not·include·it·yet),·you·can
80 use·the·_\x8a_\x8l_\x8__\x8h_\x8a_\x8v_\x8e_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8e_\x8x_\x8t_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n·and·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8r_\x8o_\x8c_\x8__\x8a_\x8d_\x8d_\x8r_\x8e_\x8s_\x8s·functions80 use·the·_\x8a_\x8l_\x8__\x8h_\x8a_\x8v_\x8e_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8e_\x8x_\x8t_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n·and·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8r_\x8o_\x8c_\x8__\x8a_\x8d_\x8d_\x8r_\x8e_\x8s_\x8s·functions
81 instead.81 instead.
82 ·····N\x8No\x8ot\x8te\x8e:\x8:·the·exact·extensions·exposed·depend·on·how·Allegro·was82 ·····N\x8No\x8ot\x8te\x8e:\x8:·the·exact·extensions·exposed·depend·on·how·Allegro·was
83 ·····compiled.·It·is·recommended·to·use·_\x8a_\x8l_\x8__\x8h_\x8a_\x8v_\x8e_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8e_\x8x_\x8t_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n·and83 ·····compiled.·It·is·recommended·to·use·_\x8a_\x8l_\x8__\x8h_\x8a_\x8v_\x8e_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8e_\x8x_\x8t_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n·and
84 ·····_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8r_\x8o_\x8c_\x8__\x8a_\x8d_\x8d_\x8r_\x8e_\x8s_\x8s·for·the·most·stable·experience.84 ·····_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8r_\x8o_\x8c_\x8__\x8a_\x8d_\x8d_\x8r_\x8e_\x8s_\x8s·for·the·most·stable·experience.
 85 Examples:
 86 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8._\x8c
 87 ····*·_\x8e_\x8x_\x8__\x8g_\x8l_\x8e_\x8x_\x8t_\x8._\x8c
85 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_o\x8op\x8pe\x8en\x8ng\x8gl\x8l_\x8_p\x8pr\x8ro\x8oc\x8c_\x8_a\x8ad\x8dd\x8dr\x8re\x8es\x8ss\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*88 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_o\x8op\x8pe\x8en\x8ng\x8gl\x8l_\x8_p\x8pr\x8ro\x8oc\x8c_\x8_a\x8ad\x8dd\x8dr\x8re\x8es\x8ss\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
86 void·*al_get_opengl_proc_address(const·char·*name)89 void·*al_get_opengl_proc_address(const·char·*name)
87 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e90 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
88 Helper·to·get·the·address·of·an·OpenGL·symbol91 Helper·to·get·the·address·of·an·OpenGL·symbol
89 Example:92 Example:
90 How·to·get·the·function·g\x8gl\x8lM\x8Mu\x8ul\x8lt\x8ti\x8iT\x8Te\x8ex\x8xC\x8Co\x8oo\x8or\x8rd\x8d3\x83f\x8fA\x8AR\x8RB\x8B·that·comes·with·ARB’s·Multitexture93 How·to·get·the·function·g\x8gl\x8lM\x8Mu\x8ul\x8lt\x8ti\x8iT\x8Te\x8ex\x8xC\x8Co\x8oo\x8or\x8rd\x8d3\x83f\x8fA\x8AR\x8RB\x8B·that·comes·with·ARB’s·Multitexture
91 extension:94 extension:
Offset 113, 14 lines modifiedOffset 116, 17 lines modified
113 Returns·the·OpenGL·texture·id·internally·used·by·the·given·bitmap·if·it·uses116 Returns·the·OpenGL·texture·id·internally·used·by·the·given·bitmap·if·it·uses
114 one,·else·0.117 one,·else·0.
115 Example:118 Example:
116 bitmap·=·al_load_bitmap("my_texture.png");119 bitmap·=·al_load_bitmap("my_texture.png");
117 texture·=·al_get_opengl_texture(bitmap);120 texture·=·al_get_opengl_texture(bitmap);
118 if·(texture·!=·0)121 if·(texture·!=·0)
119 ····glBindTexture(GL_TEXTURE_2D,·texture);122 ····glBindTexture(GL_TEXTURE_2D,·texture);
 123 Examples:
 124 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8i_\x8x_\x8e_\x8l_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
 125 ····*·_\x8e_\x8x_\x8__\x8g_\x8l_\x8d_\x8e_\x8p_\x8t_\x8h_\x8._\x8c
120 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_o\x8op\x8pe\x8en\x8ng\x8gl\x8l_\x8_t\x8te\x8ex\x8xt\x8tu\x8ur\x8re\x8e_\x8_s\x8si\x8iz\x8ze\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*126 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_o\x8op\x8pe\x8en\x8ng\x8gl\x8l_\x8_t\x8te\x8ex\x8xt\x8tu\x8ur\x8re\x8e_\x8_s\x8si\x8iz\x8ze\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
121 bool·al_get_opengl_texture_size(ALLEGRO_BITMAP·*bitmap,·int·*w,·int·*h)127 bool·al_get_opengl_texture_size(ALLEGRO_BITMAP·*bitmap,·int·*w,·int·*h)
122 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e128 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
123 Retrieves·the·size·of·the·texture·used·for·the·bitmap.·This·can·be·different129 Retrieves·the·size·of·the·texture·used·for·the·bitmap.·This·can·be·different
124 from·the·bitmap·size·if·OpenGL·only·supports·power-of-two·sizes·or·if·it·is·a130 from·the·bitmap·size·if·OpenGL·only·supports·power-of-two·sizes·or·if·it·is·a
125 sub-bitmap.131 sub-bitmap.
126 Returns·true·on·success,·false·on·failure.·Zero·width·and·height·are·returned132 Returns·true·on·success,·false·on·failure.·Zero·width·and·height·are·returned
Offset 161, 14 lines modifiedOffset 167, 16 lines modified
161 This·function·is·a·helper·to·determine·whether·an·OpenGL·extension·is·available167 This·function·is·a·helper·to·determine·whether·an·OpenGL·extension·is·available
162 on·the·given·display·or·not.168 on·the·given·display·or·not.
163 Example:169 Example:
164 bool·packedpixels·=·al_have_opengl_extension("GL_EXT_packed_pixels");170 bool·packedpixels·=·al_have_opengl_extension("GL_EXT_packed_pixels");
165 If·p\x8pa\x8ac\x8ck\x8ke\x8ed\x8dp\x8pi\x8ix\x8xe\x8el\x8ls\x8s·is·true·then·you·can·safely·use·the·constants·related·to·the171 If·p\x8pa\x8ac\x8ck\x8ke\x8ed\x8dp\x8pi\x8ix\x8xe\x8el\x8ls\x8s·is·true·then·you·can·safely·use·the·constants·related·to·the
166 packed·pixels·extension.172 packed·pixels·extension.
167 Returns·true·if·the·extension·is·available;·false·otherwise.173 Returns·true·if·the·extension·is·available;·false·otherwise.
 174 Examples:
 175 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8i_\x8x_\x8e_\x8l_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
168 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_o\x8op\x8pe\x8en\x8ng\x8gl\x8l_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*176 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_o\x8op\x8pe\x8en\x8ng\x8gl\x8l_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
169 uint32_t·al_get_opengl_version(void)177 uint32_t·al_get_opengl_version(void)
170 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e178 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
171 Returns·the·OpenGL·or·OpenGL·ES·version·number·of·the·client·(the·computer·the179 Returns·the·OpenGL·or·OpenGL·ES·version·number·of·the·client·(the·computer·the
172 program·is·running·on),·for·the·current·display.·“1.0”·is·returned·as180 program·is·running·on),·for·the·current·display.·“1.0”·is·returned·as
173 0x01000000,·“1.2.1”·is·returned·as·0x01020100,·and·“1.2.2”·as·0x01020200,·etc.181 0x01000000,·“1.2.1”·is·returned·as·0x01020100,·and·“1.2.2”·as·0x01020200,·etc.
174 A·valid·OpenGL·context·must·exist·for·this·function·to·work,·which·means·you182 A·valid·OpenGL·context·must·exist·for·this·function·to·work,·which·means·you
Offset 201, 8 lines modifiedOffset 209, 7 lines modified
201 You·can·disable·the·detection·of·any·OpenGL·extension·by·Allegro·with·a·section209 You·can·disable·the·detection·of·any·OpenGL·extension·by·Allegro·with·a·section
202 like·this·in·allegro5.cfg:210 like·this·in·allegro5.cfg:
203 [opengl_disabled_extensions]211 [opengl_disabled_extensions]
204 GL_ARB_texture_non_power_of_two=0212 GL_ARB_texture_non_power_of_two=0
205 GL_EXT_framebuffer_object=0213 GL_EXT_framebuffer_object=0
206 Any·extension·which·appears·in·the·section·is·treated·as·not·available·(it·does214 Any·extension·which·appears·in·the·section·is·treated·as·not·available·(it·does
207 not·matter·if·you·set·it·to·0·or·any·other·value).215 not·matter·if·you·set·it·to·0·or·any·other·value).
208 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC 
39.5 KB
./usr/share/doc/allegro5-doc/refman/path.html
    
Offset 240, 14 lines modifiedOffset 240, 23 lines modified
240 followed·by·a·directory·separator·and·is·neither·“.”·nor·“..”,·is240 followed·by·a·directory·separator·and·is·neither·“.”·nor·“..”,·is
241 treated·as·the·last·directory·name·in·the·path.·Otherwise·the·last241 treated·as·the·last·directory·name·in·the·path.·Otherwise·the·last
242 component·is·treated·as·the·filename.·The·string·may·be·NULL·for·an242 component·is·treated·as·the·filename.·The·string·may·be·NULL·for·an
243 empty·path.</p>243 empty·path.</p>
244 <p>See·also:·<a244 <p>See·also:·<a
245 href="path.html#al_create_path_for_directory">al_create_path_for_directory</a>,245 href="path.html#al_create_path_for_directory">al_create_path_for_directory</a>,
246 <a·href="path.html#al_destroy_path">al_destroy_path</a></p>246 <a·href="path.html#al_destroy_path">al_destroy_path</a></p>
 247 <p>Examples:</p>
 248 <ul>
 249 <li><a
 250 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path.c#L18">ex_path.c</a></li>
 251 <li><a
 252 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path_test.c#L35">ex_path_test.c</a></li>
 253 <li><a
 254 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_chain.cpp#L187">ex_audio_chain.cpp</a></li>
 255 </ul>
247 <h1·id="al_create_path_for_directory">al_create_path_for_directory</h1>256 <h1·id="al_create_path_for_directory">al_create_path_for_directory</h1>
248 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_PATH·<span·class="op">*</span>al_create_path_for_directory<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>str<span·class="op">)</span></span></code></pre></div>257 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_PATH·<span·class="op">*</span>al_create_path_for_directory<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>str<span·class="op">)</span></span></code></pre></div>
249 <p><a258 <p><a
250 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L188">Source259 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L188">Source
251 Code</a></p>260 Code</a></p>
252 <p>This·is·the·same·as·<a261 <p>This·is·the·same·as·<a
253 href="path.html#al_create_path">al_create_path</a>,·but·interprets·the262 href="path.html#al_create_path">al_create_path</a>,·but·interprets·the
Offset 259, 143 lines modifiedOffset 268, 228 lines modified
259 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_path<span·class="op">(</span>ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>268 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_destroy_path<span·class="op">(</span>ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>
260 <p><a269 <p><a
261 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L429">Source270 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L429">Source
262 Code</a></p>271 Code</a></p>
263 <p>Free·a·path·structure.·Does·nothing·if·passed·NULL.</p>272 <p>Free·a·path·structure.·Does·nothing·if·passed·NULL.</p>
264 <p>See·also:·<a·href="path.html#al_create_path">al_create_path</a>,·<a273 <p>See·also:·<a·href="path.html#al_create_path">al_create_path</a>,·<a
265 href="path.html#al_create_path_for_directory">al_create_path_for_directory</a></p>274 href="path.html#al_create_path_for_directory">al_create_path_for_directory</a></p>
 275 <p>Examples:</p>
 276 <ul>
 277 <li><a
 278 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_get_path.c#L14">ex_get_path.c</a></li>
 279 <li><a
 280 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path.c#L21">ex_path.c</a></li>
 281 <li><a
 282 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path_test.c#L36">ex_path_test.c</a></li>
 283 </ul>
266 <h1·id="al_clone_path">al_clone_path</h1>284 <h1·id="al_clone_path">al_clone_path</h1>
267 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_PATH·<span·class="op">*</span>al_clone_path<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>285 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_PATH·<span·class="op">*</span>al_clone_path<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>
268 <p><a286 <p><a
269 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L203">Source287 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L203">Source
270 Code</a></p>288 Code</a></p>
271 <p>Clones·an·ALLEGRO_PATH·structure.·Returns·NULL·on·failure.</p>289 <p>Clones·an·ALLEGRO_PATH·structure.·Returns·NULL·on·failure.</p>
272 <p>See·also:·<a·href="path.html#al_destroy_path">al_destroy_path</a></p>290 <p>See·also:·<a·href="path.html#al_destroy_path">al_destroy_path</a></p>
 291 <p>Examples:</p>
 292 <ul>
 293 <li><a
 294 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path.c#L65">ex_path.c</a></li>
 295 <li><a
 296 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path_test.c#L490">ex_path_test.c</a></li>
 297 </ul>
273 <h1·id="al_join_paths">al_join_paths</h1>298 <h1·id="al_join_paths">al_join_paths</h1>
274 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_join_paths<span·class="op">(</span>ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">,</span>·<span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>tail<span·class="op">)</span></span></code></pre></div>299 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_join_paths<span·class="op">(</span>ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">,</span>·<span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>tail<span·class="op">)</span></span></code></pre></div>
275 <p><a300 <p><a
276 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L347">Source301 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L347">Source
277 Code</a></p>302 Code</a></p>
278 <p>Concatenate·two·path·structures.·The·first·path·structure·is303 <p>Concatenate·two·path·structures.·The·first·path·structure·is
279 modified.·If·‘tail’·is·an·absolute·path,·this·function·does·nothing.</p>304 modified.·If·‘tail’·is·an·absolute·path,·this·function·does·nothing.</p>
280 <p>If·‘tail’·is·a·relative·path,·all·of·its·directory·components·will·be305 <p>If·‘tail’·is·a·relative·path,·all·of·its·directory·components·will·be
281 appended·to·‘path’.·tail’s·filename·will·also·overwrite·path’s·filename,306 appended·to·‘path’.·tail’s·filename·will·also·overwrite·path’s·filename,
282 even·if·it·is·just·the·empty·string.</p>307 even·if·it·is·just·the·empty·string.</p>
283 <p>Tail’s·drive·is·ignored.</p>308 <p>Tail’s·drive·is·ignored.</p>
284 <p>Returns·true·if·‘tail’·was·a·relative·path·and·so·concatenated·to309 <p>Returns·true·if·‘tail’·was·a·relative·path·and·so·concatenated·to
285 ‘path’,·otherwise·returns·false.</p>310 ‘path’,·otherwise·returns·false.</p>
286 <p>See·also:·<a·href="path.html#al_rebase_path">al_rebase_path</a></p>311 <p>See·also:·<a·href="path.html#al_rebase_path">al_rebase_path</a></p>
 312 <p>Examples:</p>
 313 <ul>
 314 <li><a
 315 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path_test.c#L318">ex_path_test.c</a></li>
 316 </ul>
287 <h1·id="al_rebase_path">al_rebase_path</h1>317 <h1·id="al_rebase_path">al_rebase_path</h1>
288 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_rebase_path<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>head<span·class="op">,</span>·ALLEGRO_PATH·<span·class="op">*</span>tail<span·class="op">)</span></span></code></pre></div>318 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_rebase_path<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>head<span·class="op">,</span>·ALLEGRO_PATH·<span·class="op">*</span>tail<span·class="op">)</span></span></code></pre></div>
289 <p><a319 <p><a
290 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L374">Source320 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L374">Source
291 Code</a></p>321 Code</a></p>
292 <p>Concatenate·two·path·structures,·modifying·the·second·path·structure.322 <p>Concatenate·two·path·structures,·modifying·the·second·path·structure.
293 If·<em>tail</em>·is·an·absolute·path,·this·function·does·nothing.323 If·<em>tail</em>·is·an·absolute·path,·this·function·does·nothing.
294 Otherwise,·the·drive·and·path·components·in·<em>head</em>·are·inserted324 Otherwise,·the·drive·and·path·components·in·<em>head</em>·are·inserted
295 at·the·start·of·<em>tail</em>.</p>325 at·the·start·of·<em>tail</em>.</p>
296 <p>For·example,·if·<em>head</em>·is·“/anchor/”·and·<em>tail</em>·is326 <p>For·example,·if·<em>head</em>·is·“/anchor/”·and·<em>tail</em>·is
297 “data/file.ext”,·then·after·the·call·<em>tail</em>·becomes327 “data/file.ext”,·then·after·the·call·<em>tail</em>·becomes
298 “/anchor/data/file.ext”.</p>328 “/anchor/data/file.ext”.</p>
299 <p>See·also:·<a·href="path.html#al_join_paths">al_join_paths</a></p>329 <p>See·also:·<a·href="path.html#al_join_paths">al_join_paths</a></p>
 330 <p>Examples:</p>
 331 <ul>
 332 <li><a
 333 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path_test.c#L376">ex_path_test.c</a></li>
 334 <li><a
 335 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_chain.cpp#L188">ex_audio_chain.cpp</a></li>
 336 </ul>
300 <h1·id="al_get_path_drive">al_get_path_drive</h1>337 <h1·id="al_get_path_drive">al_get_path_drive</h1>
301 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>al_get_path_drive<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>338 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>al_get_path_drive<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>
302 <p><a339 <p><a
303 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L481">Source340 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L481">Source
304 Code</a></p>341 Code</a></p>
305 <p>Return·the·drive·letter·on·a·path,·or·the·empty·string·if·there·is342 <p>Return·the·drive·letter·on·a·path,·or·the·empty·string·if·there·is
306 none.</p>343 none.</p>
307 <p>The·“drive·letter”·is·only·used·on·Windows,·and·is·usually·a·string344 <p>The·“drive·letter”·is·only·used·on·Windows,·and·is·usually·a·string
308 like·“c:”,·but·may·be·something·like·“\\Computer·Name”·in·the·case·of345 like·“c:”,·but·may·be·something·like·“\\Computer·Name”·in·the·case·of
309 UNC·(Uniform·Naming·Convention)·syntax.</p>346 UNC·(Uniform·Naming·Convention)·syntax.</p>
 347 <p>Examples:</p>
 348 <ul>
 349 <li><a
 350 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path.c#L35">ex_path.c</a></li>
 351 <li><a
 352 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path_test.c#L36">ex_path_test.c</a></li>
 353 </ul>
310 <h1·id="al_get_path_num_components">al_get_path_num_components</h1>354 <h1·id="al_get_path_num_components">al_get_path_num_components</h1>
311 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_path_num_components<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>355 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_path_num_components<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_PATH·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>
312 <p><a356 <p><a
313 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L229">Source357 href="https://github.com/liballeg/allegro5/blob/master/src/path.c#L229">Source
314 Code</a></p>358 Code</a></p>
315 <p>Return·the·number·of·directory·components·in·a·path.</p>359 <p>Return·the·number·of·directory·components·in·a·path.</p>
316 <p>The·directory·components·do·not·include·the·final·part·of·a·path·(the360 <p>The·directory·components·do·not·include·the·final·part·of·a·path·(the
317 filename).</p>361 filename).</p>
318 <p>See·also:·<a362 <p>See·also:·<a
319 href="path.html#al_get_path_component">al_get_path_component</a></p>363 href="path.html#al_get_path_component">al_get_path_component</a></p>
 364 <p>Examples:</p>
 365 <ul>
 366 <li><a
 367 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path.c#L50">ex_path.c</a></li>
 368 <li><a
 369 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_path_test.c#L35">ex_path_test.c</a></li>
 370 </ul>
Max diff block lines reached; 17799/25911 bytes (68.69%) of diff not shown.
14.1 KB
html2text {}
    
Offset 79, 170 lines modifiedOffset 79, 228 lines modified
79 ALLEGRO_PATH·*al_create_path(const·char·*str)79 ALLEGRO_PATH·*al_create_path(const·char·*str)
80 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e80 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
81 Create·a·path·structure·from·a·string.·The·last·component,·if·it·is·followed·by81 Create·a·path·structure·from·a·string.·The·last·component,·if·it·is·followed·by
82 a·directory·separator·and·is·neither·“.”·nor·“..”,·is·treated·as·the·last82 a·directory·separator·and·is·neither·“.”·nor·“..”,·is·treated·as·the·last
83 directory·name·in·the·path.·Otherwise·the·last·component·is·treated·as·the83 directory·name·in·the·path.·Otherwise·the·last·component·is·treated·as·the
84 filename.·The·string·may·be·NULL·for·an·empty·path.84 filename.·The·string·may·be·NULL·for·an·empty·path.
85 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8f_\x8o_\x8r_\x8__\x8d_\x8i_\x8r_\x8e_\x8c_\x8t_\x8o_\x8r_\x8y,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h85 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8f_\x8o_\x8r_\x8__\x8d_\x8i_\x8r_\x8e_\x8c_\x8t_\x8o_\x8r_\x8y,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h
 86 Examples:
 87 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 88 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
 89 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8c_\x8h_\x8a_\x8i_\x8n_\x8._\x8c_\x8p_\x8p
86 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_p\x8pa\x8at\x8th\x8h_\x8_f\x8fo\x8or\x8r_\x8_d\x8di\x8ir\x8re\x8ec\x8ct\x8to\x8or\x8ry\x8y·*\x8**\x8**\x8**\x8**\x8**\x8*90 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_p\x8pa\x8at\x8th\x8h_\x8_f\x8fo\x8or\x8r_\x8_d\x8di\x8ir\x8re\x8ec\x8ct\x8to\x8or\x8ry\x8y·*\x8**\x8**\x8**\x8**\x8**\x8*
87 ALLEGRO_PATH·*al_create_path_for_directory(const·char·*str)91 ALLEGRO_PATH·*al_create_path_for_directory(const·char·*str)
88 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e92 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
89 This·is·the·same·as·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h,·but·interprets·the·passed·string·as·a93 This·is·the·same·as·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h,·but·interprets·the·passed·string·as·a
90 directory·path.·The·filename·component·of·the·returned·path·will·always·be94 directory·path.·The·filename·component·of·the·returned·path·will·always·be
91 empty.95 empty.
92 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h96 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h
93 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_p\x8pa\x8at\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*97 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_p\x8pa\x8at\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*
94 void·al_destroy_path(ALLEGRO_PATH·*path)98 void·al_destroy_path(ALLEGRO_PATH·*path)
95 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e99 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
96 Free·a·path·structure.·Does·nothing·if·passed·NULL.100 Free·a·path·structure.·Does·nothing·if·passed·NULL.
97 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8f_\x8o_\x8r_\x8__\x8d_\x8i_\x8r_\x8e_\x8c_\x8t_\x8o_\x8r_\x8y101 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8f_\x8o_\x8r_\x8__\x8d_\x8i_\x8r_\x8e_\x8c_\x8t_\x8o_\x8r_\x8y
 102 Examples:
 103 ····*·_\x8e_\x8x_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 104 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 105 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
98 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cl\x8lo\x8on\x8ne\x8e_\x8_p\x8pa\x8at\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*106 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cl\x8lo\x8on\x8ne\x8e_\x8_p\x8pa\x8at\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*
99 ALLEGRO_PATH·*al_clone_path(const·ALLEGRO_PATH·*path)107 ALLEGRO_PATH·*al_clone_path(const·ALLEGRO_PATH·*path)
100 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e108 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
101 Clones·an·ALLEGRO_PATH·structure.·Returns·NULL·on·failure.109 Clones·an·ALLEGRO_PATH·structure.·Returns·NULL·on·failure.
102 See·also:·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h110 See·also:·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h
 111 Examples:
 112 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 113 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
103 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_j\x8jo\x8oi\x8in\x8n_\x8_p\x8pa\x8at\x8th\x8hs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*114 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_j\x8jo\x8oi\x8in\x8n_\x8_p\x8pa\x8at\x8th\x8hs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
104 bool·al_join_paths(ALLEGRO_PATH·*path,·const·ALLEGRO_PATH·*tail)115 bool·al_join_paths(ALLEGRO_PATH·*path,·const·ALLEGRO_PATH·*tail)
105 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e116 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
106 Concatenate·two·path·structures.·The·first·path·structure·is·modified.·If117 Concatenate·two·path·structures.·The·first·path·structure·is·modified.·If
107 ‘tail’·is·an·absolute·path,·this·function·does·nothing.118 ‘tail’·is·an·absolute·path,·this·function·does·nothing.
108 If·‘tail’·is·a·relative·path,·all·of·its·directory·components·will·be·appended119 If·‘tail’·is·a·relative·path,·all·of·its·directory·components·will·be·appended
109 to·‘path’.·tail’s·filename·will·also·overwrite·path’s·filename,·even·if·it·is120 to·‘path’.·tail’s·filename·will·also·overwrite·path’s·filename,·even·if·it·is
110 just·the·empty·string.121 just·the·empty·string.
111 Tail’s·drive·is·ignored.122 Tail’s·drive·is·ignored.
112 Returns·true·if·‘tail’·was·a·relative·path·and·so·concatenated·to·‘path’,123 Returns·true·if·‘tail’·was·a·relative·path·and·so·concatenated·to·‘path’,
113 otherwise·returns·false.124 otherwise·returns·false.
114 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8b_\x8a_\x8s_\x8e_\x8__\x8p_\x8a_\x8t_\x8h125 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8b_\x8a_\x8s_\x8e_\x8__\x8p_\x8a_\x8t_\x8h
 126 Examples:
 127 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
115 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8eb\x8ba\x8as\x8se\x8e_\x8_p\x8pa\x8at\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*128 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8eb\x8ba\x8as\x8se\x8e_\x8_p\x8pa\x8at\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*
116 bool·al_rebase_path(const·ALLEGRO_PATH·*head,·ALLEGRO_PATH·*tail)129 bool·al_rebase_path(const·ALLEGRO_PATH·*head,·ALLEGRO_PATH·*tail)
117 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e130 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
118 Concatenate·two·path·structures,·modifying·the·second·path·structure.·If·t\x8ta\x8ai\x8il\x8l131 Concatenate·two·path·structures,·modifying·the·second·path·structure.·If·t\x8ta\x8ai\x8il\x8l
119 is·an·absolute·path,·this·function·does·nothing.·Otherwise,·the·drive·and·path132 is·an·absolute·path,·this·function·does·nothing.·Otherwise,·the·drive·and·path
120 components·in·h\x8he\x8ea\x8ad\x8d·are·inserted·at·the·start·of·t\x8ta\x8ai\x8il\x8l.133 components·in·h\x8he\x8ea\x8ad\x8d·are·inserted·at·the·start·of·t\x8ta\x8ai\x8il\x8l.
121 For·example,·if·h\x8he\x8ea\x8ad\x8d·is·“/anchor/”·and·t\x8ta\x8ai\x8il\x8l·is·“data/file.ext”,·then·after·the134 For·example,·if·h\x8he\x8ea\x8ad\x8d·is·“/anchor/”·and·t\x8ta\x8ai\x8il\x8l·is·“data/file.ext”,·then·after·the
122 call·t\x8ta\x8ai\x8il\x8l·becomes·“/anchor/data/file.ext”.135 call·t\x8ta\x8ai\x8il\x8l·becomes·“/anchor/data/file.ext”.
123 See·also:·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8p_\x8a_\x8t_\x8h_\x8s136 See·also:·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8p_\x8a_\x8t_\x8h_\x8s
 137 Examples:
 138 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
 139 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8c_\x8h_\x8a_\x8i_\x8n_\x8._\x8c_\x8p_\x8p
124 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_d\x8dr\x8ri\x8iv\x8ve\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*140 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_d\x8dr\x8ri\x8iv\x8ve\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
125 const·char·*al_get_path_drive(const·ALLEGRO_PATH·*path)141 const·char·*al_get_path_drive(const·ALLEGRO_PATH·*path)
126 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e142 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
127 Return·the·drive·letter·on·a·path,·or·the·empty·string·if·there·is·none.143 Return·the·drive·letter·on·a·path,·or·the·empty·string·if·there·is·none.
128 The·“drive·letter”·is·only·used·on·Windows,·and·is·usually·a·string·like·“c:”,144 The·“drive·letter”·is·only·used·on·Windows,·and·is·usually·a·string·like·“c:”,
129 but·may·be·something·like·“\\Computer·Name”·in·the·case·of·UNC·(Uniform·Naming145 but·may·be·something·like·“\\Computer·Name”·in·the·case·of·UNC·(Uniform·Naming
130 Convention)·syntax.146 Convention)·syntax.
 147 Examples:
 148 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 149 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
131 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_n\x8nu\x8um\x8m_\x8_c\x8co\x8om\x8mp\x8po\x8on\x8ne\x8en\x8nt\x8ts\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*150 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_n\x8nu\x8um\x8m_\x8_c\x8co\x8om\x8mp\x8po\x8on\x8ne\x8en\x8nt\x8ts\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
132 int·al_get_path_num_components(const·ALLEGRO_PATH·*path)151 int·al_get_path_num_components(const·ALLEGRO_PATH·*path)
133 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e152 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
134 Return·the·number·of·directory·components·in·a·path.153 Return·the·number·of·directory·components·in·a·path.
135 The·directory·components·do·not·include·the·final·part·of·a·path·(the154 The·directory·components·do·not·include·the·final·part·of·a·path·(the
136 filename).155 filename).
137 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8c_\x8o_\x8m_\x8p_\x8o_\x8n_\x8e_\x8n_\x8t156 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8c_\x8o_\x8m_\x8p_\x8o_\x8n_\x8e_\x8n_\x8t
 157 Examples:
 158 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 159 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
138 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_c\x8co\x8om\x8mp\x8po\x8on\x8ne\x8en\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*160 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_c\x8co\x8om\x8mp\x8po\x8on\x8ne\x8en\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
139 const·char·*al_get_path_component(const·ALLEGRO_PATH·*path,·int·i)161 const·char·*al_get_path_component(const·ALLEGRO_PATH·*path,·int·i)
140 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e162 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
141 Return·the·i’th·directory·component·of·a·path,·counting·from·zero.·If·the·index163 Return·the·i’th·directory·component·of·a·path,·counting·from·zero.·If·the·index
142 is·negative·then·count·from·the·right,·i.e. -1·refers·to·the·last·path164 is·negative·then·count·from·the·right,·i.e. -1·refers·to·the·last·path
143 component.·It·is·an·error·to·pass·an·index·which·is·out·of·bounds.165 component.·It·is·an·error·to·pass·an·index·which·is·out·of·bounds.
144 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8n_\x8u_\x8m_\x8__\x8c_\x8o_\x8m_\x8p_\x8o_\x8n_\x8e_\x8n_\x8t_\x8s,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8a_\x8i_\x8l166 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8n_\x8u_\x8m_\x8__\x8c_\x8o_\x8m_\x8p_\x8o_\x8n_\x8e_\x8n_\x8t_\x8s,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8a_\x8i_\x8l
 167 Examples:
 168 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 169 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
 170 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8c_\x8h_\x8a_\x8i_\x8n_\x8._\x8c_\x8p_\x8p
145 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_t\x8ta\x8ai\x8il\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*171 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_t\x8ta\x8ai\x8il\x8l·*\x8**\x8**\x8**\x8**\x8**\x8*
146 const·char·*al_get_path_tail(const·ALLEGRO_PATH·*path)172 const·char·*al_get_path_tail(const·ALLEGRO_PATH·*path)
147 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e173 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
148 Returns·the·last·directory·component,·or·NULL·if·there·are·no·directory174 Returns·the·last·directory·component,·or·NULL·if·there·are·no·directory
149 components.175 components.
 176 Examples:
 177 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
150 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_f\x8fi\x8il\x8le\x8en\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*178 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_f\x8fi\x8il\x8le\x8en\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
151 const·char·*al_get_path_filename(const·ALLEGRO_PATH·*path)179 const·char·*al_get_path_filename(const·ALLEGRO_PATH·*path)
152 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e180 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
153 Return·the·filename·part·of·the·path,·or·the·empty·string·if·there·is·none.181 Return·the·filename·part·of·the·path,·or·the·empty·string·if·there·is·none.
154 The·returned·pointer·is·valid·only·until·the·filename·part·of·the·path·is182 The·returned·pointer·is·valid·only·until·the·filename·part·of·the·path·is
155 modified·in·any·way,·or·until·the·path·is·destroyed.183 modified·in·any·way,·or·until·the·path·is·destroyed.
156 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8b_\x8a_\x8s_\x8e_\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8e_\x8x_\x8t_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8c_\x8o_\x8m_\x8p_\x8o_\x8n_\x8e_\x8n_\x8t184 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8b_\x8a_\x8s_\x8e_\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8e_\x8x_\x8t_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8c_\x8o_\x8m_\x8p_\x8o_\x8n_\x8e_\x8n_\x8t
 185 Examples:
 186 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 187 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
157 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_b\x8ba\x8as\x8se\x8en\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*188 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_b\x8ba\x8as\x8se\x8en\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
158 const·char·*al_get_path_basename(const·ALLEGRO_PATH·*path)189 const·char·*al_get_path_basename(const·ALLEGRO_PATH·*path)
159 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e190 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
160 Return·the·basename,·i.e. filename·with·the·extension·removed.·If·the·filename191 Return·the·basename,·i.e. filename·with·the·extension·removed.·If·the·filename
161 doesn’t·have·an·extension,·the·whole·filename·is·the·basename.·If·there·is·no192 doesn’t·have·an·extension,·the·whole·filename·is·the·basename.·If·there·is·no
162 filename·part·then·the·empty·string·is·returned.193 filename·part·then·the·empty·string·is·returned.
163 The·returned·pointer·is·valid·only·until·the·filename·part·of·the·path·is194 The·returned·pointer·is·valid·only·until·the·filename·part·of·the·path·is
164 modified·in·any·way,·or·until·the·path·is·destroyed.195 modified·in·any·way,·or·until·the·path·is·destroyed.
165 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8f_\x8i_\x8l_\x8e_\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8e_\x8x_\x8t_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n196 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8f_\x8i_\x8l_\x8e_\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8e_\x8x_\x8t_\x8e_\x8n_\x8s_\x8i_\x8o_\x8n
 197 Examples:
 198 ····*·_\x8e_\x8x_\x8__\x8p_\x8a_\x8t_\x8h_\x8__\x8t_\x8e_\x8s_\x8t_\x8._\x8c
166 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_e\x8ex\x8xt\x8te\x8en\x8ns\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*199 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_p\x8pa\x8at\x8th\x8h_\x8_e\x8ex\x8xt\x8te\x8en\x8ns\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
167 const·char·*al_get_path_extension(const·ALLEGRO_PATH·*path)200 const·char·*al_get_path_extension(const·ALLEGRO_PATH·*path)
168 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e201 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
169 Return·a·pointer·to·the·start·of·the·extension·of·the·filename,·i.e. everything202 Return·a·pointer·to·the·start·of·the·extension·of·the·filename,·i.e. everything
170 from·the·final·dot·(‘.’)·character·onwards.·If·no·dot·exists,·returns·an·empty203 from·the·final·dot·(‘.’)·character·onwards.·If·no·dot·exists,·returns·an·empty
171 string.204 string.
172 The·returned·pointer·is·valid·only·until·the·filename·part·of·the·path·is205 The·returned·pointer·is·valid·only·until·the·filename·part·of·the·path·is
Max diff block lines reached; 6795/14386 bytes (47.23%) of diff not shown.
2.21 KB
./usr/share/doc/allegro5-doc/refman/physfs.html
    
Offset 224, 14 lines modifiedOffset 224, 19 lines modified
224 <blockquote>224 <blockquote>
225 <p><em>Note:</em>·PhysFS·does·not·support·the·text-mode·reading·and225 <p><em>Note:</em>·PhysFS·does·not·support·the·text-mode·reading·and
226 writing,·which·means·that·Windows-style·newlines·will·not·be226 writing,·which·means·that·Windows-style·newlines·will·not·be
227 preserved.</p>227 preserved.</p>
228 </blockquote>228 </blockquote>
229 <p>See·also:·<a229 <p>See·also:·<a
230 href="file.html#al_set_new_file_interface">al_set_new_file_interface</a>.</p>230 href="file.html#al_set_new_file_interface">al_set_new_file_interface</a>.</p>
 231 <p>Examples:</p>
 232 <ul>
 233 <li><a
 234 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_physfs.c#L149">ex_physfs.c</a></li>
 235 </ul>
231 <h1236 <h1
232 id="al_get_allegro_physfs_version">al_get_allegro_physfs_version</h1>237 id="al_get_allegro_physfs_version">al_get_allegro_physfs_version</h1>
233 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">uint32_t</span>·al_get_allegro_physfs_version<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>238 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">uint32_t</span>·al_get_allegro_physfs_version<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
234 <p><a239 <p><a
235 href="https://github.com/liballeg/allegro5/blob/master/addons/physfs/a5_physfs.c#L310">Source240 href="https://github.com/liballeg/allegro5/blob/master/addons/physfs/a5_physfs.c#L310">Source
236 Code</a></p>241 Code</a></p>
237 <p>Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as·<a242 <p>Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as·<a
1.12 KB
html2text {}
    
Offset 70, 13 lines modifiedOffset 70, 15 lines modified
70 _\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e.70 _\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e.
71 ·····N\x8No\x8ot\x8te\x8e:\x8:·due·to·an·oversight,·this·function·differs·from71 ·····N\x8No\x8ot\x8te\x8e:\x8:·due·to·an·oversight,·this·function·differs·from
72 ·····_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e·and·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e·which72 ·····_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e·and·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e·which
73 ·····only·alter·the·current·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E.73 ·····only·alter·the·current·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E.
74 ·····N\x8No\x8ot\x8te\x8e:\x8:·PhysFS·does·not·support·the·text-mode·reading·and·writing,74 ·····N\x8No\x8ot\x8te\x8e:\x8:·PhysFS·does·not·support·the·text-mode·reading·and·writing,
75 ·····which·means·that·Windows-style·newlines·will·not·be·preserved.75 ·····which·means·that·Windows-style·newlines·will·not·be·preserved.
76 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e.76 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8i_\x8l_\x8e_\x8__\x8i_\x8n_\x8t_\x8e_\x8r_\x8f_\x8a_\x8c_\x8e.
 77 Examples:
 78 ····*·_\x8e_\x8x_\x8__\x8p_\x8h_\x8y_\x8s_\x8f_\x8s_\x8._\x8c
77 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8al\x8ll\x8le\x8eg\x8gr\x8ro\x8o_\x8_p\x8ph\x8hy\x8ys\x8sf\x8fs\x8s_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*79 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8al\x8ll\x8le\x8eg\x8gr\x8ro\x8o_\x8_p\x8ph\x8hy\x8ys\x8sf\x8fs\x8s_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
78 uint32_t·al_get_allegro_physfs_version(void)80 uint32_t·al_get_allegro_physfs_version(void)
79 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e81 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
80 Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as82 Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as
81 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8a_\x8l_\x8l_\x8e_\x8g_\x8r_\x8o_\x8__\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n.83 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8a_\x8l_\x8l_\x8e_\x8g_\x8r_\x8o_\x8__\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n.
82 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC84 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC
6.17 KB
./usr/share/doc/allegro5-doc/refman/platform.html
    
Offset 226, 14 lines modifiedOffset 226, 19 lines modified
226 <h2·id="al_get_win_window_handle">al_get_win_window_handle</h2>226 <h2·id="al_get_win_window_handle">al_get_win_window_handle</h2>
227 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a>HWND·al_get_win_window_handle<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">)</span></span></code></pre></div>227 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a>HWND·al_get_win_window_handle<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">)</span></span></code></pre></div>
228 <p><a228 <p><a
229 href="https://github.com/liballeg/allegro5/blob/master/src/win/wwindow.c#L1460">Source229 href="https://github.com/liballeg/allegro5/blob/master/src/win/wwindow.c#L1460">Source
230 Code</a></p>230 Code</a></p>
231 <p>Returns·the·handle·to·the·window·that·the·passed·display·is231 <p>Returns·the·handle·to·the·window·that·the·passed·display·is
232 using.</p>232 using.</p>
 233 <p>Examples:</p>
 234 <ul>
 235 <li><a
 236 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_ogre3d.cpp#L115">ex_ogre3d.cpp</a></li>
 237 </ul>
233 <h2·id="al_win_add_window_callback">al_win_add_window_callback</h2>238 <h2·id="al_win_add_window_callback">al_win_add_window_callback</h2>
234 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_win_add_window_callback<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">,</span></span>239 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_win_add_window_callback<span·class="op">(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">,</span></span>
235 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">bool</span>·<span·class="op">(*</span>callback<span·class="op">)(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">,</span>·UINT·message<span·class="op">,</span>·WPARAM·wparam<span·class="op">,</span></span>240 <span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">bool</span>·<span·class="op">(*</span>callback<span·class="op">)(</span>ALLEGRO_DISPLAY·<span·class="op">*</span>display<span·class="op">,</span>·UINT·message<span·class="op">,</span>·WPARAM·wparam<span·class="op">,</span></span>
236 <span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"·tabindex="-1"></a>···LPARAM·lparam<span·class="op">,</span>·LRESULT·<span·class="op">*</span>result<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">*</span>userdata<span·class="op">),</span>·<span·class="dt">void</span>·<span·class="op">*</span>userdata<span·class="op">)</span></span></code></pre></div>241 <span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"·tabindex="-1"></a>···LPARAM·lparam<span·class="op">,</span>·LRESULT·<span·class="op">*</span>result<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">*</span>userdata<span·class="op">),</span>·<span·class="dt">void</span>·<span·class="op">*</span>userdata<span·class="op">)</span></span></code></pre></div>
237 <p><a242 <p><a
238 href="https://github.com/liballeg/allegro5/blob/master/src/win/wwindow.c#L1502">Source243 href="https://github.com/liballeg/allegro5/blob/master/src/win/wwindow.c#L1502">Source
239 Code</a></p>244 Code</a></p>
Offset 326, 17 lines modifiedOffset 331, 17 lines modified
326 </blockquote>331 </blockquote>
327 <p>Since:·5.1.2</p>332 <p>Since:·5.1.2</p>
328 <p>Examples:</p>333 <p>Examples:</p>
329 <ul>334 <ul>
330 <li><a335 <li><a
331 href="https://github.com/liballeg/allegro5/blob/master/examples/common.c#L19">common.c</a></li>336 href="https://github.com/liballeg/allegro5/blob/master/examples/common.c#L19">common.c</a></li>
332 <li><a337 <li><a
333 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L222">ex_native_filechooser.c</a></li> 
334 <li><a 
335 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_android.c#L5">ex_android.c</a></li>338 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_android.c#L5">ex_android.c</a></li>
 339 <li><a
 340 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L222">ex_native_filechooser.c</a></li>
336 </ul>341 </ul>
337 <h2342 <h2
338 id="al_android_set_apk_fs_interface">al_android_set_apk_fs_interface</h2>343 id="al_android_set_apk_fs_interface">al_android_set_apk_fs_interface</h2>
339 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_android_set_apk_fs_interface<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>344 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_android_set_apk_fs_interface<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
340 <p><a345 <p><a
341 href="https://github.com/liballeg/allegro5/blob/master/src/android/android_apk_fs.c#L302">Source346 href="https://github.com/liballeg/allegro5/blob/master/src/android/android_apk_fs.c#L302">Source
342 Code</a></p>347 Code</a></p>
Offset 466, 14 lines modifiedOffset 471, 16 lines modified
466 you·can·set·an·icon·before·calling·al_create_display.·This·works·by471 you·can·set·an·icon·before·calling·al_create_display.·This·works·by
467 setting·the·icon·before·XMapWindow.</p>472 setting·the·icon·before·XMapWindow.</p>
468 <p>Since:·5.2.3</p>473 <p>Since:·5.2.3</p>
469 <blockquote>474 <blockquote>
470 <p><em><a·href="getting_started.html#unstable-api">Unstable475 <p><em><a·href="getting_started.html#unstable-api">Unstable
471 API</a>:</em>·New·API.</p>476 API</a>:</em>·New·API.</p>
472 </blockquote>477 </blockquote>
473 <p·class="timestamp"> 
474 Allegro·version·5.2.10 
475 ·-·Last·updated:·2025-01-09·13:52:42·UTC 
476 </p>478 <p>Examples:</p>
 479 <ul>
 480 <li><a
 481 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_icon2.c#L45">ex_icon2.c</a></li>
 482 </ul>
  
477 </div>483 </div>
478 </body>484 </body>
479 </html>485 </html>
2.59 KB
html2text {}
    
Offset 66, 14 lines modifiedOffset 66, 16 lines modified
66 *\x8**\x8**\x8**\x8**\x8**\x8*·W\x8Wi\x8in\x8nd\x8do\x8ow\x8ws\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*66 *\x8**\x8**\x8**\x8**\x8**\x8*·W\x8Wi\x8in\x8nd\x8do\x8ow\x8ws\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
67 These·functions·are·declared·in·the·following·header·file:67 These·functions·are·declared·in·the·following·header·file:
68 ·#include·<allegro5/allegro_windows.h>68 ·#include·<allegro5/allegro_windows.h>
69 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_w\x8wi\x8in\x8n_\x8_w\x8wi\x8in\x8nd\x8do\x8ow\x8w_\x8_h\x8ha\x8an\x8nd\x8dl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*69 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_w\x8wi\x8in\x8n_\x8_w\x8wi\x8in\x8nd\x8do\x8ow\x8w_\x8_h\x8ha\x8an\x8nd\x8dl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
70 HWND·al_get_win_window_handle(ALLEGRO_DISPLAY·*display)70 HWND·al_get_win_window_handle(ALLEGRO_DISPLAY·*display)
71 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e71 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
72 Returns·the·handle·to·the·window·that·the·passed·display·is·using.72 Returns·the·handle·to·the·window·that·the·passed·display·is·using.
 73 Examples:
 74 ····*·_\x8e_\x8x_\x8__\x8o_\x8g_\x8r_\x8e_\x83_\x8d_\x8._\x8c_\x8p_\x8p
73 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_w\x8wi\x8in\x8n_\x8_a\x8ad\x8dd\x8d_\x8_w\x8wi\x8in\x8nd\x8do\x8ow\x8w_\x8_c\x8ca\x8al\x8ll\x8lb\x8ba\x8ac\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8*75 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_w\x8wi\x8in\x8n_\x8_a\x8ad\x8dd\x8d_\x8_w\x8wi\x8in\x8nd\x8do\x8ow\x8w_\x8_c\x8ca\x8al\x8ll\x8lb\x8ba\x8ac\x8ck\x8k·*\x8**\x8**\x8**\x8**\x8*
74 bool·al_win_add_window_callback(ALLEGRO_DISPLAY·*display,76 bool·al_win_add_window_callback(ALLEGRO_DISPLAY·*display,
75 ···bool·(*callback)(ALLEGRO_DISPLAY·*display,·UINT·message,·WPARAM·wparam,77 ···bool·(*callback)(ALLEGRO_DISPLAY·*display,·UINT·message,·WPARAM·wparam,
76 ···LPARAM·lparam,·LRESULT·*result,·void·*userdata),·void·*userdata)78 ···LPARAM·lparam,·LRESULT·*result,·void·*userdata),·void·*userdata)
77 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e79 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
78 The·specified·callback·function·will·intercept·the·window’s·message·before80 The·specified·callback·function·will·intercept·the·window’s·message·before
79 Allegro·processes·it.·If·the·callback·function·consumes·the·event,·then·it81 Allegro·processes·it.·If·the·callback·function·consumes·the·event,·then·it
Offset 134, 16 lines modifiedOffset 136, 16 lines modified
134 This·function·will·set·up·a·custom·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E·that·makes·all·future136 This·function·will·set·up·a·custom·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8I_\x8L_\x8E_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E·that·makes·all·future
135 calls·of·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n·read·from·the·applicatons’s·APK·file.137 calls·of·_\x8a_\x8l_\x8__\x8f_\x8o_\x8p_\x8e_\x8n·read·from·the·applicatons’s·APK·file.
136 ·····N\x8No\x8ot\x8te\x8e:\x8:·Currently,·access·to·the·APK·file·after·calling·this·function138 ·····N\x8No\x8ot\x8te\x8e:\x8:·Currently,·access·to·the·APK·file·after·calling·this·function
137 ·····is·read·only.139 ·····is·read·only.
138 Since:·5.1.2140 Since:·5.1.2
139 Examples:141 Examples:
140 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c142 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c
141 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c 
142 ····*·_\x8e_\x8x_\x8__\x8a_\x8n_\x8d_\x8r_\x8o_\x8i_\x8d_\x8._\x8c143 ····*·_\x8e_\x8x_\x8__\x8a_\x8n_\x8d_\x8r_\x8o_\x8i_\x8d_\x8._\x8c
 144 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
143 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_a\x8an\x8nd\x8dr\x8ro\x8oi\x8id\x8d_\x8_s\x8se\x8et\x8t_\x8_a\x8ap\x8pk\x8k_\x8_f\x8fs\x8s_\x8_i\x8in\x8nt\x8te\x8er\x8rf\x8fa\x8ac\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8*145 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_a\x8an\x8nd\x8dr\x8ro\x8oi\x8id\x8d_\x8_s\x8se\x8et\x8t_\x8_a\x8ap\x8pk\x8k_\x8_f\x8fs\x8s_\x8_i\x8in\x8nt\x8te\x8er\x8rf\x8fa\x8ac\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8*
144 void·al_android_set_apk_fs_interface(void)146 void·al_android_set_apk_fs_interface(void)
145 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e147 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
146 This·function·will·set·up·a·custom·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8S_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E·which·allows·working148 This·function·will·set·up·a·custom·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8F_\x8S_\x8__\x8I_\x8N_\x8T_\x8E_\x8R_\x8F_\x8A_\x8C_\x8E·which·allows·working
147 within·the·APK·filesystem.·The·filesystem·root·is·your·assets·directory·and149 within·the·APK·filesystem.·The·filesystem·root·is·your·assets·directory·and
148 there·is·read-only·access·to·all·files·within.150 there·is·read-only·access·to·all·files·within.
149 ·····N\x8No\x8ot\x8te\x8e:\x8:·Some·things·like·querying·file·size·or·attributes·are·not151 ·····N\x8No\x8ot\x8te\x8e:\x8:·Some·things·like·querying·file·size·or·attributes·are·not
Offset 232, 8 lines modifiedOffset 234, 9 lines modified
232 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e234 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
233 On·some·window·managers·(notably·Ubuntu’s·Unity)·al_set_display_icon·doesn’t235 On·some·window·managers·(notably·Ubuntu’s·Unity)·al_set_display_icon·doesn’t
234 work·and·you·need·to·use·a·.desktop·file.·But·with·this·function·you·can·set·an236 work·and·you·need·to·use·a·.desktop·file.·But·with·this·function·you·can·set·an
235 icon·before·calling·al_create_display.·This·works·by·setting·the·icon·before237 icon·before·calling·al_create_display.·This·works·by·setting·the·icon·before
236 XMapWindow.238 XMapWindow.
237 Since:·5.2.3239 Since:·5.2.3
238 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·New·API.240 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·New·API.
239 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC241 Examples:
 242 ····*·_\x8e_\x8x_\x8__\x8i_\x8c_\x8o_\x8n_\x82_\x8._\x8c
95.9 KB
./usr/share/doc/allegro5-doc/refman/primitives.html
    
Offset 343, 14 lines modifiedOffset 343, 23 lines modified
343 <p><a343 <p><a
344 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/primitives.c#L48">Source344 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/primitives.c#L48">Source
345 Code</a></p>345 Code</a></p>
346 <p>Initializes·the·primitives·addon.</p>346 <p>Initializes·the·primitives·addon.</p>
347 <p><em>Returns:</em>·True·on·success,·false·on·failure.</p>347 <p><em>Returns:</em>·True·on·success,·false·on·failure.</p>
348 <p>See·also:·<a348 <p>See·also:·<a
349 href="primitives.html#al_shutdown_primitives_addon">al_shutdown_primitives_addon</a></p>349 href="primitives.html#al_shutdown_primitives_addon">al_shutdown_primitives_addon</a></p>
 350 <p>Examples:</p>
 351 <ul>
 352 <li><a
 353 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_touch_input.c#L55">ex_touch_input.c</a></li>
 354 <li><a
 355 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend_bench.c#L154">ex_blend_bench.c</a></li>
 356 <li><a
 357 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_client.c#L157">ex_enet_client.c</a></li>
 358 </ul>
350 <h2359 <h2
351 id="al_is_primitives_addon_initialized">al_is_primitives_addon_initialized</h2>360 id="al_is_primitives_addon_initialized">al_is_primitives_addon_initialized</h2>
352 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_primitives_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>361 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_primitives_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
353 <p><a362 <p><a
354 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/primitives.c#L62">Source363 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/primitives.c#L62">Source
355 Code</a></p>364 Code</a></p>
356 <p>Returns·true·if·the·primitives·addon·is·initialized,·otherwise365 <p>Returns·true·if·the·primitives·addon·is·initialized,·otherwise
Offset 474, 14 lines modifiedOffset 483, 23 lines modified
474 <li>x1,·y1,·x2,·y2·-·Start·and·end·points·of·the·line</li>483 <li>x1,·y1,·x2,·y2·-·Start·and·end·points·of·the·line</li>
475 <li>color·-·Color·of·the·line</li>484 <li>color·-·Color·of·the·line</li>
476 <li>thickness·-·Thickness·of·the·line,·pass·<code>&lt;=·0</code>·to·draw485 <li>thickness·-·Thickness·of·the·line,·pass·<code>&lt;=·0</code>·to·draw
477 hairline·lines</li>486 hairline·lines</li>
478 </ul>487 </ul>
479 <p>See·also:·<a488 <p>See·also:·<a
480 href="primitives.html#al_draw_soft_line">al_draw_soft_line</a></p>489 href="primitives.html#al_draw_soft_line">al_draw_soft_line</a></p>
 490 <p>Examples:</p>
 491 <ul>
 492 <li><a
 493 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L85">ex_font_justify.cpp</a></li>
 494 <li><a
 495 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_resize.c#L17">ex_resize.c</a></li>
 496 <li><a
 497 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_warp.c#L59">ex_mouse_warp.c</a></li>
 498 </ul>
481 <h2·id="al_draw_triangle">al_draw_triangle</h2>499 <h2·id="al_draw_triangle">al_draw_triangle</h2>
482 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_draw_triangle<span·class="op">(</span><span·class="dt">float</span>·x1<span·class="op">,</span>·<span·class="dt">float</span>·y1<span·class="op">,</span>·<span·class="dt">float</span>·x2<span·class="op">,</span>·<span·class="dt">float</span>·y2<span·class="op">,</span></span>500 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_draw_triangle<span·class="op">(</span><span·class="dt">float</span>·x1<span·class="op">,</span>·<span·class="dt">float</span>·y1<span·class="op">,</span>·<span·class="dt">float</span>·x2<span·class="op">,</span>·<span·class="dt">float</span>·y2<span·class="op">,</span></span>
483 <span·id="cb8-2"><a·href="#cb8-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·x3<span·class="op">,</span>·<span·class="dt">float</span>·y3<span·class="op">,</span>·ALLEGRO_COLOR·color<span·class="op">,</span>·<span·class="dt">float</span>·thickness<span·class="op">)</span></span></code></pre></div>501 <span·id="cb8-2"><a·href="#cb8-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·x3<span·class="op">,</span>·<span·class="dt">float</span>·y3<span·class="op">,</span>·ALLEGRO_COLOR·color<span·class="op">,</span>·<span·class="dt">float</span>·thickness<span·class="op">)</span></span></code></pre></div>
484 <p><a502 <p><a
485 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/high_primitives.c#L126">Source503 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/high_primitives.c#L126">Source
486 Code</a></p>504 Code</a></p>
487 <p>Draws·an·outlined·triangle.</p>505 <p>Draws·an·outlined·triangle.</p>
Offset 492, 28 lines modifiedOffset 510, 38 lines modified
492 <li>thickness·-·Thickness·of·the·lines,·pass·<code>&lt;=·0</code>·to510 <li>thickness·-·Thickness·of·the·lines,·pass·<code>&lt;=·0</code>·to
493 draw·hairline·lines</li>511 draw·hairline·lines</li>
494 </ul>512 </ul>
495 <p>See·also:·<a513 <p>See·also:·<a
496 href="primitives.html#al_draw_filled_triangle">al_draw_filled_triangle</a>,514 href="primitives.html#al_draw_filled_triangle">al_draw_filled_triangle</a>,
497 <a515 <a
498 href="primitives.html#al_draw_soft_triangle">al_draw_soft_triangle</a></p>516 href="primitives.html#al_draw_soft_triangle">al_draw_soft_triangle</a></p>
 517 <p>Examples:</p>
 518 <ul>
 519 <li><a
 520 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim.c#L321">ex_prim.c</a></li>
 521 </ul>
499 <h2·id="al_draw_filled_triangle">al_draw_filled_triangle</h2>522 <h2·id="al_draw_filled_triangle">al_draw_filled_triangle</h2>
500 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_draw_filled_triangle<span·class="op">(</span><span·class="dt">float</span>·x1<span·class="op">,</span>·<span·class="dt">float</span>·y1<span·class="op">,</span>·<span·class="dt">float</span>·x2<span·class="op">,</span>·<span·class="dt">float</span>·y2<span·class="op">,</span></span>523 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_draw_filled_triangle<span·class="op">(</span><span·class="dt">float</span>·x1<span·class="op">,</span>·<span·class="dt">float</span>·y1<span·class="op">,</span>·<span·class="dt">float</span>·x2<span·class="op">,</span>·<span·class="dt">float</span>·y2<span·class="op">,</span></span>
501 <span·id="cb9-2"><a·href="#cb9-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·x3<span·class="op">,</span>·<span·class="dt">float</span>·y3<span·class="op">,</span>·ALLEGRO_COLOR·color<span·class="op">)</span></span></code></pre></div>524 <span·id="cb9-2"><a·href="#cb9-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">float</span>·x3<span·class="op">,</span>·<span·class="dt">float</span>·y3<span·class="op">,</span>·ALLEGRO_COLOR·color<span·class="op">)</span></span></code></pre></div>
502 <p><a525 <p><a
503 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/high_primitives.c#L339">Source526 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/high_primitives.c#L339">Source
504 Code</a></p>527 Code</a></p>
505 <p>Draws·a·filled·triangle.</p>528 <p>Draws·a·filled·triangle.</p>
506 <p><em>Parameters:</em></p>529 <p><em>Parameters:</em></p>
507 <ul>530 <ul>
508 <li>x1,·y1,·x2,·y2,·x3,·y3·-·Three·points·of·the·triangle</li>531 <li>x1,·y1,·x2,·y2,·x3,·y3·-·Three·points·of·the·triangle</li>
509 <li>color·-·Color·of·the·triangle</li>532 <li>color·-·Color·of·the·triangle</li>
510 </ul>533 </ul>
511 <p>See·also:·<a534 <p>See·also:·<a
512 href="primitives.html#al_draw_triangle">al_draw_triangle</a></p>535 href="primitives.html#al_draw_triangle">al_draw_triangle</a></p>
 536 <p>Examples:</p>
 537 <ul>
 538 <li><a
 539 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim.c#L350">ex_prim.c</a></li>
 540 </ul>
513 <h2·id="al_draw_rectangle">al_draw_rectangle</h2>541 <h2·id="al_draw_rectangle">al_draw_rectangle</h2>
514 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_draw_rectangle<span·class="op">(</span><span·class="dt">float</span>·x1<span·class="op">,</span>·<span·class="dt">float</span>·y1<span·class="op">,</span>·<span·class="dt">float</span>·x2<span·class="op">,</span>·<span·class="dt">float</span>·y2<span·class="op">,</span></span>542 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_draw_rectangle<span·class="op">(</span><span·class="dt">float</span>·x1<span·class="op">,</span>·<span·class="dt">float</span>·y1<span·class="op">,</span>·<span·class="dt">float</span>·x2<span·class="op">,</span>·<span·class="dt">float</span>·y2<span·class="op">,</span></span>
515 <span·id="cb10-2"><a·href="#cb10-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_COLOR·color<span·class="op">,</span>·<span·class="dt">float</span>·thickness<span·class="op">)</span></span></code></pre></div>543 <span·id="cb10-2"><a·href="#cb10-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_COLOR·color<span·class="op">,</span>·<span·class="dt">float</span>·thickness<span·class="op">)</span></span></code></pre></div>
516 <p><a544 <p><a
517 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/high_primitives.c#L361">Source545 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/high_primitives.c#L361">Source
518 Code</a></p>546 Code</a></p>
519 <p>Draws·an·outlined·rectangle.</p>547 <p>Draws·an·outlined·rectangle.</p>
Offset 525, 14 lines modifiedOffset 553, 23 lines modified
525 <li>thickness·-·Thickness·of·the·lines,·pass·<code>&lt;=·0</code>·to553 <li>thickness·-·Thickness·of·the·lines,·pass·<code>&lt;=·0</code>·to
526 draw·hairline·lines</li>554 draw·hairline·lines</li>
527 </ul>555 </ul>
528 <p>See·also:·<a556 <p>See·also:·<a
529 href="primitives.html#al_draw_filled_rectangle">al_draw_filled_rectangle</a>,557 href="primitives.html#al_draw_filled_rectangle">al_draw_filled_rectangle</a>,
530 <a558 <a
531 href="primitives.html#al_draw_rounded_rectangle">al_draw_rounded_rectangle</a></p>559 href="primitives.html#al_draw_rounded_rectangle">al_draw_rounded_rectangle</a></p>
 560 <p>Examples:</p>
 561 <ul>
 562 <li><a
 563 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse.c#L24">ex_mouse.c</a></li>
 564 <li><a
 565 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_justify.cpp#L83">ex_font_justify.cpp</a></li>
 566 <li><a
 567 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_subbitmap.c#L206">ex_subbitmap.c</a></li>
 568 </ul>
532 <h2·id="al_draw_filled_rectangle">al_draw_filled_rectangle</h2>569 <h2·id="al_draw_filled_rectangle">al_draw_filled_rectangle</h2>
533 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_draw_filled_rectangle<span·class="op">(</span><span·class="dt">float</span>·x1<span·class="op">,</span>·<span·class="dt">float</span>·y1<span·class="op">,</span>·<span·class="dt">float</span>·x2<span·class="op">,</span>·<span·class="dt">float</span>·y2<span·class="op">,</span></span>570 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_draw_filled_rectangle<span·class="op">(</span><span·class="dt">float</span>·x1<span·class="op">,</span>·<span·class="dt">float</span>·y1<span·class="op">,</span>·<span·class="dt">float</span>·x2<span·class="op">,</span>·<span·class="dt">float</span>·y2<span·class="op">,</span></span>
534 <span·id="cb11-2"><a·href="#cb11-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_COLOR·color<span·class="op">)</span></span></code></pre></div>571 <span·id="cb11-2"><a·href="#cb11-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_COLOR·color<span·class="op">)</span></span></code></pre></div>
535 <p><a572 <p><a
536 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/high_primitives.c#L406">Source573 href="https://github.com/liballeg/allegro5/blob/master/addons/primitives/high_primitives.c#L406">Source
537 Code</a></p>574 Code</a></p>
538 <p>Draws·a·filled·rectangle.</p>575 <p>Draws·a·filled·rectangle.</p>
Offset 541, 14 lines modifiedOffset 578, 23 lines modified
541 <li>x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the578 <li>x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the
542 rectangle</li>579 rectangle</li>
543 <li>color·-·Color·of·the·rectangle</li>580 <li>color·-·Color·of·the·rectangle</li>
544 </ul>581 </ul>
545 <p>See·also:·<a582 <p>See·also:·<a
546 href="primitives.html#al_draw_rectangle">al_draw_rectangle</a>,·<a583 href="primitives.html#al_draw_rectangle">al_draw_rectangle</a>,·<a
547 href="primitives.html#al_draw_filled_rounded_rectangle">al_draw_filled_rounded_rectangle</a></p>584 href="primitives.html#al_draw_filled_rounded_rectangle">al_draw_filled_rounded_rectangle</a></p>
 585 <p>Examples:</p>
 586 <ul>
 587 <li><a
 588 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse.c#L23">ex_mouse.c</a></li>
 589 <li><a
 590 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer.c#L91">ex_timer.c</a></li>
 591 <li><a
 592 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_window_maximized.c#L103">ex_window_maximized.c</a></li>
 593 </ul>
Max diff block lines reached; 53322/61354 bytes (86.91%) of diff not shown.
35.9 KB
html2text {}
    
Offset 123, 14 lines modifiedOffset 123, 18 lines modified
123 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8a_\x8l_\x8l_\x8e_\x8g_\x8r_\x8o_\x8__\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n.123 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8a_\x8l_\x8l_\x8e_\x8g_\x8r_\x8o_\x8__\x8v_\x8e_\x8r_\x8s_\x8i_\x8o_\x8n.
124 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_p\x8pr\x8ri\x8im\x8mi\x8it\x8ti\x8iv\x8ve\x8es\x8s_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*124 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_p\x8pr\x8ri\x8im\x8mi\x8it\x8ti\x8iv\x8ve\x8es\x8s_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*
125 bool·al_init_primitives_addon(void)125 bool·al_init_primitives_addon(void)
126 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e126 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
127 Initializes·the·primitives·addon.127 Initializes·the·primitives·addon.
128 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·True·on·success,·false·on·failure.128 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·True·on·success,·false·on·failure.
129 See·also:·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8p_\x8r_\x8i_\x8m_\x8i_\x8t_\x8i_\x8v_\x8e_\x8s_\x8__\x8a_\x8d_\x8d_\x8o_\x8n129 See·also:·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8p_\x8r_\x8i_\x8m_\x8i_\x8t_\x8i_\x8v_\x8e_\x8s_\x8__\x8a_\x8d_\x8d_\x8o_\x8n
 130 Examples:
 131 ····*·_\x8e_\x8x_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t_\x8._\x8c
 132 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8__\x8b_\x8e_\x8n_\x8c_\x8h_\x8._\x8c
 133 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8c_\x8l_\x8i_\x8e_\x8n_\x8t_\x8._\x8c
130 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_p\x8pr\x8ri\x8im\x8mi\x8it\x8ti\x8iv\x8ve\x8es\x8s_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8*134 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_p\x8pr\x8ri\x8im\x8mi\x8it\x8ti\x8iv\x8ve\x8es\x8s_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8*
131 bool·al_is_primitives_addon_initialized(void)135 bool·al_is_primitives_addon_initialized(void)
132 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e136 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
133 Returns·true·if·the·primitives·addon·is·initialized,·otherwise·returns·false.137 Returns·true·if·the·primitives·addon·is·initialized,·otherwise·returns·false.
134 Since:·5.2.6138 Since:·5.2.6
135 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8p_\x8r_\x8i_\x8m_\x8i_\x8t_\x8i_\x8v_\x8e_\x8s_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8p_\x8r_\x8i_\x8m_\x8i_\x8t_\x8i_\x8v_\x8e_\x8s_\x8__\x8a_\x8d_\x8d_\x8o_\x8n139 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8p_\x8r_\x8i_\x8m_\x8i_\x8t_\x8i_\x8v_\x8e_\x8s_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8s_\x8h_\x8u_\x8t_\x8d_\x8o_\x8w_\x8n_\x8__\x8p_\x8r_\x8i_\x8m_\x8i_\x8t_\x8i_\x8v_\x8e_\x8s_\x8__\x8a_\x8d_\x8d_\x8o_\x8n
136 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_p\x8pr\x8ri\x8im\x8mi\x8it\x8ti\x8iv\x8ve\x8es\x8s_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*140 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_p\x8pr\x8ri\x8im\x8mi\x8it\x8ti\x8iv\x8ve\x8es\x8s_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8*
Offset 225, 73 lines modifiedOffset 229, 97 lines modified
225 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e229 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
226 Draws·a·line·segment·between·two·points.230 Draws·a·line·segment·between·two·points.
227 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:231 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
228 ····*·x1,·y1,·x2,·y2·-·Start·and·end·points·of·the·line232 ····*·x1,·y1,·x2,·y2·-·Start·and·end·points·of·the·line
229 ····*·color·-·Color·of·the·line233 ····*·color·-·Color·of·the·line
230 ····*·thickness·-·Thickness·of·the·line,·pass·<=·0·to·draw·hairline·lines234 ····*·thickness·-·Thickness·of·the·line,·pass·<=·0·to·draw·hairline·lines
231 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8s_\x8o_\x8f_\x8t_\x8__\x8l_\x8i_\x8n_\x8e235 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8s_\x8o_\x8f_\x8t_\x8__\x8l_\x8i_\x8n_\x8e
 236 Examples:
 237 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8j_\x8u_\x8s_\x8t_\x8i_\x8f_\x8y_\x8._\x8c_\x8p_\x8p
 238 ····*·_\x8e_\x8x_\x8__\x8r_\x8e_\x8s_\x8i_\x8z_\x8e_\x8._\x8c
 239 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8w_\x8a_\x8r_\x8p_\x8._\x8c
232 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_t\x8tr\x8ri\x8ia\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*240 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_t\x8tr\x8ri\x8ia\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
233 void·al_draw_triangle(float·x1,·float·y1,·float·x2,·float·y2,241 void·al_draw_triangle(float·x1,·float·y1,·float·x2,·float·y2,
234 ···float·x3,·float·y3,·ALLEGRO_COLOR·color,·float·thickness)242 ···float·x3,·float·y3,·ALLEGRO_COLOR·color,·float·thickness)
235 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e243 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
236 Draws·an·outlined·triangle.244 Draws·an·outlined·triangle.
237 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:245 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
238 ····*·x1,·y1,·x2,·y2,·x3,·y3·-·Three·points·of·the·triangle246 ····*·x1,·y1,·x2,·y2,·x3,·y3·-·Three·points·of·the·triangle
239 ····*·color·-·Color·of·the·triangle247 ····*·color·-·Color·of·the·triangle
240 ····*·thickness·-·Thickness·of·the·lines,·pass·<=·0·to·draw·hairline·lines248 ····*·thickness·-·Thickness·of·the·lines,·pass·<=·0·to·draw·hairline·lines
241 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8t_\x8r_\x8i_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8s_\x8o_\x8f_\x8t_\x8__\x8t_\x8r_\x8i_\x8a_\x8n_\x8g_\x8l_\x8e249 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8t_\x8r_\x8i_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8s_\x8o_\x8f_\x8t_\x8__\x8t_\x8r_\x8i_\x8a_\x8n_\x8g_\x8l_\x8e
 250 Examples:
 251 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8._\x8c
242 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_f\x8fi\x8il\x8ll\x8le\x8ed\x8d_\x8_t\x8tr\x8ri\x8ia\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*252 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_f\x8fi\x8il\x8ll\x8le\x8ed\x8d_\x8_t\x8tr\x8ri\x8ia\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
243 void·al_draw_filled_triangle(float·x1,·float·y1,·float·x2,·float·y2,253 void·al_draw_filled_triangle(float·x1,·float·y1,·float·x2,·float·y2,
244 ···float·x3,·float·y3,·ALLEGRO_COLOR·color)254 ···float·x3,·float·y3,·ALLEGRO_COLOR·color)
245 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e255 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
246 Draws·a·filled·triangle.256 Draws·a·filled·triangle.
247 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:257 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
248 ····*·x1,·y1,·x2,·y2,·x3,·y3·-·Three·points·of·the·triangle258 ····*·x1,·y1,·x2,·y2,·x3,·y3·-·Three·points·of·the·triangle
249 ····*·color·-·Color·of·the·triangle259 ····*·color·-·Color·of·the·triangle
250 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8t_\x8r_\x8i_\x8a_\x8n_\x8g_\x8l_\x8e260 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8t_\x8r_\x8i_\x8a_\x8n_\x8g_\x8l_\x8e
 261 Examples:
 262 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8._\x8c
251 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_r\x8re\x8ec\x8ct\x8ta\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*263 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_r\x8re\x8ec\x8ct\x8ta\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
252 void·al_draw_rectangle(float·x1,·float·y1,·float·x2,·float·y2,264 void·al_draw_rectangle(float·x1,·float·y1,·float·x2,·float·y2,
253 ···ALLEGRO_COLOR·color,·float·thickness)265 ···ALLEGRO_COLOR·color,·float·thickness)
254 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e266 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
255 Draws·an·outlined·rectangle.267 Draws·an·outlined·rectangle.
256 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:268 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
257 ····*·x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the·rectangle269 ····*·x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the·rectangle
258 ····*·color·-·Color·of·the·rectangle270 ····*·color·-·Color·of·the·rectangle
259 ····*·thickness·-·Thickness·of·the·lines,·pass·<=·0·to·draw·hairline·lines271 ····*·thickness·-·Thickness·of·the·lines,·pass·<=·0·to·draw·hairline·lines
260 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8r_\x8o_\x8u_\x8n_\x8d_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e272 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8r_\x8o_\x8u_\x8n_\x8d_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e
 273 Examples:
 274 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8._\x8c
 275 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8j_\x8u_\x8s_\x8t_\x8i_\x8f_\x8y_\x8._\x8c_\x8p_\x8p
 276 ····*·_\x8e_\x8x_\x8__\x8s_\x8u_\x8b_\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8._\x8c
261 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_f\x8fi\x8il\x8ll\x8le\x8ed\x8d_\x8_r\x8re\x8ec\x8ct\x8ta\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*277 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_f\x8fi\x8il\x8ll\x8le\x8ed\x8d_\x8_r\x8re\x8ec\x8ct\x8ta\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
262 void·al_draw_filled_rectangle(float·x1,·float·y1,·float·x2,·float·y2,278 void·al_draw_filled_rectangle(float·x1,·float·y1,·float·x2,·float·y2,
263 ···ALLEGRO_COLOR·color)279 ···ALLEGRO_COLOR·color)
264 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e280 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
265 Draws·a·filled·rectangle.281 Draws·a·filled·rectangle.
266 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:282 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
267 ····*·x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the·rectangle283 ····*·x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the·rectangle
268 ····*·color·-·Color·of·the·rectangle284 ····*·color·-·Color·of·the·rectangle
269 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8r_\x8o_\x8u_\x8n_\x8d_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e285 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8r_\x8o_\x8u_\x8n_\x8d_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e
 286 Examples:
 287 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8._\x8c
 288 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8._\x8c
 289 ····*·_\x8e_\x8x_\x8__\x8w_\x8i_\x8n_\x8d_\x8o_\x8w_\x8__\x8m_\x8a_\x8x_\x8i_\x8m_\x8i_\x8z_\x8e_\x8d_\x8._\x8c
270 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_r\x8ro\x8ou\x8un\x8nd\x8de\x8ed\x8d_\x8_r\x8re\x8ec\x8ct\x8ta\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*290 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_r\x8ro\x8ou\x8un\x8nd\x8de\x8ed\x8d_\x8_r\x8re\x8ec\x8ct\x8ta\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
271 void·al_draw_rounded_rectangle(float·x1,·float·y1,·float·x2,·float·y2,291 void·al_draw_rounded_rectangle(float·x1,·float·y1,·float·x2,·float·y2,
272 ···float·rx,·float·ry,·ALLEGRO_COLOR·color,·float·thickness)292 ···float·rx,·float·ry,·ALLEGRO_COLOR·color,·float·thickness)
273 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e293 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
274 Draws·an·outlined·rounded·rectangle.294 Draws·an·outlined·rounded·rectangle.
275 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:295 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
276 ····*·x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the·rectangle296 ····*·x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the·rectangle
277 ····*·color·-·Color·of·the·rectangle297 ····*·color·-·Color·of·the·rectangle
278 ····*·rx,·ry·-·The·radii·of·the·round298 ····*·rx,·ry·-·The·radii·of·the·round
279 ····*·thickness·-·Thickness·of·the·lines,·pass·<=·0·to·draw·hairline·lines299 ····*·thickness·-·Thickness·of·the·lines,·pass·<=·0·to·draw·hairline·lines
280 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8r_\x8o_\x8u_\x8n_\x8d_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e300 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8r_\x8o_\x8u_\x8n_\x8d_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e
 301 Examples:
 302 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x8._\x8c
 303 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8._\x8c
 304 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8c_\x8h_\x8a_\x8i_\x8n_\x8._\x8c_\x8p_\x8p
281 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_f\x8fi\x8il\x8ll\x8le\x8ed\x8d_\x8_r\x8ro\x8ou\x8un\x8nd\x8de\x8ed\x8d_\x8_r\x8re\x8ec\x8ct\x8ta\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*305 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_f\x8fi\x8il\x8ll\x8le\x8ed\x8d_\x8_r\x8ro\x8ou\x8un\x8nd\x8de\x8ed\x8d_\x8_r\x8re\x8ec\x8ct\x8ta\x8an\x8ng\x8gl\x8le\x8e·*\x8**\x8**\x8**\x8**\x8*
282 void·al_draw_filled_rounded_rectangle(float·x1,·float·y1,·float·x2,·float·y2,306 void·al_draw_filled_rounded_rectangle(float·x1,·float·y1,·float·x2,·float·y2,
283 ···float·rx,·float·ry,·ALLEGRO_COLOR·color)307 ···float·rx,·float·ry,·ALLEGRO_COLOR·color)
284 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e308 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
285 Draws·an·filled·rounded·rectangle.309 Draws·an·filled·rounded·rectangle.
286 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:310 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
287 ····*·x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the·rectangle311 ····*·x1,·y1,·x2,·y2·-·Upper·left·and·lower·right·points·of·the·rectangle
288 ····*·color·-·Color·of·the·rectangle312 ····*·color·-·Color·of·the·rectangle
289 ····*·rx,·ry·-·The·radii·of·the·round313 ····*·rx,·ry·-·The·radii·of·the·round
290 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8r_\x8o_\x8u_\x8n_\x8d_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e314 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8r_\x8o_\x8u_\x8n_\x8d_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8f_\x8i_\x8l_\x8l_\x8e_\x8d_\x8__\x8r_\x8e_\x8c_\x8t_\x8a_\x8n_\x8g_\x8l_\x8e
 315 Examples:
 316 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x8._\x8c
 317 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
 318 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8._\x8c
291 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8ca\x8al\x8lc\x8cu\x8ul\x8la\x8at\x8te\x8e_\x8_a\x8ar\x8rc\x8c·*\x8**\x8**\x8**\x8**\x8*319 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8ca\x8al\x8lc\x8cu\x8ul\x8la\x8at\x8te\x8e_\x8_a\x8ar\x8rc\x8c·*\x8**\x8**\x8**\x8**\x8*
292 void·al_calculate_arc(float*·dest,·int·stride,·float·cx,·float·cy,320 void·al_calculate_arc(float*·dest,·int·stride,·float·cx,·float·cy,
293 ···float·rx,·float·ry,·float·start_theta,·float·delta_theta,·float·thickness,321 ···float·rx,·float·ry,·float·start_theta,·float·delta_theta,·float·thickness,
294 ···int·num_points)322 ···int·num_points)
295 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e323 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
296 When·thickness·<=·0·this·function·computes·positions·of·num_points·regularly324 When·thickness·<=·0·this·function·computes·positions·of·num_points·regularly
297 spaced·points·on·an·elliptical·arc.·When·thickness·>·0·this·function·computes325 spaced·points·on·an·elliptical·arc.·When·thickness·>·0·this·function·computes
Offset 343, 14 lines modifiedOffset 371, 16 lines modified
343 ····*·start_theta·-·The·initial·angle·from·which·the·arc·is·calculated·in371 ····*·start_theta·-·The·initial·angle·from·which·the·arc·is·calculated·in
344 ······radians372 ······radians
345 ····*·delta_theta·-·Angular·span·of·the·arc·in·radians·(pass·a·negative·number373 ····*·delta_theta·-·Angular·span·of·the·arc·in·radians·(pass·a·negative·number
346 ······to·switch·direction)374 ······to·switch·direction)
347 ····*·thickness·-·Thickness·of·the·arc375 ····*·thickness·-·Thickness·of·the·arc
348 ····*·num_points·-·The·number·of·points·to·calculate376 ····*·num_points·-·The·number·of·points·to·calculate
349 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8a_\x8r_\x8c,·_\x8a_\x8l_\x8__\x8c_\x8a_\x8l_\x8c_\x8u_\x8l_\x8a_\x8t_\x8e_\x8__\x8s_\x8p_\x8l_\x8i_\x8n_\x8e,·_\x8a_\x8l_\x8__\x8c_\x8a_\x8l_\x8c_\x8u_\x8l_\x8a_\x8t_\x8e_\x8__\x8r_\x8i_\x8b_\x8b_\x8o_\x8n377 See·also:·_\x8a_\x8l_\x8__\x8d_\x8r_\x8a_\x8w_\x8__\x8a_\x8r_\x8c,·_\x8a_\x8l_\x8__\x8c_\x8a_\x8l_\x8c_\x8u_\x8l_\x8a_\x8t_\x8e_\x8__\x8s_\x8p_\x8l_\x8i_\x8n_\x8e,·_\x8a_\x8l_\x8__\x8c_\x8a_\x8l_\x8c_\x8u_\x8l_\x8a_\x8t_\x8e_\x8__\x8r_\x8i_\x8b_\x8b_\x8o_\x8n
 378 Examples:
 379 ····*·_\x8e_\x8x_\x8__\x8v_\x8e_\x8r_\x8t_\x8e_\x8x_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r_\x8._\x8c
350 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_p\x8pi\x8ie\x8es\x8sl\x8li\x8ic\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8*380 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8dr\x8ra\x8aw\x8w_\x8_p\x8pi\x8ie\x8es\x8sl\x8li\x8ic\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8*
Max diff block lines reached; 29380/36714 bytes (80.02%) of diff not shown.
33.0 KB
./usr/share/doc/allegro5-doc/refman/shader.html
    
Offset 229, 14 lines modifiedOffset 229, 23 lines modified
229 <em>program</em>·which·has·one·or·more·<em>shaders</em>·attached.·This229 <em>program</em>·which·has·one·or·more·<em>shaders</em>·attached.·This
230 can·be·confusing.)</p>230 can·be·confusing.)</p>
231 <p>The·source·code·for·the·underlying·vertex·or·pixel·shader·can·be231 <p>The·source·code·for·the·underlying·vertex·or·pixel·shader·can·be
232 provided·either·as·GLSL·or·HLSL,·depending·on·the·value·of·<a232 provided·either·as·GLSL·or·HLSL,·depending·on·the·value·of·<a
233 href="shader.html#allegro_shader_platform">ALLEGRO_SHADER_PLATFORM</a>233 href="shader.html#allegro_shader_platform">ALLEGRO_SHADER_PLATFORM</a>
234 used·when·creating·it.</p>234 used·when·creating·it.</p>
235 <p>Since:·5.1.0</p>235 <p>Since:·5.1.0</p>
 236 <p>Examples:</p>
 237 <ul>
 238 <li><a
 239 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L39">ex_shader.cpp</a></li>
 240 <li><a
 241 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_target.c#L22">ex_shader_target.c</a></li>
 242 <li><a
 243 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim_shader.c#L60">ex_prim_shader.c</a></li>
 244 </ul>
236 <h1·id="allegro_shader_type">ALLEGRO_SHADER_TYPE</h1>245 <h1·id="allegro_shader_type">ALLEGRO_SHADER_TYPE</h1>
237 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_SHADER_TYPE·ALLEGRO_SHADER_TYPE<span·class="op">;</span></span></code></pre></div>246 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_SHADER_TYPE·ALLEGRO_SHADER_TYPE<span·class="op">;</span></span></code></pre></div>
238 <p><a247 <p><a
239 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/shader.h#L23">Source248 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/shader.h#L23">Source
240 Code</a></p>249 Code</a></p>
241 <p>Used·with·<a250 <p>Used·with·<a
242 href="shader.html#al_attach_shader_source">al_attach_shader_source</a>251 href="shader.html#al_attach_shader_source">al_attach_shader_source</a>
Offset 284, 14 lines modifiedOffset 293, 21 lines modified
284 more·minimal·implementation·that·may·not·support·alpha·testing.</li>293 more·minimal·implementation·that·may·not·support·alpha·testing.</li>
285 <li>ALLEGRO_SHADER_GLSL_MINIMAL·-·Minimal·GLSL·shader.</li>294 <li>ALLEGRO_SHADER_GLSL_MINIMAL·-·Minimal·GLSL·shader.</li>
286 <li>ALLEGRO_SHADER_HLSL_MINIMAL·-·Minimal·HLSL·shader.</li>295 <li>ALLEGRO_SHADER_HLSL_MINIMAL·-·Minimal·HLSL·shader.</li>
287 <li>ALLEGRO_SHADER_HLSL_SM_3_0·-·HLSL·shader·using·shader·model296 <li>ALLEGRO_SHADER_HLSL_SM_3_0·-·HLSL·shader·using·shader·model
288 3_0.</li>297 3_0.</li>
289 </ul>298 </ul>
290 <p>Since:·5.1.0</p>299 <p>Since:·5.1.0</p>
 300 <p>Examples:</p>
 301 <ul>
 302 <li><a
 303 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L42">ex_shader.cpp</a></li>
 304 <li><a
 305 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_target.c#L22">ex_shader_target.c</a></li>
 306 </ul>
291 <h1·id="al_create_shader">al_create_shader</h1>307 <h1·id="al_create_shader">al_create_shader</h1>
292 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_SHADER·<span·class="op">*</span>al_create_shader<span·class="op">(</span>ALLEGRO_SHADER_PLATFORM·platform<span·class="op">)</span></span></code></pre></div>308 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_SHADER·<span·class="op">*</span>al_create_shader<span·class="op">(</span>ALLEGRO_SHADER_PLATFORM·platform<span·class="op">)</span></span></code></pre></div>
293 <p><a309 <p><a
294 href="https://github.com/liballeg/allegro5/blob/master/src/shader.c#L58">Source310 href="https://github.com/liballeg/allegro5/blob/master/src/shader.c#L58">Source
295 Code</a></p>311 Code</a></p>
296 <p>Create·a·shader·object.</p>312 <p>Create·a·shader·object.</p>
297 <p>The·platform·argument·is·one·of·the·<a313 <p>The·platform·argument·is·one·of·the·<a
Offset 312, 14 lines modifiedOffset 328, 23 lines modified
312 href="shader.html#al_attach_shader_source">al_attach_shader_source</a>,328 href="shader.html#al_attach_shader_source">al_attach_shader_source</a>,
313 <a329 <a
314 href="shader.html#al_attach_shader_source_file">al_attach_shader_source_file</a>,330 href="shader.html#al_attach_shader_source_file">al_attach_shader_source_file</a>,
315 <a·href="shader.html#al_build_shader">al_build_shader</a>,·<a331 <a·href="shader.html#al_build_shader">al_build_shader</a>,·<a
316 href="shader.html#al_use_shader">al_use_shader</a>,·<a332 href="shader.html#al_use_shader">al_use_shader</a>,·<a
317 href="shader.html#al_destroy_shader">al_destroy_shader</a>,·<a333 href="shader.html#al_destroy_shader">al_destroy_shader</a>,·<a
318 href="shader.html#al_get_shader_platform">al_get_shader_platform</a></p>334 href="shader.html#al_get_shader_platform">al_get_shader_platform</a></p>
 335 <p>Examples:</p>
 336 <ul>
 337 <li><a
 338 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L87">ex_shader.cpp</a></li>
 339 <li><a
 340 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_target.c#L86">ex_shader_target.c</a></li>
 341 <li><a
 342 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim_shader.c#L117">ex_prim_shader.c</a></li>
 343 </ul>
319 <h1·id="al_attach_shader_source">al_attach_shader_source</h1>344 <h1·id="al_attach_shader_source">al_attach_shader_source</h1>
320 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_attach_shader_source<span·class="op">(</span>ALLEGRO_SHADER·<span·class="op">*</span>shader<span·class="op">,</span>·ALLEGRO_SHADER_TYPE·type<span·class="op">,</span></span>345 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_attach_shader_source<span·class="op">(</span>ALLEGRO_SHADER·<span·class="op">*</span>shader<span·class="op">,</span>·ALLEGRO_SHADER_TYPE·type<span·class="op">,</span></span>
321 <span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"·tabindex="-1"></a>····<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>source<span·class="op">)</span></span></code></pre></div>346 <span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"·tabindex="-1"></a>····<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>source<span·class="op">)</span></span></code></pre></div>
322 <p><a347 <p><a
323 href="https://github.com/liballeg/allegro5/blob/master/src/shader.c#L102">Source348 href="https://github.com/liballeg/allegro5/blob/master/src/shader.c#L102">Source
324 Code</a></p>349 Code</a></p>
325 <p>Attaches·the·shader’s·source·code·to·the·shader·object·and·compiles350 <p>Attaches·the·shader’s·source·code·to·the·shader·object·and·compiles
Offset 457, 14 lines modifiedOffset 482, 23 lines modified
457 <p>Since:·5.1.0</p>482 <p>Since:·5.1.0</p>
458 <p>See·also:·<a483 <p>See·also:·<a
459 href="shader.html#al_attach_shader_source_file">al_attach_shader_source_file</a>,484 href="shader.html#al_attach_shader_source_file">al_attach_shader_source_file</a>,
460 <a·href="shader.html#al_build_shader">al_build_shader</a>,·<a485 <a·href="shader.html#al_build_shader">al_build_shader</a>,·<a
461 href="shader.html#al_get_default_shader_source">al_get_default_shader_source</a>,486 href="shader.html#al_get_default_shader_source">al_get_default_shader_source</a>,
462 <a·href="shader.html#al_get_shader_log">al_get_shader_log</a>,·<a487 <a·href="shader.html#al_get_shader_log">al_get_shader_log</a>,·<a
463 href="primitives.html#allegro_prim_attr">ALLEGRO_PRIM_ATTR</a></p>488 href="primitives.html#allegro_prim_attr">ALLEGRO_PRIM_ATTR</a></p>
 489 <p>Examples:</p>
 490 <ul>
 491 <li><a
 492 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L97">ex_shader.cpp</a></li>
 493 <li><a
 494 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_target.c#L94">ex_shader_target.c</a></li>
 495 <li><a
 496 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim_shader.c#L132">ex_prim_shader.c</a></li>
 497 </ul>
464 <h1·id="al_attach_shader_source_file">al_attach_shader_source_file</h1>498 <h1·id="al_attach_shader_source_file">al_attach_shader_source_file</h1>
465 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_attach_shader_source_file<span·class="op">(</span>ALLEGRO_SHADER·<span·class="op">*</span>shader<span·class="op">,</span></span>499 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_attach_shader_source_file<span·class="op">(</span>ALLEGRO_SHADER·<span·class="op">*</span>shader<span·class="op">,</span></span>
466 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_SHADER_TYPE·type<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>filename<span·class="op">)</span></span></code></pre></div>500 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>···ALLEGRO_SHADER_TYPE·type<span·class="op">,</span>·<span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>filename<span·class="op">)</span></span></code></pre></div>
467 <p><a501 <p><a
468 href="https://github.com/liballeg/allegro5/blob/master/src/shader.c#L111">Source502 href="https://github.com/liballeg/allegro5/blob/master/src/shader.c#L111">Source
469 Code</a></p>503 Code</a></p>
470 <p>Like·<a504 <p>Like·<a
Offset 474, 14 lines modifiedOffset 508, 23 lines modified
474 log·is·updated.·The·error·log·can·be·retrieved·with·<a508 log·is·updated.·The·error·log·can·be·retrieved·with·<a
475 href="shader.html#al_get_shader_log">al_get_shader_log</a>.</p>509 href="shader.html#al_get_shader_log">al_get_shader_log</a>.</p>
476 <p>Since:·5.1.0</p>510 <p>Since:·5.1.0</p>
477 <p>See·also:·<a511 <p>See·also:·<a
478 href="shader.html#al_attach_shader_source">al_attach_shader_source</a>,512 href="shader.html#al_attach_shader_source">al_attach_shader_source</a>,
479 <a·href="shader.html#al_build_shader">al_build_shader</a>,·<a513 <a·href="shader.html#al_build_shader">al_build_shader</a>,·<a
480 href="shader.html#al_get_shader_log">al_get_shader_log</a></p>514 href="shader.html#al_get_shader_log">al_get_shader_log</a></p>
 515 <p>Examples:</p>
 516 <ul>
 517 <li><a
 518 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L97">ex_shader.cpp</a></li>
 519 <li><a
 520 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_target.c#L94">ex_shader_target.c</a></li>
 521 <li><a
 522 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim_shader.c#L132">ex_prim_shader.c</a></li>
 523 </ul>
481 <h1·id="al_build_shader">al_build_shader</h1>524 <h1·id="al_build_shader">al_build_shader</h1>
482 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_build_shader<span·class="op">(</span>ALLEGRO_SHADER·<span·class="op">*</span>shader<span·class="op">)</span></span></code></pre></div>525 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_build_shader<span·class="op">(</span>ALLEGRO_SHADER·<span·class="op">*</span>shader<span·class="op">)</span></span></code></pre></div>
483 <p><a526 <p><a
484 href="https://github.com/liballeg/allegro5/blob/master/src/shader.c#L144">Source527 href="https://github.com/liballeg/allegro5/blob/master/src/shader.c#L144">Source
485 Code</a></p>528 Code</a></p>
486 <p>This·is·required·before·the·shader·can·be·used·with·<a529 <p>This·is·required·before·the·shader·can·be·used·with·<a
487 href="shader.html#al_use_shader">al_use_shader</a>.·It·should·be·called530 href="shader.html#al_use_shader">al_use_shader</a>.·It·should·be·called
Offset 496, 14 lines modifiedOffset 539, 23 lines modified
496 <p><em>Note:</em>·If·you·are·using·the·ALLEGRO_PROGRAMMABLE_PIPELINE539 <p><em>Note:</em>·If·you·are·using·the·ALLEGRO_PROGRAMMABLE_PIPELINE
497 flag,·then·you·must·specify·both·a·pixel·and·a·vertex·shader·sources·for540 flag,·then·you·must·specify·both·a·pixel·and·a·vertex·shader·sources·for
498 anything·to·be·rendered.</p>541 anything·to·be·rendered.</p>
499 </blockquote>542 </blockquote>
500 <p>Since:·5.1.6</p>543 <p>Since:·5.1.6</p>
501 <p>See·also:·<a·href="shader.html#al_use_shader">al_use_shader</a>,·<a544 <p>See·also:·<a·href="shader.html#al_use_shader">al_use_shader</a>,·<a
502 href="shader.html#al_get_shader_log">al_get_shader_log</a></p>545 href="shader.html#al_get_shader_log">al_get_shader_log</a></p>
 546 <p>Examples:</p>
 547 <ul>
Max diff block lines reached; 11397/19307 bytes (59.03%) of diff not shown.
14.0 KB
html2text {}
    
Offset 71, 14 lines modifiedOffset 71, 18 lines modified
71 An·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R·is·a·program·that·runs·on·the·GPU.·It·combines·both·a·vertex71 An·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R·is·a·program·that·runs·on·the·GPU.·It·combines·both·a·vertex
72 and·a·pixel·shader.·(In·OpenGL·terms,·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R·is·actually·a·p\x8pr\x8ro\x8og\x8gr\x8ra\x8am\x8m72 and·a·pixel·shader.·(In·OpenGL·terms,·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R·is·actually·a·p\x8pr\x8ro\x8og\x8gr\x8ra\x8am\x8m
73 which·has·one·or·more·s\x8sh\x8ha\x8ad\x8de\x8er\x8rs\x8s·attached.·This·can·be·confusing.)73 which·has·one·or·more·s\x8sh\x8ha\x8ad\x8de\x8er\x8rs\x8s·attached.·This·can·be·confusing.)
74 The·source·code·for·the·underlying·vertex·or·pixel·shader·can·be·provided74 The·source·code·for·the·underlying·vertex·or·pixel·shader·can·be·provided
75 either·as·GLSL·or·HLSL,·depending·on·the·value·of·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R_\x8__\x8P_\x8L_\x8A_\x8T_\x8F_\x8O_\x8R_\x8M·used75 either·as·GLSL·or·HLSL,·depending·on·the·value·of·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R_\x8__\x8P_\x8L_\x8A_\x8T_\x8F_\x8O_\x8R_\x8M·used
76 when·creating·it.76 when·creating·it.
77 Since:·5.1.077 Since:·5.1.0
 78 Examples:
 79 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 80 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 81 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
78 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_S\x8SH\x8HA\x8AD\x8DE\x8ER\x8R_\x8_T\x8TY\x8YP\x8PE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*82 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_S\x8SH\x8HA\x8AD\x8DE\x8ER\x8R_\x8_T\x8TY\x8YP\x8PE\x8E·*\x8**\x8**\x8**\x8**\x8**\x8*
79 typedef·enum·ALLEGRO_SHADER_TYPE·ALLEGRO_SHADER_TYPE;83 typedef·enum·ALLEGRO_SHADER_TYPE·ALLEGRO_SHADER_TYPE;
80 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e84 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
81 Used·with·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·and·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e·to·specify85 Used·with·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·and·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e·to·specify
82 how·to·interpret·the·attached·source.86 how·to·interpret·the·attached·source.
83 ··ALLEGRO_VERTEX_SHADER87 ··ALLEGRO_VERTEX_SHADER
84 ······A·vertex·shader·is·executed·for·each·vertex·it·is·used·with.·The·program88 ······A·vertex·shader·is·executed·for·each·vertex·it·is·used·with.·The·program
Offset 109, 14 lines modifiedOffset 113, 17 lines modified
109 ····*·ALLEGRO_SHADER_HLSL·-·High·Level·Shader·Language·(for·Direct3D)113 ····*·ALLEGRO_SHADER_HLSL·-·High·Level·Shader·Language·(for·Direct3D)
110 ····*·ALLEGRO_SHADER_AUTO_MINIMAL·-·Like·ALLEGRO_SHADER_AUTO,·but·pick·a·more114 ····*·ALLEGRO_SHADER_AUTO_MINIMAL·-·Like·ALLEGRO_SHADER_AUTO,·but·pick·a·more
111 ······minimal·implementation·that·may·not·support·alpha·testing.115 ······minimal·implementation·that·may·not·support·alpha·testing.
112 ····*·ALLEGRO_SHADER_GLSL_MINIMAL·-·Minimal·GLSL·shader.116 ····*·ALLEGRO_SHADER_GLSL_MINIMAL·-·Minimal·GLSL·shader.
113 ····*·ALLEGRO_SHADER_HLSL_MINIMAL·-·Minimal·HLSL·shader.117 ····*·ALLEGRO_SHADER_HLSL_MINIMAL·-·Minimal·HLSL·shader.
114 ····*·ALLEGRO_SHADER_HLSL_SM_3_0·-·HLSL·shader·using·shader·model·3_0.118 ····*·ALLEGRO_SHADER_HLSL_SM_3_0·-·HLSL·shader·using·shader·model·3_0.
115 Since:·5.1.0119 Since:·5.1.0
 120 Examples:
 121 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 122 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
116 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*123 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
117 ALLEGRO_SHADER·*al_create_shader(ALLEGRO_SHADER_PLATFORM·platform)124 ALLEGRO_SHADER·*al_create_shader(ALLEGRO_SHADER_PLATFORM·platform)
118 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e125 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
119 Create·a·shader·object.126 Create·a·shader·object.
120 The·platform·argument·is·one·of·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R_\x8__\x8P_\x8L_\x8A_\x8T_\x8F_\x8O_\x8R_\x8M·values,·and127 The·platform·argument·is·one·of·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8H_\x8A_\x8D_\x8E_\x8R_\x8__\x8P_\x8L_\x8A_\x8T_\x8F_\x8O_\x8R_\x8M·values,·and
121 specifies·the·type·of·shader·object·to·create,·and·which·language·is·used·to128 specifies·the·type·of·shader·object·to·create,·and·which·language·is·used·to
122 program·the·shader.129 program·the·shader.
Offset 127, 14 lines modifiedOffset 134, 18 lines modified
127 for·the·display·currently·targeted·by·the·calling·thread;·there·must·be·such·a134 for·the·display·currently·targeted·by·the·calling·thread;·there·must·be·such·a
128 display.·It·will·create·a·GLSL·shader·for·an·OpenGL·display,·and·a·HLSL·shader135 display.·It·will·create·a·GLSL·shader·for·an·OpenGL·display,·and·a·HLSL·shader
129 for·a·Direct3D·display.136 for·a·Direct3D·display.
130 Returns·the·shader·object·on·success.·Otherwise,·returns·NULL.137 Returns·the·shader·object·on·success.·Otherwise,·returns·NULL.
131 Since:·5.1.0138 Since:·5.1.0
132 See·also:·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e,139 See·also:·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e,
133 _\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8p_\x8l_\x8a_\x8t_\x8f_\x8o_\x8r_\x8m140 _\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8p_\x8l_\x8a_\x8t_\x8f_\x8o_\x8r_\x8m
 141 Examples:
 142 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 143 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 144 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
134 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_a\x8at\x8tt\x8ta\x8ac\x8ch\x8h_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*145 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_a\x8at\x8tt\x8ta\x8ac\x8ch\x8h_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
135 bool·al_attach_shader_source(ALLEGRO_SHADER·*shader,·ALLEGRO_SHADER_TYPE·type,146 bool·al_attach_shader_source(ALLEGRO_SHADER·*shader,·ALLEGRO_SHADER_TYPE·type,
136 ····const·char·*source)147 ····const·char·*source)
137 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e148 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
138 Attaches·the·shader’s·source·code·to·the·shader·object·and·compiles·it.·Passing149 Attaches·the·shader’s·source·code·to·the·shader·object·and·compiles·it.·Passing
139 NULL·deletes·the·underlying·(OpenGL·or·DirectX)·shader.·See·also150 NULL·deletes·the·underlying·(OpenGL·or·DirectX)·shader.·See·also
140 _\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e·if·you·prefer·to·obtain·your·shader·source·from·an151 _\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e·if·you·prefer·to·obtain·your·shader·source·from·an
Offset 213, 65 lines modifiedOffset 224, 89 lines modified
213 Examine·the·output·of·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8e_\x8f_\x8a_\x8u_\x8l_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·for·an·example·of·how·to·use224 Examine·the·output·of·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8e_\x8f_\x8a_\x8u_\x8l_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·for·an·example·of·how·to·use
214 the·above·uniforms·and·attributes.225 the·above·uniforms·and·attributes.
215 Returns·true·on·success·and·false·on·error,·in·which·case·the·error·log·is226 Returns·true·on·success·and·false·on·error,·in·which·case·the·error·log·is
216 updated.·The·error·log·can·be·retrieved·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g.227 updated.·The·error·log·can·be·retrieved·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g.
217 Since:·5.1.0228 Since:·5.1.0
218 See·also:·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,229 See·also:·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e,·_\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,
219 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8e_\x8f_\x8a_\x8u_\x8l_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8P_\x8R_\x8I_\x8M_\x8__\x8A_\x8T_\x8T_\x8R230 _\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8d_\x8e_\x8f_\x8a_\x8u_\x8l_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8P_\x8R_\x8I_\x8M_\x8__\x8A_\x8T_\x8T_\x8R
 231 Examples:
 232 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 233 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 234 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
220 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_a\x8at\x8tt\x8ta\x8ac\x8ch\x8h_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e_\x8_f\x8fi\x8il\x8le\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*235 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_a\x8at\x8tt\x8ta\x8ac\x8ch\x8h_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e_\x8_f\x8fi\x8il\x8le\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
221 bool·al_attach_shader_source_file(ALLEGRO_SHADER·*shader,236 bool·al_attach_shader_source_file(ALLEGRO_SHADER·*shader,
222 ···ALLEGRO_SHADER_TYPE·type,·const·char·*filename)237 ···ALLEGRO_SHADER_TYPE·type,·const·char·*filename)
223 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e238 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
224 Like·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·but·reads·the·source·code·for·the·shader·from·the239 Like·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·but·reads·the·source·code·for·the·shader·from·the
225 named·file.240 named·file.
226 Returns·true·on·success·and·false·on·error,·in·which·case·the·error·log·is241 Returns·true·on·success·and·false·on·error,·in·which·case·the·error·log·is
227 updated.·The·error·log·can·be·retrieved·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g.242 updated.·The·error·log·can·be·retrieved·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g.
228 Since:·5.1.0243 Since:·5.1.0
229 See·also:·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g244 See·also:·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g
 245 Examples:
 246 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 247 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 248 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
230 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_b\x8bu\x8ui\x8il\x8ld\x8d_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*249 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_b\x8bu\x8ui\x8il\x8ld\x8d_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
231 bool·al_build_shader(ALLEGRO_SHADER·*shader)250 bool·al_build_shader(ALLEGRO_SHADER·*shader)
232 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e251 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
233 This·is·required·before·the·shader·can·be·used·with·_\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r.·It·should·be252 This·is·required·before·the·shader·can·be·used·with·_\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r.·It·should·be
234 called·after·successfully·attaching·the·pixel·and/or·vertex·shaders·with253 called·after·successfully·attaching·the·pixel·and/or·vertex·shaders·with
235 _\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·or·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e.254 _\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·or·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e.
236 Returns·true·on·success·and·false·on·error,·in·which·case·the·error·log·is255 Returns·true·on·success·and·false·on·error,·in·which·case·the·error·log·is
237 updated.·The·error·log·can·be·retrieved·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g.256 updated.·The·error·log·can·be·retrieved·with·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g.
238 ·····N\x8No\x8ot\x8te\x8e:\x8:·If·you·are·using·the·ALLEGRO_PROGRAMMABLE_PIPELINE·flag,·then257 ·····N\x8No\x8ot\x8te\x8e:\x8:·If·you·are·using·the·ALLEGRO_PROGRAMMABLE_PIPELINE·flag,·then
239 ·····you·must·specify·both·a·pixel·and·a·vertex·shader·sources·for258 ·····you·must·specify·both·a·pixel·and·a·vertex·shader·sources·for
240 ·····anything·to·be·rendered.259 ·····anything·to·be·rendered.
241 Since:·5.1.6260 Since:·5.1.6
242 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g261 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8l_\x8o_\x8g
 262 Examples:
 263 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 264 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 265 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
243 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r_\x8_l\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*266 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r_\x8_l\x8lo\x8og\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*
244 const·char·*al_get_shader_log(ALLEGRO_SHADER·*shader)267 const·char·*al_get_shader_log(ALLEGRO_SHADER·*shader)
245 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e268 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
246 Return·a·read-only·string·containing·the·information·log·for·a·shader·program.269 Return·a·read-only·string·containing·the·information·log·for·a·shader·program.
247 The·log·is·updated·by·certain·functions,·such·as·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·or270 The·log·is·updated·by·certain·functions,·such·as·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e·or
248 _\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r·when·there·is·an·error.271 _\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r·when·there·is·an·error.
249 This·function·never·returns·NULL.272 This·function·never·returns·NULL.
250 Since:·5.1.0273 Since:·5.1.0
251 See·also:·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e,274 See·also:·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e,·_\x8a_\x8l_\x8__\x8a_\x8t_\x8t_\x8a_\x8c_\x8h_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e_\x8__\x8f_\x8i_\x8l_\x8e,
252 _\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r275 _\x8a_\x8l_\x8__\x8b_\x8u_\x8i_\x8l_\x8d_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r
 276 Examples:
 277 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 278 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 279 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
253 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r_\x8_p\x8pl\x8la\x8at\x8tf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*280 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r_\x8_p\x8pl\x8la\x8at\x8tf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
254 ALLEGRO_SHADER_PLATFORM·al_get_shader_platform(ALLEGRO_SHADER·*shader)281 ALLEGRO_SHADER_PLATFORM·al_get_shader_platform(ALLEGRO_SHADER·*shader)
255 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e282 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
256 Returns·the·platform·the·shader·was·created·with·(either·ALLEGRO_SHADER_HLSL·or283 Returns·the·platform·the·shader·was·created·with·(either·ALLEGRO_SHADER_HLSL·or
257 ALLEGRO_SHADER_GLSL).284 ALLEGRO_SHADER_GLSL).
258 Since:·5.1.6285 Since:·5.1.6
259 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r286 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r
 287 Examples:
 288 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 289 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 290 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
260 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8se\x8e_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*291 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8se\x8e_\x8_s\x8sh\x8ha\x8ad\x8de\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
261 bool·al_use_shader(ALLEGRO_SHADER·*shader)292 bool·al_use_shader(ALLEGRO_SHADER·*shader)
262 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e293 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
263 Uses·the·shader·for·subsequent·drawing·operations·on·the·current·target·bitmap.294 Uses·the·shader·for·subsequent·drawing·operations·on·the·current·target·bitmap.
Max diff block lines reached; 5946/14338 bytes (41.47%) of diff not shown.
8.89 KB
./usr/share/doc/allegro5-doc/refman/state.html
    
Offset 218, 14 lines modifiedOffset 218, 23 lines modified
218 All·other·global·state·is·per-thread,·so·if·your·application·has218 All·other·global·state·is·per-thread,·so·if·your·application·has
219 multiple·separate·threads·they·never·will·interfere·with·each·other.219 multiple·separate·threads·they·never·will·interfere·with·each·other.
220 (Except·if·there·are·objects·accessed·by·multiple·threads·of·course.220 (Except·if·there·are·objects·accessed·by·multiple·threads·of·course.
221 Usually·you·want·to·minimize·that·though·and·for·the·remaining·cases·use221 Usually·you·want·to·minimize·that·though·and·for·the·remaining·cases·use
222 synchronization·primitives·described·in·the·threads·section·or·events222 synchronization·primitives·described·in·the·threads·section·or·events
223 described·in·the·events·section·to·control·inter-thread223 described·in·the·events·section·to·control·inter-thread
224 communication.)</p>224 communication.)</p>
 225 <p>Examples:</p>
 226 <ul>
 227 <li><a
 228 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend_bench.c#L65">ex_blend_bench.c</a></li>
 229 <li><a
 230 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend2.cpp#L298">ex_blend2.cpp</a></li>
 231 <li><a
 232 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L24">nihgui.cpp</a></li>
 233 </ul>
225 <h1·id="allegro_state_flags">ALLEGRO_STATE_FLAGS</h1>234 <h1·id="allegro_state_flags">ALLEGRO_STATE_FLAGS</h1>
226 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_STATE_FLAGS</span></code></pre></div>235 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_STATE_FLAGS</span></code></pre></div>
227 <p><a236 <p><a
228 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/tls.h#L28">Source237 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/tls.h#L28">Source
229 Code</a></p>238 Code</a></p>
230 <p>Flags·which·can·be·passed·to·<a239 <p>Flags·which·can·be·passed·to·<a
231 href="state.html#al_store_state">al_store_state</a>/<a240 href="state.html#al_store_state">al_store_state</a>/<a
Offset 237, 14 lines modifiedOffset 246, 23 lines modified
237 <p><a246 <p><a
238 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L762">Source247 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L762">Source
239 Code</a></p>248 Code</a></p>
240 <p>Restores·part·of·the·state·of·the·current·thread·from·the·given·<a249 <p>Restores·part·of·the·state·of·the·current·thread·from·the·given·<a
241 href="state.html#allegro_state">ALLEGRO_STATE</a>·object.</p>250 href="state.html#allegro_state">ALLEGRO_STATE</a>·object.</p>
242 <p>See·also:·<a·href="state.html#al_store_state">al_store_state</a>,·<a251 <p>See·also:·<a·href="state.html#al_store_state">al_store_state</a>,·<a
243 href="state.html#allegro_state_flags">ALLEGRO_STATE_FLAGS</a></p>252 href="state.html#allegro_state_flags">ALLEGRO_STATE_FLAGS</a></p>
 253 <p>Examples:</p>
 254 <ul>
 255 <li><a
 256 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend_bench.c#L96">ex_blend_bench.c</a></li>
 257 <li><a
 258 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend2.cpp#L316">ex_blend2.cpp</a></li>
 259 <li><a
 260 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L33">nihgui.cpp</a></li>
 261 </ul>
244 <h1·id="al_store_state">al_store_state</h1>262 <h1·id="al_store_state">al_store_state</h1>
245 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_store_state<span·class="op">(</span>ALLEGRO_STATE·<span·class="op">*</span>state<span·class="op">,</span>·<span·class="dt">int</span>·flags<span·class="op">)</span></span></code></pre></div>263 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_store_state<span·class="op">(</span>ALLEGRO_STATE·<span·class="op">*</span>state<span·class="op">,</span>·<span·class="dt">int</span>·flags<span·class="op">)</span></span></code></pre></div>
246 <p><a264 <p><a
247 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L692">Source265 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L692">Source
248 Code</a></p>266 Code</a></p>
249 <p>Stores·part·of·the·state·of·the·current·thread·in·the·given·<a267 <p>Stores·part·of·the·state·of·the·current·thread·in·the·given·<a
250 href="state.html#allegro_state">ALLEGRO_STATE</a>·object.·The·flags268 href="state.html#allegro_state">ALLEGRO_STATE</a>·object.·The·flags
Offset 263, 30 lines modifiedOffset 281, 51 lines modified
263 <li>ALLEGRO_STATE_NEW_FILE_INTERFACE·-·new_file_interface</li>281 <li>ALLEGRO_STATE_NEW_FILE_INTERFACE·-·new_file_interface</li>
264 <li>ALLEGRO_STATE_BITMAP·-·same·as·ALLEGRO_STATE_NEW_BITMAP_PARAMETERS282 <li>ALLEGRO_STATE_BITMAP·-·same·as·ALLEGRO_STATE_NEW_BITMAP_PARAMETERS
265 and·ALLEGRO_STATE_TARGET_BITMAP</li>283 and·ALLEGRO_STATE_TARGET_BITMAP</li>
266 <li>ALLEGRO_STATE_ALL·-·all·of·the·above</li>284 <li>ALLEGRO_STATE_ALL·-·all·of·the·above</li>
267 </ul>285 </ul>
268 <p>See·also:·<a·href="state.html#al_restore_state">al_restore_state</a>,286 <p>See·also:·<a·href="state.html#al_restore_state">al_restore_state</a>,
269 <a·href="state.html#allegro_state">ALLEGRO_STATE</a></p>287 <a·href="state.html#allegro_state">ALLEGRO_STATE</a></p>
 288 <p>Examples:</p>
 289 <ul>
 290 <li><a
 291 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend_bench.c#L91">ex_blend_bench.c</a></li>
 292 <li><a
 293 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend2.cpp#L299">ex_blend2.cpp</a></li>
 294 <li><a
 295 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L29">nihgui.cpp</a></li>
 296 </ul>
270 <h1·id="al_get_errno">al_get_errno</h1>297 <h1·id="al_get_errno">al_get_errno</h1>
271 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_errno<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span>298 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_errno<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span>
272 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>GETTER<span·class="op">(</span>allegro_errno<span·class="op">,</span>·<span·class="dv">0</span><span·class="op">)</span></span></code></pre></div>299 <span·id="cb7-2"><a·href="#cb7-2"·aria-hidden="true"·tabindex="-1"></a>GETTER<span·class="op">(</span>allegro_errno<span·class="op">,</span>·<span·class="dv">0</span><span·class="op">)</span></span></code></pre></div>
273 <p><a300 <p><a
274 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L928">Source301 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L928">Source
275 Code</a></p>302 Code</a></p>
276 <p>Some·Allegro·functions·will·set·an·error·number·as·well·as·returning303 <p>Some·Allegro·functions·will·set·an·error·number·as·well·as·returning
277 an·error·code.·Call·this·function·to·retrieve·the·last·error·number·set304 an·error·code.·Call·this·function·to·retrieve·the·last·error·number·set
278 for·the·calling·thread.</p>305 for·the·calling·thread.</p>
 306 <p>Examples:</p>
 307 <ul>
 308 <li><a
 309 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_utf8.c#L477">ex_utf8.c</a></li>
 310 </ul>
279 <h1·id="al_set_errno">al_set_errno</h1>311 <h1·id="al_set_errno">al_set_errno</h1>
280 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_errno<span·class="op">(</span><span·class="dt">int</span>·errnum<span·class="op">)</span></span>312 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_errno<span·class="op">(</span><span·class="dt">int</span>·errnum<span·class="op">)</span></span>
281 <span·id="cb8-2"><a·href="#cb8-2"·aria-hidden="true"·tabindex="-1"></a>SETTER<span·class="op">(</span>allegro_errno<span·class="op">,</span>·errnum<span·class="op">)</span></span></code></pre></div>313 <span·id="cb8-2"><a·href="#cb8-2"·aria-hidden="true"·tabindex="-1"></a>SETTER<span·class="op">(</span>allegro_errno<span·class="op">,</span>·errnum<span·class="op">)</span></span></code></pre></div>
282 <p><a314 <p><a
283 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L933">Source315 href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L933">Source
284 Code</a></p>316 Code</a></p>
285 <p>Set·the·error·number·for·the·calling·thread.</p>317 <p>Set·the·error·number·for·the·calling·thread.</p>
 318 <p>Examples:</p>
 319 <ul>
 320 <li><a
 321 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_curl.c#L250">ex_curl.c</a></li>
 322 <li><a
 323 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_utf8.c#L475">ex_utf8.c</a></li>
 324 </ul>
286 <p·class="timestamp">325 <p·class="timestamp">
287 Allegro·version·5.2.10326 Allegro·version·5.2.10
288 ·-·Last·updated:·2025-01-09·13:52:42·UTC327 ·-·Last·updated:·2025-01-09·13:52:42·UTC
289 </p>328 </p>
290 </div>329 </div>
291 </body>330 </body>
292 </html>331 </html>
3.37 KB
html2text {}
    
Offset 76, 25 lines modifiedOffset 76, 33 lines modified
76 In·general,·the·only·real·global·state·is·the·active·system·driver.·All·other76 In·general,·the·only·real·global·state·is·the·active·system·driver.·All·other
77 global·state·is·per-thread,·so·if·your·application·has·multiple·separate77 global·state·is·per-thread,·so·if·your·application·has·multiple·separate
78 threads·they·never·will·interfere·with·each·other.·(Except·if·there·are·objects78 threads·they·never·will·interfere·with·each·other.·(Except·if·there·are·objects
79 accessed·by·multiple·threads·of·course.·Usually·you·want·to·minimize·that79 accessed·by·multiple·threads·of·course.·Usually·you·want·to·minimize·that
80 though·and·for·the·remaining·cases·use·synchronization·primitives·described·in80 though·and·for·the·remaining·cases·use·synchronization·primitives·described·in
81 the·threads·section·or·events·described·in·the·events·section·to·control·inter-81 the·threads·section·or·events·described·in·the·events·section·to·control·inter-
82 thread·communication.)82 thread·communication.)
 83 Examples:
 84 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8__\x8b_\x8e_\x8n_\x8c_\x8h_\x8._\x8c
 85 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x82_\x8._\x8c_\x8p_\x8p
 86 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
83 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_S\x8ST\x8TA\x8AT\x8TE\x8E_\x8_F\x8FL\x8LA\x8AG\x8GS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*87 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_S\x8ST\x8TA\x8AT\x8TE\x8E_\x8_F\x8FL\x8LA\x8AG\x8GS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*
84 typedef·enum·ALLEGRO_STATE_FLAGS88 typedef·enum·ALLEGRO_STATE_FLAGS
85 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e89 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
86 Flags·which·can·be·passed·to·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e/_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e·as·bit90 Flags·which·can·be·passed·to·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e/_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e·as·bit
87 combinations.·See·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e·for·the·list·of·flags.91 combinations.·See·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e·for·the·list·of·flags.
88 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8st\x8to\x8or\x8re\x8e_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*92 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8st\x8to\x8or\x8re\x8e_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
89 void·al_restore_state(ALLEGRO_STATE·const·*state)93 void·al_restore_state(ALLEGRO_STATE·const·*state)
90 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e94 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
91 Restores·part·of·the·state·of·the·current·thread·from·the·given·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8T_\x8A_\x8T_\x8E95 Restores·part·of·the·state·of·the·current·thread·from·the·given·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8T_\x8A_\x8T_\x8E
92 object.96 object.
93 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8T_\x8A_\x8T_\x8E_\x8__\x8F_\x8L_\x8A_\x8G_\x8S97 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8T_\x8A_\x8T_\x8E_\x8__\x8F_\x8L_\x8A_\x8G_\x8S
 98 Examples:
 99 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8__\x8b_\x8e_\x8n_\x8c_\x8h_\x8._\x8c
 100 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x82_\x8._\x8c_\x8p_\x8p
 101 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
94 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8to\x8or\x8re\x8e_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*102 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8to\x8or\x8re\x8e_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
95 void·al_store_state(ALLEGRO_STATE·*state,·int·flags)103 void·al_store_state(ALLEGRO_STATE·*state,·int·flags)
96 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e104 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
97 Stores·part·of·the·state·of·the·current·thread·in·the·given·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8T_\x8A_\x8T_\x8E105 Stores·part·of·the·state·of·the·current·thread·in·the·given·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8T_\x8A_\x8T_\x8E
98 object.·The·flags·parameter·can·take·any·bit-combination·of·these·flags:106 object.·The·flags·parameter·can·take·any·bit-combination·of·these·flags:
99 ····*·ALLEGRO_STATE_NEW_DISPLAY_PARAMETERS·-·new_display_format,107 ····*·ALLEGRO_STATE_NEW_DISPLAY_PARAMETERS·-·new_display_format,
100 ······new_display_refresh_rate,·new_display_flags108 ······new_display_refresh_rate,·new_display_flags
Offset 105, 20 lines modifiedOffset 113, 29 lines modified
105 ····*·ALLEGRO_STATE_TRANSFORM·-·current_transformation113 ····*·ALLEGRO_STATE_TRANSFORM·-·current_transformation
106 ····*·ALLEGRO_STATE_PROJECTION_TRANSFORM·-·current_projection_transformation114 ····*·ALLEGRO_STATE_PROJECTION_TRANSFORM·-·current_projection_transformation
107 ····*·ALLEGRO_STATE_NEW_FILE_INTERFACE·-·new_file_interface115 ····*·ALLEGRO_STATE_NEW_FILE_INTERFACE·-·new_file_interface
108 ····*·ALLEGRO_STATE_BITMAP·-·same·as·ALLEGRO_STATE_NEW_BITMAP_PARAMETERS·and116 ····*·ALLEGRO_STATE_BITMAP·-·same·as·ALLEGRO_STATE_NEW_BITMAP_PARAMETERS·and
109 ······ALLEGRO_STATE_TARGET_BITMAP117 ······ALLEGRO_STATE_TARGET_BITMAP
110 ····*·ALLEGRO_STATE_ALL·-·all·of·the·above118 ····*·ALLEGRO_STATE_ALL·-·all·of·the·above
111 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8T_\x8A_\x8T_\x8E119 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8t_\x8o_\x8r_\x8e_\x8__\x8s_\x8t_\x8a_\x8t_\x8e,·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8T_\x8A_\x8T_\x8E
 120 Examples:
 121 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8__\x8b_\x8e_\x8n_\x8c_\x8h_\x8._\x8c
 122 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x82_\x8._\x8c_\x8p_\x8p
 123 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
112 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_e\x8er\x8rr\x8rn\x8no\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*124 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_e\x8er\x8rr\x8rn\x8no\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*
113 int·al_get_errno(void)125 int·al_get_errno(void)
114 GETTER(allegro_errno,·0)126 GETTER(allegro_errno,·0)
115 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e127 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
116 Some·Allegro·functions·will·set·an·error·number·as·well·as·returning·an·error128 Some·Allegro·functions·will·set·an·error·number·as·well·as·returning·an·error
117 code.·Call·this·function·to·retrieve·the·last·error·number·set·for·the·calling129 code.·Call·this·function·to·retrieve·the·last·error·number·set·for·the·calling
118 thread.130 thread.
 131 Examples:
 132 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
119 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_e\x8er\x8rr\x8rn\x8no\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*133 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_e\x8er\x8rr\x8rn\x8no\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*
120 void·al_set_errno(int·errnum)134 void·al_set_errno(int·errnum)
121 SETTER(allegro_errno,·errnum)135 SETTER(allegro_errno,·errnum)
122 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e136 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
123 Set·the·error·number·for·the·calling·thread.137 Set·the·error·number·for·the·calling·thread.
 138 Examples:
 139 ····*·_\x8e_\x8x_\x8__\x8c_\x8u_\x8r_\x8l_\x8._\x8c
 140 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
124 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC141 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC
15.4 KB
./usr/share/doc/allegro5-doc/refman/system.html
    
Offset 248, 31 lines modifiedOffset 248, 54 lines modified
248 game·binary.·In·particular,·do·not·call·it·inside·a·shared·library248 game·binary.·In·particular,·do·not·call·it·inside·a·shared·library
249 unless·you·know·what·you’re·doing.·In·those·cases,·it·is·better·to·call249 unless·you·know·what·you’re·doing.·In·those·cases,·it·is·better·to·call
250 al_install_system·either·with·a·<code>NULL</code>·atexit_ptr,·or·with·a250 al_install_system·either·with·a·<code>NULL</code>·atexit_ptr,·or·with·a
251 pointer·to·atexit·provided·by·the·user·of·this·shared·library.</p>251 pointer·to·atexit·provided·by·the·user·of·this·shared·library.</p>
252 </blockquote>252 </blockquote>
253 <p>See·also:·<a253 <p>See·also:·<a
254 href="system.html#al_install_system">al_install_system</a></p>254 href="system.html#al_install_system">al_install_system</a></p>
 255 <p>Examples:</p>
 256 <ul>
 257 <li><a
 258 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_devices.c#L16">ex_audio_devices.c</a></li>
 259 <li><a
 260 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_get_path.c#L30">ex_get_path.c</a></li>
 261 <li><a
 262 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_monitorinfo.c#L15">ex_monitorinfo.c</a></li>
 263 </ul>
255 <h1·id="al_uninstall_system">al_uninstall_system</h1>264 <h1·id="al_uninstall_system">al_uninstall_system</h1>
256 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_uninstall_system<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>265 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_uninstall_system<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
257 <p><a266 <p><a
258 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L316">Source267 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L316">Source
259 Code</a></p>268 Code</a></p>
260 <p>Closes·down·the·Allegro·system.</p>269 <p>Closes·down·the·Allegro·system.</p>
261 <blockquote>270 <blockquote>
262 <p>Note:·al_uninstall_system()·can·be·called·without·a·corresponding·<a271 <p>Note:·al_uninstall_system()·can·be·called·without·a·corresponding·<a
263 href="system.html#al_install_system">al_install_system</a>·call,272 href="system.html#al_install_system">al_install_system</a>·call,
264 e.g. from·atexit().</p>273 e.g. from·atexit().</p>
265 </blockquote>274 </blockquote>
 275 <p>Examples:</p>
 276 <ul>
 277 <li><a
 278 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_opengl_pixel_shader.c#L128">ex_opengl_pixel_shader.c</a></li>
 279 <li><a
 280 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_icon2.c#L85">ex_icon2.c</a></li>
 281 <li><a
 282 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_icon.c#L74">ex_icon.c</a></li>
 283 </ul>
266 <h1·id="al_is_system_installed">al_is_system_installed</h1>284 <h1·id="al_is_system_installed">al_is_system_installed</h1>
267 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_system_installed<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>285 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_system_installed<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
268 <p><a286 <p><a
269 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L346">Source287 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L346">Source
270 Code</a></p>288 Code</a></p>
271 <p>Returns·true·if·Allegro·is·initialized,·otherwise·returns·false.</p>289 <p>Returns·true·if·Allegro·is·initialized,·otherwise·returns·false.</p>
 290 <p>Examples:</p>
 291 <ul>
 292 <li><a
 293 href="https://github.com/liballeg/allegro5/blob/master/examples/common.c#L40">common.c</a></li>
 294 </ul>
272 <h1·id="al_get_allegro_version">al_get_allegro_version</h1>295 <h1·id="al_get_allegro_version">al_get_allegro_version</h1>
273 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">uint32_t</span>·al_get_allegro_version<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>296 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">uint32_t</span>·al_get_allegro_version<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
274 <p><a297 <p><a
275 href="https://github.com/liballeg/allegro5/blob/master/src/allegro.c#L27">Source298 href="https://github.com/liballeg/allegro5/blob/master/src/allegro.c#L27">Source
276 Code</a></p>299 Code</a></p>
277 <p>Returns·the·(compiled)·version·of·the·Allegro·library,·packed·into·a300 <p>Returns·the·(compiled)·version·of·the·Allegro·library,·packed·into·a
278 single·integer·as·groups·of·8·bits·in·the·form301 single·integer·as·groups·of·8·bits·in·the·form
Offset 358, 14 lines modifiedOffset 381, 23 lines modified
358 </dl>381 </dl>
359 <p>Returns·NULL·on·failure.·The·returned·path·should·be·freed·with·<a382 <p>Returns·NULL·on·failure.·The·returned·path·should·be·freed·with·<a
360 href="path.html#al_destroy_path">al_destroy_path</a>.</p>383 href="path.html#al_destroy_path">al_destroy_path</a>.</p>
361 <p>See·also:·<a·href="system.html#al_set_app_name">al_set_app_name</a>,384 <p>See·also:·<a·href="system.html#al_set_app_name">al_set_app_name</a>,
362 <a·href="system.html#al_set_org_name">al_set_org_name</a>,·<a385 <a·href="system.html#al_set_org_name">al_set_org_name</a>,·<a
363 href="path.html#al_destroy_path">al_destroy_path</a>,·<a386 href="path.html#al_destroy_path">al_destroy_path</a>,·<a
364 href="system.html#al_set_exe_name">al_set_exe_name</a></p>387 href="system.html#al_set_exe_name">al_set_exe_name</a></p>
 388 <p>Examples:</p>
 389 <ul>
 390 <li><a
 391 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_get_path.c#L11">ex_get_path.c</a></li>
 392 <li><a
 393 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_physfs.c#L87">ex_physfs.c</a></li>
 394 <li><a
 395 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_android.c#L20">ex_android.c</a></li>
 396 </ul>
365 <h1·id="al_set_exe_name">al_set_exe_name</h1>397 <h1·id="al_set_exe_name">al_set_exe_name</h1>
366 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_exe_name<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>398 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_exe_name<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>path<span·class="op">)</span></span></code></pre></div>
367 <p><a399 <p><a
368 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L405">Source400 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L405">Source
369 Code</a></p>401 Code</a></p>
370 <p>This·override·the·executable·name·used·by·<a402 <p>This·override·the·executable·name·used·by·<a
371 href="system.html#al_get_standard_path">al_get_standard_path</a>·for403 href="system.html#al_get_standard_path">al_get_standard_path</a>·for
Offset 373, 42 lines modifiedOffset 405, 57 lines modified
373 <p>One·possibility·where·changing·this·can·be·useful·is·if·you·use·the405 <p>One·possibility·where·changing·this·can·be·useful·is·if·you·use·the
374 Python·wrapper.·Allegro·would·then·by·default·think·that·the·system’s406 Python·wrapper.·Allegro·would·then·by·default·think·that·the·system’s
375 Python·executable·is·the·current·executable·-·but·you·can·set·it·to·the407 Python·executable·is·the·current·executable·-·but·you·can·set·it·to·the
376 .py·file·being·executed·instead.</p>408 .py·file·being·executed·instead.</p>
377 <p>Since:·5.0.6,·5.1.0</p>409 <p>Since:·5.0.6,·5.1.0</p>
378 <p>See·also:·<a410 <p>See·also:·<a
379 href="system.html#al_get_standard_path">al_get_standard_path</a></p>411 href="system.html#al_get_standard_path">al_get_standard_path</a></p>
 412 <p>Examples:</p>
 413 <ul>
 414 <li><a
 415 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_get_path.c#L41">ex_get_path.c</a></li>
 416 </ul>
380 <h1·id="al_set_app_name">al_set_app_name</h1>417 <h1·id="al_set_app_name">al_set_app_name</h1>
381 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_app_name<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>app_name<span·class="op">)</span></span></code></pre></div>418 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_app_name<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>app_name<span·class="op">)</span></span></code></pre></div>
382 <p><a419 <p><a
383 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L428">Source420 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L428">Source
384 Code</a></p>421 Code</a></p>
385 <p>Sets·the·global·application·name.</p>422 <p>Sets·the·global·application·name.</p>
386 <p>The·application·name·is·used·by·<a423 <p>The·application·name·is·used·by·<a
387 href="system.html#al_get_standard_path">al_get_standard_path</a>·to424 href="system.html#al_get_standard_path">al_get_standard_path</a>·to
388 build·the·full·path·to·an·application’s·files.</p>425 build·the·full·path·to·an·application’s·files.</p>
389 <p>This·function·may·be·called·before·<a426 <p>This·function·may·be·called·before·<a
390 href="system.html#al_init">al_init</a>·or·<a427 href="system.html#al_init">al_init</a>·or·<a
391 href="system.html#al_install_system">al_install_system</a>.</p>428 href="system.html#al_install_system">al_install_system</a>.</p>
392 <p>See·also:·<a·href="system.html#al_get_app_name">al_get_app_name</a>,429 <p>See·also:·<a·href="system.html#al_get_app_name">al_get_app_name</a>,
393 <a·href="system.html#al_set_org_name">al_set_org_name</a></p>430 <a·href="system.html#al_set_org_name">al_set_org_name</a></p>
 431 <p>Examples:</p>
 432 <ul>
 433 <li><a
 434 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_get_path.c#L28">ex_get_path.c</a></li>
 435 </ul>
394 <h1·id="al_set_org_name">al_set_org_name</h1>436 <h1·id="al_set_org_name">al_set_org_name</h1>
395 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_org_name<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>org_name<span·class="op">)</span></span></code></pre></div>437 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_org_name<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>org_name<span·class="op">)</span></span></code></pre></div>
396 <p><a438 <p><a
397 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L417">Source439 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L417">Source
398 Code</a></p>440 Code</a></p>
399 <p>Sets·the·global·organization·name.</p>441 <p>Sets·the·global·organization·name.</p>
400 <p>The·organization·name·is·used·by·<a442 <p>The·organization·name·is·used·by·<a
401 href="system.html#al_get_standard_path">al_get_standard_path</a>·to443 href="system.html#al_get_standard_path">al_get_standard_path</a>·to
402 build·the·full·path·to·an·application’s·files.</p>444 build·the·full·path·to·an·application’s·files.</p>
403 <p>This·function·may·be·called·before·<a445 <p>This·function·may·be·called·before·<a
404 href="system.html#al_init">al_init</a>·or·<a446 href="system.html#al_init">al_init</a>·or·<a
405 href="system.html#al_install_system">al_install_system</a>.</p>447 href="system.html#al_install_system">al_install_system</a>.</p>
406 <p>See·also:·<a·href="system.html#al_get_org_name">al_get_org_name</a>,448 <p>See·also:·<a·href="system.html#al_get_org_name">al_get_org_name</a>,
407 <a·href="system.html#al_set_app_name">al_set_app_name</a></p>449 <a·href="system.html#al_set_app_name">al_set_app_name</a></p>
 450 <p>Examples:</p>
 451 <ul>
 452 <li><a
Max diff block lines reached; 2446/9942 bytes (24.60%) of diff not shown.
5.56 KB
html2text {}
    
Offset 90, 24 lines modifiedOffset 90, 34 lines modified
90 atexit·function·visible·in·the·current·binary.90 atexit·function·visible·in·the·current·binary.
91 ·····Note:·It·is·typically·wrong·to·call·al_init·anywhere·except·the·final91 ·····Note:·It·is·typically·wrong·to·call·al_init·anywhere·except·the·final
92 ·····game·binary.·In·particular,·do·not·call·it·inside·a·shared·library92 ·····game·binary.·In·particular,·do·not·call·it·inside·a·shared·library
93 ·····unless·you·know·what·you’re·doing.·In·those·cases,·it·is·better·to93 ·····unless·you·know·what·you’re·doing.·In·those·cases,·it·is·better·to
94 ·····call·al_install_system·either·with·a·NULL·atexit_ptr,·or·with·a94 ·····call·al_install_system·either·with·a·NULL·atexit_ptr,·or·with·a
95 ·····pointer·to·atexit·provided·by·the·user·of·this·shared·library.95 ·····pointer·to·atexit·provided·by·the·user·of·this·shared·library.
96 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m96 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m
 97 Examples:
 98 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8d_\x8e_\x8v_\x8i_\x8c_\x8e_\x8s_\x8._\x8c
 99 ····*·_\x8e_\x8x_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 100 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8n_\x8i_\x8t_\x8o_\x8r_\x8i_\x8n_\x8f_\x8o_\x8._\x8c
97 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_s\x8sy\x8ys\x8st\x8te\x8em\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*101 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_s\x8sy\x8ys\x8st\x8te\x8em\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
98 void·al_uninstall_system(void)102 void·al_uninstall_system(void)
99 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e103 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
100 Closes·down·the·Allegro·system.104 Closes·down·the·Allegro·system.
101 ·····Note:·al_uninstall_system()·can·be·called·without·a·corresponding105 ·····Note:·al_uninstall_system()·can·be·called·without·a·corresponding
102 ·····_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m·call,·e.g. from·atexit().106 ·····_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m·call,·e.g. from·atexit().
 107 Examples:
 108 ····*·_\x8e_\x8x_\x8__\x8o_\x8p_\x8e_\x8n_\x8g_\x8l_\x8__\x8p_\x8i_\x8x_\x8e_\x8l_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
 109 ····*·_\x8e_\x8x_\x8__\x8i_\x8c_\x8o_\x8n_\x82_\x8._\x8c
 110 ····*·_\x8e_\x8x_\x8__\x8i_\x8c_\x8o_\x8n_\x8._\x8c
103 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_s\x8sy\x8ys\x8st\x8te\x8em\x8m_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*111 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_s\x8sy\x8ys\x8st\x8te\x8em\x8m_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
104 bool·al_is_system_installed(void)112 bool·al_is_system_installed(void)
105 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e113 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
106 Returns·true·if·Allegro·is·initialized,·otherwise·returns·false.114 Returns·true·if·Allegro·is·initialized,·otherwise·returns·false.
 115 Examples:
 116 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c
107 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8al\x8ll\x8le\x8eg\x8gr\x8ro\x8o_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*117 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8al\x8ll\x8le\x8eg\x8gr\x8ro\x8o_\x8_v\x8ve\x8er\x8rs\x8si\x8io\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
108 uint32_t·al_get_allegro_version(void)118 uint32_t·al_get_allegro_version(void)
109 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e119 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
110 Returns·the·(compiled)·version·of·the·Allegro·library,·packed·into·a·single120 Returns·the·(compiled)·version·of·the·Allegro·library,·packed·into·a·single
111 integer·as·groups·of·8·bits·in·the·form·(major·<<·24)·|·(minor·<<·16)·|121 integer·as·groups·of·8·bits·in·the·form·(major·<<·24)·|·(minor·<<·16)·|
112 (revision·<<·8)·|·release.122 (revision·<<·8)·|·release.
113 You·can·use·code·like·this·to·extract·them:123 You·can·use·code·like·this·to·extract·them:
Offset 168, 41 lines modifiedOffset 178, 51 lines modified
168 ······path·will·usually·not·be·present·on·the·file·system,·so·make·sure·to178 ······path·will·usually·not·be·present·on·the·file·system,·so·make·sure·to
169 ······create·it·before·writing·to·it.179 ······create·it·before·writing·to·it.
170 ··ALLEGRO_EXENAME_PATH180 ··ALLEGRO_EXENAME_PATH
171 ······The·full·path·to·the·executable.181 ······The·full·path·to·the·executable.
172 Returns·NULL·on·failure.·The·returned·path·should·be·freed·with182 Returns·NULL·on·failure.·The·returned·path·should·be·freed·with
173 _\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h.183 _\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h.
174 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8a_\x8p_\x8p_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8o_\x8r_\x8g_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8e_\x8x_\x8e_\x8__\x8n_\x8a_\x8m_\x8e184 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8a_\x8p_\x8p_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8o_\x8r_\x8g_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8p_\x8a_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8e_\x8x_\x8e_\x8__\x8n_\x8a_\x8m_\x8e
 185 Examples:
 186 ····*·_\x8e_\x8x_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
 187 ····*·_\x8e_\x8x_\x8__\x8p_\x8h_\x8y_\x8s_\x8f_\x8s_\x8._\x8c
 188 ····*·_\x8e_\x8x_\x8__\x8a_\x8n_\x8d_\x8r_\x8o_\x8i_\x8d_\x8._\x8c
175 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_e\x8ex\x8xe\x8e_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*189 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_e\x8ex\x8xe\x8e_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
176 void·al_set_exe_name(char·const·*path)190 void·al_set_exe_name(char·const·*path)
177 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e191 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
178 This·override·the·executable·name·used·by·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8p_\x8a_\x8t_\x8h·for192 This·override·the·executable·name·used·by·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8p_\x8a_\x8t_\x8h·for
179 ALLEGRO_EXENAME_PATH·and·ALLEGRO_RESOURCES_PATH.193 ALLEGRO_EXENAME_PATH·and·ALLEGRO_RESOURCES_PATH.
180 One·possibility·where·changing·this·can·be·useful·is·if·you·use·the·Python194 One·possibility·where·changing·this·can·be·useful·is·if·you·use·the·Python
181 wrapper.·Allegro·would·then·by·default·think·that·the·system’s·Python195 wrapper.·Allegro·would·then·by·default·think·that·the·system’s·Python
182 executable·is·the·current·executable·-·but·you·can·set·it·to·the·.py·file·being196 executable·is·the·current·executable·-·but·you·can·set·it·to·the·.py·file·being
183 executed·instead.197 executed·instead.
184 Since:·5.0.6,·5.1.0198 Since:·5.0.6,·5.1.0
185 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8p_\x8a_\x8t_\x8h199 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8p_\x8a_\x8t_\x8h
 200 Examples:
 201 ····*·_\x8e_\x8x_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
186 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_a\x8ap\x8pp\x8p_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*202 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_a\x8ap\x8pp\x8p_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
187 void·al_set_app_name(const·char·*app_name)203 void·al_set_app_name(const·char·*app_name)
188 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e204 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
189 Sets·the·global·application·name.205 Sets·the·global·application·name.
190 The·application·name·is·used·by·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8p_\x8a_\x8t_\x8h·to·build·the·full·path·to206 The·application·name·is·used·by·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8p_\x8a_\x8t_\x8h·to·build·the·full·path·to
191 an·application’s·files.207 an·application’s·files.
192 This·function·may·be·called·before·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t·or·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m.208 This·function·may·be·called·before·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t·or·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m.
193 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8a_\x8p_\x8p_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8o_\x8r_\x8g_\x8__\x8n_\x8a_\x8m_\x8e209 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8a_\x8p_\x8p_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8o_\x8r_\x8g_\x8__\x8n_\x8a_\x8m_\x8e
 210 Examples:
 211 ····*·_\x8e_\x8x_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
194 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_o\x8or\x8rg\x8g_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*212 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_o\x8or\x8rg\x8g_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
195 void·al_set_org_name(const·char·*org_name)213 void·al_set_org_name(const·char·*org_name)
196 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e214 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
197 Sets·the·global·organization·name.215 Sets·the·global·organization·name.
198 The·organization·name·is·used·by·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8p_\x8a_\x8t_\x8h·to·build·the·full·path·to216 The·organization·name·is·used·by·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8s_\x8t_\x8a_\x8n_\x8d_\x8a_\x8r_\x8d_\x8__\x8p_\x8a_\x8t_\x8h·to·build·the·full·path·to
199 an·application’s·files.217 an·application’s·files.
200 This·function·may·be·called·before·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t·or·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m.218 This·function·may·be·called·before·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t·or·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8s_\x8y_\x8s_\x8t_\x8e_\x8m.
201 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8o_\x8r_\x8g_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8a_\x8p_\x8p_\x8__\x8n_\x8a_\x8m_\x8e219 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8o_\x8r_\x8g_\x8__\x8n_\x8a_\x8m_\x8e,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8a_\x8p_\x8p_\x8__\x8n_\x8a_\x8m_\x8e
 220 Examples:
 221 ····*·_\x8e_\x8x_\x8__\x8g_\x8e_\x8t_\x8__\x8p_\x8a_\x8t_\x8h_\x8._\x8c
202 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8ap\x8pp\x8p_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*222 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_a\x8ap\x8pp\x8p_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
203 const·char·*al_get_app_name(void)223 const·char·*al_get_app_name(void)
204 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e224 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
205 Returns·the·global·application·name·string.225 Returns·the·global·application·name·string.
206 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8a_\x8p_\x8p_\x8__\x8n_\x8a_\x8m_\x8e226 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8a_\x8p_\x8p_\x8__\x8n_\x8a_\x8m_\x8e
207 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_o\x8or\x8rg\x8g_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*227 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_o\x8or\x8rg\x8g_\x8_n\x8na\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
208 const·char·*al_get_org_name(void)228 const·char·*al_get_org_name(void)
Offset 493, 14 lines modifiedOffset 513, 17 lines modified
493 #·To·restore·behavior·of·older·code·versions,·specify·this·value·to·the513 #·To·restore·behavior·of·older·code·versions,·specify·this·value·to·the
494 #·Allegro·version·that·had·the·desired·old·behavior.514 #·Allegro·version·that·had·the·desired·old·behavior.
495 #·joystick_version·=·5.2.9515 #·joystick_version·=·5.2.9
496 #·keyboard_version·=·5.2.9516 #·keyboard_version·=·5.2.9
  
497 #·Prefer·using·DUMB·rather·than·OpenMPT·to·decode·module·files.517 #·Prefer·using·DUMB·rather·than·OpenMPT·to·decode·module·files.
498 acodec_prefer_dumb·=·false518 acodec_prefer_dumb·=·false
 519 Examples:
 520 ····*·_\x8e_\x8x_\x8__\x8r_\x8e_\x8s_\x8i_\x8z_\x8e_\x82_\x8._\x8c
 521 ····*·_\x8e_\x8x_\x8__\x8c_\x8a_\x8m_\x8e_\x8r_\x8a_\x8._\x8c
499 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_s\x8sy\x8ys\x8st\x8te\x8em\x8m_\x8_i\x8id\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*522 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_s\x8sy\x8ys\x8st\x8te\x8em\x8m_\x8_i\x8id\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
500 ALLEGRO_SYSTEM_ID·al_get_system_id(void)523 ALLEGRO_SYSTEM_ID·al_get_system_id(void)
501 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e524 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
502 Returns·the·platform·that·Allegro·is·running·on.525 Returns·the·platform·that·Allegro·is·running·on.
503 Since:·5.2.5526 Since:·5.2.5
504 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8Y_\x8S_\x8T_\x8E_\x8M_\x8__\x8I_\x8D527 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8S_\x8Y_\x8S_\x8T_\x8E_\x8M_\x8__\x8I_\x8D
505 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8eg\x8gi\x8is\x8st\x8te\x8er\x8r_\x8_a\x8as\x8ss\x8se\x8er\x8rt\x8t_\x8_h\x8ha\x8an\x8nd\x8dl\x8le\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*528 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8eg\x8gi\x8is\x8st\x8te\x8er\x8r_\x8_a\x8as\x8ss\x8se\x8er\x8rt\x8t_\x8_h\x8ha\x8an\x8nd\x8dl\x8le\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
30.2 KB
./usr/share/doc/allegro5-doc/refman/threads.html
    
Offset 228, 39 lines modifiedOffset 228, 69 lines modified
228 <div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"·tabindex="-1"></a>·<span·class="pp">#include·</span><span·class="im">&lt;allegro5/allegro.h&gt;</span></span></code></pre></div>228 <div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"·tabindex="-1"></a>·<span·class="pp">#include·</span><span·class="im">&lt;allegro5/allegro.h&gt;</span></span></code></pre></div>
229 <h1·id="allegro_thread">ALLEGRO_THREAD</h1>229 <h1·id="allegro_thread">ALLEGRO_THREAD</h1>
230 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_THREAD·ALLEGRO_THREAD<span·class="op">;</span></span></code></pre></div>230 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_THREAD·ALLEGRO_THREAD<span·class="op">;</span></span></code></pre></div>
231 <p><a231 <p><a
232 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/threads.h#L27">Source232 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/threads.h#L27">Source
233 Code</a></p>233 Code</a></p>
234 <p>An·opaque·structure·representing·a·thread.</p>234 <p>An·opaque·structure·representing·a·thread.</p>
 235 <p>Examples:</p>
 236 <ul>
 237 <li><a
 238 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads.c#L97">ex_threads.c</a></li>
 239 <li><a
 240 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads2.c#L150">ex_threads2.c</a></li>
 241 <li><a
 242 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_loading_thread.c#L16">ex_loading_thread.c</a></li>
 243 </ul>
235 <h1·id="allegro_mutex">ALLEGRO_MUTEX</h1>244 <h1·id="allegro_mutex">ALLEGRO_MUTEX</h1>
236 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_MUTEX·ALLEGRO_MUTEX<span·class="op">;</span></span></code></pre></div>245 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_MUTEX·ALLEGRO_MUTEX<span·class="op">;</span></span></code></pre></div>
237 <p><a246 <p><a
238 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/threads.h#L31">Source247 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/threads.h#L31">Source
239 Code</a></p>248 Code</a></p>
240 <p>An·opaque·structure·representing·a·mutex.</p>249 <p>An·opaque·structure·representing·a·mutex.</p>
 250 <p>Examples:</p>
 251 <ul>
 252 <li><a
 253 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads2.c#L27">ex_threads2.c</a></li>
 254 <li><a
 255 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_loading_thread.c#L14">ex_loading_thread.c</a></li>
 256 </ul>
241 <h1·id="allegro_cond">ALLEGRO_COND</h1>257 <h1·id="allegro_cond">ALLEGRO_COND</h1>
242 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_COND·ALLEGRO_COND<span·class="op">;</span></span></code></pre></div>258 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_COND·ALLEGRO_COND<span·class="op">;</span></span></code></pre></div>
243 <p><a259 <p><a
244 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/threads.h#L35">Source260 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/threads.h#L35">Source
245 Code</a></p>261 Code</a></p>
246 <p>An·opaque·structure·representing·a·condition·variable.</p>262 <p>An·opaque·structure·representing·a·condition·variable.</p>
 263 <p>Examples:</p>
 264 <ul>
 265 <li><a
 266 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads2.c#L28">ex_threads2.c</a></li>
 267 </ul>
247 <h1·id="al_create_thread">al_create_thread</h1>268 <h1·id="al_create_thread">al_create_thread</h1>
248 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_THREAD·<span·class="op">*</span>al_create_thread<span·class="op">(</span></span>269 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_THREAD·<span·class="op">*</span>al_create_thread<span·class="op">(</span></span>
249 <span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">void</span>·<span·class="op">*(*</span>proc<span·class="op">)(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">*</span>arg<span·class="op">),</span>·<span·class="dt">void</span>·<span·class="op">*</span>arg<span·class="op">)</span></span></code></pre></div>270 <span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">void</span>·<span·class="op">*(*</span>proc<span·class="op">)(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">*</span>arg<span·class="op">),</span>·<span·class="dt">void</span>·<span·class="op">*</span>arg<span·class="op">)</span></span></code></pre></div>
250 <p><a271 <p><a
251 href="https://github.com/liballeg/allegro5/blob/master/src/threads.c#L115">Source272 href="https://github.com/liballeg/allegro5/blob/master/src/threads.c#L115">Source
252 Code</a></p>273 Code</a></p>
253 <p>Spawn·a·new·thread·which·begins·executing·<code>proc</code>.·The·new274 <p>Spawn·a·new·thread·which·begins·executing·<code>proc</code>.·The·new
254 thread·is·passed·its·own·thread·handle·and·the·value275 thread·is·passed·its·own·thread·handle·and·the·value
255 <code>arg</code>.</p>276 <code>arg</code>.</p>
256 <p>Returns·a·pointer·to·the·thread·on·success.·Otherwise,·returns·NULL277 <p>Returns·a·pointer·to·the·thread·on·success.·Otherwise,·returns·NULL
257 if·there·was·an·error.</p>278 if·there·was·an·error.</p>
258 <p>See·also:·<a·href="threads.html#al_start_thread">al_start_thread</a>,279 <p>See·also:·<a·href="threads.html#al_start_thread">al_start_thread</a>,
259 <a·href="threads.html#al_join_thread">al_join_thread</a>.</p>280 <a·href="threads.html#al_join_thread">al_join_thread</a>.</p>
 281 <p>Examples:</p>
 282 <ul>
 283 <li><a
 284 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads.c#L233">ex_threads.c</a></li>
 285 <li><a
 286 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads2.c#L313">ex_threads2.c</a></li>
 287 <li><a
 288 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_loading_thread.c#L158">ex_loading_thread.c</a></li>
 289 </ul>
260 <h1290 <h1
261 id="al_create_thread_with_stacksize">al_create_thread_with_stacksize</h1>291 id="al_create_thread_with_stacksize">al_create_thread_with_stacksize</h1>
262 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_THREAD·<span·class="op">*</span>al_create_thread_with_stacksize<span·class="op">(</span></span>292 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_THREAD·<span·class="op">*</span>al_create_thread_with_stacksize<span·class="op">(</span></span>
263 <span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">void</span>·<span·class="op">*(*</span>proc<span·class="op">)(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">*</span>arg<span·class="op">),</span>·<span·class="dt">void</span>·<span·class="op">*</span>arg<span·class="op">,</span>·<span·class="dt">size_t</span>·stacksize<span·class="op">)</span></span></code></pre></div>293 <span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"·tabindex="-1"></a>···<span·class="dt">void</span>·<span·class="op">*(*</span>proc<span·class="op">)(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">*</span>arg<span·class="op">),</span>·<span·class="dt">void</span>·<span·class="op">*</span>arg<span·class="op">,</span>·<span·class="dt">size_t</span>·stacksize<span·class="op">)</span></span></code></pre></div>
264 <p><a294 <p><a
265 href="https://github.com/liballeg/allegro5/blob/master/src/threads.c#L131">Source295 href="https://github.com/liballeg/allegro5/blob/master/src/threads.c#L131">Source
266 Code</a></p>296 Code</a></p>
Offset 284, 14 lines modifiedOffset 314, 23 lines modified
284 Code</a></p>314 Code</a></p>
285 <p>When·a·thread·is·created,·it·is·initially·in·a·suspended·state.315 <p>When·a·thread·is·created,·it·is·initially·in·a·suspended·state.
286 Calling·<a·href="threads.html#al_start_thread">al_start_thread</a>·will316 Calling·<a·href="threads.html#al_start_thread">al_start_thread</a>·will
287 start·its·actual·execution.</p>317 start·its·actual·execution.</p>
288 <p>Starting·a·thread·which·has·already·been·started·does·nothing.</p>318 <p>Starting·a·thread·which·has·already·been·started·does·nothing.</p>
289 <p>See·also:·<a319 <p>See·also:·<a
290 href="threads.html#al_create_thread">al_create_thread</a>.</p>320 href="threads.html#al_create_thread">al_create_thread</a>.</p>
 321 <p>Examples:</p>
 322 <ul>
 323 <li><a
 324 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads.c#L237">ex_threads.c</a></li>
 325 <li><a
 326 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads2.c#L329">ex_threads2.c</a></li>
 327 <li><a
 328 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_loading_thread.c#L159">ex_loading_thread.c</a></li>
 329 </ul>
291 <h1·id="al_join_thread">al_join_thread</h1>330 <h1·id="al_join_thread">al_join_thread</h1>
292 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_join_thread<span·class="op">(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">**</span>ret_value<span·class="op">)</span></span></code></pre></div>331 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_join_thread<span·class="op">(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">,</span>·<span·class="dt">void</span>·<span·class="op">**</span>ret_value<span·class="op">)</span></span></code></pre></div>
293 <p><a332 <p><a
294 href="https://github.com/liballeg/allegro5/blob/master/src/threads.c#L194">Source333 href="https://github.com/liballeg/allegro5/blob/master/src/threads.c#L194">Source
295 Code</a></p>334 Code</a></p>
296 <p>Wait·for·the·thread·to·finish·executing.·This·implicitly·calls·<a335 <p>Wait·for·the·thread·to·finish·executing.·This·implicitly·calls·<a
297 href="threads.html#al_set_thread_should_stop">al_set_thread_should_stop</a>336 href="threads.html#al_set_thread_should_stop">al_set_thread_should_stop</a>
Offset 300, 24 lines modifiedOffset 339, 38 lines modified
300 returned·by·the·thread·function·will·be·stored·at·the·location·pointed339 returned·by·the·thread·function·will·be·stored·at·the·location·pointed
301 to·by·<code>ret_value</code>.</p>340 to·by·<code>ret_value</code>.</p>
302 <p>See·also:·<a341 <p>See·also:·<a
303 href="threads.html#al_set_thread_should_stop">al_set_thread_should_stop</a>,342 href="threads.html#al_set_thread_should_stop">al_set_thread_should_stop</a>,
304 <a343 <a
305 href="threads.html#al_get_thread_should_stop">al_get_thread_should_stop</a>,344 href="threads.html#al_get_thread_should_stop">al_get_thread_should_stop</a>,
306 <a·href="threads.html#al_destroy_thread">al_destroy_thread</a>.</p>345 <a·href="threads.html#al_destroy_thread">al_destroy_thread</a>.</p>
 346 <p>Examples:</p>
 347 <ul>
 348 <li><a
 349 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads.c#L240">ex_threads.c</a></li>
 350 <li><a
 351 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads2.c#L383">ex_threads2.c</a></li>
 352 <li><a
 353 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_loading_thread.c#L227">ex_loading_thread.c</a></li>
 354 </ul>
307 <h1·id="al_set_thread_should_stop">al_set_thread_should_stop</h1>355 <h1·id="al_set_thread_should_stop">al_set_thread_should_stop</h1>
308 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_thread_should_stop<span·class="op">(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">)</span></span></code></pre></div>356 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_thread_should_stop<span·class="op">(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">)</span></span></code></pre></div>
309 <p><a357 <p><a
310 href="https://github.com/liballeg/allegro5/blob/master/src/threads.c#L244">Source358 href="https://github.com/liballeg/allegro5/blob/master/src/threads.c#L244">Source
311 Code</a></p>359 Code</a></p>
312 <p>Set·the·flag·to·indicate·<code>thread</code>·should·stop.·Returns360 <p>Set·the·flag·to·indicate·<code>thread</code>·should·stop.·Returns
313 immediately.</p>361 immediately.</p>
314 <p>See·also:·<a·href="threads.html#al_join_thread">al_join_thread</a>,362 <p>See·also:·<a·href="threads.html#al_join_thread">al_join_thread</a>,
315 <a363 <a
316 href="threads.html#al_get_thread_should_stop">al_get_thread_should_stop</a>.</p>364 href="threads.html#al_get_thread_should_stop">al_get_thread_should_stop</a>.</p>
 365 <p>Examples:</p>
 366 <ul>
 367 <li><a
 368 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_threads2.c#L375">ex_threads2.c</a></li>
 369 </ul>
317 <h1·id="al_get_thread_should_stop">al_get_thread_should_stop</h1>370 <h1·id="al_get_thread_should_stop">al_get_thread_should_stop</h1>
318 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_get_thread_should_stop<span·class="op">(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">)</span></span></code></pre></div>371 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_get_thread_should_stop<span·class="op">(</span>ALLEGRO_THREAD·<span·class="op">*</span>thread<span·class="op">)</span></span></code></pre></div>
Max diff block lines reached; 10441/19155 bytes (54.51%) of diff not shown.
11.4 KB
html2text {}
    
Offset 74, 31 lines modifiedOffset 74, 44 lines modified
74 cases.74 cases.
75 These·functions·are·declared·in·the·main·Allegro·header·file:75 These·functions·are·declared·in·the·main·Allegro·header·file:
76 ·#include·<allegro5/allegro.h>76 ·#include·<allegro5/allegro.h>
77 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_T\x8TH\x8HR\x8RE\x8EA\x8AD\x8D·*\x8**\x8**\x8**\x8**\x8**\x8*77 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_T\x8TH\x8HR\x8RE\x8EA\x8AD\x8D·*\x8**\x8**\x8**\x8**\x8**\x8*
78 typedef·struct·ALLEGRO_THREAD·ALLEGRO_THREAD;78 typedef·struct·ALLEGRO_THREAD·ALLEGRO_THREAD;
79 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e79 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
80 An·opaque·structure·representing·a·thread.80 An·opaque·structure·representing·a·thread.
 81 Examples:
 82 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x8._\x8c
 83 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
 84 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
81 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_M\x8MU\x8UT\x8TE\x8EX\x8X·*\x8**\x8**\x8**\x8**\x8**\x8*85 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_M\x8MU\x8UT\x8TE\x8EX\x8X·*\x8**\x8**\x8**\x8**\x8**\x8*
82 typedef·struct·ALLEGRO_MUTEX·ALLEGRO_MUTEX;86 typedef·struct·ALLEGRO_MUTEX·ALLEGRO_MUTEX;
83 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e87 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
84 An·opaque·structure·representing·a·mutex.88 An·opaque·structure·representing·a·mutex.
 89 Examples:
 90 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
 91 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
85 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8ON\x8ND\x8D·*\x8**\x8**\x8**\x8**\x8**\x8*92 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_C\x8CO\x8ON\x8ND\x8D·*\x8**\x8**\x8**\x8**\x8**\x8*
86 typedef·struct·ALLEGRO_COND·ALLEGRO_COND;93 typedef·struct·ALLEGRO_COND·ALLEGRO_COND;
87 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e94 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
88 An·opaque·structure·representing·a·condition·variable.95 An·opaque·structure·representing·a·condition·variable.
 96 Examples:
 97 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
89 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*98 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
90 ALLEGRO_THREAD·*al_create_thread(99 ALLEGRO_THREAD·*al_create_thread(
91 ···void·*(*proc)(ALLEGRO_THREAD·*thread,·void·*arg),·void·*arg)100 ···void·*(*proc)(ALLEGRO_THREAD·*thread,·void·*arg),·void·*arg)
92 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e101 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
93 Spawn·a·new·thread·which·begins·executing·proc.·The·new·thread·is·passed·its102 Spawn·a·new·thread·which·begins·executing·proc.·The·new·thread·is·passed·its
94 own·thread·handle·and·the·value·arg.103 own·thread·handle·and·the·value·arg.
95 Returns·a·pointer·to·the·thread·on·success.·Otherwise,·returns·NULL·if·there104 Returns·a·pointer·to·the·thread·on·success.·Otherwise,·returns·NULL·if·there
96 was·an·error.105 was·an·error.
97 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d,·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d.106 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d,·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d.
 107 Examples:
 108 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x8._\x8c
 109 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
 110 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
98 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d_\x8_w\x8wi\x8it\x8th\x8h_\x8_s\x8st\x8ta\x8ac\x8ck\x8ks\x8si\x8iz\x8ze\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*111 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d_\x8_w\x8wi\x8it\x8th\x8h_\x8_s\x8st\x8ta\x8ac\x8ck\x8ks\x8si\x8iz\x8ze\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
99 ALLEGRO_THREAD·*al_create_thread_with_stacksize(112 ALLEGRO_THREAD·*al_create_thread_with_stacksize(
100 ···void·*(*proc)(ALLEGRO_THREAD·*thread,·void·*arg),·void·*arg,·size_t113 ···void·*(*proc)(ALLEGRO_THREAD·*thread,·void·*arg),·void·*arg,·size_t
101 stacksize)114 stacksize)
102 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e115 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
103 Spawn·a·new·thread·with·the·give·stacksize·in·bytes·which·begins·executing116 Spawn·a·new·thread·with·the·give·stacksize·in·bytes·which·begins·executing
104 proc.·The·new·thread·is·passed·its·own·thread·handle·and·the·value·arg.117 proc.·The·new·thread·is·passed·its·own·thread·handle·and·the·value·arg.
Offset 111, 58 lines modifiedOffset 124, 78 lines modified
111 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8ta\x8ar\x8rt\x8t_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*124 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8ta\x8ar\x8rt\x8t_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
112 void·al_start_thread(ALLEGRO_THREAD·*thread)125 void·al_start_thread(ALLEGRO_THREAD·*thread)
113 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e126 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
114 When·a·thread·is·created,·it·is·initially·in·a·suspended·state.·Calling127 When·a·thread·is·created,·it·is·initially·in·a·suspended·state.·Calling
115 _\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·will·start·its·actual·execution.128 _\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·will·start·its·actual·execution.
116 Starting·a·thread·which·has·already·been·started·does·nothing.129 Starting·a·thread·which·has·already·been·started·does·nothing.
117 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d.130 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d.
 131 Examples:
 132 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x8._\x8c
 133 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
 134 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
118 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_j\x8jo\x8oi\x8in\x8n_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*135 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_j\x8jo\x8oi\x8in\x8n_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
119 void·al_join_thread(ALLEGRO_THREAD·*thread,·void·**ret_value)136 void·al_join_thread(ALLEGRO_THREAD·*thread,·void·**ret_value)
120 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e137 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
121 Wait·for·the·thread·to·finish·executing.·This·implicitly·calls138 Wait·for·the·thread·to·finish·executing.·This·implicitly·calls
122 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p·first.139 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p·first.
123 If·ret_value·is·non-NULL,·the·value·returned·by·the·thread·function·will·be140 If·ret_value·is·non-NULL,·the·value·returned·by·the·thread·function·will·be
124 stored·at·the·location·pointed·to·by·ret_value.141 stored·at·the·location·pointed·to·by·ret_value.
125 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p,142 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p,
126 _\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d.143 _\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d.
 144 Examples:
 145 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x8._\x8c
 146 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
 147 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
127 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d_\x8_s\x8sh\x8ho\x8ou\x8ul\x8ld\x8d_\x8_s\x8st\x8to\x8op\x8p·*\x8**\x8**\x8**\x8**\x8**\x8*148 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d_\x8_s\x8sh\x8ho\x8ou\x8ul\x8ld\x8d_\x8_s\x8st\x8to\x8op\x8p·*\x8**\x8**\x8**\x8**\x8**\x8*
128 void·al_set_thread_should_stop(ALLEGRO_THREAD·*thread)149 void·al_set_thread_should_stop(ALLEGRO_THREAD·*thread)
129 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e150 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
130 Set·the·flag·to·indicate·thread·should·stop.·Returns·immediately.151 Set·the·flag·to·indicate·thread·should·stop.·Returns·immediately.
131 See·also:·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p.152 See·also:·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p.
 153 Examples:
 154 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
132 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d_\x8_s\x8sh\x8ho\x8ou\x8ul\x8ld\x8d_\x8_s\x8st\x8to\x8op\x8p·*\x8**\x8**\x8**\x8**\x8**\x8*155 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d_\x8_s\x8sh\x8ho\x8ou\x8ul\x8ld\x8d_\x8_s\x8st\x8to\x8op\x8p·*\x8**\x8**\x8**\x8**\x8**\x8*
133 bool·al_get_thread_should_stop(ALLEGRO_THREAD·*thread)156 bool·al_get_thread_should_stop(ALLEGRO_THREAD·*thread)
134 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e157 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
135 Check·if·another·thread·is·waiting·for·thread·to·stop.·Threads·which·run·in·a158 Check·if·another·thread·is·waiting·for·thread·to·stop.·Threads·which·run·in·a
136 loop·should·check·this·periodically·and·act·on·it·when·convenient.159 loop·should·check·this·periodically·and·act·on·it·when·convenient.
137 Returns·true·if·another·thread·has·called·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·or160 Returns·true·if·another·thread·has·called·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·or
138 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p·on·this·thread.161 _\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p·on·this·thread.
139 See·also:·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p.162 See·also:·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d,·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8__\x8s_\x8h_\x8o_\x8u_\x8l_\x8d_\x8__\x8s_\x8t_\x8o_\x8p.
140 ·····N\x8No\x8ot\x8te\x8e:\x8:·We·don’t·support·forceful·killing·of·threads.163 ·····N\x8No\x8ot\x8te\x8e:\x8:·We·don’t·support·forceful·killing·of·threads.
 164 Examples:
 165 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
 166 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
141 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*167 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
142 void·al_destroy_thread(ALLEGRO_THREAD·*thread)168 void·al_destroy_thread(ALLEGRO_THREAD·*thread)
143 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e169 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
144 Free·the·resources·used·by·a·thread.·Implicitly·performs·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·on·the170 Free·the·resources·used·by·a·thread.·Implicitly·performs·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·on·the
145 thread·if·it·hasn’t·been·done·already.171 thread·if·it·hasn’t·been·done·already.
146 Does·nothing·if·thread·is·NULL.172 Does·nothing·if·thread·is·NULL.
147 See·also:·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d.173 See·also:·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d.
 174 Examples:
 175 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x8._\x8c
 176 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
 177 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
148 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8ru\x8un\x8n_\x8_d\x8de\x8et\x8ta\x8ac\x8ch\x8he\x8ed\x8d_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*178 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8ru\x8un\x8n_\x8_d\x8de\x8et\x8ta\x8ac\x8ch\x8he\x8ed\x8d_\x8_t\x8th\x8hr\x8re\x8ea\x8ad\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
149 void·al_run_detached_thread(void·*(*proc)(void·*arg),·void·*arg)179 void·al_run_detached_thread(void·*(*proc)(void·*arg),·void·*arg)
150 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e180 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
151 Runs·the·passed·function·in·its·own·thread,·with·arg·passed·to·it·as·only181 Runs·the·passed·function·in·its·own·thread,·with·arg·passed·to·it·as·only
152 parameter.·This·is·similar·to·calling·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·and182 parameter.·This·is·similar·to·calling·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·and
153 (after·the·thread·has·finished)·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·-·but·you·don’t·have·the183 (after·the·thread·has·finished)·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·-·but·you·don’t·have·the
154 possibility·of·ever·calling·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·on·the·thread.184 possibility·of·ever·calling·_\x8a_\x8l_\x8__\x8j_\x8o_\x8i_\x8n_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d·on·the·thread.
155 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_m\x8mu\x8ut\x8te\x8ex\x8x·*\x8**\x8**\x8**\x8**\x8**\x8*185 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_m\x8mu\x8ut\x8te\x8ex\x8x·*\x8**\x8**\x8**\x8**\x8**\x8*
156 ALLEGRO_MUTEX·*al_create_mutex(void)186 ALLEGRO_MUTEX·*al_create_mutex(void)
157 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e187 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
158 Create·the·mutex·object·(a·mutual·exclusion·device).·The·mutex·may·or·may·not188 Create·the·mutex·object·(a·mutual·exclusion·device).·The·mutex·may·or·may·not
159 support·“recursive”·locking.189 support·“recursive”·locking.
160 Returns·the·mutex·on·success·or·NULL·on·error.190 Returns·the·mutex·on·success·or·NULL·on·error.
161 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8m_\x8u_\x8t_\x8e_\x8x_\x8__\x8r_\x8e_\x8c_\x8u_\x8r_\x8s_\x8i_\x8v_\x8e.191 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8m_\x8u_\x8t_\x8e_\x8x_\x8__\x8r_\x8e_\x8c_\x8u_\x8r_\x8s_\x8i_\x8v_\x8e.
 192 Examples:
 193 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x82_\x8._\x8c
 194 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
162 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_m\x8mu\x8ut\x8te\x8ex\x8x_\x8_r\x8re\x8ec\x8cu\x8ur\x8rs\x8si\x8iv\x8ve\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*195 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_m\x8mu\x8ut\x8te\x8ex\x8x_\x8_r\x8re\x8ec\x8cu\x8ur\x8rs\x8si\x8iv\x8ve\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
163 ALLEGRO_MUTEX·*al_create_mutex_recursive(void)196 ALLEGRO_MUTEX·*al_create_mutex_recursive(void)
164 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e197 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
165 Create·the·mutex·object·(a·mutual·exclusion·device),·with·support·for198 Create·the·mutex·object·(a·mutual·exclusion·device),·with·support·for
166 “recursive”·locking.·That·is,·the·mutex·will·count·the·number·of·times·it·has199 “recursive”·locking.·That·is,·the·mutex·will·count·the·number·of·times·it·has
167 been·locked·by·the·same·thread.·If·the·caller·tries·to·acquire·a·lock·on·the200 been·locked·by·the·same·thread.·If·the·caller·tries·to·acquire·a·lock·on·the
168 mutex·when·it·already·holds·the·lock·then·the·count·is·incremented.·The·mutex201 mutex·when·it·already·holds·the·lock·then·the·count·is·incremented.·The·mutex
Offset 177, 32 lines modifiedOffset 210, 42 lines modified
177 If·the·mutex·is·already·locked·by·the·calling·thread,·then·the·behaviour210 If·the·mutex·is·already·locked·by·the·calling·thread,·then·the·behaviour
178 depends·on·whether·the·mutex·was·created·with·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8m_\x8u_\x8t_\x8e_\x8x·or211 depends·on·whether·the·mutex·was·created·with·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8m_\x8u_\x8t_\x8e_\x8x·or
179 _\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8m_\x8u_\x8t_\x8e_\x8x_\x8__\x8r_\x8e_\x8c_\x8u_\x8r_\x8s_\x8i_\x8v_\x8e.·In·the·former·case,·the·behaviour·is·undefined;·the212 _\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8m_\x8u_\x8t_\x8e_\x8x_\x8__\x8r_\x8e_\x8c_\x8u_\x8r_\x8s_\x8i_\x8v_\x8e.·In·the·former·case,·the·behaviour·is·undefined;·the
Max diff block lines reached; 3944/11620 bytes (33.94%) of diff not shown.
6.69 KB
./usr/share/doc/allegro5-doc/refman/time.html
    
Offset 187, 47 lines modifiedOffset 187, 75 lines modified
187 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_TIMEOUT·ALLEGRO_TIMEOUT<span·class="op">;</span></span></code></pre></div>187 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_TIMEOUT·ALLEGRO_TIMEOUT<span·class="op">;</span></span></code></pre></div>
188 <p><a188 <p><a
189 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/altime.h#L12">Source189 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/altime.h#L12">Source
190 Code</a></p>190 Code</a></p>
191 <p>Represent·a·timeout·value.·The·size·of·the·structure·is·known·so·it191 <p>Represent·a·timeout·value.·The·size·of·the·structure·is·known·so·it
192 can·be·statically·allocated.·The·contents·are·private.</p>192 can·be·statically·allocated.·The·contents·are·private.</p>
193 <p>See·also:·<a·href="time.html#al_init_timeout">al_init_timeout</a></p>193 <p>See·also:·<a·href="time.html#al_init_timeout">al_init_timeout</a></p>
 194 <p>Examples:</p>
 195 <ul>
 196 <li><a
 197 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timedwait.c#L99">ex_timedwait.c</a></li>
 198 </ul>
194 <h1·id="al_get_time">al_get_time</h1>199 <h1·id="al_get_time">al_get_time</h1>
195 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">double</span>·al_get_time<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>200 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">double</span>·al_get_time<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
196 <p><a201 <p><a
197 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L504">Source202 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L504">Source
198 Code</a></p>203 Code</a></p>
199 <p>Return·the·number·of·seconds·since·the·Allegro·library·was204 <p>Return·the·number·of·seconds·since·the·Allegro·library·was
200 initialised.·The·return·value·is·undefined·if·Allegro·is·uninitialised.205 initialised.·The·return·value·is·undefined·if·Allegro·is·uninitialised.
201 The·resolution·depends·on·the·used·driver,·but·typically·can·be·in·the206 The·resolution·depends·on·the·used·driver,·but·typically·can·be·in·the
202 order·of·microseconds.</p>207 order·of·microseconds.</p>
 208 <p>Examples:</p>
 209 <ul>
 210 <li><a
 211 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_convert.c#L40">ex_convert.c</a></li>
 212 <li><a
 213 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_d3d.cpp#L81">ex_d3d.cpp</a></li>
 214 <li><a
 215 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L215">ex_enet_server.c</a></li>
 216 </ul>
203 <h1·id="al_init_timeout">al_init_timeout</h1>217 <h1·id="al_init_timeout">al_init_timeout</h1>
204 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_init_timeout<span·class="op">(</span>ALLEGRO_TIMEOUT·<span·class="op">*</span>timeout<span·class="op">,</span>·<span·class="dt">double</span>·seconds<span·class="op">)</span></span></code></pre></div>218 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_init_timeout<span·class="op">(</span>ALLEGRO_TIMEOUT·<span·class="op">*</span>timeout<span·class="op">,</span>·<span·class="dt">double</span>·seconds<span·class="op">)</span></span></code></pre></div>
205 <p><a219 <p><a
206 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L527">Source220 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L527">Source
207 Code</a></p>221 Code</a></p>
208 <p>Set·timeout·value·of·some·number·of·seconds·after·the·function222 <p>Set·timeout·value·of·some·number·of·seconds·after·the·function
209 call.</p>223 call.</p>
210 <p>For·compatibility·with·all·platforms,·<code>seconds</code>·must·be224 <p>For·compatibility·with·all·platforms,·<code>seconds</code>·must·be
211 2,147,483.647·seconds·or·less.</p>225 2,147,483.647·seconds·or·less.</p>
212 <p>See·also:·<a·href="time.html#allegro_timeout">ALLEGRO_TIMEOUT</a>,·<a226 <p>See·also:·<a·href="time.html#allegro_timeout">ALLEGRO_TIMEOUT</a>,·<a
213 href="events.html#al_wait_for_event_until">al_wait_for_event_until</a></p>227 href="events.html#al_wait_for_event_until">al_wait_for_event_until</a></p>
 228 <p>Examples:</p>
 229 <ul>
 230 <li><a
 231 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timedwait.c#L105">ex_timedwait.c</a></li>
 232 </ul>
214 <h1·id="al_rest">al_rest</h1>233 <h1·id="al_rest">al_rest</h1>
215 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_rest<span·class="op">(</span><span·class="dt">double</span>·seconds<span·class="op">)</span></span></code></pre></div>234 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_rest<span·class="op">(</span><span·class="dt">double</span>·seconds<span·class="op">)</span></span></code></pre></div>
216 <p><a235 <p><a
217 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L516">Source236 href="https://github.com/liballeg/allegro5/blob/master/src/system.c#L516">Source
218 Code</a></p>237 Code</a></p>
219 <p>Waits·for·the·specified·number·of·seconds.·This·tells·the·system·to238 <p>Waits·for·the·specified·number·of·seconds.·This·tells·the·system·to
220 pause·the·current·thread·for·the·given·amount·of·time.·With·some239 pause·the·current·thread·for·the·given·amount·of·time.·With·some
221 operating·systems,·the·accuracy·can·be·in·the·order·of·10ms.·That·is,240 operating·systems,·the·accuracy·can·be·in·the·order·of·10ms.·That·is,
222 even</p>241 even</p>
223 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>al_rest<span·class="op">(</span><span·class="fl">0.000001</span><span·class="op">)</span></span></code></pre></div>242 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>al_rest<span·class="op">(</span><span·class="fl">0.000001</span><span·class="op">)</span></span></code></pre></div>
224 <p>might·pause·for·something·like·10ms.·Also·see·the·section·on·Timer243 <p>might·pause·for·something·like·10ms.·Also·see·the·section·on·Timer
225 routines·for·easier·ways·to·time·your·program·without·using·up·all244 routines·for·easier·ways·to·time·your·program·without·using·up·all
226 CPU.</p>245 CPU.</p>
 246 <p>Examples:</p>
 247 <ul>
 248 <li><a
 249 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_keyboard_focus.c#L68">ex_keyboard_focus.c</a></li>
 250 <li><a
 251 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L45">ex_timer_pause.c</a></li>
 252 <li><a
 253 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_focus.c#L92">ex_mouse_focus.c</a></li>
 254 </ul>
227 <p·class="timestamp">255 <p·class="timestamp">
228 Allegro·version·5.2.10256 Allegro·version·5.2.10
229 ·-·Last·updated:·2025-01-09·13:52:42·UTC257 ·-·Last·updated:·2025-01-09·13:52:42·UTC
230 </p>258 </p>
231 </div>259 </div>
232 </body>260 </body>
233 </html>261 </html>
2.22 KB
html2text {}
    
Offset 51, 30 lines modifiedOffset 51, 42 lines modified
51 ·#include·<allegro5/allegro.h>51 ·#include·<allegro5/allegro.h>
52 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_T\x8TI\x8IM\x8ME\x8EO\x8OU\x8UT\x8T·*\x8**\x8**\x8**\x8**\x8**\x8*52 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_T\x8TI\x8IM\x8ME\x8EO\x8OU\x8UT\x8T·*\x8**\x8**\x8**\x8**\x8**\x8*
53 typedef·struct·ALLEGRO_TIMEOUT·ALLEGRO_TIMEOUT;53 typedef·struct·ALLEGRO_TIMEOUT·ALLEGRO_TIMEOUT;
54 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e54 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
55 Represent·a·timeout·value.·The·size·of·the·structure·is·known·so·it·can·be55 Represent·a·timeout·value.·The·size·of·the·structure·is·known·so·it·can·be
56 statically·allocated.·The·contents·are·private.56 statically·allocated.·The·contents·are·private.
57 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8o_\x8u_\x8t57 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8o_\x8u_\x8t
 58 Examples:
 59 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8d_\x8w_\x8a_\x8i_\x8t_\x8._\x8c
58 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*60 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
59 double·al_get_time(void)61 double·al_get_time(void)
60 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e62 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
61 Return·the·number·of·seconds·since·the·Allegro·library·was·initialised.·The63 Return·the·number·of·seconds·since·the·Allegro·library·was·initialised.·The
62 return·value·is·undefined·if·Allegro·is·uninitialised.·The·resolution·depends64 return·value·is·undefined·if·Allegro·is·uninitialised.·The·resolution·depends
63 on·the·used·driver,·but·typically·can·be·in·the·order·of·microseconds.65 on·the·used·driver,·but·typically·can·be·in·the·order·of·microseconds.
 66 Examples:
 67 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8n_\x8v_\x8e_\x8r_\x8t_\x8._\x8c
 68 ····*·_\x8e_\x8x_\x8__\x8d_\x83_\x8d_\x8._\x8c_\x8p_\x8p
 69 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
64 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_t\x8ti\x8im\x8me\x8eo\x8ou\x8ut\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*70 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_t\x8ti\x8im\x8me\x8eo\x8ou\x8ut\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
65 void·al_init_timeout(ALLEGRO_TIMEOUT·*timeout,·double·seconds)71 void·al_init_timeout(ALLEGRO_TIMEOUT·*timeout,·double·seconds)
66 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e72 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
67 Set·timeout·value·of·some·number·of·seconds·after·the·function·call.73 Set·timeout·value·of·some·number·of·seconds·after·the·function·call.
68 For·compatibility·with·all·platforms,·seconds·must·be·2,147,483.647·seconds·or74 For·compatibility·with·all·platforms,·seconds·must·be·2,147,483.647·seconds·or
69 less.75 less.
70 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8T_\x8I_\x8M_\x8E_\x8O_\x8U_\x8T,·_\x8a_\x8l_\x8__\x8w_\x8a_\x8i_\x8t_\x8__\x8f_\x8o_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8u_\x8n_\x8t_\x8i_\x8l76 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8T_\x8I_\x8M_\x8E_\x8O_\x8U_\x8T,·_\x8a_\x8l_\x8__\x8w_\x8a_\x8i_\x8t_\x8__\x8f_\x8o_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8u_\x8n_\x8t_\x8i_\x8l
 77 Examples:
 78 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8d_\x8w_\x8a_\x8i_\x8t_\x8._\x8c
71 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8st\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*79 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8st\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
72 void·al_rest(double·seconds)80 void·al_rest(double·seconds)
73 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e81 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
74 Waits·for·the·specified·number·of·seconds.·This·tells·the·system·to·pause·the82 Waits·for·the·specified·number·of·seconds.·This·tells·the·system·to·pause·the
75 current·thread·for·the·given·amount·of·time.·With·some·operating·systems,·the83 current·thread·for·the·given·amount·of·time.·With·some·operating·systems,·the
76 accuracy·can·be·in·the·order·of·10ms.·That·is,·even84 accuracy·can·be·in·the·order·of·10ms.·That·is,·even
77 al_rest(0.000001)85 al_rest(0.000001)
78 might·pause·for·something·like·10ms.·Also·see·the·section·on·Timer·routines·for86 might·pause·for·something·like·10ms.·Also·see·the·section·on·Timer·routines·for
79 easier·ways·to·time·your·program·without·using·up·all·CPU.87 easier·ways·to·time·your·program·without·using·up·all·CPU.
 88 Examples:
 89 ····*·_\x8e_\x8x_\x8__\x8k_\x8e_\x8y_\x8b_\x8o_\x8a_\x8r_\x8d_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
 90 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
 91 ····*·_\x8e_\x8x_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8f_\x8o_\x8c_\x8u_\x8s_\x8._\x8c
80 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC92 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC
21.9 KB
./usr/share/doc/allegro5-doc/refman/timer.html
    
Offset 213, 14 lines modifiedOffset 213, 23 lines modified
213 <div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"·tabindex="-1"></a>·<span·class="pp">#include·</span><span·class="im">&lt;allegro5/allegro.h&gt;</span></span></code></pre></div>213 <div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"·tabindex="-1"></a>·<span·class="pp">#include·</span><span·class="im">&lt;allegro5/allegro.h&gt;</span></span></code></pre></div>
214 <h1·id="allegro_timer">ALLEGRO_TIMER</h1>214 <h1·id="allegro_timer">ALLEGRO_TIMER</h1>
215 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_TIMER·ALLEGRO_TIMER<span·class="op">;</span></span></code></pre></div>215 <div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_TIMER·ALLEGRO_TIMER<span·class="op">;</span></span></code></pre></div>
216 <p><a216 <p><a
217 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/timer.h#L46">Source217 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/timer.h#L46">Source
218 Code</a></p>218 Code</a></p>
219 <p>This·is·an·abstract·data·type·representing·a·timer·object.</p>219 <p>This·is·an·abstract·data·type·representing·a·timer·object.</p>
 220 <p>Examples:</p>
 221 <ul>
 222 <li><a
 223 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L188">ex_enet_server.c</a></li>
 224 <li><a
 225 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L22">ex_timer_pause.c</a></li>
 226 <li><a
 227 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_user_events.c#L46">ex_user_events.c</a></li>
 228 </ul>
220 <h1·id="allegro_usecs_to_secs">ALLEGRO_USECS_TO_SECS</h1>229 <h1·id="allegro_usecs_to_secs">ALLEGRO_USECS_TO_SECS</h1>
221 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_USECS_TO_SECS</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">)</span><span·class="pp">······</span><span·class="op">((</span><span·class="pp">x</span><span·class="op">)</span><span·class="pp">·</span><span·class="op">/</span><span·class="pp">·</span><span·class="fl">1000000.0</span><span·class="op">)</span></span></code></pre></div>230 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_USECS_TO_SECS</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">)</span><span·class="pp">······</span><span·class="op">((</span><span·class="pp">x</span><span·class="op">)</span><span·class="pp">·</span><span·class="op">/</span><span·class="pp">·</span><span·class="fl">1000000.0</span><span·class="op">)</span></span></code></pre></div>
222 <p><a231 <p><a
223 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/timer.h#L29">Source232 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/timer.h#L29">Source
224 Code</a></p>233 Code</a></p>
225 <p>Convert·microseconds·to·seconds.</p>234 <p>Convert·microseconds·to·seconds.</p>
226 <h1·id="allegro_msecs_to_secs">ALLEGRO_MSECS_TO_SECS</h1>235 <h1·id="allegro_msecs_to_secs">ALLEGRO_MSECS_TO_SECS</h1>
Offset 231, 14 lines modifiedOffset 240, 19 lines modified
231 <p>Convert·milliseconds·to·seconds.</p>240 <p>Convert·milliseconds·to·seconds.</p>
232 <h1·id="allegro_bps_to_secs">ALLEGRO_BPS_TO_SECS</h1>241 <h1·id="allegro_bps_to_secs">ALLEGRO_BPS_TO_SECS</h1>
233 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_BPS_TO_SECS</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">)</span><span·class="pp">········</span><span·class="op">(</span><span·class="fl">1.0</span><span·class="pp">·</span><span·class="op">/</span><span·class="pp">·</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">))</span></span></code></pre></div>242 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_BPS_TO_SECS</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">)</span><span·class="pp">········</span><span·class="op">(</span><span·class="fl">1.0</span><span·class="pp">·</span><span·class="op">/</span><span·class="pp">·</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">))</span></span></code></pre></div>
234 <p><a243 <p><a
235 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/timer.h#L37">Source244 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/timer.h#L37">Source
236 Code</a></p>245 Code</a></p>
237 <p>Convert·beats·per·second·to·seconds.</p>246 <p>Convert·beats·per·second·to·seconds.</p>
 247 <p>Examples:</p>
 248 <ul>
 249 <li><a
 250 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim.c#L719">ex_prim.c</a></li>
 251 </ul>
238 <h1·id="allegro_bpm_to_secs">ALLEGRO_BPM_TO_SECS</h1>252 <h1·id="allegro_bpm_to_secs">ALLEGRO_BPM_TO_SECS</h1>
239 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_BPM_TO_SECS</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">)</span><span·class="pp">········</span><span·class="op">(</span><span·class="fl">60.0</span><span·class="pp">·</span><span·class="op">/</span><span·class="pp">·</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">))</span></span></code></pre></div>253 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a><span·class="pp">#define·ALLEGRO_BPM_TO_SECS</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">)</span><span·class="pp">········</span><span·class="op">(</span><span·class="fl">60.0</span><span·class="pp">·</span><span·class="op">/</span><span·class="pp">·</span><span·class="op">(</span><span·class="pp">x</span><span·class="op">))</span></span></code></pre></div>
240 <p><a254 <p><a
241 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/timer.h#L41">Source255 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/timer.h#L41">Source
242 Code</a></p>256 Code</a></p>
243 <p>Convert·beats·per·minute·to·seconds.</p>257 <p>Convert·beats·per·minute·to·seconds.</p>
244 <h1·id="al_create_timer">al_create_timer</h1>258 <h1·id="al_create_timer">al_create_timer</h1>
Offset 253, 51 lines modifiedOffset 267, 85 lines modified
253 href="timer.html#al_start_timer">al_start_timer</a>·before·<a267 href="timer.html#al_start_timer">al_start_timer</a>·before·<a
254 href="events.html#allegro_event_timer">ALLEGRO_EVENT_TIMER</a>·events268 href="events.html#allegro_event_timer">ALLEGRO_EVENT_TIMER</a>·events
255 are·sent.</p>269 are·sent.</p>
256 <p>Usage·note:·typical·granularity·is·on·the·order·of·microseconds,·but270 <p>Usage·note:·typical·granularity·is·on·the·order·of·microseconds,·but
257 with·some·drivers·might·only·be·milliseconds.</p>271 with·some·drivers·might·only·be·milliseconds.</p>
258 <p>See·also:·<a·href="timer.html#al_start_timer">al_start_timer</a>,·<a272 <p>See·also:·<a·href="timer.html#al_start_timer">al_start_timer</a>,·<a
259 href="timer.html#al_destroy_timer">al_destroy_timer</a></p>273 href="timer.html#al_destroy_timer">al_destroy_timer</a></p>
 274 <p>Examples:</p>
 275 <ul>
 276 <li><a
 277 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L212">ex_enet_server.c</a></li>
 278 <li><a
 279 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L37">ex_timer_pause.c</a></li>
 280 <li><a
 281 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_user_events.c#L59">ex_user_events.c</a></li>
 282 </ul>
260 <h1·id="al_start_timer">al_start_timer</h1>283 <h1·id="al_start_timer">al_start_timer</h1>
261 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_start_timer<span·class="op">(</span>ALLEGRO_TIMER·<span·class="op">*</span>timer<span·class="op">)</span></span></code></pre></div>284 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_start_timer<span·class="op">(</span>ALLEGRO_TIMER·<span·class="op">*</span>timer<span·class="op">)</span></span></code></pre></div>
262 <p><a285 <p><a
263 href="https://github.com/liballeg/allegro5/blob/master/src/timernu.c#L318">Source286 href="https://github.com/liballeg/allegro5/blob/master/src/timernu.c#L318">Source
264 Code</a></p>287 Code</a></p>
265 <p>Start·the·timer·specified.·From·then,·the·timer’s·counter·will288 <p>Start·the·timer·specified.·From·then,·the·timer’s·counter·will
266 increment·at·a·constant·rate,·and·it·will·begin·generating·events.289 increment·at·a·constant·rate,·and·it·will·begin·generating·events.
267 Starting·a·timer·that·is·already·started·does·nothing.·Starting·a·timer290 Starting·a·timer·that·is·already·started·does·nothing.·Starting·a·timer
268 that·was·stopped·will·reset·the·timer’s·counter,·effectively·restarting291 that·was·stopped·will·reset·the·timer’s·counter,·effectively·restarting
269 the·timer·from·the·beginning.</p>292 the·timer·from·the·beginning.</p>
270 <p>See·also:·<a·href="timer.html#al_stop_timer">al_stop_timer</a>,·<a293 <p>See·also:·<a·href="timer.html#al_stop_timer">al_stop_timer</a>,·<a
271 href="timer.html#al_get_timer_started">al_get_timer_started</a>,·<a294 href="timer.html#al_get_timer_started">al_get_timer_started</a>,·<a
272 href="timer.html#al_resume_timer">al_resume_timer</a></p>295 href="timer.html#al_resume_timer">al_resume_timer</a></p>
 296 <p>Examples:</p>
 297 <ul>
 298 <li><a
 299 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_enet_server.c#L216">ex_enet_server.c</a></li>
 300 <li><a
 301 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L5">ex_timer_pause.c</a></li>
 302 <li><a
 303 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_user_events.c#L72">ex_user_events.c</a></li>
 304 </ul>
273 <h1·id="al_resume_timer">al_resume_timer</h1>305 <h1·id="al_resume_timer">al_resume_timer</h1>
274 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_resume_timer<span·class="op">(</span>ALLEGRO_TIMER·<span·class="op">*</span>timer<span·class="op">)</span></span></code></pre></div>306 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_resume_timer<span·class="op">(</span>ALLEGRO_TIMER·<span·class="op">*</span>timer<span·class="op">)</span></span></code></pre></div>
275 <p><a307 <p><a
276 href="https://github.com/liballeg/allegro5/blob/master/src/timernu.c#L327">Source308 href="https://github.com/liballeg/allegro5/blob/master/src/timernu.c#L327">Source
277 Code</a></p>309 Code</a></p>
278 <p>Resume·the·timer·specified.·From·then,·the·timer’s·counter·will310 <p>Resume·the·timer·specified.·From·then,·the·timer’s·counter·will
279 increment·at·a·constant·rate,·and·it·will·begin·generating·events.311 increment·at·a·constant·rate,·and·it·will·begin·generating·events.
280 Resuming·a·timer·that·is·already·started·does·nothing.·Resuming·a312 Resuming·a·timer·that·is·already·started·does·nothing.·Resuming·a
281 stopped·timer·will·not·reset·the·timer’s·counter·(unlike·<a313 stopped·timer·will·not·reset·the·timer’s·counter·(unlike·<a
282 href="timer.html#al_start_timer">al_start_timer</a>).</p>314 href="timer.html#al_start_timer">al_start_timer</a>).</p>
283 <p>See·also:·<a·href="timer.html#al_start_timer">al_start_timer</a>,·<a315 <p>See·also:·<a·href="timer.html#al_start_timer">al_start_timer</a>,·<a
284 href="timer.html#al_stop_timer">al_stop_timer</a>,·<a316 href="timer.html#al_stop_timer">al_stop_timer</a>,·<a
285 href="timer.html#al_get_timer_started">al_get_timer_started</a></p>317 href="timer.html#al_get_timer_started">al_get_timer_started</a></p>
 318 <p>Examples:</p>
 319 <ul>
 320 <li><a
 321 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L5">ex_timer_pause.c</a></li>
 322 <li><a
 323 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L350">ex_native_filechooser.c</a></li>
 324 </ul>
286 <h1·id="al_stop_timer">al_stop_timer</h1>325 <h1·id="al_stop_timer">al_stop_timer</h1>
287 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_stop_timer<span·class="op">(</span>ALLEGRO_TIMER·<span·class="op">*</span>timer<span·class="op">)</span></span></code></pre></div>326 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_stop_timer<span·class="op">(</span>ALLEGRO_TIMER·<span·class="op">*</span>timer<span·class="op">)</span></span></code></pre></div>
288 <p><a327 <p><a
289 href="https://github.com/liballeg/allegro5/blob/master/src/timernu.c#L336">Source328 href="https://github.com/liballeg/allegro5/blob/master/src/timernu.c#L336">Source
290 Code</a></p>329 Code</a></p>
291 <p>Stop·the·timer·specified.·The·timer’s·counter·will·stop·incrementing330 <p>Stop·the·timer·specified.·The·timer’s·counter·will·stop·incrementing
292 and·it·will·stop·generating·events.·Stopping·a·timer·that·is·already331 and·it·will·stop·generating·events.·Stopping·a·timer·that·is·already
293 stopped·does·nothing.</p>332 stopped·does·nothing.</p>
294 <p>See·also:·<a·href="timer.html#al_start_timer">al_start_timer</a>,·<a333 <p>See·also:·<a·href="timer.html#al_start_timer">al_start_timer</a>,·<a
295 href="timer.html#al_get_timer_started">al_get_timer_started</a>,·<a334 href="timer.html#al_get_timer_started">al_get_timer_started</a>,·<a
296 href="timer.html#al_resume_timer">al_resume_timer</a></p>335 href="timer.html#al_resume_timer">al_resume_timer</a></p>
 336 <p>Examples:</p>
 337 <ul>
 338 <li><a
 339 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_timer_pause.c#L48">ex_timer_pause.c</a></li>
 340 <li><a
 341 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_android.c#L196">ex_android.c</a></li>
 342 <li><a
 343 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_projection2.c#L153">ex_projection2.c</a></li>
 344 </ul>
297 <h1·id="al_get_timer_started">al_get_timer_started</h1>345 <h1·id="al_get_timer_started">al_get_timer_started</h1>
298 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_get_timer_started<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_TIMER·<span·class="op">*</span>timer<span·class="op">)</span></span></code></pre></div>346 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_get_timer_started<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_TIMER·<span·class="op">*</span>timer<span·class="op">)</span></span></code></pre></div>
299 <p><a347 <p><a
300 href="https://github.com/liballeg/allegro5/blob/master/src/timernu.c#L356">Source348 href="https://github.com/liballeg/allegro5/blob/master/src/timernu.c#L356">Source
301 Code</a></p>349 Code</a></p>
Max diff block lines reached; 5056/14163 bytes (35.70%) of diff not shown.
8.0 KB
html2text {}
    
Offset 62, 87 lines modifiedOffset 62, 116 lines modified
62 ····*·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e62 ····*·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e
63 These·functions·are·declared·in·the·main·Allegro·header·file:63 These·functions·are·declared·in·the·main·Allegro·header·file:
64 ·#include·<allegro5/allegro.h>64 ·#include·<allegro5/allegro.h>
65 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_T\x8TI\x8IM\x8ME\x8ER\x8R·*\x8**\x8**\x8**\x8**\x8**\x8*65 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_T\x8TI\x8IM\x8ME\x8ER\x8R·*\x8**\x8**\x8**\x8**\x8**\x8*
66 typedef·struct·ALLEGRO_TIMER·ALLEGRO_TIMER;66 typedef·struct·ALLEGRO_TIMER·ALLEGRO_TIMER;
67 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e67 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
68 This·is·an·abstract·data·type·representing·a·timer·object.68 This·is·an·abstract·data·type·representing·a·timer·object.
 69 Examples:
 70 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 71 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
 72 ····*·_\x8e_\x8x_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
69 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_U\x8US\x8SE\x8EC\x8CS\x8S_\x8_T\x8TO\x8O_\x8_S\x8SE\x8EC\x8CS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*73 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_U\x8US\x8SE\x8EC\x8CS\x8S_\x8_T\x8TO\x8O_\x8_S\x8SE\x8EC\x8CS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*
70 #define·ALLEGRO_USECS_TO_SECS(x)······((x)·/·1000000.0)74 #define·ALLEGRO_USECS_TO_SECS(x)······((x)·/·1000000.0)
71 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e75 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
72 Convert·microseconds·to·seconds.76 Convert·microseconds·to·seconds.
73 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_M\x8MS\x8SE\x8EC\x8CS\x8S_\x8_T\x8TO\x8O_\x8_S\x8SE\x8EC\x8CS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*77 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_M\x8MS\x8SE\x8EC\x8CS\x8S_\x8_T\x8TO\x8O_\x8_S\x8SE\x8EC\x8CS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*
74 #define·ALLEGRO_MSECS_TO_SECS(x)······((x)·/·1000.0)78 #define·ALLEGRO_MSECS_TO_SECS(x)······((x)·/·1000.0)
75 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e79 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
76 Convert·milliseconds·to·seconds.80 Convert·milliseconds·to·seconds.
77 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_B\x8BP\x8PS\x8S_\x8_T\x8TO\x8O_\x8_S\x8SE\x8EC\x8CS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*81 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_B\x8BP\x8PS\x8S_\x8_T\x8TO\x8O_\x8_S\x8SE\x8EC\x8CS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*
78 #define·ALLEGRO_BPS_TO_SECS(x)········(1.0·/·(x))82 #define·ALLEGRO_BPS_TO_SECS(x)········(1.0·/·(x))
79 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e83 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
80 Convert·beats·per·second·to·seconds.84 Convert·beats·per·second·to·seconds.
 85 Examples:
 86 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8._\x8c
81 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_B\x8BP\x8PM\x8M_\x8_T\x8TO\x8O_\x8_S\x8SE\x8EC\x8CS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*87 *\x8**\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_B\x8BP\x8PM\x8M_\x8_T\x8TO\x8O_\x8_S\x8SE\x8EC\x8CS\x8S·*\x8**\x8**\x8**\x8**\x8**\x8*
82 #define·ALLEGRO_BPM_TO_SECS(x)········(60.0·/·(x))88 #define·ALLEGRO_BPM_TO_SECS(x)········(60.0·/·(x))
83 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e89 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
84 Convert·beats·per·minute·to·seconds.90 Convert·beats·per·minute·to·seconds.
85 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*91 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cr\x8re\x8ea\x8at\x8te\x8e_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
86 ALLEGRO_TIMER·*al_create_timer(double·speed_secs)92 ALLEGRO_TIMER·*al_create_timer(double·speed_secs)
87 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e93 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
88 Allocates·and·initializes·a·timer.·If·successful,·a·pointer·to·a·new·timer94 Allocates·and·initializes·a·timer.·If·successful,·a·pointer·to·a·new·timer
89 object·is·returned,·otherwise·NULL·is·returned.·s\x8sp\x8pe\x8ee\x8ed\x8d_\x8_s\x8se\x8ec\x8cs\x8s·is·in·seconds·per95 object·is·returned,·otherwise·NULL·is·returned.·s\x8sp\x8pe\x8ee\x8ed\x8d_\x8_s\x8se\x8ec\x8cs\x8s·is·in·seconds·per
90 “tick”,·and·must·be·positive.·The·new·timer·is·initially·stopped·and·needs·to96 “tick”,·and·must·be·positive.·The·new·timer·is·initially·stopped·and·needs·to
91 be·started·with·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r·before·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8I_\x8M_\x8E_\x8R·events·are·sent.97 be·started·with·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r·before·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8I_\x8M_\x8E_\x8R·events·are·sent.
92 Usage·note:·typical·granularity·is·on·the·order·of·microseconds,·but·with·some98 Usage·note:·typical·granularity·is·on·the·order·of·microseconds,·but·with·some
93 drivers·might·only·be·milliseconds.99 drivers·might·only·be·milliseconds.
94 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8t_\x8i_\x8m_\x8e_\x8r100 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8d_\x8e_\x8s_\x8t_\x8r_\x8o_\x8y_\x8__\x8t_\x8i_\x8m_\x8e_\x8r
 101 Examples:
 102 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 103 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
 104 ····*·_\x8e_\x8x_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
95 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8ta\x8ar\x8rt\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*105 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8ta\x8ar\x8rt\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
96 void·al_start_timer(ALLEGRO_TIMER·*timer)106 void·al_start_timer(ALLEGRO_TIMER·*timer)
97 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e107 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
98 Start·the·timer·specified.·From·then,·the·timer’s·counter·will·increment·at·a108 Start·the·timer·specified.·From·then,·the·timer’s·counter·will·increment·at·a
99 constant·rate,·and·it·will·begin·generating·events.·Starting·a·timer·that·is109 constant·rate,·and·it·will·begin·generating·events.·Starting·a·timer·that·is
100 already·started·does·nothing.·Starting·a·timer·that·was·stopped·will·reset·the110 already·started·does·nothing.·Starting·a·timer·that·was·stopped·will·reset·the
101 timer’s·counter,·effectively·restarting·the·timer·from·the·beginning.111 timer’s·counter,·effectively·restarting·the·timer·from·the·beginning.
102 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8e_\x8d,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8u_\x8m_\x8e_\x8__\x8t_\x8i_\x8m_\x8e_\x8r112 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8e_\x8d,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8u_\x8m_\x8e_\x8__\x8t_\x8i_\x8m_\x8e_\x8r
 113 Examples:
 114 ····*·_\x8e_\x8x_\x8__\x8e_\x8n_\x8e_\x8t_\x8__\x8s_\x8e_\x8r_\x8v_\x8e_\x8r_\x8._\x8c
 115 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
 116 ····*·_\x8e_\x8x_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
103 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8su\x8um\x8me\x8e_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*117 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_r\x8re\x8es\x8su\x8um\x8me\x8e_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
104 void·al_resume_timer(ALLEGRO_TIMER·*timer)118 void·al_resume_timer(ALLEGRO_TIMER·*timer)
105 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e119 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
106 Resume·the·timer·specified.·From·then,·the·timer’s·counter·will·increment·at·a120 Resume·the·timer·specified.·From·then,·the·timer’s·counter·will·increment·at·a
107 constant·rate,·and·it·will·begin·generating·events.·Resuming·a·timer·that·is121 constant·rate,·and·it·will·begin·generating·events.·Resuming·a·timer·that·is
108 already·started·does·nothing.·Resuming·a·stopped·timer·will·not·reset·the122 already·started·does·nothing.·Resuming·a·stopped·timer·will·not·reset·the
109 timer’s·counter·(unlike·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r).123 timer’s·counter·(unlike·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r).
110 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8e_\x8d124 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8s_\x8t_\x8o_\x8p_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8e_\x8d
 125 Examples:
 126 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
 127 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
111 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8to\x8op\x8p_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*128 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8to\x8op\x8p_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
112 void·al_stop_timer(ALLEGRO_TIMER·*timer)129 void·al_stop_timer(ALLEGRO_TIMER·*timer)
113 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e130 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
114 Stop·the·timer·specified.·The·timer’s·counter·will·stop·incrementing·and·it131 Stop·the·timer·specified.·The·timer’s·counter·will·stop·incrementing·and·it
115 will·stop·generating·events.·Stopping·a·timer·that·is·already·stopped·does132 will·stop·generating·events.·Stopping·a·timer·that·is·already·stopped·does
116 nothing.133 nothing.
117 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8e_\x8d,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8u_\x8m_\x8e_\x8__\x8t_\x8i_\x8m_\x8e_\x8r134 See·also:·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8e_\x8d,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8s_\x8u_\x8m_\x8e_\x8__\x8t_\x8i_\x8m_\x8e_\x8r
 135 Examples:
 136 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
 137 ····*·_\x8e_\x8x_\x8__\x8a_\x8n_\x8d_\x8r_\x8o_\x8i_\x8d_\x8._\x8c
 138 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x82_\x8._\x8c
118 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_s\x8st\x8ta\x8ar\x8rt\x8te\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*139 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_s\x8st\x8ta\x8ar\x8rt\x8te\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
119 bool·al_get_timer_started(const·ALLEGRO_TIMER·*timer)140 bool·al_get_timer_started(const·ALLEGRO_TIMER·*timer)
120 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e141 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
121 Return·true·if·the·timer·specified·is·currently·started.142 Return·true·if·the·timer·specified·is·currently·started.
122 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*143 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8y_\x8_t\x8ti\x8im\x8me\x8er\x8r·*\x8**\x8**\x8**\x8**\x8**\x8*
123 void·al_destroy_timer(ALLEGRO_TIMER·*timer)144 void·al_destroy_timer(ALLEGRO_TIMER·*timer)
124 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e145 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
125 Uninstall·the·timer·specified.·If·the·timer·is·started,·it·will·automatically146 Uninstall·the·timer·specified.·If·the·timer·is·started,·it·will·automatically
126 be·stopped·before·uninstallation.·It·will·also·automatically·unregister·the147 be·stopped·before·uninstallation.·It·will·also·automatically·unregister·the
127 timer·with·any·event·queues.148 timer·with·any·event·queues.
128 Does·nothing·if·passed·the·NULL·pointer.149 Does·nothing·if·passed·the·NULL·pointer.
129 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8i_\x8m_\x8e_\x8r150 See·also:·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8i_\x8m_\x8e_\x8r
 151 Examples:
 152 ····*·_\x8e_\x8x_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8p_\x8a_\x8u_\x8s_\x8e_\x8._\x8c
 153 ····*·_\x8e_\x8x_\x8__\x8u_\x8s_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8s_\x8._\x8c
 154 ····*·_\x8e_\x8x_\x8__\x8n_\x8o_\x8f_\x8r_\x8a_\x8m_\x8e_\x8._\x8c
130 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_c\x8co\x8ou\x8un\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*155 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_c\x8co\x8ou\x8un\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
131 int64_t·al_get_timer_count(const·ALLEGRO_TIMER·*timer)156 int64_t·al_get_timer_count(const·ALLEGRO_TIMER·*timer)
132 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e157 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
133 Return·the·timer’s·counter·value.·The·timer·can·be·started·or·stopped.158 Return·the·timer’s·counter·value.·The·timer·can·be·started·or·stopped.
134 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8c_\x8o_\x8u_\x8n_\x8t159 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8c_\x8o_\x8u_\x8n_\x8t
 160 Examples:
 161 ····*·_\x8e_\x8x_\x8__\x8m_\x8e_\x8n_\x8u_\x8._\x8c
135 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_c\x8co\x8ou\x8un\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*162 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_c\x8co\x8ou\x8un\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
136 void·al_set_timer_count(ALLEGRO_TIMER·*timer,·int64_t·new_count)163 void·al_set_timer_count(ALLEGRO_TIMER·*timer,·int64_t·new_count)
137 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e164 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
138 Set·the·timer’s·counter·value.·The·timer·can·be·started·or·stopped.·The·count165 Set·the·timer’s·counter·value.·The·timer·can·be·started·or·stopped.·The·count
139 value·may·be·positive·or·negative,·but·will·always·be·incremented·by·+1·at·each166 value·may·be·positive·or·negative,·but·will·always·be·incremented·by·+1·at·each
140 tick.167 tick.
141 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8c_\x8o_\x8u_\x8n_\x8t,·_\x8a_\x8l_\x8__\x8a_\x8d_\x8d_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8c_\x8o_\x8u_\x8n_\x8t168 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8c_\x8o_\x8u_\x8n_\x8t,·_\x8a_\x8l_\x8__\x8a_\x8d_\x8d_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8c_\x8o_\x8u_\x8n_\x8t
 169 Examples:
 170 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8._\x8c
142 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_a\x8ad\x8dd\x8d_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_c\x8co\x8ou\x8un\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*171 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_a\x8ad\x8dd\x8d_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_c\x8co\x8ou\x8un\x8nt\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
143 void·al_add_timer_count(ALLEGRO_TIMER·*timer,·int64_t·diff)172 void·al_add_timer_count(ALLEGRO_TIMER·*timer,·int64_t·diff)
144 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e173 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
145 Add·d\x8di\x8if\x8ff\x8f·to·the·timer’s·counter·value.·This·is·similar·to·writing:174 Add·d\x8di\x8if\x8ff\x8f·to·the·timer’s·counter·value.·This·is·similar·to·writing:
146 al_set_timer_count(timer,·al_get_timer_count(timer)·+·diff);175 al_set_timer_count(timer,·al_get_timer_count(timer)·+·diff);
147 except·that·the·addition·is·performed·atomically,·so·no·ticks·will·be·lost.176 except·that·the·addition·is·performed·atomically,·so·no·ticks·will·be·lost.
148 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8c_\x8o_\x8u_\x8n_\x8t177 See·also:·_\x8a_\x8l_\x8__\x8s_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8c_\x8o_\x8u_\x8n_\x8t
Offset 157, 12 lines modifiedOffset 186, 19 lines modified
157 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e186 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
158 Set·the·timer’s·speed,·i.e. the·rate·at·which·its·counter·will·be·incremented187 Set·the·timer’s·speed,·i.e. the·rate·at·which·its·counter·will·be·incremented
159 when·it·is·started.·This·can·be·done·when·the·timer·is·started·or·stopped.·If188 when·it·is·started.·This·can·be·done·when·the·timer·is·started·or·stopped.·If
160 the·timer·is·currently·running,·it·is·made·to·look·as·though·the·speed·change189 the·timer·is·currently·running,·it·is·made·to·look·as·though·the·speed·change
161 occurred·precisely·at·the·last·tick.190 occurred·precisely·at·the·last·tick.
162 s\x8sp\x8pe\x8ee\x8ed\x8d_\x8_s\x8se\x8ec\x8cs\x8s·has·exactly·the·same·meaning·as·with·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8i_\x8m_\x8e_\x8r.191 s\x8sp\x8pe\x8ee\x8ed\x8d_\x8_s\x8se\x8ec\x8cs\x8s·has·exactly·the·same·meaning·as·with·_\x8a_\x8l_\x8__\x8c_\x8r_\x8e_\x8a_\x8t_\x8e_\x8__\x8t_\x8i_\x8m_\x8e_\x8r.
163 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8s_\x8p_\x8e_\x8e_\x8d192 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8__\x8s_\x8p_\x8e_\x8e_\x8d
 193 Examples:
 194 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8._\x8c
164 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*195 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8ti\x8im\x8me\x8er\x8r_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
Max diff block lines reached; 413/8170 bytes (5.06%) of diff not shown.
10.6 KB
./usr/share/doc/allegro5-doc/refman/touch.html
    
Offset 294, 14 lines modifiedOffset 294, 23 lines modified
294 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L43">Source294 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L43">Source
295 Code</a></p>295 Code</a></p>
296 <p>Install·a·touch·input·driver,·returning·true·if·successful.·If·a296 <p>Install·a·touch·input·driver,·returning·true·if·successful.·If·a
297 touch·input·driver·was·already·installed,·returns·true·immediately.</p>297 touch·input·driver·was·already·installed,·returns·true·immediately.</p>
298 <p>Since:·5.1.0</p>298 <p>Since:·5.1.0</p>
299 <p>See·also:·<a299 <p>See·also:·<a
300 href="touch.html#al_uninstall_touch_input">al_uninstall_touch_input</a></p>300 href="touch.html#al_uninstall_touch_input">al_uninstall_touch_input</a></p>
 301 <p>Examples:</p>
 302 <ul>
 303 <li><a
 304 href="https://github.com/liballeg/allegro5/blob/master/examples/common.c#L18">common.c</a></li>
 305 <li><a
 306 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_touch_input.c#L56">ex_touch_input.c</a></li>
 307 <li><a
 308 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_lockbitmap.c#L165">ex_lockbitmap.c</a></li>
 309 </ul>
301 <h1·id="al_uninstall_touch_input">al_uninstall_touch_input</h1>310 <h1·id="al_uninstall_touch_input">al_uninstall_touch_input</h1>
302 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_uninstall_touch_input<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>311 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_uninstall_touch_input<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
303 <p><a312 <p><a
304 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L68">Source313 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L68">Source
305 Code</a></p>314 Code</a></p>
306 <p>Uninstalls·the·active·touch·input·driver.·If·no·touch·input·driver315 <p>Uninstalls·the·active·touch·input·driver.·If·no·touch·input·driver
307 was·active,·this·function·does·nothing.</p>316 was·active,·this·function·does·nothing.</p>
Offset 314, 14 lines modifiedOffset 323, 23 lines modified
314 <p><a323 <p><a
315 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L35">Source324 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L35">Source
316 Code</a></p>325 Code</a></p>
317 <p>Returns·true·if·<a326 <p>Returns·true·if·<a
318 href="touch.html#al_install_touch_input">al_install_touch_input</a>·was327 href="touch.html#al_install_touch_input">al_install_touch_input</a>·was
319 called·successfully.</p>328 called·successfully.</p>
320 <p>Since:·5.1.0</p>329 <p>Since:·5.1.0</p>
 330 <p>Examples:</p>
 331 <ul>
 332 <li><a
 333 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_lockbitmap.c#L178">ex_lockbitmap.c</a></li>
 334 <li><a
 335 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haiku.c#L973">ex_haiku.c</a></li>
 336 <li><a
 337 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim_shader.c#L154">ex_prim_shader.c</a></li>
 338 </ul>
321 <h1·id="al_get_touch_input_state">al_get_touch_input_state</h1>339 <h1·id="al_get_touch_input_state">al_get_touch_input_state</h1>
322 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_get_touch_input_state<span·class="op">(</span>ALLEGRO_TOUCH_INPUT_STATE·<span·class="op">*</span>ret_state<span·class="op">)</span></span></code></pre></div>340 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_get_touch_input_state<span·class="op">(</span>ALLEGRO_TOUCH_INPUT_STATE·<span·class="op">*</span>ret_state<span·class="op">)</span></span></code></pre></div>
323 <p><a341 <p><a
324 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L93">Source342 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L93">Source
325 Code</a></p>343 Code</a></p>
326 <p>Gets·the·current·touch·input·state.·The·touch·information·is·copied344 <p>Gets·the·current·touch·input·state.·The·touch·information·is·copied
327 into·the·<a345 into·the·<a
Offset 341, 14 lines modifiedOffset 359, 19 lines modified
341 API</a>:</em>·Seems·of·limited·value,·as·touch·input·tends·to·have359 API</a>:</em>·Seems·of·limited·value,·as·touch·input·tends·to·have
342 different·semantics·compared·to·mouse·input.</p>360 different·semantics·compared·to·mouse·input.</p>
343 </blockquote>361 </blockquote>
344 <p>See·also:·<a362 <p>See·also:·<a
345 href="touch.html#allegro_mouse_emulation_mode">ALLEGRO_MOUSE_EMULATION_MODE</a>,363 href="touch.html#allegro_mouse_emulation_mode">ALLEGRO_MOUSE_EMULATION_MODE</a>,
346 <a364 <a
347 href="touch.html#al_get_mouse_emulation_mode">al_get_mouse_emulation_mode</a>.</p>365 href="touch.html#al_get_mouse_emulation_mode">al_get_mouse_emulation_mode</a>.</p>
 366 <p>Examples:</p>
 367 <ul>
 368 <li><a
 369 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_native_filechooser.c#L205">ex_native_filechooser.c</a></li>
 370 </ul>
348 <h1·id="al_get_mouse_emulation_mode">al_get_mouse_emulation_mode</h1>371 <h1·id="al_get_mouse_emulation_mode">al_get_mouse_emulation_mode</h1>
349 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_mouse_emulation_mode<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>372 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">int</span>·al_get_mouse_emulation_mode<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
350 <p><a373 <p><a
351 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L117">Source374 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L117">Source
352 Code</a></p>375 Code</a></p>
353 <p>Returns·the·kind·of·mouse·emulation·which·the·touch·input·subsystem376 <p>Returns·the·kind·of·mouse·emulation·which·the·touch·input·subsystem
354 is·set·to·perform.</p>377 is·set·to·perform.</p>
Offset 371, 14 lines modifiedOffset 394, 23 lines modified
371 <p>Returns·the·global·touch·input·event·source.·This·event·source394 <p>Returns·the·global·touch·input·event·source.·This·event·source
372 generates·<a·href="events.html#allegro_event_touch_begin">touch·input395 generates·<a·href="events.html#allegro_event_touch_begin">touch·input
373 events</a>.</p>396 events</a>.</p>
374 <p>Since:·5.1.0</p>397 <p>Since:·5.1.0</p>
375 <p>See·also:·<a398 <p>See·also:·<a
376 href="events.html#allegro_event_source">ALLEGRO_EVENT_SOURCE</a>,·<a399 href="events.html#allegro_event_source">ALLEGRO_EVENT_SOURCE</a>,·<a
377 href="events.html#al_register_event_source">al_register_event_source</a></p>400 href="events.html#al_register_event_source">al_register_event_source</a></p>
 401 <p>Examples:</p>
 402 <ul>
 403 <li><a
 404 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_touch_input.c#L66">ex_touch_input.c</a></li>
 405 <li><a
 406 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_android.c#L129">ex_android.c</a></li>
 407 <li><a
 408 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_polygon.c#L387">ex_polygon.c</a></li>
 409 </ul>
378 <h1410 <h1
379 id="al_get_touch_input_mouse_emulation_event_source">al_get_touch_input_mouse_emulation_event_source</h1>411 id="al_get_touch_input_mouse_emulation_event_source">al_get_touch_input_mouse_emulation_event_source</h1>
380 <div·class="sourceCode"·id="cb14"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb14-1"><a·href="#cb14-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_EVENT_SOURCE·<span·class="op">*</span>al_get_touch_input_mouse_emulation_event_source<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>412 <div·class="sourceCode"·id="cb14"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb14-1"><a·href="#cb14-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_EVENT_SOURCE·<span·class="op">*</span>al_get_touch_input_mouse_emulation_event_source<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
381 <p><a413 <p><a
382 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L140">Source414 href="https://github.com/liballeg/allegro5/blob/master/src/touch_input.c#L140">Source
383 Code</a></p>415 Code</a></p>
384 <p>Returns·the·global·touch·input·event·source·for·emulated·mouse416 <p>Returns·the·global·touch·input·event·source·for·emulated·mouse
Offset 390, 11 lines modifiedOffset 422, 23 lines modified
390 href="events.html#al_register_event_source">al_register_event_source</a></p>422 href="events.html#al_register_event_source">al_register_event_source</a></p>
391 <p>Since:·5.1.0</p>423 <p>Since:·5.1.0</p>
392 <blockquote>424 <blockquote>
393 <p><em><a·href="getting_started.html#unstable-api">Unstable425 <p><em><a·href="getting_started.html#unstable-api">Unstable
394 API</a>:</em>·Seems·of·limited·value,·as·touch·input·tends·to·have426 API</a>:</em>·Seems·of·limited·value,·as·touch·input·tends·to·have
395 different·semantics·compared·to·mouse·input.</p>427 different·semantics·compared·to·mouse·input.</p>
396 </blockquote>428 </blockquote>
 429 <p>Examples:</p>
 430 <ul>
 431 <li><a
 432 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_lockbitmap.c#L180">ex_lockbitmap.c</a></li>
 433 <li><a
 434 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_haiku.c#L975">ex_haiku.c</a></li>
 435 <li><a
 436 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_prim_shader.c#L156">ex_prim_shader.c</a></li>
 437 </ul>
 438 <p·class="timestamp">
 439 Allegro·version·5.2.10
 440 ·-·Last·updated:·2025-01-09·13:52:42·UTC
 441 </p>
397 </div>442 </div>
398 </body>443 </body>
399 </html>444 </html>
4.72 KB
html2text {}
    
Offset 110, 41 lines modifiedOffset 110, 51 lines modified
110 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*110 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
111 bool·al_install_touch_input(void)111 bool·al_install_touch_input(void)
112 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e112 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
113 Install·a·touch·input·driver,·returning·true·if·successful.·If·a·touch·input113 Install·a·touch·input·driver,·returning·true·if·successful.·If·a·touch·input
114 driver·was·already·installed,·returns·true·immediately.114 driver·was·already·installed,·returns·true·immediately.
115 Since:·5.1.0115 Since:·5.1.0
116 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t116 See·also:·_\x8a_\x8l_\x8__\x8u_\x8n_\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t
 117 Examples:
 118 ····*·_\x8c_\x8o_\x8m_\x8m_\x8o_\x8n_\x8._\x8c
 119 ····*·_\x8e_\x8x_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t_\x8._\x8c
 120 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8c_\x8k_\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8._\x8c
117 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*121 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8un\x8ni\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8l_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
118 void·al_uninstall_touch_input(void)122 void·al_uninstall_touch_input(void)
119 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e123 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
120 Uninstalls·the·active·touch·input·driver.·If·no·touch·input·driver·was·active,124 Uninstalls·the·active·touch·input·driver.·If·no·touch·input·driver·was·active,
121 this·function·does·nothing.125 this·function·does·nothing.
122 This·function·is·automatically·called·when·Allegro·is·shut·down.126 This·function·is·automatically·called·when·Allegro·is·shut·down.
123 Since:·5.1.0127 Since:·5.1.0
124 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t128 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t
125 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*129 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t_\x8_i\x8in\x8ns\x8st\x8ta\x8al\x8ll\x8le\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
126 bool·al_is_touch_input_installed(void)130 bool·al_is_touch_input_installed(void)
127 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e131 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
128 Returns·true·if·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t·was·called·successfully.132 Returns·true·if·_\x8a_\x8l_\x8__\x8i_\x8n_\x8s_\x8t_\x8a_\x8l_\x8l_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t·was·called·successfully.
129 Since:·5.1.0133 Since:·5.1.0
 134 Examples:
 135 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8c_\x8k_\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8._\x8c
 136 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8i_\x8k_\x8u_\x8._\x8c
 137 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
130 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*138 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t_\x8_s\x8st\x8ta\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
131 void·al_get_touch_input_state(ALLEGRO_TOUCH_INPUT_STATE·*ret_state)139 void·al_get_touch_input_state(ALLEGRO_TOUCH_INPUT_STATE·*ret_state)
132 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e140 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
133 Gets·the·current·touch·input·state.·The·touch·information·is·copied·into·the141 Gets·the·current·touch·input·state.·The·touch·information·is·copied·into·the
134 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8T_\x8O_\x8U_\x8C_\x8H_\x8__\x8I_\x8N_\x8P_\x8U_\x8T_\x8__\x8S_\x8T_\x8A_\x8T_\x8E·you·provide·to·this·function.142 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8T_\x8O_\x8U_\x8C_\x8H_\x8__\x8I_\x8N_\x8P_\x8U_\x8T_\x8__\x8S_\x8T_\x8A_\x8T_\x8E·you·provide·to·this·function.
135 Since:·5.1.0143 Since:·5.1.0
136 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_e\x8em\x8mu\x8ul\x8la\x8at\x8ti\x8io\x8on\x8n_\x8_m\x8mo\x8od\x8de\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*144 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_e\x8em\x8mu\x8ul\x8la\x8at\x8ti\x8io\x8on\x8n_\x8_m\x8mo\x8od\x8de\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
137 void·al_set_mouse_emulation_mode(int·mode)145 void·al_set_mouse_emulation_mode(int·mode)
138 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e146 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
139 Sets·the·kind·of·mouse·emulation·for·the·touch·input·subsystem·to·perform.147 Sets·the·kind·of·mouse·emulation·for·the·touch·input·subsystem·to·perform.
140 Since:·5.1.0148 Since:·5.1.0
141 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Seems·of·limited·value,·as·touch·input·tends·to·have149 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Seems·of·limited·value,·as·touch·input·tends·to·have
142 ·····different·semantics·compared·to·mouse·input.150 ·····different·semantics·compared·to·mouse·input.
143 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8E_\x8M_\x8U_\x8L_\x8A_\x8T_\x8I_\x8O_\x8N_\x8__\x8M_\x8O_\x8D_\x8E,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8e_\x8m_\x8u_\x8l_\x8a_\x8t_\x8i_\x8o_\x8n_\x8__\x8m_\x8o_\x8d_\x8e.151 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8M_\x8O_\x8U_\x8S_\x8E_\x8__\x8E_\x8M_\x8U_\x8L_\x8A_\x8T_\x8I_\x8O_\x8N_\x8__\x8M_\x8O_\x8D_\x8E,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8m_\x8o_\x8u_\x8s_\x8e_\x8__\x8e_\x8m_\x8u_\x8l_\x8a_\x8t_\x8i_\x8o_\x8n_\x8__\x8m_\x8o_\x8d_\x8e.
 152 Examples:
 153 ····*·_\x8e_\x8x_\x8__\x8n_\x8a_\x8t_\x8i_\x8v_\x8e_\x8__\x8f_\x8i_\x8l_\x8e_\x8c_\x8h_\x8o_\x8o_\x8s_\x8e_\x8r_\x8._\x8c
144 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_e\x8em\x8mu\x8ul\x8la\x8at\x8ti\x8io\x8on\x8n_\x8_m\x8mo\x8od\x8de\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*154 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_e\x8em\x8mu\x8ul\x8la\x8at\x8ti\x8io\x8on\x8n_\x8_m\x8mo\x8od\x8de\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
145 int·al_get_mouse_emulation_mode(void)155 int·al_get_mouse_emulation_mode(void)
146 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e156 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
147 Returns·the·kind·of·mouse·emulation·which·the·touch·input·subsystem·is·set·to157 Returns·the·kind·of·mouse·emulation·which·the·touch·input·subsystem·is·set·to
148 perform.158 perform.
149 Since:·5.1.0159 Since:·5.1.0
150 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Seems·of·limited·value,·as·touch·input·tends·to·have160 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Seems·of·limited·value,·as·touch·input·tends·to·have
Offset 153, 16 lines modifiedOffset 163, 25 lines modified
153 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*163 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
154 ALLEGRO_EVENT_SOURCE·*al_get_touch_input_event_source(void)164 ALLEGRO_EVENT_SOURCE·*al_get_touch_input_event_source(void)
155 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e165 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
156 Returns·the·global·touch·input·event·source.·This·event·source·generates·_\x8t_\x8o_\x8u_\x8c_\x8h166 Returns·the·global·touch·input·event·source.·This·event·source·generates·_\x8t_\x8o_\x8u_\x8c_\x8h
157 _\x8i_\x8n_\x8p_\x8u_\x8t_\x8·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s.167 _\x8i_\x8n_\x8p_\x8u_\x8t_\x8·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s.
158 Since:·5.1.0168 Since:·5.1.0
159 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8S_\x8O_\x8U_\x8R_\x8C_\x8E,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e169 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8S_\x8O_\x8U_\x8R_\x8C_\x8E,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e
 170 Examples:
 171 ····*·_\x8e_\x8x_\x8__\x8t_\x8o_\x8u_\x8c_\x8h_\x8__\x8i_\x8n_\x8p_\x8u_\x8t_\x8._\x8c
 172 ····*·_\x8e_\x8x_\x8__\x8a_\x8n_\x8d_\x8r_\x8o_\x8i_\x8d_\x8._\x8c
 173 ····*·_\x8e_\x8x_\x8__\x8p_\x8o_\x8l_\x8y_\x8g_\x8o_\x8n_\x8._\x8c
160 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_e\x8em\x8mu\x8ul\x8la\x8at\x8ti\x8io\x8on\x8n_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*174 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_t\x8to\x8ou\x8uc\x8ch\x8h_\x8_i\x8in\x8np\x8pu\x8ut\x8t_\x8_m\x8mo\x8ou\x8us\x8se\x8e_\x8_e\x8em\x8mu\x8ul\x8la\x8at\x8ti\x8io\x8on\x8n_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
161 ALLEGRO_EVENT_SOURCE·*al_get_touch_input_mouse_emulation_event_source(void)175 ALLEGRO_EVENT_SOURCE·*al_get_touch_input_mouse_emulation_event_source(void)
162 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e176 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
163 Returns·the·global·touch·input·event·source·for·emulated·mouse·events.·This177 Returns·the·global·touch·input·event·source·for·emulated·mouse·events.·This
164 event·source·generates·_\x8e_\x8m_\x8u_\x8l_\x8a_\x8t_\x8e_\x8d_\x8·_\x8m_\x8o_\x8u_\x8s_\x8e_\x8·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s·that·are·based·on·touch·events.178 event·source·generates·_\x8e_\x8m_\x8u_\x8l_\x8a_\x8t_\x8e_\x8d_\x8·_\x8m_\x8o_\x8u_\x8s_\x8e_\x8·_\x8e_\x8v_\x8e_\x8n_\x8t_\x8s·that·are·based·on·touch·events.
165 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8S_\x8O_\x8U_\x8R_\x8C_\x8E,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e179 See·also:·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8S_\x8O_\x8U_\x8R_\x8C_\x8E,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8g_\x8i_\x8s_\x8t_\x8e_\x8r_\x8__\x8e_\x8v_\x8e_\x8n_\x8t_\x8__\x8s_\x8o_\x8u_\x8r_\x8c_\x8e
166 Since:·5.1.0180 Since:·5.1.0
167 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Seems·of·limited·value,·as·touch·input·tends·to·have181 ·····_\x8U\x8U_\x8n\x8n_\x8s\x8s_\x8t\x8t_\x8a\x8a_\x8b\x8b_\x8l\x8l_\x8e\x8e_\x8·_\x8A\x8A_\x8P\x8P_\x8I\x8I:\x8:·Seems·of·limited·value,·as·touch·input·tends·to·have
168 ·····different·semantics·compared·to·mouse·input.182 ·····different·semantics·compared·to·mouse·input.
 183 Examples:
 184 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8c_\x8k_\x8b_\x8i_\x8t_\x8m_\x8a_\x8p_\x8._\x8c
 185 ····*·_\x8e_\x8x_\x8__\x8h_\x8a_\x8i_\x8k_\x8u_\x8._\x8c
 186 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c
 187 Allegro·version·5.2.10·-·Last·updated:·2025-01-09·13:52:42·UTC
42.2 KB
./usr/share/doc/allegro5-doc/refman/transformations.html
    
Offset 312, 25 lines modifiedOffset 312, 39 lines modified
312 <p>Defines·the·generic·transformation·type,·a·4x4·matrix.·2D·transforms312 <p>Defines·the·generic·transformation·type,·a·4x4·matrix.·2D·transforms
313 use·only·a·small·subsection·of·this·matrix,·namely·the·top·left·2x2313 use·only·a·small·subsection·of·this·matrix,·namely·the·top·left·2x2
314 matrix,·and·the·right·most·2x1·matrix,·for·a·total·of·6·values.</p>314 matrix,·and·the·right·most·2x1·matrix,·for·a·total·of·6·values.</p>
315 <p><em>Fields:</em></p>315 <p><em>Fields:</em></p>
316 <ul>316 <ul>
317 <li>m·-·A·4x4·float·matrix</li>317 <li>m·-·A·4x4·float·matrix</li>
318 </ul>318 </ul>
 319 <p>Examples:</p>
 320 <ul>
 321 <li><a
 322 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L137">ex_shader.cpp</a></li>
 323 <li><a
 324 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_target.c#L61">ex_shader_target.c</a></li>
 325 <li><a
 326 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_timer.c#L74">ex_audio_timer.c</a></li>
 327 </ul>
319 <h1·id="al_copy_transform">al_copy_transform</h1>328 <h1·id="al_copy_transform">al_copy_transform</h1>
320 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_copy_transform<span·class="op">(</span>ALLEGRO_TRANSFORM·<span·class="op">*</span>dest<span·class="op">,</span>·<span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>src<span·class="op">)</span></span></code></pre></div>329 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_copy_transform<span·class="op">(</span>ALLEGRO_TRANSFORM·<span·class="op">*</span>dest<span·class="op">,</span>·<span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>src<span·class="op">)</span></span></code></pre></div>
321 <p><a330 <p><a
322 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L30">Source331 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L30">Source
323 Code</a></p>332 Code</a></p>
324 <p>Makes·a·copy·of·a·transformation.</p>333 <p>Makes·a·copy·of·a·transformation.</p>
325 <p><em>Parameters:</em></p>334 <p><em>Parameters:</em></p>
326 <ul>335 <ul>
327 <li>dest·-·Source·transformation</li>336 <li>dest·-·Source·transformation</li>
328 <li>src·-·Destination·transformation</li>337 <li>src·-·Destination·transformation</li>
329 </ul>338 </ul>
 339 <p>Examples:</p>
 340 <ul>
 341 <li><a
 342 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L138">ex_shader.cpp</a></li>
 343 </ul>
330 <h1·id="al_use_transform">al_use_transform</h1>344 <h1·id="al_use_transform">al_use_transform</h1>
331 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_use_transform<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>trans<span·class="op">)</span></span></code></pre></div>345 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_use_transform<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>trans<span·class="op">)</span></span></code></pre></div>
332 <p><a346 <p><a
333 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L40">Source347 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L40">Source
334 Code</a></p>348 Code</a></p>
335 <p>Sets·the·transformation·to·be·used·for·the·the·drawing·operations·on349 <p>Sets·the·transformation·to·be·used·for·the·the·drawing·operations·on
336 the·target·bitmap·(each·bitmap·maintains·its·own·transformation).·Every350 the·target·bitmap·(each·bitmap·maintains·its·own·transformation).·Every
Offset 351, 25 lines modifiedOffset 365, 41 lines modified
351 <ul>365 <ul>
352 <li>trans·-·Transformation·to·use</li>366 <li>trans·-·Transformation·to·use</li>
353 </ul>367 </ul>
354 <p>See·also:·<a368 <p>See·also:·<a
355 href="transformations.html#al_get_current_transform">al_get_current_transform</a>,369 href="transformations.html#al_get_current_transform">al_get_current_transform</a>,
356 <a370 <a
357 href="transformations.html#al_transform_coordinates">al_transform_coordinates</a></p>371 href="transformations.html#al_transform_coordinates">al_transform_coordinates</a></p>
 372 <p>Examples:</p>
 373 <ul>
 374 <li><a
 375 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L142">ex_shader.cpp</a></li>
 376 <li><a
 377 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader_target.c#L120">ex_shader_target.c</a></li>
 378 <li><a
 379 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_audio_timer.c#L124">ex_audio_timer.c</a></li>
 380 </ul>
358 <h1·id="al_get_current_transform">al_get_current_transform</h1>381 <h1·id="al_get_current_transform">al_get_current_transform</h1>
359 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>al_get_current_transform<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>382 <div·class="sourceCode"·id="cb10"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb10-1"><a·href="#cb10-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>al_get_current_transform<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
360 <p><a383 <p><a
361 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L104">Source384 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L104">Source
362 Code</a></p>385 Code</a></p>
363 <p>Returns·the·transformation·of·the·current·target·bitmap,·as·set·by·<a386 <p>Returns·the·transformation·of·the·current·target·bitmap,·as·set·by·<a
364 href="transformations.html#al_use_transform">al_use_transform</a>.·If387 href="transformations.html#al_use_transform">al_use_transform</a>.·If
365 there·is·no·target·bitmap,·this·function·returns·NULL.</p>388 there·is·no·target·bitmap,·this·function·returns·NULL.</p>
366 <p><em>Returns:</em>·A·pointer·to·the·current·transformation.</p>389 <p><em>Returns:</em>·A·pointer·to·the·current·transformation.</p>
367 <p>See·also:·<a390 <p>See·also:·<a
368 href="transformations.html#al_get_current_projection_transform">al_get_current_projection_transform</a></p>391 href="transformations.html#al_get_current_projection_transform">al_get_current_projection_transform</a></p>
 392 <p>Examples:</p>
 393 <ul>
 394 <li><a
 395 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_shader.cpp#L138">ex_shader.cpp</a></li>
 396 <li><a
 397 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_color_gradient.c#L63">ex_color_gradient.c</a></li>
 398 </ul>
369 <h1·id="al_use_projection_transform">al_use_projection_transform</h1>399 <h1·id="al_use_projection_transform">al_use_projection_transform</h1>
370 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_use_projection_transform<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>trans<span·class="op">)</span></span></code></pre></div>400 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_use_projection_transform<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>trans<span·class="op">)</span></span></code></pre></div>
371 <p><a401 <p><a
372 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L74">Source402 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L74">Source
373 Code</a></p>403 Code</a></p>
374 <p>Sets·the·projection·transformation·to·be·used·for·the·drawing404 <p>Sets·the·projection·transformation·to·be·used·for·the·drawing
375 operations·on·the·target·bitmap·(each·bitmap·maintains·its·own405 operations·on·the·target·bitmap·(each·bitmap·maintains·its·own
Offset 401, 25 lines modifiedOffset 431, 39 lines modified
401 <p>Since:·5.1.9</p>431 <p>Since:·5.1.9</p>
402 <p>See·also:·<a432 <p>See·also:·<a
403 href="transformations.html#al_get_current_projection_transform">al_get_current_projection_transform</a>,433 href="transformations.html#al_get_current_projection_transform">al_get_current_projection_transform</a>,
404 <a434 <a
405 href="transformations.html#al_perspective_transform">al_perspective_transform</a>,435 href="transformations.html#al_perspective_transform">al_perspective_transform</a>,
406 <a436 <a
407 href="transformations.html#al_orthographic_transform">al_orthographic_transform</a></p>437 href="transformations.html#al_orthographic_transform">al_orthographic_transform</a></p>
 438 <p>Examples:</p>
 439 <ul>
 440 <li><a
 441 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_projection.c#L79">ex_projection.c</a></li>
 442 <li><a
 443 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_depth_target.c#L40">ex_depth_target.c</a></li>
 444 <li><a
 445 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_projection2.c#L43">ex_projection2.c</a></li>
 446 </ul>
408 <h1447 <h1
409 id="al_get_current_projection_transform">al_get_current_projection_transform</h1>448 id="al_get_current_projection_transform">al_get_current_projection_transform</h1>
410 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>al_get_current_projection_transform<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>449 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>al_get_current_projection_transform<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
411 <p><a450 <p><a
412 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L116">Source451 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L116">Source
413 Code</a></p>452 Code</a></p>
414 <p>If·there·is·no·target·bitmap,·this·function·returns·NULL.</p>453 <p>If·there·is·no·target·bitmap,·this·function·returns·NULL.</p>
415 <p><em>Returns:</em>·A·pointer·to·the·current·transformation.</p>454 <p><em>Returns:</em>·A·pointer·to·the·current·transformation.</p>
416 <p>Since:·5.1.9</p>455 <p>Since:·5.1.9</p>
417 <p>See·also:·<a456 <p>See·also:·<a
418 href="transformations.html#al_use_projection_transform">al_use_projection_transform</a></p>457 href="transformations.html#al_use_projection_transform">al_use_projection_transform</a></p>
 458 <p>Examples:</p>
 459 <ul>
 460 <li><a
 461 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_camera.c#L325">ex_camera.c</a></li>
 462 </ul>
419 <h1463 <h1
420 id="al_get_current_inverse_transform">al_get_current_inverse_transform</h1>464 id="al_get_current_inverse_transform">al_get_current_inverse_transform</h1>
421 <div·class="sourceCode"·id="cb14"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb14-1"><a·href="#cb14-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>al_get_current_inverse_transform<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>465 <div·class="sourceCode"·id="cb14"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb14-1"><a·href="#cb14-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·ALLEGRO_TRANSFORM·<span·class="op">*</span>al_get_current_inverse_transform<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
422 <p><a466 <p><a
423 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L128">Source467 href="https://github.com/liballeg/allegro5/blob/master/src/transformations.c#L128">Source
424 Code</a></p>468 Code</a></p>
425 <p>Returns·the·inverse·of·the·current·transformation·of·the·target469 <p>Returns·the·inverse·of·the·current·transformation·of·the·target
Offset 520, 14 lines modifiedOffset 564, 23 lines modified
520 </ul>564 </ul>
521 <p>See·also:·<a565 <p>See·also:·<a
522 href="transformations.html#al_translate_transform">al_translate_transform</a>,566 href="transformations.html#al_translate_transform">al_translate_transform</a>,
523 <a567 <a
524 href="transformations.html#al_rotate_transform">al_rotate_transform</a>,568 href="transformations.html#al_rotate_transform">al_rotate_transform</a>,
Max diff block lines reached; 19538/26925 bytes (72.56%) of diff not shown.
15.8 KB
html2text {}
    
Offset 136, 21 lines modifiedOffset 136, 27 lines modified
136 typedef·struct·ALLEGRO_TRANSFORM·ALLEGRO_TRANSFORM;136 typedef·struct·ALLEGRO_TRANSFORM·ALLEGRO_TRANSFORM;
137 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e137 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
138 Defines·the·generic·transformation·type,·a·4x4·matrix.·2D·transforms·use·only·a138 Defines·the·generic·transformation·type,·a·4x4·matrix.·2D·transforms·use·only·a
139 small·subsection·of·this·matrix,·namely·the·top·left·2x2·matrix,·and·the·right139 small·subsection·of·this·matrix,·namely·the·top·left·2x2·matrix,·and·the·right
140 most·2x1·matrix,·for·a·total·of·6·values.140 most·2x1·matrix,·for·a·total·of·6·values.
141 F\x8Fi\x8ie\x8el\x8ld\x8ds\x8s:\x8:141 F\x8Fi\x8ie\x8el\x8ld\x8ds\x8s:\x8:
142 ····*·m·-·A·4x4·float·matrix142 ····*·m·-·A·4x4·float·matrix
 143 Examples:
 144 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 145 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 146 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8._\x8c
143 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8op\x8py\x8y_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*147 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8co\x8op\x8py\x8y_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
144 void·al_copy_transform(ALLEGRO_TRANSFORM·*dest,·const·ALLEGRO_TRANSFORM·*src)148 void·al_copy_transform(ALLEGRO_TRANSFORM·*dest,·const·ALLEGRO_TRANSFORM·*src)
145 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e149 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
146 Makes·a·copy·of·a·transformation.150 Makes·a·copy·of·a·transformation.
147 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:151 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
148 ····*·dest·-·Source·transformation152 ····*·dest·-·Source·transformation
149 ····*·src·-·Destination·transformation153 ····*·src·-·Destination·transformation
 154 Examples:
 155 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
150 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8se\x8e_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*156 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8se\x8e_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
151 void·al_use_transform(const·ALLEGRO_TRANSFORM·*trans)157 void·al_use_transform(const·ALLEGRO_TRANSFORM·*trans)
152 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e158 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
153 Sets·the·transformation·to·be·used·for·the·the·drawing·operations·on·the·target159 Sets·the·transformation·to·be·used·for·the·the·drawing·operations·on·the·target
154 bitmap·(each·bitmap·maintains·its·own·transformation).·Every·drawing·operation160 bitmap·(each·bitmap·maintains·its·own·transformation).·Every·drawing·operation
155 after·this·call·will·be·transformed·using·this·transformation.·Call·this161 after·this·call·will·be·transformed·using·this·transformation.·Call·this
156 function·with·an·identity·transformation·to·return·to·the·default·behaviour.162 function·with·an·identity·transformation·to·return·to·the·default·behaviour.
Offset 163, 21 lines modifiedOffset 169, 28 lines modified
163 ···ALLEGRO_TRANSFORM·transform;169 ···ALLEGRO_TRANSFORM·transform;
164 ···al_translate_transform(&transform,·5,·10);170 ···al_translate_transform(&transform,·5,·10);
165 ···al_use_transform(&transform);171 ···al_use_transform(&transform);
166 }172 }
167 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:173 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
168 ····*·trans·-·Transformation·to·use174 ····*·trans·-·Transformation·to·use
169 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8c_\x8u_\x8r_\x8r_\x8e_\x8n_\x8t_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m_\x8__\x8c_\x8o_\x8o_\x8r_\x8d_\x8i_\x8n_\x8a_\x8t_\x8e_\x8s175 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8c_\x8u_\x8r_\x8r_\x8e_\x8n_\x8t_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m_\x8__\x8c_\x8o_\x8o_\x8r_\x8d_\x8i_\x8n_\x8a_\x8t_\x8e_\x8s
 176 Examples:
 177 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 178 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 179 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8._\x8c
170 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_c\x8cu\x8ur\x8rr\x8re\x8en\x8nt\x8t_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*180 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_c\x8cu\x8ur\x8rr\x8re\x8en\x8nt\x8t_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
171 const·ALLEGRO_TRANSFORM·*al_get_current_transform(void)181 const·ALLEGRO_TRANSFORM·*al_get_current_transform(void)
172 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e182 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
173 Returns·the·transformation·of·the·current·target·bitmap,·as·set·by183 Returns·the·transformation·of·the·current·target·bitmap,·as·set·by
174 _\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m.·If·there·is·no·target·bitmap,·this·function·returns·NULL.184 _\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m.·If·there·is·no·target·bitmap,·this·function·returns·NULL.
175 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·A·pointer·to·the·current·transformation.185 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·A·pointer·to·the·current·transformation.
176 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8c_\x8u_\x8r_\x8r_\x8e_\x8n_\x8t_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m186 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8c_\x8u_\x8r_\x8r_\x8e_\x8n_\x8t_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m
 187 Examples:
 188 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 189 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8g_\x8r_\x8a_\x8d_\x8i_\x8e_\x8n_\x8t_\x8._\x8c
177 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8se\x8e_\x8_p\x8pr\x8ro\x8oj\x8je\x8ec\x8ct\x8ti\x8io\x8on\x8n_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*190 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8se\x8e_\x8_p\x8pr\x8ro\x8oj\x8je\x8ec\x8ct\x8ti\x8io\x8on\x8n_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
178 void·al_use_projection_transform(const·ALLEGRO_TRANSFORM·*trans)191 void·al_use_projection_transform(const·ALLEGRO_TRANSFORM·*trans)
179 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e192 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
180 Sets·the·projection·transformation·to·be·used·for·the·drawing·operations·on·the193 Sets·the·projection·transformation·to·be·used·for·the·drawing·operations·on·the
181 target·bitmap·(each·bitmap·maintains·its·own·projection·transformation).·Every194 target·bitmap·(each·bitmap·maintains·its·own·projection·transformation).·Every
182 drawing·operation·after·this·call·will·be·transformed·using·this195 drawing·operation·after·this·call·will·be·transformed·using·this
183 transformation.·To·return·default·behavior,·call·this·function·with·an196 transformation.·To·return·default·behavior,·call·this·function·with·an
Offset 201, 21 lines modifiedOffset 214, 27 lines modified
201 projection·transform·of·the·target·bitmap·was·temporarily·reset·to·default).214 projection·transform·of·the·target·bitmap·was·temporarily·reset·to·default).
202 The·parameter·is·passed·by·reference·as·an·optimization·to·avoid·the·overhead215 The·parameter·is·passed·by·reference·as·an·optimization·to·avoid·the·overhead
203 of·stack·copying.·The·reference·will·not·be·stored·in·the·Allegro·library·so·it216 of·stack·copying.·The·reference·will·not·be·stored·in·the·Allegro·library·so·it
204 is·safe·to·pass·references·to·local·variables.217 is·safe·to·pass·references·to·local·variables.
205 Since:·5.1.9218 Since:·5.1.9
206 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8c_\x8u_\x8r_\x8r_\x8e_\x8n_\x8t_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8p_\x8e_\x8r_\x8s_\x8p_\x8e_\x8c_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,219 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8c_\x8u_\x8r_\x8r_\x8e_\x8n_\x8t_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8p_\x8e_\x8r_\x8s_\x8p_\x8e_\x8c_\x8t_\x8i_\x8v_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,
207 _\x8a_\x8l_\x8__\x8o_\x8r_\x8t_\x8h_\x8o_\x8g_\x8r_\x8a_\x8p_\x8h_\x8i_\x8c_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m220 _\x8a_\x8l_\x8__\x8o_\x8r_\x8t_\x8h_\x8o_\x8g_\x8r_\x8a_\x8p_\x8h_\x8i_\x8c_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m
 221 Examples:
 222 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8._\x8c
 223 ····*·_\x8e_\x8x_\x8__\x8d_\x8e_\x8p_\x8t_\x8h_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 224 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x82_\x8._\x8c
208 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_c\x8cu\x8ur\x8rr\x8re\x8en\x8nt\x8t_\x8_p\x8pr\x8ro\x8oj\x8je\x8ec\x8ct\x8ti\x8io\x8on\x8n_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*225 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_c\x8cu\x8ur\x8rr\x8re\x8en\x8nt\x8t_\x8_p\x8pr\x8ro\x8oj\x8je\x8ec\x8ct\x8ti\x8io\x8on\x8n_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
209 const·ALLEGRO_TRANSFORM·*al_get_current_projection_transform(void)226 const·ALLEGRO_TRANSFORM·*al_get_current_projection_transform(void)
210 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e227 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
211 If·there·is·no·target·bitmap,·this·function·returns·NULL.228 If·there·is·no·target·bitmap,·this·function·returns·NULL.
212 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·A·pointer·to·the·current·transformation.229 R\x8Re\x8et\x8tu\x8ur\x8rn\x8ns\x8s:\x8:·A·pointer·to·the·current·transformation.
213 Since:·5.1.9230 Since:·5.1.9
214 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m231 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8e_\x8__\x8p_\x8r_\x8o_\x8j_\x8e_\x8c_\x8t_\x8i_\x8o_\x8n_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m
 232 Examples:
 233 ····*·_\x8e_\x8x_\x8__\x8c_\x8a_\x8m_\x8e_\x8r_\x8a_\x8._\x8c
215 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_c\x8cu\x8ur\x8rr\x8re\x8en\x8nt\x8t_\x8_i\x8in\x8nv\x8ve\x8er\x8rs\x8se\x8e_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*234 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_c\x8cu\x8ur\x8rr\x8re\x8en\x8nt\x8t_\x8_i\x8in\x8nv\x8ve\x8er\x8rs\x8se\x8e_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
216 const·ALLEGRO_TRANSFORM·*al_get_current_inverse_transform(void)235 const·ALLEGRO_TRANSFORM·*al_get_current_inverse_transform(void)
217 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e236 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
218 Returns·the·inverse·of·the·current·transformation·of·the·target·bitmap.·If237 Returns·the·inverse·of·the·current·transformation·of·the·target·bitmap.·If
219 there·is·no·target·bitmap,·this·function·returns·NULL.238 there·is·no·target·bitmap,·this·function·returns·NULL.
220 This·is·similar·to·calling·al_invert_transform(al_get_current_transform())·but239 This·is·similar·to·calling·al_invert_transform(al_get_current_transform())·but
221 the·result·of·this·function·is·cached.240 the·result·of·this·function·is·cached.
Offset 280, 14 lines modifiedOffset 299, 18 lines modified
280 the·default.299 the·default.
281 ALLEGRO_TRANSFORM·t;300 ALLEGRO_TRANSFORM·t;
282 al_identity_transform(&t);301 al_identity_transform(&t);
283 al_use_transform(&t);302 al_use_transform(&t);
284 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:303 P\x8Pa\x8ar\x8ra\x8am\x8me\x8et\x8te\x8er\x8rs\x8s:\x8:
285 ····*·trans·-·Transformation·to·alter304 ····*·trans·-·Transformation·to·alter
286 See·also:·_\x8a_\x8l_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8l_\x8a_\x8t_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8r_\x8o_\x8t_\x8a_\x8t_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8s_\x8c_\x8a_\x8l_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m305 See·also:·_\x8a_\x8l_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8l_\x8a_\x8t_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8r_\x8o_\x8t_\x8a_\x8t_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8s_\x8c_\x8a_\x8l_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m
 306 Examples:
 307 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8._\x8c_\x8p_\x8p
 308 ····*·_\x8e_\x8x_\x8__\x8s_\x8h_\x8a_\x8d_\x8e_\x8r_\x8__\x8t_\x8a_\x8r_\x8g_\x8e_\x8t_\x8._\x8c
 309 ····*·_\x8e_\x8x_\x8__\x8a_\x8u_\x8d_\x8i_\x8o_\x8__\x8t_\x8i_\x8m_\x8e_\x8r_\x8._\x8c
287 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_b\x8bu\x8ui\x8il\x8ld\x8d_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*310 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_b\x8bu\x8ui\x8il\x8ld\x8d_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
288 void·al_build_transform(ALLEGRO_TRANSFORM·*trans,·float·x,·float·y,311 void·al_build_transform(ALLEGRO_TRANSFORM·*trans,·float·x,·float·y,
289 ···float·sx,·float·sy,·float·theta)312 ···float·sx,·float·sy,·float·theta)
290 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e313 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
291 Builds·a·transformation·given·some·parameters.·This·call·is·equivalent·to314 Builds·a·transformation·given·some·parameters.·This·call·is·equivalent·to
292 calling·the·transformations·in·this·order:·make·identity,·rotate,·scale,315 calling·the·transformations·in·this·order:·make·identity,·rotate,·scale,
293 translate.·This·method·is·faster,·however,·than·actually·calling·those316 translate.·This·method·is·faster,·however,·than·actually·calling·those
Offset 298, 14 lines modifiedOffset 321, 18 lines modified
298 ····*·sx,·sy·-·Scale321 ····*·sx,·sy·-·Scale
299 ····*·theta·-·Rotation·angle·in·radians322 ····*·theta·-·Rotation·angle·in·radians
300 ·····N\x8No\x8ot\x8te\x8e:·this·function·was·previously·documented·to·be·equivalent·to·a323 ·····N\x8No\x8ot\x8te\x8e:·this·function·was·previously·documented·to·be·equivalent·to·a
301 ·····different·(and·more·useful)·order·of·operations:·identity,·scale,324 ·····different·(and·more·useful)·order·of·operations:·identity,·scale,
302 ·····rotate,·translate.325 ·····rotate,·translate.
303 See·also:·_\x8a_\x8l_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8l_\x8a_\x8t_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8r_\x8o_\x8t_\x8a_\x8t_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8s_\x8c_\x8a_\x8l_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,326 See·also:·_\x8a_\x8l_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8l_\x8a_\x8t_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8r_\x8o_\x8t_\x8a_\x8t_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,·_\x8a_\x8l_\x8__\x8s_\x8c_\x8a_\x8l_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m,
304 _\x8a_\x8l_\x8__\x8c_\x8o_\x8m_\x8p_\x8o_\x8s_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m327 _\x8a_\x8l_\x8__\x8c_\x8o_\x8m_\x8p_\x8o_\x8s_\x8e_\x8__\x8t_\x8r_\x8a_\x8n_\x8s_\x8f_\x8o_\x8r_\x8m
 328 Examples:
 329 ····*·_\x8e_\x8x_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8s_\x8._\x8c
 330 ····*·_\x8e_\x8x_\x8__\x8c_\x8o_\x8l_\x8o_\x8r_\x8__\x8g_\x8r_\x8a_\x8d_\x8i_\x8e_\x8n_\x8t_\x8._\x8c
 331 ····*·_\x8e_\x8x_\x8__\x8p_\x8r_\x8i_\x8m_\x8._\x8c
305 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_b\x8bu\x8ui\x8il\x8ld\x8d_\x8_c\x8ca\x8am\x8me\x8er\x8ra\x8a_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*332 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_b\x8bu\x8ui\x8il\x8ld\x8d_\x8_c\x8ca\x8am\x8me\x8er\x8ra\x8a_\x8_t\x8tr\x8ra\x8an\x8ns\x8sf\x8fo\x8or\x8rm\x8m·*\x8**\x8**\x8**\x8**\x8**\x8*
306 void·al_build_camera_transform(ALLEGRO_TRANSFORM·*trans,333 void·al_build_camera_transform(ALLEGRO_TRANSFORM·*trans,
307 ···float·position_x,·float·position_y,·float·position_z,334 ···float·position_x,·float·position_y,·float·position_z,
308 ···float·look_x,·float·look_y,·float·look_z,335 ···float·look_x,·float·look_y,·float·look_z,
309 ···float·up_x,·float·up_y,·float·up_z)336 ···float·up_x,·float·up_y,·float·up_z)
310 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e337 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
311 Builds·a·transformation·which·can·be·used·to·transform·3D·coordinates·in·world338 Builds·a·transformation·which·can·be·used·to·transform·3D·coordinates·in·world
Offset 334, 59 lines modifiedOffset 361, 77 lines modified
334 al_build_camera_transform(&t,361 al_build_camera_transform(&t,
335 ····1,·1,·1,362 ····1,·1,·1,
336 ····5,·5,·5,363 ····5,·5,·5,
337 ····1,·1,·0);364 ····1,·1,·0);
Max diff block lines reached; 8991/16203 bytes (55.49%) of diff not shown.
120 KB
./usr/share/doc/allegro5-doc/refman/utf8.html
    
Offset 444, 28 lines modifiedOffset 444, 46 lines modified
444 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·_al_tagbstring·ALLEGRO_USTR<span·class="op">;</span></span></code></pre></div>444 <div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·_al_tagbstring·ALLEGRO_USTR<span·class="op">;</span></span></code></pre></div>
445 <p><a445 <p><a
446 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/utf8.h#L12">Source446 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/utf8.h#L12">Source
447 Code</a></p>447 Code</a></p>
448 <p>An·opaque·type·representing·a·string.·ALLEGRO_USTRs·normally·contain448 <p>An·opaque·type·representing·a·string.·ALLEGRO_USTRs·normally·contain
449 UTF-8·encoded·strings,·but·they·may·be·used·to·hold·any·byte·sequences,449 UTF-8·encoded·strings,·but·they·may·be·used·to·hold·any·byte·sequences,
450 including·NULs.</p>450 including·NULs.</p>
 451 <p>Examples:</p>
 452 <ul>
 453 <li><a
 454 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_multiline.cpp#L248">ex_font_multiline.cpp</a></li>
 455 <li><a
 456 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L39">nihgui.cpp</a></li>
 457 <li><a
 458 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend.c#L57">ex_blend.c</a></li>
 459 </ul>
451 <h2·id="allegro_ustr_info">ALLEGRO_USTR_INFO</h2>460 <h2·id="allegro_ustr_info">ALLEGRO_USTR_INFO</h2>
452 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·_al_tagbstring·ALLEGRO_USTR_INFO<span·class="op">;</span></span></code></pre></div>461 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·_al_tagbstring·ALLEGRO_USTR_INFO<span·class="op">;</span></span></code></pre></div>
453 <p><a462 <p><a
454 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/utf8.h#L16">Source463 href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/utf8.h#L16">Source
455 Code</a></p>464 Code</a></p>
456 <p>A·type·that·holds·additional·information·for·an·<a465 <p>A·type·that·holds·additional·information·for·an·<a
457 href="utf8.html#allegro_ustr">ALLEGRO_USTR</a>·that·references·an466 href="utf8.html#allegro_ustr">ALLEGRO_USTR</a>·that·references·an
458 external·memory·buffer.·You·can·convert·it·back·to·<a467 external·memory·buffer.·You·can·convert·it·back·to·<a
459 href="utf8.html#allegro_ustr">ALLEGRO_USTR</a>·via·<a468 href="utf8.html#allegro_ustr">ALLEGRO_USTR</a>·via·<a
460 href="utf8.html#al_ref_info">al_ref_info</a>.</p>469 href="utf8.html#al_ref_info">al_ref_info</a>.</p>
461 <p>See·also:·<a·href="utf8.html#al_ref_cstr">al_ref_cstr</a>,·<a470 <p>See·also:·<a·href="utf8.html#al_ref_cstr">al_ref_cstr</a>,·<a
462 href="utf8.html#al_ref_buffer">al_ref_buffer</a>,·<a471 href="utf8.html#al_ref_buffer">al_ref_buffer</a>,·<a
463 href="utf8.html#al_ref_info">al_ref_info</a>·and·<a472 href="utf8.html#al_ref_info">al_ref_info</a>·and·<a
464 href="utf8.html#al_ref_ustr">al_ref_ustr</a>.</p>473 href="utf8.html#al_ref_ustr">al_ref_ustr</a>.</p>
 474 <p>Examples:</p>
 475 <ul>
 476 <li><a
 477 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_font_multiline.cpp#L248">ex_font_multiline.cpp</a></li>
 478 <li><a
 479 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L39">nihgui.cpp</a></li>
 480 <li><a
 481 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_blend.c#L57">ex_blend.c</a></li>
 482 </ul>
465 <h1·id="creating-and-destroying-strings">Creating·and·destroying483 <h1·id="creating-and-destroying-strings">Creating·and·destroying
466 strings</h1>484 strings</h1>
467 <h2·id="al_ustr_new">al_ustr_new</h2>485 <h2·id="al_ustr_new">al_ustr_new</h2>
468 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_USTR·<span·class="op">*</span>al_ustr_new<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>s<span·class="op">)</span></span></code></pre></div>486 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_USTR·<span·class="op">*</span>al_ustr_new<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>s<span·class="op">)</span></span></code></pre></div>
469 <p><a487 <p><a
470 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L62">Source488 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L62">Source
471 Code</a></p>489 Code</a></p>
Offset 473, 24 lines modifiedOffset 491, 38 lines modified
473 <code>s</code>.·The·string·must·eventually·be·freed·with·<a491 <code>s</code>.·The·string·must·eventually·be·freed·with·<a
474 href="utf8.html#al_ustr_free">al_ustr_free</a>.</p>492 href="utf8.html#al_ustr_free">al_ustr_free</a>.</p>
475 <p>See·also:·<a493 <p>See·also:·<a
476 href="utf8.html#al_ustr_new_from_buffer">al_ustr_new_from_buffer</a>,·<a494 href="utf8.html#al_ustr_new_from_buffer">al_ustr_new_from_buffer</a>,·<a
477 href="utf8.html#al_ustr_newf">al_ustr_newf</a>,·<a495 href="utf8.html#al_ustr_newf">al_ustr_newf</a>,·<a
478 href="utf8.html#al_ustr_dup">al_ustr_dup</a>,·<a496 href="utf8.html#al_ustr_dup">al_ustr_dup</a>,·<a
479 href="utf8.html#al_ustr_new_from_utf16">al_ustr_new_from_utf16</a></p>497 href="utf8.html#al_ustr_new_from_utf16">al_ustr_new_from_utf16</a></p>
 498 <p>Examples:</p>
 499 <ul>
 500 <li><a
 501 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L756">nihgui.cpp</a></li>
 502 <li><a
 503 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_loading_thread.c#L65">ex_loading_thread.c</a></li>
 504 <li><a
 505 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_utf8.c#L54">ex_utf8.c</a></li>
 506 </ul>
480 <h2·id="al_ustr_new_from_buffer">al_ustr_new_from_buffer</h2>507 <h2·id="al_ustr_new_from_buffer">al_ustr_new_from_buffer</h2>
481 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_USTR·<span·class="op">*</span>al_ustr_new_from_buffer<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>s<span·class="op">,</span>·<span·class="dt">size_t</span>·size<span·class="op">)</span></span></code></pre></div>508 <div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_USTR·<span·class="op">*</span>al_ustr_new_from_buffer<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>s<span·class="op">,</span>·<span·class="dt">size_t</span>·size<span·class="op">)</span></span></code></pre></div>
482 <p><a509 <p><a
483 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L70">Source510 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L70">Source
484 Code</a></p>511 Code</a></p>
485 <p>Create·a·new·string·containing·a·copy·of·the·buffer·pointed·to·by512 <p>Create·a·new·string·containing·a·copy·of·the·buffer·pointed·to·by
486 <code>s</code>·of·the·given·<code>size</code>·in·bytes.·The·string·must513 <code>s</code>·of·the·given·<code>size</code>·in·bytes.·The·string·must
487 eventually·be·freed·with·<a514 eventually·be·freed·with·<a
488 href="utf8.html#al_ustr_free">al_ustr_free</a>.</p>515 href="utf8.html#al_ustr_free">al_ustr_free</a>.</p>
489 <p>See·also:·<a·href="utf8.html#al_ustr_new">al_ustr_new</a></p>516 <p>See·also:·<a·href="utf8.html#al_ustr_new">al_ustr_new</a></p>
 517 <p>Examples:</p>
 518 <ul>
 519 <li><a
 520 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_utf8.c#L845">ex_utf8.c</a></li>
 521 </ul>
490 <h2·id="al_ustr_newf">al_ustr_newf</h2>522 <h2·id="al_ustr_newf">al_ustr_newf</h2>
491 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_USTR·<span·class="op">*</span>al_ustr_newf<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>fmt<span·class="op">,</span>·<span·class="op">...)</span></span></code></pre></div>523 <div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_USTR·<span·class="op">*</span>al_ustr_newf<span·class="op">(</span><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>fmt<span·class="op">,</span>·<span·class="op">...)</span></span></code></pre></div>
492 <p><a524 <p><a
493 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L78">Source525 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L78">Source
494 Code</a></p>526 Code</a></p>
495 <p>Create·a·new·string·using·a·printf-style·format·string.</p>527 <p>Create·a·new·string·using·a·printf-style·format·string.</p>
496 <p><em>Notes:</em></p>528 <p><em>Notes:</em></p>
Offset 503, 24 lines modifiedOffset 535, 38 lines modified
503 code·point.·Therefore·it·is·only·usable·for·ASCII·characters·(value535 code·point.·Therefore·it·is·only·usable·for·ASCII·characters·(value
504 &lt;=·127)·or·if·you·really·mean·to·output·byte·values·from·128–255.·To536 &lt;=·127)·or·if·you·really·mean·to·output·byte·values·from·128–255.·To
505 insert·the·UTF-8·encoding·of·a·code·point,·encode·it·into·a·memory537 insert·the·UTF-8·encoding·of·a·code·point,·encode·it·into·a·memory
506 buffer·using·<a·href="utf8.html#al_utf8_encode">al_utf8_encode</a>·then538 buffer·using·<a·href="utf8.html#al_utf8_encode">al_utf8_encode</a>·then
507 use·the·“%s”·specifier.·Remember·to·NUL·terminate·the·buffer.</p>539 use·the·“%s”·specifier.·Remember·to·NUL·terminate·the·buffer.</p>
508 <p>See·also:·<a·href="utf8.html#al_ustr_new">al_ustr_new</a>,·<a540 <p>See·also:·<a·href="utf8.html#al_ustr_new">al_ustr_new</a>,·<a
509 href="utf8.html#al_ustr_appendf">al_ustr_appendf</a></p>541 href="utf8.html#al_ustr_appendf">al_ustr_appendf</a></p>
 542 <p>Examples:</p>
 543 <ul>
 544 <li><a
 545 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_utf8.c#L1006">ex_utf8.c</a></li>
 546 </ul>
510 <h2·id="al_ustr_free">al_ustr_free</h2>547 <h2·id="al_ustr_free">al_ustr_free</h2>
511 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_ustr_free<span·class="op">(</span>ALLEGRO_USTR·<span·class="op">*</span>us<span·class="op">)</span></span></code></pre></div>548 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_ustr_free<span·class="op">(</span>ALLEGRO_USTR·<span·class="op">*</span>us<span·class="op">)</span></span></code></pre></div>
512 <p><a549 <p><a
513 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L93">Source550 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L93">Source
514 Code</a></p>551 Code</a></p>
515 <p>Free·a·previously·allocated·string.·Does·nothing·if·the·argument·is552 <p>Free·a·previously·allocated·string.·Does·nothing·if·the·argument·is
516 NULL.</p>553 NULL.</p>
517 <p>See·also:·<a·href="utf8.html#al_ustr_new">al_ustr_new</a>,·<a554 <p>See·also:·<a·href="utf8.html#al_ustr_new">al_ustr_new</a>,·<a
518 href="utf8.html#al_ustr_new_from_buffer">al_ustr_new_from_buffer</a>,·<a555 href="utf8.html#al_ustr_new_from_buffer">al_ustr_new_from_buffer</a>,·<a
519 href="utf8.html#al_ustr_newf">al_ustr_newf</a></p>556 href="utf8.html#al_ustr_newf">al_ustr_newf</a></p>
 557 <p>Examples:</p>
 558 <ul>
 559 <li><a
 560 href="https://github.com/liballeg/allegro5/blob/master/examples/nihgui.cpp#L761">nihgui.cpp</a></li>
 561 <li><a
 562 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_loading_thread.c#L77">ex_loading_thread.c</a></li>
 563 <li><a
 564 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_utf8.c#L61">ex_utf8.c</a></li>
 565 </ul>
520 <h2·id="al_cstr">al_cstr</h2>566 <h2·id="al_cstr">al_cstr</h2>
521 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>al_cstr<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_USTR·<span·class="op">*</span>us<span·class="op">)</span></span></code></pre></div>567 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">const</span>·<span·class="dt">char</span>·<span·class="op">*</span>al_cstr<span·class="op">(</span><span·class="dt">const</span>·ALLEGRO_USTR·<span·class="op">*</span>us<span·class="op">)</span></span></code></pre></div>
522 <p><a568 <p><a
523 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L101">Source569 href="https://github.com/liballeg/allegro5/blob/master/src/utf8.c#L101">Source
524 Code</a></p>570 Code</a></p>
525 <p>Get·a·<code>char·*</code>·pointer·to·the·data·in·a·string.·This571 <p>Get·a·<code>char·*</code>·pointer·to·the·data·in·a·string.·This
526 pointer·will·only·be·valid·while·the·<a572 pointer·will·only·be·valid·while·the·<a
Offset 538, 47 lines modifiedOffset 584, 71 lines modified
538 <li><p>If·the·ALLEGRO_USTR·references·another·string,·the·returned·C584 <li><p>If·the·ALLEGRO_USTR·references·another·string,·the·returned·C
539 string·will·point·into·the·referenced·string.·Again,·no·NUL·terminator585 string·will·point·into·the·referenced·string.·Again,·no·NUL·terminator
Max diff block lines reached; 72877/80840 bytes (90.15%) of diff not shown.
40.9 KB
html2text {}
    
Offset 195, 35 lines modifiedOffset 195, 49 lines modified
195 *\x8**\x8**\x8**\x8**\x8**\x8*·U\x8UT\x8TF\x8F-\x8-8\x88·s\x8st\x8tr\x8ri\x8in\x8ng\x8g·t\x8ty\x8yp\x8pe\x8es\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*195 *\x8**\x8**\x8**\x8**\x8**\x8*·U\x8UT\x8TF\x8F-\x8-8\x88·s\x8st\x8tr\x8ri\x8in\x8ng\x8g·t\x8ty\x8yp\x8pe\x8es\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
196 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_U\x8US\x8ST\x8TR\x8R·*\x8**\x8**\x8**\x8**\x8*196 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_U\x8US\x8ST\x8TR\x8R·*\x8**\x8**\x8**\x8**\x8*
197 typedef·struct·_al_tagbstring·ALLEGRO_USTR;197 typedef·struct·_al_tagbstring·ALLEGRO_USTR;
198 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e198 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
199 An·opaque·type·representing·a·string.·ALLEGRO_USTRs·normally·contain·UTF-199 An·opaque·type·representing·a·string.·ALLEGRO_USTRs·normally·contain·UTF-
200 8·encoded·strings,·but·they·may·be·used·to·hold·any·byte·sequences,·including200 8·encoded·strings,·but·they·may·be·used·to·hold·any·byte·sequences,·including
201 NULs.201 NULs.
 202 Examples:
 203 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8l_\x8i_\x8n_\x8e_\x8._\x8c_\x8p_\x8p
 204 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
 205 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8._\x8c
202 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_U\x8US\x8ST\x8TR\x8R_\x8_I\x8IN\x8NF\x8FO\x8O·*\x8**\x8**\x8**\x8**\x8*206 *\x8**\x8**\x8**\x8**\x8*·A\x8AL\x8LL\x8LE\x8EG\x8GR\x8RO\x8O_\x8_U\x8US\x8ST\x8TR\x8R_\x8_I\x8IN\x8NF\x8FO\x8O·*\x8**\x8**\x8**\x8**\x8*
203 typedef·struct·_al_tagbstring·ALLEGRO_USTR_INFO;207 typedef·struct·_al_tagbstring·ALLEGRO_USTR_INFO;
204 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e208 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
205 A·type·that·holds·additional·information·for·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8U_\x8S_\x8T_\x8R·that·references·an209 A·type·that·holds·additional·information·for·an·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8U_\x8S_\x8T_\x8R·that·references·an
206 external·memory·buffer.·You·can·convert·it·back·to·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8U_\x8S_\x8T_\x8R·via210 external·memory·buffer.·You·can·convert·it·back·to·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8U_\x8S_\x8T_\x8R·via
207 _\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8i_\x8n_\x8f_\x8o.211 _\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8i_\x8n_\x8f_\x8o.
208 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8c_\x8s_\x8t_\x8r,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8i_\x8n_\x8f_\x8o·and·_\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8u_\x8s_\x8t_\x8r.212 See·also:·_\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8c_\x8s_\x8t_\x8r,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8i_\x8n_\x8f_\x8o·and·_\x8a_\x8l_\x8__\x8r_\x8e_\x8f_\x8__\x8u_\x8s_\x8t_\x8r.
 213 Examples:
 214 ····*·_\x8e_\x8x_\x8__\x8f_\x8o_\x8n_\x8t_\x8__\x8m_\x8u_\x8l_\x8t_\x8i_\x8l_\x8i_\x8n_\x8e_\x8._\x8c_\x8p_\x8p
 215 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
 216 ····*·_\x8e_\x8x_\x8__\x8b_\x8l_\x8e_\x8n_\x8d_\x8._\x8c
209 *\x8**\x8**\x8**\x8**\x8**\x8*·C\x8Cr\x8re\x8ea\x8at\x8ti\x8in\x8ng\x8g·a\x8an\x8nd\x8d·d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8yi\x8in\x8ng\x8g·s\x8st\x8tr\x8ri\x8in\x8ng\x8gs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*217 *\x8**\x8**\x8**\x8**\x8**\x8*·C\x8Cr\x8re\x8ea\x8at\x8ti\x8in\x8ng\x8g·a\x8an\x8nd\x8d·d\x8de\x8es\x8st\x8tr\x8ro\x8oy\x8yi\x8in\x8ng\x8g·s\x8st\x8tr\x8ri\x8in\x8ng\x8gs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
210 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_n\x8ne\x8ew\x8w·*\x8**\x8**\x8**\x8**\x8*218 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_n\x8ne\x8ew\x8w·*\x8**\x8**\x8**\x8**\x8*
211 ALLEGRO_USTR·*al_ustr_new(const·char·*s)219 ALLEGRO_USTR·*al_ustr_new(const·char·*s)
212 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e220 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
213 Create·a·new·string·containing·a·copy·of·the·C-style·string·s.·The·string·must221 Create·a·new·string·containing·a·copy·of·the·C-style·string·s.·The·string·must
214 eventually·be·freed·with·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e.222 eventually·be·freed·with·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e.
215 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8f,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p,223 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8f,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p,
216 _\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8u_\x8t_\x8f_\x81_\x86224 _\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8u_\x8t_\x8f_\x81_\x86
 225 Examples:
 226 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
 227 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
 228 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
217 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_n\x8ne\x8ew\x8w_\x8_f\x8fr\x8ro\x8om\x8m_\x8_b\x8bu\x8uf\x8ff\x8fe\x8er\x8r·*\x8**\x8**\x8**\x8**\x8*229 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_n\x8ne\x8ew\x8w_\x8_f\x8fr\x8ro\x8om\x8m_\x8_b\x8bu\x8uf\x8ff\x8fe\x8er\x8r·*\x8**\x8**\x8**\x8**\x8*
218 ALLEGRO_USTR·*al_ustr_new_from_buffer(const·char·*s,·size_t·size)230 ALLEGRO_USTR·*al_ustr_new_from_buffer(const·char·*s,·size_t·size)
219 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e231 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
220 Create·a·new·string·containing·a·copy·of·the·buffer·pointed·to·by·s·of·the232 Create·a·new·string·containing·a·copy·of·the·buffer·pointed·to·by·s·of·the
221 given·size·in·bytes.·The·string·must·eventually·be·freed·with·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e.233 given·size·in·bytes.·The·string·must·eventually·be·freed·with·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e.
222 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w234 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w
 235 Examples:
 236 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
223 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_n\x8ne\x8ew\x8wf\x8f·*\x8**\x8**\x8**\x8**\x8*237 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_n\x8ne\x8ew\x8wf\x8f·*\x8**\x8**\x8**\x8**\x8*
224 ALLEGRO_USTR·*al_ustr_newf(const·char·*fmt,·...)238 ALLEGRO_USTR·*al_ustr_newf(const·char·*fmt,·...)
225 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e239 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
226 Create·a·new·string·using·a·printf-style·format·string.240 Create·a·new·string·using·a·printf-style·format·string.
227 N\x8No\x8ot\x8te\x8es\x8s:\x8:241 N\x8No\x8ot\x8te\x8es\x8s:\x8:
228 The·“%s”·specifier·takes·C·string·arguments,·not·ALLEGRO_USTRs.·Therefore·to242 The·“%s”·specifier·takes·C·string·arguments,·not·ALLEGRO_USTRs.·Therefore·to
229 pass·an·ALLEGRO_USTR·as·a·parameter·you·must·use·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r,·and·it·must·be·NUL243 pass·an·ALLEGRO_USTR·as·a·parameter·you·must·use·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r,·and·it·must·be·NUL
Offset 231, 19 lines modifiedOffset 245, 25 lines modified
231 byte·onwards·will·be·ignored.245 byte·onwards·will·be·ignored.
232 The·“%c”·specifier·outputs·a·single·byte,·not·the·UTF-8·encoding·of·a·code246 The·“%c”·specifier·outputs·a·single·byte,·not·the·UTF-8·encoding·of·a·code
233 point.·Therefore·it·is·only·usable·for·ASCII·characters·(value·<=·127)·or·if247 point.·Therefore·it·is·only·usable·for·ASCII·characters·(value·<=·127)·or·if
234 you·really·mean·to·output·byte·values·from·128–255.·To·insert·the·UTF-248 you·really·mean·to·output·byte·values·from·128–255.·To·insert·the·UTF-
235 8·encoding·of·a·code·point,·encode·it·into·a·memory·buffer·using·_\x8a_\x8l_\x8__\x8u_\x8t_\x8f_\x88_\x8__\x8e_\x8n_\x8c_\x8o_\x8d_\x8e249 8·encoding·of·a·code·point,·encode·it·into·a·memory·buffer·using·_\x8a_\x8l_\x8__\x8u_\x8t_\x8f_\x88_\x8__\x8e_\x8n_\x8c_\x8o_\x8d_\x8e
236 then·use·the·“%s”·specifier.·Remember·to·NUL·terminate·the·buffer.250 then·use·the·“%s”·specifier.·Remember·to·NUL·terminate·the·buffer.
237 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8a_\x8p_\x8p_\x8e_\x8n_\x8d_\x8f251 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8a_\x8p_\x8p_\x8e_\x8n_\x8d_\x8f
 252 Examples:
 253 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
238 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_f\x8fr\x8re\x8ee\x8e·*\x8**\x8**\x8**\x8**\x8*254 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_f\x8fr\x8re\x8ee\x8e·*\x8**\x8**\x8**\x8**\x8*
239 void·al_ustr_free(ALLEGRO_USTR·*us)255 void·al_ustr_free(ALLEGRO_USTR·*us)
240 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e256 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
241 Free·a·previously·allocated·string.·Does·nothing·if·the·argument·is·NULL.257 Free·a·previously·allocated·string.·Does·nothing·if·the·argument·is·NULL.
242 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8f258 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8__\x8f_\x8r_\x8o_\x8m_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8n_\x8e_\x8w_\x8f
 259 Examples:
 260 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
 261 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
 262 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
243 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cs\x8st\x8tr\x8r·*\x8**\x8**\x8**\x8**\x8*263 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cs\x8st\x8tr\x8r·*\x8**\x8**\x8**\x8**\x8*
244 const·char·*al_cstr(const·ALLEGRO_USTR·*us)264 const·char·*al_cstr(const·ALLEGRO_USTR·*us)
245 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e265 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
246 Get·a·char·*·pointer·to·the·data·in·a·string.·This·pointer·will·only·be·valid266 Get·a·char·*·pointer·to·the·data·in·a·string.·This·pointer·will·only·be·valid
247 while·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8U_\x8S_\x8T_\x8R·object·is·not·modified·and·not·destroyed.·The·pointer267 while·the·_\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8U_\x8S_\x8T_\x8R·object·is·not·modified·and·not·destroyed.·The·pointer
248 may·be·passed·to·functions·expecting·C-style·strings,·with·the·following268 may·be·passed·to·functions·expecting·C-style·strings,·with·the·following
249 caveats:269 caveats:
Offset 253, 74 lines modifiedOffset 273, 95 lines modified
253 ······terminated.·A·string·which·is·dynamically·allocated·will·always·be·NUL273 ······terminated.·A·string·which·is·dynamically·allocated·will·always·be·NUL
254 ······terminated,·but·a·string·which·references·the·middle·of·another·string·or274 ······terminated,·but·a·string·which·references·the·middle·of·another·string·or
255 ······region·of·memory·will·n\x8no\x8ot\x8t·be·NUL·terminated.275 ······region·of·memory·will·n\x8no\x8ot\x8t·be·NUL·terminated.
256 ····*·If·the·ALLEGRO_USTR·references·another·string,·the·returned·C·string·will276 ····*·If·the·ALLEGRO_USTR·references·another·string,·the·returned·C·string·will
257 ······point·into·the·referenced·string.·Again,·no·NUL·terminator·will·be·added277 ······point·into·the·referenced·string.·Again,·no·NUL·terminator·will·be·added
258 ······to·the·referenced·string.278 ······to·the·referenced·string.
259 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8t_\x8o_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p279 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8t_\x8o_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p
 280 Examples:
 281 ····*·_\x8n_\x8i_\x8h_\x8g_\x8u_\x8i_\x8._\x8c_\x8p_\x8p
 282 ····*·_\x8e_\x8x_\x8__\x8l_\x8o_\x8a_\x8d_\x8i_\x8n_\x8g_\x8__\x8t_\x8h_\x8r_\x8e_\x8a_\x8d_\x8._\x8c
 283 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
260 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_t\x8to\x8o_\x8_b\x8bu\x8uf\x8ff\x8fe\x8er\x8r·*\x8**\x8**\x8**\x8**\x8*284 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_t\x8to\x8o_\x8_b\x8bu\x8uf\x8ff\x8fe\x8er\x8r·*\x8**\x8**\x8**\x8**\x8*
261 void·al_ustr_to_buffer(const·ALLEGRO_USTR·*us,·char·*buffer,·int·size)285 void·al_ustr_to_buffer(const·ALLEGRO_USTR·*us,·char·*buffer,·int·size)
262 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e286 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
263 Write·the·contents·of·the·string·into·a·pre-allocated·buffer·of·the·given·size287 Write·the·contents·of·the·string·into·a·pre-allocated·buffer·of·the·given·size
264 in·bytes.·The·result·will·always·be·NUL·terminated,·so·a·maximum·of·size·-·1288 in·bytes.·The·result·will·always·be·NUL·terminated,·so·a·maximum·of·size·-·1
265 bytes·will·be·copied.289 bytes·will·be·copied.
266 See·also:·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r,·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p290 See·also:·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r,·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p
 291 Examples:
 292 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
267 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cs\x8st\x8tr\x8r_\x8_d\x8du\x8up\x8p·*\x8**\x8**\x8**\x8**\x8*293 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cs\x8st\x8tr\x8r_\x8_d\x8du\x8up\x8p·*\x8**\x8**\x8**\x8**\x8*
268 char·*al_cstr_dup(const·ALLEGRO_USTR·*us)294 char·*al_cstr_dup(const·ALLEGRO_USTR·*us)
269 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e295 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
270 Create·a·NUL·('\0')·terminated·copy·of·the·string.·Any·embedded·NUL·bytes·will296 Create·a·NUL·('\0')·terminated·copy·of·the·string.·Any·embedded·NUL·bytes·will
271 still·be·presented·in·the·returned·string.·The·new·string·must·eventually·be297 still·be·presented·in·the·returned·string.·The·new·string·must·eventually·be
272 freed·with·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e.298 freed·with·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e.
273 If·an·error·occurs·NULL·is·returned.299 If·an·error·occurs·NULL·is·returned.
274 See·also:·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8t_\x8o_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e300 See·also:·_\x8a_\x8l_\x8__\x8c_\x8s_\x8t_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8t_\x8o_\x8__\x8b_\x8u_\x8f_\x8f_\x8e_\x8r,·_\x8a_\x8l_\x8__\x8f_\x8r_\x8e_\x8e
 301 Examples:
 302 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
275 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_d\x8du\x8up\x8p·*\x8**\x8**\x8**\x8**\x8*303 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_d\x8du\x8up\x8p·*\x8**\x8**\x8**\x8**\x8*
276 ALLEGRO_USTR·*al_ustr_dup(const·ALLEGRO_USTR·*us)304 ALLEGRO_USTR·*al_ustr_dup(const·ALLEGRO_USTR·*us)
277 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e305 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
278 Return·a·duplicate·copy·of·a·string.·The·new·string·will·need·to·be·freed·with306 Return·a·duplicate·copy·of·a·string.·The·new·string·will·need·to·be·freed·with
279 _\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e.307 _\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e.
280 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p_\x8__\x8s_\x8u_\x8b_\x8s_\x8t_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e308 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p_\x8__\x8s_\x8u_\x8b_\x8s_\x8t_\x8r,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e
 309 Examples:
 310 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
281 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_d\x8du\x8up\x8p_\x8_s\x8su\x8ub\x8bs\x8st\x8tr\x8r·*\x8**\x8**\x8**\x8**\x8*311 *\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_u\x8us\x8st\x8tr\x8r_\x8_d\x8du\x8up\x8p_\x8_s\x8su\x8ub\x8bs\x8st\x8tr\x8r·*\x8**\x8**\x8**\x8**\x8*
282 ALLEGRO_USTR·*al_ustr_dup_substr(const·ALLEGRO_USTR·*us,·int·start_pos,312 ALLEGRO_USTR·*al_ustr_dup_substr(const·ALLEGRO_USTR·*us,·int·start_pos,
283 ···int·end_pos)313 ···int·end_pos)
284 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e314 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
285 Return·a·new·copy·of·a·string,·containing·its·contents·in·the·byte·interval315 Return·a·new·copy·of·a·string,·containing·its·contents·in·the·byte·interval
286 [start_pos,·end_pos).·The·new·string·will·be·NUL·terminated·and·will·need·to·be316 [start_pos,·end_pos).·The·new·string·will·be·NUL·terminated·and·will·need·to·be
287 freed·with·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e.317 freed·with·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e.
288 If·necessary,·use·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8o_\x8f_\x8f_\x8s_\x8e_\x8t·to·find·the·byte·offsets·for·a·given·code318 If·necessary,·use·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8o_\x8f_\x8f_\x8s_\x8e_\x8t·to·find·the·byte·offsets·for·a·given·code
289 point·that·you·are·interested·in.319 point·that·you·are·interested·in.
290 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e320 See·also:·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8d_\x8u_\x8p,·_\x8a_\x8l_\x8__\x8u_\x8s_\x8t_\x8r_\x8__\x8f_\x8r_\x8e_\x8e
 321 Examples:
 322 ····*·_\x8e_\x8x_\x8__\x8u_\x8t_\x8f_\x88_\x8._\x8c
291 *\x8**\x8**\x8**\x8**\x8**\x8*·P\x8Pr\x8re\x8ed\x8de\x8ef\x8fi\x8in\x8ne\x8ed\x8d·s\x8st\x8tr\x8ri\x8in\x8ng\x8gs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*323 *\x8**\x8**\x8**\x8**\x8**\x8*·P\x8Pr\x8re\x8ed\x8de\x8ef\x8fi\x8in\x8ne\x8ed\x8d·s\x8st\x8tr\x8ri\x8in\x8ng\x8gs\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
Max diff block lines reached; 34404/41878 bytes (82.15%) of diff not shown.
20.8 KB
./usr/share/doc/allegro5-doc/refman/video.html
    
Offset 290, 14 lines modifiedOffset 290, 19 lines modified
290 <h1·id="al_init_video_addon">al_init_video_addon</h1>290 <h1·id="al_init_video_addon">al_init_video_addon</h1>
291 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_init_video_addon<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>291 <div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_init_video_addon<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
292 <p><a292 <p><a
293 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L275">Source293 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L275">Source
294 Code</a></p>294 Code</a></p>
295 <p>Initializes·the·video·addon.</p>295 <p>Initializes·the·video·addon.</p>
296 <p>Since:·5.1.12</p>296 <p>Since:·5.1.12</p>
 297 <p>Examples:</p>
 298 <ul>
 299 <li><a
 300 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_video.c#L114">ex_video.c</a></li>
 301 </ul>
297 <h1302 <h1
298 id="al_is_video_addon_initialized">al_is_video_addon_initialized</h1>303 id="al_is_video_addon_initialized">al_is_video_addon_initialized</h1>
299 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_video_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>304 <div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_video_addon_initialized<span·class="op">(</span><span·class="dt">void</span><span·class="op">)</span></span></code></pre></div>
300 <p><a305 <p><a
301 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L297">Source306 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L297">Source
302 Code</a></p>307 Code</a></p>
303 <p>Returns·true·if·the·video·addon·is·initialized,·otherwise·returns308 <p>Returns·true·if·the·video·addon·is·initialized,·otherwise·returns
Offset 323, 14 lines modifiedOffset 328, 19 lines modified
323 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_VIDEO·<span·class="op">*</span>al_open_video<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>filename<span·class="op">)</span></span></code></pre></div>328 <div·class="sourceCode"·id="cb8"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb8-1"><a·href="#cb8-1"·aria-hidden="true"·tabindex="-1"></a>ALLEGRO_VIDEO·<span·class="op">*</span>al_open_video<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>filename<span·class="op">)</span></span></code></pre></div>
324 <p><a329 <p><a
325 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L100">Source330 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L100">Source
326 Code</a></p>331 Code</a></p>
327 <p>Reads·a·video·file.·This·does·not·start·playing·yet·but·reads·the332 <p>Reads·a·video·file.·This·does·not·start·playing·yet·but·reads·the
328 meta·info·so·you·can·query·e.g. the·size·or·audio·rate.</p>333 meta·info·so·you·can·query·e.g. the·size·or·audio·rate.</p>
329 <p>Since:·5.1.0</p>334 <p>Since:·5.1.0</p>
 335 <p>Examples:</p>
 336 <ul>
 337 <li><a
 338 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_video.c#L141">ex_video.c</a></li>
 339 </ul>
330 <h1·id="al_identify_video">al_identify_video</h1>340 <h1·id="al_identify_video">al_identify_video</h1>
331 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>al_identify_video<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>filename<span·class="op">)</span></span></code></pre></div>341 <div·class="sourceCode"·id="cb9"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb9-1"><a·href="#cb9-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>al_identify_video<span·class="op">(</span><span·class="dt">char</span>·<span·class="dt">const</span>·<span·class="op">*</span>filename<span·class="op">)</span></span></code></pre></div>
332 <p><a342 <p><a
333 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L334">Source343 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L334">Source
334 Code</a></p>344 Code</a></p>
335 <p>This·works·exactly·as·<a345 <p>This·works·exactly·as·<a
336 href="video.html#al_identify_video_f">al_identify_video_f</a>·but·you346 href="video.html#al_identify_video_f">al_identify_video_f</a>·but·you
Offset 362, 21 lines modifiedOffset 372, 31 lines modified
362 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_close_video<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">)</span></span></code></pre></div>372 <div·class="sourceCode"·id="cb11"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb11-1"><a·href="#cb11-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_close_video<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">)</span></span></code></pre></div>
363 <p><a373 <p><a
364 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L141">Source374 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L141">Source
365 Code</a></p>375 Code</a></p>
366 <p>Closes·the·video·and·frees·all·allocated·resources.·The·video·pointer376 <p>Closes·the·video·and·frees·all·allocated·resources.·The·video·pointer
367 is·invalid·after·the·function·returns.</p>377 is·invalid·after·the·function·returns.</p>
368 <p>Since:·5.1.0</p>378 <p>Since:·5.1.0</p>
 379 <p>Examples:</p>
 380 <ul>
 381 <li><a
 382 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_video.c#L180">ex_video.c</a></li>
 383 </ul>
369 <h1·id="al_start_video">al_start_video</h1>384 <h1·id="al_start_video">al_start_video</h1>
370 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_start_video<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">,</span>·ALLEGRO_MIXER·<span·class="op">*</span>mixer<span·class="op">)</span></span></code></pre></div>385 <div·class="sourceCode"·id="cb12"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb12-1"><a·href="#cb12-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_start_video<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">,</span>·ALLEGRO_MIXER·<span·class="op">*</span>mixer<span·class="op">)</span></span></code></pre></div>
371 <p><a386 <p><a
372 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L164">Source387 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L164">Source
373 Code</a></p>388 Code</a></p>
374 <p>Starts·playing·the·video·from·the·beginning.</p>389 <p>Starts·playing·the·video·from·the·beginning.</p>
375 <p>Since:·5.1.0</p>390 <p>Since:·5.1.0</p>
 391 <p>Examples:</p>
 392 <ul>
 393 <li><a
 394 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_video.c#L162">ex_video.c</a></li>
 395 </ul>
376 <h1·id="al_start_video_with_voice">al_start_video_with_voice</h1>396 <h1·id="al_start_video_with_voice">al_start_video_with_voice</h1>
377 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_start_video_with_voice<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">,</span>·ALLEGRO_VOICE·<span·class="op">*</span>voice<span·class="op">)</span></span></code></pre></div>397 <div·class="sourceCode"·id="cb13"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb13-1"><a·href="#cb13-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_start_video_with_voice<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">,</span>·ALLEGRO_VOICE·<span·class="op">*</span>voice<span·class="op">)</span></span></code></pre></div>
378 <p><a398 <p><a
379 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L179">Source399 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L179">Source
380 Code</a></p>400 Code</a></p>
381 <p>Like·<a·href="video.html#al_start_video">al_start_video</a>·but·audio401 <p>Like·<a·href="video.html#al_start_video">al_start_video</a>·but·audio
382 is·routed·to·the·provided·voice.</p>402 is·routed·to·the·provided·voice.</p>
Offset 386, 65 lines modifiedOffset 406, 100 lines modified
386 <p><a406 <p><a
387 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L156">Source407 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L156">Source
388 Code</a></p>408 Code</a></p>
389 <p>Get·an·event·source·for·the·video.·The·possible·events·are·described409 <p>Get·an·event·source·for·the·video.·The·possible·events·are·described
390 under·<a410 under·<a
391 href="video.html#allegro_video_event_type">ALLEGRO_VIDEO_EVENT_TYPE</a>.</p>411 href="video.html#allegro_video_event_type">ALLEGRO_VIDEO_EVENT_TYPE</a>.</p>
392 <p>Since:·5.1.0</p>412 <p>Since:·5.1.0</p>
 413 <p>Examples:</p>
 414 <ul>
 415 <li><a
 416 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_video.c#L157">ex_video.c</a></li>
 417 </ul>
393 <h1·id="al_set_video_playing">al_set_video_playing</h1>418 <h1·id="al_set_video_playing">al_set_video_playing</h1>
394 <div·class="sourceCode"·id="cb15"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb15-1"><a·href="#cb15-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_video_playing<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">,</span>·<span·class="dt">bool</span>·play<span·class="op">)</span></span></code></pre></div>419 <div·class="sourceCode"·id="cb15"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb15-1"><a·href="#cb15-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">void</span>·al_set_video_playing<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">,</span>·<span·class="dt">bool</span>·play<span·class="op">)</span></span></code></pre></div>
395 <p><a420 <p><a
396 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L190">Source421 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L190">Source
397 Code</a></p>422 Code</a></p>
398 <p>Paused·or·resumes·playback.</p>423 <p>Paused·or·resumes·playback.</p>
399 <p>Since:·5.1.12</p>424 <p>Since:·5.1.12</p>
 425 <p>Examples:</p>
 426 <ul>
 427 <li><a
 428 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_video.c#L177">ex_video.c</a></li>
 429 </ul>
400 <h1·id="al_is_video_playing">al_is_video_playing</h1>430 <h1·id="al_is_video_playing">al_is_video_playing</h1>
401 <div·class="sourceCode"·id="cb16"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb16-1"><a·href="#cb16-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_video_playing<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">)</span></span></code></pre></div>431 <div·class="sourceCode"·id="cb16"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb16-1"><a·href="#cb16-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">bool</span>·al_is_video_playing<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">)</span></span></code></pre></div>
402 <p><a432 <p><a
403 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L202">Source433 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L202">Source
404 Code</a></p>434 Code</a></p>
405 <p>Returns·true·if·the·video·is·currently·playing.</p>435 <p>Returns·true·if·the·video·is·currently·playing.</p>
406 <p>Since:·5.1.12</p>436 <p>Since:·5.1.12</p>
 437 <p>Examples:</p>
 438 <ul>
 439 <li><a
 440 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_video.c#L74">ex_video.c</a></li>
 441 </ul>
407 <h1·id="al_get_video_audio_rate">al_get_video_audio_rate</h1>442 <h1·id="al_get_video_audio_rate">al_get_video_audio_rate</h1>
408 <div·class="sourceCode"·id="cb17"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb17-1"><a·href="#cb17-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">double</span>·al_get_video_audio_rate<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">)</span></span></code></pre></div>443 <div·class="sourceCode"·id="cb17"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb17-1"><a·href="#cb17-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">double</span>·al_get_video_audio_rate<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">)</span></span></code></pre></div>
409 <p><a444 <p><a
410 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L243">Source445 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L243">Source
411 Code</a></p>446 Code</a></p>
412 <p>Returns·the·audio·rate·of·the·video,·in·Hz.</p>447 <p>Returns·the·audio·rate·of·the·video,·in·Hz.</p>
413 <p>Since:·5.1.0</p>448 <p>Since:·5.1.0</p>
 449 <p>Examples:</p>
 450 <ul>
 451 <li><a
 452 href="https://github.com/liballeg/allegro5/blob/master/examples/ex_video.c#L72">ex_video.c</a></li>
 453 </ul>
414 <h1·id="al_get_video_fps">al_get_video_fps</h1>454 <h1·id="al_get_video_fps">al_get_video_fps</h1>
415 <div·class="sourceCode"·id="cb18"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb18-1"><a·href="#cb18-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">double</span>·al_get_video_fps<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">)</span></span></code></pre></div>455 <div·class="sourceCode"·id="cb18"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb18-1"><a·href="#cb18-1"·aria-hidden="true"·tabindex="-1"></a><span·class="dt">double</span>·al_get_video_fps<span·class="op">(</span>ALLEGRO_VIDEO·<span·class="op">*</span>video<span·class="op">)</span></span></code></pre></div>
416 <p><a456 <p><a
417 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L251">Source457 href="https://github.com/liballeg/allegro5/blob/master/addons/video/video.c#L251">Source
418 Code</a></p>458 Code</a></p>
419 <p>Returns·the·speed·of·the·video·in·frames·per·second.·Often·this·will459 <p>Returns·the·speed·of·the·video·in·frames·per·second.·Often·this·will
420 not·be·an·integer·value.</p>460 not·be·an·integer·value.</p>
Max diff block lines reached; 5730/13966 bytes (41.03%) of diff not shown.
7.09 KB
html2text {}
    
Offset 109, 14 lines modifiedOffset 109, 16 lines modified
109 ······in·sync.109 ······in·sync.
110 Since:·5.1.11110 Since:·5.1.11
111 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*111 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8in\x8ni\x8it\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
112 bool·al_init_video_addon(void)112 bool·al_init_video_addon(void)
113 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e113 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
114 Initializes·the·video·addon.114 Initializes·the·video·addon.
115 Since:·5.1.12115 Since:·5.1.12
 116 Examples:
 117 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
116 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*118 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8ad\x8dd\x8do\x8on\x8n_\x8_i\x8in\x8ni\x8it\x8ti\x8ia\x8al\x8li\x8iz\x8ze\x8ed\x8d·*\x8**\x8**\x8**\x8**\x8**\x8*
117 bool·al_is_video_addon_initialized(void)119 bool·al_is_video_addon_initialized(void)
118 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e120 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
119 Returns·true·if·the·video·addon·is·initialized,·otherwise·returns·false.121 Returns·true·if·the·video·addon·is·initialized,·otherwise·returns·false.
120 Since:·5.2.6122 Since:·5.2.6
121 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*123 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8sh\x8hu\x8ut\x8td\x8do\x8ow\x8wn\x8n_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8ad\x8dd\x8do\x8on\x8n·*\x8**\x8**\x8**\x8**\x8**\x8*
122 void·al_shutdown_video_addon(void)124 void·al_shutdown_video_addon(void)
Offset 132, 14 lines modifiedOffset 134, 16 lines modified
132 Since:·5.1.12134 Since:·5.1.12
133 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_o\x8op\x8pe\x8en\x8n_\x8_v\x8vi\x8id\x8de\x8eo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*135 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_o\x8op\x8pe\x8en\x8n_\x8_v\x8vi\x8id\x8de\x8eo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*
134 ALLEGRO_VIDEO·*al_open_video(char·const·*filename)136 ALLEGRO_VIDEO·*al_open_video(char·const·*filename)
135 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e137 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
136 Reads·a·video·file.·This·does·not·start·playing·yet·but·reads·the·meta·info·so138 Reads·a·video·file.·This·does·not·start·playing·yet·but·reads·the·meta·info·so
137 you·can·query·e.g. the·size·or·audio·rate.139 you·can·query·e.g. the·size·or·audio·rate.
138 Since:·5.1.0140 Since:·5.1.0
 141 Examples:
 142 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
139 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8id\x8de\x8en\x8nt\x8ti\x8if\x8fy\x8y_\x8_v\x8vi\x8id\x8de\x8eo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*143 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8id\x8de\x8en\x8nt\x8ti\x8if\x8fy\x8y_\x8_v\x8vi\x8id\x8de\x8eo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*
140 char·const·*al_identify_video(char·const·*filename)144 char·const·*al_identify_video(char·const·*filename)
141 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e145 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
142 This·works·exactly·as·_\x8a_\x8l_\x8__\x8i_\x8d_\x8e_\x8n_\x8t_\x8i_\x8f_\x8y_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8f·but·you·specify·the·filename·of·the146 This·works·exactly·as·_\x8a_\x8l_\x8__\x8i_\x8d_\x8e_\x8n_\x8t_\x8i_\x8f_\x8y_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8f·but·you·specify·the·filename·of·the
143 file·for·which·to·detect·the·type·and·not·a·file·handle.·The·extension,·if·any,147 file·for·which·to·detect·the·type·and·not·a·file·handle.·The·extension,·if·any,
144 of·the·passed·filename·is·not·taken·into·account·-·only·the·file·contents.148 of·the·passed·filename·is·not·taken·into·account·-·only·the·file·contents.
145 Since:·5.2.8149 Since:·5.2.8
Offset 157, 67 lines modifiedOffset 161, 85 lines modified
157 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8i_\x8d_\x8e_\x8n_\x8t_\x8i_\x8f_\x8y_\x8__\x8v_\x8i_\x8d_\x8e_\x8o161 See·also:·_\x8a_\x8l_\x8__\x8i_\x8n_\x8i_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8a_\x8d_\x8d_\x8o_\x8n,·_\x8a_\x8l_\x8__\x8i_\x8d_\x8e_\x8n_\x8t_\x8i_\x8f_\x8y_\x8__\x8v_\x8i_\x8d_\x8e_\x8o
158 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cl\x8lo\x8os\x8se\x8e_\x8_v\x8vi\x8id\x8de\x8eo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*162 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_c\x8cl\x8lo\x8os\x8se\x8e_\x8_v\x8vi\x8id\x8de\x8eo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*
159 void·al_close_video(ALLEGRO_VIDEO·*video)163 void·al_close_video(ALLEGRO_VIDEO·*video)
160 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e164 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
161 Closes·the·video·and·frees·all·allocated·resources.·The·video·pointer·is165 Closes·the·video·and·frees·all·allocated·resources.·The·video·pointer·is
162 invalid·after·the·function·returns.166 invalid·after·the·function·returns.
163 Since:·5.1.0167 Since:·5.1.0
 168 Examples:
 169 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
164 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8ta\x8ar\x8rt\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*170 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8ta\x8ar\x8rt\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o·*\x8**\x8**\x8**\x8**\x8**\x8*
165 void·al_start_video(ALLEGRO_VIDEO·*video,·ALLEGRO_MIXER·*mixer)171 void·al_start_video(ALLEGRO_VIDEO·*video,·ALLEGRO_MIXER·*mixer)
166 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e172 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
167 Starts·playing·the·video·from·the·beginning.173 Starts·playing·the·video·from·the·beginning.
168 Since:·5.1.0174 Since:·5.1.0
 175 Examples:
 176 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
169 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8ta\x8ar\x8rt\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_w\x8wi\x8it\x8th\x8h_\x8_v\x8vo\x8oi\x8ic\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*177 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8st\x8ta\x8ar\x8rt\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_w\x8wi\x8it\x8th\x8h_\x8_v\x8vo\x8oi\x8ic\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
170 void·al_start_video_with_voice(ALLEGRO_VIDEO·*video,·ALLEGRO_VOICE·*voice)178 void·al_start_video_with_voice(ALLEGRO_VIDEO·*video,·ALLEGRO_VOICE·*voice)
171 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e179 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
172 Like·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o·but·audio·is·routed·to·the·provided·voice.180 Like·_\x8a_\x8l_\x8__\x8s_\x8t_\x8a_\x8r_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o·but·audio·is·routed·to·the·provided·voice.
173 Since:·5.1.0181 Since:·5.1.0
174 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*182 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_e\x8ev\x8ve\x8en\x8nt\x8t_\x8_s\x8so\x8ou\x8ur\x8rc\x8ce\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
175 ALLEGRO_EVENT_SOURCE·*al_get_video_event_source(ALLEGRO_VIDEO·*video)183 ALLEGRO_EVENT_SOURCE·*al_get_video_event_source(ALLEGRO_VIDEO·*video)
176 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e184 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
177 Get·an·event·source·for·the·video.·The·possible·events·are·described·under185 Get·an·event·source·for·the·video.·The·possible·events·are·described·under
178 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8V_\x8I_\x8D_\x8E_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E.186 _\x8A_\x8L_\x8L_\x8E_\x8G_\x8R_\x8O_\x8__\x8V_\x8I_\x8D_\x8E_\x8O_\x8__\x8E_\x8V_\x8E_\x8N_\x8T_\x8__\x8T_\x8Y_\x8P_\x8E.
179 Since:·5.1.0187 Since:·5.1.0
 188 Examples:
 189 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
180 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_p\x8pl\x8la\x8ay\x8yi\x8in\x8ng\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*190 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_s\x8se\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_p\x8pl\x8la\x8ay\x8yi\x8in\x8ng\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*
181 void·al_set_video_playing(ALLEGRO_VIDEO·*video,·bool·play)191 void·al_set_video_playing(ALLEGRO_VIDEO·*video,·bool·play)
182 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e192 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
183 Paused·or·resumes·playback.193 Paused·or·resumes·playback.
184 Since:·5.1.12194 Since:·5.1.12
 195 Examples:
 196 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
185 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_p\x8pl\x8la\x8ay\x8yi\x8in\x8ng\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*197 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_i\x8is\x8s_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_p\x8pl\x8la\x8ay\x8yi\x8in\x8ng\x8g·*\x8**\x8**\x8**\x8**\x8**\x8*
186 bool·al_is_video_playing(ALLEGRO_VIDEO·*video)198 bool·al_is_video_playing(ALLEGRO_VIDEO·*video)
187 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e199 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
188 Returns·true·if·the·video·is·currently·playing.200 Returns·true·if·the·video·is·currently·playing.
189 Since:·5.1.12201 Since:·5.1.12
 202 Examples:
 203 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
190 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8au\x8ud\x8di\x8io\x8o_\x8_r\x8ra\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*204 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_a\x8au\x8ud\x8di\x8io\x8o_\x8_r\x8ra\x8at\x8te\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
191 double·al_get_video_audio_rate(ALLEGRO_VIDEO·*video)205 double·al_get_video_audio_rate(ALLEGRO_VIDEO·*video)
192 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e206 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
193 Returns·the·audio·rate·of·the·video,·in·Hz.207 Returns·the·audio·rate·of·the·video,·in·Hz.
194 Since:·5.1.0208 Since:·5.1.0
 209 Examples:
 210 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
195 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_f\x8fp\x8ps\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*211 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_f\x8fp\x8ps\x8s·*\x8**\x8**\x8**\x8**\x8**\x8*
196 double·al_get_video_fps(ALLEGRO_VIDEO·*video)212 double·al_get_video_fps(ALLEGRO_VIDEO·*video)
197 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e213 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
198 Returns·the·speed·of·the·video·in·frames·per·second.·Often·this·will·not·be·an214 Returns·the·speed·of·the·video·in·frames·per·second.·Often·this·will·not·be·an
199 integer·value.215 integer·value.
200 Since:·5.1.0216 Since:·5.1.0
 217 Examples:
 218 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
201 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_s\x8sc\x8ca\x8al\x8le\x8ed\x8d_\x8_w\x8wi\x8id\x8dt\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*219 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_s\x8sc\x8ca\x8al\x8le\x8ed\x8d_\x8_w\x8wi\x8id\x8dt\x8th\x8h·*\x8**\x8**\x8**\x8**\x8**\x8*
202 float·al_get_video_scaled_width(ALLEGRO_VIDEO·*video)220 float·al_get_video_scaled_width(ALLEGRO_VIDEO·*video)
203 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e221 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
204 Returns·the·width·with·which·the·video·frame·should·be·drawn.·Videos·often·do222 Returns·the·width·with·which·the·video·frame·should·be·drawn.·Videos·often·do
205 not·use·square·pixels,·so·this·will·may·return·a·value·larger·than·the·width·of223 not·use·square·pixels,·so·this·will·may·return·a·value·larger·than·the·width·of
206 the·frame·bitmap.224 the·frame·bitmap.
207 Since:·5.1.12225 Since:·5.1.12
208 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8f_\x8r_\x8a_\x8m_\x8e226 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8f_\x8r_\x8a_\x8m_\x8e
 227 Examples:
 228 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
209 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_s\x8sc\x8ca\x8al\x8le\x8ed\x8d_\x8_h\x8he\x8ei\x8ig\x8gh\x8ht\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*229 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_s\x8sc\x8ca\x8al\x8le\x8ed\x8d_\x8_h\x8he\x8ei\x8ig\x8gh\x8ht\x8t·*\x8**\x8**\x8**\x8**\x8**\x8*
210 float·al_get_video_scaled_height(ALLEGRO_VIDEO·*video)230 float·al_get_video_scaled_height(ALLEGRO_VIDEO·*video)
211 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e231 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
212 Returns·the·height·with·which·the·video·frame·should·be·drawn.·Videos·often·do232 Returns·the·height·with·which·the·video·frame·should·be·drawn.·Videos·often·do
213 not·use·square·pixels,·so·this·will·may·return·a·value·larger·than·the·height233 not·use·square·pixels,·so·this·will·may·return·a·value·larger·than·the·height
214 of·the·frame·bitmap.234 of·the·frame·bitmap.
215 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8f_\x8r_\x8a_\x8m_\x8e235 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8f_\x8r_\x8a_\x8m_\x8e
216 Since:·5.1.12236 Since:·5.1.12
 237 Examples:
 238 ····*·_\x8e_\x8x_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8._\x8c
217 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_f\x8fr\x8ra\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*239 *\x8**\x8**\x8**\x8**\x8**\x8*·a\x8al\x8l_\x8_g\x8ge\x8et\x8t_\x8_v\x8vi\x8id\x8de\x8eo\x8o_\x8_f\x8fr\x8ra\x8am\x8me\x8e·*\x8**\x8**\x8**\x8**\x8**\x8*
218 ALLEGRO_BITMAP·*al_get_video_frame(ALLEGRO_VIDEO·*video)240 ALLEGRO_BITMAP·*al_get_video_frame(ALLEGRO_VIDEO·*video)
219 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e241 _\x8S_\x8o_\x8u_\x8r_\x8c_\x8e_\x8·_\x8C_\x8o_\x8d_\x8e
220 Returns·the·current·video·frame.·The·bitmap·is·owned·by·the·video·so·do·not242 Returns·the·current·video·frame.·The·bitmap·is·owned·by·the·video·so·do·not
221 attempt·to·free·it.·The·bitmap·will·stay·valid·until·the·next·call·to243 attempt·to·free·it.·The·bitmap·will·stay·valid·until·the·next·call·to
222 al_get_video_frame.244 al_get_video_frame.
223 Videos·often·do·not·use·square·pixels·so·the·recommended·way·to·draw·a·video245 Videos·often·do·not·use·square·pixels·so·the·recommended·way·to·draw·a·video
Offset 227, 21 lines modifiedOffset 249, 27 lines modified
227 float·sw·=·al_get_bitmap_width(frame);249 float·sw·=·al_get_bitmap_width(frame);
228 float·sh·=·al_get_bitmap_height(frame);250 float·sh·=·al_get_bitmap_height(frame);
229 float·dw·=·scale·*·al_get_video_scaled_width(video);251 float·dw·=·scale·*·al_get_video_scaled_width(video);
230 float·dh·=·scale·*·al_get_video_scaled_height(video);252 float·dh·=·scale·*·al_get_video_scaled_height(video);
231 al_draw_scaled_bitmap(frame,·0,·0,·sw,·sh,·0,·0,·dw,·dh,·0);253 al_draw_scaled_bitmap(frame,·0,·0,·sw,·sh,·0,·0,·dw,·dh,·0);
232 Since:·5.1.0254 Since:·5.1.0
233 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8s_\x8c_\x8a_\x8l_\x8e_\x8d_\x8__\x8w_\x8i_\x8d_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8s_\x8c_\x8a_\x8l_\x8e_\x8d_\x8__\x8h_\x8e_\x8i_\x8g_\x8h_\x8t255 See·also:·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8s_\x8c_\x8a_\x8l_\x8e_\x8d_\x8__\x8w_\x8i_\x8d_\x8t_\x8h,·_\x8a_\x8l_\x8__\x8g_\x8e_\x8t_\x8__\x8v_\x8i_\x8d_\x8e_\x8o_\x8__\x8s_\x8c_\x8a_\x8l_\x8e_\x8d_\x8__\x8h_\x8e_\x8i_\x8g_\x8h_\x8t
Max diff block lines reached; 808/7240 bytes (11.16%) of diff not shown.
426 B
./usr/share/man/man3/ALLEGRO_CONFIG.3alleg5.gz
334 B
ALLEGRO_CONFIG.3alleg5
    
Offset 3, 12 lines modifiedOffset 3, 10 lines modified
3 .TH·"ALLEGRO_CONFIG"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_CONFIG"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_CONFIG·\-·Allegro·5·API5 ALLEGRO_CONFIG·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_CONFIG·ALLEGRO_CONFIG; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·abstract·configuration·structure.12 An·abstract·configuration·structure.
605 B
./usr/share/man/man3/ALLEGRO_CONFIG_ENTRY.3alleg5.gz
501 B
ALLEGRO_CONFIG_ENTRY.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"ALLEGRO_CONFIG_ENTRY"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_CONFIG_ENTRY"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_CONFIG_ENTRY·\-·Allegro·5·API5 ALLEGRO_CONFIG_ENTRY·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·opaque·structure·used·for·iterating·across·entries·in·a·configuration12 An·opaque·structure·used·for·iterating·across·entries·in·a·configuration
14 section.13 section.
15 .SH·SEE·ALSO14 .SH·SEE·ALSO
16 al_get_first_config_entry(3alleg5),·al_get_next_config_entry(3alleg5)15 al_get_first_config_entry(3alleg5),·al_get_next_config_entry(3alleg5)
629 B
./usr/share/man/man3/ALLEGRO_CONFIG_SECTION.3alleg5.gz
521 B
ALLEGRO_CONFIG_SECTION.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_CONFIG_SECTION"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_CONFIG_SECTION"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_CONFIG_SECTION·\-·Allegro·5·API5 ALLEGRO_CONFIG_SECTION·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·opaque·structure·used·for·iterating·across·sections·in·a12 An·opaque·structure·used·for·iterating·across·sections·in·a
14 configuration·structure.13 configuration·structure.
15 .SH·SEE·ALSO14 .SH·SEE·ALSO
16 al_get_first_config_section(3alleg5),15 al_get_first_config_section(3alleg5),
17 al_get_next_config_section(3alleg5)16 al_get_next_config_section(3alleg5)
452 B
./usr/share/man/man3/ALLEGRO_DISPLAY.3alleg5.gz
358 B
ALLEGRO_DISPLAY.3alleg5
    
Offset 3, 12 lines modifiedOffset 3, 10 lines modified
3 .TH·"ALLEGRO_DISPLAY"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_DISPLAY"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_DISPLAY·\-·Allegro·5·API5 ALLEGRO_DISPLAY·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·opaque·type·representing·an·open·display·or·window.12 An·opaque·type·representing·an·open·display·or·window.
594 B
./usr/share/man/man3/ALLEGRO_EVENT.3alleg5.gz
504 B
ALLEGRO_EVENT.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_EVENT"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_EVENT"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_EVENT·\-·Allegro·5·API5 ALLEGRO_EVENT·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·union·ALLEGRO_EVENT·ALLEGRO_EVENT; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·ALLEGRO_EVENT·is·a·union·of·all·builtin·event·structures,·i.e.\·it·is12 An·ALLEGRO_EVENT·is·a·union·of·all·builtin·event·structures,·i.e.\·it·is
14 an·object·large·enough·to·hold·the·data·of·any·event·type.13 an·object·large·enough·to·hold·the·data·of·any·event·type.
15 All·events·have·the·following·fields·in·common:14 All·events·have·the·following·fields·in·common:
16 .TP15 .TP
17 type·(ALLEGRO_EVENT_TYPE)16 type·(ALLEGRO_EVENT_TYPE)
663 B
./usr/share/man/man3/ALLEGRO_EVENT_QUEUE.3alleg5.gz
561 B
ALLEGRO_EVENT_QUEUE.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_EVENT_QUEUE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_EVENT_QUEUE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_EVENT_QUEUE·\-·Allegro·5·API5 ALLEGRO_EVENT_QUEUE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_EVENT_QUEUE·ALLEGRO_EVENT_QUEUE; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·event·queue·holds·events·that·have·been·generated·by·event·sources12 An·event·queue·holds·events·that·have·been·generated·by·event·sources
14 that·are·registered·with·the·queue.13 that·are·registered·with·the·queue.
15 Events·are·stored·in·the·order·they·are·generated.14 Events·are·stored·in·the·order·they·are·generated.
16 Access·is·in·a·strictly·FIFO·(first\-in\-first\-out)·order.15 Access·is·in·a·strictly·FIFO·(first\-in\-first\-out)·order.
17 .SH·SEE·ALSO16 .SH·SEE·ALSO
671 B
./usr/share/man/man3/ALLEGRO_EVENT_SOURCE.3alleg5.gz
567 B
ALLEGRO_EVENT_SOURCE.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_EVENT_SOURCE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_EVENT_SOURCE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_EVENT_SOURCE·\-·Allegro·5·API5 ALLEGRO_EVENT_SOURCE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_EVENT_SOURCE·ALLEGRO_EVENT_SOURCE; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·event·source·is·any·object·which·can·generate·events.12 An·event·source·is·any·object·which·can·generate·events.
14 For·example,·an·ALLEGRO_DISPLAY·can·generate·events,·and·you·can·get·the13 For·example,·an·ALLEGRO_DISPLAY·can·generate·events,·and·you·can·get·the
15 ALLEGRO_EVENT_SOURCE·pointer·from·an·ALLEGRO_DISPLAY·with14 ALLEGRO_EVENT_SOURCE·pointer·from·an·ALLEGRO_DISPLAY·with
16 al_get_display_event_source(3alleg5).15 al_get_display_event_source(3alleg5).
17 .PP16 .PP
583 B
./usr/share/man/man3/ALLEGRO_EVENT_TYPE.3alleg5.gz
483 B
ALLEGRO_EVENT_TYPE.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"ALLEGRO_EVENT_TYPE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_EVENT_TYPE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_EVENT_TYPE·\-·Allegro·5·API5 ALLEGRO_EVENT_TYPE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·unsigned·int·ALLEGRO_EVENT_TYPE; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·integer·used·to·distinguish·between·different·types·of·events.12 An·integer·used·to·distinguish·between·different·types·of·events.
14 .SH·SEE·ALSO13 .SH·SEE·ALSO
15 ALLEGRO_EVENT(3alleg5),·ALLEGRO_GET_EVENT_TYPE(3alleg5),14 ALLEGRO_EVENT(3alleg5),·ALLEGRO_GET_EVENT_TYPE(3alleg5),
16 ALLEGRO_EVENT_TYPE_IS_USER(3alleg5)15 ALLEGRO_EVENT_TYPE_IS_USER(3alleg5)
614 B
./usr/share/man/man3/ALLEGRO_EVENT_TYPE_IS_USER.3alleg5.gz
498 B
ALLEGRO_EVENT_TYPE_IS_USER.3alleg5
    
Offset 3, 13 lines modifiedOffset 3, 11 lines modified
3 .TH·"ALLEGRO_EVENT_TYPE_IS_USER"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_EVENT_TYPE_IS_USER"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_EVENT_TYPE_IS_USER·\-·Allegro·5·API5 ALLEGRO_EVENT_TYPE_IS_USER·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 #define·ALLEGRO_EVENT_TYPE_IS_USER(t)········((t)·>=·512) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 A·macro·which·evaluates·to·true·if·the·event·type·is·not·a·builtin·event12 A·macro·which·evaluates·to·true·if·the·event·type·is·not·a·builtin·event
14 type,·i.e.\·one·of·those·described·in·ALLEGRO_EVENT_TYPE(3alleg5).13 type,·i.e.\·one·of·those·described·in·ALLEGRO_EVENT_TYPE(3alleg5).
471 B
./usr/share/man/man3/ALLEGRO_FILE.3alleg5.gz
383 B
ALLEGRO_FILE.3alleg5
    
Offset 3, 13 lines modifiedOffset 3, 11 lines modified
3 .TH·"ALLEGRO_FILE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_FILE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_FILE·\-·Allegro·5·API5 ALLEGRO_FILE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_FILE·ALLEGRO_FILE; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·opaque·object·representing·an·open·file.12 An·opaque·object·representing·an·open·file.
14 This·could·be·a·real·file·on·disk·or·a·virtual·file.13 This·could·be·a·real·file·on·disk·or·a·virtual·file.
610 B
./usr/share/man/man3/ALLEGRO_FILE_INTERFACE.3alleg5.gz
502 B
ALLEGRO_FILE_INTERFACE.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_FILE_INTERFACE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_FILE_INTERFACE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_FILE_INTERFACE·\-·Allegro·5·API5 ALLEGRO_FILE_INTERFACE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_FILE_INTERFACE 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 A·structure·containing·function·pointers·to·handle·a·type·of12 A·structure·containing·function·pointers·to·handle·a·type·of
14 \[lq]file\[rq],·real·or·virtual.13 \[lq]file\[rq],·real·or·virtual.
15 See·the·full·discussion·in·al_set_new_file_interface(3alleg5).14 See·the·full·discussion·in·al_set_new_file_interface(3alleg5).
16 .PP15 .PP
17 The·fields·are:16 The·fields·are:
512 B
./usr/share/man/man3/ALLEGRO_FILE_MODE.3alleg5.gz
414 B
ALLEGRO_FILE_MODE.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_FILE_MODE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_FILE_MODE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_FILE_MODE·\-·Allegro·5·API5 ALLEGRO_FILE_MODE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·enum·ALLEGRO_FILE_MODE 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Filesystem·modes/types12 Filesystem·modes/types
14 .IP·\[bu]·213 .IP·\[bu]·2
15 ALLEGRO_FILEMODE_READ·\-·Readable14 ALLEGRO_FILEMODE_READ·\-·Readable
16 .IP·\[bu]·215 .IP·\[bu]·2
17 ALLEGRO_FILEMODE_WRITE·\-·Writable16 ALLEGRO_FILEMODE_WRITE·\-·Writable
675 B
./usr/share/man/man3/ALLEGRO_FOR_EACH_FS_ENTRY_RESULT.3alleg5.gz
547 B
ALLEGRO_FOR_EACH_FS_ENTRY_RESULT.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_FOR_EACH_FS_ENTRY_RESULT"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_FOR_EACH_FS_ENTRY_RESULT"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·\-·Allegro·5·API5 ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·enum·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·{ 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Return·values·for·the·callbacks·of·al_for_each_fs_entry(3alleg5)·and·for12 Return·values·for·the·callbacks·of·al_for_each_fs_entry(3alleg5)·and·for
14 that·function·itself.13 that·function·itself.
15 .IP·\[bu]·214 .IP·\[bu]·2
16 ALLEGRO_FOR_EACH_FS_ENTRY_ERROR·\-·An·error·ocurred.15 ALLEGRO_FOR_EACH_FS_ENTRY_ERROR·\-·An·error·ocurred.
17 .IP·\[bu]·216 .IP·\[bu]·2
564 B
./usr/share/man/man3/ALLEGRO_FS_ENTRY.3alleg5.gz
468 B
ALLEGRO_FS_ENTRY.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"ALLEGRO_FS_ENTRY"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_FS_ENTRY"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_FS_ENTRY·\-·Allegro·5·API5 ALLEGRO_FS_ENTRY·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Opaque·filesystem·entry·object.12 Opaque·filesystem·entry·object.
14 Represents·a·file·or·a·directory·(check·with13 Represents·a·file·or·a·directory·(check·with
15 al_get_fs_entry_mode(3alleg5)).14 al_get_fs_entry_mode(3alleg5)).
16 There·are·no·user·accessible·member·variables.15 There·are·no·user·accessible·member·variables.
578 B
./usr/share/man/man3/ALLEGRO_FS_INTERFACE.3alleg5.gz
474 B
ALLEGRO_FS_INTERFACE.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_FS_INTERFACE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_FS_INTERFACE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_FS_INTERFACE·\-·Allegro·5·API5 ALLEGRO_FS_INTERFACE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_FS_INTERFACE·ALLEGRO_FS_INTERFACE; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 The·available·functions·you·can·provide·for·a·filesystem.12 The·available·functions·you·can·provide·for·a·filesystem.
14 They·are:13 They·are:
15 .IP14 .IP
16 .EX15 .EX
17 ···ALLEGRO_FS_ENTRY·*··fs_create_entry···(const·char·*path);16 ···ALLEGRO_FS_ENTRY·*··fs_create_entry···(const·char·*path);
620 B
./usr/share/man/man3/ALLEGRO_GET_EVENT_TYPE.3alleg5.gz
512 B
ALLEGRO_GET_EVENT_TYPE.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_GET_EVENT_TYPE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_GET_EVENT_TYPE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_GET_EVENT_TYPE·\-·Allegro·5·API5 ALLEGRO_GET_EVENT_TYPE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 #define·ALLEGRO_GET_EVENT_TYPE(a,·b,·c,·d)···AL_ID(a,·b,·c,·d) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Make·an·event·type·identifier,·which·is·a·32\-bit·integer.12 Make·an·event·type·identifier,·which·is·a·32\-bit·integer.
14 Usually,·but·not·necessarily,·this·will·be·made·from·four·8\-bit13 Usually,·but·not·necessarily,·this·will·be·made·from·four·8\-bit
15 character·codes,·for·example:14 character·codes,·for·example:
16 .IP15 .IP
17 .EX16 .EX
656 B
./usr/share/man/man3/ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE.3alleg5.gz
526 B
ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·\-·Allegro·5·API5 ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 #define·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·255 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·is·the·maximum·size·of·the·title·that·can·be·set·with12 This·is·the·maximum·size·of·the·title·that·can·be·set·with
14 al_set_new_window_title(3alleg5).13 al_set_new_window_title(3alleg5).
15 .SH·SEE·ALSO14 .SH·SEE·ALSO
16 al_set_new_window_title(3alleg5)15 al_set_new_window_title(3alleg5)
17 .SH·SINCE16 .SH·SINCE
511 B
./usr/share/man/man3/ALLEGRO_SEEK.3alleg5.gz
423 B
ALLEGRO_SEEK.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_SEEK"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_SEEK"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_SEEK·\-·Allegro·5·API5 ALLEGRO_SEEK·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·enum·ALLEGRO_SEEK 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 .IP·\[bu]·212 .IP·\[bu]·2
14 ALLEGRO_SEEK_SET·\-·seek·relative·to·beginning·of·file13 ALLEGRO_SEEK_SET·\-·seek·relative·to·beginning·of·file
15 .IP·\[bu]·214 .IP·\[bu]·2
16 ALLEGRO_SEEK_CUR·\-·seek·relative·to·current·file·position15 ALLEGRO_SEEK_CUR·\-·seek·relative·to·current·file·position
17 .IP·\[bu]·216 .IP·\[bu]·2
570 B
./usr/share/man/man3/ALLEGRO_USER_EVENT.3alleg5.gz
470 B
ALLEGRO_USER_EVENT.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"ALLEGRO_USER_EVENT"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"ALLEGRO_USER_EVENT"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 ALLEGRO_USER_EVENT·\-·Allegro·5·API5 ALLEGRO_USER_EVENT·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·struct·ALLEGRO_USER_EVENT·ALLEGRO_USER_EVENT; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 An·event·structure·that·can·be·emitted·by·user·event·sources.12 An·event·structure·that·can·be·emitted·by·user·event·sources.
14 These·are·the·public·fields:13 These·are·the·public·fields:
15 .IP·\[bu]·214 .IP·\[bu]·2
16 ALLEGRO_EVENT_SOURCE·*source;15 ALLEGRO_EVENT_SOURCE·*source;
17 .IP·\[bu]·216 .IP·\[bu]·2
759 B
./usr/share/man/man3/al_acknowledge_drawing_halt.3alleg5.gz
641 B
al_acknowledge_drawing_halt.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_acknowledge_drawing_halt"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_acknowledge_drawing_halt"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_acknowledge_drawing_halt·\-·Allegro·5·API5 al_acknowledge_drawing_halt·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_acknowledge_drawing_halt(ALLEGRO_DISPLAY·*display) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Call·this·in·response·to·the·ALLEGRO_EVENT_DISPLAY_HALT_DRAWING(3alleg5)12 Call·this·in·response·to·the·ALLEGRO_EVENT_DISPLAY_HALT_DRAWING(3alleg5)
14 event.13 event.
15 This·is·currently·necessary·for·Android·and·iOS·as·you·are·not·allowed14 This·is·currently·necessary·for·Android·and·iOS·as·you·are·not·allowed
16 to·draw·to·your·display·while·it·is·not·being·shown.15 to·draw·to·your·display·while·it·is·not·being·shown.
17 If·you·do·not·call·this·function·to·let·the·operating·system·know·that16 If·you·do·not·call·this·function·to·let·the·operating·system·know·that
609 B
./usr/share/man/man3/al_acknowledge_drawing_resume.3alleg5.gz
487 B
al_acknowledge_drawing_resume.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_acknowledge_drawing_resume"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_acknowledge_drawing_resume"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_acknowledge_drawing_resume·\-·Allegro·5·API5 al_acknowledge_drawing_resume·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_acknowledge_drawing_resume(ALLEGRO_DISPLAY·*display) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Call·this·in·response·to·the12 Call·this·in·response·to·the
14 ALLEGRO_EVENT_DISPLAY_RESUME_DRAWING(3alleg5)·event.13 ALLEGRO_EVENT_DISPLAY_RESUME_DRAWING(3alleg5)·event.
15 .SH·SINCE14 .SH·SINCE
16 5.1.115 5.1.1
17 .SH·SEE·ALSO16 .SH·SEE·ALSO
708 B
./usr/share/man/man3/al_apply_window_constraints.3alleg5.gz
590 B
al_apply_window_constraints.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_apply_window_constraints"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_apply_window_constraints"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_apply_window_constraints·\-·Allegro·5·API5 al_apply_window_constraints·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_apply_window_constraints(ALLEGRO_DISPLAY·*display,·bool·onoff) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Enable·or·disable·previously·set·constraints·by12 Enable·or·disable·previously·set·constraints·by
14 al_set_window_constraints(3alleg5)·function.13 al_set_window_constraints(3alleg5)·function.
15 .PP14 .PP
16 If·enabled,·the·specified·display·will·be·automatically·resized·to·new15 If·enabled,·the·specified·display·will·be·automatically·resized·to·new
17 sizes·to·conform·constraints·in·next·cases:16 sizes·to·conform·constraints·in·next·cases:
627 B
./usr/share/man/man3/al_fixacos.3alleg5.gz
543 B
al_fixacos.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixacos"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixacos"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixacos·\-·Allegro·5·API5 al_fixacos·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixacos(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·function·finds·the·inverse·cosine·of·a·value·using·a·lookup·table.12 This·function·finds·the·inverse·cosine·of·a·value·using·a·lookup·table.
14 The·input·must·be·a·fixed·point·value.13 The·input·must·be·a·fixed·point·value.
15 The·inverse·cosine·is·defined·only·in·the·domain·from·\-1·to·1.14 The·inverse·cosine·is·defined·only·in·the·domain·from·\-1·to·1.
16 Outside·of·this·input·range,·the·function·will·set·Allegro\[cq]s·errno15 Outside·of·this·input·range,·the·function·will·set·Allegro\[cq]s·errno
17 to·EDOM·and·return·zero.16 to·EDOM·and·return·zero.
644 B
./usr/share/man/man3/al_fixadd.3alleg5.gz
562 B
al_fixadd.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixadd"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixadd"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixadd·\-·Allegro·5·API5 al_fixadd·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixadd(al_fixed·x,·al_fixed·y); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Although·fixed·point·numbers·can·be·added·with·the·normal·\f[CR]+\f[R]12 Although·fixed·point·numbers·can·be·added·with·the·normal·\f[CR]+\f[R]
14 integer·operator,·that·doesn\[cq]t·provide·any·protection·against13 integer·operator,·that·doesn\[cq]t·provide·any·protection·against
15 overflow.14 overflow.
16 If·overflow·is·a·problem,·you·should·use·this·function·instead.15 If·overflow·is·a·problem,·you·should·use·this·function·instead.
17 It·is·slower·than·using·integer·operators,·but·if·an·overflow·occurs·it16 It·is·slower·than·using·integer·operators,·but·if·an·overflow·occurs·it
629 B
./usr/share/man/man3/al_fixasin.3alleg5.gz
545 B
al_fixasin.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixasin"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixasin"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixasin·\-·Allegro·5·API5 al_fixasin·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixasin(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·function·finds·the·inverse·sine·of·a·value·using·a·lookup·table.12 This·function·finds·the·inverse·sine·of·a·value·using·a·lookup·table.
14 The·input·value·must·be·a·fixed·point·value.13 The·input·value·must·be·a·fixed·point·value.
15 The·inverse·sine·is·defined·only·in·the·domain·from·\-1·to·1.14 The·inverse·sine·is·defined·only·in·the·domain·from·\-1·to·1.
16 Outside·of·this·input·range,·the·function·will·set·Allegro\[cq]s·errno15 Outside·of·this·input·range,·the·function·will·set·Allegro\[cq]s·errno
17 to·EDOM·and·return·zero.16 to·EDOM·and·return·zero.
544 B
./usr/share/man/man3/al_fixatan.3alleg5.gz
460 B
al_fixatan.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixatan"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixatan"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixatan·\-·Allegro·5·API5 al_fixatan·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixatan(al_fixed·x) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·function·finds·the·inverse·tangent·of·a·value·using·a·lookup·table.12 This·function·finds·the·inverse·tangent·of·a·value·using·a·lookup·table.
14 The·input·must·be·a·fixed·point·value.13 The·input·must·be·a·fixed·point·value.
15 The·inverse·tangent·is·the·value·whose·tangent·is·\f[CR]x\f[R].14 The·inverse·tangent·is·the·value·whose·tangent·is·\f[CR]x\f[R].
16 .PP15 .PP
17 Example:16 Example:
672 B
./usr/share/man/man3/al_fixatan2.3alleg5.gz
586 B
al_fixatan2.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixatan2"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixatan2"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixatan2·\-·Allegro·5·API5 al_fixatan2·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixatan2(al_fixed·y,·al_fixed·x) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·is·a·fixed·point·version·of·the·libc·atan2()·routine.12 This·is·a·fixed·point·version·of·the·libc·atan2()·routine.
14 It·computes·the·arc·tangent·of·\f[CR]y·/·x\f[R],·but·the·signs·of·both13 It·computes·the·arc·tangent·of·\f[CR]y·/·x\f[R],·but·the·signs·of·both
15 arguments·are·used·to·determine·the·quadrant·of·the·result,·and14 arguments·are·used·to·determine·the·quadrant·of·the·result,·and
16 \f[CR]x\f[R]·is·permitted·to·be·zero.15 \f[CR]x\f[R]·is·permitted·to·be·zero.
17 This·function·is·useful·to·convert·Cartesian·coordinates·to·polar16 This·function·is·useful·to·convert·Cartesian·coordinates·to·polar
460 B
./usr/share/man/man3/al_fixceil.3alleg5.gz
376 B
al_fixceil.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixceil"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixceil"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixceil·\-·Allegro·5·API5 al_fixceil·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_fixceil(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Returns·the·smallest·integer·not·less·than·x.12 Returns·the·smallest·integer·not·less·than·x.
14 That·is,·it·rounds·towards·positive·infinity.13 That·is,·it·rounds·towards·positive·infinity.
15 .PP14 .PP
16 Example:15 Example:
17 .IP16 .IP
482 B
./usr/share/man/man3/al_fixcos.3alleg5.gz
400 B
al_fixcos.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixcos"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixcos"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixcos·\-·Allegro·5·API5 al_fixcos·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixcos(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·function·finds·the·cosine·of·a·value·using·a·lookup·table.12 This·function·finds·the·cosine·of·a·value·using·a·lookup·table.
14 The·input·value·must·be·a·fixed·point·binary·angle.13 The·input·value·must·be·a·fixed·point·binary·angle.
15 .PP14 .PP
16 Example:15 Example:
17 .IP16 .IP
662 B
./usr/share/man/man3/al_fixdiv.3alleg5.gz
580 B
al_fixdiv.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixdiv"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixdiv"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixdiv·\-·Allegro·5·API5 al_fixdiv·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixdiv(al_fixed·x,·al_fixed·y); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 A·fixed·point·value·can·be·divided·by·an·integer·with·the·normal12 A·fixed·point·value·can·be·divided·by·an·integer·with·the·normal
14 \f[CR]/\f[R]·operator.13 \f[CR]/\f[R]·operator.
15 To·divide·two·fixed·point·values,·though,·you·must·use·this·function.14 To·divide·two·fixed·point·values,·though,·you·must·use·this·function.
16 If·a·division·by·zero·occurs,·Allegro\[cq]s·errno·will·be·set·and·the15 If·a·division·by·zero·occurs,·Allegro\[cq]s·errno·will·be·set·and·the
17 maximum·possible·value·will·be·returned,·but·errno·is·not·cleared·if·the16 maximum·possible·value·will·be·returned,·but·errno·is·not·cleared·if·the
573 B
./usr/share/man/man3/al_fixed.3alleg5.gz
493 B
al_fixed.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixed"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixed"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixed·\-·Allegro·5·API5 al_fixed·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 typedef·int32_t·al_fixed; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 A·fixed·point·number.12 A·fixed·point·number.
14 .PP13 .PP
15 Allegro·provides·some·routines·for·working·with·fixed·point·numbers,·and14 Allegro·provides·some·routines·for·working·with·fixed·point·numbers,·and
16 defines·the·type·\f[CR]al_fixed\f[R]·to·be·a·signed·32\-bit·integer.15 defines·the·type·\f[CR]al_fixed\f[R]·to·be·a·signed·32\-bit·integer.
17 The·high·word·is·used·for·the·integer·part·and·the·low·word·for·the16 The·high·word·is·used·for·the·integer·part·and·the·low·word·for·the
470 B
./usr/share/man/man3/al_fixfloor.3alleg5.gz
384 B
al_fixfloor.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixfloor"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixfloor"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixfloor·\-·Allegro·5·API5 al_fixfloor·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_fixfloor(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Returns·the·greatest·integer·not·greater·than·x.12 Returns·the·greatest·integer·not·greater·than·x.
14 That·is,·it·rounds·towards·negative·infinity.13 That·is,·it·rounds·towards·negative·infinity.
15 .PP14 .PP
16 Example:15 Example:
17 .IP16 .IP
550 B
./usr/share/man/man3/al_fixhypot.3alleg5.gz
464 B
al_fixhypot.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"al_fixhypot"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixhypot"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixhypot·\-·Allegro·5·API5 al_fixhypot·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixhypot(al_fixed·x,·al_fixed·y) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Fixed·point·hypotenuse·(returns·the·square·root·of12 Fixed·point·hypotenuse·(returns·the·square·root·of
14 \f[CR]x*x·+·y*y\f[R]).13 \f[CR]x*x·+·y*y\f[R]).
15 This·should·be·better·than·calculating·the·formula·yourself·manually,14 This·should·be·better·than·calculating·the·formula·yourself·manually,
16 since·the·error·is·much·smaller.15 since·the·error·is·much·smaller.
628 B
./usr/share/man/man3/al_fixmul.3alleg5.gz
546 B
al_fixmul.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixmul"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixmul"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixmul·\-·Allegro·5·API5 al_fixmul·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixmul(al_fixed·x,·al_fixed·y); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 A·fixed·point·value·can·be·multiplied·or·divided·by·an·integer·with·the12 A·fixed·point·value·can·be·multiplied·or·divided·by·an·integer·with·the
14 normal·\f[CR]*\f[R]·and·\f[CR]/\f[R]·operators.13 normal·\f[CR]*\f[R]·and·\f[CR]/\f[R]·operators.
15 To·multiply·two·fixed·point·values,·though,·you·must·use·this·function.14 To·multiply·two·fixed·point·values,·though,·you·must·use·this·function.
16 .PP15 .PP
17 If·an·overflow·occurs,·Allegro\[cq]s·errno·will·be·set·and·the·maximum16 If·an·overflow·occurs,·Allegro\[cq]s·errno·will·be·set·and·the·maximum
480 B
./usr/share/man/man3/al_fixsin.3alleg5.gz
398 B
al_fixsin.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixsin"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixsin"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixsin·\-·Allegro·5·API5 al_fixsin·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixsin(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·function·finds·the·sine·of·a·value·using·a·lookup·table.12 This·function·finds·the·sine·of·a·value·using·a·lookup·table.
14 The·input·value·must·be·a·fixed·point·binary·angle.13 The·input·value·must·be·a·fixed·point·binary·angle.
15 .PP14 .PP
16 Example:15 Example:
17 .IP16 .IP
509 B
./usr/share/man/man3/al_fixsqrt.3alleg5.gz
425 B
al_fixsqrt.3alleg5
    
Offset 3, 14 lines modifiedOffset 3, 12 lines modified
3 .TH·"al_fixsqrt"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixsqrt"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixsqrt·\-·Allegro·5·API5 al_fixsqrt·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixsqrt(al_fixed·x) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·finds·out·the·non·negative·square·root·of·\f[CR]x\f[R].12 This·finds·out·the·non·negative·square·root·of·\f[CR]x\f[R].
14 If·\f[CR]x\f[R]·is·negative,·Allegro\[cq]s·errno·is·set·to·EDOM·and·the13 If·\f[CR]x\f[R]·is·negative,·Allegro\[cq]s·errno·is·set·to·EDOM·and·the
15 function·returns·zero.14 function·returns·zero.
650 B
./usr/share/man/man3/al_fixsub.3alleg5.gz
568 B
al_fixsub.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixsub"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixsub"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixsub·\-·Allegro·5·API5 al_fixsub·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixsub(al_fixed·x,·al_fixed·y); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Although·fixed·point·numbers·can·be·subtracted·with·the·normal12 Although·fixed·point·numbers·can·be·subtracted·with·the·normal
14 \f[CR]\-\f[R]·integer·operator,·that·doesn\[cq]t·provide·any·protection13 \f[CR]\-\f[R]·integer·operator,·that·doesn\[cq]t·provide·any·protection
15 against·overflow.14 against·overflow.
16 If·overflow·is·a·problem,·you·should·use·this·function·instead.15 If·overflow·is·a·problem,·you·should·use·this·function·instead.
17 It·is·slower·than·using·integer·operators,·but·if·an·overflow·occurs·it16 It·is·slower·than·using·integer·operators,·but·if·an·overflow·occurs·it
483 B
./usr/share/man/man3/al_fixtan.3alleg5.gz
401 B
al_fixtan.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixtan"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixtan"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixtan·\-·Allegro·5·API5 al_fixtan·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_fixtan(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·function·finds·the·tangent·of·a·value·using·a·lookup·table.12 This·function·finds·the·tangent·of·a·value·using·a·lookup·table.
14 The·input·value·must·be·a·fixed·point·binary·angle.13 The·input·value·must·be·a·fixed·point·binary·angle.
15 .PP14 .PP
16 Example:15 Example:
17 .IP16 .IP
408 B
./usr/share/man/man3/al_fixtof.3alleg5.gz
326 B
al_fixtof.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixtof"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixtof"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixtof·\-·Allegro·5·API5 al_fixtof·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 double·al_fixtof(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Converts·fixed·point·to·floating·point.12 Converts·fixed·point·to·floating·point.
14 .PP13 .PP
15 Example:14 Example:
16 .IP15 .IP
17 .EX16 .EX
439 B
./usr/share/man/man3/al_fixtoi.3alleg5.gz
357 B
al_fixtoi.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixtoi"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixtoi"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixtoi·\-·Allegro·5·API5 al_fixtoi·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_fixtoi(al_fixed·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Converts·fixed·point·to·integer,·rounding·as·required·to·the·nearest12 Converts·fixed·point·to·integer,·rounding·as·required·to·the·nearest
14 integer.13 integer.
15 .PP14 .PP
16 Example:15 Example:
17 .IP16 .IP
542 B
./usr/share/man/man3/al_fixtorad_r.3alleg5.gz
452 B
al_fixtorad_r.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_fixtorad_r"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_fixtorad_r"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_fixtorad_r·\-·Allegro·5·API5 al_fixtorad_r·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 const·al_fixed·al_fixtorad_r·=·(al_fixed)1608; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·constant·gives·a·ratio·which·can·be·used·to·convert·a·fixed·point12 This·constant·gives·a·ratio·which·can·be·used·to·convert·a·fixed·point
14 number·in·binary·angle·format·to·a·fixed·point·number·in·radians.13 number·in·binary·angle·format·to·a·fixed·point·number·in·radians.
15 .PP14 .PP
16 Example:15 Example:
17 .IP16 .IP
566 B
./usr/share/man/man3/al_ftofix.3alleg5.gz
484 B
al_ftofix.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_ftofix"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_ftofix"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_ftofix·\-·Allegro·5·API5 al_ftofix·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_ftofix(double·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Converts·a·floating·point·value·to·fixed·point.12 Converts·a·floating·point·value·to·fixed·point.
14 Unlike·al_itofix(3alleg5),·this·function·clamps·values·which·could13 Unlike·al_itofix(3alleg5),·this·function·clamps·values·which·could
15 overflow·the·type·conversion,·setting·Allegro\[cq]s·errno·to·ERANGE·in14 overflow·the·type·conversion,·setting·Allegro\[cq]s·errno·to·ERANGE·in
16 the·process·if·this·happens.15 the·process·if·this·happens.
17 .PP16 .PP
583 B
./usr/share/man/man3/al_get_display_adapter.3alleg5.gz
475 B
al_get_display_adapter.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"al_get_display_adapter"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_display_adapter"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_display_adapter·\-·Allegro·5·API5 al_get_display_adapter·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_get_display_adapter(ALLEGRO_DISPLAY·*display) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Returns·which·adapter·the·window·is·currently·placed·on.12 Returns·which·adapter·the·window·is·currently·placed·on.
14 Returns·\-1·if·there·was·an·error·in·determining·the·adapter.13 Returns·\-1·if·there·was·an·error·in·determining·the·adapter.
15 .SH·SINCE14 .SH·SINCE
16 5.2.1015 5.2.10
547 B
./usr/share/man/man3/al_get_display_option.3alleg5.gz
441 B
al_get_display_option.3alleg5
    
Offset 3, 14 lines modifiedOffset 3, 12 lines modified
3 .TH·"al_get_display_option"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_display_option"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_display_option·\-·Allegro·5·API5 al_get_display_option·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_get_display_option(ALLEGRO_DISPLAY·*display,·int·option) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Return·an·extra·display·setting·of·the·display.12 Return·an·extra·display·setting·of·the·display.
14 .SH·SEE·ALSO13 .SH·SEE·ALSO
15 al_set_new_display_option(3alleg5)14 al_set_new_display_option(3alleg5)
678 B
./usr/share/man/man3/al_get_new_display_adapter.3alleg5.gz
562 B
al_get_new_display_adapter.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_get_new_display_adapter"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_new_display_adapter"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_new_display_adapter·\-·Allegro·5·API5 al_get_new_display_adapter·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_get_new_display_adapter(void) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Gets·the·video·adapter·index·where·new·displays·will·be·created·by·the12 Gets·the·video·adapter·index·where·new·displays·will·be·created·by·the
14 calling·thread,·if·previously·set·with13 calling·thread,·if·previously·set·with
15 al_set_new_display_adapter(3alleg5).14 al_set_new_display_adapter(3alleg5).
16 Otherwise·returns·\f[CR]ALLEGRO_DEFAULT_DISPLAY_ADAPTER\f[R].15 Otherwise·returns·\f[CR]ALLEGRO_DEFAULT_DISPLAY_ADAPTER\f[R].
17 .SH·SEE·ALSO16 .SH·SEE·ALSO
601 B
./usr/share/man/man3/al_get_new_display_flags.3alleg5.gz
489 B
al_get_new_display_flags.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"al_get_new_display_flags"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_new_display_flags"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_new_display_flags·\-·Allegro·5·API5 al_get_new_display_flags·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_get_new_display_flags(void) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Get·the·display·flags·to·be·used·when·creating·new·displays·on·the12 Get·the·display·flags·to·be·used·when·creating·new·displays·on·the
14 calling·thread.13 calling·thread.
15 .SH·SEE·ALSO14 .SH·SEE·ALSO
16 al_set_new_display_flags(3alleg5),·al_set_display_flag(3alleg5)15 al_set_new_display_flags(3alleg5),·al_set_display_flag(3alleg5)
569 B
./usr/share/man/man3/al_get_new_display_option.3alleg5.gz
455 B
al_get_new_display_option.3alleg5
    
Offset 3, 13 lines modifiedOffset 3, 11 lines modified
3 .TH·"al_get_new_display_option"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_new_display_option"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_new_display_option·\-·Allegro·5·API5 al_get_new_display_option·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_get_new_display_option(int·option,·int·*importance) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Retrieve·an·extra·display·setting·which·was·previously·set·with12 Retrieve·an·extra·display·setting·which·was·previously·set·with
14 al_set_new_display_option(3alleg5).13 al_set_new_display_option(3alleg5).
636 B
./usr/share/man/man3/al_get_new_display_refresh_rate.3alleg5.gz
510 B
al_get_new_display_refresh_rate.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"al_get_new_display_refresh_rate"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_new_display_refresh_rate"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_new_display_refresh_rate·\-·Allegro·5·API5 al_get_new_display_refresh_rate·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 int·al_get_new_display_refresh_rate(void) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Get·the·requested·refresh·rate·to·be·used·when·creating·new·displays·on12 Get·the·requested·refresh·rate·to·be·used·when·creating·new·displays·on
14 the·calling·thread.13 the·calling·thread.
15 .SH·SEE·ALSO14 .SH·SEE·ALSO
16 al_set_new_display_refresh_rate(3alleg5)15 al_set_new_display_refresh_rate(3alleg5)
635 B
./usr/share/man/man3/al_get_new_file_interface.3alleg5.gz
521 B
al_get_new_file_interface.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"al_get_new_file_interface"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_new_file_interface"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_new_file_interface·\-·Allegro·5·API5 al_get_new_file_interface·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 const·ALLEGRO_FILE_INTERFACE·*al_get_new_file_interface(void) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Return·a·pointer·to·the·ALLEGRO_FILE_INTERFACE(3alleg5)·table·in·effect12 Return·a·pointer·to·the·ALLEGRO_FILE_INTERFACE(3alleg5)·table·in·effect
14 for·the·calling·thread.13 for·the·calling·thread.
15 .SH·SEE·ALSO14 .SH·SEE·ALSO
16 al_store_state(3alleg5),·al_restore_state(3alleg5).15 al_store_state(3alleg5),·al_restore_state(3alleg5).
613 B
./usr/share/man/man3/al_get_new_window_position.3alleg5.gz
497 B
al_get_new_window_position.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"al_get_new_window_position"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_new_window_position"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_new_window_position·\-·Allegro·5·API5 al_get_new_window_position·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_get_new_window_position(int·*x,·int·*y) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Get·the·position·where·new·non\-fullscreen·displays·created·by·the12 Get·the·position·where·new·non\-fullscreen·displays·created·by·the
14 calling·thread·will·be·placed.13 calling·thread·will·be·placed.
15 .SH·SEE·ALSO14 .SH·SEE·ALSO
16 al_set_new_window_position(3alleg5)15 al_set_new_window_position(3alleg5)
688 B
./usr/share/man/man3/al_get_new_window_title.3alleg5.gz
578 B
al_get_new_window_title.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_get_new_window_title"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_get_new_window_title"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_get_new_window_title·\-·Allegro·5·API5 al_get_new_window_title·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 const·char·*al_get_new_window_title(void) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Returns·the·title·that·will·be·used·when·a·new·display·is·created.12 Returns·the·title·that·will·be·used·when·a·new·display·is·created.
14 This·returns·the·value·that·al_set_window_title(3alleg5)·was·called13 This·returns·the·value·that·al_set_window_title(3alleg5)·was·called
15 with.14 with.
16 If·that·function·wasn\[cq]t·called·yet,·the·value·of15 If·that·function·wasn\[cq]t·called·yet,·the·value·of
17 al_get_app_name(3alleg5)·is·returned·as·a·default.16 al_get_app_name(3alleg5)·is·returned·as·a·default.
697 B
./usr/share/man/man3/al_inhibit_screensaver.3alleg5.gz
589 B
al_inhibit_screensaver.3alleg5
    
Offset 3, 15 lines modifiedOffset 3, 13 lines modified
3 .TH·"al_inhibit_screensaver"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_inhibit_screensaver"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_inhibit_screensaver·\-·Allegro·5·API5 al_inhibit_screensaver·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 bool·al_inhibit_screensaver(bool·inhibit) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·function·allows·the·user·to·stop·the·system·screensaver·from12 This·function·allows·the·user·to·stop·the·system·screensaver·from
14 starting·up·if·true·is·passed,·or·resets·the·system·back·to·the·default13 starting·up·if·true·is·passed,·or·resets·the·system·back·to·the·default
15 state·(the·state·at·program·start)·if·false·is·passed.14 state·(the·state·at·program·start)·if·false·is·passed.
16 It·returns·true·if·the·state·was·set·successfully,·otherwise·false.15 It·returns·true·if·the·state·was·set·successfully,·otherwise·false.
592 B
./usr/share/man/man3/al_itofix.3alleg5.gz
510 B
al_itofix.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_itofix"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_itofix"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_itofix·\-·Allegro·5·API5 al_itofix·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 al_fixed·al_itofix(int·x); 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Converts·an·integer·to·fixed·point.12 Converts·an·integer·to·fixed·point.
14 This·is·the·same·thing·as·x<<16.13 This·is·the·same·thing·as·x<<16.
15 Remember·that·overflows·(trying·to·convert·an·integer·greater·than14 Remember·that·overflows·(trying·to·convert·an·integer·greater·than
16 32767)·and·underflows·(trying·to·convert·an·integer·lesser·than·\-32768)15 32767)·and·underflows·(trying·to·convert·an·integer·lesser·than·\-32768)
17 are·not·detected·even·in·debug·builds!16 are·not·detected·even·in·debug·builds!
545 B
./usr/share/man/man3/al_radtofix_r.3alleg5.gz
455 B
al_radtofix_r.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_radtofix_r"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_radtofix_r"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_radtofix_r·\-·Allegro·5·API5 al_radtofix_r·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 const·al_fixed·al_radtofix_r·=·(al_fixed)2670177; 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·constant·gives·a·ratio·which·can·be·used·to·convert·a·fixed·point12 This·constant·gives·a·ratio·which·can·be·used·to·convert·a·fixed·point
14 number·in·radians·to·a·fixed·point·number·in·binary·angle·format.13 number·in·radians·to·a·fixed·point·number·in·binary·angle·format.
15 .PP14 .PP
16 Example:15 Example:
17 .IP16 .IP
559 B
./usr/share/man/man3/al_reset_new_display_options.3alleg5.gz
439 B
al_reset_new_display_options.3alleg5
    
Offset 3, 13 lines modifiedOffset 3, 11 lines modified
3 .TH·"al_reset_new_display_options"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_reset_new_display_options"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_reset_new_display_options·\-·Allegro·5·API5 al_reset_new_display_options·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_reset_new_display_options(void) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 This·undoes·any·previous·call·to·al_set_new_display_option(3alleg5)·on12 This·undoes·any·previous·call·to·al_set_new_display_option(3alleg5)·on
14 the·calling·thread.13 the·calling·thread.
761 B
./usr/share/man/man3/al_set_display_option.3alleg5.gz
655 B
al_set_display_option.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_set_display_option"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_set_display_option"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_set_display_option·\-·Allegro·5·API5 al_set_display_option·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_set_display_option(ALLEGRO_DISPLAY·*display,·int·option,·int·value) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Change·an·option·that·was·previously·set·for·a·display.12 Change·an·option·that·was·previously·set·for·a·display.
14 After·displays·are·created,·they·take·on·the·options·set·with13 After·displays·are·created,·they·take·on·the·options·set·with
15 al_set_new_display_option(3alleg5).14 al_set_new_display_option(3alleg5).
16 Calling·al_set_new_display_option(3alleg5)·subsequently·only·changes15 Calling·al_set_new_display_option(3alleg5)·subsequently·only·changes
17 options·for·newly·created·displays,·and·doesn\[cq]t·touch·the·options·of16 options·for·newly·created·displays,·and·doesn\[cq]t·touch·the·options·of
701 B
./usr/share/man/man3/al_set_new_display_adapter.3alleg5.gz
585 B
al_set_new_display_adapter.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_set_new_display_adapter"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_set_new_display_adapter"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_set_new_display_adapter·\-·Allegro·5·API5 al_set_new_display_adapter·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_set_new_display_adapter(int·adapter) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Sets·the·adapter·to·use·for·new·displays·created·by·the·calling·thread.12 Sets·the·adapter·to·use·for·new·displays·created·by·the·calling·thread.
14 The·adapter·has·a·monitor·attached·to·it.13 The·adapter·has·a·monitor·attached·to·it.
15 Information·about·the·monitor·can·be·gotten·using14 Information·about·the·monitor·can·be·gotten·using
16 al_get_num_video_adapters(3alleg5)·and·al_get_monitor_info(3alleg5).15 al_get_num_video_adapters(3alleg5)·and·al_get_monitor_info(3alleg5).
17 .PP16 .PP
608 B
./usr/share/man/man3/al_set_new_display_flags.3alleg5.gz
496 B
al_set_new_display_flags.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_set_new_display_flags"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_set_new_display_flags"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_set_new_display_flags·\-·Allegro·5·API5 al_set_new_display_flags·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_set_new_display_flags(int·flags) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Sets·various·flags·to·be·used·when·creating·new·displays·on·the·calling12 Sets·various·flags·to·be·used·when·creating·new·displays·on·the·calling
14 thread.13 thread.
15 flags·is·a·bitfield·containing·any·reasonable·combination·of·the14 flags·is·a·bitfield·containing·any·reasonable·combination·of·the
16 following:15 following:
17 .TP16 .TP
763 B
./usr/share/man/man3/al_set_new_display_option.3alleg5.gz
649 B
al_set_new_display_option.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_set_new_display_option"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_set_new_display_option"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_set_new_display_option·\-·Allegro·5·API5 al_set_new_display_option·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_set_new_display_option(int·option,·int·value,·int·importance) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Set·an·extra·display·option,·to·be·used·when·creating·new·displays·on12 Set·an·extra·display·option,·to·be·used·when·creating·new·displays·on
14 the·calling·thread.13 the·calling·thread.
15 Display·options·differ·from·display·flags,·and·specify·some·details·of14 Display·options·differ·from·display·flags,·and·specify·some·details·of
16 the·context·to·be·created·within·the·window·itself.15 the·context·to·be·created·within·the·window·itself.
17 These·mainly·have·no·effect·on·Allegro·itself,·but·you·may·want·to16 These·mainly·have·no·effect·on·Allegro·itself,·but·you·may·want·to
712 B
./usr/share/man/man3/al_set_new_display_refresh_rate.3alleg5.gz
586 B
al_set_new_display_refresh_rate.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_set_new_display_refresh_rate"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_set_new_display_refresh_rate"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_set_new_display_refresh_rate·\-·Allegro·5·API5 al_set_new_display_refresh_rate·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_set_new_display_refresh_rate(int·refresh_rate) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Sets·the·refresh·rate·to·use·when·creating·new·displays·on·the·calling12 Sets·the·refresh·rate·to·use·when·creating·new·displays·on·the·calling
14 thread.13 thread.
15 If·the·refresh·rate·is·not·available,·al_create_display(3alleg5)·will14 If·the·refresh·rate·is·not·available,·al_create_display(3alleg5)·will
16 fail.15 fail.
17 A·list·of·modes·with·refresh·rates·can·be·found·with16 A·list·of·modes·with·refresh·rates·can·be·found·with
733 B
./usr/share/man/man3/al_set_new_file_interface.3alleg5.gz
619 B
al_set_new_file_interface.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_set_new_file_interface"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_set_new_file_interface"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_set_new_file_interface·\-·Allegro·5·API5 al_set_new_file_interface·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_set_new_file_interface(const·ALLEGRO_FILE_INTERFACE·*file_interface) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Set·the·ALLEGRO_FILE_INTERFACE(3alleg5)·table·for·the·calling·thread.12 Set·the·ALLEGRO_FILE_INTERFACE(3alleg5)·table·for·the·calling·thread.
14 This·will·change·the·handler·for·later·calls·to·al_fopen(3alleg5).13 This·will·change·the·handler·for·later·calls·to·al_fopen(3alleg5).
15 .SH·SEE·ALSO14 .SH·SEE·ALSO
16 al_set_standard_file_interface(3alleg5),·al_store_state(3alleg5),15 al_set_standard_file_interface(3alleg5),·al_store_state(3alleg5),
17 al_restore_state(3alleg5).16 al_restore_state(3alleg5).
679 B
./usr/share/man/man3/al_set_new_window_position.3alleg5.gz
563 B
al_set_new_window_position.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_set_new_window_position"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_set_new_window_position"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_set_new_window_position·\-·Allegro·5·API5 al_set_new_window_position·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_set_new_window_position(int·x,·int·y) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Sets·where·the·top·left·pixel·of·the·client·area·of·newly·created12 Sets·where·the·top·left·pixel·of·the·client·area·of·newly·created
14 windows·(non\-fullscreen)·will·be·on·screen,·for·displays·created·by·the13 windows·(non\-fullscreen)·will·be·on·screen,·for·displays·created·by·the
15 calling·thread.14 calling·thread.
16 Negative·values·are·allowed·on·some·multihead·systems.15 Negative·values·are·allowed·on·some·multihead·systems.
17 .PP16 .PP
674 B
./usr/share/man/man3/al_set_new_window_title.3alleg5.gz
564 B
al_set_new_window_title.3alleg5
    
Offset 3, 16 lines modifiedOffset 3, 14 lines modified
3 .TH·"al_set_new_window_title"·"3alleg5"·""·"Allegro·reference·manual"·""3 .TH·"al_set_new_window_title"·"3alleg5"·""·"Allegro·reference·manual"·""
4 .SH·NAME4 .SH·NAME
5 al_set_new_window_title·\-·Allegro·5·API5 al_set_new_window_title·\-·Allegro·5·API
6 .SH·SYNOPSIS6 .SH·SYNOPSIS
7 .IP7 .IP
8 .EX8 .EX
9 #include·<allegro5/allegro.h>9 #include·<allegro5/allegro.h>
  
10 void·al_set_new_window_title(const·char·*title) 
11 .EE10 .EE
12 .SH·DESCRIPTION11 .SH·DESCRIPTION
13 Set·the·title·that·will·be·used·when·a·new·display·is·created.12 Set·the·title·that·will·be·used·when·a·new·display·is·created.
14 Allegro·uses·a·static·buffer·of13 Allegro·uses·a·static·buffer·of
15 ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE(3alleg5)·to·store·this,·so·the·length14 ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE(3alleg5)·to·store·this,·so·the·length
16 of·the·titme·you·set·must·be·less·than·this.15 of·the·titme·you·set·must·be·less·than·this.
17 .SH·SEE·ALSO16 .SH·SEE·ALSO
2.92 KB
liballegro5-dev_5.2.10.1+dfsg-1_amd64.deb
98.0 B
control.tar.xz
70.0 B
control.tar
48.0 B
./md5sums
30.0 B
./md5sums
Files differ
2.75 KB
data.tar.xz
2.73 KB
data.tar
2.15 KB
file list
    
Offset 93, 15 lines modifiedOffset 93, 15 lines modified
93 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/include/x86_64-linux-gnu/allegro5/93 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/include/x86_64-linux-gnu/allegro5/
94 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/include/x86_64-linux-gnu/allegro5/platform/94 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/include/x86_64-linux-gnu/allegro5/platform/
95 -rw-r--r--···0·root·········(0)·root·········(0)·····3996·2025-01-09·13:52:42.000000·./usr/include/x86_64-linux-gnu/allegro5/platform/alplatf.h95 -rw-r--r--···0·root·········(0)·root·········(0)·····3996·2025-01-09·13:52:42.000000·./usr/include/x86_64-linux-gnu/allegro5/platform/alplatf.h
96 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/96 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/
97 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/97 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/
98 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/98 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/
99 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/99 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/
100 -rw-r--r--···0·root·········(0)·root·········(0)·····1609·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroConfig.cmake100 -rw-r--r--···0·root·········(0)·root·········(0)·····1606·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroConfig.cmake
101 -rw-r--r--···0·root·········(0)·root·········(0)·····1862·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroConfigVersion.cmake101 -rw-r--r--···0·root·········(0)·root·········(0)·····1862·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroConfigVersion.cmake
102 -rw-r--r--···0·root·········(0)·root·········(0)·····7642·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroTargets-none.cmake102 -rw-r--r--···0·root·········(0)·root·········(0)·····7642·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroTargets-none.cmake
103 -rw-r--r--···0·root·········(0)·root·········(0)·····9526·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroTargets.cmake103 -rw-r--r--···0·root·········(0)·root·········(0)·····9526·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroTargets.cmake
104 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/pkgconfig/104 drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/pkgconfig/
105 -rw-r--r--···0·root·········(0)·root·········(0)······315·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/pkgconfig/allegro-5.pc105 -rw-r--r--···0·root·········(0)·root·········(0)······315·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/pkgconfig/allegro-5.pc
106 -rw-r--r--···0·root·········(0)·root·········(0)······378·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/pkgconfig/allegro_color-5.pc106 -rw-r--r--···0·root·········(0)·root·········(0)······378·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/pkgconfig/allegro_color-5.pc
107 -rw-r--r--···0·root·········(0)·root·········(0)······374·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/pkgconfig/allegro_font-5.pc107 -rw-r--r--···0·root·········(0)·root·········(0)······374·2025-01-09·13:52:42.000000·./usr/lib/x86_64-linux-gnu/pkgconfig/allegro_font-5.pc
578 B
./usr/lib/x86_64-linux-gnu/cmake/allegro/AllegroConfig.cmake
    
Offset 31, 11 lines modifiedOffset 31, 11 lines modified
31 set(ALLEGRO_PKG_VERSION_PATCH·10)31 set(ALLEGRO_PKG_VERSION_PATCH·10)
32 set(ALLEGRO_PKG_VERSION·5.2.10)32 set(ALLEGRO_PKG_VERSION·5.2.10)
  
33 #·Architecture,·compiler·and·other·low·level·flags33 #·Architecture,·compiler·and·other·low·level·flags
34 set(ALLEGRO_PKG_LIBRARY_ARCHITECTURE·"x86_64-linux-gnu")34 set(ALLEGRO_PKG_LIBRARY_ARCHITECTURE·"x86_64-linux-gnu")
35 set(ALLEGRO_PKG_COMPILER·"GNU")35 set(ALLEGRO_PKG_COMPILER·"GNU")
36 set(ALLEGRO_PKG_COMPILER_VERSION·"14.2.0")36 set(ALLEGRO_PKG_COMPILER_VERSION·"14.2.0")
37 set(ALLEGRO_PKG_HOST_SYSTEM·"Linux-6.12.12+bpo-amd64")37 set(ALLEGRO_PKG_HOST_SYSTEM·"Linux-6.1.0-31-amd64")
  
38 #·Targets38 #·Targets
39 include("${CMAKE_CURRENT_LIST_DIR}/AllegroTargets.cmake")39 include("${CMAKE_CURRENT_LIST_DIR}/AllegroTargets.cmake")