/usr/bin/diffoscope --timeout 7200 --html /srv/reproducible-results/rbuild-debian/r-b-build.FS1UI7gb/allegro5_5.2.6.0-3.diffoscope.html --text /srv/reproducible-results/rbuild-debian/r-b-build.FS1UI7gb/allegro5_5.2.6.0-3.diffoscope.txt --json /srv/reproducible-results/rbuild-debian/r-b-build.FS1UI7gb/allegro5_5.2.6.0-3.diffoscope.json --profile=- /srv/reproducible-results/rbuild-debian/r-b-build.FS1UI7gb/b1/allegro5_5.2.6.0-3_arm64.changes /srv/reproducible-results/rbuild-debian/r-b-build.FS1UI7gb/b2/allegro5_5.2.6.0-3

⊟

1.32 MB

/srv/reproducible-results/rbuild-debian/r-b-build.FS1UI7gb/b1/allegro5_5.2.6.0-3_arm64.changes vs.

/srv/reproducible-results/rbuild-debian/r-b-build.FS1UI7gb/b2/allegro5_5.2.6.0-3_arm64.changes ¶

⊟

905 B

Files ¶

⊟

1.32 MB

allegro5-doc_5.2.6.0-3_all.deb ¶

⊟

452 B

file list ¶

⊟

623 B

control.tar.xz ¶

⊟

595 B

control.tar ¶

⊟

525 B

./control ¶

⊟

48.0 B

./md5sums ¶

⊟

30.0 B

./md5sums ¶

Files differ

⊟

1.32 MB

data.tar.xz ¶

⊟

1.32 MB

data.tar ¶

⊟

192 KB

file list ¶

⊟

6.28 KB

⊟

1.52 KB

⊟

266 KB

⊟

67.2 KB

⊟

64.1 KB

⊟

14.6 KB

⊟

7.53 KB

⊟

1.59 KB

⊟

1.32 KB

⊟

506 B

⊟

9.32 KB

⊟

1.88 KB

⊟

18.8 KB

⊟

4.76 KB

⊟

8.43 KB

⊟

2.01 KB

⊟

4.91 KB

⊟

1.14 KB

⊟

110 KB

⊟

26.8 KB

⊟

11.5 KB

⊟

3.03 KB

⊟

4.61 KB

⊟

1.11 KB

⊟

1.38 KB

⊟

470 B

⊟

20.7 KB

⊟

4.8 KB

⊟

10.9 KB

⊟

3.25 KB

⊟

7.44 KB

⊟

1.91 KB

⊟

847 B

⊟

334 B

⊟

1.0 KB

⊟

373 B

⊟

7.64 KB

⊟

1.92 KB

⊟

4.0 KB

⊟

1.23 KB

⊟

1.84 KB

⊟

508 B

⊟

4.94 KB

⊟

1.42 KB

⊟

13.9 KB

⊟

3.26 KB

⊟

3.76 KB

⊟

1.12 KB

⊟

4.6 KB

⊟

1.26 KB

⊟

3.01 KB

⊟

1.01 KB

⊟

82.9 KB

⊟

20.8 KB

⊟

1.57 KB

⊟

506 B

⊟

1.59 KB

⊟

577 B

⊟

6.16 KB

⊟

1.5 KB

⊟

1.13 KB

⊟

480 B

⊟

152 KB

⊟

37.9 KB

⊟

8.74 KB

⊟

2.54 KB

⊟

6.25 KB

⊟

1.67 KB

⊟

6.96 KB

⊟

1.84 KB

⊟

6.56 KB

⊟

1.46 KB

⊟

1.71 KB

⊟

552 B

⊟

8.16 KB

⊟

1.85 KB

⊟

9.32 KB

⊟

2.61 KB

⊟

3.38 KB

⊟

971 B

⊟

6.75 KB

⊟

1.56 KB

⊟

30.0 KB

⊟

7.15 KB

⊟

521 B

⊟

419 B

⊟

500 B

⊟

388 B

⊟

538 B

⊟

430 B

⊟

488 B

⊟

380 B

⊟

562 B

⊟

442 B

⊟

574 B

⊟

470 B

⊟

395 B

⊟

303 B

⊟

414 B

⊟

312 B

⊟

412 B

⊟

310 B

⊟

422 B

⊟

318 B

⊟

484 B

⊟

394 B

⊟

386 B

⊟

298 B

⊟

384 B

⊟

292 B

⊟

492 B

⊟

388 B

⊟

511 B

⊟

403 B

⊟

410 B

⊟

316 B

⊟

448 B

⊟

344 B

⊟

519 B

⊟

429 B

⊟

546 B

⊟

444 B

⊟

585 B

⊟

481 B

⊟

438 B

⊟

338 B

⊟

560 B

⊟

444 B

⊟

429 B

⊟

341 B

⊟

440 B

⊟

338 B

⊟

522 B

⊟

414 B

⊟

399 B

⊟

301 B

⊟

517 B

⊟

429 B

⊟

532 B

⊟

404 B

⊟

474 B

⊟

378 B

⊟

469 B

⊟

365 B

⊟

567 B

⊟

459 B

⊟

418 B

⊟

328 B

⊟

461 B

⊟

369 B

⊟

481 B

⊟

369 B

⊟

506 B

⊟

400 B

⊟

606 B

⊟

494 B

⊟

568 B

⊟

464 B

⊟

449 B

⊟

353 B

⊟

446 B

⊟

350 B

⊟

570 B

⊟

462 B

⊟

580 B

⊟

472 B

⊟

402 B

⊟

306 B

⊟

409 B

⊟

311 B

⊟

562 B

⊟

456 B

⊟

478 B

⊟

366 B

⊟

473 B

⊟

385 B

⊟

475 B

⊟

377 B

⊟

548 B

⊟

458 B

⊟

462 B

⊟

356 B

⊟

542 B

⊟

438 B

⊟

464 B

⊟

344 B

⊟

449 B

⊟

347 B

⊟

422 B

⊟

316 B

⊟

381 B

⊟

291 B

⊟

531 B

⊟

401 B

⊟

445 B

⊟

361 B

⊟

444 B

⊟

340 B

⊟

382 B

⊟

286 B

⊟

495 B

⊟

397 B

⊟

530 B

⊟

416 B

⊟

505 B

⊟

401 B

⊟

515 B

⊟

411 B

⊟

482 B

⊟

384 B

⊟

428 B

⊟

318 B

⊟

432 B

⊟

328 B

⊟

513 B

⊟

421 B

⊟

532 B

⊟

434 B

⊟

588 B

⊟

478 B

⊟

433 B

⊟

345 B

⊟

516 B

⊟

424 B

⊟

563 B

⊟

453 B

⊟

519 B

⊟

417 B

⊟

427 B

⊟

337 B

⊟

500 B

⊟

398 B

⊟

409 B

⊟

311 B

⊟

405 B

⊟

311 B

⊟

390 B

⊟

298 B

⊟

398 B

⊟

308 B

⊟

476 B

⊟

374 B

⊟

528 B

⊟

394 B

⊟

536 B

⊟

422 B

⊟

491 B

⊟

389 B

⊟

574 B

⊟

476 B

⊟

428 B

⊟

322 B

⊟

484 B

⊟

384 B

⊟

494 B

⊟

406 B

⊟

493 B

⊟

395 B

⊟

538 B

⊟

446 B

⊟

557 B

⊟

451 B

⊟

535 B

⊟

421 B

⊟

529 B

⊟

427 B

⊟

531 B

⊟

423 B

⊟

453 B

⊟

341 B

⊟

603 B

⊟

485 B

⊟

552 B

⊟

462 B

⊟

480 B

⊟

368 B

⊟

662 B

⊟

560 B

⊟

618 B

⊟

504 B

⊟

601 B

⊟

475 B

⊟

678 B

⊟

552 B

⊟

614 B

⊟

502 B

⊟

571 B

⊟

459 B

⊟

617 B

⊟

485 B

⊟

718 B

⊟

586 B

⊟

474 B

⊟

384 B

⊟

796 B

⊟

700 B

⊟

712 B

⊟

610 B

⊟

677 B

⊟

575 B

⊟

485 B

⊟

403 B

⊟

515 B

⊟

425 B

⊟

512 B

⊟

402 B

⊟

509 B

⊟

397 B

⊟

466 B

⊟

374 B

⊟

492 B

⊟

402 B

⊟

569 B

⊟

465 B

⊟

456 B

⊟

368 B

⊟

567 B

⊟

465 B

⊟

452 B

⊟

364 B

⊟

559 B

⊟

457 B

⊟

489 B

⊟

399 B

⊟

634 B

⊟

530 B

⊟

533 B

⊟

445 B

⊟

527 B

⊟

425 B

⊟

522 B

⊟

434 B

⊟

524 B

⊟

422 B

⊟

459 B

⊟

369 B

⊟

501 B

⊟

397 B

⊟

615 B

⊟

511 B

⊟

652 B

⊟

550 B

⊟

640 B

⊟

538 B

⊟

527 B

⊟

423 B

⊟

515 B

⊟

413 B

⊟

516 B

⊟

414 B

⊟

523 B

⊟

419 B

⊟

514 B

⊟

412 B

⊟

512 B

⊟

410 B

⊟

515 B

⊟

413 B

⊟

497 B

⊟

409 B

⊟

522 B

⊟

420 B

⊟

500 B

⊟

412 B

⊟

520 B

⊟

418 B

⊟

440 B

⊟

352 B

⊟

523 B

⊟

421 B

⊟

803 B

⊟

691 B

⊟

796 B

⊟

688 B

⊟

518 B

⊟

410 B

⊟

654 B

⊟

546 B

⊟

431 B

⊟

339 B

⊟

631 B

⊟

537 B

⊟

679 B

⊟

559 B

⊟

556 B

⊟

452 B

⊟

772 B

⊟

676 B

⊟

615 B

⊟

501 B

⊟

685 B

⊟

575 B

⊟

629 B

⊟

523 B

⊟

628 B

⊟

534 B

⊟

551 B

⊟

437 B

⊟

534 B

⊟

424 B

⊟

433 B

⊟

339 B

⊟

486 B

⊟

376 B

⊟

532 B

⊟

438 B

⊟

396 B

⊟

300 B

⊟

505 B

⊟

383 B

⊟

517 B

⊟

419 B

⊟

583 B

⊟

467 B

⊟

495 B

⊟

383 B

⊟

467 B

⊟

359 B

⊟

470 B

⊟

374 B

⊟

495 B

⊟

387 B

⊟

433 B

⊟

339 B

⊟

509 B

⊟

395 B

⊟

438 B

⊟

344 B

⊟

534 B

⊟

414 B

⊟

794 B

⊟

690 B

⊟

754 B

⊟

650 B

⊟

594 B

⊟

488 B

⊟

534 B

⊟

448 B

⊟

488 B

⊟

396 B

⊟

517 B

⊟

423 B

⊟

633 B

⊟

525 B

⊟

499 B

⊟

393 B

⊟

522 B

⊟

414 B

⊟

608 B

⊟

498 B

⊟

582 B

⊟

474 B

⊟

725 B

⊟

595 B

⊟

536 B

⊟

424 B

⊟

633 B

⊟

505 B

⊟

569 B

⊟

459 B

⊟

632 B

⊟

542 B

⊟

757 B

⊟

649 B

⊟

689 B

⊟

585 B

⊟

661 B

⊟

553 B

⊟

746 B

⊟

636 B

⊟

735 B

⊟

627 B

⊟

513 B

⊟

425 B

⊟

772 B

⊟

664 B

⊟

786 B

⊟

676 B

⊟

766 B

⊟

658 B

⊟

595 B

⊟

499 B

⊟

654 B

⊟

560 B

⊟

717 B

⊟

621 B

⊟

569 B

⊟

481 B

⊟

531 B

⊟

433 B

⊟

661 B

⊟

569 B

⊟

627 B

⊟

513 B

⊟

849 B

⊟

751 B

⊟

1000 B

⊟

894 B

⊟

494 B

⊟

402 B

⊟

624 B

⊟

536 B

⊟

636 B

⊟

546 B

⊟

564 B

⊟

468 B

⊟

621 B

⊟

533 B

⊟

683 B

⊟

577 B

⊟

623 B

⊟

505 B

⊟

634 B

⊟

540 B

⊟

547 B

⊟

459 B

⊟

615 B

⊟

517 B

⊟

384 B

⊟

304 B

⊟

474 B

⊟

396 B

⊟

513 B

⊟

391 B

⊟

506 B

⊟

386 B

⊟

506 B

⊟

386 B

⊟

499 B

⊟

381 B

⊟

506 B

⊟

386 B

⊟

520 B

⊟

396 B

⊟

562 B

⊟

426 B

⊟

513 B

⊟

391 B

⊟

541 B

⊟

411 B

⊟

492 B

⊟

376 B

⊟

517 B

⊟

397 B

⊟

551 B

⊟

441 B

⊟

552 B

⊟

434 B

⊟

608 B

⊟

476 B

⊟

528 B

⊟

408 B

⊟

545 B

⊟

425 B

⊟

515 B

⊟

401 B

⊟

610 B

⊟

482 B

⊟

587 B

⊟

467 B

⊟

629 B

⊟

507 B

⊟

516 B

⊟

394 B

⊟

494 B

⊟

382 B

⊟

498 B

⊟

382 B

⊟

551 B

⊟

425 B

⊟

481 B

⊟

371 B

⊟

598 B

⊟

466 B

⊟

508 B

⊟

390 B

⊟

536 B

⊟

416 B

⊟

616 B

⊟

486 B

⊟

510 B

⊟

396 B

⊟

681 B

⊟

539 B

⊟

534 B

⊟

430 B

⊟

637 B

⊟

509 B

⊟

565 B

⊟

461 B

⊟

437 B

⊟

333 B

⊟

523 B

⊟

421 B

⊟

461 B

⊟

357 B

⊟

429 B

⊟

329 B

⊟

436 B

⊟

334 B

⊟

590 B

⊟

480 B

⊟

567 B

⊟

467 B

⊟

612 B

⊟

524 B

⊟

664 B

⊟

560 B

⊟

688 B

⊟

578 B

⊟

578 B

⊟

478 B

⊟

477 B

⊟

365 B

⊟

550 B

⊟

438 B

⊟

523 B

⊟

415 B

⊟

608 B

⊟

502 B

⊟

469 B

⊟

363 B

⊟

490 B

⊟

384 B

⊟

460 B

⊟

360 B

⊟

476 B

⊟

368 B

⊟

455 B

⊟

357 B

⊟

449 B

⊟

345 B

⊟

472 B

⊟

368 B

⊟

551 B

⊟

425 B

⊟

683 B

⊟

559 B

⊟

591 B

⊟

457 B

⊟

510 B

⊟

420 B

⊟

502 B

⊟

394 B

⊟

441 B

⊟

341 B

⊟

472 B

⊟

370 B

⊟

488 B

⊟

378 B

⊟

555 B

⊟

429 B

⊟

593 B

⊟

467 B

⊟

571 B

⊟

451 B

⊟

568 B

⊟

440 B

⊟

521 B

⊟

403 B

⊟

616 B

⊟

494 B

⊟

508 B

⊟

392 B

⊟

611 B

⊟

487 B

⊟

567 B

⊟

441 B

⊟

558 B

⊟

432 B

⊟

537 B

⊟

417 B

⊟

555 B

⊟

437 B

⊟

476 B

⊟

372 B

⊟

695 B

⊟

587 B

⊟

482 B

⊟

384 B

⊟

663 B

⊟

555 B

⊟

494 B

⊟

396 B

⊟

486 B

⊟

372 B

⊟

463 B

⊟

353 B

⊟

557 B

⊟

443 B

⊟

467 B

⊟

371 B

⊟

559 B

⊟

459 B

⊟

609 B

⊟

503 B

⊟

599 B

⊟

483 B

⊟

591 B

⊟

477 B

⊟

497 B

⊟

391 B

⊟

467 B

⊟

367 B

⊟

477 B

⊟

369 B

⊟

459 B

⊟

355 B

⊟

565 B

⊟

459 B

⊟

624 B

⊟

512 B

⊟

506 B

⊟

428 B

⊟

505 B

⊟

401 B

⊟

432 B

⊟

332 B

⊟

493 B

⊟

391 B

⊟

482 B

⊟

364 B

⊟

472 B

⊟

360 B

⊟

488 B

⊟

390 B

⊟

388 B

⊟

286 B

⊟

718 B

⊟

616 B

⊟

403 B

⊟

307 B

⊟

496 B

⊟

372 B

⊟

447 B

⊟

341 B

⊟

549 B

⊟

425 B

⊟

484 B

⊟

364 B

⊟

492 B

⊟

370 B

⊟

552 B

⊟

414 B

⊟

528 B

⊟

396 B

⊟

476 B

⊟

358 B

⊟

492 B

⊟

370 B

⊟

439 B

⊟

337 B

⊟

618 B

⊟

514 B

⊟

684 B

⊟

576 B

⊟

524 B

⊟

422 B

⊟

588 B

⊟

474 B

⊟

549 B

⊟

461 B

⊟

510 B

⊟

418 B

⊟

573 B

⊟

477 B

⊟

561 B

⊟

465 B

⊟

610 B

⊟

510 B

⊟

592 B

⊟

480 B

⊟

674 B

⊟

558 B

⊟

655 B

⊟

551 B

⊟

581 B

⊟

483 B

⊟

662 B

⊟

556 B

⊟

492 B

⊟

410 B

⊟

574 B

⊟

480 B

⊟

612 B

⊟

502 B

⊟

486 B

⊟

396 B

⊟

640 B

⊟

548 B

⊟

499 B

⊟

389 B

⊟

576 B

⊟

486 B

⊟

517 B

⊟

433 B

⊟

793 B

⊟

667 B

⊟

799 B

⊟

669 B

⊟

628 B

⊟

518 B

⊟

639 B

⊟

525 B

⊟

645 B

⊟

527 B

⊟

650 B

⊟

538 B

⊟

656 B

⊟

540 B

⊟

545 B

⊟

437 B

⊟

549 B

⊟

447 B

⊟

515 B

⊟

415 B

⊟

523 B

⊟

411 B

⊟

552 B

⊟

444 B

⊟

505 B

⊟

413 B

⊟

575 B

⊟

479 B

⊟

587 B

⊟

473 B

⊟

507 B

⊟

417 B

⊟

652 B

⊟

532 B

⊟

529 B

⊟

417 B

⊟

676 B

⊟

554 B

⊟

616 B

⊟

506 B

⊟

546 B

⊟

428 B

⊟

569 B

⊟

449 B

⊟

538 B

⊟

424 B

⊟

544 B

⊟

440 B

⊟

522 B

⊟

418 B

⊟

584 B

⊟

482 B

⊟

618 B

⊟

514 B

⊟

611 B

⊟

499 B

⊟

549 B

⊟

441 B

⊟

634 B

⊟

528 B

⊟

530 B

⊟

422 B

⊟

487 B

⊟

389 B

⊟

487 B

⊟

383 B

⊟

818 B

⊟

688 B

⊟

550 B

⊟

446 B

⊟

532 B

⊟

412 B

⊟

497 B

⊟

407 B

⊟

716 B

⊟

578 B

⊟

556 B

⊟

438 B

⊟

672 B

⊟

550 B

⊟

636 B

⊟

520 B

⊟

600 B

⊟

476 B

⊟

596 B

⊟

470 B

⊟

590 B

⊟

464 B

⊟

553 B

⊟

433 B

⊟

447 B

⊟

343 B

⊟

545 B

⊟

441 B

⊟

549 B

⊟

443 B

⊟

602 B

⊟

486 B

⊟

741 B

⊟

625 B

⊟

484 B

⊟

376 B

⊟

492 B

⊟

382 B

⊟

474 B

⊟

348 B

⊟

532 B

⊟

412 B

⊟

425 B

⊟

319 B

⊟

492 B

⊟

382 B

⊟

552 B

⊟

442 B

⊟

452 B

⊟

360 B

⊟

543 B

⊟

429 B

⊟

562 B

⊟

454 B

⊟

426 B

⊟

334 B

⊟

467 B

⊟

357 B

⊟

391 B

⊟

297 B

⊟

575 B

⊟

461 B

⊟

799 B

⊟

691 B

⊟

388 B

⊟

288 B

⊟

472 B

⊟

364 B

⊟

572 B

⊟

470 B

⊟

481 B

⊟

371 B


Offset 1, 9 lines modified		Offset 1, 9 lines modified

1	·~~d17~~4~~72ab~~e~~fcb807d7591~~c8850~~cd97~~722·13~~65448~~·doc·optional·allegro5-doc_5.2.6.0-3_all.deb	1	·1e854f510e79644c3cb65ca802ffc781·1358272·doc·optional·allegro5-doc_5.2.6.0-3_all.deb
2	·55d816a0e9655c14c45b838bc116f67d·15720·libdevel·optional·liballegro-acodec5-dev_5.2.6.0-3_arm64.deb	2	·55d816a0e9655c14c45b838bc116f67d·15720·libdevel·optional·liballegro-acodec5-dev_5.2.6.0-3_arm64.deb
3	·a56c9f783ec1a1fcd3290ce2bab24b37·56620·debug·optional·liballegro-acodec5.2-dbgsym_5.2.6.0-3_arm64.deb	3	·a56c9f783ec1a1fcd3290ce2bab24b37·56620·debug·optional·liballegro-acodec5.2-dbgsym_5.2.6.0-3_arm64.deb
4	·77b053f71000937fb12bdec53a6781c2·32064·libs·optional·liballegro-acodec5.2_5.2.6.0-3_arm64.deb	4	·77b053f71000937fb12bdec53a6781c2·32064·libs·optional·liballegro-acodec5.2_5.2.6.0-3_arm64.deb
5	·bb2053988511fca6a24e93e76d3a04e8·18376·libdevel·optional·liballegro-audio5-dev_5.2.6.0-3_arm64.deb	5	·bb2053988511fca6a24e93e76d3a04e8·18376·libdevel·optional·liballegro-audio5-dev_5.2.6.0-3_arm64.deb
6	·84b8d25f7e21ae25ea5b6b931be08f77·97452·debug·optional·liballegro-audio5.2-dbgsym_5.2.6.0-3_arm64.deb	6	·84b8d25f7e21ae25ea5b6b931be08f77·97452·debug·optional·liballegro-audio5.2-dbgsym_5.2.6.0-3_arm64.deb
7	·2957ead9e1307ef802164d0cb8a116b7·51120·libs·optional·liballegro-audio5.2_5.2.6.0-3_arm64.deb	7	·2957ead9e1307ef802164d0cb8a116b7·51120·libs·optional·liballegro-audio5.2_5.2.6.0-3_arm64.deb
8	·303201df7ad944a9c595d4b6848b9a35·16800·libdevel·optional·liballegro-dialog5-dev_5.2.6.0-3_arm64.deb	8	·303201df7ad944a9c595d4b6848b9a35·16800·libdevel·optional·liballegro-dialog5-dev_5.2.6.0-3_arm64.deb


Offset 1, 3 lines modified		Offset 1, 3 lines modified
1	-rw-r--r--···0········0········0········4·2020-11-27·12:02:04.000000·debian-binary	1	-rw-r--r--···0········0········0········4·2020-11-27·12:02:04.000000·debian-binary
2	-rw-r--r--···0········0········0····30696·2020-11-27·12:02:04.000000·control.tar.xz	2	-rw-r--r--···0········0········0····30692·2020-11-27·12:02:04.000000·control.tar.xz
3	-rw-r--r--···0········0········0··13~~34560~~·2020-11-27·12:02:04.000000·data.tar.xz	3	-rw-r--r--···0········0········0··1327388·2020-11-27·12:02:04.000000·data.tar.xz


Offset 1, 13 lines modified		Offset 1, 13 lines modified
1	Package:·allegro5-doc	1	Package:·allegro5-doc
2	Source:·allegro5	2	Source:·allegro5
3	Version:·2:5.2.6.0-3	3	Version:·2:5.2.6.0-3
4	Architecture:·all	4	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:·5166	6	Installed-Size:·5066
7	Depends:·fonts-dejavu-core	7	Depends:·fonts-dejavu-core
8	Section:·doc	8	Section:·doc
9	Priority:·optional	9	Priority:·optional
10	Homepage:·http://liballeg.org/	10	Homepage:·http://liballeg.org/
11	Description:·documentation·for·the·Allegro·5·library	11	Description:·documentation·for·the·Allegro·5·library
12	·This·package·contains·the·Allegro·documentation·in·various·formats,	12	·This·package·contains·the·Allegro·documentation·in·various·formats,
13	·FAQs·and·other·documentation·about·the·Allegro·library,·source·of·the	13	·FAQs·and·other·documentation·about·the·Allegro·library,·source·of·the


Offset 167, 38 lines modified		Offset 167, 35 lines modified
167	<li><a·href="#al_is_acodec_addon_initialized">al_is_acodec_addon_initialized</a></li>	167	<li><a·href="#al_is_acodec_addon_initialized">al_is_acodec_addon_initialized</a></li>
168	<li><a·href="#al_get_allegro_acodec_version">al_get_allegro_acodec_version</a></li>	168	<li><a·href="#al_get_allegro_acodec_version">al_get_allegro_acodec_version</a></li>
169	</ul>	169	</ul>
170	</nav>	170	</nav>
171	<p>These·functions·are·declared·in·the·following·header·file.·Link·with·allegro_acodec.</p>	171	<p>These·functions·are·declared·in·the·following·header·file.·Link·with·allegro_acodec.</p>
172	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro_acodec.h></span></span></code></pre></div>	172	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro_acodec.h></span></span></code></pre></div>
173	<h1·id="al_init_acodec_addon">al_init_acodec_addon</h1>	173	<h1·id="al_init_acodec_addon">al_init_acodec_addon</h1>
174	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_init_acodec_addon(<span·class="dt">void</span>)</span>	174	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_init_acodec_addon(<span·class="dt">void</span>)</span></code></pre></div>
175	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="dt">bool</span>·al_init_acodec_addon(<span·class="dt">void</span>)</span></code></pre></div>
176	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/acodec/acodec.c#L21">Source·Code</a></p>	175	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/acodec/acodec.c#L21">Source·Code</a></p>
177	<p>This·function·registers·all·the·known·audio·file·type·handlers·for·<a·href="audio.html#al_load_sample">al_load_sample</a>,·<a·href="audio.html#al_save_sample">al_save_sample</a>,·<a·href="audio.html#al_load_audio_stream">al_load_audio_stream</a>,·etc.</p>	176	<p>This·function·registers·all·the·known·audio·file·type·handlers·for·<a·href="audio.html#al_load_sample">al_load_sample</a>,·<a·href="audio.html#al_save_sample">al_save_sample</a>,·<a·href="audio.html#al_load_audio_stream">al_load_audio_stream</a>,·etc.</p>
178	<p>Depending·on·what·libraries·are·available,·the·full·set·of·recognised·extensions·is:·.wav,·.flac,·.ogg,·.opus,·.it,·.mod,·.s3m,·.xm,·.voc.</p>	177	<p>Depending·on·what·libraries·are·available,·the·full·set·of·recognised·extensions·is:·.wav,·.flac,·.ogg,·.opus,·.it,·.mod,·.s3m,·.xm,·.voc.</p>
179	<p><em>Limitations:</em></p>	178	<p><em>Limitations:</em></p>
180	<ul>	179	<ul>
181	<li><p>Saving·is·only·supported·for·wav·files.</p></li>	180	<li><p>Saving·is·only·supported·for·wav·files.</p></li>
182	<li><p>The·wav·file·loader·currently·only·supports·8/16·bit·little·endian·PCM·files.·16·bits·are·used·when·saving·wav·files.·Use·flac·files·if·more·precision·is·required.</p></li>	181	<li><p>The·wav·file·loader·currently·only·supports·8/16·bit·little·endian·PCM·files.·16·bits·are·used·when·saving·wav·files.·Use·flac·files·if·more·precision·is·required.</p></li>
183	<li><p>Module·files·(.it,·.mod,·.s3m,·.xm)·are·often·composed·with·streaming·in·mind,·and·sometimes·cannot·be·easily·rendered·into·a·finite·length·sample.·Therefore·they·cannot·be·loaded·with·<a·href="audio.html#al_load_sample">al_load_sample</a>/<a·href="audio.html#al_load_sample_f">al_load_sample_f</a>·and·must·be·streamed·with·<a·href="audio.html#al_load_audio_stream">al_load_audio_stream</a>·or·<a·href="audio.html#al_load_audio_stream_f">al_load_audio_stream_f</a>.</p></li>	182	<li><p>Module·files·(.it,·.mod,·.s3m,·.xm)·are·often·composed·with·streaming·in·mind,·and·sometimes·cannot·be·easily·rendered·into·a·finite·length·sample.·Therefore·they·cannot·be·loaded·with·<a·href="audio.html#al_load_sample">al_load_sample</a>/<a·href="audio.html#al_load_sample_f">al_load_sample_f</a>·and·must·be·streamed·with·<a·href="audio.html#al_load_audio_stream">al_load_audio_stream</a>·or·<a·href="audio.html#al_load_audio_stream_f">al_load_audio_stream_f</a>.</p></li>
184	<li><p>.voc·file·streaming·is·unimplemented.</p></li>	183	<li><p>.voc·file·streaming·is·unimplemented.</p></li>
185	</ul>	184	</ul>
186	<p>Return·true·on·success.</p>	185	<p>Return·true·on·success.</p>
187	<h1·id="al_is_acodec_addon_initialized">al_is_acodec_addon_initialized</h1>	186	<h1·id="al_is_acodec_addon_initialized">al_is_acodec_addon_initialized</h1>
188	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_is_acodec_addon_initialized(<span·class="dt">void</span>)</span>	187	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_is_acodec_addon_initialized(<span·class="dt">void</span>)</span></code></pre></div>
189	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a><span·class="dt">bool</span>·al_is_acodec_addon_initialized(<span·class="dt">void</span>)</span></code></pre></div>
190	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/acodec/acodec.c#L77">Source·Code</a></p>	188	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/acodec/acodec.c#L77">Source·Code</a></p>
191	<p>Returns·true·if·the·acodec·addon·is·initialized,·otherwise·returns·false.</p>	189	<p>Returns·true·if·the·acodec·addon·is·initialized,·otherwise·returns·false.</p>
192	<p>Since:·5.2.6</p>	190	<p>Since:·5.2.6</p>
193	<h1·id="al_get_allegro_acodec_version">al_get_allegro_acodec_version</h1>	191	<h1·id="al_get_allegro_acodec_version">al_get_allegro_acodec_version</h1>
194	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="dt">uint32_t</span>·al_get_allegro_acodec_version(<span·class="dt">void</span>)</span>	192	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="dt">uint32_t</span>·al_get_allegro_acodec_version(<span·class="dt">void</span>)</span></code></pre></div>
195	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a><span·class="dt">uint32_t</span>·al_get_allegro_acodec_version(<span·class="dt">void</span>)</span></code></pre></div>
196	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/acodec/acodec.c#L13">Source·Code</a></p>	193	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/acodec/acodec.c#L13">Source·Code</a></p>
197	<p>Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as·<a·href="system.html#al_get_allegro_version">al_get_allegro_version</a>.</p>	194	<p>Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as·<a·href="system.html#al_get_allegro_version">al_get_allegro_version</a>.</p>
198	<p·class="timestamp">	195	<p·class="timestamp">
199	Allegro·version·5.2.6	196	Allegro·version·5.2.6
200	·-·Last·updated:·2025-02-07·20:10:12·UTC	197	·-·Last·updated:·2024-01-06·13:49:37·UTC
201	</p>	198	</p>
202	</div>	199	</div>
203	</body>	200	</body>
204	</html>	201	</html>


Offset 51, 15 lines modified		Offset 51, 14 lines modified
51	····*·al_is_acodec_addon_initialized	51	····*·al_is_acodec_addon_initialized
52	····*·al_get_allegro_acodec_version	52	····*·al_get_allegro_acodec_version
53	These·functions·are·declared·in·the·following·header·file.·Link·with	53	These·functions·are·declared·in·the·following·header·file.·Link·with
54	allegro_acodec.	54	allegro_acodec.
55	·#include·<allegro5/allegro_acodec.h>	55	·#include·<allegro5/allegro_acodec.h>
56	****·al_init_acodec_addon·****	56	****·al_init_acodec_addon·****
57	bool·al_init_acodec_addon(void)	57	bool·al_init_acodec_addon(void)
58	bool·al_init_acodec_addon(void)
59	Source_Code	58	Source_Code
60	This·function·registers·all·the·known·audio·file·type·handlers·for	59	This·function·registers·all·the·known·audio·file·type·handlers·for
61	al_load_sample,·al_save_sample,·al_load_audio_stream,·etc.	60	al_load_sample,·al_save_sample,·al_load_audio_stream,·etc.
62	Depending·on·what·libraries·are·available,·the·full·set·of·recognised	61	Depending·on·what·libraries·are·available,·the·full·set·of·recognised
63	extensions·is:·.wav,·.flac,·.ogg,·.opus,·.it,·.mod,·.s3m,·.xm,·.voc.	62	extensions·is:·.wav,·.flac,·.ogg,·.opus,·.it,·.mod,·.s3m,·.xm,·.voc.
64	Limitations:	63	Limitations:
65	····*·Saving·is·only·supported·for·wav·files.	64	····*·Saving·is·only·supported·for·wav·files.
Offset 71, 18 lines modified		Offset 70, 16 lines modified
71	······sample.·Therefore·they·cannot·be·loaded·with·al_load_sample/	70	······sample.·Therefore·they·cannot·be·loaded·with·al_load_sample/
72	······al_load_sample_f·and·must·be·streamed·with·al_load_audio_stream·or	71	······al_load_sample_f·and·must·be·streamed·with·al_load_audio_stream·or
73	······al_load_audio_stream_f.	72	······al_load_audio_stream_f.
74	····*·.voc·file·streaming·is·unimplemented.	73	····*·.voc·file·streaming·is·unimplemented.
75	Return·true·on·success.	74	Return·true·on·success.
76	****·al_is_acodec_addon_initialized·****	75	****·al_is_acodec_addon_initialized·****
77	bool·al_is_acodec_addon_initialized(void)	76	bool·al_is_acodec_addon_initialized(void)
78	bool·al_is_acodec_addon_initialized(void)
79	Source_Code	77	Source_Code
80	Returns·true·if·the·acodec·addon·is·initialized,·otherwise·returns·false.	78	Returns·true·if·the·acodec·addon·is·initialized,·otherwise·returns·false.
81	Since:·5.2.6	79	Since:·5.2.6
82	****·al_get_allegro_acodec_version·****	80	****·al_get_allegro_acodec_version·****
83	uint32_t·al_get_allegro_acodec_version(void)	81	uint32_t·al_get_allegro_acodec_version(void)
84	uint32_t·al_get_allegro_acodec_version(void)
85	Source_Code	82	Source_Code
86	Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as	83	Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as
87	al_get_allegro_version.	84	al_get_allegro_version.
88	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:12·UTC	85	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:37·UTC


