Home

Welcome to the ASFML wiki!

Documentation for users

Available resources:

• API documentation for ASFML.
• Tutorials for SFML (C++) or CSFML (C) are useful. Applicability to Ada is usually straightforward.

Video-tutorials by users

Build the SFML and CSFML and use it through the ASFML in Ada (Linux) by HonkiTonk

(German version)

List of projects using ASFML

Feel free to add yours!

• 16 Games
• Play 2048
• pygamer-simulator
• lvgl-ada-simulator
• Honki Tonk's Zivilisationen
• BingAda (only for sound)
• Quiza (archived)
• qva
• VcAdaSfmlTetris
• Spaceport (unfinished)

Distributions and indexes including ASFML

• Alire
• FreeBSD

Notes for developers

Steps to update to a new CSFML release:

1. Install the new CSFML release.
2. Change current directory to include/generated.
3. Run make CSFML_PREFIX=/your/path/to/CSFML check, in order to get the list of new symbols to import.
4. Read the release notes for SFML and CSFML to get an idea of API changes.
5. Compare the two tags (current bound release and new release) to see differences in header files, for example: https://github.com/SFML/CSFML/compare/2.5.2...2.6.0
6. Run make CSFML_PREFIX=/your/path/to/CSFML generate to get the automatically generated specifications.
7. Merge generated specifications with current ones and edit accordingly.
8. Update tests if needed.
9. Repeat until make check says everything is updated and compile and run tests.
10. Update version numbers in include/sf.ads
11. Regenerate documentation and update README.md.
12. Make new release in GitHub and in Alire.