Short:    Version 1.2.3 of Amiga SDL audio/video library with OpenGL
Author:   Gabriele Greco
Uploader: gabriele.greco@aruba.it
Version:  1.2.3
Type:     dev/misc
Replaces: SDL-Amiga.lha

This is the porting of 1.2.3 version of SDL (the latest stable one)
to AmigaOS 68k/WOS and MorphOS.

All the bugs known of the past version have been corrected. And I've
added all the new SDL features.

This version of SDL needs Cybergraphx V3 (r69+) or CyberGraphX V4
and AHI v3+. It works also with P96, althrough there are still some color
problems with certain bitperpixel values.
Maybe it works also with CGXAga, but it's untested.

This version is available as linked library for SAS/C, GCC (68k & MorphOS),
STORMC 4 (68k & PPC-WOS). Every version except the MorphOS one is provided with
OpenGL support through StormMESA (HW acceleration supported). You should use the GL
version of the library only if your app needs OpenGL support.

Implemented:

- 8/16/24/32bit video modes, both fullscreen and windowed.
- CGX hardware surfaces (blitting acceleration, also in colorkey blitting)
- AHI audio (8/16 bit, with any audio format), always uses unit 0 for now.
- Thread & semaphores support through exec/execppc.
- Window resizing and backdrop windows
- Joystick/Joypad support.
- OpenGL (through StormMESA and Warp3D) (feature added by Glenn Hisdal)

To do:

- CDRom audio playing support

The SASC/GCC/Morphos libraries are distributed with debug enabled, to strip debug info 
simply add STRIPDEBUG argument to the linker and define a FAKE kprintf. Otherwise if you
want to see debug infos link with the included debug.lib/libdebug.a.

Installation:

1) SAS/C:
- copy 68klib/#?.lib sc:lib
- add the directory where SDL includes are stored to your makefile with IDIR=dir or
  copy includes to your include: assign (copy include/#? include:)
- Add to your link directive in the makefile "LIB lib:sdl.lib lib:debug.lib" for 
  nonGL apps and "LIB lib:sdlgl.lib lib:mesa.lib lib:debug.lib" for GL apps. 
- You can get rid by debug.lib if you define an empty kprintf() in your code.


2) GCC/68k:
- copy 68klib/#?.a gg:lib/
- place the SDL includes in gg:os-include or in a custom directory and add it to your
  include search path with -Idir.
- link with -lSDL -ldebug -lpthread (-lSDLgl -lGL -ldebug -lpthread for gl apps). 
  Pthread is required since ixemul libc is not multithread safe (you can omit it if
  you are using a single thread).
- you can both link it with or without ixemul, but libnix executables (-noixemul) has
  better performances

3) GCC/MorphOS:
- copy morphoslib/#?.a gg:lib/
- place the SDL includes in gg:os-include or in a custom directory and add it to your
  include search path with -Idir.
- link with -lSDL -ldebug (gl apps NOT supported).
- debug kprintf are disabled by default unless you have ggdebug.library (on aminet) in
  your libs directory, you can anyway build a fake kprintf and link without -ldebug.
- you can both link it with or without ixemul, but libnix executables (-noixemul) has
  better performances, also note that libnix is almost threadsafe while morphos ixemul
  is not, so you may have problems with ixemul multithread programs.

4) StormC
- Ask to Glen Hisdal (ghisdal@c2i.net), AFAIK the libraries are only compatible with StormC 4.

More info on my webpage (http://ggreco.interfree.it/sdl.html) or the SDL Amiga related
mailinglist: 
SDL-Amiga@yahoogroups.com


Source:

The source of SDL is available in a separate archive on my web page or in the official
source package at www.libsdl.org (get the CVS version if you have cvs installed).

You can find a lot of stuff that often compiles with a simple "make" on the
OFFICIAL libSDL website:

http://www.libsdl.org

This site includes lots of games, utility, docs about SDL and SDL programming,
with your contribution we will be able to port TONS of application to AmigaOS!

You can find some informations and download specific of the SDL amiga 
implementation at the following URL:

http://ggreco.interfree.it/sdl.html

You can also subscribe to the SDL-Amiga mailing list sending a mail to:

sdl-amiga-subscribe@yahoogroups.com

For info, support, bugfix and other feel free to mail me:

Gabriele Greco (gabriele.greco@aruba.it/gabrielegreco@tin.it)