SDL获得屏幕属性及实现分析

[时间：2017-05] [状态：Open]

[关键词：sdl2，屏幕分辨率，显示区域，多媒体渲染，窗口，sdl2源码分析]

0 引言

本文的主要目标在于使用SDL2获得屏幕相关的属性，比如分辨率、屏幕个数以及屏幕可用区域的范围。

通常情况下，有过图形界面编程经验的人都知道桌面系统的构成，屏幕分辨率是指的整个屏幕区域的宽高，而通常屏幕区域有一些系统的任务栏或者菜单栏；举个例子，windows下的任务栏一般位于下面，并且通常非全屏窗口是不能占用任务栏的。

1 获得屏幕个数

SDL2中提供了获得屏幕个数的接口SDL_GetNumVideoDisplays，具体建议参考sdl2-wiki。

当然屏幕还有其他属性，比如显示模式等，可以通过SDL_GetNumDisplayModes和SDL_GetDisplayMode获得SDL_DisplayMode的结构，其中包括显示格式（YUV、RGB等）、宽高、刷新率等。

2 每个屏幕的分辨率

SDL_GetDisplayBounds可以获得指定屏幕的显示区域，可以通过显示区域获取屏幕分辨率。

3 获取实际显示区域的大小

SDL_GetDisplayUsableBounds返回的是实际可用显示区域的大小，这个通常比屏幕分辨率小。

4 SDL2内部实现的原理分析

这里以SDL_GetDisplayBounds为例说明，如果读者对其他函数感兴趣，可以查看sdl2代码。

int SDL_GetDisplayBounds(int displayIndex, SDL_Rect * rect)

{

    CHECK_DISPLAY_INDEX(displayIndex, -1);

    if (rect) {

        SDL_VideoDisplay *display = &_this->displays[displayIndex];

        if (_this->GetDisplayBounds) {

            if (_this->GetDisplayBounds(_this, display, rect) == 0) {

                return 0;

            }

        }

        /* Assume that the displays are left to right */

        if (displayIndex == 0) {

            rect->x = 0;

            rect->y = 0;

        } else {

            SDL_GetDisplayBounds(displayIndex-1, rect);

            rect->x += rect->w;

        }

        rect->w = display->current_mode.w;

        rect->h = display->current_mode.h;

    }

    return 0;  /* !!! FIXME: should this be an error if (rect==NULL) ? */

}

很明显这个函数直接调用了SDL_VideoDevice->GetDisplayBounds函数，那么我们找一个实现版本看看，比如windows下的，代码如下：

static SDL_VideoDevice * WIN_CreateDevice(int devindex)

{

	// ...

	device->GetDisplayBounds = WIN_GetDisplayBounds;

	// ...

}

这个实现被重定向到WIN_GetDisplayBounds函数中，代码如下：

int

WIN_GetDisplayBounds(_THIS, SDL_VideoDisplay * display, SDL_Rect * rect)

{

    SDL_DisplayModeData *data = (SDL_DisplayModeData *) display->current_mode.driverdata;

    rect->x = (int)SDL_ceil(data->DeviceMode.dmPosition.x * data->ScaleX);

    rect->y = (int)SDL_ceil(data->DeviceMode.dmPosition.y * data->ScaleY);

    rect->w = (int)SDL_ceil(data->DeviceMode.dmPelsWidth * data->ScaleX);

    rect->h = (int)SDL_ceil(data->DeviceMode.dmPelsHeight * data->ScaleY);

    return 0;

}

实现比较简单，直接从display->current_mode中获得数据。那么这个mode在哪里赋值的呢？

在SDL_windowsvideo.c中查找下，发下如下调用：

static SDL_bool WIN_AddDisplay(_THIS, LPTSTR DeviceName)

{

    SDL_VideoDisplay display;

    SDL_DisplayData *displaydata;

    SDL_DisplayMode mode;

    DISPLAY_DEVICE device;

    if (!WIN_GetDisplayMode(_this, DeviceName, ENUM_CURRENT_SETTINGS, &mode)) {

        return SDL_FALSE;

    }

    displaydata = (SDL_DisplayData *) SDL_malloc(sizeof(*displaydata));

    if (!displaydata) {

        return SDL_FALSE;

    }

    SDL_memcpy(displaydata->DeviceName, DeviceName,

               sizeof(displaydata->DeviceName));

    SDL_zero(display);

    device.cb = sizeof(device);

    if (EnumDisplayDevices(DeviceName, 0, &device, 0)) {

        display.name = WIN_StringToUTF8(device.DeviceString);

    }

    display.desktop_mode = mode;

    display.current_mode = mode;

    display.driverdata = displaydata;

    SDL_AddVideoDisplay(&display);

    SDL_free(display.name);

    return SDL_TRUE;

}

明显这是从EnumDisplayDevices中获取。

至此所有实现逻辑基本理清。

5 小结

本文主要整理我近期遇到的SDL2关于窗口和屏幕属性获取的逻辑，同时分析了SDL_GetDisplayBounds在windows上的实现逻辑。

秒客网