Contents

Introduction
Included Files
Running the Example Programs
Postscripts
 

Introduction

This file contains the Linux version of my SDL wrappers for Euphoria.  SDL is a free library for cross platform development of graphics and multimedia programs.  The SDL API includes functions for graphics, sound, CD audio, timing, controllers and events.  Some very high quality commercial games and applications have been written using SDL, as well as a number of excellent freeware/shareware programs.  The SDL_wrap file makes the SDL functions accessible from Euphoria.  The Linux version of the SDL_wrap file is based almost entirely my previous Windows version with only minor changes.  The Linux version of the SDL/Euphoria project is my first attempt at programming for Linux and should be treated as a work in progress.

SDL was written by Sam Lantinga and is distributed under the GNU Lesser Public License.
The official SDL website http://www.libsdl.org/ contains more information.
If you use SDL_Wrap in a Euphoria program please credit me (Mark K. Akita) somewhere in the docs or help screen.
 

Included Files

The SDL_Wrap tar file contains the following:

lib-SDL.1.2.so.0.0.2- The SDL library
Sdl_Wrap.e - The Euphoria SDL wrapper
sdldex01.ex - Demo program 1: Makes kaleidoscopic pictures
sdldex02.ex - Demo program 2: Galton box simulation
sdldex03.ex - Demo program 3: The swirling arcs
sdldex05.ex - Demo program 5: Scrolling map demo
sdldex06.ex - Demo program 6: Controller input demo
Blur.ex  - A sample motion blur program
Bounder_SDL.ex - Displays an orbiting pattern on a starry background
Ellipse_SDL.ex - Displays a swirling colored pattern of ellipses
Fireworx.ex - A simple pyrotechnics display
Life_SDL.ex - John Conway's classic cellular automata example
Mathpic_SDL.ex - Draw geometic patterns
Plasma.ex - Colorful swirling patterns
Readme.HTML - This document in HTML format
Readme.TXT - This document in plain text format
Bitmaps - A folder containing the images used
 

Running the Example Programs

For all of the demo programs, press the Esc key or click the left mouse button anywhere on the demo screen to exit.

Blur - The blue guitar image will follow your mouse pointer on screen and leave a visible trail.
Plasma - The Plasma demo displays colored arcs around the center of the screen that vary randomly in intensity.
Bounder_SDL - Originally written using the Neil graphics library.  This version replaces the geometric background with a tiled star field and will display pastel balls, neon cubes, or rainbow rings orbiting the screen center.  Press the right mouse button to change patterns.
Ellipse_SDL - Originally written using the Open PTC library.  Display a changing rainbow colored ellipse pattern over a dark background.
Fireworx - This program generates a continuous random fireworks display.
Life_SDL - Originally written using the Open PTC library.  Based on John Conway's famous game of life mathematical simulation.
Mathpic_SDL - Displays randomly generated color pattern, then repeats.  This is an SDL version of one of the first Euphoria graphics programs I wrote.
sdlex05  - Use the arrow keys to scroll the map.
sdlex06 - Use the arrow keys to move the "Keys" object and the mouse or joystick (if attached) to move the others.

Postscripts

The Linux version of  SDL_Wrap was developed on an AMD K6-3 300mhz computer, using SuSE Linux 7.3 and the KDE deskstop.  I don't have access to other Linux systems so I wasn't able to test the library extensively.  I'm currently working on a Linux version of the SDL_Mixer Euphoria library as well as other SDL/Euphoria projects for Windows.
 

Send comments & feedback to mkakita@earthlink.net