gtk

Rust bindings and wrappers for GLib, GDK 3, GTK+ 3 and Cairo.

Building

gtk expects GTK+, GLib and Cairo development files to be installed on your system. Optionally, it is recommended to install the debug packages containing helpful debug symbols.

Debian and Ubuntu

```Shell

sudo apt-get install libgtk-3-dev sudo apt-get install libgtk-3-0-dbg libglib2.0-0-dbg libcairo2-dbg ```

Fedora

```Shell

sudo dnf install gtk3-devel glib2-devel

Fedora 21 and earlier

sudo yum install gtk3-devel glib2-devel ```

OS X

Install XQuartz, then: ```Shell

brew install gtk+3 --without-x11 export PKGCONFIGPATH=/usr/local/lib/pkgconfig:/opt/X11/lib/pkgconfig ```

Windows

Install mingw-w64 (select the win32 threading model) and download a GTK+ SDK: * The GNOME project has an official distribution of GTK+ 3.6: x86, x64. * GTK+ for Windows Runtime Environment Installer: 64-bit supports GTK+ 3.14, its SDK downloads can currently be found here.

Make sure both mingw's and the sdk's bin directories are in your PATH e.g. (assuming mingw is installed in C:\mingw-w64 and the SDK unpacked into C:\gtk) C:\> set PATH="C:\mingw-w64\bin;C:\gtk\bin;%PATH%" If your Rust installation has gcc.exe and ld.exe in its bin directory, you may get a linking error ld: cannot find -limm32. In that case remove those executables, they will be provided by mingw instead.

Versions and features

gtk targets GTK+ 3.6 and Cairo 1.10 by default, other versions support is enabled by requesting a corresponding feature e.g. ```Shell

cargo build --features gtk310 Disabling the default GTK 3.6 support Shell cargo build --no-default-features --features gtk34 ``` Currently supported versions are GTK+ 3.4 to 3.14 and Cairo 1.10 to 1.12.

We are currently targetting rust master compiler to build gtk, make sure you have the latest version before submitting any bugs.

Examples are providing in the rust-gnome/examples repository, you can find some tests showing off the functionality, these can be built and run as follows:

```Shell

cargo build --release

Or, if your system has GTK 3.10 or later

cargo build --features gtk310 --release ./target/release/gtktest ./target/release/cairotest ```

When building documentation don't forget to specify the feature set you're using:

```Shell

cargo doc --feature gtk312 ```

Your local copy can be accessed using your browser at

file:///{gtk_location}/target/doc/gtk/index.html

Including gtk as a cargo dependency

To include gtk as a cargo dependency you have to add it to your Cargo.toml and specify the GTK version you want using Cargo features: Toml [dependencies.gtk] git = "https://github.com/rust-gnome/gtk.git" features = ["gtk_3_12"] If it's lower than 3.6: Toml [dependencies.gtk] git = "https://github.com/rust-gnome/gtk.git" features = ["gtk_3_4"] default-features = false For maximum compatibility the version you select here should be the lowest that provides all of the GTK features needed by your project. Don't just set it to match the libraries installed on your system.

Use gtk

To implement GTK+ inheritance in rust, we implemented gtk superclasses as traits located in gtk::gtk::traits::*. The various widgets implement these traits and live in gtk::gtk::*.

For your convenience the various traits are reexported in the gtk::* namespace as Gtk{trait_name}Trait so you can just use...

```Rust extern crate gtk;

use gtk::*; ```

...to easily access all the gtk widgets and all traits methods:

Rust let button = gtk::Button:new(); // You have access to the struct methods of gtk::Button aswell // as the trait methods from gtk::traits::Button as GtkButtonTrait.

Projects using gtk

• SolidOak
• rrun
• process-viewer

If you want yours to be added to this list, please create a Pull Request for it!

Screenshots

Contribute

Contributor you're welcome!

You probably know but Gtk+ uses its own GObject system: inherited class and interface.

To respect this design, I follow a special design on gtk:

• Interface -> Implement them on a trait with only default methods.
• Class -> Implement the construct on the class impl and other methods on a traits.
• Sub-class -> Implement all the methods on the class.

Example for GtkOrientable, GtkBox, GtkButtonBox:

GtkOrientable is an interface with all methods implemented as default method of the trait gtk::traits::Orientable.

GtkBox is a class with constructors implemented on the struct gtk::Box, and the other method as default methods of the trait gtk::traits::Box. So gtk::Box implements gtk::traits::Orientable and gtk::traits::Box.

GtkButtonBox is a sub-class of GtkBox, the struct gtk::ButtonBox implements all the methods of GtkButtonBox and the traits gtk::traits::Orientable and gtk::traits::Box.

Finally, all the gtk widgets implement the trait gtk::traits::Widget.

License

gtk is available under the MIT License, please refer to it.