среда, 28 декабря 2011 г.

Установка полноэкранного режима (Fullscreen/Windowed modes)

Это мой первый блог и здесь я хочу описать, как можно установить видео режим в приложении. Тема довольно избитая, но все же вопросы по ней возникают у многих начинающих программистов. Речь пойдет о С++, хотя для других языков принцип ничем не отличается. Варианта два:
- установка режима средствами DirectX;
- установка режима средствами WinAPI.
Рассмотрим второй случай.
Все, что нужно, это EnumDisplaySettings и ChangeDisplaySettings.

BOOL EnumDisplaySettings(
__in LPCTSTR lpszDeviceName,
__in DWORD iModeNum,
__out DEVMODE *lpDevMode
);

LONG ChangeDisplaySettings(
__in DEVMODE *lpDevMode,
__in DWORD dwflags
);
Первая нам понадобиться, чтобы получить список доступных видео режимов, а вторая для установки видео режима.

На высоком уровне нам понадобится функция для смены видео режима, принимающая на вход ширину, высоту и глубину, а так же функции для быстрого переключения между desktop-режимом и установленным новым режимом (для переключения по Alt+Tab или свертке/восстановлении окна). Рассмотрим следующий класс:

class CCDS
{
public:
      CCDS();
      virtual ~CCDS();

      // Функция устанавливает видео режим. Если параметр bpp установлен в 0,
      // то устанавливается режим с максимальным bpp
      bool        changeDisplaySettings( unsigned width, unsigned height, unsigned bpp=0 );

      // Функция восстанавливает настройки режима рабочего стола
      void        restoreDesktopSettings();

      // Функция восстанавливает настройки выбранного ранее режима
      void        restoreDisplaySettings();

      // Функция возвращает состояние - был ли видео режим изменен
      bool        isModeChanged                      () const { return modeChanged != &desktopMode; }

      unsigned    getWidth                () const { return modeChanged->dmPelsWidth; }
      unsigned    getHeight               () const { return modeChanged->dmPelsHeight; }
      unsigned    getBitsPerPel     () const { return modeChanged->dmBitsPerPel; }
      unsigned    getFrequency      () const { return modeChanged->dmDisplayFrequency; }

      bool        getModeDescription      ( unsigned modeNum, unsigned & width, unsigned & height ) const;

private:
      DEVMODE     desktopMode;
      DEVMODE     displayMode;
      DEVMODE     *modeChanged;

      // Функция выбирает подходящий видео режим. Если параметр bpp установлен в 0,
      // то выбирается режим с максимальным bpp
      DWORD chooseAppropriateMode( unsigned width, unsigned height, unsigned bpp=0 );
};
  
 
Desktop-режим можно получить в конструкторе класса следующим образом:

CCDS::CCDS()
      : modeChanged(&desktopMode)
{
      memset( &desktopMode, 0, sizeof( desktopMode ) );
      desktopMode.dmSize = sizeof( desktopMode );
      if( !EnumDisplaySettings( NULL, ENUM_CURRENT_SETTINGS, &desktopMode ) )
            output( "Can't get desktop settings\n" );
}

Выборку режима производит следующий нехитрый метод:

DWORD CCDS::chooseAppropriateMode( unsigned width, unsigned height, unsigned bpp ) {
      DEVMODE     dm;
      DWORD mode = -1;
      DWORD maxBpp = -1;
      DWORD maxFreq = -1;

      while (1) {
            for ( DWORD modeNum = 0 ; ; modeNum++ ) {
                  if (!::EnumDisplaySettings( NULL, modeNum, &dm )) {
                        break;
                  }
                  if ( dm.dmPelsWidth == width && dm.dmPelsHeight == height ) {
                        if ( bpp == 0 ) {
                             if ( (int)maxBpp < (int)dm.dmBitsPerPel ) {
                                   maxBpp = dm.dmBitsPerPel;
                                   mode = modeNum;         // remember current mode
                             }
                        }
                        else if ( bpp == dm.dmBitsPerPel ) {
                             if ( (int)maxFreq < (int)dm.dmDisplayFrequency ) {
                                   maxFreq = dm.dmDisplayFrequency;
                                   mode = modeNum;         // remember current mode
                             }
                        }
                  }
            }

            if ( (int)mode == -1 ) {
                  if (bpp != 0)     // выбранный режим не был найден
                  {
                        output( "WARNING: Your system does not support choosen fullscreen video mode (%d %d %d), trying to choose other like this...\n", width, height, bpp );
                        bpp = 0;          // попытаемся выбрать режим с другим Bpp
                  }
                  else if ( width == DEVICE_SAFE_WIDTH && height == DEVICE_SAFE_HEIGHT ) {
                        output( "Safe fullscreen mode failed\n" );
                        break;
                  }
                  else {
                        output( "Falling to safe resolution (%d %d)...\n", DEVICE_SAFE_WIDTH, DEVICE_SAFE_HEIGHT );
                        width = DEVICE_SAFE_WIDTH;
                        height = DEVICE_SAFE_HEIGHT;
                  }
            }
            else {
                  if ( bpp == 0 ) {
                        bpp = maxBpp;
                        for ( DWORD modeNum = 0 ; ; modeNum++ ) {
                             if (!EnumDisplaySettings( NULL, modeNum, &dm ))
                                   break;
                             if ( dm.dmPelsWidth == width && dm.dmPelsHeight == height && bpp == dm.dmBitsPerPel ) {
                                   if ( (int)maxFreq < (int)dm.dmDisplayFrequency ) {
                                         maxFreq = dm.dmDisplayFrequency;
                                         mode = modeNum;         // remember current mode
                                   }
                             }
                        }
                  }
                  break;
            }
      }
      return mode;
}

