author Sam Lantinga <>
Mon, 29 May 2006 05:08:33 +0000
changeset 1669 9857d21967bb
parent 1668 4da1ee79c9af
child 1676 e136f3ffdc1b
permissions -rw-r--r--
The test programs compile again. The dummy video driver is partially functional now.

    SDL - Simple DirectMedia Layer
    Copyright (C) 1997-2006 Sam Lantinga

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

    Sam Lantinga
#include "SDL_config.h"

/* Dummy SDL video driver implementation; this is just enough to make an
 *  SDL-based application THINK it's got a working video driver, for
 *  applications that call SDL_Init(SDL_INIT_VIDEO) when they don't need it,
 *  and also for use as a collection of stubs when porting SDL to a new
 *  platform for which you haven't yet written a valid video driver.
 * This is also a great way to determine bottlenecks: if you think that SDL
 *  is a performance problem for a given platform, enable this driver, and
 *  then see if your application runs faster without video overhead.
 * Initial work by Ryan C. Gordon ( A good portion
 *  of this was cut-and-pasted from Stephane Peter's work in the AAlib
 *  SDL video driver.  Renamed to "DUMMY" by Sam Lantinga.

#include "SDL_video.h"
#include "SDL_mouse.h"
#include "../SDL_sysvideo.h"
#include "../SDL_pixels_c.h"
#include "../../events/SDL_events_c.h"

#include "SDL_nullvideo.h"
#include "SDL_nullevents_c.h"
#include "SDL_nullmouse_c.h"

#define DUMMYVID_DRIVER_NAME "dummy"

/* Initialization/Query functions */
static int DUMMY_VideoInit(_THIS);
static int DUMMY_SetDisplayMode(_THIS, const SDL_DisplayMode * mode);
static void DUMMY_CreateWindowSurface(_THIS, SDL_Window * window,
                                      Uint32 flags);
static void DUMMY_UpdateWindowSurface(_THIS, SDL_Window * window,
                                      int numrects, SDL_Rect * rects);
static void DUMMY_VideoQuit(_THIS);

/* DUMMY driver bootstrap functions */

static int
    const char *envr = SDL_getenv("SDL_VIDEODRIVER");
    if ((envr) && (SDL_strcmp(envr, DUMMYVID_DRIVER_NAME) == 0)) {
        return (1);

    return (0);

static void
DUMMY_DeleteDevice(SDL_VideoDevice * device)

static SDL_VideoDevice *
DUMMY_CreateDevice(int devindex)
    SDL_VideoDevice *device;

    /* Initialize all variables that we clean on shutdown */
    device = (SDL_VideoDevice *) SDL_malloc(sizeof(SDL_VideoDevice));
    if (device) {
        SDL_memset(device, 0, (sizeof *device));
        device->hidden = (struct SDL_PrivateVideoData *)
            SDL_malloc((sizeof *device->hidden));
    if ((device == NULL) || (device->hidden == NULL)) {
        if (device) {
        return (0);
    SDL_memset(device->hidden, 0, (sizeof *device->hidden));

    /* Set the function pointers */
    device->VideoInit = DUMMY_VideoInit;
    device->SetDisplayMode = DUMMY_SetDisplayMode;
    device->CreateWindowSurface = DUMMY_CreateWindowSurface;
    device->UpdateWindowSurface = DUMMY_UpdateWindowSurface;
    device->VideoQuit = DUMMY_VideoQuit;
    device->InitOSKeymap = DUMMY_InitOSKeymap;
    device->PumpEvents = DUMMY_PumpEvents;

    device->free = DUMMY_DeleteDevice;

    return device;

VideoBootStrap DUMMY_bootstrap = {
    DUMMYVID_DRIVER_NAME, "SDL dummy video driver",
    DUMMY_Available, DUMMY_CreateDevice

    SDL_DisplayMode mode;


    SDL_AddDisplayMode(0, &mode);

    /* We're done! */
    return 0;

static int
DUMMY_SetDisplayMode(_THIS, const SDL_DisplayMode * mode)
    SDL_CurrentDisplay.current_mode = *mode;
    return 0;

static void
DUMMY_CreateWindowSurface(_THIS, SDL_Window * window, Uint32 flags)
    int bpp;
    Uint32 Rmask, Gmask, Bmask, Amask;

    SDL_PixelFormatEnumToMasks(SDL_GetCurrentDisplayMode()->format, &bpp,
                               &Rmask, &Gmask, &Bmask, &Amask);
    window->surface =
        SDL_CreateRGBSurface(flags, window->w, window->h, bpp, Rmask, Gmask,
                             Bmask, Amask);

static void
DUMMY_UpdateWindowSurface(_THIS, SDL_Window * window, int numrects,
                          SDL_Rect * rects)
    static int frame_number;
    if (SDL_getenv("SDL_VIDEO_DUMMY_SAVE_FRAMES")) {
        char file[128];
        SDL_snprintf(file, sizeof(file), "SDL_screen-%8.8d.bmp",
        SDL_SaveBMP(window->surface, file);

/* Note:  If we are terminated, this could be called in the middle of
   another SDL video routine -- notably UpdateRects.

/* vi: set ts=4 sw=4 expandtab: */