Это мой первый блог и здесь я хочу описать, как можно установить видео режим в приложении. Тема довольно избитая, но все же вопросы по ней возникают у многих начинающих программистов. Речь пойдет о С++, хотя для других языков принцип ничем не отличается. Варианта два:
- установка режима средствами 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;
}