view docs/man3/SDL_ConvertSurface.3 @ 1122:e253d5448fce

From Patrice Mandin: "Just a request about test subdirectory: the autotools files (config.guess, config.sub, etc...) are a bit outdated, and I have to update them for my cross-compilation party. So it would be nice to have these updated. ... Just removing these files works, because then configure will use those of SDL's topdir. Could someone else check this, just to be sure? i.e. remove config.guess, config.sub, install-sh and mkinstalldirs from test subdir." I tested on Linux and MacOSX...seems to be safe, so I'm nuking the files. --ryan.
author Ryan C. Gordon <icculus@icculus.org>
date Sat, 20 Aug 2005 21:39:06 +0000
parents e5bc29de3f0a
children 546f7c1eb755
line wrap: on
line source

.TH "SDL_ConvertSurface" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference" 
.SH "NAME"
SDL_ConvertSurface\- Converts a surface to the same format as another surface\&.
.SH "SYNOPSIS"
.PP
\fB#include "SDL/SDL\&.h"
.sp
\fBSDL_Surface *\fBSDL_ConvertSurface\fP\fR(\fBSDL_Surface *src, SDL_PixelFormat *fmt, Uint32 flags\fR);
.SH "DESCRIPTION"
.PP
Creates a new surface of the specified format, and then copies and maps the given surface to it\&. If this function fails, it returns \fBNULL\fP\&.
.PP
The \fBflags\fR parameter is passed to \fI\fBSDL_CreateRGBSurface\fP\fR and has those semantics\&.
.PP
This function is used internally by \fI\fBSDL_DisplayFormat\fP\fR\&.
.PP
This function can only be called after SDL_Init\&.
.SH "RETURN VALUE"
.PP
Returns either a pointer to the new surface, or \fBNULL\fP on error\&.
.SH "SEE ALSO"
.PP
\fI\fBSDL_CreateRGBSurface\fP\fR, \fI\fBSDL_DisplayFormat\fP\fR, \fI\fBSDL_PixelFormat\fR\fR, \fI\fBSDL_Surface\fR\fR
...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01