Skip to content

Latest commit

 

History

History
71 lines (49 loc) · 3.73 KB

README.md

File metadata and controls

71 lines (49 loc) · 3.73 KB
Raw

gtk-fortran extra examples

These examples are under MIT license (contrarily to the gtk-fortran repository which is under GPL), so you can begin working on your own gtk-fortran application without worrying about license problems. You can pick an app and adapt it to your own needs.

The applications

Each application is in a directory:

  • my_fast_app: a gtk-fortran application for fast computations (ideally < 1 second). In that case, you can use the GtkApplication API. The activate() GUI callback function will call the scientific computing subroutine and draw the GUI and the graphical result. In the present case, it draws a Lorenz attractor, with three planar views and a text view. The command line version will simply print the x, y, z position of the final point.
  • my_long_app: a gtk-fortran application for long computations, with a picture that is updated regularly. In that case you can not declare a GtkApplication: you must manage the events of the GLib main loop to keep the GUI reactive during the computation. The application is drawing a Buddhabrot. The command line version will finally save a picture in portable pixmap format (PPM).
  • parallel_app/ demonstrates how you can use parallel Fortran 2008 and 2018 features (coarrays, collective routines...) in a gtk-fortran application. It draws a Buddhabrot.
  • reaction_diffusion/: a gtk-fortran application using ForColormap to create a movie with Turing patterns, displayed with various colormaps.
  • saville_code/: a gtk-fortran application to encode a text using Peter Saville's color code.
  • unknown_pleasures/: a Fortran generator of figures similar to the iconic Joy Division's Unknown Pleasures cover.

You can see the windows of those apps in the screenshots/ directory.

Installation

Dependencies

The gtk-4-fortran library must be installed on your machine, with its dev files. You will also need git:

$ sudo apt install libgtk-4-dev git

Some examples can be built directly with fpm. For the others, you need to build gtk-fortran and install the library in your system. Typically, on a Linux Ubuntu system, you just need to type:

$ sudo apt install cmake
$ git clone git@github.com:vmagnin/gtk-fortran.git
$ cd gtk-fortran
$ mkdir build && cd build
$ cmake ..
$ make -j
$ sudo make install

Note that your application must be compiled with the same compiler as the one used for building gtk-fortran. The default compiler used by the shell scripts is gfortran.

See https://github.com/vmagnin/gtk-fortran/wiki#installation-and-building for more installation instructions, especially for other OS.

Compiling and running the apps

Typically, you need to type in your terminal:

$ git clone git@github.com:vmagnin/gtk-fortran-extra.git
$ cd gtk-fortran-extra

then go into the directory of an application and launch the build script:

$ cd my_fast_app
$ ./with_GUI.sh

fpm

The examples reaction_diffusion, saville_code and unknown_pleasures can be built and run with the Fortran Package Manager, for example:

$ cd unknown_pleasures
$ fpm run

In that case, gtk-fortran will be cloned and built automatically by fpm.

References

  • Vincent MAGNIN, James TAPPIN, Jens HUNGER, Jerry DE LISLE, "gtk-fortran: a GTK+ binding to build Graphical User Interfaces in Fortran", Journal of Open Source Software, 4(34), 1109, 12th January 2019, https://doi.org/10.21105/joss.01109