Edit ``CLX''

CLX provides an implementation of the X Window System protocol to Lisp *(graphics library)[ies] and applications. It is the Common Lisp equivalent of Xlib.

_(portable-clx) (formerly called "telent CLX") is used in _(SBCL) and also forms
the basis of the _(OpenMCL) and _(ECL) CLX packages.  As of 0.7.3 it 
additionally supports Allegro CL. It includes Unix-domain socket support, SHAPE, XRENDER, XFREE86-VIDMODE extensions, authorization fixes for ssh-forwarded connections, and many other bugfixes and performance improvements.  Usually tested against the latest released SBCL.

<pre>
# This is the version used in _(QuickLisp)
git clone git://github.com/sharplispers/clx.git
</pre>

Bundled versions of CLX for different implementations:
<ul>
<li>_(CMUCL): available from <a href="http://www.cons.org/cmucl/download.html">CMUCL download sites</a> in the
<tt>extra</tt> package.

<li>_(CLISP) comes with two implementations of CLX - the original MIT-CLX
and NEW-CLX which is faster and has some extensions.

<li>_(LispWorks) - Barry Wilkes ported the MIT R5.02 sources to
LispWorks for Linux - <a href="http://www.bew.org.uk/Lisp/index.html"
>http://www.bew.org.uk/Lisp/index.html</a>.  Other UNIX ports of
LispWorks have a version of CLX supported by Xanalys.

<li>_(OpenMCL) (based on telent CLX) at <a
href="ftp://clozure.com/pub/CLX/" >ftp://clozure.com/pub/CLX/</a>

<li>Allegro Common Lisp: comes with CLX. You can browse the version distributed with Allegro CL <a href="http://github.com/franzinc/clx/tree/master">here</a>; 
it appears to be the same as the MIT sources, featurewise.
</ul>

The _(CLX Manual) is available in HTML and texinfo.

<h2>Supported X11 extensions</h2>
<ul>
<li> XRENDER by Gilbert Baumann (basically done in the telent tree)
<li> XSHAPE and XFREE86-VIDMODE in the telent tree
<li> GLX (experimental) and DPMS (also in the telent tree)
<li> BIG-REQUESTS (work begun in _(Christophe)'s darcs repository)
<li> Some XSM work has been done in _(Eclipse); e.g.: <a href="http://common-lisp.net/cgi-bin/viewcvs.cgi/eclipse/lib/sm/?cvsroot=eclipse">eclipse/lib/sm/</a> _(common-lisp.net) CVSWeb entry
</ul>

<h2>Opportunities to contribute</h2>
<ul>
<li>Adding more effective declarations</li>
<li>Update the _(CLX Manual).
<li>Adding documentation strings to functions (mostly just converting existing good comments to strings).
<li>Better i18n</li>
<li>Support for the MITSHM extension</li>
<li>Use <a href="http://xcb.freedesktop.org/XmlXcb/">XmlXcb</a> (XML description of the X protocol as used by XCB) as basis.</li>
</ul>

<h2>ssh-forwarded connections</h2>

The standard CLX function OPEN-DISPLAY doesn't correctly extract the
display number from the DISPLAY environment variable. This is a
problem when using CLX on an ssh-forwarded *(X11) session, as ssh
typically uses display number 10+n.  Additionally, CLX in its MIT
guise doesn't handle xauth very well, requiring the <tt>xhost</tt>
blunt instrument before it'll put up a window on such a display.  This
is handled correctly in CMUCL CLX (use EXT:OPEN-CLX-DISPLAY) and in
telent CLX (XLIB:OPEN-DEFAULT-DISPLAY).  See _(CMUCL Hints) for more
information.

<h2>CLOS interfce</h2>

_(Paul Foley) wrote <a href="http://users.actrix.co.nz/mycroft/event.lisp">CLOS class wrappers for X events</a>.

<h2>Example programs</h2>
Perhaps you want to have a look at the source code of _(Acclaim) as it directly uses CLX without any layer in between to display the rendered slides on screen.

<hr>

Topics: *(x11) *(networking)
See also: _(GUI) toolkits

<b>This download link is for benefit of ASDF-INSTALL only: if you're installing
manually, get an up-to-date version from the github address or using QuickLisp.</b>
:(package "http://common-lisp.net/~abridgewater/dist/clx/clx-0.7.4.tgz")

Please supply your name and a summary of changes for the Recent Changes page. If you are making a minor alteration to a page you recently edited, you can avoid making another Recent Changes entry by leaving the Summary box blank
Summary of changes:
Captcha (enter the word "lisp" here):
Your name:
Check this box to fill in your name automatically next time (uses a cookie)

Please note: other readers will see your changes immediately, but external search engines will continue to see the old version for another 24 hours. Spamming this site to improve your PageRank is therefore a particularly fruitless activity.

CLiki pages can be edited by anyone at any time. Imagine a fearsomely comprehensive disclaimer of liability. Now fear, comprehensively