DUIM - Dylan User Interface Manager

We have a lot to learn about hacking on DUIM, so there isn’t much to document yet as we haven’t learned yet.

GTK Back-end

The GTK+ back-end is usable on both macOS and Linux. It is based on GTK+ 3.x. On macOS, it assumes that the Quartz back-end is being used rather than X11.

The bindings for GTK+ are largely generated from gobject-introspection meta-data. Some portions are hand-edited however or entirely done by hand, like the Cairo bindings. Most of the special cases for hand-editing are put into the binding generator (gir-dylan), but not all.

Getting GTK+ 3.x with Quartz on macOS

Building GTK+ 3.x with Quartz on macOS must be done in a specific way. This currently can not be done with Homebrew.

Follow the directions on the GTK+ wiki, but make sure to build GTK+ 3.x rather than 2.x. To do this, you’ll want to use the moduleset meta-gtk-osx-gtk3 rather than meta-gtk-osx-core.

Once you have a build, be sure to add the appropriate directories to your path.

We have not yet integrated GTK+’s macOS integration module, so the menu bar will not (yet) be integrated with the system menu bar when running a DUIM application.

Note

GTK+ will be built as a 64 bit binary. This means that your Dylan code will also have to be built as a 64 bit binary. Doing this requires a build of Open Dylan from the master branch. Once you have a current build of Open Dylan, set the OPEN_DYLAN_TARGET_PLATFORM environment variable to x86_64-darwin and your builds will be 64 bit.

Debugging Information

To enable more debugging information, uncomment the following line in sources/duim/gtk/gtk-debug.dylan:

*debug-duim-function* := dbg;

You can then output debugging information with either of the following functions:

  • ignoring(msg)

  • duim-debug-message(format, args)

Additional debug information can be obtained via the GTK_DEBUG and GDK_DEBUG environment variables.