1. A first window
fortran
!< tut01_window, tutorial chapter 1: a window with one line of text.
program tut01_window
!< tut01_window, tutorial chapter 1: a window with one line of text.
use, intrinsic :: iso_fortran_env, only : int32
use figure, only : app_object, ig_begin, ig_end, ig_text
implicit none
type(app_object) :: app !< Application.
call app%init('FIGURE: first window', 640_int32, 360_int32)
do while (app%next_frame())
if (ig_begin('Hello')) then
call ig_text('Hello from Fortran.')
endif
call ig_end()
enddo
call app%destroy()
endprogram tut01_window
app_objectis the application: one per program.initopens a 640 x 360 window titled "FIGURE: first window" and creates the Dear ImGui and ImPlot contexts.640_int32is the literal 640 of kindint32, fromiso_fortran_env: FIGURE's integer and real arguments have that module's kinds (Feature map), and the next chapters write a real as0.5_real64.next_frame()renders the previous frame, waits for input, and opens the next frame; it returns.false.when the user closes the window.- Between two
next_framecalls the program declares the interface. Here, one Dear ImGui window named "Hello" with one line of text. The window can be moved, resized and collapsed with the mouse: Dear ImGui handles it. ig_beginreturns.false.when the window is collapsed: its content is skipped.ig_endis called in any case.destroycloses the window.
The program does nothing while you do not touch it: once the interface has settled, next_frame sleeps until the next input event or for at most 0.5 s (lazy redraw).
Building it
Save the program above as tut01_window.F90. With FIGURE installed by the one-line installer (PKG_CONFIG_PATH set as the installer printed):
bash
gfortran tut01_window.F90 $(pkg-config --cflags --libs figure) -o tut01_window
./tut01_windowOn WSL2, set GALLIUM_DRIVER=d3d12 before running it (Installation).
In a clone of the repository, after scripts/build_native.sh and from its root (the chapter's source is docs/examples/src/tut01_window.F90):
bash
fobis build --mode figure-static-gnu
gfortran -I lib/mod docs/examples/src/tut01_window.F90 lib/libfigure.a -L lib -lfigure_native -lSDL3 -lstdc++ -ldl \
-lpthread -lm -o tut01_windowWhat you learned
The application, the frame loop, a window. Reference: Frame loop and redraw.
Next: 2. Widgets and state.