Important note

This is an old webpage. As of 2008-12-05 17:45, this project may now be found at: http://code.google.com/p/lispbuilder/

LISPBUILDER - Do stuff with Common Lisp


 

Abstract

Common Lisp Application Builder provides several useful cross-platform packages for Common Lisp.

Text processing; AWKing, LEXing, YACCing, and REGEXing: LISPBUILDER-CLAWK, LISPBUILDER-LEXER, LISPBUILDER-REGEX, LISPBUILDER-YACC.

Game development; Event handling, 2D graphics, image loading, TTF font handling and sound: LISPBUILDER-SDL, LISPBUILDER-SDL-GFX, LISPBUILDER-SDL-IMAGE, LISPBUILDER-SDL-TTF, LISPBUILDER-SDL-MIXER.

Networking: LISPBUILDER-NET.

Win32 specific (windows.h): LISPBUILDER-WINDOWS.

Offical releases can be found on Sourceforge.

These packages come with a BSD style license.

LISPBUILDER is a Common Lisp Gardeners project.


 

Index

  1. News
  2. Releases
  3. Download
  4. Windows Installation
  5. Mac OS-X Installation
  6. Linux Installation
  7. Usage
  8. Support
  9. Contributors
  10. Links

 

News


 

Releases

The latest official releases of the LISPBUILDER packages are as follows.

Packages Binary Library
Package Name Version Released Lib Name Version
lispbuilder-clawk SVN 28 Feb 2006 N/A N/A
lispbuilder-lexer SVN 28 Feb 2006 N/A N/A
lispbuilder-openrm 0.1.0 Oct 20, 2006 OpenRM 1.6.0-2
lispbuilder-regex SVN 28 Feb 2006 N/A N/A
lispbuilder-sdl 0.9.0 July 03, 2007 SDL 1.2.11
lispbuilder-sdl-gfx 0.6.0 June 27, 2007 SDL_gfx 2.0.13
lispbuilder-sdl-image 0.4.0 July 06, 2007 SDL_image 1.2.5
lispbuilder-sdl-mixer 0.2.0 Apr 15, 2008 SDL_mixer 1.2.8
lispbuilder-net SVN Initial N/A N/A
lispbuilder-sdl-ttf 0.2.0 June 27, 2007 SDL_ttf 2.0
lispbuilder-windows Initial 10 Dec 2006 N/A N/A
lispbuilder-yacc SVN 28 Feb 2006 N/A N/A

 

Download

Current Versions: The latest versions can be downloaded from Releases above.
 

Windows Installation

  1. Install Lispworks Personal Edition.
  2. Install Edi Weitz's Lisp Starter Pack.
  3. Download config.lisp and place into the same directory as the Lisp Starter Pack as described here.
  4. Run the Lisp Starter Pack and select the LISPBUILDER-* packages to install.
  5. Finally, load the LISPBUILDER libraries into the Lisp image. The libraries are now ready for use.

 

Mac OS-X Installation

In addition to downloading LISPBUILDER, you need to install the SDL framework available here. To use SDL you first need to compile the OS-X specific helper library located in lispbuilder-sdl/cocoahelper, just cd to this directory and type "make". Then before trying to run any SDL programs you need to load the cocoahelper package: 
(asdf:operate 'asdf:load-op :cocoahelper)
This creates an instance of NSApplication that serves as a bridge between SDL and Cocoa, similiar to that used by the Python project Pygame. If this is successful, you should see the icon for a generic OS-X ap appear in your dock. Many of the LISPBUILDER packages rely on one or more external dynamic linked libraries that are not included in the lispbuilder packages. These libraries must be installed prior to loading any of the LISPBUILDER packages. Additional information on the dependencies for a package can be found in the in the documentation for that package.
 

Linux Installation

The LISPBUILDER-SDL-* libraries can be downloaded and installed using ASDF-INSTALL. Many of the LISPBUILDER packages rely on one or more external dynamic linked libraries (.so) that are not included in the lispbuilder packages. These libraries must be installed prior to loading any of the LISPBUILDER packages. Use the package manager for your Linux distro to download and install these libraries. Additional information on the dependencies for a package can be found in the in the documentation for that package. For example the following will download, install and compile LISPBUILDER-SDL associated examples and all related dependencies on SBCL. 
	(require 'asdf-install)
	(asdf-install:install :lispbuilder-sdl-examples)
	(asdf:operate 'asdf:load-op :lispbuilder-sdl-examples)
NOTE: CFFI will attempt to load the .so libraries from the standard Linux .so library search path.
 

Useage

The following will load and run one of the examples from LISPBUILDER-SDL.
From the REPL, evaluate the following forms: 
	(asdf:operate 'asdf:load-op :lispbuilder-sdl-examples)
	(sdl-examples:recursive-rects)

 

Support & Mailing List

Questions answered and help given on the lispbuilder discussion list. Documentation for LISPBUILDER-SDL and related packages is available on the LISPBUILDER project page on Sourceforge. For additional information, look at the Lisp Gardeners page, and Application Builder page on the ALU's (Association of Lisp Users) wiki.
 

Contributors


 

References and Links

Hosted on SourceForge SourceForge.net Logo