Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vmagnin/gtk-fortran-extra
Extra examples to start your own gtk-fortran application (MIT license).
https://github.com/vmagnin/gtk-fortran-extra
fortran gtk-fortran gtk4 gui gui-application
Last synced: 2 months ago
JSON representation
Extra examples to start your own gtk-fortran application (MIT license).
- Host: GitHub
- URL: https://github.com/vmagnin/gtk-fortran-extra
- Owner: vmagnin
- License: mit
- Created: 2021-06-03T06:49:22.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-20T19:47:05.000Z (3 months ago)
- Last Synced: 2024-10-25T09:24:47.841Z (2 months ago)
- Topics: fortran, gtk-fortran, gtk4, gui, gui-application
- Language: Fortran
- Homepage:
- Size: 4.9 MB
- Stars: 14
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# gtk-fortran extra examples
**These examples are under MIT license** (contrarily to the [gtk-fortran](https://github.com/vmagnin/gtk-fortran/wiki) 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](https://docs.gtk.org/gtk4/class.Application.html). 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](https://en.wikipedia.org/wiki/Lorenz_system), 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](https://en.wikipedia.org/wiki/Buddhabrot). The command line version will finally save a picture in [portable pixmap format (PPM)](https://en.wikipedia.org/wiki/Netpbm#File_formats).
* `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](https://github.com/vmagnin/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:
```bash
$ 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:
```bash
$ sudo apt install cmake
$ git clone [email protected]: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](https://gcc.gnu.org/wiki/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:
```bash
$ git clone [email protected]:vmagnin/gtk-fortran-extra.git
$ cd gtk-fortran-extra
```
then go into the directory of an application and launch the build script:
```bash
$ 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:
```bash
$ 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](https://doi.org/10.21105/joss.01109)