< index < 3. System layer | ===================================== 3.3 Using a custom resolution for the fullscreen mode ===================================== |

### TCODSystem::forceFullscreenResolution

This function allows you to force the use of a specific resolution in fullscreen mode.
The default resolution depends on the root console size and the font character size.

    C++ : static void TCODSystem::forceFullscreenResolution(int width, int height)
    C   : void TCOD_sys_force_fullscreen_resolution(int width, int height)
    Py  : sys_force_fullscreen_resolution(width, height)

Parameter | Description
--- | ---
width, height | Resolution to use when switching to fullscreen. Will use the smallest available resolution so that : resolution width >= width and resolution width >= root console width * font char width resolution width >= height and resolution height >= root console height * font char height

Example :

    C++ : TCODSystem::forceFullscreenResolution(800,600); // use 800x600 in fullscreen instead of 640x400
          TCODConsole::initRoot(80,50,"",true); // 80x50 console with 8x8 char => 640x400 default resolution
    C   : TCOD_sys_force_fullscreen_resolution(800,600);
          TCOD_console_init_root(80,50,"",true);
    Py  : libtcod.sys_force_fullscreen_resolution(800,600)
          libtcod.console_init_root(80,50,"",True)

### TCODSystem::getCurrentResolution

You can get the current screen resolution with getCurrentResolution. You can use it for example to get the desktop resolution before initializing the root console.

    C++ : static void TCODSystem::getCurrentResolution(int *width, int *height)
    C   : void TCOD_sys_get_current_resolution(int *width, int *height)
    Py  : sys_get_current_resolution() # returns w,h

Parameter | Description
--- | ---
width, height | Contain current resolution when the function returns.

Example :

    C++ : int w,h;
          TCODSystem::getCurrentResolution(&w,&h); // get desktop resolution
          TCODConsole::initRoot(w/8,h/8,"",true); // sets the console size so that it fills the desktop with a 8x8 font
    C   : TCOD_sys_get_current_resolution(&w,&h);
          TCOD_console_init_root(w/8,h/8,"",true);
    Py  : w,h=libtcod.sys_get_current_resolution()
          libtcod.console_init_root(w/8,h/8,"",True)

### TCODSystem::getCharSize

You can also get the current font character size.

    C++ : static void TCODSystem::getCharSize(int *width, int *height)
    C   : void TCOD_sys_get_char_size(int *width, int *height)
    Py  : sys_get_char_size() # returns w,h

Parameter | Description
--- | ---
width, height | Contain the font characters size when the function returns.