* Porting To A New Platform | |
The first thing you have to do when porting to a new platform, is look at | |
include/SDL_platform.h and create an entry there for your operating system. | |
The standard format is __PLATFORM__, where PLATFORM is the name of the OS. | |
Ideally SDL_platform.h will be able to auto-detect the system it's building | |
on based on C preprocessor symbols. | |
There are two basic ways of building SDL at the moment: | |
1. The "UNIX" way: ./configure; make; make install | |
If you have a GNUish system, then you might try this. Edit configure.in, | |
take a look at the large section labelled: | |
"Set up the configuration based on the target platform!" | |
Add a section for your platform, and then re-run autogen.sh and build! | |
2. Using an IDE: | |
If you're using an IDE or other non-configure build system, you'll probably | |
want to create a custom SDL_config.h for your platform. Edit SDL_config.h, | |
add a section for your platform, and create a custom SDL_config_{platform}.h, | |
based on SDL_config.h.minimal and SDL_config.h.in | |
Add the top level include directory to the header search path, and then add | |
the following sources to the project: | |
src/*.c | |
src/atomic/*.c | |
src/audio/*.c | |
src/cpuinfo/*.c | |
src/events/*.c | |
src/file/*.c | |
src/haptic/*.c | |
src/joystick/*.c | |
src/power/*.c | |
src/render/*.c | |
src/stdlib/*.c | |
src/thread/*.c | |
src/timer/*.c | |
src/video/*.c | |
src/audio/disk/*.c | |
src/audio/dummy/*.c | |
src/video/dummy/*.c | |
src/haptic/dummy/*.c | |
src/joystick/dummy/*.c | |
src/main/dummy/*.c | |
src/thread/generic/*.c | |
src/timer/dummy/*.c | |
src/loadso/dummy/*.c | |
Once you have a working library without any drivers, you can go back to each | |
of the major subsystems and start implementing drivers for your platform. | |
If you have any questions, don't hesitate to ask on the SDL mailing list: | |
http://www.libsdl.org/mailing-list.php | |
Enjoy! | |
Sam Lantinga (slouken@libsdl.org) | |