Overview

EuGTK is a Euphoria 4.1 wrapper for the GTK 3 GUI user interface. EuGTK does not work with Phix. Euphoria/GTK code is much simpler and easier to understand than similar libraries for other programming languages.

History

Built on an original concept by Dave Cuny, with help from Mike Sabal, Ron Tarrant, and others. It is currently maintained by Irv Mullins.

Platform

EuGTK runs on Linux, Windows, and OSX. The latest version (4.11.7) May 2016, makes it very easy to build complex GUI interfaces for your programs. Interface can be hand-coded or designed using Glade. In many cases, the same source code can run on all three platforms without change.

Latest version can be downloaded from http://sites.google.com/site/euphoriagtk/Home

On the Linux platform, EuGTK uses the GTK3 libraries which are installed by default with current Linux distros such as Mint or Ubuntu, etc...

EuGTK on Windows requires the appropriate GTK libraries for Windows, either 32-bit or 64-bit. Links to several versions are included in the pdf which comes with the EuGTK package.

For OSX, you must install the gtk3 package with MacPorts

Preliminary installation instructions for installing on Raspberry Pi 3 are at bottom of this page.

EuGTK uses an object-oriented approach to coding. Below is a sample:

---------------------------------------------------------------------------- 
--# Yet Another Hello World! program 
---------------------------------------------------------------------------- 
 
include GtkEngine.e 
 
constant --[1] create the widgets; 
     
    win = create(GtkWindow,"border width=10,icon=face-laugh,$destroy=Quit"), 
    pan = create(GtkBox,"orientation=1"),  
    lbl = create(GtkLabel,"color=blue"), 
    box = create(GtkButtonBox), -- default is horizontal; 
    btn = create(GtkButton,"gtk-quit", "Quit") 
 
    set(lbl,"markup", -- style text; 
    "<b><u><span color='red'>Hello World!</span></u></b>\n\n" & 
    "This demos a simple window with\na label and a quit button.\n") 
 
    --[2] add widgets to containers; 
     
    add(win,pan) 
    add(pan,lbl) 
    pack_end(pan,box) 
    add(box,btn) 
     
show_all(win)  
main() -- enter main processing loop; 

Unix:

Windows:

Raspberry Pi 3:

Installing on Raspbian:

Follow the links on the Downloads page to download:

1. Arm binary for manual installation
2. Wee
3. EuGTK

Download the latest EuGTK, and click on the EuGTK4.x.x.tar.gz file, read the important note, then drag the demos folder into your home folder.

Download euphoria-4.1.0-ARMv6-hardfloat-5.tar.gz Click on it, and extract to, let's say, your home folder.

Go to your home folder, and open a terminal to copy some files:

cd ~/euphoria-4.1.0-ARMv6-hardfloat/bin 
sudo cp * /usr/bin 
cd .. 
sudo mkdir /usr/share/euphoria 
sudo chmod 777 /usr/share/euphoria 
sudo rm /usr/bin/eu.cfg 
cp -r * /usr/share/euphoria 

pi@raspberrypi:~ $ eui 
Euphoria Interpreter v4.1.0 development 
   32-bit Linux, Using System Memory 
   Revision Date: 2015-02-02 14:18:53, Id: 5861:57179171dbed 
 
ERROR: Must specify the file to be interpreted on the command line 

Replace /usr/bin/eu.cfg with the following:

[all] 
-eudir /usr/share/euphoria 
-i /usr/share/euphoria/include 
 
[translate] 
-arch ARM 
-gcc  
-con  
-com /usr/share/euphoria 
-lib-pic /usr/share/euphoria/bin/euso.a 
-lib /usr/share/euphoria/bin/eu.a 
 
[bind] 
-eub /usr/share/euphoria/bin/eub 

Check that it works

cd demos
eui test0

Should take a few seconds, and then show the window.

Install WEE

Download WEE-master.zip Use archiver to extract to /home/pi (or /home/your_user_name)

Associate .ex files

cd ~/demos 
right-click on test0.ex 
select Properties from the popup window 
Select Open With -> Customize 
Click on Custom Command Line 
enter eui as Command line to execute: 
Enter Euphoria as the Application name 
click OK 

Double click on an .ex program to see if it works.

Trouble Shooting

If you get a long warning re: accessibility, add the setenv line to GtkEngine.e as shown below:

export constant  
	version = "4.12.2", 
	release = "Feb 1, 2017", 
	copyright = " © 2017 by Irv Mullins" 
 
setenv("NO_AT_BRIDGE","1") -- add this line here 

Over on Linux/Mint and probably other Debian distributions, we see libgtk-3.0 is no longer installed to /usr/lib. This causes problems with the library. Until this is worked around you can modify the code so it finds the library, or you can put a symbolic link:

ln -s /usr/lib/*/libgtk-3.so.0 /usr/lib 

On Linux/32-bit, the latest eubins fail to work with this library. This is an interpreter problem and not a problem with the library itself. See ticket #933.

If the demos fail with cannot find test1.ex or something, it is because when the documentation says install to the home directory it really means you must install it there.