DisplayRes Class Reference

#include <DisplayRes.h>

Inheritance diagram for DisplayRes:

Detailed Description

The DisplayRes module allows for the display resolution and refresh rateto be changed "on the fly".

Resolution and refresh rate can be changed using an explicit call or based on the video resolution.

The SwitchToVideoMode routine takes care of the actual work involved in changing the display mode. There are currently XRandR and OS X Carbon implementation so this works for X (Linux/BSD/UNIX) and Mac OS X.

Definition at line 27 of file DisplayRes.h.


Public Member Functions
bool	Initialize (void)
	Initialize DisplayRes, normally called automatically.
Resolution/Refresh Rate Changing methods.
These return true if mode is changed
bool	SwitchToVideo (int iwidth, int iheight, short irate=0)
	Switches to the resolution and refresh rate defined in the database for the specified video resolution and frame rate.
bool	SwitchToGUI (tmode which_gui=GUI)
	Switches to the GUI resolution specified.
bool	SwitchToCustomGUI (int width, int height, short rate=0)
	Switches to the custom GUI resolution specified.
Queries of current video mode
int	GetWidth (void) const
	Returns current screen width in pixels.
int	GetHeight (void) const
	Returns current screen width in pixels.
int	GetPhysicalWidth (void) const
	Returns current screen width in millimeters.
int	GetPhysicalHeight (void) const
	Returns current screen height in millimeters.
int	GetRefreshRate (void) const
	Returns current screen refresh rate.
double	GetAspectRatio (void) const
	Returns current screen aspect ratio.
These methods are global for all video modes
int	GetMaxWidth (void) const
	Returns maximum width in pixels supported by display.
int	GetMaxHeight (void) const
	Returns maximum height in pixels supported by display.
virtual const vector < DisplayResScreen > &	GetVideoModes () const =0
	Returns all video modes supported by the display.
const vector< short >	GetRefreshRates (int width, int height) const
	Returns refresh rates available at a specific screen resolution.
Static Public Member Functions
static DisplayRes *	GetDisplayRes (void)
	Factory method that returns a DisplayRes singleton.
Protected Member Functions
	DisplayRes (void)
	DisplayRes is an abstract class, instanciate with GetDisplayRes(void).
virtual	~DisplayRes (void)
virtual bool	GetDisplaySize (int &width_mm, int &height_mm) const =0
virtual bool	SwitchToVideoMode (int width, int height, short framerate)=0
Private Member Functions
	DisplayRes (const DisplayRes &rhs)
Private Attributes
tmode	cur_mode
DisplayResScreen	mode [4]
DisplayResScreen	last
DisplayResMap	in_size_to_output_mode
	maps input video parameters to output video modes
int	max_width
int	max_height
Static Private Attributes
static DisplayRes *	instance = NULL

Constructor & Destructor Documentation

DisplayRes::DisplayRes ( void ) [inline, protected]

DisplayRes is an abstract class, instanciate with GetDisplayRes(void).

Definition at line 118 of file DisplayRes.h.

virtual DisplayRes::~DisplayRes ( void ) [inline, protected, virtual]

Definition at line 119 of file DisplayRes.h.

DisplayRes::DisplayRes ( const DisplayRes & rhs ) [private]

Member Function Documentation

DisplayRes * DisplayRes::GetDisplayRes ( void ) [static]

Factory method that returns a DisplayRes singleton.

Definition at line 14 of file DisplayRes.cpp.

Referenced by VoqvFullscreen::BeginPort(), VoqvFullscreen::EndPort(), HostRefreshRateComboBox::GetRefreshRates(), GetVideoModes(), TV::Init(), MythContext::LoadQtConfig(), and VideoOutputXv::VideoOutputXv().

bool DisplayRes::Initialize ( void )

Initialize DisplayRes, normally called automatically.

While Initialize is called automatically by GetDisplayRes(void) it should be called again if the database settings for DisplayRes have changed.

Definition at line 27 of file DisplayRes.cpp.

Referenced by DisplayResOSX::DisplayResOSX(), DisplayResX::DisplayResX(), and MythContext::LoadQtConfig().

DisplayRes::SwitchToVideo	(	int	iwidth,
		int	iheight,
		short	irate = `0`
	)

Switches to the resolution and refresh rate defined in the database for the specified video resolution and frame rate.

Definition at line 85 of file DisplayRes.cpp.

Referenced by VoqvFullscreen::BeginPort(), and VideoOutputXv::ResizeForVideo().

bool DisplayRes::SwitchToGUI ( tmode which_gui = GUI )

Switches to the GUI resolution specified.

If which_gui is GUI then this switches to the resolution and refresh rate set in the database for the GUI. If which_gui is set to CUSTOM_GUI then we switch to the resolution and refresh rate specified in the last call to SwitchToCustomGUI(int, int, short).

Parameters:

which_gui

either regular GUI or CUSTOM_GUI

See also:: SwitchToCustomGUI(int, int, short)

Definition at line 126 of file DisplayRes.cpp.

Referenced by VoqvFullscreen::EndPort(), MythContext::LoadQtConfig(), VideoOutputXv::ResizeForGui(), SwitchToCustomGUI(), and VideoOutputXv::~VideoOutputXv().

bool DisplayRes::SwitchToCustomGUI	(	int	width,
		int	height,
		short	rate = `0`
	)

Switches to the custom GUI resolution specified.

This switches to the specified resolution, and refresh rate if specified. It also makes saves this resolution as the CUSTOM_GUI resolution, so that it can be recalled with SwitchToGUI(CUSTOM_GUI) in later DisplayRes calls.