fortran-raylib

A work-in-progress collection of interface bindings to raylib 6.0, for 2-D and 3-D game programming in Fortran 2018. The library has been tested with GNU Fortran 15 and Flang 21.

Build Instructions

Install the raylib package suitable for your operating system, or build from source, for example:

$ cd raylib-6.0/
$ mkdir build && cd build/
$ cmake .. -DCMAKE_BUILD_TYPE=Release -DPLATFORM=Desktop -DWITH_PIC=ON -DBUILD_SHARED_LIBS=ON
$ cmake --build .

Install the library to /opt/lib:

$ cmake --install . --prefix /opt

Make

Build the fortran-raylib library with GNU Fortran by executing the provided Makefile:

$ git clone --depth 1 https://github.com/interkosmos/fortran-raylib
$ cd fortran-raylib/
$ make

Or, to compile with Flang:

$ make FC=flang21

Pass argument RAYLIB to override the raylib library to link. For example, if the static library libraylib.a is in the same directory:

$ make RAYLIB=libraylib.a

You may have to set the libraries to link manually (argument LDLIBS), depending on your operating system.

Fortran Package Manager

Building the library and all examples with fpm:

$ fpm build --profile release

Alternatively, you can add fortran-raylib as a dependency to the fpm.toml of your project:

[dependencies]
fortran-raylib = { git = "https://github.com/interkosmos/fortran-raylib" }

Linking

Link your Fortran application against libfortran-raylib.a, -lraylib, and additional platform-dependent libraries:

System	Linker Libraries
FreeBSD	-lraylib -lglfw -lGL -lpthread -lm
Linux	-lraylib -lGL -lm -lpthread -ldl -lrt -lX11
Linux (Wayland)	-lraylib -lGL -lm -lpthread -ldl -lrt -lwayland-client -lwayland-cursor -lwayland-egl -lxkbcommon
macOS	-lraylib -framework OpenGL -framework Cocoa -framework IOKit -framework CoreAudio -framework CoreVideo
Raspberry Pi	-lraylib -lbrcmGLESv2 -lbrcmEGL -lpthread -lrt -lm -lbcm_host -ldl -latomic
Windows	-lraylib -lopengl32 -lgdi32 -lwinmm

Example

The following example program opens a window and draws some text.

! example.f90
program main
    use :: raylib
    use :: raylib_util
    implicit none (type, external)

    integer, parameter :: SCREEN_WIDTH  = 800
    integer, parameter :: SCREEN_HEIGHT = 450

    call init_window(SCREEN_WIDTH, SCREEN_HEIGHT, f_c_str('Fortran + raylib'))
    call set_target_fps(60)

    do while (.not. window_should_close())
        call begin_drawing()
            call clear_background(RAYWHITE)
            call draw_text(f_c_str('Hello, World!'), 190, 200, 20, LIGHTGRAY)
        call end_drawing()
    end do

    call close_window()
end program main

Compile and link the example program:

$ gfortran -L/usr/local/lib -o example example.f90 libfortran-raylib.a -lraylib -lGL -lpthread -lm
$ ./example

Depending on the build flags chosen for raylib, you may have to additionally link against -lglfw. If libraylib is not installed to /usr/lib or /usr/local/lib, add the library search path (for instance, -Wl,-rpath=/opt/lib -L/opt/lib if installed to /opt/lib).

Further Examples

More examples can be found in examples/:

• bunny is a bunny benchmark.
• camera renders a cube in 3-D.
• camera3d renders a 3-D scene, with keyboard and mouse controls.
• castle renders a 3-D model loaded from file.
• collision shows 2-D collision detection.
• cubes renders waving cubes.
• explosion renders sprites and plays sound.
• flags shows window flags.
• geometric renders basic geometric shapes.
• font displays text using bitmap fonts.
• julia renders animated Julia set (via GLSL shader).
• keys demonstrates keyboard input.
• log adds a custom logging routine.
• map renders a height map.
• maze renders a 3-D maze in first-person view.
• mesh demonstrates mesh instancing.
• plane shows pitch/yaw/roll of a 3-D model.
• shapes renders basic shapes.
• ship rotates a 3-D model loaded from file.
• window opens a window with raylib.

Build all examples with:

$ make examples

To link against a static raylib library, run:

$ make examples RAYLIB=/path/to/libraylib.a

Documentation

Create the source code documentation with FORD:

$ pip install -U ford
$ make doc

Compatibility

Some issues have to be regarded when calling raylib from Fortran:

• All procedure names and dummy arguments have been converted to snake case.
• Make sure to properly null-terminate all character strings passed to raylib with c_null_char or by using utility function f_c_str().
• Some variadic C functions of raylib are not bound by the interface library, like TextFormat(). In this particular case, just use the Fortran write statement instead.
• If a function returns type(c_ptr), the result has to be converted to a Fortran pointer with the intrinsic subroutine c_f_pointer() first. C char pointers may be converted with utility subroutine c_f_str_ptr() from module raylib_util, or the intrinsic c_f_strpointer() (Fortran 2023).

Licence

ISC