home *** CD-ROM | disk | FTP | other *** search
/ Chip 2002 February / chip_20022115.iso / amiga / chiputil / sdl-amiga.rea < prev    next >
Text File  |  2002-01-07  |  4KB  |  107 lines
  1. Short:    SDL audio/video library 1.2.3 for Amiga (68k/WOS/MorphOS)
  2. Author:   Gabriele Greco
  3. Uploader: gabriele.greco@aruba.it
  4. Version:  1.2.3
  5. Type:     dev/misc
  6. Replaces: SDL-Amiga.lha
  7.  
  8. This is the porting of 1.2.3 version of SDL (the latest stable one)
  9. to AmigaOS 68k/WOS and MorphOS.
  10.  
  11. All the bugs known of the past version have been corrected. And I've
  12. added all the new SDL features.
  13.  
  14. This version of SDL needs Cybergraphx V3 (r69+) or CyberGraphX V4
  15. and AHI v3+. It works also with P96, althrough there are still some color
  16. problems with certain bitperpixel values.
  17. Maybe it works also with CGXAga, but it's untested.
  18.  
  19. This version is available as linked library for SAS/C, GCC (68k & MorphOS),
  20. STORMC 4 (68k & PPC-WOS). Every version except the MorphOS one is provided with
  21. OpenGL support through StormMESA (HW acceleration supported). You should use the GL
  22. version of the library only if your app needs OpenGL support.
  23.  
  24. Implemented:
  25.  
  26. - 8/16/24/32bit video modes, both fullscreen and windowed.
  27. - CGX hardware surfaces (blitting acceleration, also in colorkey blitting)
  28. - AHI audio (8/16 bit, with any audio format), always uses unit 0 for now.
  29. - Thread & semaphores support through exec/execppc.
  30. - Window resizing and backdrop windows
  31. - Joystick/Joypad support.
  32. - OpenGL (through StormMESA and Warp3D) (feature added by Glenn Hisdal)
  33.  
  34. To do:
  35.  
  36. - CDRom audio playing support
  37.  
  38. The SASC/GCC/Morphos libraries are distributed with debug enabled, to strip debug info 
  39. simply add STRIPDEBUG argument to the linker and define a FAKE kprintf. Otherwise if you
  40. want to see debug infos link with the included debug.lib/libdebug.a.
  41.  
  42. Installation:
  43.  
  44. 1) SAS/C:
  45. - copy 68klib/#?.lib sc:lib
  46. - add the directory where SDL includes are stored to your makefile with IDIR=dir or
  47.   copy includes to your include: assign (copy include/#? include:)
  48. - Add to your link directive in the makefile "LIB lib:sdl.lib lib:debug.lib" for 
  49.   nonGL apps and "LIB lib:sdlgl.lib lib:mesa.lib lib:debug.lib" for GL apps. 
  50. - You can get rid by debug.lib if you define an empty kprintf() in your code.
  51.  
  52.  
  53. 2) GCC/68k:
  54. - copy 68klib/#?.a gg:lib/
  55. - place the SDL includes in gg:os-include or in a custom directory and add it to your
  56.   include search path with -Idir.
  57. - link with -lSDL -ldebug -lpthread (-lSDLgl -lGL -ldebug -lpthread for gl apps). 
  58.   Pthread is required since ixemul libc is not multithread safe (you can omit it if
  59.   you are using a single thread).
  60. - you can both link it with or without ixemul, but libnix executables (-noixemul) has
  61.   better performances
  62.  
  63. 3) GCC/MorphOS:
  64. - copy morphoslib/#?.a gg:lib/
  65. - place the SDL includes in gg:os-include or in a custom directory and add it to your
  66.   include search path with -Idir.
  67. - link with -lSDL -ldebug (gl apps NOT supported).
  68. - debug kprintf are disabled by default unless you have ggdebug.library (on aminet) in
  69.   your libs directory, you can anyway build a fake kprintf and link without -ldebug.
  70. - you can both link it with or without ixemul, but libnix executables (-noixemul) has
  71.   better performances, also note that libnix is almost threadsafe while morphos ixemul
  72.   is not, so you may have problems with ixemul multithread programs.
  73.  
  74. 4) StormC
  75. - Ask to Glen Hisdal (ghisdal@c2i.net), AFAIK the libraries are only compatible with StormC 4.
  76.  
  77. More info on my webpage (http://ggreco.interfree.it/sdl.html) or the SDL Amiga related
  78. mailinglist: 
  79. SDL-Amiga@yahoogroups.com
  80.  
  81.  
  82. Source:
  83.  
  84. The source of SDL is available in a separate archive on my web page or in the official
  85. source package at www.libsdl.org (get the CVS version if you have cvs installed).
  86.  
  87. You can find a lot of stuff that often compiles with a simple "make" on the
  88. OFFICIAL libSDL website:
  89.  
  90. http://www.libsdl.org
  91.  
  92. This site includes lots of games, utility, docs about SDL and SDL programming,
  93. with your contribution we will be able to port TONS of application to AmigaOS!
  94.  
  95. You can find some informations and download specific of the SDL amiga 
  96. implementation at the following URL:
  97.  
  98. http://ggreco.interfree.it/sdl.html
  99.  
  100. You can also subscribe to the SDL-Amiga mailing list sending a mail to:
  101.  
  102. sdl-amiga-subscribe@yahoogroups.com
  103.  
  104. For info, support, bugfix and other feel free to mail me:
  105.  
  106. Gabriele Greco (gabriele.greco@aruba.it/gabrielegreco@tin.it)
  107.