Return to the Gtk-Server-Wrapper Home Page

Common Lisp Gtk-Server Wrapper - Documentation

Introduction
Show me some example
API Documentation
Working Common-Lisp Implementations
How to install
Who am I
License
Contact
Acknowledgments

Introduction

With this wrapper you can develop gui application using the Gtk+ Library in a platform independent manner.

This wrapper works with Gtk-Server. Gtk-Server is a really wonderful program that enables the access to the GTK widget set for another process using many communication protocols like stdin/stdout, tcp/udp port, named pipe, etc.

You can view more informations about Gtk-Server here.

Show me some example

Yes of course :-D

As you already understood my English is bad so I think my lisp code is more understandable than my explanations....

You can view the examples – documentation page.

API Documentation

If you want you can see the LispDoc generated api documentation

Package Name	Package Documentation
GTK-SERVER	Documentation (new window)

Working Common-Lisp Implementations

I've tested the Gtk-Server wrapper with this implementations and operating systems:

	Linux	Windows	MacOSX
CLisp	OK	OK
Cmucl	OK	n.a.	OK
Sbcl	OK	n.a.	OK
Clozure CL	n.a.	n.a.	OK
LispWorks		See note	OK

Note: the LispWorks version run incredibly slow comparing the clisp version in windows and I don't know why. Probably I'm using the pipe feature of Lispworks in a wrong manner. If you have some idea on how to correct my code please contact me at Leonardo Cecchi (please remove NOSPAM from the email address).

How to install

Requirements:

A supported common-lisp implementation (see common-lisp implementation paragraph)
ASDF installed and working (see asdf page on the Cliki). Some common-lisp implementations comes with asdf pre-installed.
Gtk-Server installed. The gtk-server directory should be in the path. (On windows the gtk-server installation bundle already place the directory in the path)

The Gtk-Server wrapper ASDF-package:

Download the source package here: gtk-server-wrapper.zip
(optional) Download examples packages: gtk-server-wrapper-samples.zip

To load the gtk-server package you issue (at the REPL):

(asdf:oos 'asdf:load-op :gtk-server)
(asdf:oos 'asdf:load-op :gtk-server-components)

Every sample file defines a package and a main function. You can start the main function to try the example:

(example-one:main)

Who am I

I'm a Common Lisp newbie that want to make gui applications in a fast and reliable way.... so if you find problems in this wrapper please don't bear with me :-D

I always need help on how to do things in the Lisp Way.

Common Lisp is a wonderful language for too many reason. If you want to learn Common Lisp as a second language I encourage you to read and buy the Peter Seibel book here.

License

This Gtk-Server Wrapper is release under a BSD license that you can read here.

Contact

If you want you can contact me ad my e-mail address: Leonardo Cecchi (please remove NOSPAM from the email address).

Acknowledgments

I would like to thank Peter van Eerten for making the gtk-server software.

He always support his product like (maybe better) a commercial one and this wrapper has started from the CLisp example you can download at gtk-server site.

I would like to thank Peter Seibel for writing the book that has taken me to lisp “Practical Common Lisp Book”.

You can read the book here: http://www.gigamonkeys.com/book/