Offset 302, 15 lines modified		Offset 302, 14 lines modified
302	See·Audio_recording·for·Allegroâs·audio·recording·API,·which·is,·as·of·now,	302	See·Audio_recording·for·Allegroâs·audio·recording·API,·which·is,·as·of·now,
303	still·unstable·and·subject·to·change.	303	still·unstable·and·subject·to·change.
304	****·Audio·types·****	304	****·Audio·types·****
305	Events·sent·by·al_get_audio_stream_event_source·or	305	Events·sent·by·al_get_audio_stream_event_source·or
306	al_get_audio_recorder_event_source.	306	al_get_audio_recorder_event_source.
307	***·ALLEGRO_AUDIO_EVENT_TYPE·***	307	***·ALLEGRO_AUDIO_EVENT_TYPE·***
308	enum·ALLEGRO_AUDIO_EVENT_TYPE	308	enum·ALLEGRO_AUDIO_EVENT_TYPE
309	enum·ALLEGRO_AUDIO_EVENT_TYPE
310	Source_Code	309	Source_Code
311	**·ALLEGRO_EVENT_AUDIO_STREAM_FRAGMENT·**	310	**·ALLEGRO_EVENT_AUDIO_STREAM_FRAGMENT·**
312	Sent·when·a·stream·fragment·is·ready·to·be·filled·in.·See	311	Sent·when·a·stream·fragment·is·ready·to·be·filled·in.·See
313	al_get_audio_stream_fragment.	312	al_get_audio_stream_fragment.
314	**·ALLEGRO_EVENT_AUDIO_STREAM_FINISHED·**	313	**·ALLEGRO_EVENT_AUDIO_STREAM_FINISHED·**
315	Sent·when·a·stream·is·finished.	314	Sent·when·a·stream·is·finished.
316	**·ALLEGRO_EVENT_AUDIO_RECORDER_FRAGMENT·**	315	**·ALLEGRO_EVENT_AUDIO_RECORDER_FRAGMENT·**
Offset 318, 15 lines modified		Offset 317, 14 lines modified
318	to·ALLEGRO_AUDIO_RECORDER_EVENT·via·al_get_audio_recorder_event.	317	to·ALLEGRO_AUDIO_RECORDER_EVENT·via·al_get_audio_recorder_event.
319	You·must·always·check·the·values·for·the·buffer·and·samples·as·they·are·not	318	You·must·always·check·the·values·for·the·buffer·and·samples·as·they·are·not
320	guaranteed·to·be·exactly·what·was·originally·specified.	319	guaranteed·to·be·exactly·what·was·originally·specified.
321	Since:·5.1.1	320	Since:·5.1.1
322	·····Unstable_API:·The·API·may·need·a·slight·redesign.	321	·····Unstable_API:·The·API·may·need·a·slight·redesign.
323	***·ALLEGRO_AUDIO_DEPTH·***	322	***·ALLEGRO_AUDIO_DEPTH·***
324	enum·ALLEGRO_AUDIO_DEPTH	323	enum·ALLEGRO_AUDIO_DEPTH
325	enum·ALLEGRO_AUDIO_DEPTH
326	Source_Code	324	Source_Code
327	Sample·depth·and·type·as·well·as·signedness.·Mixers·only·use·32-bit·signed	325	Sample·depth·and·type·as·well·as·signedness.·Mixers·only·use·32-bit·signed
328	float·(-1..+1),·or·16-bit·signed·integers.·Signedness·is·determined·by·an	326	float·(-1..+1),·or·16-bit·signed·integers.·Signedness·is·determined·by·an
329	âunsignedâ·bit-flag·applied·to·the·depth·value.	327	âunsignedâ·bit-flag·applied·to·the·depth·value.
330	····*·ALLEGRO_AUDIO_DEPTH_INT8	328	····*·ALLEGRO_AUDIO_DEPTH_INT8
331	····*·ALLEGRO_AUDIO_DEPTH_INT16	329	····*·ALLEGRO_AUDIO_DEPTH_INT16
332	····*·ALLEGRO_AUDIO_DEPTH_INT24	330	····*·ALLEGRO_AUDIO_DEPTH_INT24
Offset 334, 98 lines modified		Offset 332, 89 lines modified
334	····*·ALLEGRO_AUDIO_DEPTH_UNSIGNED	332	····*·ALLEGRO_AUDIO_DEPTH_UNSIGNED
335	For·convenience:	333	For·convenience:
336	····*·ALLEGRO_AUDIO_DEPTH_UINT8	334	····*·ALLEGRO_AUDIO_DEPTH_UINT8
337	····*·ALLEGRO_AUDIO_DEPTH_UINT16	335	····*·ALLEGRO_AUDIO_DEPTH_UINT16
338	····*·ALLEGRO_AUDIO_DEPTH_UINT24	336	····*·ALLEGRO_AUDIO_DEPTH_UINT24
339	***·ALLEGRO_AUDIO_PAN_NONE·***	337	***·ALLEGRO_AUDIO_PAN_NONE·***
340	#define·ALLEGRO_AUDIO_PAN_NONE······(-1000.0f)	338	#define·ALLEGRO_AUDIO_PAN_NONE······(-1000.0f)
341	#define·ALLEGRO_AUDIO_PAN_NONE······(-1000.0f)
342	Source_Code	339	Source_Code
343	A·special·value·for·the·pan·property·of·sample·instances·and·audio·streams.·Use	340	A·special·value·for·the·pan·property·of·sample·instances·and·audio·streams.·Use
344	this·value·to·disable·panning·on·sample·instances·and·audio·streams,·and·play	341	this·value·to·disable·panning·on·sample·instances·and·audio·streams,·and·play
345	them·without·attentuation·implied·by·panning·support.	342	them·without·attentuation·implied·by·panning·support.
346	ALLEGRO_AUDIO_PAN_NONE·is·different·from·a·pan·value·of·0.0·(centered)·because,	343	ALLEGRO_AUDIO_PAN_NONE·is·different·from·a·pan·value·of·0.0·(centered)·because,
347	when·panning·is·enabled,·we·try·to·maintain·a·constant·sound·power·level·as·a	344	when·panning·is·enabled,·we·try·to·maintain·a·constant·sound·power·level·as·a
348	sample·is·panned·from·left·to·right.·A·sound·coming·out·of·one·speaker·should	345	sample·is·panned·from·left·to·right.·A·sound·coming·out·of·one·speaker·should
349	sound·as·loud·as·it·does·when·split·over·two·speakers.·As·a·consequence,·a	346	sound·as·loud·as·it·does·when·split·over·two·speakers.·As·a·consequence,·a
350	sample·with·pan·value·0.0·will·be·3·dB·softer·than·the·original·level.	347	sample·with·pan·value·0.0·will·be·3·dB·softer·than·the·original·level.
351	(Please·correct·us·if·this·is·wrong.)	348	(Please·correct·us·if·this·is·wrong.)
352	***·ALLEGRO_CHANNEL_CONF·***	349	***·ALLEGRO_CHANNEL_CONF·***
353	enum·ALLEGRO_CHANNEL_CONF	350	enum·ALLEGRO_CHANNEL_CONF
354	enum·ALLEGRO_CHANNEL_CONF
355	Source_Code	351	Source_Code
356	Speaker·configuration·(mono,·stereo,·2.1,·etc).	352	Speaker·configuration·(mono,·stereo,·2.1,·etc).
357	····*·ALLEGRO_CHANNEL_CONF_1	353	····*·ALLEGRO_CHANNEL_CONF_1
358	····*·ALLEGRO_CHANNEL_CONF_2	354	····*·ALLEGRO_CHANNEL_CONF_2
359	····*·ALLEGRO_CHANNEL_CONF_3	355	····*·ALLEGRO_CHANNEL_CONF_3
360	····*·ALLEGRO_CHANNEL_CONF_4	356	····*·ALLEGRO_CHANNEL_CONF_4
361	····*·ALLEGRO_CHANNEL_CONF_5_1	357	····*·ALLEGRO_CHANNEL_CONF_5_1
362	····*·ALLEGRO_CHANNEL_CONF_6_1	358	····*·ALLEGRO_CHANNEL_CONF_6_1
363	····*·ALLEGRO_CHANNEL_CONF_7_1	359	····*·ALLEGRO_CHANNEL_CONF_7_1
364	***·ALLEGRO_MIXER·***	360	***·ALLEGRO_MIXER·***
365	typedef·struct·ALLEGRO_MIXER·ALLEGRO_MIXER;	361	typedef·struct·ALLEGRO_MIXER·ALLEGRO_MIXER;
366	typedef·struct·ALLEGRO_MIXER·ALLEGRO_MIXER;
367	Source_Code	362	Source_Code
368	A·mixer·mixes·together·attached·streams·into·a·single·buffer.·In·the·process,	363	A·mixer·mixes·together·attached·streams·into·a·single·buffer.·In·the·process,
369	it·converts·channel·configurations,·sample·frequencies·and·audio·depths·of·the	364	it·converts·channel·configurations,·sample·frequencies·and·audio·depths·of·the
370	attached·sample·instances·and·audio·streams·accordingly.·You·can·control·the	365	attached·sample·instances·and·audio·streams·accordingly.·You·can·control·the
371	quality·of·this·conversion·using·ALLEGRO_MIXER_QUALITY.	366	quality·of·this·conversion·using·ALLEGRO_MIXER_QUALITY.
372	When·going·from·mono·to·stereo·(and·above),·the·mixer·reduces·the·volume·of	367	When·going·from·mono·to·stereo·(and·above),·the·mixer·reduces·the·volume·of
373	both·channels·by·sqrt(2).·When·going·from·stereo·(and·above)·to·mono,·the·mixer	368	both·channels·by·sqrt(2).·When·going·from·stereo·(and·above)·to·mono,·the·mixer
374	reduces·the·volume·of·the·left·and·right·channels·by·sqrt(2)·before·adding·them	369	reduces·the·volume·of·the·left·and·right·channels·by·sqrt(2)·before·adding·them
375	to·the·center·channel·(if·present).	370	to·the·center·channel·(if·present).
376	***·ALLEGRO_MIXER_QUALITY·***	371	***·ALLEGRO_MIXER_QUALITY·***
377	enum·ALLEGRO_MIXER_QUALITY	372	enum·ALLEGRO_MIXER_QUALITY
378	enum·ALLEGRO_MIXER_QUALITY
379	Source_Code	373	Source_Code
380	····*·ALLEGRO_MIXER_QUALITY_POINT·-·point·sampling	374	····*·ALLEGRO_MIXER_QUALITY_POINT·-·point·sampling
381	····*·ALLEGRO_MIXER_QUALITY_LINEAR·-·linear·interpolation	375	····*·ALLEGRO_MIXER_QUALITY_LINEAR·-·linear·interpolation
382	····*·ALLEGRO_MIXER_QUALITY_CUBIC·-·cubic·interpolation·(since:·5.0.8,·5.1.4)	376	····*·ALLEGRO_MIXER_QUALITY_CUBIC·-·cubic·interpolation·(since:·5.0.8,·5.1.4)
383	***·ALLEGRO_PLAYMODE·***	377	***·ALLEGRO_PLAYMODE·***
384	enum·ALLEGRO_PLAYMODE	378	enum·ALLEGRO_PLAYMODE
385	enum·ALLEGRO_PLAYMODE
386	Source_Code	379	Source_Code
387	Sample·and·stream·playback·mode.	380	Sample·and·stream·playback·mode.
388	····*·ALLEGRO_PLAYMODE_ONCE	381	····*·ALLEGRO_PLAYMODE_ONCE
389	····*·ALLEGRO_PLAYMODE_LOOP	382	····*·ALLEGRO_PLAYMODE_LOOP
390	····*·ALLEGRO_PLAYMODE_BIDIR	383	····*·ALLEGRO_PLAYMODE_BIDIR
391	***·ALLEGRO_SAMPLE_ID·***	384	***·ALLEGRO_SAMPLE_ID·***
392	typedef·struct·ALLEGRO_SAMPLE_ID·ALLEGRO_SAMPLE_ID;	385	typedef·struct·ALLEGRO_SAMPLE_ID·ALLEGRO_SAMPLE_ID;
393	typedef·struct·ALLEGRO_SAMPLE_ID·ALLEGRO_SAMPLE_ID;
394	Source_Code	386	Source_Code
395	An·ALLEGRO_SAMPLE_ID·represents·a·sample·being·played·via·al_play_sample.·It	387	An·ALLEGRO_SAMPLE_ID·represents·a·sample·being·played·via·al_play_sample.·It
396	can·be·used·to·later·stop·the·sample·with·al_stop_sample.·The·underlying	388	can·be·used·to·later·stop·the·sample·with·al_stop_sample.·The·underlying
397	ALLEGRO_SAMPLE_INSTANCE·can·be·extracted·using·al_lock_sample_id.	389	ALLEGRO_SAMPLE_INSTANCE·can·be·extracted·using·al_lock_sample_id.
398	***·ALLEGRO_SAMPLE·***	390	***·ALLEGRO_SAMPLE·***
399	typedef·struct·ALLEGRO_SAMPLE·ALLEGRO_SAMPLE;	391	typedef·struct·ALLEGRO_SAMPLE·ALLEGRO_SAMPLE;
400	typedef·struct·ALLEGRO_SAMPLE·ALLEGRO_SAMPLE;
401	Source_Code	392	Source_Code
402	An·ALLEGRO_SAMPLE·object·stores·the·data·necessary·for·playing·pre-defined	393	An·ALLEGRO_SAMPLE·object·stores·the·data·necessary·for·playing·pre-defined
403	digital·audio.·It·holds·a·user-specified·PCM·data·buffer·and·information·about	394	digital·audio.·It·holds·a·user-specified·PCM·data·buffer·and·information·about
404	its·format·(data·length,·depth,·frequency,·channel·configuration).·You·can·have	395	its·format·(data·length,·depth,·frequency,·channel·configuration).·You·can·have
405	the·same·ALLEGRO_SAMPLE·playing·multiple·times·simultaneously.	396	the·same·ALLEGRO_SAMPLE·playing·multiple·times·simultaneously.
406	See·also:·ALLEGRO_SAMPLE_INSTANCE	397	See·also:·ALLEGRO_SAMPLE_INSTANCE
407	***·ALLEGRO_SAMPLE_INSTANCE·***	398	***·ALLEGRO_SAMPLE_INSTANCE·***
408	typedef·struct·ALLEGRO_SAMPLE_INSTANCE·ALLEGRO_SAMPLE_INSTANCE;	399	typedef·struct·ALLEGRO_SAMPLE_INSTANCE·ALLEGRO_SAMPLE_INSTANCE;
409	typedef·struct·ALLEGRO_SAMPLE_INSTANCE·ALLEGRO_SAMPLE_INSTANCE;
410	Source_Code	400	Source_Code
411	An·ALLEGRO_SAMPLE_INSTANCE·object·represents·a·playable·instance·of·a	401	An·ALLEGRO_SAMPLE_INSTANCE·object·represents·a·playable·instance·of·a
412	predefined·sound·effect.·It·holds·information·about·how·the·effect·should·be	402	predefined·sound·effect.·It·holds·information·about·how·the·effect·should·be
413	played:·These·playback·parameters·consist·of·the·looping·mode,·loop·start/end	403	played:·These·playback·parameters·consist·of·the·looping·mode,·loop·start/end
414	points,·playing·position,·speed,·gain,·pan·and·the·playmode.·Whether·a·sample	404	points,·playing·position,·speed,·gain,·pan·and·the·playmode.·Whether·a·sample
415	instance·is·currently·playing·or·paused·is·also·one·of·its·properties.	405	instance·is·currently·playing·or·paused·is·also·one·of·its·properties.
416	An·instance·uses·the·data·from·an·ALLEGRO_SAMPLE·object.·Multiple·instances·may	406	An·instance·uses·the·data·from·an·ALLEGRO_SAMPLE·object.·Multiple·instances·may
417	be·created·from·the·same·ALLEGRO_SAMPLE.·An·ALLEGRO_SAMPLE·must·not·be	407	be·created·from·the·same·ALLEGRO_SAMPLE.·An·ALLEGRO_SAMPLE·must·not·be
418	destroyed·while·there·are·instances·which·reference·it.	408	destroyed·while·there·are·instances·which·reference·it.
419	To·actually·produce·audio·output,·an·ALLEGRO_SAMPLE_INSTANCE·must·be·attached	409	To·actually·produce·audio·output,·an·ALLEGRO_SAMPLE_INSTANCE·must·be·attached
420	to·an·ALLEGRO_MIXER·which·eventually·reaches·an·ALLEGRO_VOICE·object.	410	to·an·ALLEGRO_MIXER·which·eventually·reaches·an·ALLEGRO_VOICE·object.
421	See·also:·ALLEGRO_SAMPLE	411	See·also:·ALLEGRO_SAMPLE
422	***·ALLEGRO_AUDIO_STREAM·***	412	***·ALLEGRO_AUDIO_STREAM·***
423	typedef·struct·ALLEGRO_AUDIO_STREAM·ALLEGRO_AUDIO_STREAM;	413	typedef·struct·ALLEGRO_AUDIO_STREAM·ALLEGRO_AUDIO_STREAM;
424	typedef·struct·ALLEGRO_AUDIO_STREAM·ALLEGRO_AUDIO_STREAM;
425	Source_Code	414	Source_Code
426	An·ALLEGRO_AUDIO_STREAM·object·is·used·to·stream·generated·audio·to·the·sound	415	An·ALLEGRO_AUDIO_STREAM·object·is·used·to·stream·generated·audio·to·the·sound
427	device,·in·real-time.·This·is·done·by·reading·from·a·buffer,·which·is·split	416	device,·in·real-time.·This·is·done·by·reading·from·a·buffer,·which·is·split
428	into·a·number·of·fragments.·Whenever·a·fragment·has·finished·playing,·the·user	417	into·a·number·of·fragments.·Whenever·a·fragment·has·finished·playing,·the·user
Max diff block lines reached; 62736/68813 bytes (91.17%) of diff not shown.


