Util

Description

Various utility functions related to engines.

Functions
void	initCommonGFX ()
void	initGraphicsModes (const Graphics::ModeList &modes)
void	initGraphics (int width, int height)
void	initGraphics (int width, int height, const Graphics::PixelFormat *format)
void	initGraphics (int width, int height, const Common::List< Graphics::PixelFormat > &formatList)
void	initGraphics3d (int width, int height)

Function Documentation

initCommonGFX()

void initCommonGFX

(

)

Set up the graphics mode of the backend.

initGraphicsModes()

void initGraphicsModes

(

const Graphics::ModeList &

modes

)

Send a list of graphics modes to the backend so it can make a decision about the best way to set up the display hardware.

Engines that switch between different virtual screen sizes during the game should call this function prior to any call to initGraphics. Engines that use only a single screen size do not need to call this function.

initGraphics() [1/3]

void initGraphics	(	int	width,
		int	height
	)

Set up the screen size and graphics mode of the backend.

Shows various warnings on certain backend graphics transaction failures (aspect switch, fullscreen switch, etc.).

Errors are returned when the backend is not able to switch to the specified mode.

Defaults to 256 color palette mode if no graphics format is provided. Uses the preferred format of the backend if graphics format pointer is NULL. Finds the best compatible format if a list of graphics formats is provided.

initGraphics() [2/3]

void initGraphics	(	int	width,
		int	height,
		const Graphics::PixelFormat *	format
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

initGraphics() [3/3]

void initGraphics	(	int	width,
		int	height,
		const Common::List< Graphics::PixelFormat > &	formatList
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

initGraphics3d()

void initGraphics3d	(	int	width,
		int	height
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.