Здесь сначала мы подбираем наиболее подходящий режим по ширине и высоте, затем, если указана глубина, подбираем по глубине. Если глубина цвета не указана (bpp=0), то ищем максимально доступную из списка видео режимов. В зваершение подбираем максимальную частоту экрана.

Мотоды restoreDisplaySettings и restoreDesktopSettings просты до безобразия:
  
void CCDS::restoreDesktopSettings() {
      if ( modeChanged != &desktopMode )
      {
            ::ChangeDisplaySettings( &desktopMode, 0 );
#ifdef HWGAMMA
            // restore gamma
            HWND  deskwnd = GetDesktopWindow();
            HDC         deskdc = GetDC( deskwnd );
            SetDeviceGammaRamp( deskdc, desktopGammaTable );
            ReleaseDC( deskwnd, deskdc );
#endif
            modeChanged = &desktopMode;
      }
}

void CCDS::restoreDisplaySettings() {
      if ( modeChanged != &displayMode )
      {
            ::ChangeDisplaySettings( &displayMode, CDS_FULLSCREEN );
#ifdef HWGAMMA
            // restore gamma
            HWND  deskwnd = GetDesktopWindow();
            HDC         deskdc = GetDC( deskwnd );
            SetDeviceGammaRamp( deskdc, gameGammaTable );
            ReleaseDC( deskwnd, deskdc );
#endif
            modeChanged = &displayMode;
      }
}

Их следует поместить в обработчик сообщений Windows в WM_SETFOCUS и WM_KILLFOCUS для  restoreDisplaySettings и restoreDesktopSettings соответственно. Здесь же можно при необходимости устанавливать и восстанавливать гамму. Подробнее о гамме, возможно будет описано в одном из следующих блогов :)

Метод  getModeDescription возвращает ширину и высоту указанного видео режима.

Метод changeDisplaySettings:

// changeDisplaySettings
// Устанавливает видео режим
bool CCDS::changeDisplaySettings( unsigned width, unsigned height, unsigned bpp ) {
      DWORD mode = chooseAppropriateMode( width, height, bpp );
      if ( (int)mode == -1 ) {
            output( "Failed to find an appropriate fullscreen mode\n" );
            return false;
      }
      memset( &displayMode, 0, sizeof( displayMode ) );
      if ( !::EnumDisplaySettings( NULL, mode, &displayMode ) ) {
            output( "Couldn't get display mode\n" );
            return false;
      }

      // Нас интересуют только следующие поля
      displayMode.dmFields &= DM_PELSWIDTH | DM_PELSHEIGHT | DM_DISPLAYFREQUENCY | DM_BITSPERPEL;

      output( "Selected fullscreen resolution (%d %d %d %dhz)\n", displayMode.dmPelsWidth, displayMode.dmPelsHeight, displayMode.dmBitsPerPel, displayMode.dmDisplayFrequency );
      output( "Changing display settings... " );
      LONG CDS = ::ChangeDisplaySettings( &displayMode, CDS_FULLSCREEN );
      switch ( CDS )
      {
      case DISP_CHANGE_SUCCESSFUL: output( "DISP_CHANGE_SUCCESSFUL\n" ); break;
      case DISP_CHANGE_BADMODE: output( "DISP_CHANGE_BADMODE\n" ); break;
      case DISP_CHANGE_RESTART: output( "DISP_CHANGE_RESTART\n" ); break;
      case DISP_CHANGE_FAILED: output( "DISP_CHANGE_FAILED\n" ); break;
      case DISP_CHANGE_NOTUPDATED: output( "DISP_CHANGE_NOTUPDATED\n" ); break;
      case DISP_CHANGE_BADFLAGS: output( "DISP_CHANGE_BADFLAGS\n" ); break;
      case DISP_CHANGE_BADPARAM: output( "DISP_CHANGE_BADPARAM\n" ); break;
      }
      if ( CDS == DISP_CHANGE_BADMODE )
            output( "Bad mode (%ix%ix%i %ihz)\n", displayMode.dmPelsWidth, displayMode.dmPelsHeight, displayMode.dmBitsPerPel, displayMode.dmDisplayFrequency );
      else if ( CDS != DISP_CHANGE_SUCCESSFUL )
            output( "Failed to change resolution\n" );
      if ( CDS != DISP_CHANGE_SUCCESSFUL )
            return false;
      modeChanged = &displayMode;
      return true;
}