Offset 97, 124 lines modified		Offset 97, 108 lines modified
97	try·to·be·close·to·the·sRGB·specification.·And·so·if·in·an·Allegro·game·you	97	try·to·be·close·to·the·sRGB·specification.·And·so·if·in·an·Allegro·game·you
98	display·something·with·color	98	display·something·with·color
99	al_map_rgb_f(0.5,·0.5,·0,5)	99	al_map_rgb_f(0.5,·0.5,·0,5)
100	then·it·will·appear·at·about·half·brightness·(even·though·the·actual·brightness	100	then·it·will·appear·at·about·half·brightness·(even·though·the·actual·brightness
101	output·of·the·monitor·will·be·less·than·half).	101	output·of·the·monitor·will·be·less·than·half).
102	****·al_color_cmyk·****	102	****·al_color_cmyk·****
103	ALLEGRO_COLOR·al_color_cmyk(float·c,·float·m,·float·y,·float·k)	103	ALLEGRO_COLOR·al_color_cmyk(float·c,·float·m,·float·y,·float·k)
104	ALLEGRO_COLOR·al_color_cmyk(float·c,·float·m,·float·y,·float·k)
105	Source_Code	104	Source_Code
106	Return·an·ALLEGRO_COLOR·structure·from·CMYK·values·(cyan,·magenta,·yellow,	105	Return·an·ALLEGRO_COLOR·structure·from·CMYK·values·(cyan,·magenta,·yellow,
107	black).	106	black).
108	See·also:·al_color_cmyk_to_rgb,·al_color_rgb_to_cmyk	107	See·also:·al_color_cmyk_to_rgb,·al_color_rgb_to_cmyk
109	****·al_color_cmyk_to_rgb·****	108	****·al_color_cmyk_to_rgb·****
110	void·al_color_cmyk_to_rgb(float·cyan,·float·magenta,·float·yellow,	109	void·al_color_cmyk_to_rgb(float·cyan,·float·magenta,·float·yellow,
111	····float·key,·float·red,·float·green,·float·*blue)	110	····float·key,·float·red,·float·green,·float·*blue)
112	void·al_color_cmyk_to_rgb(float·cyan,·float·magenta,·float·yellow,
113	····float·key,·float·red,·float·green,·float·*blue)
114	Source_Code	111	Source_Code
115	Convert·CMYK·values·to·RGB·values.	112	Convert·CMYK·values·to·RGB·values.
116	See·also:·al_color_cmyk,·al_color_rgb_to_cmyk	113	See·also:·al_color_cmyk,·al_color_rgb_to_cmyk
117	****·al_color_hsl·****	114	****·al_color_hsl·****
118	ALLEGRO_COLOR·al_color_hsl(float·h,·float·s,·float·l)	115	ALLEGRO_COLOR·al_color_hsl(float·h,·float·s,·float·l)
119	ALLEGRO_COLOR·al_color_hsl(float·h,·float·s,·float·l)
120	Source_Code	116	Source_Code
121	Return·an·ALLEGRO_COLOR·structure·from·HSL·(hue,·saturation,·lightness)·values.	117	Return·an·ALLEGRO_COLOR·structure·from·HSL·(hue,·saturation,·lightness)·values.
122	Parameters:	118	Parameters:
123	····*·hue·-·Color·hue·angle·in·the·range·0..360	119	····*·hue·-·Color·hue·angle·in·the·range·0..360
124	····*·saturation·-·Color·saturation·in·the·range·0..1	120	····*·saturation·-·Color·saturation·in·the·range·0..1
125	····*·lightness·-·Color·lightness·in·the·range·0..1	121	····*·lightness·-·Color·lightness·in·the·range·0..1
126	See·also:·al_color_hsl_to_rgb,·al_color_hsv	122	See·also:·al_color_hsl_to_rgb,·al_color_hsv
127	****·al_color_hsl_to_rgb·****	123	****·al_color_hsl_to_rgb·****
128	void·al_color_hsl_to_rgb(float·hue,·float·saturation,·float·lightness,	124	void·al_color_hsl_to_rgb(float·hue,·float·saturation,·float·lightness,
129	···float·red,·float·green,·float·*blue)	125	···float·red,·float·green,·float·*blue)
130	void·al_color_hsl_to_rgb(float·hue,·float·saturation,·float·lightness,
131	···float·red,·float·green,·float·*blue)
132	Source_Code	126	Source_Code
133	Convert·values·in·HSL·color·model·to·RGB·color·model.	127	Convert·values·in·HSL·color·model·to·RGB·color·model.
134	Parameters:	128	Parameters:
135	····*·hue·-·Color·hue·angle·in·the·range·0..360	129	····*·hue·-·Color·hue·angle·in·the·range·0..360
136	····*·saturation·-·Color·saturation·in·the·range·0..1	130	····*·saturation·-·Color·saturation·in·the·range·0..1
137	····*·lightness·-·Color·lightness·in·the·range·0..1	131	····*·lightness·-·Color·lightness·in·the·range·0..1
138	····*·red,·green,·blue·-·returned·RGB·values·in·the·range·0..1	132	····*·red,·green,·blue·-·returned·RGB·values·in·the·range·0..1
139	See·also:·al_color_rgb_to_hsl,·al_color_hsl,·al_color_hsv_to_rgb	133	See·also:·al_color_rgb_to_hsl,·al_color_hsl,·al_color_hsv_to_rgb
140	****·al_color_hsv·****	134	****·al_color_hsv·****
141	ALLEGRO_COLOR·al_color_hsv(float·h,·float·s,·float·v)	135	ALLEGRO_COLOR·al_color_hsv(float·h,·float·s,·float·v)
142	ALLEGRO_COLOR·al_color_hsv(float·h,·float·s,·float·v)
143	Source_Code	136	Source_Code
144	Return·an·ALLEGRO_COLOR·structure·from·HSV·(hue,·saturation,·value)·values.	137	Return·an·ALLEGRO_COLOR·structure·from·HSV·(hue,·saturation,·value)·values.
145	Parameters:	138	Parameters:
146	····*·hue·-·Color·hue·angle·in·the·range·0..360	139	····*·hue·-·Color·hue·angle·in·the·range·0..360
147	····*·saturation·-·Color·saturation·in·the·range·0..1	140	····*·saturation·-·Color·saturation·in·the·range·0..1
148	····*·value·-·Color·value·in·the·range·0..1	141	····*·value·-·Color·value·in·the·range·0..1
149	See·also:·al_color_hsv_to_rgb,·al_color_hsl	142	See·also:·al_color_hsv_to_rgb,·al_color_hsl
150	****·al_color_hsv_to_rgb·****	143	****·al_color_hsv_to_rgb·****
151	void·al_color_hsv_to_rgb(float·hue,·float·saturation,·float·value,	144	void·al_color_hsv_to_rgb(float·hue,·float·saturation,·float·value,
152	···float·red,·float·green,·float·*blue)	145	···float·red,·float·green,·float·*blue)
153	void·al_color_hsv_to_rgb(float·hue,·float·saturation,·float·value,
154	···float·red,·float·green,·float·*blue)
155	Source_Code	146	Source_Code
156	Convert·values·in·HSV·color·model·to·RGB·color·model.	147	Convert·values·in·HSV·color·model·to·RGB·color·model.
157	Parameters:	148	Parameters:
158	····*·hue·-·Color·hue·angle·in·the·range·0..360	149	····*·hue·-·Color·hue·angle·in·the·range·0..360
159	····*·saturation·-·Color·saturation·in·the·range·0..1	150	····*·saturation·-·Color·saturation·in·the·range·0..1
160	····*·value·-·Color·value·in·the·range·0..1	151	····*·value·-·Color·value·in·the·range·0..1
161	····*·red,·green,·blue·-·returned·RGB·values·in·the·range·0..1	152	····*·red,·green,·blue·-·returned·RGB·values·in·the·range·0..1
162	See·also:·al_color_rgb_to_hsv,·al_color_hsv,·al_color_hsl_to_rgb	153	See·also:·al_color_rgb_to_hsv,·al_color_hsv,·al_color_hsl_to_rgb
163	****·al_color_html·****	154	****·al_color_html·****
164	ALLEGRO_COLOR·al_color_html(char·const·*string)	155	ALLEGRO_COLOR·al_color_html(char·const·*string)
165	ALLEGRO_COLOR·al_color_html(char·const·*string)
166	Source_Code	156	Source_Code
167	Interprets·an·HTML-style·hex·number·(e.g.Â #00faff)·as·a·color.·The·accepted	157	Interprets·an·HTML-style·hex·number·(e.g.Â #00faff)·as·a·color.·The·accepted
168	format·is·the·same·as·al_color_html_to_rgb.	158	format·is·the·same·as·al_color_html_to_rgb.
169	Returns·the·interpreted·color,·or·al_map_rgba(0,·0,·0,·0)·if·the·string·could	159	Returns·the·interpreted·color,·or·al_map_rgba(0,·0,·0,·0)·if·the·string·could
170	not·be·parsed.	160	not·be·parsed.
171	·····Note:·the·behaviour·on·invalid·strings·is·different·from·Allegro	161	·····Note:·the·behaviour·on·invalid·strings·is·different·from·Allegro
172	·····5.0.x.	162	·····5.0.x.
173	See·also:·al_color_html_to_rgb,·al_color_rgb_to_html	163	See·also:·al_color_html_to_rgb,·al_color_rgb_to_html
174	****·al_color_html_to_rgb·****	164	****·al_color_html_to_rgb·****
175	bool·al_color_html_to_rgb(char·const·*string,	165	bool·al_color_html_to_rgb(char·const·*string,
176	···float·red,·float·green,·float·*blue)	166	···float·red,·float·green,·float·*blue)
177	bool·al_color_html_to_rgb(char·const·*string,
178	···float·red,·float·green,·float·*blue)
179	Source_Code	167	Source_Code
180	Interprets·an·HTML-style·hex·number·(e.g.Â #00faff)·as·a·color.·The·only	168	Interprets·an·HTML-style·hex·number·(e.g.Â #00faff)·as·a·color.·The·only
181	accepted·formats·are·â#RRGGBBâ·and·âRRGGBBâ·where·R,·G,·B·are	169	accepted·formats·are·â#RRGGBBâ·and·âRRGGBBâ·where·R,·G,·B·are
182	hexadecimal·digits·[0-9A-Fa-f].	170	hexadecimal·digits·[0-9A-Fa-f].
183	Returns·true·on·success,·false·on·failure.·On·failure·all·components·are·set·to	171	Returns·true·on·success,·false·on·failure.·On·failure·all·components·are·set·to
184	zero.	172	zero.
185	·····Note:·the·behaviour·on·invalid·strings·is·different·from·Allegro	173	·····Note:·the·behaviour·on·invalid·strings·is·different·from·Allegro
186	·····5.0.x.	174	·····5.0.x.
187	See·also:·al_color_html,·al_color_rgb_to_html	175	See·also:·al_color_html,·al_color_rgb_to_html
188	****·al_color_rgb_to_html·****	176	****·al_color_rgb_to_html·****
189	void·al_color_rgb_to_html(float·red,·float·green,·float·blue,	177	void·al_color_rgb_to_html(float·red,·float·green,·float·blue,
190	····char·*string)	178	····char·*string)
191	void·al_color_rgb_to_html(float·red,·float·green,·float·blue,
192	····char·*string)
193	Source_Code	179	Source_Code
194	Create·an·HTML-style·string·representation·of·an·ALLEGRO_COLOR,·e.g.Â #00faff.	180	Create·an·HTML-style·string·representation·of·an·ALLEGRO_COLOR,·e.g.Â #00faff.
195	Parameters:	181	Parameters:
196	····*·red,·green,·blue·-·The·color·components·in·the·range·0..1.	182	····*·red,·green,·blue·-·The·color·components·in·the·range·0..1.
197	····*·string·-·A·pointer·to·a·buffer·of·at·least·8·bytes,·into·which·the·result	183	····*·string·-·A·pointer·to·a·buffer·of·at·least·8·bytes,·into·which·the·result
198	······will·be·written·(including·the·NUL·terminator).	184	······will·be·written·(including·the·NUL·terminator).
199	Example:	185	Example:
200	char·html[8];	186	char·html[8];
201	al_color_rgb_to_html(1,·0,·0,·html);	187	al_color_rgb_to_html(1,·0,·0,·html);
202	Now·html·will·contain·â#ff0000â.	188	Now·html·will·contain·â#ff0000â.
203	See·also:·al_color_html,·al_color_html_to_rgb	189	See·also:·al_color_html,·al_color_html_to_rgb
204	****·al_color_name·****	190	****·al_color_name·****
205	ALLEGRO_COLOR·al_color_name(char·const·*name)	191	ALLEGRO_COLOR·al_color_name(char·const·*name)
206	ALLEGRO_COLOR·al_color_name(char·const·*name)
207	Source_Code	192	Source_Code
208	Return·an·ALLEGRO_COLOR·with·the·given·name.·If·the·color·is·not·found·then	193	Return·an·ALLEGRO_COLOR·with·the·given·name.·If·the·color·is·not·found·then
209	black·is·returned.	194	black·is·returned.
210	See·al_color_name_to_rgb·for·the·list·of·names.	195	See·al_color_name_to_rgb·for·the·list·of·names.
211	****·al_color_name_to_rgb·****	196	****·al_color_name_to_rgb·****
212	bool·al_color_name_to_rgb(char·const·name,·float·r,·float·g,·float·b)	197	bool·al_color_name_to_rgb(char·const·name,·float·r,·float·g,·float·b)
213	bool·al_color_name_to_rgb(char·const·name,·float·r,·float·g,·float·b)
214	Source_Code	198	Source_Code
215	Parameters:	199	Parameters:
216	····*·name·-·The·(lowercase)·name·of·the·color.	200	····*·name·-·The·(lowercase)·name·of·the·color.
217	····*·r,·g,·b·-·If·one·of·the·recognized·color·names·below·is·passed,·the	201	····*·r,·g,·b·-·If·one·of·the·recognized·color·names·below·is·passed,·the
218	······corresponding·RGB·values·in·the·range·0..1·are·written.	202	······corresponding·RGB·values·in·the·range·0..1·are·written.
219	The·148·recognized·names·are:	203	The·148·recognized·names·are:
220	·····aliceblue,·antiquewhite,·aqua,·aquamarine,·azure,·beige,·bisque,	204	·····aliceblue,·antiquewhite,·aqua,·aquamarine,·azure,·beige,·bisque,
Offset 247, 124 lines modified		Offset 231, 104 lines modified
247	dimgray·=·dimgrey,·fuchsia·=·purple,·gray·=·grey,·lightgray·=·lightgrey,	231	dimgray·=·dimgrey,·fuchsia·=·purple,·gray·=·grey,·lightgray·=·lightgrey,
248	lightslategray·=·lightslategrey,·slategray·=·slategrey	232	lightslategray·=·lightslategrey,·slategray·=·slategrey
Max diff block lines reached; 9084/14976 bytes (60.66%) of diff not shown.


Offset 205, 27 lines modified		Offset 205, 24 lines modified
205	<p>It·can·then·be·accessed·like·this·(make·sure·to·check·for·errors·in·an·actual·program):</p>	205	<p>It·can·then·be·accessed·like·this·(make·sure·to·check·for·errors·in·an·actual·program):</p>
206	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a>ALLEGRO_CONFIG*·cfg·=·al_load_config_file(<span·class="st">"test.cfg"</span>);</span>	206	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a>ALLEGRO_CONFIG*·cfg·=·al_load_config_file(<span·class="st">"test.cfg"</span>);</span>
207	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a>printf(<span·class="st">"%s</span><span·class="sc">\n</span><span·class="st">"</span>,·al_get_config_value(cfg,·<span·class="st">""</span>,·<span·class="st">"monster·name"</span>));·<span·class="co">/·Prints:·Allegro·Developer·/</span></span>	207	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a>printf(<span·class="st">"%s</span><span·class="sc">\n</span><span·class="st">"</span>,·al_get_config_value(cfg,·<span·class="st">""</span>,·<span·class="st">"monster·name"</span>));·<span·class="co">/·Prints:·Allegro·Developer·/</span></span>
208	<span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"></a>printf(<span·class="st">"%s</span><span·class="sc">\n</span><span·class="st">"</span>,·al_get_config_value(cfg,·<span·class="st">"weapon·0"</span>,·<span·class="st">"damage"</span>));·<span·class="co">/·Prints:·443·/</span></span>	208	<span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"></a>printf(<span·class="st">"%s</span><span·class="sc">\n</span><span·class="st">"</span>,·al_get_config_value(cfg,·<span·class="st">"weapon·0"</span>,·<span·class="st">"damage"</span>));·<span·class="co">/·Prints:·443·/</span></span>
209	<span·id="cb3-4"><a·href="#cb3-4"·aria-hidden="true"></a>printf(<span·class="st">"%s</span><span·class="sc">\n</span><span·class="st">"</span>,·al_get_config_value(cfg,·<span·class="st">"weapon·1"</span>,·<span·class="st">"damage"</span>));·<span·class="co">/·Prints:·503·/</span></span>	209	<span·id="cb3-4"><a·href="#cb3-4"·aria-hidden="true"></a>printf(<span·class="st">"%s</span><span·class="sc">\n</span><span·class="st">"</span>,·al_get_config_value(cfg,·<span·class="st">"weapon·1"</span>,·<span·class="st">"damage"</span>));·<span·class="co">/·Prints:·503·/</span></span>
210	<span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"></a>al_destroy_config(cfg);</span></code></pre></div>	210	<span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"></a>al_destroy_config(cfg);</span></code></pre></div>
211	<h1·id="allegro_config">ALLEGRO_CONFIG</h1>	211	<h1·id="allegro_config">ALLEGRO_CONFIG</h1>
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"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG·ALLEGRO_CONFIG;</span>	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"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG·ALLEGRO_CONFIG;</span></code></pre></div>
213	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG·ALLEGRO_CONFIG;</span></code></pre></div>
214	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L12">Source·Code</a></p>	213	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L12">Source·Code</a></p>
215	<p>An·abstract·configuration·structure.</p>	214	<p>An·abstract·configuration·structure.</p>
216	<h1·id="allegro_config_section">ALLEGRO_CONFIG_SECTION</h1>	215	<h1·id="allegro_config_section">ALLEGRO_CONFIG_SECTION</h1>
217	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION;</span>	216	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION;</span></code></pre></div>
218	<span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION;</span></code></pre></div>
219	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L16">Source·Code</a></p>	217	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L16">Source·Code</a></p>
220	<p>An·opaque·structure·used·for·iterating·across·sections·in·a·configuration·structure.</p>	218	<p>An·opaque·structure·used·for·iterating·across·sections·in·a·configuration·structure.</p>
221	<p>See·also:·<a·href="config.html#al_get_first_config_section">al_get_first_config_section</a>,·<a·href="config.html#al_get_next_config_section">al_get_next_config_section</a></p>	219	<p>See·also:·<a·href="config.html#al_get_first_config_section">al_get_first_config_section</a>,·<a·href="config.html#al_get_next_config_section">al_get_next_config_section</a></p>
222	<h1·id="allegro_config_entry">ALLEGRO_CONFIG_ENTRY</h1>	220	<h1·id="allegro_config_entry">ALLEGRO_CONFIG_ENTRY</h1>
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"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY;</span>	221	<div·class="sourceCode"·id="cb6"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb6-1"><a·href="#cb6-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY;</span></code></pre></div>
224	<span·id="cb6-2"><a·href="#cb6-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY;</span></code></pre></div>
225	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L20">Source·Code</a></p>	222	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/config.h#L20">Source·Code</a></p>
226	<p>An·opaque·structure·used·for·iterating·across·entries·in·a·configuration·section.</p>	223	<p>An·opaque·structure·used·for·iterating·across·entries·in·a·configuration·section.</p>
227	<p>See·also:·<a·href="config.html#al_get_first_config_entry">al_get_first_config_entry</a>,·<a·href="config.html#al_get_next_config_entry">al_get_next_config_entry</a></p>	224	<p>See·also:·<a·href="config.html#al_get_first_config_entry">al_get_first_config_entry</a>,·<a·href="config.html#al_get_next_config_entry">al_get_next_config_entry</a></p>
228	<h1·id="al_create_config">al_create_config</h1>	225	<h1·id="al_create_config">al_create_config</h1>
229	<div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"></a>ALLEGRO_CONFIG·*al_create_config(<span·class="dt">void</span>)</span></code></pre></div>	226	<div·class="sourceCode"·id="cb7"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb7-1"><a·href="#cb7-1"·aria-hidden="true"></a>ALLEGRO_CONFIG·*al_create_config(<span·class="dt">void</span>)</span></code></pre></div>
230	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L37">Source·Code</a></p>	227	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L37">Source·Code</a></p>
231	<p>Create·an·empty·configuration·structure.</p>	228	<p>Create·an·empty·configuration·structure.</p>
Offset 326, 12 lines modified		Offset 323, 12 lines modified
326	<h1·id="al_merge_config_into">al_merge_config_into</h1>	323	<h1·id="al_merge_config_into">al_merge_config_into</h1>
327	<div·class="sourceCode"·id="cb24"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb24-1"><a·href="#cb24-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_merge_config_into(ALLEGRO_CONFIG·master,·<span·class="dt">const</span>·ALLEGRO_CONFIG·add)</span></code></pre></div>	324	<div·class="sourceCode"·id="cb24"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb24-1"><a·href="#cb24-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_merge_config_into(ALLEGRO_CONFIG·master,·<span·class="dt">const</span>·ALLEGRO_CONFIG·add)</span></code></pre></div>
328	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L515">Source·Code</a></p>	325	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/config.c#L515">Source·Code</a></p>
329	<p>Merge·one·configuration·structure·into·another.·Values·in·configuration·‘add’·override·those·in·‘master’.·‘master’·is·modified.·Comments·from·‘add’·are·not·retained.</p>	326	<p>Merge·one·configuration·structure·into·another.·Values·in·configuration·‘add’·override·those·in·‘master’.·‘master’·is·modified.·Comments·from·‘add’·are·not·retained.</p>
330	<p>See·also:·<a·href="config.html#al_merge_config">al_merge_config</a></p>	327	<p>See·also:·<a·href="config.html#al_merge_config">al_merge_config</a></p>
331	<p·class="timestamp">	328	<p·class="timestamp">
332	Allegro·version·5.2.6	329	Allegro·version·5.2.6
333	·-·Last·updated:·2025-02-07·20:10:04·UTC	330	·-·Last·updated:·2024-01-06·13:49:31·UTC
334	</p>	331	</p>
335	</div>	332	</div>
336	</body>	333	</body>
337	</html>	334	</html>


Offset 105, 27 lines modified		Offset 105, 24 lines modified
105	printf("%s\n",·al_get_config_value(cfg,·"weapon·0",·"damage"));·/*·Prints:·443	105	printf("%s\n",·al_get_config_value(cfg,·"weapon·0",·"damage"));·/*·Prints:·443
106	*/	106	*/
107	printf("%s\n",·al_get_config_value(cfg,·"weapon·1",·"damage"));·/*·Prints:·503	107	printf("%s\n",·al_get_config_value(cfg,·"weapon·1",·"damage"));·/*·Prints:·503
108	*/	108	*/
109	al_destroy_config(cfg);	109	al_destroy_config(cfg);
110	****·ALLEGRO_CONFIG·****	110	****·ALLEGRO_CONFIG·****
111	typedef·struct·ALLEGRO_CONFIG·ALLEGRO_CONFIG;	111	typedef·struct·ALLEGRO_CONFIG·ALLEGRO_CONFIG;
112	typedef·struct·ALLEGRO_CONFIG·ALLEGRO_CONFIG;
113	Source_Code	112	Source_Code
114	An·abstract·configuration·structure.	113	An·abstract·configuration·structure.
115	****·ALLEGRO_CONFIG_SECTION·****	114	****·ALLEGRO_CONFIG_SECTION·****
116	typedef·struct·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION;	115	typedef·struct·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION;
117	typedef·struct·ALLEGRO_CONFIG_SECTION·ALLEGRO_CONFIG_SECTION;
118	Source_Code	116	Source_Code
119	An·opaque·structure·used·for·iterating·across·sections·in·a·configuration	117	An·opaque·structure·used·for·iterating·across·sections·in·a·configuration
120	structure.	118	structure.
121	See·also:·al_get_first_config_section,·al_get_next_config_section	119	See·also:·al_get_first_config_section,·al_get_next_config_section
122	****·ALLEGRO_CONFIG_ENTRY·****	120	****·ALLEGRO_CONFIG_ENTRY·****
123	typedef·struct·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY;	121	typedef·struct·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY;
124	typedef·struct·ALLEGRO_CONFIG_ENTRY·ALLEGRO_CONFIG_ENTRY;
125	Source_Code	122	Source_Code
126	An·opaque·structure·used·for·iterating·across·entries·in·a·configuration	123	An·opaque·structure·used·for·iterating·across·entries·in·a·configuration
127	section.	124	section.
128	See·also:·al_get_first_config_entry,·al_get_next_config_entry	125	See·also:·al_get_first_config_entry,·al_get_next_config_entry
129	****·al_create_config·****	126	****·al_create_config·****
130	ALLEGRO_CONFIG·*al_create_config(void)	127	ALLEGRO_CONFIG·*al_create_config(void)
131	Source_Code	128	Source_Code
Offset 256, 8 lines modified		Offset 253, 8 lines modified
256	****·al_merge_config_into·****	253	****·al_merge_config_into·****
257	void·al_merge_config_into(ALLEGRO_CONFIG·master,·const·ALLEGRO_CONFIG·add)	254	void·al_merge_config_into(ALLEGRO_CONFIG·master,·const·ALLEGRO_CONFIG·add)
258	Source_Code	255	Source_Code
259	Merge·one·configuration·structure·into·another.·Values·in·configuration	256	Merge·one·configuration·structure·into·another.·Values·in·configuration
260	âaddâ·override·those·in·âmasterâ.·âmasterâ·is·modified.·Comments	257	âaddâ·override·those·in·âmasterâ.·âmasterâ·is·modified.·Comments
261	from·âaddâ·are·not·retained.	258	from·âaddâ·are·not·retained.
262	See·also:·al_merge_config	259	See·also:·al_merge_config
263	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:04·UTC	260	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:31·UTC


Offset 240, 12 lines modified		Offset 240, 12 lines modified
240	<span·id="cb11-2"><a·href="#cb11-2"·aria-hidden="true"></a>···<span·class="dt">void</span>·(callback)(ALLEGRO_DISPLAY·display))</span></code></pre></div>	240	<span·id="cb11-2"><a·href="#cb11-2"·aria-hidden="true"></a>···<span·class="dt">void</span>·(callback)(ALLEGRO_DISPLAY·display))</span></code></pre></div>
241	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/win/d3d_disp.cpp#L227">Source·Code</a></p>	241	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/win/d3d_disp.cpp#L227">Source·Code</a></p>
242	<p>The·callback·will·be·called·whenever·a·D3D·device·that·has·been·reset·is·restored.·In·the·callback·you·should·restore·any·d3d·resources·you·have·created·yourself.·The·callback·receives·the·affected·display·as·a·parameter.</p>	242	<p>The·callback·will·be·called·whenever·a·D3D·device·that·has·been·reset·is·restored.·In·the·callback·you·should·restore·any·d3d·resources·you·have·created·yourself.·The·callback·receives·the·affected·display·as·a·parameter.</p>
243	<p>Pass·NULL·to·disable·the·callback.</p>	243	<p>Pass·NULL·to·disable·the·callback.</p>
244	<p>Since:·5.1.0</p>	244	<p>Since:·5.1.0</p>
245	<p·class="timestamp">	245	<p·class="timestamp">
246	Allegro·version·5.2.6	246	Allegro·version·5.2.6
247	·-·Last·updated:·2025-02-07·20:10:12·UTC	247	·-·Last·updated:·2024-01-06·13:49:37·UTC
248	</p>	248	</p>
249	</div>	249	</div>
250	</body>	250	</body>
251	</html>	251	</html>


Offset 130, 8 lines modified		Offset 130, 8 lines modified
130	···void·(callback)(ALLEGRO_DISPLAY·display))	130	···void·(callback)(ALLEGRO_DISPLAY·display))
131	Source_Code	131	Source_Code
132	The·callback·will·be·called·whenever·a·D3D·device·that·has·been·reset·is	132	The·callback·will·be·called·whenever·a·D3D·device·that·has·been·reset·is
133	restored.·In·the·callback·you·should·restore·any·d3d·resources·you·have·created	133	restored.·In·the·callback·you·should·restore·any·d3d·resources·you·have·created
134	yourself.·The·callback·receives·the·affected·display·as·a·parameter.	134	yourself.·The·callback·receives·the·affected·display·as·a·parameter.
135	Pass·NULL·to·disable·the·callback.	135	Pass·NULL·to·disable·the·callback.
136	Since:·5.1.0	136	Since:·5.1.0
137	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:12·UTC	137	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:37·UTC


Offset 237, 16 lines modified		Offset 237, 15 lines modified
237	<p>Before·creating·a·display·with·<a·href="display.html#al_create_display">al_create_display</a>,·flags·and·options·can·be·set·with·<a·href="display.html#al_set_new_display_flags">al_set_new_display_flags</a>·and·<a·href="display.html#al_set_new_display_option">al_set_new_display_option</a>.·For·example,·you·can·enable·the·use·of·shaders·or·choose·between·the·OpenGL·and·Direct3D·backends·(on·platforms·that·support·both)·with·<a·href="display.html#al_set_new_display_flags">al_set_new_display_flags</a>.·Display·options·are·rather·optional·settings·that·do·not·affect·Allegro·itself,·e.g. they·allow·you·to·specify·whether·you·want·a·depth·buffer·or·enable·multisampling.</p>	237	<p>Before·creating·a·display·with·<a·href="display.html#al_create_display">al_create_display</a>,·flags·and·options·can·be·set·with·<a·href="display.html#al_set_new_display_flags">al_set_new_display_flags</a>·and·<a·href="display.html#al_set_new_display_option">al_set_new_display_option</a>.·For·example,·you·can·enable·the·use·of·shaders·or·choose·between·the·OpenGL·and·Direct3D·backends·(on·platforms·that·support·both)·with·<a·href="display.html#al_set_new_display_flags">al_set_new_display_flags</a>.·Display·options·are·rather·optional·settings·that·do·not·affect·Allegro·itself,·e.g. they·allow·you·to·specify·whether·you·want·a·depth·buffer·or·enable·multisampling.</p>
238	<p>The·actual·properties·of·a·display·that·has·been·successfully·created·can·be·queried·via·<a·href="display.html#al_get_display_option">al_get_display_option</a>,·<a·href="display.html#al_get_display_flags">al_get_display_flags</a>,·<a·href="display.html#al_get_display_width">al_get_display_width</a>·etc.·Note·that·you·can·query·some·additional·read-only·properties·such·as·the·maximum·allowed·bitmap·(i.e. texture)·size·via·<a·href="display.html#al_get_display_option">al_get_display_option</a>.</p>	238	<p>The·actual·properties·of·a·display·that·has·been·successfully·created·can·be·queried·via·<a·href="display.html#al_get_display_option">al_get_display_option</a>,·<a·href="display.html#al_get_display_flags">al_get_display_flags</a>,·<a·href="display.html#al_get_display_width">al_get_display_width</a>·etc.·Note·that·you·can·query·some·additional·read-only·properties·such·as·the·maximum·allowed·bitmap·(i.e. texture)·size·via·<a·href="display.html#al_get_display_option">al_get_display_option</a>.</p>
239	<p>Each·display·has·a·backbuffer·associated·to·it·which·is·the·default·target·for·any·drawing·operations.·In·order·to·make·visible·what·has·been·drawn·previously,·you·have·to·to·call·<a·href="display.html#al_flip_display">al_flip_display</a>.·Note·that·it·is·generally·advisable·to·redraw·the·whole·screen·(or·<a·href="graphics.html#al_clear_to_color">clear</a>·it·in·advance)·to·avoid·artefacts·of·uninitialised·memory·becoming·visible·with·some·drivers.</p>	239	<p>Each·display·has·a·backbuffer·associated·to·it·which·is·the·default·target·for·any·drawing·operations.·In·order·to·make·visible·what·has·been·drawn·previously,·you·have·to·to·call·<a·href="display.html#al_flip_display">al_flip_display</a>.·Note·that·it·is·generally·advisable·to·redraw·the·whole·screen·(or·<a·href="graphics.html#al_clear_to_color">clear</a>·it·in·advance)·to·avoid·artefacts·of·uninitialised·memory·becoming·visible·with·some·drivers.</p>
240	<p>You·don’t·have·to·use·Allegro’s·drawing·routines,·however:·since·creating·a·display·implies·the·creation·of·an·OpenGL·context·or·Direct3D·device·respectively,·you·can·use·these·APIs·directly·if·you·prefer·to·do·so.·Allegro·provides·integration·for·both·(see·the·OpenGL·/·Direct3D·sections),·so·you·can·retrieve·the·underlying·textures·of·<a·href="graphics.html#allegro_bitmap">ALLEGRO_BITMAP</a>s,·for·example.</p>	240	<p>You·don’t·have·to·use·Allegro’s·drawing·routines,·however:·since·creating·a·display·implies·the·creation·of·an·OpenGL·context·or·Direct3D·device·respectively,·you·can·use·these·APIs·directly·if·you·prefer·to·do·so.·Allegro·provides·integration·for·both·(see·the·OpenGL·/·Direct3D·sections),·so·you·can·retrieve·the·underlying·textures·of·<a·href="graphics.html#allegro_bitmap">ALLEGRO_BITMAP</a>s,·for·example.</p>
241	<p>In·order·to·write·a·well-behaved·application,·it·is·necessary·to·remember·that·displays·will·also·inform·you·about·important·<a·href="events.html#allegro_event_display_expose">events</a>·via·their·<a·href="display.html#al_get_display_event_source">event·sources</a>.</p>	241	<p>In·order·to·write·a·well-behaved·application,·it·is·necessary·to·remember·that·displays·will·also·inform·you·about·important·<a·href="events.html#allegro_event_display_expose">events</a>·via·their·<a·href="display.html#al_get_display_event_source">event·sources</a>.</p>
242	<h1·id="display-creation">Display·creation</h1>	242	<h1·id="display-creation">Display·creation</h1>
243	<h2·id="allegro_display">ALLEGRO_DISPLAY</h2>	243	<h2·id="allegro_display">ALLEGRO_DISPLAY</h2>
244	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY;</span>	244	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY;</span></code></pre></div>
245	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY;</span></code></pre></div>
246	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/display.h#L108">Source·Code</a></p>	245	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/display.h#L108">Source·Code</a></p>
247	<p>An·opaque·type·representing·an·open·display·or·window.</p>	246	<p>An·opaque·type·representing·an·open·display·or·window.</p>
248	<h2·id="al_create_display">al_create_display</h2>	247	<h2·id="al_create_display">al_create_display</h2>
249	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a>ALLEGRO_DISPLAY·*al_create_display(<span·class="dt">int</span>·w,·<span·class="dt">int</span>·h)</span></code></pre></div>	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"></a>ALLEGRO_DISPLAY·*al_create_display(<span·class="dt">int</span>·w,·<span·class="dt">int</span>·h)</span></code></pre></div>
250	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/display.c#L38">Source·Code</a></p>	249	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/display.c#L38">Source·Code</a></p>
251	<p>Create·a·display,·or·window,·with·the·specified·dimensions.·The·parameters·of·the·display·are·determined·by·the·last·calls·to·al_set_new_display_*.·Default·parameters·are·used·if·none·are·set·explicitly.·Creating·a·new·display·will·automatically·make·it·the·active·one,·with·the·backbuffer·selected·for·drawing.</p>	250	<p>Create·a·display,·or·window,·with·the·specified·dimensions.·The·parameters·of·the·display·are·determined·by·the·last·calls·to·al_set_new_display_*.·Default·parameters·are·used·if·none·are·set·explicitly.·Creating·a·new·display·will·automatically·make·it·the·active·one,·with·the·backbuffer·selected·for·drawing.</p>
252	<p>Returns·NULL·on·error.</p>	251	<p>Returns·NULL·on·error.</p>
Offset 620, 16 lines modified		Offset 619, 15 lines modified
620	<h2·id="al_set_new_window_title">al_set_new_window_title</h2>	619	<h2·id="al_set_new_window_title">al_set_new_window_title</h2>
621	<div·class="sourceCode"·id="cb36"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb36-1"><a·href="#cb36-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_set_new_window_title(<span·class="dt">const</span>·<span·class="dt">char</span>·*title)</span></code></pre></div>	620	<div·class="sourceCode"·id="cb36"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb36-1"><a·href="#cb36-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_set_new_window_title(<span·class="dt">const</span>·<span·class="dt">char</span>·*title)</span></code></pre></div>
622	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L203">Source·Code</a></p>	621	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L203">Source·Code</a></p>
623	<p>Set·the·title·that·will·be·used·when·a·new·display·is·created.·Allegro·uses·a·static·buffer·of·<a·href="display.html#allegro_new_window_title_max_size">ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE</a>·to·store·this,·so·the·length·of·the·titme·you·set·must·be·less·than·this.</p>	622	<p>Set·the·title·that·will·be·used·when·a·new·display·is·created.·Allegro·uses·a·static·buffer·of·<a·href="display.html#allegro_new_window_title_max_size">ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE</a>·to·store·this,·so·the·length·of·the·titme·you·set·must·be·less·than·this.</p>
624	<p>See·also:·<a·href="display.html#al_set_window_title">al_set_window_title</a>,·<a·href="display.html#al_get_new_window_title">al_get_new_window_title</a>,·<a·href="display.html#al_create_display">al_create_display</a>,·<a·href="display.html#allegro_new_window_title_max_size">ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE</a></p>	623	<p>See·also:·<a·href="display.html#al_set_window_title">al_set_window_title</a>,·<a·href="display.html#al_get_new_window_title">al_get_new_window_title</a>,·<a·href="display.html#al_create_display">al_create_display</a>,·<a·href="display.html#allegro_new_window_title_max_size">ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE</a></p>
625	<p>Since:·5.1.12</p>	624	<p>Since:·5.1.12</p>
626	<h2·id="allegro_new_window_title_max_size">ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE</h2>	625	<h2·id="allegro_new_window_title_max_size">ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE</h2>
627	<div·class="sourceCode"·id="cb37"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb37-1"><a·href="#cb37-1"·aria-hidden="true"></a><span·class="pp">#define·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·255</span></span>	626	<div·class="sourceCode"·id="cb37"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb37-1"><a·href="#cb37-1"·aria-hidden="true"></a><span·class="pp">#define·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·255</span></span></code></pre></div>
628	<span·id="cb37-2"><a·href="#cb37-2"·aria-hidden="true"></a><span·class="pp">#define·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·255</span></span></code></pre></div>
629	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/display.h#L113">Source·Code</a></p>	627	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/display.h#L113">Source·Code</a></p>
630	<p>This·is·the·maximum·size·of·the·title·that·can·be·set·with·<a·href="display.html#al_set_new_window_title">al_set_new_window_title</a>.</p>	628	<p>This·is·the·maximum·size·of·the·title·that·can·be·set·with·<a·href="display.html#al_set_new_window_title">al_set_new_window_title</a>.</p>
631	<p>See·also:·<a·href="display.html#al_set_new_window_title">al_set_new_window_title</a></p>	629	<p>See·also:·<a·href="display.html#al_set_new_window_title">al_set_new_window_title</a></p>
632	<p>Since:·5.1.12</p>	630	<p>Since:·5.1.12</p>
633	<h2·id="al_get_new_window_title">al_get_new_window_title</h2>	631	<h2·id="al_get_new_window_title">al_get_new_window_title</h2>
634	<div·class="sourceCode"·id="cb38"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb38-1"><a·href="#cb38-1"·aria-hidden="true"></a><span·class="dt">const</span>·<span·class="dt">char</span>·*al_get_new_window_title(<span·class="dt">void</span>)</span></code></pre></div>	632	<div·class="sourceCode"·id="cb38"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb38-1"><a·href="#cb38-1"·aria-hidden="true"></a><span·class="dt">const</span>·<span·class="dt">char</span>·*al_get_new_window_title(<span·class="dt">void</span>)</span></code></pre></div>
635	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L224">Source·Code</a></p>	633	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L224">Source·Code</a></p>
Offset 688, 12 lines modified		Offset 686, 12 lines modified
688	<div·class="sourceCode"·id="cb46"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb46-1"><a·href="#cb46-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_clipboard_has_text(ALLEGRO_DISPLAY·*display)</span></code></pre></div>	686	<div·class="sourceCode"·id="cb46"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb46-1"><a·href="#cb46-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_clipboard_has_text(ALLEGRO_DISPLAY·*display)</span></code></pre></div>
689	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/clipboard.c#L64">Source·Code</a></p>	687	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/clipboard.c#L64">Source·Code</a></p>
690	<p>This·function·returns·true·if·and·only·if·the·clipboard·has·text·available.</p>	688	<p>This·function·returns·true·if·and·only·if·the·clipboard·has·text·available.</p>
691	<p>Since:·5.1.12</p>	689	<p>Since:·5.1.12</p>
692	<p>See·also:·<a·href="display.html#al_set_clipboard_text">al_set_clipboard_text</a>,·<a·href="display.html#al_get_clipboard_text">al_get_clipboard_text</a></p>	690	<p>See·also:·<a·href="display.html#al_set_clipboard_text">al_set_clipboard_text</a>,·<a·href="display.html#al_get_clipboard_text">al_get_clipboard_text</a></p>
693	<p·class="timestamp">	691	<p·class="timestamp">
694	Allegro·version·5.2.6	692	Allegro·version·5.2.6
695	·-·Last·updated:·2025-02-07·20:10:04·UTC	693	·-·Last·updated:·2024-01-06·13:49:31·UTC
696	</p>	694	</p>
697	</div>	695	</div>
698	</body>	696	</body>
699	</html>	697	</html>


Offset 126, 15 lines modified		Offset 126, 14 lines modified
126	provides·integration·for·both·(see·the·OpenGL·/·Direct3D·sections),·so·you·can	126	provides·integration·for·both·(see·the·OpenGL·/·Direct3D·sections),·so·you·can
127	retrieve·the·underlying·textures·of·ALLEGRO_BITMAPs,·for·example.	127	retrieve·the·underlying·textures·of·ALLEGRO_BITMAPs,·for·example.
128	In·order·to·write·a·well-behaved·application,·it·is·necessary·to·remember·that	128	In·order·to·write·a·well-behaved·application,·it·is·necessary·to·remember·that
129	displays·will·also·inform·you·about·important·events·via·their·event_sources.	129	displays·will·also·inform·you·about·important·events·via·their·event_sources.
130	****·Display·creation·****	130	****·Display·creation·****
131	***·ALLEGRO_DISPLAY·***	131	***·ALLEGRO_DISPLAY·***
132	typedef·struct·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY;	132	typedef·struct·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY;
133	typedef·struct·ALLEGRO_DISPLAY·ALLEGRO_DISPLAY;
134	Source_Code	133	Source_Code
135	An·opaque·type·representing·an·open·display·or·window.	134	An·opaque·type·representing·an·open·display·or·window.
136	***·al_create_display·***	135	***·al_create_display·***
137	ALLEGRO_DISPLAY·*al_create_display(int·w,·int·h)	136	ALLEGRO_DISPLAY·*al_create_display(int·w,·int·h)
138	Source_Code	137	Source_Code
139	Create·a·display,·or·window,·with·the·specified·dimensions.·The·parameters·of	138	Create·a·display,·or·window,·with·the·specified·dimensions.·The·parameters·of
140	the·display·are·determined·by·the·last·calls·to·al_set_new_display_*.·Default	139	the·display·are·determined·by·the·last·calls·to·al_set_new_display_*.·Default
Offset 619, 15 lines modified		Offset 618, 14 lines modified
619	static·buffer·of·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·to·store·this,·so·the·length	618	static·buffer·of·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·to·store·this,·so·the·length
620	of·the·titme·you·set·must·be·less·than·this.	619	of·the·titme·you·set·must·be·less·than·this.
621	See·also:·al_set_window_title,·al_get_new_window_title,·al_create_display,	620	See·also:·al_set_window_title,·al_get_new_window_title,·al_create_display,
622	ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE	621	ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE
623	Since:·5.1.12	622	Since:·5.1.12
624	***·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·***	623	***·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·***
625	#define·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·255	624	#define·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·255
626	#define·ALLEGRO_NEW_WINDOW_TITLE_MAX_SIZE·255
627	Source_Code	625	Source_Code
628	This·is·the·maximum·size·of·the·title·that·can·be·set·with	626	This·is·the·maximum·size·of·the·title·that·can·be·set·with
629	al_set_new_window_title.	627	al_set_new_window_title.
630	See·also:·al_set_new_window_title	628	See·also:·al_set_new_window_title
631	Since:·5.1.12	629	Since:·5.1.12
632	***·al_get_new_window_title·***	630	***·al_get_new_window_title·***
633	const·char·*al_get_new_window_title(void)	631	const·char·*al_get_new_window_title(void)
Offset 706, 8 lines modified		Offset 704, 8 lines modified
706	See·also:·al_get_clipboard_text,·al_clipboard_has_text	704	See·also:·al_get_clipboard_text,·al_clipboard_has_text
707	***·al_clipboard_has_text·***	705	***·al_clipboard_has_text·***
708	bool·al_clipboard_has_text(ALLEGRO_DISPLAY·*display)	706	bool·al_clipboard_has_text(ALLEGRO_DISPLAY·*display)
709	Source_Code	707	Source_Code
710	This·function·returns·true·if·and·only·if·the·clipboard·has·text·available.	708	This·function·returns·true·if·and·only·if·the·clipboard·has·text·available.
711	Since:·5.1.12	709	Since:·5.1.12
712	See·also:·al_set_clipboard_text,·al_get_clipboard_text	710	See·also:·al_set_clipboard_text,·al_get_clipboard_text
713	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:04·UTC	711	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:31·UTC


