These files are the OpenGL ES render driver. You should be able to use them on any platform that supports OpenGL ES -- not just iPhone. The driver is based off the OpenGL render driver. There are a few differences between OpenGL and OpenGL ES that present difficulties for this driver: - OpenGL ES does NOT support many pixel formats (for example, no GL_BGR). Also, when using texture functions format and internalFormat must be the same -- this means 32 bit packed formats like SDL_PIXELFORMAT_BGR888 cannot be automatically converted to GL_RGB (which is 24bpp). - OpenGL ES doesn't have GL_PACK_ROW_LENGTH, which means data must be reformatted before uploading changes to dirty rects. This change has been added. - OpenGL ES doesn't support paletted textures, though there is an extension. I'm looking into this. Some other notable differences: - OpenGL ES has an extension called GL_OES_draw_texture which allows for quicker 2D sprite-type drawing. I use this in GL_RenderCopy when it is available. The iPhone supports the extension, but the iPhone Simulator does not (presently). - No glBegin() / glEnd() and no GL_QUADS! I'm using glDrawArrays with GL_TRIANGLE_STRIP instead!

.TH "SDL_Init" "3" "Tue 11 Sep 2001, 23:00" "SDL" "SDL API Reference" 
.SH "NAME"
SDL_Init \- Initializes SDL
.SH "SYNOPSIS"
.PP
\fB#include "SDL\&.h"
.sp
\fBint \fBSDL_Init\fP\fR(\fBUint32 flags\fR);
.SH "DESCRIPTION"
.PP
Initializes SDL\&. This should be called before all other SDL functions\&. The \fBflags\fR parameter specifies what part(s) of SDL to initialize\&.
.TP 20
\fBSDL_INIT_TIMER\fP
Initializes the \fItimer\fR subsystem\&.
.TP 20
\fBSDL_INIT_AUDIO\fP
Initializes the \fIaudio\fR subsystem\&.
.TP 20
\fBSDL_INIT_VIDEO\fP
Initializes the \fIvideo\fR subsystem\&.
.TP 20
\fBSDL_INIT_CDROM\fP
Initializes the \fIcdrom\fR subsystem\&.
.TP 20
\fBSDL_INIT_JOYSTICK\fP
Initializes the \fIjoystick\fR subsystem\&.
.TP 20
\fBSDL_INIT_EVERYTHING\fP
Initialize all of the above\&.
.TP 20
\fBSDL_INIT_NOPARACHUTE\fP
Prevents SDL from catching fatal signals\&.
.TP 20
\fBSDL_INIT_EVENTTHREAD\fP
.SH "RETURN VALUE"
.PP
Returns \fB-1\fR on an error or \fB0\fR on success\&.
.SH "SEE ALSO"
.PP
\fI\fBSDL_Quit\fP\fR, \fI\fBSDL_InitSubSystem\fP\fR
...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:00