home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue4 / SDL / gcc346 / !SDL / man / SDL_ConvertSurface.3 < prev    next >
Encoding:
Text File  |  2006-09-20  |  1.7 KB  |  53 lines

  1. <!-- manual page source format generated by PolyglotMan v3.0.8+X.Org, -->
  2. <!-- available at http://polyglotman.sourceforge.net/ -->
  3.  
  4. <html>
  5. <head>
  6. <title>"SDL_ConvertSurface"("3") manual page</title>
  7. </head>
  8. <body bgcolor='#efefef' text='black' link='blue' vlink='#551A8B' alink='red'>
  9. <a href='#toc'>Table of Contents</a><p>
  10.  
  11. <h2><a name='sect0' href='#toc0'>Name</a></h2>
  12. SDL_ConvertSurface- Converts a surface to the same format as another
  13. surface. 
  14. <h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
  15. <p>
  16. <b>#include "SDL/SDL.h" <p>
  17. </b><b>SDL_Surface *<b>SDL_ConvertSurface</b></b>(<b>SDL_Surface
  18. *src, SDL_PixelFormat *fmt, Uint32 flags</b>); 
  19. <h2><a name='sect2' href='#toc2'>Description</a></h2>
  20. <p>
  21. Creates a new surface
  22. of the specified format, and then copies and maps the given surface to
  23. it. If this function fails, it returns <b>NULL</b>. <p>
  24. The <b>flags</b> parameter is passed
  25. to <i><b>SDL_CreateRGBSurface</b></i> and has those semantics. <p>
  26. This function is used internally
  27. by <i><b>SDL_DisplayFormat</b></i>. <p>
  28. This function can only be called after SDL_Init. 
  29. <h2><a name='sect3' href='#toc3'>Return
  30. Value</a></h2>
  31. <p>
  32. Returns either a pointer to the new surface, or <b>NULL</b> on error. 
  33. <h2><a name='sect4' href='#toc4'>See
  34. Also</a></h2>
  35. <p>
  36. <i><b>SDL_CreateRGBSurface</b></i>, <i><b>SDL_DisplayFormat</b></i>, <i><b>SDL_PixelFormat</b></i>, <i><b>SDL_Surface</b></i>
  37.  
  38. <!--
  39.   
  40.  <p>
  41.  
  42. <hr><p>
  43. <a name='toc'><b>Table of Contents</b></a><p>
  44. <ul>
  45. <li><a name='toc0' href='#sect0'>Name</a></li>
  46. <li><a name='toc1' href='#sect1'>Synopsis</a></li>
  47. <li><a name='toc2' href='#sect2'>Description</a></li>
  48. <li><a name='toc3' href='#sect3'>Return Value</a></li>
  49. <li><a name='toc4' href='#sect4'>See Also</a></li>
  50. </ul>
  51. </body>
  52. </html>
  53.