Offset 121, 15 lines modified		Offset 121, 14 lines modified
121	events·that·can·be·generated·by·user-defined·event·sources.	121	events·that·can·be·generated·by·user-defined·event·sources.
122	The·appropriate·reaction·to·an·event·is·determined·by·examining·the·fields·of	122	The·appropriate·reaction·to·an·event·is·determined·by·examining·the·fields·of
123	the·ALLEGRO_EVENT·union·according·to·the·event·type.	123	the·ALLEGRO_EVENT·union·according·to·the·event·type.
124	In·addition·to·the·events·sent·by·Allegro·core,·thereâs·also·events·send·by	124	In·addition·to·the·events·sent·by·Allegro·core,·thereâs·also·events·send·by
125	the·addons,·see·ALLEGRO_AUDIO_EVENT_TYPE·and·ALLEGRO_VIDEO_EVENT_TYPE.	125	the·addons,·see·ALLEGRO_AUDIO_EVENT_TYPE·and·ALLEGRO_VIDEO_EVENT_TYPE.
126	****·ALLEGRO_EVENT·****	126	****·ALLEGRO_EVENT·****
127	typedef·union·ALLEGRO_EVENT·ALLEGRO_EVENT;	127	typedef·union·ALLEGRO_EVENT·ALLEGRO_EVENT;
128	typedef·union·ALLEGRO_EVENT·ALLEGRO_EVENT;
129	Source_Code	128	Source_Code
130	An·ALLEGRO_EVENT·is·a·union·of·all·builtin·event·structures,·i.e.Â it·is·an	129	An·ALLEGRO_EVENT·is·a·union·of·all·builtin·event·structures,·i.e.Â it·is·an
131	object·large·enough·to·hold·the·data·of·any·event·type.·All·events·have·the	130	object·large·enough·to·hold·the·data·of·any·event·type.·All·events·have·the
132	following·fields·in·common:	131	following·fields·in·common:
133	··type·(ALLEGRO_EVENT_TYPE)	132	··type·(ALLEGRO_EVENT_TYPE)
134	······Indicates·the·type·of·event.	133	······Indicates·the·type·of·event.
135	··any.source·(ALLEGRO_EVENT_SOURCE·*)	134	··any.source·(ALLEGRO_EVENT_SOURCE·*)
Offset 465, 15 lines modified		Offset 464, 14 lines modified
465	This·event·is·sent·when·a·physical·display·is·disconnected·from·the·device	464	This·event·is·sent·when·a·physical·display·is·disconnected·from·the·device
466	Allegro·runs·on.·Currently,·on·most·platforms,·Allegro·supports·only·a·single	465	Allegro·runs·on.·Currently,·on·most·platforms,·Allegro·supports·only·a·single
467	physical·display.·However,·on·iOS,·a·secondary·physical·display·is·supported.	466	physical·display.·However,·on·iOS,·a·secondary·physical·display·is·supported.
468	··display.source·(ALLEGRO_DISPLAY·*)	467	··display.source·(ALLEGRO_DISPLAY·*)
469	······The·display·which·was·disconnected.	468	······The·display·which·was·disconnected.
470	****·ALLEGRO_USER_EVENT·****	469	****·ALLEGRO_USER_EVENT·****
471	typedef·struct·ALLEGRO_USER_EVENT·ALLEGRO_USER_EVENT;	470	typedef·struct·ALLEGRO_USER_EVENT·ALLEGRO_USER_EVENT;
472	typedef·struct·ALLEGRO_USER_EVENT·ALLEGRO_USER_EVENT;
473	Source_Code	471	Source_Code
474	An·event·structure·that·can·be·emitted·by·user·event·sources.·These·are·the	472	An·event·structure·that·can·be·emitted·by·user·event·sources.·These·are·the
475	public·fields:	473	public·fields:
476	·····ALLEGRO_EVENT_SOURCE·source;	474	·····ALLEGRO_EVENT_SOURCE·source;
477	····*·intptr_t·data1;	475	····*·intptr_t·data1;
478	····*·intptr_t·data2;	476	····*·intptr_t·data2;
479	····*·intptr_t·data3;	477	····*·intptr_t·data3;
Offset 499, 38 lines modified		Offset 497, 34 lines modified
499	al_emit_user_event(&my_event_source,·&my_event,·NULL);	497	al_emit_user_event(&my_event_source,·&my_event,·NULL);
500	Event·type·identifiers·for·user·events·are·assigned·by·the·user.·Please·see·the	498	Event·type·identifiers·for·user·events·are·assigned·by·the·user.·Please·see·the
501	documentation·for·ALLEGRO_GET_EVENT_TYPE·for·the·rules·you·should·follow·when	499	documentation·for·ALLEGRO_GET_EVENT_TYPE·for·the·rules·you·should·follow·when
502	assigning·identifiers.	500	assigning·identifiers.
503	See·also:·al_emit_user_event,·ALLEGRO_GET_EVENT_TYPE,·al_init_user_event_source	501	See·also:·al_emit_user_event,·ALLEGRO_GET_EVENT_TYPE,·al_init_user_event_source
504	****·ALLEGRO_EVENT_QUEUE·****	502	****·ALLEGRO_EVENT_QUEUE·****
505	typedef·struct·ALLEGRO_EVENT_QUEUE·ALLEGRO_EVENT_QUEUE;	503	typedef·struct·ALLEGRO_EVENT_QUEUE·ALLEGRO_EVENT_QUEUE;
506	typedef·struct·ALLEGRO_EVENT_QUEUE·ALLEGRO_EVENT_QUEUE;
507	Source_Code	504	Source_Code
508	An·event·queue·holds·events·that·have·been·generated·by·event·sources·that·are	505	An·event·queue·holds·events·that·have·been·generated·by·event·sources·that·are
509	registered·with·the·queue.·Events·are·stored·in·the·order·they·are·generated.	506	registered·with·the·queue.·Events·are·stored·in·the·order·they·are·generated.
510	Access·is·in·a·strictly·FIFO·(first-in-first-out)·order.	507	Access·is·in·a·strictly·FIFO·(first-in-first-out)·order.
511	See·also:·al_create_event_queue,·al_destroy_event_queue	508	See·also:·al_create_event_queue,·al_destroy_event_queue
512	****·ALLEGRO_EVENT_SOURCE·****	509	****·ALLEGRO_EVENT_SOURCE·****
513	typedef·struct·ALLEGRO_EVENT_SOURCE·ALLEGRO_EVENT_SOURCE;	510	typedef·struct·ALLEGRO_EVENT_SOURCE·ALLEGRO_EVENT_SOURCE;
514	typedef·struct·ALLEGRO_EVENT_SOURCE·ALLEGRO_EVENT_SOURCE;
515	Source_Code	511	Source_Code
516	An·event·source·is·any·object·which·can·generate·events.·For·example,·an	512	An·event·source·is·any·object·which·can·generate·events.·For·example,·an
517	ALLEGRO_DISPLAY·can·generate·events,·and·you·can·get·the·ALLEGRO_EVENT_SOURCE	513	ALLEGRO_DISPLAY·can·generate·events,·and·you·can·get·the·ALLEGRO_EVENT_SOURCE
518	pointer·from·an·ALLEGRO_DISPLAY·with·al_get_display_event_source.	514	pointer·from·an·ALLEGRO_DISPLAY·with·al_get_display_event_source.
519	You·may·create·your·own·âuserâ·event·sources·that·emit·custom·events.	515	You·may·create·your·own·âuserâ·event·sources·that·emit·custom·events.
520	See·also:·ALLEGRO_EVENT,·al_init_user_event_source,·al_emit_user_event	516	See·also:·ALLEGRO_EVENT,·al_init_user_event_source,·al_emit_user_event
521	****·ALLEGRO_EVENT_TYPE·****	517	****·ALLEGRO_EVENT_TYPE·****
522	typedef·unsigned·int·ALLEGRO_EVENT_TYPE;	518	typedef·unsigned·int·ALLEGRO_EVENT_TYPE;
523	typedef·unsigned·int·ALLEGRO_EVENT_TYPE;
524	Source_Code	519	Source_Code
525	An·integer·used·to·distinguish·between·different·types·of·events.	520	An·integer·used·to·distinguish·between·different·types·of·events.
526	See·also:·ALLEGRO_EVENT,·ALLEGRO_GET_EVENT_TYPE,·ALLEGRO_EVENT_TYPE_IS_USER	521	See·also:·ALLEGRO_EVENT,·ALLEGRO_GET_EVENT_TYPE,·ALLEGRO_EVENT_TYPE_IS_USER
527	****·ALLEGRO_GET_EVENT_TYPE·****	522	****·ALLEGRO_GET_EVENT_TYPE·****
528	#define·ALLEGRO_GET_EVENT_TYPE(a,·b,·c,·d)···AL_ID(a,·b,·c,·d)	523	#define·ALLEGRO_GET_EVENT_TYPE(a,·b,·c,·d)···AL_ID(a,·b,·c,·d)
529	#define·ALLEGRO_GET_EVENT_TYPE(a,·b,·c,·d)···AL_ID(a,·b,·c,·d)
530	Source_Code	524	Source_Code
531	Make·an·event·type·identifier,·which·is·a·32-bit·integer.·Usually,·but·not	525	Make·an·event·type·identifier,·which·is·a·32-bit·integer.·Usually,·but·not
532	necessarily,·this·will·be·made·from·four·8-bit·character·codes,·for·example:	526	necessarily,·this·will·be·made·from·four·8-bit·character·codes,·for·example:
533	#defin··MY_EVENT_TYPE···ALLEGRO_GET_EVENT_TYPE('M','I','N','E')	527	#defin··MY_EVENT_TYPE···ALLEGRO_GET_EVENT_TYPE('M','I','N','E')
534	IDs·less·than·1024·are·reserved·for·Allegro·or·its·addons.·Donât·use·anything	528	IDs·less·than·1024·are·reserved·for·Allegro·or·its·addons.·Donât·use·anything
535	lower·than·ALLEGRO_GET_EVENT_TYPE(0,·0,·4,·0).	529	lower·than·ALLEGRO_GET_EVENT_TYPE(0,·0,·4,·0).
536	You·should·try·to·make·your·IDs·unique·so·they·donât·clash·with·any·3rd·party	530	You·should·try·to·make·your·IDs·unique·so·they·donât·clash·with·any·3rd·party
Offset 546, 15 lines modified		Offset 540, 14 lines modified
546	···BARK_EVENT·=·ALLEGRO_GET_EVENT_TYPE('M','I','N','E'),	540	···BARK_EVENT·=·ALLEGRO_GET_EVENT_TYPE('M','I','N','E'),
547	···MEOW_EVENT,	541	···MEOW_EVENT,
548	···SQUAWK_EVENT	542	···SQUAWK_EVENT
549	};	543	};
550	See·also:·ALLEGRO_EVENT,·ALLEGRO_USER_EVENT,·ALLEGRO_EVENT_TYPE_IS_USER	544	See·also:·ALLEGRO_EVENT,·ALLEGRO_USER_EVENT,·ALLEGRO_EVENT_TYPE_IS_USER
551	****·ALLEGRO_EVENT_TYPE_IS_USER·****	545	****·ALLEGRO_EVENT_TYPE_IS_USER·****
552	#define·ALLEGRO_EVENT_TYPE_IS_USER(t)········((t)·>=·512)	546	#define·ALLEGRO_EVENT_TYPE_IS_USER(t)········((t)·>=·512)
553	#define·ALLEGRO_EVENT_TYPE_IS_USER(t)········((t)·>=·512)
554	Source_Code	547	Source_Code
555	A·macro·which·evaluates·to·true·if·the·event·type·is·not·a·builtin·event·type,	548	A·macro·which·evaluates·to·true·if·the·event·type·is·not·a·builtin·event·type,
556	i.e.Â one·of·those·described·in·ALLEGRO_EVENT_TYPE.	549	i.e.Â one·of·those·described·in·ALLEGRO_EVENT_TYPE.
557	****·al_create_event_queue·****	550	****·al_create_event_queue·****
558	ALLEGRO_EVENT_QUEUE·*al_create_event_queue(void)	551	ALLEGRO_EVENT_QUEUE·*al_create_event_queue(void)
559	Source_Code	552	Source_Code
560	Create·a·new,·empty·event·queue,·returning·a·pointer·to·the·newly·created	553	Create·a·new,·empty·event·queue,·returning·a·pointer·to·the·newly·created
Offset 761, 8 lines modified		Offset 754, 8 lines modified
761	****·al_set_event_source_data·****	754	****·al_set_event_source_data·****
762	void·al_set_event_source_data(ALLEGRO_EVENT_SOURCE·*source,·intptr_t·data)	755	void·al_set_event_source_data(ALLEGRO_EVENT_SOURCE·*source,·intptr_t·data)
763	Source_Code	756	Source_Code
764	Assign·the·abstract·user·data·to·the·event·source.·Allegro·does·not·use·the	757	Assign·the·abstract·user·data·to·the·event·source.·Allegro·does·not·use·the
765	data·internally·for·anything;·it·is·simply·meant·as·a·convenient·way·to	758	data·internally·for·anything;·it·is·simply·meant·as·a·convenient·way·to
766	associate·your·own·data·or·objects·with·events.	759	associate·your·own·data·or·objects·with·events.
767	See·also:·al_get_event_source_data	760	See·also:·al_get_event_source_data
768	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:05·UTC	761	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:31·UTC


Offset 189, 391 lines modified		Offset 189, 391 lines modified
189	-rw-r--r--···0·root·········(0)·root·········(0)·····5396·2017-05-30·18:25:58.000000·./usr/share/doc/allegro5-doc/examples/ex_window_maximized.c	189	-rw-r--r--···0·root·········(0)·root·········(0)·····5396·2017-05-30·18:25:58.000000·./usr/share/doc/allegro5-doc/examples/ex_window_maximized.c
190	-rw-r--r--···0·root·········(0)·root·········(0)·····2660·2015-08-31·04:43:15.000000·./usr/share/doc/allegro5-doc/examples/ex_window_title.c	190	-rw-r--r--···0·root·········(0)·root·········(0)·····2660·2015-08-31·04:43:15.000000·./usr/share/doc/allegro5-doc/examples/ex_window_title.c
191	-rw-r--r--···0·root·········(0)·root·········(0)·····2975·2017-02-26·02:02:03.000000·./usr/share/doc/allegro5-doc/examples/ex_windows.c	191	-rw-r--r--···0·root·········(0)·root·········(0)·····2975·2017-02-26·02:02:03.000000·./usr/share/doc/allegro5-doc/examples/ex_windows.c
192	-rw-r--r--···0·root·········(0)·root·········(0)·····1674·2013-11-06·11:26:41.000000·./usr/share/doc/allegro5-doc/examples/ex_winfull.c	192	-rw-r--r--···0·root·········(0)·root·········(0)·····1674·2013-11-06·11:26:41.000000·./usr/share/doc/allegro5-doc/examples/ex_winfull.c
193	-rw-r--r--···0·root·········(0)·root·········(0)····19521·2016-02-21·20:36:27.000000·./usr/share/doc/allegro5-doc/examples/nihgui.cpp	193	-rw-r--r--···0·root·········(0)·root·········(0)····19521·2016-02-21·20:36:27.000000·./usr/share/doc/allegro5-doc/examples/nihgui.cpp
194	-rw-r--r--···0·root·········(0)·root·········(0)·····6456·2013-07-07·19:37:58.000000·./usr/share/doc/allegro5-doc/examples/nihgui.hpp	194	-rw-r--r--···0·root·········(0)·root·········(0)·····6456·2013-07-07·19:37:58.000000·./usr/share/doc/allegro5-doc/examples/nihgui.hpp
195	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/	195	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/
196	-rw-r--r--···0·root·········(0)·root·········(0)····1~~1032~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/acodec.html	196	-rw-r--r--···0·root·········(0)·root·········(0)····10577·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/acodec.html
197	-rw-r--r--···0·root·········(0)·root·········(0)···195031·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/audio.html	197	-rw-r--r--···0·root·········(0)·root·········(0)···165411·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/audio.html
198	-rw-r--r--···0·root·········(0)·root·········(0)····35631·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/autosuggest.js	198	-rw-r--r--···0·root·········(0)·root·········(0)····35631·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/autosuggest.js
199	-rw-r--r--···0·root·········(0)·root·········(0)····~~53769~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/color.html	199	-rw-r--r--···0·root·········(0)·root·········(0)····44035·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/color.html
200	-rw-r--r--···0·root·········(0)·root·········(0)····29929·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/config.html	200	-rw-r--r--···0·root·········(0)·root·········(0)····29427·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/config.html
201	-rw-r--r--···0·root·········(0)·root·········(0)····15545·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/direct3d.html	201	-rw-r--r--···0·root·········(0)·root·········(0)····15545·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/direct3d.html
202	-rw-r--r--···0·root·········(0)·root·········(0)····65~~607~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/display.html	202	-rw-r--r--···0·root·········(0)·root·········(0)····65311·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/display.html
203	-rw-r--r--···0·root·········(0)·root·········(0)····6~~5962~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/events.html	203	-rw-r--r--···0·root·········(0)·root·········(0)····64824·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/events.html
204	-rw-r--r--···0·root·········(0)·root·········(0)····4~~8297~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/file.html	204	-rw-r--r--···0·root·········(0)·root·········(0)····47855·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/file.html
205	-rw-r--r--···0·root·········(0)·root·········(0)····45~~867~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/fixed.html	205	-rw-r--r--···0·root·········(0)·root·········(0)····45729·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/fixed.html
206	-rw-r--r--···0·root·········(0)·root·········(0)····~~9016~~9·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/font.html	206	-rw-r--r--···0·root·········(0)·root·········(0)····75679·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/font.html
207	-rw-r--r--···0·root·········(0)·root·········(0)····35~~785~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/fshook.html	207	-rw-r--r--···0·root·········(0)·root·········(0)····35146·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/fshook.html
208	-rw-r--r--···0·root·········(0)·root·········(0)····11~~732~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/fullscreen_mode.html	208	-rw-r--r--···0·root·········(0)·root·········(0)····11584·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/fullscreen_mode.html
209	-rw-r--r--···0·root·········(0)·root·········(0)····16295·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/getting_started.html	209	-rw-r--r--···0·root·········(0)·root·········(0)····16295·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/getting_started.html
210	-rw-r--r--···0·root·········(0)·root·········(0)···16~~9980~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/graphics.html	210	-rw-r--r--···0·root·········(0)·root·········(0)···168879·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/graphics.html
211	-rw-r--r--···0·root·········(0)·root·········(0)····60~~905~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/haptic.html	211	-rw-r--r--···0·root·········(0)·root·········(0)····60334·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/haptic.html
212	-rw-r--r--···0·root·········(0)·root·········(0)····11721·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/image.html	212	-rw-r--r--···0·root·········(0)·root·········(0)····11122·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/image.html
213	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/	213	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/
214	-rw-r--r--···0·root·········(0)·root·········(0)····21480·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/LINE_CAP.png	214	-rw-r--r--···0·root·········(0)·root·········(0)····21480·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/LINE_CAP.png
215	-rw-r--r--···0·root·········(0)·root·········(0)····15893·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/LINE_JOIN.png	215	-rw-r--r--···0·root·········(0)·root·········(0)····15893·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/LINE_JOIN.png
216	-rw-r--r--···0·root·········(0)·root·········(0)····65065·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/audio.png	216	-rw-r--r--···0·root·········(0)·root·········(0)····65065·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/audio.png
217	-rw-r--r--···0·root·········(0)·root·········(0)····16058·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/primitives1.png	217	-rw-r--r--···0·root·········(0)·root·········(0)····16058·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/primitives1.png
218	-rw-r--r--···0·root·········(0)·root·········(0)····25805·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/primitives2.png	218	-rw-r--r--···0·root·········(0)·root·········(0)····25805·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/images/primitives2.png
219	-rw-r--r--···0·root·········(0)·root·········(0)·····6356·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/index.html	219	-rw-r--r--···0·root·········(0)·root·········(0)·····6356·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/index.html
220	-rw-r--r--···0·root·········(0)·root·········(0)···107495·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/index_all.html	220	-rw-r--r--···0·root·········(0)·root·········(0)···107495·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/index_all.html
221	-rw-r--r--···0·root·········(0)·root·········(0)····2~~7019~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/joystick.html	221	-rw-r--r--···0·root·········(0)·root·········(0)····26573·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/joystick.html
222	-rw-r--r--···0·root·········(0)·root·········(0)····19~~390~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/keyboard.html	222	-rw-r--r--···0·root·········(0)·root·········(0)····19216·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/keyboard.html
223	-rw-r--r--···0·root·········(0)·root·········(0)·····8392·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/main.html	223	-rw-r--r--···0·root·········(0)·root·········(0)·····8392·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/main.html
224	-rw-r--r--···0·root·········(0)·root·········(0)·····9~~939~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/memfile.html	224	-rw-r--r--···0·root·········(0)·root·········(0)·····9548·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/memfile.html
225	-rw-r--r--···0·root·········(0)·root·········(0)····1~~9801~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/memory.html	225	-rw-r--r--···0·root·········(0)·root·········(0)····18582·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/memory.html
226	-rw-r--r--···0·root·········(0)·root·········(0)·····9~~354~~·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/misc.html	226	-rw-r--r--···0·root·········(0)·root·········(0)·····9217·2020-11-27·12:02:04.000000·./usr/share/doc/allegro5-doc/refman/misc.html