Полный листинг: 

#define     DEVICE_SAFE_WIDTH       640
#define     DEVICE_SAFE_HEIGHT      480

class CCDS
{
public:
      CCDS();
      virtual ~CCDS();

      // Функция устанавливает видео режим. Если параметр bpp установлен в 0,
      // то устанавливается режим с максимальным bpp
      bool        changeDisplaySettings( unsigned width, unsigned height, unsigned bpp=0 );

      // Функция восстанавливает настройки режима рабочего стола
      void        restoreDesktopSettings();

      // Функция восстанавливает настройки выбранного ранее режима
      void        restoreDisplaySettings();

      // Функция возвращает состояние - был ли видео режим изменен
      bool        isModeChanged                      () const { return modeChanged != &desktopMode; }

      unsigned    getWidth                () const { return modeChanged->dmPelsWidth; }
      unsigned    getHeight               () const { return modeChanged->dmPelsHeight; }
      unsigned    getBitsPerPel     () const { return modeChanged->dmBitsPerPel; }
      unsigned    getFrequency      () const { return modeChanged->dmDisplayFrequency; }

      bool        getModeDescription      ( unsigned modeNum, unsigned & width, unsigned & height ) const;

private:
      DEVMODE     desktopMode;
      DEVMODE     displayMode;
      DEVMODE     *modeChanged;

      // Функция выбирает подходящий видео режим. Если параметр bpp установлен в 0,
      // то выбирается режим с максимальным bpp
      DWORD chooseAppropriateMode( unsigned width, unsigned height, unsigned bpp=0 );
};

CCDS::CCDS()
      : modeChanged(&desktopMode)
{
      memset( &desktopMode, 0, sizeof( desktopMode ) );
      desktopMode.dmSize = sizeof( desktopMode );
      if( !EnumDisplaySettings( NULL, ENUM_CURRENT_SETTINGS, &desktopMode ) )
            output( "Can't get desktop settings\n" );
}

CCDS::~CCDS()
{
      if ( modeChanged != &desktopMode )
            ::ChangeDisplaySettings( &desktopMode, 0 );
}

// chooseAppropriateMode
// Функция просматривает список доступных режимов и ищет
// с такими же параметрами, в противном случае выбирается
// режим по умолчанию 640x480
// Если Bpp не указано, либо равно нулю, то функция подбирает
// наиболее высокий
// Если режим был выбран успешно, функция подбирает максимально
// возможную поддерживаемую частоту обновления экрана
// Функция возвращает (-1) если режим не удалось выбрать
DWORD CCDS::chooseAppropriateMode( unsigned width, unsigned height, unsigned bpp ) {
      DEVMODE     dm;
      DWORD mode = -1;
      DWORD maxBpp = -1;
      DWORD maxFreq = -1;

      while (1) {
            for ( DWORD modeNum = 0 ; ; modeNum++ ) {
                  if (!::EnumDisplaySettings( NULL, modeNum, &dm )) {
                        break;
                  }
                  if ( dm.dmPelsWidth == width && dm.dmPelsHeight == height ) {
                        if ( bpp == 0 ) {
                             if ( (int)maxBpp < (int)dm.dmBitsPerPel ) {
                                   maxBpp = dm.dmBitsPerPel;
                                   mode = modeNum;         // remember current mode
                             }
                        }
                        else if ( bpp == dm.dmBitsPerPel ) {
                             if ( (int)maxFreq < (int)dm.dmDisplayFrequency ) {
                                   maxFreq = dm.dmDisplayFrequency;
                                   mode = modeNum;         // remember current mode
                             }
                        }
                  }
            }

            if ( (int)mode == -1 ) {
                  if (bpp != 0)     // выбранный режим не был найден
                  {
                        output( "WARNING: Your system does not support choosen fullscreen video mode (%d %d %d), trying to choose other like this...\n", width, height, bpp );
                        bpp = 0;          // попытаемся выбрать режим с другим Bpp
                  }
                  else if ( width == DEVICE_SAFE_WIDTH && height == DEVICE_SAFE_HEIGHT ) {
                        output( "Safe fullscreen mode failed\n" );
                        break;
                  }
                  else {
                        output( "Falling to safe resolution (%d %d)...\n", DEVICE_SAFE_WIDTH, DEVICE_SAFE_HEIGHT );
                        width = DEVICE_SAFE_WIDTH;
                        height = DEVICE_SAFE_HEIGHT;
                  }
            }
            else {
                  if ( bpp == 0 ) {
                        bpp = maxBpp;
                        for ( DWORD modeNum = 0 ; ; modeNum++ ) {
                             if (!EnumDisplaySettings( NULL, modeNum, &dm ))
                                   break;
                             if ( dm.dmPelsWidth == width && dm.dmPelsHeight == height && bpp == dm.dmBitsPerPel ) {
                                   if ( (int)maxFreq < (int)dm.dmDisplayFrequency ) {
                                         maxFreq = dm.dmDisplayFrequency;
                                         mode = modeNum;         // remember current mode
                                   }
                             }
                        }
                  }
                  break;
            }
      }
      return mode;
}

