Simple and Fast Multimedia Library

[[Programmer|Original authorTemplate:Pluralize from text]]	Laurent Gomila, and others
[[Programmer|DeveloperTemplate:Pluralize from text]]	SFML Team
Initial release	August 9, 2007 (2007-08-09)
Template:Infobox software/simple
Written in
Engine	Template:Wikidata Template:EditAtWikidata
Operating system
Type	API
License	zlib License
Website	www.sfml-dev.org
Repository	[http://Template:Wikidata http://Template:Wikidata]Template:EditAtWikidata

Simple and Fast Multimedia Library (SFML) is a cross-platform software development library designed to provide a simple application programming interface (API) to various multimedia components in computers. It is written in C++ with bindings available for Ada, C, Crystal, D, Euphoria, Go, Java, Julia, .NET, Nim, OCaml, Python, Ruby, Rust, Node.js, Beef and Zuko. Experimental mobile ports were made available for Android and iOS with the release of SFML 2.2.

SFML handles creating and input to windows, and creating and managing OpenGL contexts. It also provides a graphics module for simple hardware acceleration of 2D computer graphics which includes text rendering using FreeType, an audio module that uses OpenAL, replaced by miniaudio as of v3.0.0, and a networking module for basic Transmission Control Protocol (TCP) and User Datagram Protocol (UDP) communication.

SFML is free and open-source software provided under the terms of the zlib/png license. It is available on Linux, macOS, Windows and FreeBSD. The first version v1.0 was released on 9 August 2007, and the latest version, v3.0.0, was released on 21 December 2024.

Software architecture

Modules

SFML consists of various modules:

• System – vector and Unicode string classes, portable threading and timer facilities
• Window – window and input device management including support for joysticks, OpenGL context management
• Graphics – hardware acceleration of 2D graphics including sprites, polygons and text rendering
• Audio – hardware-accelerated spatialised audio playback and recording
• Network – TCP and UDP network sockets, data encapsulation facilities, HTTP and FTP classes

While the graphics module is one of the main features of SFML, developers who are interested in only creating an environment to program directly in OpenGL can do so by using the Window module on its own without the graphics module. Similarly, the other modules can also be used independently of each other, except for the System module which is used by all of the modules.

Language bindings

SFML is written in C++ and provides a C++ interface (it also provides a C interface through the official CSFML binding). Several language bindings exist that enable using SFML in other programming languages.

This table lists supported bindings for SFML as of 2024.

Name	Language	Supported version
ASFML	Ada	2.6
CSFML1	C	2.6
BeefSFML	Beef	2.5
SFML.Net1	.NET	2.6
CrSFML	Crystal	2.6
bindbc-sfml	D	2.5
DSFML	D	2.1
EuSFML2	Euphoria	2.4
csfml-fpc	Free Pascal	2.5
go-sfml	Go	2.5.1
GoSFML2	Go	2.0
Hackage	Haskell	2.3
JSFML	Java	2.2
CSFML.jl	Julia	2.5.1
nim-csfml	Nim	2.3
Ocsfml	OCaml	2.2
OCaml-SFML	OCaml	2.5.1
PasSFML	Pascal	2.4
pySFML	Python	2.3.2
rbSFML	Ruby	2.3.2
rust-sfml	Rust	2.6.1
zig-sfml	Zig	2.6.1
sfml.js	Node.js	2.5.1
zukoSFML	Zuko	2.5

¹ Official bindings

Unofficial add-ons

SFML provides the basic functions on which higher-level software can be built. Add-on libraries exist that provide added support for graphical user interfaces (GUIs), 2D lighting, particle systems and animation, video playback and tilemaps.

Example

This is a basic example of SFML given on the tutorial page, which draws a green circle.

#include <SFML/Graphics.hpp>

import std;

using sf::Color;
using sf::CircleShape;
using sf::Event;
using sf::RenderWindow;
using sf::VideoMode;

int main() {
    RenderWindow window(VideoMode({200, 200}), "SFML works!");
    CircleShape shape(100.0f);
    shape.setFillColor(Color::Green);

    while (window.isOpen()) {
        while (const std::optional event = window.pollEvent()) {
            if (event->is<Event::Closed>()) {
                window.close();
            }
        }

        window.clear();
        window.draw(shape);
        window.display();
    }
}

Reception and adoption

SFML is primarily used by hobbyist game developers, small independent video game developers, and startup companies consisting of several developers at most. Because SFML does not require writing large amounts of code, it has also been adopted by many Ludum Dare participants. Compared to older libraries such as Simple DirectMedia Layer (SDL) and Allegro, the SFML user base is relatively small but growing. As of 25 December 2024, its GitHub software repository has been starred by over 10,000 users.

SFML has been used in teaching at universities and in scientific projects.

Video game use examples

• Atom Zombie Smasher, real-time strategy game.
• Away Team, Simulation Interactive Fiction game.
• Chesster, puzzle game.
• Cosmoscroll, free open-source space-based shoot 'em up game.
• Crea, moddable 2D sandbox game.
• Enchanted Forest
• Extreme Tux Racer, free open-source arctic racing game featuring Tux (using SFML since version 0.7).
• GravytX The Gravytoid, 2D action-platform, adventure game for Web, Mobile and PC.
• HolySpirit, 3D isometric hack and slash game.
• Hope, point and click adventure game (like Myst).
• I Can Transform, 2D action-platform, multiplayer (playable also in solo) game for Web, Mobile and PC.
• Jin Conception, 2D pixel art JRPG for Nintendo Switch.
• KeeperRL, dungeon simulator with rogue-like and RPG elements.
• Kroniax, minimalistic side-scroller, and the first SFML game for Android.
• Limit Theory, infinite, procedural space game.
• M.A.R.S., multiplayer shoot 'em up game.
• Moonman, pixel art exploration sandbox game.
• Open Hexagon, free open-source Super Hexagon clone.
• Ovid The Owl, puzzle platform game.
• Pioneers, turn based exploration game with some RPG elements.
• Postmortem: one must die, narrative adventure game.
• Project Black Sun, retro 2D side-scrolling video game.
• TacWars, a puzzle RPG that pits Dwarves against Goblins.
• The Duke, action platform game.
• The Shooting of Isaac, vertical shooter game.
• Vagante, action RPG platform game.
• Zloxx, 2D action platformer.

Further examples of games using SFML are listed on IndieDB.

Other software use

• Aquila, open source digital signal processing (DSP) library for C++.
• Otter , a 2D C# framework built on SFML 2.
• GDevelop, open source game creation software.
• Immersion Engine , tool to visualize detailed landscapes and architecture.
• is::Engine, 2D C++ game engine for Nintendo Switch, Web (HTML 5), Mobile and PC.

See also

• Allegro
• ClanLib
• Cross-platform support middleware
• GLFW
• OpenGL
• OpenGL Utility Toolkit (GLUT)
• Raylib
• Simple DirectMedia Layer (SDL)

Further reading

• Jan Haller, Henrik Vogelius Hansson, Artur Moreira: SFML Game Development, Packt Publishing, Template:ISBN
• http://www.lifehacker.com.au/2013/02/xna-is-dead-3-alternatives-that-let-you-use-your-c-and-net-skills/
• https://www.binpress.com/tutorial/creating-a-city-building-game-with-sfml/137
• http://www.gamefromscratch.com/page/Game-From-Scratch-CPP-Edition-The-Introduction.aspx

External links

1. REDIRECT Template:GitHub

• SFML Tutorials