Logo by Nickman (anonymous IP: 3.238.82.77,2251) | ||||||||||||||
| ||||||||||||||
Audio (343) Datatype (51) Demo (203) Development (600) Document (24) Driver (97) Emulation (148) Game (1008) Graphics (500) Library (118) Network (233) Office (66) Utility (931) Video (69) Total files: 4391 Full index file Recent index file
Amigans.net OpenAmiga Aminet IntuitionBase
Support the site
|
================================================================================ SDL 2 requirements ================================================================================ AmigaOS 4.1 Final Edition MiniGL (optional from SDL2 point of view, but OpenGL context might still be required by the SDL2 application) OpenGL ES 2.0 (optional) ================================================================================ Installation ================================================================================ There is an installer script that can be used to install shared objects, prefs program and the SDK. Many current SDL2 applications are linked statically but there are some apps like RebelSDL (Hollywood) that use SDL2 as a shared object. Installer script creates soft link from libSDL2.so to the latest libSDL2-2.x.so file. SDL2 version numbering changed after 2.0.22 release: next stable release had version 2.24.0. ================================================================================ Building SDL 2 library ================================================================================ # non-debug variant gmake -f Makefile.amigaos4 # with serial debug prints gmake -f Makefile.amigaos4 debug At the moment configure script and CMake are not supported. ================================================================================ Using SDL 2 in your projects ================================================================================ #include "SDL2/SDL.h" ...do magical SDL2 things... gcc helloworld.c -use-dynld -lSDL2 ================================================================================ About SDL_Renderers ================================================================================ A renderer is a subsystem that can do 2D drawing. There are 4 renderers: software, OpenGL, OpenGL ES 2.0 and compositing. Software renderer is always available. Pixels are plotted by the CPU so this is usually a slow option. OpenGL renderer uses MiniGL (and Warp3D) for accelerated drawing. Drawing is done in immediate mode. This should be fairly fast if textures are static. OpenGL ES 2.0 renderer uses ogles2.library (and Warp3D Nova). Compositing renderer uses AmigaOS 4 graphics.library for accelerated drawing. However, blended lines and points are not accelerated since compositing doesn't support them. Compositing renderer supports only 32-bit bitmaps. If (Workbench) screen mode is 16-bit, color format conversion can slow things down. It's possible to select the preferred renderer before its creation, like this: SDL_SetHint(SDL_HINT_RENDER_DRIVER, name); where name is "software", "opengl" or "compositing". It's possible to enable VSYNC with: SDL_SetHint(SDL_HINT_RENDER_VSYNC, "1"); There is a benchmark tool called sdl2benchmark which was written to test available renderers. ================================================================================ About ENV variables ================================================================================ Advanced users may use ENV variables to control some things in SDL2. Some variables supported by the SDL_Renderer subsystem: Batch drawing: setenv SDL_RENDER_BATCHING 1 # Enable setenv SDL_RENDER_BATCHING 0 # Disable Driver selection: setenv SDL_RENDER_DRIVER "software" setenv SDL_RENDER_DRIVER "compositing" setenv SDL_RENDER_DRIVER "opengl" setenv SDL_RENDER_DRIVER "opengles2" VSYNC: setenv SDL_RENDER_VSYNC 1 # Enable setenv SDL_RENDER_VSYNC 0 # Disable It must be noted that these variables apply only to those applications that actually use the SDL_Renderer subsystem, and not 3D games. Screensaver control: setenv SDL_VIDEO_ALLOW_SCREENSAVER 1 # Enable setenv SDL_VIDEO_ALLOW_SCREENSAVER 0 # Disable Please check also SDL2 preferences program. ================================================================================ About OpenGL ================================================================================ If you want to draw accelerated 3D graphics or use explicitly OpenGL functions, you have to create an OpenGL context, instead of an SDL_Renderer. If you would like to create an OpenGL ES 2.0 context, you need to specify the version before window creation, for example: SDL_GL_SetAttribute(SDL_GL_CONTEXT_PROFILE_MASK, SDL_GL_CONTEXT_PROFILE_ES); SDL_GL_SetAttribute(SDL_GL_CONTEXT_MAJOR_VERSION, 2); SDL_GL_SetAttribute(SDL_GL_CONTEXT_MINOR_VERSION, 0); MiniGL context can be created using major version 1 and minor version 3. This is also the default setup. SDL_GL_SetAttribute(SDL_GL_CONTEXT_MAJOR_VERSION, 1); SDL_GL_SetAttribute(SDL_GL_CONTEXT_MINOR_VERSION, 3); ================================================================================ About Joysticks ================================================================================ Joysticks that are compatible with AmigaInput can be used with SDL2. In addition to legacy joystick API, SDL supports new game controller API which uses a predefined database to map joystick axes and buttons. At the moment game controller database contains the following entries: - Speedlink Competition Pro - Ewent Joypad EW3170 - PS2 Joystick (USB adaptor) - SHARK 91230 Joystick - MAGIC-NS - Wireless Controller - 8Bitdo SN30 Pro - Thrustmaster dual analog 3.2 - XEOX Gamepad SL-6556-BK - Strike2 Joystick - GeeekPi_A gamepad - Logitech Cordless RumblePad 2 - Logitech RumblePad 2 USB - Logitech(R) Precision(TM) Gamepad - Logitech Dual Action - MAYFLASH Arcade Fightstick F300 - Game Controller for Android - 2In1 USB Joystick Joysticks can be tested using testjoystick tool. New game controller mappings can be generated using controllermap tool. New mappings can be then added to the game controller database. ================================================================================ WinUAE ================================================================================ Because WinUAE doesn't support hardware-accelerated compositing or 3D, you need to install the following software: - http://os4depot.net/index.php?function=showfile&file=graphics/misc/patchcomposit etags.lha - http://os4depot.net/index.php?function=showfile&file=library/graphics/wazp3d.lha ================================================================================ Tips ================================================================================ If you are already familiar with SDL 1.2, or porting SDL 1.2 code, it's worth checking the migration guide at: https://wiki.libsdl.org/MigrationGuide Always check the return values of functions and in error case you can get more information using SDL_GetError() function! ================================================================================ Limitations ================================================================================ Altivec support is disabled. It should be possible to enable in private builds but it hasn't been tested so far. Unsupported subsystems include Haptic and Power. There is no Vulkan backend for AmigaOS either. OpenGL renderer doesn't support render targets and blend modes "ADD" or "MOD". This is due to missing features in MiniGL. Compositing renderer doesn't support color modulation for triangle geometry. Use "software" or "opengles2" driver if you need it. ================================================================================ Project page and bug tracker ================================================================================ https://github.com/AmigaPorts/SDL |
Copyright © 2004-2024 by Björn Hagström All Rights Reserved |