Offset 202, 129 lines modified		Offset 202, 113 lines modified
202	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro_color.h></span></span></code></pre></div>	202	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro_color.h></span></span></code></pre></div>
203	<p>When·converting·between·certain·color·spaces,·RGB·colors·are·implicitly·assumed·to·mean·sRGB.</p>	203	<p>When·converting·between·certain·color·spaces,·RGB·colors·are·implicitly·assumed·to·mean·sRGB.</p>
204	<p>sRGB·is·a·standard·which·maps·RGB·colors·to·absolute·colors.·sRGB·is·very·close·to·RGB·values·on·a·monitor·which·has·a·gamma·value·of·2.2.·For·example·when·the·red·component·of·a·color·is·0.5,·the·monitor·will·use·a·brightness·of·pow(0.5,·2.2)·or·about·22%·-·and·not·50%.·The·reason·is·that·human·eyes·can·distinguish·better·between·dark·colors·than·between·bright·colors,·and·so·if·a·pixel·of·the·monitor·is·lit·up·to·22%·of·its·maximum·power·it·already·will·appear·at·half·brightness·to·a·human·eye.</p>	204	<p>sRGB·is·a·standard·which·maps·RGB·colors·to·absolute·colors.·sRGB·is·very·close·to·RGB·values·on·a·monitor·which·has·a·gamma·value·of·2.2.·For·example·when·the·red·component·of·a·color·is·0.5,·the·monitor·will·use·a·brightness·of·pow(0.5,·2.2)·or·about·22%·-·and·not·50%.·The·reason·is·that·human·eyes·can·distinguish·better·between·dark·colors·than·between·bright·colors,·and·so·if·a·pixel·of·the·monitor·is·lit·up·to·22%·of·its·maximum·power·it·already·will·appear·at·half·brightness·to·a·human·eye.</p>
205	<p>sRGB·improves·upon·simple·gamma·correction·by·taking·differences·between·the·three·color·channels·into·account·as·well.·In·general,·most·monitors·nowadays·try·to·be·close·to·the·sRGB·specification.·And·so·if·in·an·Allegro·game·you·display·something·with·color</p>	205	<p>sRGB·improves·upon·simple·gamma·correction·by·taking·differences·between·the·three·color·channels·into·account·as·well.·In·general,·most·monitors·nowadays·try·to·be·close·to·the·sRGB·specification.·And·so·if·in·an·Allegro·game·you·display·something·with·color</p>
206	<p>al_map_rgb_f(0.5,·0.5,·0,5)</p>	206	<p>al_map_rgb_f(0.5,·0.5,·0,5)</p>
207	<p>then·it·will·appear·at·about·half·brightness·(even·though·the·actual·brightness·output·of·the·monitor·will·be·less·than·half).</p>	207	<p>then·it·will·appear·at·about·half·brightness·(even·though·the·actual·brightness·output·of·the·monitor·will·be·less·than·half).</p>
208	<h1·id="al_color_cmyk">al_color_cmyk</h1>	208	<h1·id="al_color_cmyk">al_color_cmyk</h1>
209	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a>ALLEGRO_COLOR·al_color_cmyk(<span·class="dt">float</span>·c,·<span·class="dt">float</span>·m,·<span·class="dt">float</span>·y,·<span·class="dt">float</span>·k)</span>	209	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a>ALLEGRO_COLOR·al_color_cmyk(<span·class="dt">float</span>·c,·<span·class="dt">float</span>·m,·<span·class="dt">float</span>·y,·<span·class="dt">float</span>·k)</span></code></pre></div>
210	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a>ALLEGRO_COLOR·al_color_cmyk(<span·class="dt">float</span>·c,·<span·class="dt">float</span>·m,·<span·class="dt">float</span>·y,·<span·class="dt">float</span>·k)</span></code></pre></div>
211	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L480">Source·Code</a></p>	210	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L480">Source·Code</a></p>
212	<p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>·structure·from·CMYK·values·(cyan,·magenta,·yellow,·black).</p>	211	<p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>·structure·from·CMYK·values·(cyan,·magenta,·yellow,·black).</p>
213	<p>See·also:·<a·href="color.html#al_color_cmyk_to_rgb">al_color_cmyk_to_rgb</a>,·<a·href="color.html#al_color_rgb_to_cmyk">al_color_rgb_to_cmyk</a></p>	212	<p>See·also:·<a·href="color.html#al_color_cmyk_to_rgb">al_color_cmyk_to_rgb</a>,·<a·href="color.html#al_color_rgb_to_cmyk">al_color_rgb_to_cmyk</a></p>
214	<h1·id="al_color_cmyk_to_rgb">al_color_cmyk_to_rgb</h1>	213	<h1·id="al_color_cmyk_to_rgb">al_color_cmyk_to_rgb</h1>
215	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_color_cmyk_to_rgb(<span·class="dt">float</span>·cyan,·<span·class="dt">float</span>·magenta,·<span·class="dt">float</span>·yellow,</span>	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"></a><span·class="dt">void</span>·al_color_cmyk_to_rgb(<span·class="dt">float</span>·cyan,·<span·class="dt">float</span>·magenta,·<span·class="dt">float</span>·yellow,</span>
216	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a>····<span·class="dt">float</span>·key,·<span·class="dt">float</span>·red,·<span·class="dt">float</span>·green,·<span·class="dt">float</span>·*blue)</span>
217	<span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"></a><span·class="dt">void</span>·al_color_cmyk_to_rgb(<span·class="dt">float</span>·cyan,·<span·class="dt">float</span>·magenta,·<span·class="dt">float</span>·yellow,</span>
218	<span·id="cb3-4"><a·href="#cb3-4"·aria-hidden="true"></a>····<span·class="dt">float</span>·key,·<span·class="dt">float</span>·red,·<span·class="dt">float</span>·green,·<span·class="dt">float</span>·*blue)</span></code></pre></div>	215	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a>····<span·class="dt">float</span>·key,·<span·class="dt">float</span>·red,·<span·class="dt">float</span>·green,·<span·class="dt">float</span>·*blue)</span></code></pre></div>
219	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L446">Source·Code</a></p>	216	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L446">Source·Code</a></p>
220	<p>Convert·CMYK·values·to·RGB·values.</p>	217	<p>Convert·CMYK·values·to·RGB·values.</p>
221	<p>See·also:·<a·href="color.html#al_color_cmyk">al_color_cmyk</a>,·<a·href="color.html#al_color_rgb_to_cmyk">al_color_rgb_to_cmyk</a></p>	218	<p>See·also:·<a·href="color.html#al_color_cmyk">al_color_cmyk</a>,·<a·href="color.html#al_color_rgb_to_cmyk">al_color_rgb_to_cmyk</a></p>
222	<h1·id="al_color_hsl">al_color_hsl</h1>	219	<h1·id="al_color_hsl">al_color_hsl</h1>
223	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a>ALLEGRO_COLOR·al_color_hsl(<span·class="dt">float</span>·h,·<span·class="dt">float</span>·s,·<span·class="dt">float</span>·l)</span>	220	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a>ALLEGRO_COLOR·al_color_hsl(<span·class="dt">float</span>·h,·<span·class="dt">float</span>·s,·<span·class="dt">float</span>·l)</span></code></pre></div>
224	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a>ALLEGRO_COLOR·al_color_hsl(<span·class="dt">float</span>·h,·<span·class="dt">float</span>·s,·<span·class="dt">float</span>·l)</span></code></pre></div>
225	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L436">Source·Code</a></p>	221	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L436">Source·Code</a></p>
226	<p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>·structure·from·HSL·(hue,·saturation,·lightness)·values.</p>	222	<p>Return·an·<a·href="graphics.html#allegro_color">ALLEGRO_COLOR</a>·structure·from·HSL·(hue,·saturation,·lightness)·values.</p>
227	<p>Parameters:</p>	223	<p>Parameters:</p>
228	<ul>	224	<ul>
229	<li>hue·-·Color·hue·angle·in·the·range·0..360</li>	225	<li>hue·-·Color·hue·angle·in·the·range·0..360</li>
230	<li>saturation·-·Color·saturation·in·the·range·0..1</li>	226	<li>saturation·-·Color·saturation·in·the·range·0..1</li>
231	<li>lightness·-·Color·lightness·in·the·range·0..1</li>	227	<li>lightness·-·Color·lightness·in·the·range·0..1</li>
232	</ul>	228	</ul>
233	<p>See·also:·<a·href="color.html#al_color_hsl_to_rgb">al_color_hsl_to_rgb</a>,·<a·href="color.html#al_color_hsv">al_color_hsv</a></p>	229	<p>See·also:·<a·href="color.html#al_color_hsl_to_rgb">al_color_hsl_to_rgb</a>,·<a·href="color.html#al_color_hsv">al_color_hsv</a></p>
234	<h1·id="al_color_hsl_to_rgb">al_color_hsl_to_rgb</h1>	230	<h1·id="al_color_hsl_to_rgb">al_color_hsl_to_rgb</h1>
235	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_color_hsl_to_rgb(<span·class="dt">float</span>·hue,·<span·class="dt">float</span>·saturation,·<span·class="dt">float</span>·lightness,</span>	231	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_color_hsl_to_rgb(<span·class="dt">float</span>·hue,·<span·class="dt">float</span>·saturation,·<span·class="dt">float</span>·lightness,</span>
236	<span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"></a>···<span·class="dt">float</span>·red,·<span·class="dt">float</span>·green,·<span·class="dt">float</span>·*blue)</span>
237	<span·id="cb5-3"><a·href="#cb5-3"·aria-hidden="true"></a><span·class="dt">void</span>·al_color_hsl_to_rgb(<span·class="dt">float</span>·hue,·<span·class="dt">float</span>·saturation,·<span·class="dt">float</span>·lightness,</span>
238	<span·id="cb5-4"><a·href="#cb5-4"·aria-hidden="true"></a>···<span·class="dt">float</span>·red,·<span·class="dt">float</span>·green,·<span·class="dt">float</span>·*blue)</span></code></pre></div>	232	<span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"></a>···<span·class="dt">float</span>·red,·<span·class="dt">float</span>·green,·<span·class="dt">float</span>·*blue)</span></code></pre></div>
239	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L367">Source·Code</a></p>	233	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/color/color.c#L367">Source·Code</a></p>


Offset 230, 16 lines modified		Offset 230, 15 lines modified
230	<p>Events·are·generated·by·event·sources.·Most·notably,·each·of·the·input·subsystems·provides·an·event·source,·but·also·timers,·displays,·and·audio·streams·will·generate·events.</p>	230	<p>Events·are·generated·by·event·sources.·Most·notably,·each·of·the·input·subsystems·provides·an·event·source,·but·also·timers,·displays,·and·audio·streams·will·generate·events.</p>
231	<p>Event·sources·are·registered·to·event·queues·which·aggregate·events·from·multiple·sources.·A·single·event·source·can·also·be·registered·to·multiple·event·queues.</p>	231	<p>Event·sources·are·registered·to·event·queues·which·aggregate·events·from·multiple·sources.·A·single·event·source·can·also·be·registered·to·multiple·event·queues.</p>
232	<p>Event·queues·can·then·be·queried·for·events.·In·particular,·it·is·possible·to·wait·until·events·become·available·in·order·to·save·CPU·time.·You·can·combine·this·with·<a·href="timer.html#allegro_timer">timers</a>·to·make·your·main-loop·run·at·a·specific·speed·without·wasting·CPU·time·or·missing·events.</p>	232	<p>Event·queues·can·then·be·queried·for·events.·In·particular,·it·is·possible·to·wait·until·events·become·available·in·order·to·save·CPU·time.·You·can·combine·this·with·<a·href="timer.html#allegro_timer">timers</a>·to·make·your·main-loop·run·at·a·specific·speed·without·wasting·CPU·time·or·missing·events.</p>
233	<p>In·addition·to·the·predefined·event·types,·Allegro·also·allows·for·user-defined·events·that·can·be·generated·by·user-defined·event·sources.</p>	233	<p>In·addition·to·the·predefined·event·types,·Allegro·also·allows·for·user-defined·events·that·can·be·generated·by·user-defined·event·sources.</p>
234	<p>The·appropriate·reaction·to·an·event·is·determined·by·examining·the·fields·of·the·<a·href="events.html#allegro_event">ALLEGRO_EVENT</a>·union·according·to·the·event·type.</p>	234	<p>The·appropriate·reaction·to·an·event·is·determined·by·examining·the·fields·of·the·<a·href="events.html#allegro_event">ALLEGRO_EVENT</a>·union·according·to·the·event·type.</p>
235	<p>In·addition·to·the·events·sent·by·Allegro·core,·there’s·also·events·send·by·the·addons,·see·<a·href="audio.html#allegro_audio_event_type">ALLEGRO_AUDIO_EVENT_TYPE</a>·and·<a·href="video.html#allegro_video_event_type">ALLEGRO_VIDEO_EVENT_TYPE</a>.</p>	235	<p>In·addition·to·the·events·sent·by·Allegro·core,·there’s·also·events·send·by·the·addons,·see·<a·href="audio.html#allegro_audio_event_type">ALLEGRO_AUDIO_EVENT_TYPE</a>·and·<a·href="video.html#allegro_video_event_type">ALLEGRO_VIDEO_EVENT_TYPE</a>.</p>
236	<h1·id="allegro_event">ALLEGRO_EVENT</h1>	236	<h1·id="allegro_event">ALLEGRO_EVENT</h1>
237	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">union</span>·ALLEGRO_EVENT·ALLEGRO_EVENT;</span>	237	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">union</span>·ALLEGRO_EVENT·ALLEGRO_EVENT;</span></code></pre></div>
238	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">union</span>·ALLEGRO_EVENT·ALLEGRO_EVENT;</span></code></pre></div>
239	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L202">Source·Code</a></p>	238	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L202">Source·Code</a></p>
240	<p>An·ALLEGRO_EVENT·is·a·union·of·all·builtin·event·structures,·i.e. it·is·an·object·large·enough·to·hold·the·data·of·any·event·type.·All·events·have·the·following·fields·in·common:</p>	239	<p>An·ALLEGRO_EVENT·is·a·union·of·all·builtin·event·structures,·i.e. it·is·an·object·large·enough·to·hold·the·data·of·any·event·type.·All·events·have·the·following·fields·in·common:</p>
241	<dl>	240	<dl>
242	<dt>type·(ALLEGRO_EVENT_TYPE)</dt>	241	<dt>type·(ALLEGRO_EVENT_TYPE)</dt>
243	<dd>Indicates·the·type·of·event.	242	<dd>Indicates·the·type·of·event.
244	</dd>	243	</dd>
245	<dt>any.source·(ALLEGRO_EVENT_SOURCE·*)</dt>	244	<dt>any.source·(ALLEGRO_EVENT_SOURCE·*)</dt>
Offset 643, 16 lines modified		Offset 642, 15 lines modified
643	<p>This·event·is·sent·when·a·physical·display·is·disconnected·from·the·device·Allegro·runs·on.·Currently,·on·most·platforms,·Allegro·supports·only·a·single·physical·display.·However,·on·iOS,·a·secondary·physical·display·is·supported.</p>	642	<p>This·event·is·sent·when·a·physical·display·is·disconnected·from·the·device·Allegro·runs·on.·Currently,·on·most·platforms,·Allegro·supports·only·a·single·physical·display.·However,·on·iOS,·a·secondary·physical·display·is·supported.</p>
644	<dl>	643	<dl>
645	<dt>display.source·(ALLEGRO_DISPLAY·*)</dt>	644	<dt>display.source·(ALLEGRO_DISPLAY·*)</dt>
646	<dd>The·display·which·was·disconnected.	645	<dd>The·display·which·was·disconnected.
647	</dd>	646	</dd>
648	</dl>	647	</dl>
649	<h1·id="allegro_user_event">ALLEGRO_USER_EVENT</h1>	648	<h1·id="allegro_user_event">ALLEGRO_USER_EVENT</h1>
650	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_USER_EVENT·ALLEGRO_USER_EVENT;</span>	649	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_USER_EVENT·ALLEGRO_USER_EVENT;</span></code></pre></div>
651	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_USER_EVENT·ALLEGRO_USER_EVENT;</span></code></pre></div>
652	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L186">Source·Code</a></p>	650	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h#L186">Source·Code</a></p>
653	<p>An·event·structure·that·can·be·emitted·by·user·event·sources.·These·are·the·public·fields:</p>	651	<p>An·event·structure·that·can·be·emitted·by·user·event·sources.·These·are·the·public·fields:</p>
654	<ul>	652	<ul>
655	<li>ALLEGRO_EVENT_SOURCE·*source;</li>	653	<li>ALLEGRO_EVENT_SOURCE·*source;</li>
656	<li>intptr_t·data1;</li>	654	<li>intptr_t·data1;</li>
657	<li>intptr_t·data2;</li>	655	<li>intptr_t·data2;</li>
658	<li>intptr_t·data3;</li>	656	<li>intptr_t·data3;</li>
Offset 677, 35 lines modified		Offset 675, 31 lines modified
677	<span·id="cb4-8"><a·href="#cb4-8"·aria-hidden="true"></a>my_event.user.data1·=·<span·class="dv">1</span>;</span>	675	<span·id="cb4-8"><a·href="#cb4-8"·aria-hidden="true"></a>my_event.user.data1·=·<span·class="dv">1</span>;</span>
678	<span·id="cb4-9"><a·href="#cb4-9"·aria-hidden="true"></a>my_event.user.data2·=·&some_var;</span>	676	<span·id="cb4-9"><a·href="#cb4-9"·aria-hidden="true"></a>my_event.user.data2·=·&some_var;</span>
679	<span·id="cb4-10"><a·href="#cb4-10"·aria-hidden="true"></a></span>	677	<span·id="cb4-10"><a·href="#cb4-10"·aria-hidden="true"></a></span>
680	<span·id="cb4-11"><a·href="#cb4-11"·aria-hidden="true"></a>al_emit_user_event(&my_event_source,·&my_event,·NULL);</span></code></pre></div>	678	<span·id="cb4-11"><a·href="#cb4-11"·aria-hidden="true"></a>al_emit_user_event(&my_event_source,·&my_event,·NULL);</span></code></pre></div>


Offset 70, 15 lines modified		Offset 70, 14 lines modified
70	··········o·al_fixatan2	70	··········o·al_fixatan2
71	··········o·al_fixsqrt	71	··········o·al_fixsqrt
72	··········o·al_fixhypot	72	··········o·al_fixhypot
73	These·functions·are·declared·in·the·main·Allegro·header·file:	73	These·functions·are·declared·in·the·main·Allegro·header·file:
74	·#include·<allegro5/allegro.h>	74	·#include·<allegro5/allegro.h>
75	****·al_fixed·****	75	****·al_fixed·****
76	typedef·int32_t·al_fixed;	76	typedef·int32_t·al_fixed;
77	typedef·int32_t·al_fixed;
78	Source_Code	77	Source_Code
79	A·fixed·point·number.	78	A·fixed·point·number.
80	Allegro·provides·some·routines·for·working·with·fixed·point·numbers,·and	79	Allegro·provides·some·routines·for·working·with·fixed·point·numbers,·and
81	defines·the·type·al_fixed·to·be·a·signed·32-bit·integer.·The·high·word·is·used	80	defines·the·type·al_fixed·to·be·a·signed·32-bit·integer.·The·high·word·is·used
82	for·the·integer·part·and·the·low·word·for·the·fraction,·giving·a·range·of·-	81	for·the·integer·part·and·the·low·word·for·the·fraction,·giving·a·range·of·-
83	32768·to·32767·and·an·accuracy·of·about·four·or·five·decimal·places.·Fixed	82	32768·to·32767·and·an·accuracy·of·about·four·or·five·decimal·places.·Fixed
84	point·numbers·can·be·assigned,·compared,·added,·subtracted,·negated·and·shifted	83	point·numbers·can·be·assigned,·compared,·added,·subtracted,·negated·and·shifted
Offset 440, 8 lines modified		Offset 439, 8 lines modified
440	errno·is·set·to·EDOM·and·the·function·returns·zero.	439	errno·is·set·to·EDOM·and·the·function·returns·zero.
441	***·al_fixhypot·***	440	***·al_fixhypot·***
442	al_fixed·al_fixhypot(al_fixed·x,·al_fixed·y)	441	al_fixed·al_fixhypot(al_fixed·x,·al_fixed·y)
443	Source_Code	442	Source_Code
444	Fixed·point·hypotenuse·(returns·the·square·root·of·xx·+·yy).·This·should·be	443	Fixed·point·hypotenuse·(returns·the·square·root·of·xx·+·yy).·This·should·be
445	better·than·calculating·the·formula·yourself·manually,·since·the·error·is·much	444	better·than·calculating·the·formula·yourself·manually,·since·the·error·is·much
446	smaller.	445	smaller.
447	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:07·UTC	446	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:32·UTC


Offset 210, 21 lines modified		Offset 210, 19 lines modified
210	<li><a·href="#al_get_file_userdata">al_get_file_userdata</a></li>	210	<li><a·href="#al_get_file_userdata">al_get_file_userdata</a></li>
211	</ul></li>	211	</ul></li>
212	</ul>	212	</ul>
213	</nav>	213	</nav>
214	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>	214	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>
215	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>	215	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>
216	<h1·id="allegro_file">ALLEGRO_FILE</h1>	216	<h1·id="allegro_file">ALLEGRO_FILE</h1>
217	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE·ALLEGRO_FILE;</span>	217	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE·ALLEGRO_FILE;</span></code></pre></div>
218	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE·ALLEGRO_FILE;</span></code></pre></div>
219	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L15">Source·Code</a></p>	218	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L15">Source·Code</a></p>
220	<p>An·opaque·object·representing·an·open·file.·This·could·be·a·real·file·on·disk·or·a·virtual·file.</p>	219	<p>An·opaque·object·representing·an·open·file.·This·could·be·a·real·file·on·disk·or·a·virtual·file.</p>
221	<h1·id="allegro_file_interface">ALLEGRO_FILE_INTERFACE</h1>	220	<h1·id="allegro_file_interface">ALLEGRO_FILE_INTERFACE</h1>
222	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE_INTERFACE</span>	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"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE_INTERFACE</span></code></pre></div>
223	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FILE_INTERFACE</span></code></pre></div>
224	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L20">Source·Code</a></p>	222	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L20">Source·Code</a></p>
225	<p>A·structure·containing·function·pointers·to·handle·a·type·of·“file”,·real·or·virtual.·See·the·full·discussion·in·<a·href="file.html#al_set_new_file_interface">al_set_new_file_interface</a>.</p>	223	<p>A·structure·containing·function·pointers·to·handle·a·type·of·“file”,·real·or·virtual.·See·the·full·discussion·in·<a·href="file.html#al_set_new_file_interface">al_set_new_file_interface</a>.</p>
226	<p>The·fields·are:</p>	224	<p>The·fields·are:</p>
227	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="dt">void</span>·········(fi_fopen)(<span·class="dt">const</span>·<span·class="dt">char</span>·path,·<span·class="dt">const</span>·<span·class="dt">char</span>·mode);</span>	225	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="dt">void</span>·········(fi_fopen)(<span·class="dt">const</span>·<span·class="dt">char</span>·path,·<span·class="dt">const</span>·<span·class="dt">char</span>·mode);</span>
228	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a><span·class="dt">bool</span>··········(fi_fclose)(ALLEGRO_FILE·f);</span>	226	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a><span·class="dt">bool</span>··········(fi_fclose)(ALLEGRO_FILE·f);</span>
229	<span·id="cb4-3"><a·href="#cb4-3"·aria-hidden="true"></a><span·class="dt">size_t</span>········(fi_fread)(ALLEGRO_FILE·f,·<span·class="dt">void</span>·*ptr,·<span·class="dt">size_t</span>·size);</span>	227	<span·id="cb4-3"><a·href="#cb4-3"·aria-hidden="true"></a><span·class="dt">size_t</span>········(fi_fread)(ALLEGRO_FILE·f,·<span·class="dt">void</span>·*ptr,·<span·class="dt">size_t</span>·size);</span>
230	<span·id="cb4-4"><a·href="#cb4-4"·aria-hidden="true"></a><span·class="dt">size_t</span>········(fi_fwrite)(ALLEGRO_FILE·f,·<span·class="dt">const</span>·<span·class="dt">void</span>·*ptr,·<span·class="dt">size_t</span>·size);</span>	228	<span·id="cb4-4"><a·href="#cb4-4"·aria-hidden="true"></a><span·class="dt">size_t</span>········(fi_fwrite)(ALLEGRO_FILE·f,·<span·class="dt">const</span>·<span·class="dt">void</span>·*ptr,·<span·class="dt">size_t</span>·size);</span>
Offset 237, 16 lines modified		Offset 235, 15 lines modified
237	<span·id="cb4-11"><a·href="#cb4-11"·aria-hidden="true"></a><span·class="dt">void</span>··········(fi_fclearerr)(ALLEGRO_FILE·f);</span>	235	<span·id="cb4-11"><a·href="#cb4-11"·aria-hidden="true"></a><span·class="dt">void</span>··········(fi_fclearerr)(ALLEGRO_FILE·f);</span>
238	<span·id="cb4-12"><a·href="#cb4-12"·aria-hidden="true"></a><span·class="dt">int</span>···········(fi_fungetc)(ALLEGRO_FILE·f,·<span·class="dt">int</span>·c);</span>	236	<span·id="cb4-12"><a·href="#cb4-12"·aria-hidden="true"></a><span·class="dt">int</span>···········(fi_fungetc)(ALLEGRO_FILE·f,·<span·class="dt">int</span>·c);</span>
239	<span·id="cb4-13"><a·href="#cb4-13"·aria-hidden="true"></a>off_t·········(fi_fsize)(ALLEGRO_FILE·f);</span></code></pre></div>	237	<span·id="cb4-13"><a·href="#cb4-13"·aria-hidden="true"></a>off_t·········(fi_fsize)(ALLEGRO_FILE·f);</span></code></pre></div>
240	<p>The·fi_open·function·must·allocate·memory·for·whatever·userdata·structure·it·needs.·The·pointer·to·that·memory·must·be·returned;·it·will·then·be·associated·with·the·file.·The·other·functions·can·access·that·data·by·calling·<a·href="file.html#al_get_file_userdata">al_get_file_userdata</a>·on·the·file·handle.·If·fi_open·returns·NULL·then·<a·href="file.html#al_fopen">al_fopen</a>·will·also·return·NULL.</p>	238	<p>The·fi_open·function·must·allocate·memory·for·whatever·userdata·structure·it·needs.·The·pointer·to·that·memory·must·be·returned;·it·will·then·be·associated·with·the·file.·The·other·functions·can·access·that·data·by·calling·<a·href="file.html#al_get_file_userdata">al_get_file_userdata</a>·on·the·file·handle.·If·fi_open·returns·NULL·then·<a·href="file.html#al_fopen">al_fopen</a>·will·also·return·NULL.</p>
241	<p>The·fi_fclose·function·must·clean·up·and·free·the·userdata,·but·Allegro·will·free·the·<a·href="file.html#allegro_file">ALLEGRO_FILE</a>·handle.</p>	239	<p>The·fi_fclose·function·must·clean·up·and·free·the·userdata,·but·Allegro·will·free·the·<a·href="file.html#allegro_file">ALLEGRO_FILE</a>·handle.</p>
242	<p>If·fi_fungetc·is·NULL,·then·Allegro’s·default·implementation·of·a·16·char·long·buffer·will·be·used.</p>	240	<p>If·fi_fungetc·is·NULL,·then·Allegro’s·default·implementation·of·a·16·char·long·buffer·will·be·used.</p>
243	<h1·id="allegro_seek">ALLEGRO_SEEK</h1>	241	<h1·id="allegro_seek">ALLEGRO_SEEK</h1>
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"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_SEEK</span>	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"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_SEEK</span></code></pre></div>
245	<span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_SEEK</span></code></pre></div>
246	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L40">Source·Code</a></p>	243	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/file.h#L40">Source·Code</a></p>
247	<ul>	244	<ul>
248	<li>ALLEGRO_SEEK_SET·-·seek·relative·to·beginning·of·file</li>	245	<li>ALLEGRO_SEEK_SET·-·seek·relative·to·beginning·of·file</li>
249	<li>ALLEGRO_SEEK_CUR·-·seek·relative·to·current·file·position</li>	246	<li>ALLEGRO_SEEK_CUR·-·seek·relative·to·current·file·position</li>
250	<li>ALLEGRO_SEEK_END·-·seek·relative·to·end·of·file</li>	247	<li>ALLEGRO_SEEK_END·-·seek·relative·to·end·of·file</li>
251	</ul>	248	</ul>
252	<p>See·also:·<a·href="file.html#al_fseek">al_fseek</a></p>	249	<p>See·also:·<a·href="file.html#al_fseek">al_fseek</a></p>
Offset 516, 12 lines modified		Offset 513, 12 lines modified
516	<p>See·also:·<a·href="file.html#al_fopen">al_fopen</a>,·<a·href="file.html#al_fclose">al_fclose</a>,·<a·href="file.html#al_set_new_file_interface">al_set_new_file_interface</a></p>	513	<p>See·also:·<a·href="file.html#al_fopen">al_fopen</a>,·<a·href="file.html#al_fclose">al_fclose</a>,·<a·href="file.html#al_set_new_file_interface">al_set_new_file_interface</a></p>
517	<h2·id="al_get_file_userdata">al_get_file_userdata</h2>	514	<h2·id="al_get_file_userdata">al_get_file_userdata</h2>
518	<div·class="sourceCode"·id="cb44"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb44-1"><a·href="#cb44-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_get_file_userdata(ALLEGRO_FILE·f)</span></code></pre></div>	515	<div·class="sourceCode"·id="cb44"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb44-1"><a·href="#cb44-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_get_file_userdata(ALLEGRO_FILE·f)</span></code></pre></div>
519	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L533">Source·Code</a></p>	516	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/file.c#L533">Source·Code</a></p>
520	<p>Returns·a·pointer·to·the·custom·userdata·that·is·attached·to·the·file·handle.·This·is·intended·to·be·used·by·functions·that·extend·<a·href="file.html#allegro_file_interface">ALLEGRO_FILE_INTERFACE</a>.</p>	517	<p>Returns·a·pointer·to·the·custom·userdata·that·is·attached·to·the·file·handle.·This·is·intended·to·be·used·by·functions·that·extend·<a·href="file.html#allegro_file_interface">ALLEGRO_FILE_INTERFACE</a>.</p>
521	<p·class="timestamp">	518	<p·class="timestamp">
522	Allegro·version·5.2.6	519	Allegro·version·5.2.6
523	·-·Last·updated:·2025-02-07·20:10:06·UTC	520	·-·Last·updated:·2024-01-06·13:49:32·UTC
524	</p>	521	</p>
525	</div>	522	</div>
526	</body>	523	</body>
527	</html>	524	</html>


Offset 89, 21 lines modified		Offset 89, 19 lines modified
89	··········o·al_get_new_file_interface	89	··········o·al_get_new_file_interface
90	··········o·al_create_file_handle	90	··········o·al_create_file_handle
91	··········o·al_get_file_userdata	91	··········o·al_get_file_userdata
92	These·functions·are·declared·in·the·main·Allegro·header·file:	92	These·functions·are·declared·in·the·main·Allegro·header·file:
93	·#include·<allegro5/allegro.h>	93	·#include·<allegro5/allegro.h>
94	****·ALLEGRO_FILE·****	94	****·ALLEGRO_FILE·****
95	typedef·struct·ALLEGRO_FILE·ALLEGRO_FILE;	95	typedef·struct·ALLEGRO_FILE·ALLEGRO_FILE;
96	typedef·struct·ALLEGRO_FILE·ALLEGRO_FILE;
97	Source_Code	96	Source_Code
98	An·opaque·object·representing·an·open·file.·This·could·be·a·real·file·on·disk	97	An·opaque·object·representing·an·open·file.·This·could·be·a·real·file·on·disk
99	or·a·virtual·file.	98	or·a·virtual·file.
100	****·ALLEGRO_FILE_INTERFACE·****	99	****·ALLEGRO_FILE_INTERFACE·****
101	typedef·struct·ALLEGRO_FILE_INTERFACE	100	typedef·struct·ALLEGRO_FILE_INTERFACE
102	typedef·struct·ALLEGRO_FILE_INTERFACE
103	Source_Code	101	Source_Code
104	A·structure·containing·function·pointers·to·handle·a·type·of·âfileâ,·real	102	A·structure·containing·function·pointers·to·handle·a·type·of·âfileâ,·real
105	or·virtual.·See·the·full·discussion·in·al_set_new_file_interface.	103	or·virtual.·See·the·full·discussion·in·al_set_new_file_interface.
106	The·fields·are:	104	The·fields·are:
107	void·········(fi_fopen)(const·char·path,·const·char·mode);	105	void·········(fi_fopen)(const·char·path,·const·char·mode);
108	bool··········(fi_fclose)(ALLEGRO_FILE·f);	106	bool··········(fi_fclose)(ALLEGRO_FILE·f);
109	size_t········(fi_fread)(ALLEGRO_FILE·f,·void·*ptr,·size_t·size);	107	size_t········(fi_fread)(ALLEGRO_FILE·f,·void·*ptr,·size_t·size);
Offset 124, 15 lines modified		Offset 122, 14 lines modified
124	will·also·return·NULL.	122	will·also·return·NULL.
125	The·fi_fclose·function·must·clean·up·and·free·the·userdata,·but·Allegro·will	123	The·fi_fclose·function·must·clean·up·and·free·the·userdata,·but·Allegro·will
126	free·the·ALLEGRO_FILE·handle.	124	free·the·ALLEGRO_FILE·handle.
127	If·fi_fungetc·is·NULL,·then·Allegroâs·default·implementation·of·a·16·char	125	If·fi_fungetc·is·NULL,·then·Allegroâs·default·implementation·of·a·16·char
128	long·buffer·will·be·used.	126	long·buffer·will·be·used.
129	****·ALLEGRO_SEEK·****	127	****·ALLEGRO_SEEK·****
130	typedef·enum·ALLEGRO_SEEK	128	typedef·enum·ALLEGRO_SEEK
131	typedef·enum·ALLEGRO_SEEK
132	Source_Code	129	Source_Code
133	····*·ALLEGRO_SEEK_SET·-·seek·relative·to·beginning·of·file	130	····*·ALLEGRO_SEEK_SET·-·seek·relative·to·beginning·of·file
134	····*·ALLEGRO_SEEK_CUR·-·seek·relative·to·current·file·position	131	····*·ALLEGRO_SEEK_CUR·-·seek·relative·to·current·file·position
135	····*·ALLEGRO_SEEK_END·-·seek·relative·to·end·of·file	132	····*·ALLEGRO_SEEK_END·-·seek·relative·to·end·of·file
136	See·also:·al_fseek	133	See·also:·al_fseek
137	****·al_fopen·****	134	****·al_fopen·****
138	ALLEGRO_FILE·al_fopen(const·char·path,·const·char·*mode)	135	ALLEGRO_FILE·al_fopen(const·char·path,·const·char·*mode)
Offset 477, 8 lines modified		Offset 474, 8 lines modified
477	finished·with·it.	474	finished·with·it.
478	See·also:·al_fopen,·al_fclose,·al_set_new_file_interface	475	See·also:·al_fopen,·al_fclose,·al_set_new_file_interface
479	***·al_get_file_userdata·***	476	***·al_get_file_userdata·***
480	void·al_get_file_userdata(ALLEGRO_FILE·f)	477	void·al_get_file_userdata(ALLEGRO_FILE·f)
481	Source_Code	478	Source_Code
482	Returns·a·pointer·to·the·custom·userdata·that·is·attached·to·the·file·handle.	479	Returns·a·pointer·to·the·custom·userdata·that·is·attached·to·the·file·handle.
483	This·is·intended·to·be·used·by·functions·that·extend·ALLEGRO_FILE_INTERFACE.	480	This·is·intended·to·be·used·by·functions·that·extend·ALLEGRO_FILE_INTERFACE.
484	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:06·UTC	481	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:32·UTC


Offset 189, 16 lines modified		Offset 189, 15 lines modified
189	<li><a·href="#al_fixhypot">al_fixhypot</a></li>	189	<li><a·href="#al_fixhypot">al_fixhypot</a></li>
190	</ul></li>	190	</ul></li>
191	</ul>	191	</ul>
192	</nav>	192	</nav>
193	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>	193	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>
194	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>	194	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>
195	<h1·id="al_fixed">al_fixed</h1>	195	<h1·id="al_fixed">al_fixed</h1>
196	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="dt">int32_t</span>·al_fixed;</span>	196	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="dt">int32_t</span>·al_fixed;</span></code></pre></div>
197	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="dt">int32_t</span>·al_fixed;</span></code></pre></div>
198	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fixed.h#L30">Source·Code</a></p>	197	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fixed.h#L30">Source·Code</a></p>
199	<p>A·fixed·point·number.</p>	198	<p>A·fixed·point·number.</p>
200	<p>Allegro·provides·some·routines·for·working·with·fixed·point·numbers,·and·defines·the·type·<code>al_fixed</code>·to·be·a·signed·32-bit·integer.·The·high·word·is·used·for·the·integer·part·and·the·low·word·for·the·fraction,·giving·a·range·of·-32768·to·32767·and·an·accuracy·of·about·four·or·five·decimal·places.·Fixed·point·numbers·can·be·assigned,·compared,·added,·subtracted,·negated·and·shifted·(for·multiplying·or·dividing·by·powers·of·two)·using·the·normal·integer·operators,·but·you·should·take·care·to·use·the·appropriate·conversion·routines·when·mixing·fixed·point·with·integer·or·floating·point·values.·Writing·<code>fixed_point_1·+·fixed_point_2</code>·is·OK,·but·<code>fixed_point·+·integer</code>·is·not.</p>	199	<p>Allegro·provides·some·routines·for·working·with·fixed·point·numbers,·and·defines·the·type·<code>al_fixed</code>·to·be·a·signed·32-bit·integer.·The·high·word·is·used·for·the·integer·part·and·the·low·word·for·the·fraction,·giving·a·range·of·-32768·to·32767·and·an·accuracy·of·about·four·or·five·decimal·places.·Fixed·point·numbers·can·be·assigned,·compared,·added,·subtracted,·negated·and·shifted·(for·multiplying·or·dividing·by·powers·of·two)·using·the·normal·integer·operators,·but·you·should·take·care·to·use·the·appropriate·conversion·routines·when·mixing·fixed·point·with·integer·or·floating·point·values.·Writing·<code>fixed_point_1·+·fixed_point_2</code>·is·OK,·but·<code>fixed_point·+·integer</code>·is·not.</p>
201	<p>The·only·advantage·of·fixed·point·math·routines·is·that·you·don’t·require·a·floating·point·coprocessor·to·use·them.·This·was·great·in·the·time·period·of·i386·and·i486·machines,·but·stopped·being·so·useful·with·the·coming·of·the·Pentium·class·of·processors.·From·Pentium·onwards,·CPUs·have·increased·their·strength·in·floating·point·operations,·equaling·or·even·surpassing·integer·math·performance.·However,·many·embedded·processors·have·no·FPUs·so·fixed·point·maths·can·still·be·useful·there.</p>	200	<p>The·only·advantage·of·fixed·point·math·routines·is·that·you·don’t·require·a·floating·point·coprocessor·to·use·them.·This·was·great·in·the·time·period·of·i386·and·i486·machines,·but·stopped·being·so·useful·with·the·coming·of·the·Pentium·class·of·processors.·From·Pentium·onwards,·CPUs·have·increased·their·strength·in·floating·point·operations,·equaling·or·even·surpassing·integer·math·performance.·However,·many·embedded·processors·have·no·FPUs·so·fixed·point·maths·can·still·be·useful·there.</p>
202	<p>Depending·on·the·type·of·operations·your·program·may·need,·using·floating·point·types·may·be·faster·than·fixed·types·if·you·are·targeting·a·specific·machine·class.</p>	201	<p>Depending·on·the·type·of·operations·your·program·may·need,·using·floating·point·types·may·be·faster·than·fixed·types·if·you·are·targeting·a·specific·machine·class.</p>
203	<h1·id="al_itofix">al_itofix</h1>	202	<h1·id="al_itofix">al_itofix</h1>
204	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a>al_fixed·al_itofix(<span·class="dt">int</span>·x);</span></code></pre></div>	203	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a>al_fixed·al_itofix(<span·class="dt">int</span>·x);</span></code></pre></div>
Offset 479, 12 lines modified		Offset 478, 12 lines modified
479	<p>This·finds·out·the·non·negative·square·root·of·<code>x</code>.·If·<code>x</code>·is·negative,·Allegro’s·errno·is·set·to·EDOM·and·the·function·returns·zero.</p>	478	<p>This·finds·out·the·non·negative·square·root·of·<code>x</code>.·If·<code>x</code>·is·negative,·Allegro’s·errno·is·set·to·EDOM·and·the·function·returns·zero.</p>
480	<h2·id="al_fixhypot">al_fixhypot</h2>	479	<h2·id="al_fixhypot">al_fixhypot</h2>
481	<div·class="sourceCode"·id="cb42"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb42-1"><a·href="#cb42-1"·aria-hidden="true"></a>al_fixed·al_fixhypot(al_fixed·x,·al_fixed·y)</span></code></pre></div>	480	<div·class="sourceCode"·id="cb42"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb42-1"><a·href="#cb42-1"·aria-hidden="true"></a>al_fixed·al_fixhypot(al_fixed·x,·al_fixed·y)</span></code></pre></div>
482	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/math.c#L321">Source·Code</a></p>	481	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/math.c#L321">Source·Code</a></p>
483	<p>Fixed·point·hypotenuse·(returns·the·square·root·of·<code>xx·+·yy</code>).·This·should·be·better·than·calculating·the·formula·yourself·manually,·since·the·error·is·much·smaller.</p>	482	<p>Fixed·point·hypotenuse·(returns·the·square·root·of·<code>xx·+·yy</code>).·This·should·be·better·than·calculating·the·formula·yourself·manually,·since·the·error·is·much·smaller.</p>
484	<p·class="timestamp">	483	<p·class="timestamp">
485	Allegro·version·5.2.6	484	Allegro·version·5.2.6
486	·-·Last·updated:·2025-02-07·20:10:07·UTC	485	·-·Last·updated:·2024-01-06·13:49:32·UTC
487	</p>	486	</p>
488	</div>	487	</div>
489	</body>	488	</body>
490	</html>	489	</html>


Offset 101, 24 lines modified		Offset 101, 22 lines modified
101	··········o·al_get_glyph	101	··········o·al_get_glyph
102	These·functions·are·declared·in·the·following·header·file.·Link·with	102	These·functions·are·declared·in·the·following·header·file.·Link·with
103	allegro_font.	103	allegro_font.
104	·#include·<allegro5/allegro_font.h>	104	·#include·<allegro5/allegro_font.h>
105	****·General·font·routines·****	105	****·General·font·routines·****
106	***·ALLEGRO_FONT·***	106	***·ALLEGRO_FONT·***
107	typedef·struct·ALLEGRO_FONT·ALLEGRO_FONT;	107	typedef·struct·ALLEGRO_FONT·ALLEGRO_FONT;
108	typedef·struct·ALLEGRO_FONT·ALLEGRO_FONT;
109	Source_Code	108	Source_Code
110	A·handle·identifying·any·kind·of·font.·Usually·you·will·create·it·with	109	A·handle·identifying·any·kind·of·font.·Usually·you·will·create·it·with
111	al_load_font·which·supports·loading·all·kinds·of·TrueType·fonts·supported·by	110	al_load_font·which·supports·loading·all·kinds·of·TrueType·fonts·supported·by
112	the·FreeType·library.·If·you·instead·pass·the·filename·of·a·bitmap·file,·it	111	the·FreeType·library.·If·you·instead·pass·the·filename·of·a·bitmap·file,·it
113	will·be·loaded·with·al_load_bitmap·and·a·font·in·Allegroâs·bitmap·font·format	112	will·be·loaded·with·al_load_bitmap·and·a·font·in·Allegroâs·bitmap·font·format
114	will·be·created·from·it·with·al_grab_font_from_bitmap.	113	will·be·created·from·it·with·al_grab_font_from_bitmap.
115	***·ALLEGRO_GLYPH·***	114	***·ALLEGRO_GLYPH·***
116	typedef·struct·ALLEGRO_GLYPH·ALLEGRO_GLYPH;	115	typedef·struct·ALLEGRO_GLYPH·ALLEGRO_GLYPH;
117	typedef·struct·ALLEGRO_GLYPH·ALLEGRO_GLYPH;
118	Source_Code	116	Source_Code
119	A·structure·containing·the·properties·of·a·character·in·a·font.	117	A·structure·containing·the·properties·of·a·character·in·a·font.
120	typedef·struct·ALLEGRO_GLYPH·{	118	typedef·struct·ALLEGRO_GLYPH·{
121	···ALLEGRO_BITMAP·*bitmap;···//·the·bitmap·the·character·is·on	119	···ALLEGRO_BITMAP·*bitmap;···//·the·bitmap·the·character·is·on
122	···int·x;····················//·the·x·position·of·the·glyph·on·bitmap	120	···int·x;····················//·the·x·position·of·the·glyph·on·bitmap
123	···int·y;····················//·the·y·position·of·the·glyph·on·bitmap	121	···int·y;····················//·the·y·position·of·the·glyph·on·bitmap
124	···int·w;····················//·the·width·of·the·glyph·in·pixels	122	···int·w;····················//·the·width·of·the·glyph·in·pixels
Offset 139, 74 lines modified		Offset 137, 66 lines modified
139	advance·is·the·number·of·pixels·to·add·to·your·x·position·to·advance·to·the	137	advance·is·the·number·of·pixels·to·add·to·your·x·position·to·advance·to·the
140	next·character·in·a·string·and·includes·kerning.	138	next·character·in·a·string·and·includes·kerning.
141	Since:·5.2.1	139	Since:·5.2.1
142	·····Unstable_API:·This·API·is·new·and·subject·to·refinement.	140	·····Unstable_API:·This·API·is·new·and·subject·to·refinement.
143	See·also:·al_get_glyph	141	See·also:·al_get_glyph
144	***·al_init_font_addon·***	142	***·al_init_font_addon·***
145	bool·al_init_font_addon(void)	143	bool·al_init_font_addon(void)
146	bool·al_init_font_addon(void)
147	Source_Code	144	Source_Code
148	Initialise·the·font·addon.	145	Initialise·the·font·addon.
149	Note·that·if·you·intend·to·load·bitmap·fonts,·you·will·need·to·initialise	146	Note·that·if·you·intend·to·load·bitmap·fonts,·you·will·need·to·initialise
150	allegro_image·separately·(unless·you·are·using·another·library·to·load·images).	147	allegro_image·separately·(unless·you·are·using·another·library·to·load·images).
151	Similarly,·if·you·wish·to·load·truetype-fonts,·do·not·forget·to·also·call	148	Similarly,·if·you·wish·to·load·truetype-fonts,·do·not·forget·to·also·call
152	al_init_ttf_addon.	149	al_init_ttf_addon.
153	Returns·true·on·success,·false·on·failure.·On·the·5.0·branch,·this·function·has	150	Returns·true·on·success,·false·on·failure.·On·the·5.0·branch,·this·function·has
154	no·return·value.·You·may·wish·to·avoid·checking·the·return·value·if·your·code	151	no·return·value.·You·may·wish·to·avoid·checking·the·return·value·if·your·code
155	needs·to·be·compatible·with·Allegro·5.0.·Currently,·the·function·will·never	152	needs·to·be·compatible·with·Allegro·5.0.·Currently,·the·function·will·never
156	return·false.	153	return·false.
157	See·also:·al_init_image_addon,·al_init_ttf_addon,·al_shutdown_font_addon	154	See·also:·al_init_image_addon,·al_init_ttf_addon,·al_shutdown_font_addon
158	***·al_is_font_addon_initialized·***	155	***·al_is_font_addon_initialized·***
159	bool·al_is_font_addon_initialized(void)	156	bool·al_is_font_addon_initialized(void)
160	bool·al_is_font_addon_initialized(void)
161	Source_Code	157	Source_Code
162	Returns·true·if·the·font·addon·is·initialized,·otherwise·returns·false.	158	Returns·true·if·the·font·addon·is·initialized,·otherwise·returns·false.
163	Since:·5.2.6	159	Since:·5.2.6
164	See·also:·al_init_font_addon,·al_shutdown_font_addon	160	See·also:·al_init_font_addon,·al_shutdown_font_addon
165	***·al_shutdown_font_addon·***	161	***·al_shutdown_font_addon·***
166	void·al_shutdown_font_addon(void)	162	void·al_shutdown_font_addon(void)
167	void·al_shutdown_font_addon(void)
168	Source_Code	163	Source_Code
169	Shut·down·the·font·addon.·This·is·done·automatically·at·program·exit,·but·can	164	Shut·down·the·font·addon.·This·is·done·automatically·at·program·exit,·but·can
170	be·called·any·time·the·user·wishes·as·well.	165	be·called·any·time·the·user·wishes·as·well.
171	See·also:·al_init_font_addon	166	See·also:·al_init_font_addon
172	***·al_load_font·***	167	***·al_load_font·***
173	ALLEGRO_FONT·al_load_font(char·const·filename,·int·size,·int·flags)	168	ALLEGRO_FONT·al_load_font(char·const·filename,·int·size,·int·flags)
174	ALLEGRO_FONT·al_load_font(char·const·filename,·int·size,·int·flags)
175	Source_Code	169	Source_Code
176	Loads·a·font·from·disk.·This·will·use·al_load_bitmap_font_flags·if·you·pass·the	170	Loads·a·font·from·disk.·This·will·use·al_load_bitmap_font_flags·if·you·pass·the
177	name·of·a·known·bitmap·format,·or·else·al_load_ttf_font.	171	name·of·a·known·bitmap·format,·or·else·al_load_ttf_font.
178	The·flags·parameter·is·passed·through·to·either·of·those·functions.·Bitmap·and	172	The·flags·parameter·is·passed·through·to·either·of·those·functions.·Bitmap·and
179	TTF·fonts·are·also·affected·by·the·current·bitmap_flags·at·the·time·the·font·is	173	TTF·fonts·are·also·affected·by·the·current·bitmap_flags·at·the·time·the·font·is
180	loaded.	174	loaded.
181	See·also:·al_destroy_font,·al_init_font_addon,·al_register_font_loader,	175	See·also:·al_destroy_font,·al_init_font_addon,·al_register_font_loader,
182	al_load_bitmap_font_flags,·al_load_ttf_font	176	al_load_bitmap_font_flags,·al_load_ttf_font
183	***·al_destroy_font·***	177	***·al_destroy_font·***
184	void·al_destroy_font(ALLEGRO_FONT·*f)	178	void·al_destroy_font(ALLEGRO_FONT·*f)
185	void·al_destroy_font(ALLEGRO_FONT·*f)
186	Source_Code	179	Source_Code
187	Frees·the·memory·being·used·by·a·font·structure.·Does·nothing·if·passed·NULL.	180	Frees·the·memory·being·used·by·a·font·structure.·Does·nothing·if·passed·NULL.
188	See·also:·al_load_font	181	See·also:·al_load_font
189	***·al_register_font_loader·***	182	***·al_register_font_loader·***
190	bool·al_register_font_loader(char·const·*extension,	183	bool·al_register_font_loader(char·const·*extension,
191	···ALLEGRO_FONT·(load_font)(char·const·*filename,·int·size,·int·flags))	184	···ALLEGRO_FONT·(load_font)(char·const·*filename,·int·size,·int·flags))
192	bool·al_register_font_loader(char·const·*extension,
193	···ALLEGRO_FONT·(load_font)(char·const·*filename,·int·size,·int·flags))
194	Source_Code	185	Source_Code
195	Informs·Allegro·of·a·new·font·file·type,·telling·it·how·to·load·files·of·this	186	Informs·Allegro·of·a·new·font·file·type,·telling·it·how·to·load·files·of·this
196	format.	187	format.
197	The·extension·should·include·the·leading·dot·(â.â)·character.·It·will·be	188	The·extension·should·include·the·leading·dot·(â.â)·character.·It·will·be
198	matched·case-insensitively.	189	matched·case-insensitively.
199	The·load_font·argument·may·be·NULL·to·unregister·an·entry.	190	The·load_font·argument·may·be·NULL·to·unregister·an·entry.
200	Returns·true·on·success,·false·on·error.·Returns·false·if·unregistering·an	191	Returns·true·on·success,·false·on·error.·Returns·false·if·unregistering·an
201	entry·that·doesnât·exist.	192	entry·that·doesnât·exist.
202	See·also:·al_init_font_addon	193	See·also:·al_init_font_addon
203	***·al_get_font_line_height·***	194	***·al_get_font_line_height·***
204	int·al_get_font_line_height(const·ALLEGRO_FONT·*f)	195	int·al_get_font_line_height(const·ALLEGRO_FONT·*f)
205	int·al_get_font_line_height(const·ALLEGRO_FONT·*f)
206	Source_Code	196	Source_Code
207	Returns·the·usual·height·of·a·line·of·text·in·the·specified·font.·For·bitmap	197	Returns·the·usual·height·of·a·line·of·text·in·the·specified·font.·For·bitmap
208	fonts·this·is·simply·the·height·of·all·glyph·bitmaps.·For·truetype·fonts·it·is	198	fonts·this·is·simply·the·height·of·all·glyph·bitmaps.·For·truetype·fonts·it·is
209	whatever·the·font·file·specifies.·In·particular,·some·special·glyphs·may·be	199	whatever·the·font·file·specifies.·In·particular,·some·special·glyphs·may·be
210	higher·than·the·height·returned·here.	200	higher·than·the·height·returned·here.
211	If·the·X·is·the·position·you·specify·to·draw·text,·the·meaning·of·ascent·and	201	If·the·X·is·the·position·you·specify·to·draw·text,·the·meaning·of·ascent·and
212	descent·and·the·line·height·is·like·in·the·figure·below.	202	descent·and·the·line·height·is·like·in·the·figure·below.
Offset 220, 43 lines modified		Offset 210, 36 lines modified
220	···············\|········\|	210	···············\|········\|
221	···············descent··\|	211	···············descent··\|
222	···············\|········\|	212	···············\|········\|
223	-------------------------	213	-------------------------
224	See·also:·al_get_text_width,·al_get_text_dimensions	214	See·also:·al_get_text_width,·al_get_text_dimensions
225	***·al_get_font_ascent·***	215	***·al_get_font_ascent·***
226	int·al_get_font_ascent(const·ALLEGRO_FONT·*f)	216	int·al_get_font_ascent(const·ALLEGRO_FONT·*f)
227	int·al_get_font_ascent(const·ALLEGRO_FONT·*f)
228	Source_Code	217	Source_Code
229	Returns·the·ascent·of·the·specified·font.	218	Returns·the·ascent·of·the·specified·font.
230	See·also:·al_get_font_descent,·al_get_font_line_height	219	See·also:·al_get_font_descent,·al_get_font_line_height
231	***·al_get_font_descent·***	220	***·al_get_font_descent·***
232	int·al_get_font_descent(const·ALLEGRO_FONT·*f)	221	int·al_get_font_descent(const·ALLEGRO_FONT·*f)
233	int·al_get_font_descent(const·ALLEGRO_FONT·*f)
234	Source_Code	222	Source_Code
235	Returns·the·descent·of·the·specified·font.	223	Returns·the·descent·of·the·specified·font.
236	See·also:·al_get_font_ascent,·al_get_font_line_height	224	See·also:·al_get_font_ascent,·al_get_font_line_height
237	***·al_get_text_width·***	225	***·al_get_text_width·***
238	int·al_get_text_width(const·ALLEGRO_FONT·f,·const·char·str)	226	int·al_get_text_width(const·ALLEGRO_FONT·f,·const·char·str)
239	int·al_get_text_width(const·ALLEGRO_FONT·f,·const·char·str)
240	Source_Code	227	Source_Code
241	Calculates·the·length·of·a·string·in·a·particular·font,·in·pixels.	228	Calculates·the·length·of·a·string·in·a·particular·font,·in·pixels.
242	See·also:·al_get_ustr_width,·al_get_font_line_height,·al_get_text_dimensions	229	See·also:·al_get_ustr_width,·al_get_font_line_height,·al_get_text_dimensions
243	***·al_get_ustr_width·***	230	***·al_get_ustr_width·***
244	int·al_get_ustr_width(const·ALLEGRO_FONT·f,·ALLEGRO_USTR·const·ustr)	231	int·al_get_ustr_width(const·ALLEGRO_FONT·f,·ALLEGRO_USTR·const·ustr)
245	int·al_get_ustr_width(const·ALLEGRO_FONT·f,·ALLEGRO_USTR·const·ustr)
246	Source_Code	232	Source_Code
Max diff block lines reached; 21420/27438 bytes (78.07%) of diff not shown.


Offset 199, 21 lines modified		Offset 199, 19 lines modified
199	</ul></li>	199	</ul></li>
200	</ul>	200	</ul>
201	</nav>	201	</nav>
202	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>	202	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>
203	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>	203	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>
204	<p>These·functions·allow·access·to·the·filesystem.·This·can·either·be·the·real·filesystem·like·your·harddrive,·or·a·virtual·filesystem·like·a·.zip·archive·(or·whatever·else·you·or·an·addon·makes·it·do).</p>	204	<p>These·functions·allow·access·to·the·filesystem.·This·can·either·be·the·real·filesystem·like·your·harddrive,·or·a·virtual·filesystem·like·a·.zip·archive·(or·whatever·else·you·or·an·addon·makes·it·do).</p>
205	<h1·id="allegro_fs_entry">ALLEGRO_FS_ENTRY</h1>	205	<h1·id="allegro_fs_entry">ALLEGRO_FS_ENTRY</h1>
206	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY;</span>	206	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY;</span></code></pre></div>
207	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY;</span></code></pre></div>
208	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L37">Source·Code</a></p>	207	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L37">Source·Code</a></p>
209	<p>Opaque·filesystem·entry·object.·Represents·a·file·or·a·directory·(check·with·<a·href="fshook.html#al_get_fs_entry_mode">al_get_fs_entry_mode</a>).·There·are·no·user·accessible·member·variables.</p>	208	<p>Opaque·filesystem·entry·object.·Represents·a·file·or·a·directory·(check·with·<a·href="fshook.html#al_get_fs_entry_mode">al_get_fs_entry_mode</a>).·There·are·no·user·accessible·member·variables.</p>
210	<h1·id="allegro_file_mode">ALLEGRO_FILE_MODE</h1>	209	<h1·id="allegro_file_mode">ALLEGRO_FILE_MODE</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"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_FILE_MODE</span>	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"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_FILE_MODE</span></code></pre></div>
212	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_FILE_MODE</span></code></pre></div>
213	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L46">Source·Code</a></p>	211	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L46">Source·Code</a></p>
214	<p>Filesystem·modes/types</p>	212	<p>Filesystem·modes/types</p>
215	<ul>	213	<ul>
216	<li>ALLEGRO_FILEMODE_READ·-·Readable</li>	214	<li>ALLEGRO_FILEMODE_READ·-·Readable</li>
217	<li>ALLEGRO_FILEMODE_WRITE·-·Writable</li>	215	<li>ALLEGRO_FILEMODE_WRITE·-·Writable</li>
218	<li>ALLEGRO_FILEMODE_EXECUTE·-·Executable</li>	216	<li>ALLEGRO_FILEMODE_EXECUTE·-·Executable</li>
219	<li>ALLEGRO_FILEMODE_HIDDEN·-·Hidden</li>	217	<li>ALLEGRO_FILEMODE_HIDDEN·-·Hidden</li>
Offset 331, 16 lines modified		Offset 329, 15 lines modified
331	<h2·id="al_open_fs_entry">al_open_fs_entry</h2>	329	<h2·id="al_open_fs_entry">al_open_fs_entry</h2>
332	<div·class="sourceCode"·id="cb23"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb23-1"><a·href="#cb23-1"·aria-hidden="true"></a>ALLEGRO_FILE·al_open_fs_entry(ALLEGRO_FS_ENTRY·e,·<span·class="dt">const</span>·<span·class="dt">char</span>·*mode)</span></code></pre></div>	330	<div·class="sourceCode"·id="cb23"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb23-1"><a·href="#cb23-1"·aria-hidden="true"></a>ALLEGRO_FILE·al_open_fs_entry(ALLEGRO_FS_ENTRY·e,·<span·class="dt">const</span>·<span·class="dt">char</span>·*mode)</span></code></pre></div>
333	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/fshook.c#L226">Source·Code</a></p>	331	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/fshook.c#L226">Source·Code</a></p>
334	<p>Open·an·<a·href="file.html#allegro_file">ALLEGRO_FILE</a>·handle·to·a·filesystem·entry,·for·the·given·access·mode.·This·is·like·calling·<a·href="file.html#al_fopen">al_fopen</a>·with·the·name·of·the·filesystem·entry,·but·uses·the·appropriate·file·interface,·not·whatever·was·set·with·the·latest·call·to·<a·href="file.html#al_set_new_file_interface">al_set_new_file_interface</a>.</p>	332	<p>Open·an·<a·href="file.html#allegro_file">ALLEGRO_FILE</a>·handle·to·a·filesystem·entry,·for·the·given·access·mode.·This·is·like·calling·<a·href="file.html#al_fopen">al_fopen</a>·with·the·name·of·the·filesystem·entry,·but·uses·the·appropriate·file·interface,·not·whatever·was·set·with·the·latest·call·to·<a·href="file.html#al_set_new_file_interface">al_set_new_file_interface</a>.</p>
335	<p>Returns·the·handle·on·success,·NULL·on·error.</p>	333	<p>Returns·the·handle·on·success,·NULL·on·error.</p>
336	<p>See·also:·<a·href="file.html#al_fopen">al_fopen</a></p>	334	<p>See·also:·<a·href="file.html#al_fopen">al_fopen</a></p>
337	<h2·id="allegro_for_each_fs_entry_result">ALLEGRO_FOR_EACH_FS_ENTRY_RESULT</h2>	335	<h2·id="allegro_for_each_fs_entry_result">ALLEGRO_FOR_EACH_FS_ENTRY_RESULT</h2>
338	<div·class="sourceCode"·id="cb24"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb24-1"><a·href="#cb24-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·{</span>	336	<div·class="sourceCode"·id="cb24"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb24-1"><a·href="#cb24-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·{</span></code></pre></div>
339	<span·id="cb24-2"><a·href="#cb24-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">enum</span>·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·{</span></code></pre></div>
340	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L124">Source·Code</a></p>	337	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L124">Source·Code</a></p>
341	<p>Return·values·for·the·callbacks·of·<a·href="fshook.html#al_for_each_fs_entry">al_for_each_fs_entry</a>·and·for·that·function·itself.</p>	338	<p>Return·values·for·the·callbacks·of·<a·href="fshook.html#al_for_each_fs_entry">al_for_each_fs_entry</a>·and·for·that·function·itself.</p>
342	<ul>	339	<ul>
343	<li>ALLEGRO_FOR_EACH_FS_ENTRY_ERROR·-·An·error·ocurred.</li>	340	<li>ALLEGRO_FOR_EACH_FS_ENTRY_ERROR·-·An·error·ocurred.</li>
344	<li>ALLEGRO_FOR_EACH_FS_ENTRY_OK·-·Continue·normally·and·recurse·into·directories.</li>	341	<li>ALLEGRO_FOR_EACH_FS_ENTRY_OK·-·Continue·normally·and·recurse·into·directories.</li>
345	<li>ALLEGRO_FOR_EACH_FS_ENTRY_SKIP·-·Continue·but·do·NOT·recusively·descend.</li>	342	<li>ALLEGRO_FOR_EACH_FS_ENTRY_SKIP·-·Continue·but·do·NOT·recusively·descend.</li>
346	<li>ALLEGRO_FOR_EACH_FS_ENTRY_STOP·-·Stop·iterating·and·return.</li>	343	<li>ALLEGRO_FOR_EACH_FS_ENTRY_STOP·-·Stop·iterating·and·return.</li>
Offset 360, 16 lines modified		Offset 357, 15 lines modified
360	<p>This·function·will·skip·any·files·or·directories·named·<code>.</code>·or·<code>..</code>·which·may·exist·on·certain·platforms·and·may·signify·the·current·and·the·parent·directory.·The·<code>callback</code>·will·not·be·called·for·files·or·directories·with·such·a·name.</p>	357	<p>This·function·will·skip·any·files·or·directories·named·<code>.</code>·or·<code>..</code>·which·may·exist·on·certain·platforms·and·may·signify·the·current·and·the·parent·directory.·The·<code>callback</code>·will·not·be·called·for·files·or·directories·with·such·a·name.</p>
361	<p>Returns·ALLEGRO_FOR_EACH_FS_ENTRY_OK·if·successful,·or·ALLEGRO_FOR_EACH_FS_ENTRY_ERROR·if·something·went·wrong·in·processing·the·directory.·In·that·case·it·will·use·<a·href="state.html#al_set_errno">al_set_errno</a>·to·indicate·the·type·of·error·which·occurred.·This·function·returns·ALLEGRO_FOR_EACH_FS_ENTRY_STOP·in·case·iteration·was·stopped·by·making·<code>callback</code>·return·that·value.·In·this·case,·<a·href="state.html#al_set_errno">al_set_errno</a>·will·not·be·used.</p>	358	<p>Returns·ALLEGRO_FOR_EACH_FS_ENTRY_OK·if·successful,·or·ALLEGRO_FOR_EACH_FS_ENTRY_ERROR·if·something·went·wrong·in·processing·the·directory.·In·that·case·it·will·use·<a·href="state.html#al_set_errno">al_set_errno</a>·to·indicate·the·type·of·error·which·occurred.·This·function·returns·ALLEGRO_FOR_EACH_FS_ENTRY_STOP·in·case·iteration·was·stopped·by·making·<code>callback</code>·return·that·value.·In·this·case,·<a·href="state.html#al_set_errno">al_set_errno</a>·will·not·be·used.</p>
362	<p>See·also:·<a·href="fshook.html#allegro_for_each_fs_entry_result">ALLEGRO_FOR_EACH_FS_ENTRY_RESULT</a></p>	359	<p>See·also:·<a·href="fshook.html#allegro_for_each_fs_entry_result">ALLEGRO_FOR_EACH_FS_ENTRY_RESULT</a></p>
363	<p>Since:·5.1.9</p>	360	<p>Since:·5.1.9</p>
364	<h1·id="alternative-filesystem-functions">Alternative·filesystem·functions</h1>	361	<h1·id="alternative-filesystem-functions">Alternative·filesystem·functions</h1>
365	<p>By·default,·Allegro·uses·platform·specific·filesystem·functions·for·things·like·directory·access.·However·if·for·example·the·files·of·your·game·are·not·in·the·local·filesystem·but·inside·some·file·archive,·you·can·provide·your·own·set·of·functions·(or·use·an·addon·which·does·this·for·you,·for·example·our·physfs·addon·allows·access·to·the·most·common·archive·formats).</p>	362	<p>By·default,·Allegro·uses·platform·specific·filesystem·functions·for·things·like·directory·access.·However·if·for·example·the·files·of·your·game·are·not·in·the·local·filesystem·but·inside·some·file·archive,·you·can·provide·your·own·set·of·functions·(or·use·an·addon·which·does·this·for·you,·for·example·our·physfs·addon·allows·access·to·the·most·common·archive·formats).</p>
366	<h2·id="allegro_fs_interface">ALLEGRO_FS_INTERFACE</h2>	363	<h2·id="allegro_fs_interface">ALLEGRO_FS_INTERFACE</h2>
367	<div·class="sourceCode"·id="cb26"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb26-1"><a·href="#cb26-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FS_INTERFACE·ALLEGRO_FS_INTERFACE;</span>	364	<div·class="sourceCode"·id="cb26"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb26-1"><a·href="#cb26-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FS_INTERFACE·ALLEGRO_FS_INTERFACE;</span></code></pre></div>
368	<span·id="cb26-2"><a·href="#cb26-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_FS_INTERFACE·ALLEGRO_FS_INTERFACE;</span></code></pre></div>
369	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L64">Source·Code</a></p>	365	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fshook.h#L64">Source·Code</a></p>
370	<p>The·available·functions·you·can·provide·for·a·filesystem.·They·are:</p>	366	<p>The·available·functions·you·can·provide·for·a·filesystem.·They·are:</p>
371	<pre><code>···ALLEGRO_FS_ENTRY···fs_create_entry···(const·char·path);	367	<pre><code>···ALLEGRO_FS_ENTRY···fs_create_entry···(const·char·path);
372	···void················fs_destroy_entry··(ALLEGRO_FS_ENTRY·*e);	368	···void················fs_destroy_entry··(ALLEGRO_FS_ENTRY·*e);
373	···const·char·········fs_entry_name·····(ALLEGRO_FS_ENTRY·e);	369	···const·char·········fs_entry_name·····(ALLEGRO_FS_ENTRY·e);
374	···bool················fs_update_entry···(ALLEGRO_FS_ENTRY·*e);	370	···bool················fs_update_entry···(ALLEGRO_FS_ENTRY·*e);
375	···uint32_t············fs_entry_mode·····(ALLEGRO_FS_ENTRY·*e);	371	···uint32_t············fs_entry_mode·····(ALLEGRO_FS_ENTRY·*e);
Offset 404, 12 lines modified		Offset 400, 12 lines modified
404	<h2·id="al_get_fs_interface">al_get_fs_interface</h2>	400	<h2·id="al_get_fs_interface">al_get_fs_interface</h2>
405	<div·class="sourceCode"·id="cb30"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb30-1"><a·href="#cb30-1"·aria-hidden="true"></a><span·class="dt">const</span>·ALLEGRO_FS_INTERFACE·*al_get_fs_interface(<span·class="dt">void</span>)</span></code></pre></div>	401	<div·class="sourceCode"·id="cb30"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb30-1"><a·href="#cb30-1"·aria-hidden="true"></a><span·class="dt">const</span>·ALLEGRO_FS_INTERFACE·*al_get_fs_interface(<span·class="dt">void</span>)</span></code></pre></div>
406	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L874">Source·Code</a></p>	402	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/tls.c#L874">Source·Code</a></p>
407	<p>Return·a·pointer·to·the·<a·href="fshook.html#allegro_fs_interface">ALLEGRO_FS_INTERFACE</a>·table·in·effect·for·the·calling·thread.</p>	403	<p>Return·a·pointer·to·the·<a·href="fshook.html#allegro_fs_interface">ALLEGRO_FS_INTERFACE</a>·table·in·effect·for·the·calling·thread.</p>
408	<p>See·also:·<a·href="state.html#al_store_state">al_store_state</a>,·<a·href="state.html#al_restore_state">al_restore_state</a>.</p>	404	<p>See·also:·<a·href="state.html#al_store_state">al_store_state</a>,·<a·href="state.html#al_restore_state">al_restore_state</a>.</p>
409	<p·class="timestamp">	405	<p·class="timestamp">
410	Allegro·version·5.2.6	406	Allegro·version·5.2.6
411	·-·Last·updated:·2025-02-07·20:10:07·UTC	407	·-·Last·updated:·2024-01-06·13:49:32·UTC
412	</p>	408	</p>
413	</div>	409	</div>
414	</body>	410	</body>
415	</html>	411	</html>


Offset 80, 21 lines modified		Offset 80, 19 lines modified
80	These·functions·are·declared·in·the·main·Allegro·header·file:	80	These·functions·are·declared·in·the·main·Allegro·header·file:
81	·#include·<allegro5/allegro.h>	81	·#include·<allegro5/allegro.h>
82	These·functions·allow·access·to·the·filesystem.·This·can·either·be·the·real	82	These·functions·allow·access·to·the·filesystem.·This·can·either·be·the·real
83	filesystem·like·your·harddrive,·or·a·virtual·filesystem·like·a·.zip·archive·(or	83	filesystem·like·your·harddrive,·or·a·virtual·filesystem·like·a·.zip·archive·(or
84	whatever·else·you·or·an·addon·makes·it·do).	84	whatever·else·you·or·an·addon·makes·it·do).
85	****·ALLEGRO_FS_ENTRY·****	85	****·ALLEGRO_FS_ENTRY·****
86	typedef·struct·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY;	86	typedef·struct·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY;
87	typedef·struct·ALLEGRO_FS_ENTRY·ALLEGRO_FS_ENTRY;
88	Source_Code	87	Source_Code
89	Opaque·filesystem·entry·object.·Represents·a·file·or·a·directory·(check·with	88	Opaque·filesystem·entry·object.·Represents·a·file·or·a·directory·(check·with
90	al_get_fs_entry_mode).·There·are·no·user·accessible·member·variables.	89	al_get_fs_entry_mode).·There·are·no·user·accessible·member·variables.
91	****·ALLEGRO_FILE_MODE·****	90	****·ALLEGRO_FILE_MODE·****
92	typedef·enum·ALLEGRO_FILE_MODE	91	typedef·enum·ALLEGRO_FILE_MODE
93	typedef·enum·ALLEGRO_FILE_MODE
94	Source_Code	92	Source_Code
95	Filesystem·modes/types	93	Filesystem·modes/types
96	····*·ALLEGRO_FILEMODE_READ·-·Readable	94	····*·ALLEGRO_FILEMODE_READ·-·Readable
97	····*·ALLEGRO_FILEMODE_WRITE·-·Writable	95	····*·ALLEGRO_FILEMODE_WRITE·-·Writable
98	····*·ALLEGRO_FILEMODE_EXECUTE·-·Executable	96	····*·ALLEGRO_FILEMODE_EXECUTE·-·Executable
99	····*·ALLEGRO_FILEMODE_HIDDEN·-·Hidden	97	····*·ALLEGRO_FILEMODE_HIDDEN·-·Hidden
100	····*·ALLEGRO_FILEMODE_ISFILE·-·Regular·file	98	····*·ALLEGRO_FILEMODE_ISFILE·-·Regular·file
Offset 246, 15 lines modified		Offset 244, 14 lines modified
246	This·is·like·calling·al_fopen·with·the·name·of·the·filesystem·entry,·but·uses	244	This·is·like·calling·al_fopen·with·the·name·of·the·filesystem·entry,·but·uses
247	the·appropriate·file·interface,·not·whatever·was·set·with·the·latest·call·to	245	the·appropriate·file·interface,·not·whatever·was·set·with·the·latest·call·to
248	al_set_new_file_interface.	246	al_set_new_file_interface.
249	Returns·the·handle·on·success,·NULL·on·error.	247	Returns·the·handle·on·success,·NULL·on·error.
250	See·also:·al_fopen	248	See·also:·al_fopen
251	***·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·***	249	***·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·***
252	typedef·enum·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·{	250	typedef·enum·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·{
253	typedef·enum·ALLEGRO_FOR_EACH_FS_ENTRY_RESULT·{
254	Source_Code	251	Source_Code
255	Return·values·for·the·callbacks·of·al_for_each_fs_entry·and·for·that·function	252	Return·values·for·the·callbacks·of·al_for_each_fs_entry·and·for·that·function
256	itself.	253	itself.
257	····*·ALLEGRO_FOR_EACH_FS_ENTRY_ERROR·-·An·error·ocurred.	254	····*·ALLEGRO_FOR_EACH_FS_ENTRY_ERROR·-·An·error·ocurred.
258	····*·ALLEGRO_FOR_EACH_FS_ENTRY_OK·-·Continue·normally·and·recurse·into	255	····*·ALLEGRO_FOR_EACH_FS_ENTRY_OK·-·Continue·normally·and·recurse·into
259	······directories.	256	······directories.
260	····*·ALLEGRO_FOR_EACH_FS_ENTRY_SKIP·-·Continue·but·do·NOT·recusively·descend.	257	····*·ALLEGRO_FOR_EACH_FS_ENTRY_SKIP·-·Continue·but·do·NOT·recusively·descend.
Offset 299, 15 lines modified		Offset 296, 14 lines modified
299	By·default,·Allegro·uses·platform·specific·filesystem·functions·for·things·like	296	By·default,·Allegro·uses·platform·specific·filesystem·functions·for·things·like
300	directory·access.·However·if·for·example·the·files·of·your·game·are·not·in·the	297	directory·access.·However·if·for·example·the·files·of·your·game·are·not·in·the
301	local·filesystem·but·inside·some·file·archive,·you·can·provide·your·own·set·of	298	local·filesystem·but·inside·some·file·archive,·you·can·provide·your·own·set·of
302	functions·(or·use·an·addon·which·does·this·for·you,·for·example·our·physfs	299	functions·(or·use·an·addon·which·does·this·for·you,·for·example·our·physfs
303	addon·allows·access·to·the·most·common·archive·formats).	300	addon·allows·access·to·the·most·common·archive·formats).
304	***·ALLEGRO_FS_INTERFACE·***	301	***·ALLEGRO_FS_INTERFACE·***
305	typedef·struct·ALLEGRO_FS_INTERFACE·ALLEGRO_FS_INTERFACE;	302	typedef·struct·ALLEGRO_FS_INTERFACE·ALLEGRO_FS_INTERFACE;
306	typedef·struct·ALLEGRO_FS_INTERFACE·ALLEGRO_FS_INTERFACE;
307	Source_Code	303	Source_Code
308	The·available·functions·you·can·provide·for·a·filesystem.·They·are:	304	The·available·functions·you·can·provide·for·a·filesystem.·They·are:
309	···ALLEGRO_FS_ENTRY···fs_create_entry···(const·char·path);	305	···ALLEGRO_FS_ENTRY···fs_create_entry···(const·char·path);
310	···void················fs_destroy_entry··(ALLEGRO_FS_ENTRY·*e);	306	···void················fs_destroy_entry··(ALLEGRO_FS_ENTRY·*e);
311	···const·char·········fs_entry_name·····(ALLEGRO_FS_ENTRY·e);	307	···const·char·········fs_entry_name·····(ALLEGRO_FS_ENTRY·e);
312	···bool················fs_update_entry···(ALLEGRO_FS_ENTRY·*e);	308	···bool················fs_update_entry···(ALLEGRO_FS_ENTRY·*e);
313	···uint32_t············fs_entry_mode·····(ALLEGRO_FS_ENTRY·*e);	309	···uint32_t············fs_entry_mode·····(ALLEGRO_FS_ENTRY·*e);
Offset 341, 8 lines modified		Offset 337, 8 lines modified
341	See·also:·al_set_fs_interface.	337	See·also:·al_set_fs_interface.
342	***·al_get_fs_interface·***	338	***·al_get_fs_interface·***
343	const·ALLEGRO_FS_INTERFACE·*al_get_fs_interface(void)	339	const·ALLEGRO_FS_INTERFACE·*al_get_fs_interface(void)
344	Source_Code	340	Source_Code
345	Return·a·pointer·to·the·ALLEGRO_FS_INTERFACE·table·in·effect·for·the·calling	341	Return·a·pointer·to·the·ALLEGRO_FS_INTERFACE·table·in·effect·for·the·calling
346	thread.	342	thread.
347	See·also:·al_store_state,·al_restore_state.	343	See·also:·al_store_state,·al_restore_state.
348	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:07·UTC	344	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:32·UTC


Offset 167, 16 lines modified		Offset 167, 15 lines modified
167	<li><a·href="#al_get_display_mode">al_get_display_mode</a></li>	167	<li><a·href="#al_get_display_mode">al_get_display_mode</a></li>
168	<li><a·href="#al_get_num_display_modes">al_get_num_display_modes</a></li>	168	<li><a·href="#al_get_num_display_modes">al_get_num_display_modes</a></li>
169	</ul>	169	</ul>
170	</nav>	170	</nav>
171	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>	171	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>
172	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>	172	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>
173	<h1·id="allegro_display_mode">ALLEGRO_DISPLAY_MODE</h1>	173	<h1·id="allegro_display_mode">ALLEGRO_DISPLAY_MODE</h1>
174	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY_MODE</span>	174	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY_MODE</span></code></pre></div>
175	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY_MODE</span></code></pre></div>
176	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fullscreen_mode.h#L13">Source·Code</a></p>	175	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/fullscreen_mode.h#L13">Source·Code</a></p>
177	<p>Used·for·fullscreen·mode·queries.·Contains·information·about·a·supported·fullscreen·modes.</p>	176	<p>Used·for·fullscreen·mode·queries.·Contains·information·about·a·supported·fullscreen·modes.</p>
178	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY_MODE·{</span>	177	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_DISPLAY_MODE·{</span>
179	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a>···<span·class="dt">int</span>·width;··········<span·class="co">//·Screen·width</span></span>	178	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a>···<span·class="dt">int</span>·width;··········<span·class="co">//·Screen·width</span></span>
180	<span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"></a>···<span·class="dt">int</span>·height;·········<span·class="co">//·Screen·height</span></span>	179	<span·id="cb3-3"><a·href="#cb3-3"·aria-hidden="true"></a>···<span·class="dt">int</span>·height;·········<span·class="co">//·Screen·height</span></span>
181	<span·id="cb3-4"><a·href="#cb3-4"·aria-hidden="true"></a>···<span·class="dt">int</span>·format;·········<span·class="co">//·The·pixel·format·of·the·mode</span></span>	180	<span·id="cb3-4"><a·href="#cb3-4"·aria-hidden="true"></a>···<span·class="dt">int</span>·format;·········<span·class="co">//·The·pixel·format·of·the·mode</span></span>
182	<span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"></a>···<span·class="dt">int</span>·refresh_rate;···<span·class="co">//·The·refresh·rate·of·the·mode</span></span>	181	<span·id="cb3-5"><a·href="#cb3-5"·aria-hidden="true"></a>···<span·class="dt">int</span>·refresh_rate;···<span·class="co">//·The·refresh·rate·of·the·mode</span></span>
Offset 192, 12 lines modified		Offset 191, 12 lines modified
192	<h1·id="al_get_num_display_modes">al_get_num_display_modes</h1>	191	<h1·id="al_get_num_display_modes">al_get_num_display_modes</h1>
193	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="dt">int</span>·al_get_num_display_modes(<span·class="dt">void</span>)</span></code></pre></div>	192	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="dt">int</span>·al_get_num_display_modes(<span·class="dt">void</span>)</span></code></pre></div>
194	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/fullscreen_mode.c#L23">Source·Code</a></p>	193	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/fullscreen_mode.c#L23">Source·Code</a></p>
195	<p>Get·the·number·of·available·fullscreen·display·modes·for·the·current·set·of·display·parameters.·This·will·use·the·values·set·with·<a·href="display.html#al_set_new_display_refresh_rate">al_set_new_display_refresh_rate</a>,·and·<a·href="display.html#al_set_new_display_flags">al_set_new_display_flags</a>·to·find·the·number·of·modes·that·match.·Settings·the·new·display·parameters·to·zero·will·give·a·list·of·all·modes·for·the·default·driver.</p>	194	<p>Get·the·number·of·available·fullscreen·display·modes·for·the·current·set·of·display·parameters.·This·will·use·the·values·set·with·<a·href="display.html#al_set_new_display_refresh_rate">al_set_new_display_refresh_rate</a>,·and·<a·href="display.html#al_set_new_display_flags">al_set_new_display_flags</a>·to·find·the·number·of·modes·that·match.·Settings·the·new·display·parameters·to·zero·will·give·a·list·of·all·modes·for·the·default·driver.</p>
196	<p>See·also:·<a·href="fullscreen_mode.html#al_get_display_mode">al_get_display_mode</a></p>	195	<p>See·also:·<a·href="fullscreen_mode.html#al_get_display_mode">al_get_display_mode</a></p>
197	<p·class="timestamp">	196	<p·class="timestamp">
198	Allegro·version·5.2.6	197	Allegro·version·5.2.6
199	·-·Last·updated:·2025-02-07·20:10:08·UTC	198	·-·Last·updated:·2024-01-06·13:49:33·UTC
200	</p>	199	</p>
201	</div>	200	</div>
202	</body>	201	</body>
203	</html>	202	</html>


Offset 50, 15 lines modified		Offset 50, 14 lines modified
50	····*·ALLEGRO_DISPLAY_MODE	50	····*·ALLEGRO_DISPLAY_MODE
51	····*·al_get_display_mode	51	····*·al_get_display_mode
52	····*·al_get_num_display_modes	52	····*·al_get_num_display_modes
53	These·functions·are·declared·in·the·main·Allegro·header·file:	53	These·functions·are·declared·in·the·main·Allegro·header·file:
54	·#include·<allegro5/allegro.h>	54	·#include·<allegro5/allegro.h>
55	****·ALLEGRO_DISPLAY_MODE·****	55	****·ALLEGRO_DISPLAY_MODE·****
56	typedef·struct·ALLEGRO_DISPLAY_MODE	56	typedef·struct·ALLEGRO_DISPLAY_MODE
57	typedef·struct·ALLEGRO_DISPLAY_MODE
58	Source_Code	57	Source_Code
59	Used·for·fullscreen·mode·queries.·Contains·information·about·a·supported	58	Used·for·fullscreen·mode·queries.·Contains·information·about·a·supported
60	fullscreen·modes.	59	fullscreen·modes.
61	typedef·struct·ALLEGRO_DISPLAY_MODE·{	60	typedef·struct·ALLEGRO_DISPLAY_MODE·{
62	···int·width;··········//·Screen·width	61	···int·width;··········//·Screen·width
63	···int·height;·········//·Screen·height	62	···int·height;·········//·Screen·height
64	···int·format;·········//·The·pixel·format·of·the·mode	63	···int·format;·········//·The·pixel·format·of·the·mode
Offset 82, 8 lines modified		Offset 81, 8 lines modified
82	Source_Code	81	Source_Code
83	Get·the·number·of·available·fullscreen·display·modes·for·the·current·set·of	82	Get·the·number·of·available·fullscreen·display·modes·for·the·current·set·of
84	display·parameters.·This·will·use·the·values·set·with	83	display·parameters.·This·will·use·the·values·set·with
85	al_set_new_display_refresh_rate,·and·al_set_new_display_flags·to·find·the	84	al_set_new_display_refresh_rate,·and·al_set_new_display_flags·to·find·the
86	number·of·modes·that·match.·Settings·the·new·display·parameters·to·zero·will	85	number·of·modes·that·match.·Settings·the·new·display·parameters·to·zero·will
87	give·a·list·of·all·modes·for·the·default·driver.	86	give·a·list·of·all·modes·for·the·default·driver.
88	See·also:·al_get_display_mode	87	See·also:·al_get_display_mode
89	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:08·UTC	88	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:33·UTC


Offset 183, 12 lines modified		Offset 183, 12 lines modified
183	<p>Some·of·Allegro’s·API·is·marked·as·unstable,·which·means·that·in·future·versions·of·Allegro·it·may·change·or·even·be·removed·entirely!·If·you·want·to·experiment·with·the·unstable·API,·define·<code>ALLEGRO_UNSTABLE</code>·macro·before·including·Allegro’s·headers.</p>	183	<p>Some·of·Allegro’s·API·is·marked·as·unstable,·which·means·that·in·future·versions·of·Allegro·it·may·change·or·even·be·removed·entirely!·If·you·want·to·experiment·with·the·unstable·API,·define·<code>ALLEGRO_UNSTABLE</code>·macro·before·including·Allegro’s·headers.</p>
184	<p>Note·that·when·you·define·that·macro,·the·version·check·performed·by·<a·href="system.html#al_install_system">al_install_system</a>·and·<a·href="system.html#al_init">al_init</a>·becomes·more·scrict.·See·documentation·of·those·functions·for·details.</p>	184	<p>Note·that·when·you·define·that·macro,·the·version·check·performed·by·<a·href="system.html#al_install_system">al_install_system</a>·and·<a·href="system.html#al_init">al_init</a>·becomes·more·scrict.·See·documentation·of·those·functions·for·details.</p>
185	<h1·id="not-the-end">Not·the·end</h1>	185	<h1·id="not-the-end">Not·the·end</h1>
186	<p>There’s·a·heap·of·stuff·we·haven’t·even·mentioned·yet.</p>	186	<p>There’s·a·heap·of·stuff·we·haven’t·even·mentioned·yet.</p>
187	<p>Enjoy!</p>	187	<p>Enjoy!</p>
188	<p·class="timestamp">	188	<p·class="timestamp">
189	Allegro·version·5.2.6	189	Allegro·version·5.2.6
190	·-·Last·updated:·2025-02-07·20:10:03·UTC	190	·-·Last·updated:·2024-01-06·13:49:30·UTC
191	</p>	191	</p>
192	</div>	192	</div>
193	</body>	193	</body>
194	</html>	194	</html>


Offset 195, 8 lines modified		Offset 195, 8 lines modified
195	including·Allegroâs·headers.	195	including·Allegroâs·headers.
196	Note·that·when·you·define·that·macro,·the·version·check·performed·by	196	Note·that·when·you·define·that·macro,·the·version·check·performed·by
197	al_install_system·and·al_init·becomes·more·scrict.·See·documentation·of·those	197	al_install_system·and·al_init·becomes·more·scrict.·See·documentation·of·those
198	functions·for·details.	198	functions·for·details.
199	****·Not·the·end·****	199	****·Not·the·end·****
200	Thereâs·a·heap·of·stuff·we·havenât·even·mentioned·yet.	200	Thereâs·a·heap·of·stuff·we·havenât·even·mentioned·yet.
201	Enjoy!	201	Enjoy!
202	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:03·UTC	202	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:30·UTC


Offset 171, 15 lines modified		Offset 171, 14 lines modified
171	··········o·al_backup_dirty_bitmap	171	··········o·al_backup_dirty_bitmap
172	··········o·al_backup_dirty_bitmaps	172	··········o·al_backup_dirty_bitmaps
173	These·functions·are·declared·in·the·main·Allegro·header·file:	173	These·functions·are·declared·in·the·main·Allegro·header·file:
174	·#include·<allegro5/allegro.h>	174	·#include·<allegro5/allegro.h>
175	****·Colors·****	175	****·Colors·****
176	***·ALLEGRO_COLOR·***	176	***·ALLEGRO_COLOR·***
177	typedef·struct·ALLEGRO_COLOR·ALLEGRO_COLOR;	177	typedef·struct·ALLEGRO_COLOR·ALLEGRO_COLOR;
178	typedef·struct·ALLEGRO_COLOR·ALLEGRO_COLOR;
179	Source_Code	178	Source_Code
180	An·ALLEGRO_COLOR·structure·describes·a·color·in·a·device·independent·way.·Use	179	An·ALLEGRO_COLOR·structure·describes·a·color·in·a·device·independent·way.·Use
181	al_map_rgb·et·al.Â and·al_unmap_rgb·et·al.Â to·translate·from·and·to·various	180	al_map_rgb·et·al.Â and·al_unmap_rgb·et·al.Â to·translate·from·and·to·various
182	color·representations.	181	color·representations.
183	***·al_map_rgb·***	182	***·al_map_rgb·***
184	ALLEGRO_COLOR·al_map_rgb(	183	ALLEGRO_COLOR·al_map_rgb(
185	···unsigned·char·r,·unsigned·char·g,·unsigned·char·b)	184	···unsigned·char·r,·unsigned·char·g,·unsigned·char·b)
Offset 265, 15 lines modified		Offset 264, 14 lines modified
265	···float·r,·float·g,·float·b,·float·a)	264	···float·r,·float·g,·float·b,·float·a)
266	Source_Code	265	Source_Code
267	Retrieves·components·of·an·ALLEGRO_COLOR.·Components·will·range·from·0.0f-1.0f.	266	Retrieves·components·of·an·ALLEGRO_COLOR.·Components·will·range·from·0.0f-1.0f.
268	See·also:·al_unmap_rgba,·al_unmap_rgb,·al_unmap_rgb_f	267	See·also:·al_unmap_rgba,·al_unmap_rgb,·al_unmap_rgb_f
269	****·Locking·and·pixel·formats·****	268	****·Locking·and·pixel·formats·****
270	***·ALLEGRO_LOCKED_REGION·***	269	***·ALLEGRO_LOCKED_REGION·***
271	typedef·struct·ALLEGRO_LOCKED_REGION·ALLEGRO_LOCKED_REGION;	270	typedef·struct·ALLEGRO_LOCKED_REGION·ALLEGRO_LOCKED_REGION;
272	typedef·struct·ALLEGRO_LOCKED_REGION·ALLEGRO_LOCKED_REGION;
273	Source_Code	271	Source_Code
274	Users·who·wish·to·manually·edit·or·read·from·a·bitmap·are·required·to·lock·it	272	Users·who·wish·to·manually·edit·or·read·from·a·bitmap·are·required·to·lock·it
275	first.·The·ALLEGRO_LOCKED_REGION·structure·represents·the·locked·region·of·the	273	first.·The·ALLEGRO_LOCKED_REGION·structure·represents·the·locked·region·of·the
276	bitmap.·This·call·will·work·with·any·bitmap,·including·memory·bitmaps.	274	bitmap.·This·call·will·work·with·any·bitmap,·including·memory·bitmaps.
277	typedef·struct·ALLEGRO_LOCKED_REGION·{	275	typedef·struct·ALLEGRO_LOCKED_REGION·{
278	···void·*data;	276	···void·*data;
279	···int·format;	277	···int·format;
Offset 294, 15 lines modified		Offset 292, 14 lines modified
294	······historically,·this·used·to·be·true·for·all·formats),·this·is·just·the	292	······historically,·this·used·to·be·true·for·all·formats),·this·is·just·the
295	······size·of·a·single·pixel,·but·for·blocked·pixel·formats·this·value·is	293	······size·of·a·single·pixel,·but·for·blocked·pixel·formats·this·value·is
296	······different.	294	······different.
297	See·also:·al_lock_bitmap,·al_lock_bitmap_region,·al_unlock_bitmap,	295	See·also:·al_lock_bitmap,·al_lock_bitmap_region,·al_unlock_bitmap,
298	ALLEGRO_PIXEL_FORMAT	296	ALLEGRO_PIXEL_FORMAT
299	***·ALLEGRO_PIXEL_FORMAT·***	297	***·ALLEGRO_PIXEL_FORMAT·***
300	typedef·enum·ALLEGRO_PIXEL_FORMAT	298	typedef·enum·ALLEGRO_PIXEL_FORMAT
301	typedef·enum·ALLEGRO_PIXEL_FORMAT
302	Source_Code	299	Source_Code
303	Pixel·formats.·Each·pixel·format·specifies·the·exact·size·and·bit·layout·of·a	300	Pixel·formats.·Each·pixel·format·specifies·the·exact·size·and·bit·layout·of·a
304	pixel·in·memory.·Components·are·specified·from·high·bits·to·low·bits,·so·for	301	pixel·in·memory.·Components·are·specified·from·high·bits·to·low·bits,·so·for
305	example·a·fully·opaque·red·pixel·in·ARGB_8888·format·is·0xFFFF0000.	302	example·a·fully·opaque·red·pixel·in·ARGB_8888·format·is·0xFFFF0000.
306	·····Note:	303	·····Note:
307	·····The·pixel·format·is·independent·of·endianness.·That·is,·in·the·above	304	·····The·pixel·format·is·independent·of·endianness.·That·is,·in·the·above
308	·····example·you·can·always·get·the·red·component·with	305	·····example·you·can·always·get·the·red·component·with
Offset 515, 15 lines modified		Offset 512, 14 lines modified
515	Unlike·al_lock_bitmap_region·the·region·specified·in·terms·of·blocks·and·not	512	Unlike·al_lock_bitmap_region·the·region·specified·in·terms·of·blocks·and·not
516	pixels.	513	pixels.
517	Since:·5.1.9	514	Since:·5.1.9
518	See·also:·al_lock_bitmap_region,·al_lock_bitmap_blocked	515	See·also:·al_lock_bitmap_region,·al_lock_bitmap_blocked
519	****·Bitmap·creation·****	516	****·Bitmap·creation·****
520	***·ALLEGRO_BITMAP·***	517	***·ALLEGRO_BITMAP·***
521	typedef·struct·ALLEGRO_BITMAP·ALLEGRO_BITMAP;	518	typedef·struct·ALLEGRO_BITMAP·ALLEGRO_BITMAP;
522	typedef·struct·ALLEGRO_BITMAP·ALLEGRO_BITMAP;
523	Source_Code	519	Source_Code
524	Abstract·type·representing·a·bitmap·(2D·image).	520	Abstract·type·representing·a·bitmap·(2D·image).
525	***·al_create_bitmap·***	521	***·al_create_bitmap·***
526	ALLEGRO_BITMAP·*al_create_bitmap(int·w,·int·h)	522	ALLEGRO_BITMAP·*al_create_bitmap(int·w,·int·h)
527	Source_Code	523	Source_Code
528	Creates·a·new·bitmap·using·the·bitmap·format·and·flags·for·the·current·thread.	524	Creates·a·new·bitmap·using·the·bitmap·format·and·flags·for·the·current·thread.
529	Blitting·between·bitmaps·of·differing·formats,·or·blitting·between·memory	525	Blitting·between·bitmaps·of·differing·formats,·or·blitting·between·memory
Offset 1650, 15 lines modified		Offset 1646, 14 lines modified
1650	if·the·bitmap·type·cannot·be·determined.	1646	if·the·bitmap·type·cannot·be·determined.
1651	Since:·5.1.12	1647	Since:·5.1.12
1652	See·also:·al_init_image_addon,·al_identify_bitmap,	1648	See·also:·al_init_image_addon,·al_identify_bitmap,
1653	al_register_bitmap_identifier	1649	al_register_bitmap_identifier
1654	****·Render·State·****	1650	****·Render·State·****
1655	***·ALLEGRO_RENDER_STATE·***	1651	***·ALLEGRO_RENDER_STATE·***
1656	typedef·enum·ALLEGRO_RENDER_STATE·{	1652	typedef·enum·ALLEGRO_RENDER_STATE·{
1657	typedef·enum·ALLEGRO_RENDER_STATE·{
1658	Source_Code	1653	Source_Code
1659	Possible·render·states·which·can·be·set·with·al_set_render_state:	1654	Possible·render·states·which·can·be·set·with·al_set_render_state:
1660	··ALLEGRO_ALPHA_TEST	1655	··ALLEGRO_ALPHA_TEST
1661	······If·this·is·set·to·1,·the·values·of·ALLEGRO_ALPHA_FUNCTION·and	1656	······If·this·is·set·to·1,·the·values·of·ALLEGRO_ALPHA_FUNCTION·and
1662	······ALLEGRO_ALPHA_TEST_VALUE·define·a·comparison·function·which·is·performed	1657	······ALLEGRO_ALPHA_TEST_VALUE·define·a·comparison·function·which·is·performed
1663	······on·the·alpha·component·of·each·pixel.·Only·if·it·evaluates·to·true·the	1658	······on·the·alpha·component·of·each·pixel.·Only·if·it·evaluates·to·true·the
1664	······pixel·is·written.·Otherwise·no·subsequent·processing·(like·depth·test·or	1659	······pixel·is·written.·Otherwise·no·subsequent·processing·(like·depth·test·or
Offset 1681, 30 lines modified		Offset 1676, 28 lines modified
1681	··ALLEGRO_DEPTH_FUNCTION	1676	··ALLEGRO_DEPTH_FUNCTION
1682	······One·of·ALLEGRO_RENDER_FUNCTION,·only·used·when·ALLEGRO_DEPTH_TEST·is·1.	1677	······One·of·ALLEGRO_RENDER_FUNCTION,·only·used·when·ALLEGRO_DEPTH_TEST·is·1.
1683	Since:·5.1.2	1678	Since:·5.1.2
1684	See·also:·al_set_render_state,·ALLEGRO_RENDER_FUNCTION,	1679	See·also:·al_set_render_state,·ALLEGRO_RENDER_FUNCTION,
1685	ALLEGRO_WRITE_MASK_FLAGS	1680	ALLEGRO_WRITE_MASK_FLAGS
1686	***·ALLEGRO_RENDER_FUNCTION·***	1681	***·ALLEGRO_RENDER_FUNCTION·***
1687	typedef·enum·ALLEGRO_RENDER_FUNCTION·{	1682	typedef·enum·ALLEGRO_RENDER_FUNCTION·{
1688	typedef·enum·ALLEGRO_RENDER_FUNCTION·{
1689	Source_Code	1683	Source_Code
1690	Possible·functions·are:	1684	Possible·functions·are:
1691	····*·ALLEGRO_RENDER_NEVER	1685	····*·ALLEGRO_RENDER_NEVER
1692	····*·ALLEGRO_RENDER_ALWAYS	1686	····*·ALLEGRO_RENDER_ALWAYS
1693	····*·ALLEGRO_RENDER_LESS	1687	····*·ALLEGRO_RENDER_LESS
1694	····*·ALLEGRO_RENDER_EQUAL	1688	····*·ALLEGRO_RENDER_EQUAL
1695	····*·ALLEGRO_RENDER_LESS_EQUAL	1689	····*·ALLEGRO_RENDER_LESS_EQUAL
1696	····*·ALLEGRO_RENDER_GREATER	1690	····*·ALLEGRO_RENDER_GREATER
1697	····*·ALLEGRO_RENDER_NOT_EQUAL	1691	····*·ALLEGRO_RENDER_NOT_EQUAL
1698	····*·ALLEGRO_RENDER_GREATER_EQUAL	1692	····*·ALLEGRO_RENDER_GREATER_EQUAL
1699	Since:·5.1.2	1693	Since:·5.1.2
1700	See·also:·al_set_render_state	1694	See·also:·al_set_render_state
1701	***·ALLEGRO_WRITE_MASK_FLAGS·***	1695	***·ALLEGRO_WRITE_MASK_FLAGS·***
1702	typedef·enum·ALLEGRO_WRITE_MASK_FLAGS·{	1696	typedef·enum·ALLEGRO_WRITE_MASK_FLAGS·{
1703	typedef·enum·ALLEGRO_WRITE_MASK_FLAGS·{
1704	Source_Code	1697	Source_Code
1705	Each·enabled·bit·means·the·corresponding·value·is·written,·a·disabled·bit·means	1698	Each·enabled·bit·means·the·corresponding·value·is·written,·a·disabled·bit·means
1706	it·is·not.	1699	it·is·not.
1707	····*·ALLEGRO_MASK_RED	1700	····*·ALLEGRO_MASK_RED
1708	····*·ALLEGRO_MASK_GREEN	1701	····*·ALLEGRO_MASK_GREEN
1709	····*·ALLEGRO_MASK_BLUE	1702	····*·ALLEGRO_MASK_BLUE
1710	····*·ALLEGRO_MASK_ALPHA	1703	····*·ALLEGRO_MASK_ALPHA
Offset 1738, 8 lines modified		Offset 1731, 8 lines modified
1738	***·al_backup_dirty_bitmaps·***	1731	***·al_backup_dirty_bitmaps·***
1739	void·al_backup_dirty_bitmaps(ALLEGRO_DISPLAY·*display)	1732	void·al_backup_dirty_bitmaps(ALLEGRO_DISPLAY·*display)
1740	Source_Code	1733	Source_Code
1741	Backs·up·all·of·a·displayâs·bitmaps·to·system·memory.	1734	Backs·up·all·of·a·displayâs·bitmaps·to·system·memory.
1742	Since:·5.2.1	1735	Since:·5.2.1
1743	·····Unstable_API:·This·API·is·new·and·subject·to·refinement.	1736	·····Unstable_API:·This·API·is·new·and·subject·to·refinement.
1744	See·also:·al_backup_dirty_bitmap	1737	See·also:·al_backup_dirty_bitmap
1745	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:08·UTC	1738	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:33·UTC


Offset 200, 26 lines modified		Offset 200, 24 lines modified
200	<li><a·href="#al_rumble_haptic">al_rumble_haptic</a></li>	200	<li><a·href="#al_rumble_haptic">al_rumble_haptic</a></li>
201	</ul>	201	</ul>
202	</nav>	202	</nav>
203	<p>Haptic·functions·support·force·feedback·and·vibration·on·input·devices.·These·functions·are·declared·in·the·main·Allegro·header·file:</p>	203	<p>Haptic·functions·support·force·feedback·and·vibration·on·input·devices.·These·functions·are·declared·in·the·main·Allegro·header·file:</p>
204	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>	204	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>
205	<p>Currently·force·feedback·is·fully·supported·on·Linux·and·on·Windows·for·DirectInput·compatible·devices.·There·is·also·minimal·support·for·Android.·It·is·not·yet·supported·on·OSX,·iOS,·or·on·Windows·for·XInput·compatible·devices.</p>	205	<p>Currently·force·feedback·is·fully·supported·on·Linux·and·on·Windows·for·DirectInput·compatible·devices.·There·is·also·minimal·support·for·Android.·It·is·not·yet·supported·on·OSX,·iOS,·or·on·Windows·for·XInput·compatible·devices.</p>
206	<h1·id="allegro_haptic">ALLEGRO_HAPTIC</h1>	206	<h1·id="allegro_haptic">ALLEGRO_HAPTIC</h1>
207	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_HAPTIC·ALLEGRO_HAPTIC;</span>	207	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_HAPTIC·ALLEGRO_HAPTIC;</span></code></pre></div>
208	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_HAPTIC·ALLEGRO_HAPTIC;</span></code></pre></div>
209	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L64">Source·Code</a></p>	208	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L64">Source·Code</a></p>
210	<p>This·is·an·abstract·data·type·representing·a·haptic·device·that·supports·force·feedback·or·vibration.</p>	209	<p>This·is·an·abstract·data·type·representing·a·haptic·device·that·supports·force·feedback·or·vibration.</p>
211	<p>Since:·5.1.8</p>	210	<p>Since:·5.1.8</p>
212	<blockquote>	211	<blockquote>
213	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>	212	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>
214	</blockquote>	213	</blockquote>
215	<p>See·also:·<a·href="haptic.html#al_get_haptic_from_joystick">al_get_haptic_from_joystick</a></p>	214	<p>See·also:·<a·href="haptic.html#al_get_haptic_from_joystick">al_get_haptic_from_joystick</a></p>
216	<h1·id="allegro_haptic_constants">ALLEGRO_HAPTIC_CONSTANTS</h1>	215	<h1·id="allegro_haptic_constants">ALLEGRO_HAPTIC_CONSTANTS</h1>
217	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="kw">enum</span>·ALLEGRO_HAPTIC_CONSTANTS</span>	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"></a><span·class="kw">enum</span>·ALLEGRO_HAPTIC_CONSTANTS</span></code></pre></div>
218	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a><span·class="kw">enum</span>·ALLEGRO_HAPTIC_CONSTANTS</span></code></pre></div>
219	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L37">Source·Code</a></p>	217	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L37">Source·Code</a></p>
220	<p>This·enum·contains·flags·that·are·used·to·define·haptic·effects·and·capabilities.·If·the·flag·is·set·in·the·return·value·of·<a·href="haptic.html#al_get_haptic_capabilities">al_get_haptic_capabilities</a>,·it·means·the·device·supports·the·given·effect.·The·value·of·these·flags·should·be·set·into·a·<a·href="haptic.html#allegro_haptic_effect">ALLEGRO_HAPTIC_EFFECT</a>·struct·to·determine·what·kind·of·haptic·effect·should·be·played.</p>	218	<p>This·enum·contains·flags·that·are·used·to·define·haptic·effects·and·capabilities.·If·the·flag·is·set·in·the·return·value·of·<a·href="haptic.html#al_get_haptic_capabilities">al_get_haptic_capabilities</a>,·it·means·the·device·supports·the·given·effect.·The·value·of·these·flags·should·be·set·into·a·<a·href="haptic.html#allegro_haptic_effect">ALLEGRO_HAPTIC_EFFECT</a>·struct·to·determine·what·kind·of·haptic·effect·should·be·played.</p>
221	<ul>	219	<ul>
222	<li>ALLEGRO_HAPTIC_RUMBLE·-·simple·vibration·effects</li>	220	<li>ALLEGRO_HAPTIC_RUMBLE·-·simple·vibration·effects</li>
223	<li>ALLEGRO_HAPTIC_PERIODIC·-·periodic,·wave-form·effects</li>	221	<li>ALLEGRO_HAPTIC_PERIODIC·-·periodic,·wave-form·effects</li>
224	<li>ALLEGRO_HAPTIC_CONSTANT·-·constant·effects</li>	222	<li>ALLEGRO_HAPTIC_CONSTANT·-·constant·effects</li>
225	<li>ALLEGRO_HAPTIC_SPRING·-·spring·effects</li>	223	<li>ALLEGRO_HAPTIC_SPRING·-·spring·effects</li>
Offset 241, 16 lines modified		Offset 239, 15 lines modified
241	</ul>	239	</ul>
242	<p>Since:·5.1.8</p>	240	<p>Since:·5.1.8</p>
243	<blockquote>	241	<blockquote>
244	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>	242	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>
245	</blockquote>	243	</blockquote>
246	<p>See·also:·<a·href="haptic.html#al_get_haptic_capabilities">al_get_haptic_capabilities</a>,·<a·href="haptic.html#allegro_haptic_effect">ALLEGRO_HAPTIC_EFFECT</a></p>	244	<p>See·also:·<a·href="haptic.html#al_get_haptic_capabilities">al_get_haptic_capabilities</a>,·<a·href="haptic.html#allegro_haptic_effect">ALLEGRO_HAPTIC_EFFECT</a></p>
247	<h1·id="allegro_haptic_effect">ALLEGRO_HAPTIC_EFFECT</h1>	245	<h1·id="allegro_haptic_effect">ALLEGRO_HAPTIC_EFFECT</h1>
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"></a><span·class="kw">struct</span>·ALLEGRO_HAPTIC_EFFECT</span>	246	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="kw">struct</span>·ALLEGRO_HAPTIC_EFFECT</span></code></pre></div>
249	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a><span·class="kw">struct</span>·ALLEGRO_HAPTIC_EFFECT</span></code></pre></div>
250	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L169">Source·Code</a></p>	247	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L169">Source·Code</a></p>
251	<p>This·struct·models·a·particular·haptic·or·vibration·effect.·It·needs·to·be·filled·in·correctly·and·uploaded·to·a·haptic·device·before·the·device·can·play·it·back.</p>	248	<p>This·struct·models·a·particular·haptic·or·vibration·effect.·It·needs·to·be·filled·in·correctly·and·uploaded·to·a·haptic·device·before·the·device·can·play·it·back.</p>
252	<p><em>Fields:</em></p>	249	<p><em>Fields:</em></p>
253	<dl>	250	<dl>
254	<dt>type</dt>	251	<dt>type</dt>
255	<dd><p>The·type·of·the·haptic·effect.·May·be·one·of·the·ALLEGRO_HAPTIC_CONSTANTS·constants·between·or·equal·to·ALLEGRO_HAPTIC_RUMBLE·and·ALLEGRO_HAPTIC_RAMP.</p>	252	<dd><p>The·type·of·the·haptic·effect.·May·be·one·of·the·ALLEGRO_HAPTIC_CONSTANTS·constants·between·or·equal·to·ALLEGRO_HAPTIC_RUMBLE·and·ALLEGRO_HAPTIC_RAMP.</p>
256	<ul>	253	<ul>
Offset 296, 16 lines modified		Offset 293, 15 lines modified
296	</dd>	293	</dd>
297	</dl>	294	</dl>
298	<p>Since:·5.1.8</p>	295	<p>Since:·5.1.8</p>
299	<blockquote>	296	<blockquote>
300	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>	297	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>
301	</blockquote>	298	</blockquote>
302	<h1·id="allegro_haptic_effect_id">ALLEGRO_HAPTIC_EFFECT_ID</h1>	299	<h1·id="allegro_haptic_effect_id">ALLEGRO_HAPTIC_EFFECT_ID</h1>
303	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID;</span>	300	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID;</span></code></pre></div>
304	<span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID;</span></code></pre></div>
305	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L183">Source·Code</a></p>	301	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/haptic.h#L183">Source·Code</a></p>
306	<p>This·struct·is·used·as·a·handle·to·control·playback·of·a·haptic·effect·and·should·be·considered·opaque.·Its·implementation·is·visible·merely·to·allow·allocation·by·the·users·of·the·Allegro·library.</p>	302	<p>This·struct·is·used·as·a·handle·to·control·playback·of·a·haptic·effect·and·should·be·considered·opaque.·Its·implementation·is·visible·merely·to·allow·allocation·by·the·users·of·the·Allegro·library.</p>
307	<p>Since:·5.1.8</p>	303	<p>Since:·5.1.8</p>
308	<blockquote>	304	<blockquote>
309	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>	305	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>
310	</blockquote>	306	</blockquote>
311	<h1·id="al_install_haptic">al_install_haptic</h1>	307	<h1·id="al_install_haptic">al_install_haptic</h1>
Offset 572, 12 lines modified		Offset 568, 12 lines modified
572	<p>In·case·false·is·returned,·the·rumble·effect·will·be·automatically·released·as·if·<a·href="haptic.html#al_release_haptic_effect">al_release_haptic_effect</a>·had·been·called,·so·there·is·no·need·to·call·it·again·manually·in·this·case.·However,·if·true·is·returned,·it·is·necessary·to·call·<a·href="haptic.html#al_release_haptic_effect">al_release_haptic_effect</a>·when·the·effect·isn’t·needed·anymore,·to·prevent·the·amount·of·available·effects·on·the·haptic·device·from·running·out.</p>	568	<p>In·case·false·is·returned,·the·rumble·effect·will·be·automatically·released·as·if·<a·href="haptic.html#al_release_haptic_effect">al_release_haptic_effect</a>·had·been·called,·so·there·is·no·need·to·call·it·again·manually·in·this·case.·However,·if·true·is·returned,·it·is·necessary·to·call·<a·href="haptic.html#al_release_haptic_effect">al_release_haptic_effect</a>·when·the·effect·isn’t·needed·anymore,·to·prevent·the·amount·of·available·effects·on·the·haptic·device·from·running·out.</p>
573	<p>Since:·5.1.8</p>	569	<p>Since:·5.1.8</p>
574	<blockquote>	570	<blockquote>
575	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>	571	<p><em><a·href="getting_started.html#unstable-api">Unstable·API</a>:</em>·Perhaps·could·be·simplified·due·to·limited·support·for·all·the·exposed·features·across·all·of·the·platforms.·Awaiting·feedback·from·users.</p>
576	</blockquote>	572	</blockquote>
577	<p·class="timestamp">	573	<p·class="timestamp">
578	Allegro·version·5.2.6	574	Allegro·version·5.2.6
579	·-·Last·updated:·2025-02-07·20:10:10·UTC	575	·-·Last·updated:·2024-01-06·13:49:33·UTC
580	</p>	576	</p>
581	</div>	577	</div>
582	</body>	578	</body>
583	</html>	579	</html>


Offset 86, 26 lines modified		Offset 86, 24 lines modified
86	functions·are·declared·in·the·main·Allegro·header·file:	86	functions·are·declared·in·the·main·Allegro·header·file:
87	·#include·<allegro5/allegro.h>	87	·#include·<allegro5/allegro.h>
88	Currently·force·feedback·is·fully·supported·on·Linux·and·on·Windows·for	88	Currently·force·feedback·is·fully·supported·on·Linux·and·on·Windows·for
89	DirectInput·compatible·devices.·There·is·also·minimal·support·for·Android.·It	89	DirectInput·compatible·devices.·There·is·also·minimal·support·for·Android.·It
90	is·not·yet·supported·on·OSX,·iOS,·or·on·Windows·for·XInput·compatible·devices.	90	is·not·yet·supported·on·OSX,·iOS,·or·on·Windows·for·XInput·compatible·devices.
91	****·ALLEGRO_HAPTIC·****	91	****·ALLEGRO_HAPTIC·****
92	typedef·struct·ALLEGRO_HAPTIC·ALLEGRO_HAPTIC;	92	typedef·struct·ALLEGRO_HAPTIC·ALLEGRO_HAPTIC;
93	typedef·struct·ALLEGRO_HAPTIC·ALLEGRO_HAPTIC;
94	Source_Code	93	Source_Code
95	This·is·an·abstract·data·type·representing·a·haptic·device·that·supports·force	94	This·is·an·abstract·data·type·representing·a·haptic·device·that·supports·force
96	feedback·or·vibration.	95	feedback·or·vibration.
97	Since:·5.1.8	96	Since:·5.1.8
98	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for	97	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for
99	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting	98	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
100	·····feedback·from·users.	99	·····feedback·from·users.
101	See·also:·al_get_haptic_from_joystick	100	See·also:·al_get_haptic_from_joystick
102	****·ALLEGRO_HAPTIC_CONSTANTS·****	101	****·ALLEGRO_HAPTIC_CONSTANTS·****
103	enum·ALLEGRO_HAPTIC_CONSTANTS	102	enum·ALLEGRO_HAPTIC_CONSTANTS
104	enum·ALLEGRO_HAPTIC_CONSTANTS
105	Source_Code	103	Source_Code
106	This·enum·contains·flags·that·are·used·to·define·haptic·effects·and	104	This·enum·contains·flags·that·are·used·to·define·haptic·effects·and
107	capabilities.·If·the·flag·is·set·in·the·return·value·of	105	capabilities.·If·the·flag·is·set·in·the·return·value·of
108	al_get_haptic_capabilities,·it·means·the·device·supports·the·given·effect.·The	106	al_get_haptic_capabilities,·it·means·the·device·supports·the·given·effect.·The
109	value·of·these·flags·should·be·set·into·a·ALLEGRO_HAPTIC_EFFECT·struct·to	107	value·of·these·flags·should·be·set·into·a·ALLEGRO_HAPTIC_EFFECT·struct·to
110	determine·what·kind·of·haptic·effect·should·be·played.	108	determine·what·kind·of·haptic·effect·should·be·played.
111	····*·ALLEGRO_HAPTIC_RUMBLE·-·simple·vibration·effects	109	····*·ALLEGRO_HAPTIC_RUMBLE·-·simple·vibration·effects
Offset 130, 15 lines modified		Offset 128, 14 lines modified
130	Since:·5.1.8	128	Since:·5.1.8
131	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for	129	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for
132	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting	130	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
133	·····feedback·from·users.	131	·····feedback·from·users.
134	See·also:·al_get_haptic_capabilities,·ALLEGRO_HAPTIC_EFFECT	132	See·also:·al_get_haptic_capabilities,·ALLEGRO_HAPTIC_EFFECT
135	****·ALLEGRO_HAPTIC_EFFECT·****	133	****·ALLEGRO_HAPTIC_EFFECT·****
136	struct·ALLEGRO_HAPTIC_EFFECT	134	struct·ALLEGRO_HAPTIC_EFFECT
137	struct·ALLEGRO_HAPTIC_EFFECT
138	Source_Code	135	Source_Code
139	This·struct·models·a·particular·haptic·or·vibration·effect.·It·needs·to·be	136	This·struct·models·a·particular·haptic·or·vibration·effect.·It·needs·to·be
140	filled·in·correctly·and·uploaded·to·a·haptic·device·before·the·device·can·play	137	filled·in·correctly·and·uploaded·to·a·haptic·device·before·the·device·can·play
141	it·back.	138	it·back.
142	Fields:	139	Fields:
143	··type	140	··type
144	······The·type·of·the·haptic·effect.·May·be·one·of·the·ALLEGRO_HAPTIC_CONSTANTS	141	······The·type·of·the·haptic·effect.·May·be·one·of·the·ALLEGRO_HAPTIC_CONSTANTS
Offset 294, 15 lines modified		Offset 291, 14 lines modified
294	······throughout·its·playback.	291	······throughout·its·playback.
295	Since:·5.1.8	292	Since:·5.1.8
296	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for	293	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for
297	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting	294	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
298	·····feedback·from·users.	295	·····feedback·from·users.
299	****·ALLEGRO_HAPTIC_EFFECT_ID·****	296	****·ALLEGRO_HAPTIC_EFFECT_ID·****
300	typedef·struct·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID;	297	typedef·struct·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID;
301	typedef·struct·ALLEGRO_HAPTIC_EFFECT_ID·ALLEGRO_HAPTIC_EFFECT_ID;
302	Source_Code	298	Source_Code
303	This·struct·is·used·as·a·handle·to·control·playback·of·a·haptic·effect·and	299	This·struct·is·used·as·a·handle·to·control·playback·of·a·haptic·effect·and
304	should·be·considered·opaque.·Its·implementation·is·visible·merely·to·allow	300	should·be·considered·opaque.·Its·implementation·is·visible·merely·to·allow
305	allocation·by·the·users·of·the·Allegro·library.	301	allocation·by·the·users·of·the·Allegro·library.
306	Since:·5.1.8	302	Since:·5.1.8
307	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for	303	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for
308	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting	304	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
Offset 674, 8 lines modified		Offset 670, 8 lines modified
674	again·manually·in·this·case.·However,·if·true·is·returned,·it·is·necessary·to	670	again·manually·in·this·case.·However,·if·true·is·returned,·it·is·necessary·to
675	call·al_release_haptic_effect·when·the·effect·isnât·needed·anymore,·to	671	call·al_release_haptic_effect·when·the·effect·isnât·needed·anymore,·to
676	prevent·the·amount·of·available·effects·on·the·haptic·device·from·running·out.	672	prevent·the·amount·of·available·effects·on·the·haptic·device·from·running·out.
677	Since:·5.1.8	673	Since:·5.1.8
678	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for	674	·····Unstable_API:·Perhaps·could·be·simplified·due·to·limited·support·for
679	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting	675	·····all·the·exposed·features·across·all·of·the·platforms.·Awaiting
680	·····feedback·from·users.	676	·····feedback·from·users.
681	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:10·UTC	677	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:33·UTC


Offset 169, 37 lines modified		Offset 169, 33 lines modified
169	<li><a·href="#al_get_allegro_image_version">al_get_allegro_image_version</a></li>	169	<li><a·href="#al_get_allegro_image_version">al_get_allegro_image_version</a></li>
170	</ul>	170	</ul>
171	</nav>	171	</nav>
172	<p>These·functions·are·declared·in·the·following·header·file.·Link·with·allegro_image.</p>	172	<p>These·functions·are·declared·in·the·following·header·file.·Link·with·allegro_image.</p>
173	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro_image.h></span></span></code></pre></div>	173	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro_image.h></span></span></code></pre></div>
174	<p>Some·of·the·format·handlers·define·configuration·options·for·specifying·things·like·compression·level·or·gamma·handling.·Refer·to·<a·href="system.html#al_get_system_config">al_get_system_config</a>·for·their·documentation.</p>	174	<p>Some·of·the·format·handlers·define·configuration·options·for·specifying·things·like·compression·level·or·gamma·handling.·Refer·to·<a·href="system.html#al_get_system_config">al_get_system_config</a>·for·their·documentation.</p>
175	<h1·id="al_init_image_addon">al_init_image_addon</h1>	175	<h1·id="al_init_image_addon">al_init_image_addon</h1>
176	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_init_image_addon(<span·class="dt">void</span>)</span>	176	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_init_image_addon(<span·class="dt">void</span>)</span></code></pre></div>
177	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="dt">bool</span>·al_init_image_addon(<span·class="dt">void</span>)</span></code></pre></div>
178	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L14">Source·Code</a></p>	177	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L14">Source·Code</a></p>
179	<p>Initializes·the·image·addon.·This·registers·bitmap·format·handlers·for·<a·href="graphics.html#al_load_bitmap">al_load_bitmap</a>,·<a·href="graphics.html#al_load_bitmap_f">al_load_bitmap_f</a>,·<a·href="graphics.html#al_save_bitmap">al_save_bitmap</a>,·<a·href="graphics.html#al_save_bitmap_f">al_save_bitmap_f</a>.</p>	178	<p>Initializes·the·image·addon.·This·registers·bitmap·format·handlers·for·<a·href="graphics.html#al_load_bitmap">al_load_bitmap</a>,·<a·href="graphics.html#al_load_bitmap_f">al_load_bitmap_f</a>,·<a·href="graphics.html#al_save_bitmap">al_save_bitmap</a>,·<a·href="graphics.html#al_save_bitmap_f">al_save_bitmap_f</a>.</p>
180	<p>The·following·types·are·built·into·the·Allegro·image·addon·and·guaranteed·to·be·available:·BMP,·DDS,·PCX,·TGA.·Every·platform·also·supports·JPEG·and·PNG·via·external·dependencies.</p>	179	<p>The·following·types·are·built·into·the·Allegro·image·addon·and·guaranteed·to·be·available:·BMP,·DDS,·PCX,·TGA.·Every·platform·also·supports·JPEG·and·PNG·via·external·dependencies.</p>
181	<p>Other·formats·may·be·available·depending·on·the·operating·system·and·installed·libraries,·but·are·not·guaranteed·and·should·not·be·assumed·to·be·universally·available.</p>	180	<p>Other·formats·may·be·available·depending·on·the·operating·system·and·installed·libraries,·but·are·not·guaranteed·and·should·not·be·assumed·to·be·universally·available.</p>
182	<p>The·DDS·format·is·only·supported·to·load·from,·and·only·if·the·DDS·file·contains·textures·compressed·in·the·DXT1,·DXT3·and·DXT5·formats.·Note·that·when·loading·a·DDS·file,·the·created·bitmap·will·always·be·a·video·bitmap·and·will·have·the·pixel·format·matching·the·format·in·the·file.</p>	181	<p>The·DDS·format·is·only·supported·to·load·from,·and·only·if·the·DDS·file·contains·textures·compressed·in·the·DXT1,·DXT3·and·DXT5·formats.·Note·that·when·loading·a·DDS·file,·the·created·bitmap·will·always·be·a·video·bitmap·and·will·have·the·pixel·format·matching·the·format·in·the·file.</p>
183	<h1·id="al_is_image_addon_initialized">al_is_image_addon_initialized</h1>	182	<h1·id="al_is_image_addon_initialized">al_is_image_addon_initialized</h1>
184	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_is_image_addon_initialized(<span·class="dt">void</span>)</span>	183	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="dt">bool</span>·al_is_image_addon_initialized(<span·class="dt">void</span>)</span></code></pre></div>
185	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a><span·class="dt">bool</span>·al_is_image_addon_initialized(<span·class="dt">void</span>)</span></code></pre></div>
186	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L169">Source·Code</a></p>	184	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L169">Source·Code</a></p>
187	<p>Returns·true·if·the·image·addon·is·initialized,·otherwise·returns·false.</p>	185	<p>Returns·true·if·the·image·addon·is·initialized,·otherwise·returns·false.</p>
188	<p>Since:·5.2.6</p>	186	<p>Since:·5.2.6</p>
189	<h1·id="al_shutdown_image_addon">al_shutdown_image_addon</h1>	187	<h1·id="al_shutdown_image_addon">al_shutdown_image_addon</h1>
190	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_shutdown_image_addon(<span·class="dt">void</span>)</span>	188	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="dt">void</span>·al_shutdown_image_addon(<span·class="dt">void</span>)</span></code></pre></div>
191	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a><span·class="dt">void</span>·al_shutdown_image_addon(<span·class="dt">void</span>)</span></code></pre></div>
192	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L177">Source·Code</a></p>	189	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L177">Source·Code</a></p>
193	<p>Shut·down·the·image·addon.·This·is·done·automatically·at·program·exit,·but·can·be·called·any·time·the·user·wishes·as·well.</p>	190	<p>Shut·down·the·image·addon.·This·is·done·automatically·at·program·exit,·but·can·be·called·any·time·the·user·wishes·as·well.</p>
194	<h1·id="al_get_allegro_image_version">al_get_allegro_image_version</h1>	191	<h1·id="al_get_allegro_image_version">al_get_allegro_image_version</h1>
195	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="dt">uint32_t</span>·al_get_allegro_image_version(<span·class="dt">void</span>)</span>	192	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="dt">uint32_t</span>·al_get_allegro_image_version(<span·class="dt">void</span>)</span></code></pre></div>
196	<span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"></a><span·class="dt">uint32_t</span>·al_get_allegro_image_version(<span·class="dt">void</span>)</span></code></pre></div>
197	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L185">Source·Code</a></p>	193	<p><a·href="https://github.com/liballeg/allegro5/blob/master/addons/image/iio.c#L185">Source·Code</a></p>
198	<p>Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as·<a·href="system.html#al_get_allegro_version">al_get_allegro_version</a>.</p>	194	<p>Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as·<a·href="system.html#al_get_allegro_version">al_get_allegro_version</a>.</p>
199	<p·class="timestamp">	195	<p·class="timestamp">
200	Allegro·version·5.2.6	196	Allegro·version·5.2.6
201	·-·Last·updated:·2025-02-07·20:10:13·UTC	197	·-·Last·updated:·2024-01-06·13:49:38·UTC
202	</p>	198	</p>
203	</div>	199	</div>
204	</body>	200	</body>
205	</html>	201	</html>


Offset 55, 15 lines modified		Offset 55, 14 lines modified
55	allegro_image.	55	allegro_image.
56	·#include·<allegro5/allegro_image.h>	56	·#include·<allegro5/allegro_image.h>
57	Some·of·the·format·handlers·define·configuration·options·for·specifying·things	57	Some·of·the·format·handlers·define·configuration·options·for·specifying·things
58	like·compression·level·or·gamma·handling.·Refer·to·al_get_system_config·for	58	like·compression·level·or·gamma·handling.·Refer·to·al_get_system_config·for
59	their·documentation.	59	their·documentation.
60	****·al_init_image_addon·****	60	****·al_init_image_addon·****
61	bool·al_init_image_addon(void)	61	bool·al_init_image_addon(void)
62	bool·al_init_image_addon(void)
63	Source_Code	62	Source_Code
64	Initializes·the·image·addon.·This·registers·bitmap·format·handlers·for	63	Initializes·the·image·addon.·This·registers·bitmap·format·handlers·for
65	al_load_bitmap,·al_load_bitmap_f,·al_save_bitmap,·al_save_bitmap_f.	64	al_load_bitmap,·al_load_bitmap_f,·al_save_bitmap,·al_save_bitmap_f.
66	The·following·types·are·built·into·the·Allegro·image·addon·and·guaranteed·to·be	65	The·following·types·are·built·into·the·Allegro·image·addon·and·guaranteed·to·be
67	available:·BMP,·DDS,·PCX,·TGA.·Every·platform·also·supports·JPEG·and·PNG·via	66	available:·BMP,·DDS,·PCX,·TGA.·Every·platform·also·supports·JPEG·and·PNG·via
68	external·dependencies.	67	external·dependencies.
69	Other·formats·may·be·available·depending·on·the·operating·system·and·installed	68	Other·formats·may·be·available·depending·on·the·operating·system·and·installed
Offset 71, 24 lines modified		Offset 70, 21 lines modified
71	available.	70	available.
72	The·DDS·format·is·only·supported·to·load·from,·and·only·if·the·DDS·file	71	The·DDS·format·is·only·supported·to·load·from,·and·only·if·the·DDS·file
73	contains·textures·compressed·in·the·DXT1,·DXT3·and·DXT5·formats.·Note·that·when	72	contains·textures·compressed·in·the·DXT1,·DXT3·and·DXT5·formats.·Note·that·when
74	loading·a·DDS·file,·the·created·bitmap·will·always·be·a·video·bitmap·and·will	73	loading·a·DDS·file,·the·created·bitmap·will·always·be·a·video·bitmap·and·will
75	have·the·pixel·format·matching·the·format·in·the·file.	74	have·the·pixel·format·matching·the·format·in·the·file.
76	****·al_is_image_addon_initialized·****	75	****·al_is_image_addon_initialized·****
77	bool·al_is_image_addon_initialized(void)	76	bool·al_is_image_addon_initialized(void)
78	bool·al_is_image_addon_initialized(void)
79	Source_Code	77	Source_Code
80	Returns·true·if·the·image·addon·is·initialized,·otherwise·returns·false.	78	Returns·true·if·the·image·addon·is·initialized,·otherwise·returns·false.
81	Since:·5.2.6	79	Since:·5.2.6
82	****·al_shutdown_image_addon·****	80	****·al_shutdown_image_addon·****
83	void·al_shutdown_image_addon(void)	81	void·al_shutdown_image_addon(void)
84	void·al_shutdown_image_addon(void)
85	Source_Code	82	Source_Code
86	Shut·down·the·image·addon.·This·is·done·automatically·at·program·exit,·but·can	83	Shut·down·the·image·addon.·This·is·done·automatically·at·program·exit,·but·can
87	be·called·any·time·the·user·wishes·as·well.	84	be·called·any·time·the·user·wishes·as·well.
88	****·al_get_allegro_image_version·****	85	****·al_get_allegro_image_version·****
89	uint32_t·al_get_allegro_image_version(void)	86	uint32_t·al_get_allegro_image_version(void)
90	uint32_t·al_get_allegro_image_version(void)
91	Source_Code	87	Source_Code
92	Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as	88	Returns·the·(compiled)·version·of·the·addon,·in·the·same·format·as
93	al_get_allegro_version.	89	al_get_allegro_version.
94	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:13·UTC	90	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:38·UTC


Offset 154, 12 lines modified		Offset 154, 12 lines modified
154	<li><a·href="native_dialog.html">Native·dialogs·addon</a></li>	154	<li><a·href="native_dialog.html">Native·dialogs·addon</a></li>
155	<li><a·href="physfs.html">PhysicsFS·addon</a></li>	155	<li><a·href="physfs.html">PhysicsFS·addon</a></li>
156	<li><a·href="primitives.html">Primitives·addon</a></li>	156	<li><a·href="primitives.html">Primitives·addon</a></li>
157	<li><a·href="video.html">Video·streaming·addon</a></li>	157	<li><a·href="video.html">Video·streaming·addon</a></li>
158	</ul>	158	</ul>
159	<p·class="timestamp">	159	<p·class="timestamp">
160	Allegro·version·5.2.6	160	Allegro·version·5.2.6
161	·-·Last·updated:·2025-02-07·20:10:13·UTC	161	·-·Last·updated:·2024-01-06·13:49:38·UTC
162	</p>	162	</p>
163	</div>	163	</div>
164	</body>	164	</body>
165	</html>	165	</html>


Offset 88, 8 lines modified		Offset 88, 8 lines modified
88	····*·Image_I/O_addon	88	····*·Image_I/O_addon
89	····*·Main_addon	89	····*·Main_addon
90	····*·Memfile_addon	90	····*·Memfile_addon
91	····*·Native_dialogs_addon	91	····*·Native_dialogs_addon
92	····*·PhysicsFS_addon	92	····*·PhysicsFS_addon
93	····*·Primitives_addon	93	····*·Primitives_addon
94	····*·Video_streaming_addon	94	····*·Video_streaming_addon
95	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:13·UTC	95	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:38·UTC


Offset 1287, 12 lines modified		Offset 1287, 12 lines modified
1287	<li><a·href="platform.html#al_win_add_window_callback">al_win_add_window_callback</a>·<!--·--></li>	1287	<li><a·href="platform.html#al_win_add_window_callback">al_win_add_window_callback</a>·<!--·--></li>
1288	<li><a·href="platform.html#al_win_remove_window_callback">al_win_remove_window_callback</a>·<!--·--></li>	1288	<li><a·href="platform.html#al_win_remove_window_callback">al_win_remove_window_callback</a>·<!--·--></li>
1289	<li><a·href="platform.html#al_x_set_initial_icon">al_x_set_initial_icon</a>·<!--·--></li>	1289	<li><a·href="platform.html#al_x_set_initial_icon">al_x_set_initial_icon</a>·<!--·--></li>
1290	<li><a·href="platform.html#iphone">iPhone</a>·<!--·--></li>	1290	<li><a·href="platform.html#iphone">iPhone</a>·<!--·--></li>
1291	</ul>	1291	</ul>
1292	<p·class="timestamp">	1292	<p·class="timestamp">
1293	Allegro·version·5.2.6	1293	Allegro·version·5.2.6
1294	·-·Last·updated:·2025-02-07·20:10:13·UTC	1294	·-·Last·updated:·2024-01-06·13:49:38·UTC
1295	</p>	1295	</p>
1296	</div>	1296	</div>
1297	</body>	1297	</body>
1298	</html>	1298	</html>


Offset 1230, 8 lines modified		Offset 1230, 8 lines modified
1230	····*·al_wait_for_event_timed	1230	····*·al_wait_for_event_timed
1231	····*·al_wait_for_event_until	1231	····*·al_wait_for_event_until
1232	····*·al_wait_for_vsync	1232	····*·al_wait_for_vsync
1233	····*·al_win_add_window_callback	1233	····*·al_win_add_window_callback
1234	····*·al_win_remove_window_callback	1234	····*·al_win_remove_window_callback
1235	····*·al_x_set_initial_icon	1235	····*·al_x_set_initial_icon
1236	····*·iPhone	1236	····*·iPhone
1237	Allegro·version·5.2.6·-·Last·updated:·2025-02-07·20:10:13·UTC	1237	Allegro·version·5.2.6·-·Last·updated:·2024-01-06·13:49:38·UTC


Offset 186, 32 lines modified		Offset 186, 29 lines modified
186	<li><a·href="#al_get_joystick_event_source">al_get_joystick_event_source</a></li>	186	<li><a·href="#al_get_joystick_event_source">al_get_joystick_event_source</a></li>
187	</ul>	187	</ul>
188	</nav>	188	</nav>
189	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>	189	<p>These·functions·are·declared·in·the·main·Allegro·header·file:</p>
190	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>	190	<div·class="sourceCode"·id="cb1"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb1-1"><a·href="#cb1-1"·aria-hidden="true"></a>·<span·class="pp">#include·</span><span·class="im"><allegro5/allegro.h></span></span></code></pre></div>
191	<p>On·Windows·there·are·two·joystick·drivers,·a·DirectInput·one·and·an·Xinput·one.·If·support·for·XInput·was·compiled·in,·then·it·can·be·enabled·by·calling·al_set_config_value(al_get_system_config(),·“joystick”,·“driver”,·“xinput”)·before·calling·al_install_joystick,·or·by·setting·the·same·option·in·the·allegro5.cfg·configuration·file.·The·Xinput·and·DirectInput·drivers·are·mutually·exclusive.·The·haptics·subsystem·will·use·the·same·driver·as·the·joystick·system·does.</p>	191	<p>On·Windows·there·are·two·joystick·drivers,·a·DirectInput·one·and·an·Xinput·one.·If·support·for·XInput·was·compiled·in,·then·it·can·be·enabled·by·calling·al_set_config_value(al_get_system_config(),·“joystick”,·“driver”,·“xinput”)·before·calling·al_install_joystick,·or·by·setting·the·same·option·in·the·allegro5.cfg·configuration·file.·The·Xinput·and·DirectInput·drivers·are·mutually·exclusive.·The·haptics·subsystem·will·use·the·same·driver·as·the·joystick·system·does.</p>
192	<h1·id="allegro_joystick">ALLEGRO_JOYSTICK</h1>	192	<h1·id="allegro_joystick">ALLEGRO_JOYSTICK</h1>
193	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK·ALLEGRO_JOYSTICK;</span>	193	<div·class="sourceCode"·id="cb2"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb2-1"><a·href="#cb2-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK·ALLEGRO_JOYSTICK;</span></code></pre></div>
194	<span·id="cb2-2"><a·href="#cb2-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK·ALLEGRO_JOYSTICK;</span></code></pre></div>
195	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L35">Source·Code</a></p>	194	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L35">Source·Code</a></p>
196	<p>This·is·an·abstract·data·type·representing·a·physical·joystick.</p>	195	<p>This·is·an·abstract·data·type·representing·a·physical·joystick.</p>
197	<p>See·also:·<a·href="joystick.html#al_get_joystick">al_get_joystick</a></p>	196	<p>See·also:·<a·href="joystick.html#al_get_joystick">al_get_joystick</a></p>
198	<h1·id="allegro_joystick_state">ALLEGRO_JOYSTICK_STATE</h1>	197	<h1·id="allegro_joystick_state">ALLEGRO_JOYSTICK_STATE</h1>
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"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK_STATE·ALLEGRO_JOYSTICK_STATE;</span>	198	<div·class="sourceCode"·id="cb3"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb3-1"><a·href="#cb3-1"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK_STATE·ALLEGRO_JOYSTICK_STATE;</span></code></pre></div>
200	<span·id="cb3-2"><a·href="#cb3-2"·aria-hidden="true"></a><span·class="kw">typedef</span>·<span·class="kw">struct</span>·ALLEGRO_JOYSTICK_STATE·ALLEGRO_JOYSTICK_STATE;</span></code></pre></div>
201	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L41">Source·Code</a></p>	199	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L41">Source·Code</a></p>
202	<p>This·is·a·structure·that·is·used·to·hold·a·“snapshot”·of·a·joystick’s·axes·and·buttons·at·a·particular·instant.·All·fields·public·and·read-only.</p>	200	<p>This·is·a·structure·that·is·used·to·hold·a·“snapshot”·of·a·joystick’s·axes·and·buttons·at·a·particular·instant.·All·fields·public·and·read-only.</p>
203	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="kw">struct</span>·{</span>	201	<div·class="sourceCode"·id="cb4"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb4-1"><a·href="#cb4-1"·aria-hidden="true"></a><span·class="kw">struct</span>·{</span>
204	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a>···<span·class="dt">float</span>·axis[num_axes];·············<span·class="co">//·-1.0·to·1.0</span></span>	202	<span·id="cb4-2"><a·href="#cb4-2"·aria-hidden="true"></a>···<span·class="dt">float</span>·axis[num_axes];·············<span·class="co">//·-1.0·to·1.0</span></span>
205	<span·id="cb4-3"><a·href="#cb4-3"·aria-hidden="true"></a>}·stick[num_sticks];</span>	203	<span·id="cb4-3"><a·href="#cb4-3"·aria-hidden="true"></a>}·stick[num_sticks];</span>
206	<span·id="cb4-4"><a·href="#cb4-4"·aria-hidden="true"></a><span·class="dt">int</span>·button[num_buttons];·············<span·class="co">//·0·to·32767</span></span></code></pre></div>	204	<span·id="cb4-4"><a·href="#cb4-4"·aria-hidden="true"></a><span·class="dt">int</span>·button[num_buttons];·············<span·class="co">//·0·to·32767</span></span></code></pre></div>
207	<p>See·also:·<a·href="joystick.html#al_get_joystick_state">al_get_joystick_state</a></p>	205	<p>See·also:·<a·href="joystick.html#al_get_joystick_state">al_get_joystick_state</a></p>
208	<h1·id="allegro_joyflags">ALLEGRO_JOYFLAGS</h1>	206	<h1·id="allegro_joyflags">ALLEGRO_JOYFLAGS</h1>
209	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="kw">enum</span>·ALLEGRO_JOYFLAGS</span>	207	<div·class="sourceCode"·id="cb5"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb5-1"><a·href="#cb5-1"·aria-hidden="true"></a><span·class="kw">enum</span>·ALLEGRO_JOYFLAGS</span></code></pre></div>
210	<span·id="cb5-2"><a·href="#cb5-2"·aria-hidden="true"></a><span·class="kw">enum</span>·ALLEGRO_JOYFLAGS</span></code></pre></div>
211	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L54">Source·Code</a></p>	208	<p><a·href="https://github.com/liballeg/allegro5/blob/master/include/allegro5/joystick.h#L54">Source·Code</a></p>
212	<ul>	209	<ul>
213	<li>ALLEGRO_JOYFLAG_DIGITAL·-·the·stick·provides·digital·input</li>	210	<li>ALLEGRO_JOYFLAG_DIGITAL·-·the·stick·provides·digital·input</li>
214	<li>ALLEGRO_JOYFLAG_ANALOGUE·-·the·stick·provides·analogue·input</li>	211	<li>ALLEGRO_JOYFLAG_ANALOGUE·-·the·stick·provides·analogue·input</li>
215	</ul>	212	</ul>
216	<p>(this·enum·is·a·holdover·from·the·old·API·and·may·be·removed)</p>	213	<p>(this·enum·is·a·holdover·from·the·old·API·and·may·be·removed)</p>
217	<p>See·also:·<a·href="joystick.html#al_get_joystick_stick_flags">al_get_joystick_stick_flags</a></p>	214	<p>See·also:·<a·href="joystick.html#al_get_joystick_stick_flags">al_get_joystick_stick_flags</a></p>
Offset 308, 12 lines modified		Offset 305, 12 lines modified
308	<p>See·also:·<a·href="joystick.html#allegro_joystick_state">ALLEGRO_JOYSTICK_STATE</a>,·<a·href="joystick.html#al_get_joystick_num_buttons">al_get_joystick_num_buttons</a>,·<a·href="joystick.html#al_get_joystick_num_axes">al_get_joystick_num_axes</a></p>	305	<p>See·also:·<a·href="joystick.html#allegro_joystick_state">ALLEGRO_JOYSTICK_STATE</a>,·<a·href="joystick.html#al_get_joystick_num_buttons">al_get_joystick_num_buttons</a>,·<a·href="joystick.html#al_get_joystick_num_axes">al_get_joystick_num_axes</a></p>
309	<h1·id="al_get_joystick_event_source">al_get_joystick_event_source</h1>	306	<h1·id="al_get_joystick_event_source">al_get_joystick_event_source</h1>
310	<div·class="sourceCode"·id="cb23"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb23-1"><a·href="#cb23-1"·aria-hidden="true"></a>ALLEGRO_EVENT_SOURCE·*al_get_joystick_event_source(<span·class="dt">void</span>)</span></code></pre></div>	307	<div·class="sourceCode"·id="cb23"><pre·class="sourceCode·c"><code·class="sourceCode·c"><span·id="cb23-1"><a·href="#cb23-1"·aria-hidden="true"></a>ALLEGRO_EVENT_SOURCE·*al_get_joystick_event_source(<span·class="dt">void</span>)</span></code></pre></div>
311	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L114">Source·Code</a></p>	308	<p><a·href="https://github.com/liballeg/allegro5/blob/master/src/joynu.c#L114">Source·Code</a></p>
312	<p>Returns·the·global·joystick·event·source.·All·<a·href="events.html#allegro_event_joystick_axis">joystick·events</a>·are·generated·by·this·event·source.</p>	309	<p>Returns·the·global·joystick·event·source.·All·<a·href="events.html#allegro_event_joystick_axis">joystick·events</a>·are·generated·by·this·event·source.</p>
313	<p·class="timestamp">	310	<p·class="timestamp">
314	Allegro·version·5.2.6	311	Allegro·version·5.2.6
315	·-·Last·updated:·2025-02-07·20:10:10·UTC	312	·-·Last·updated:·2024-01-06·13:49:34·UTC
316	</p>	313	</p>
317	</div>	314	</div>
318	</body>	315	</body>
319	</html>	316	</html>