// changeDisplaySettings
// Устанавливает видео режим
bool CCDS::changeDisplaySettings( unsigned width, unsigned height, unsigned bpp ) {
      DWORD mode = chooseAppropriateMode( width, height, bpp );
      if ( (int)mode == -1 ) {
            output( "Failed to find an appropriate fullscreen mode\n" );
            return false;
      }
      memset( &displayMode, 0, sizeof( displayMode ) );
      if ( !::EnumDisplaySettings( NULL, mode, &displayMode ) ) {
            output( "Couldn't get display mode\n" );
            return false;
      }

      // Нас интересуют только следующие поля
      displayMode.dmFields &= DM_PELSWIDTH | DM_PELSHEIGHT | DM_DISPLAYFREQUENCY | DM_BITSPERPEL;

      output( "Selected fullscreen resolution (%d %d %d %dhz)\n", displayMode.dmPelsWidth, displayMode.dmPelsHeight, displayMode.dmBitsPerPel, displayMode.dmDisplayFrequency );
      output( "Changing display settings... " );
      LONG CDS = ::ChangeDisplaySettings( &displayMode, CDS_FULLSCREEN );
      switch ( CDS )
      {
      case DISP_CHANGE_SUCCESSFUL: output( "DISP_CHANGE_SUCCESSFUL\n" ); break;
      case DISP_CHANGE_BADMODE: output( "DISP_CHANGE_BADMODE\n" ); break;
      case DISP_CHANGE_RESTART: output( "DISP_CHANGE_RESTART\n" ); break;
      case DISP_CHANGE_FAILED: output( "DISP_CHANGE_FAILED\n" ); break;
      case DISP_CHANGE_NOTUPDATED: output( "DISP_CHANGE_NOTUPDATED\n" ); break;
      case DISP_CHANGE_BADFLAGS: output( "DISP_CHANGE_BADFLAGS\n" ); break;
      case DISP_CHANGE_BADPARAM: output( "DISP_CHANGE_BADPARAM\n" ); break;
      }
      if ( CDS == DISP_CHANGE_BADMODE )
            output( "Bad mode (%ix%ix%i %ihz)\n", displayMode.dmPelsWidth, displayMode.dmPelsHeight, displayMode.dmBitsPerPel, displayMode.dmDisplayFrequency );
      else if ( CDS != DISP_CHANGE_SUCCESSFUL )
            output( "Failed to change resolution\n" );
      if ( CDS != DISP_CHANGE_SUCCESSFUL )
            return false;
      modeChanged = &displayMode;
      return true;
}

void CCDS::restoreDesktopSettings() {
      if ( modeChanged != &desktopMode )
      {
            ::ChangeDisplaySettings( &desktopMode, 0 );
#ifdef HWGAMMA
            // restore gamma
            HWND  deskwnd = GetDesktopWindow();
            HDC         deskdc = GetDC( deskwnd );
            SetDeviceGammaRamp( deskdc, desktopGammaTable );
            ReleaseDC( deskwnd, deskdc );
#endif
            modeChanged = &desktopMode;
      }
}

void CCDS::restoreDisplaySettings() {
      if ( modeChanged != &displayMode )
      {
            ::ChangeDisplaySettings( &displayMode, CDS_FULLSCREEN );
#ifdef HWGAMMA
            // restore gamma
            HWND  deskwnd = GetDesktopWindow();
            HDC         deskdc = GetDC( deskwnd );
            SetDeviceGammaRamp( deskdc, gameGammaTable );
            ReleaseDC( deskwnd, deskdc );
#endif
            modeChanged = &displayMode;
      }
}

bool        CCDS::getModeDescription     ( unsigned modeNum, unsigned & width, unsigned & height ) const
{
      DEVMODE     devMode;
      memset( &devMode, 0, sizeof( devMode ) );
      if ( !::EnumDisplaySettings( NULL, modeNum, &devMode ) ) {
            output( "Couldn't get display mode\n" );
            return false;
      }
      width = devMode.dmPelsWidth;
      height = devMode.dmPelsHeight;
      return true;
}