| 1 | /* Function prototypes */ |
|---|
| 2 | |
|---|
| 3 | /** |
|---|
| 4 | * @name Video Init and Quit |
|---|
| 5 | * These functions are used internally, and should not be used unless you |
|---|
| 6 | * have a specific need to specify the video driver you want to use. |
|---|
| 7 | * You should normally use SDL_Init() or SDL_InitSubSystem(). |
|---|
| 8 | */ |
|---|
| 9 | /*@{*/ |
|---|
| 10 | /** |
|---|
| 11 | * Initializes the video subsystem. Sets up a connection |
|---|
| 12 | * to the window manager, etc, and determines the current video mode and |
|---|
| 13 | * pixel format, but does not initialize a window or graphics mode. |
|---|
| 14 | * Note that event handling is activated by this routine. |
|---|
| 15 | * |
|---|
| 16 | * If you use both sound and video in your application, you need to call |
|---|
| 17 | * SDL_Init() before opening the sound device, otherwise under Win32 DirectX, |
|---|
| 18 | * you won't be able to set full-screen display modes. |
|---|
| 19 | */ |
|---|
| 20 | extern DECLSPEC int SDLCALL SDL_VideoInit(const char *driver_name, Uint32 flags); |
|---|
| 21 | extern DECLSPEC void SDLCALL SDL_VideoQuit(void); |
|---|
| 22 | /*@}*/ |
|---|
| 23 | |
|---|
| 24 | /** |
|---|
| 25 | * This function fills the given character buffer with the name of the |
|---|
| 26 | * video driver, and returns a pointer to it if the video driver has |
|---|
| 27 | * been initialized. It returns NULL if no driver has been initialized. |
|---|
| 28 | */ |
|---|
| 29 | extern DECLSPEC char * SDLCALL SDL_VideoDriverName(char *namebuf, int maxlen); |
|---|
| 30 | |
|---|
| 31 | /** |
|---|
| 32 | * This function returns a pointer to the current display surface. |
|---|
| 33 | * If SDL is doing format conversion on the display surface, this |
|---|
| 34 | * function returns the publicly visible surface, not the real video |
|---|
| 35 | * surface. |
|---|
| 36 | */ |
|---|
| 37 | extern DECLSPEC SDL_Surface * SDLCALL SDL_GetVideoSurface(void); |
|---|
| 38 | |
|---|
| 39 | /** |
|---|
| 40 | * This function returns a read-only pointer to information about the |
|---|
| 41 | * video hardware. If this is called before SDL_SetVideoMode(), the 'vfmt' |
|---|
| 42 | * member of the returned structure will contain the pixel format of the |
|---|
| 43 | * "best" video mode. |
|---|
| 44 | */ |
|---|
| 45 | extern DECLSPEC const SDL_VideoInfo * SDLCALL SDL_GetVideoInfo(void); |
|---|
| 46 | |
|---|
| 47 | /** |
|---|
| 48 | * Check to see if a particular video mode is supported. |
|---|
| 49 | * It returns 0 if the requested mode is not supported under any bit depth, |
|---|
| 50 | * or returns the bits-per-pixel of the closest available mode with the |
|---|
| 51 | * given width and height. If this bits-per-pixel is different from the |
|---|
| 52 | * one used when setting the video mode, SDL_SetVideoMode() will succeed, |
|---|
| 53 | * but will emulate the requested bits-per-pixel with a shadow surface. |
|---|
| 54 | * |
|---|
| 55 | * The arguments to SDL_VideoModeOK() are the same ones you would pass to |
|---|
| 56 | * SDL_SetVideoMode() |
|---|
| 57 | */ |
|---|
| 58 | extern DECLSPEC int SDLCALL SDL_VideoModeOK(int width, int height, int bpp, Uint32 flags); |
|---|
