C++ Wrapper for SDL
[Stechec]

Located in stechec/sdl directory.This module basicly defines a wrapper in C++, but it turns out that this is an (almost) complete SDL engine. It provides:

• resouces (picture, fonts) loading and caching
• encapsulation of all basic SDL functions in C++ classes
• creation of a SDL Window described by an xml file
• hierachical handling of surfaces
• handling IOLoop, updating and rendering surfaces are done automatically
• provides more high-level functions (like sprite animation).

More...

Collaboration diagram for C++ Wrapper for SDL:

Classes
class	Input
	Hold keyboard and mouse state.* For mouse absolute position and delta motion, this should be obvious. * For mouse button, use constants SDL_BUTTON_LEFT, ..., see SDL_MouseButtonEvent(5). * For keyboard, two informations are available. Keys currently pressed, and keys being pressed since the last updat.e occured. Access key using ascii character, eg: if (key_['b']) {...} * For keyboard modifier, use class convenience function. More...
class	InputTextSurface
	Implements a TextBox, to let user type text.This is implemented on top of TextSurface, and isn't really nice to render custom text, ie a cursor. Moreover, some problems may exists when user mix special keys and text, especially when the framerate is low (because special keys are not treated in the order they were typed). More...
class	SDLError
	Exception thrown by SDL functions. More...
class	TTFError
	Exception thrown by TTF functions. More...
class	ResourceCenter
	Provide loader (with cache) for SDL resources.This class is a singleton. You can access it from anywhere. It provides image and font loader, with a transparent caching system. It is usually loaded within the SDLWindow class. More...
class	SDLWindow
	Manage SDL Window.Manage creation of a SDL Window and collect its events into Input class. More...
class	Sprite
	Enhancement of Surface, give life to object.Have the same behavior of Surface, but have some more features: * can be animated * can be moved from one position to another * can show a part of a larger picture (useful when a picture consists of several 'state'). More...
class	Surface
	Basic encapsulation of SDL_Surface structure.This is the base class to display something (in rectangular shape) on the screen. More...
class	TextSurface
	Class that can draw text, similiar to a TextLabel.Support multi-line and autowrap. More...
class	VirtualScrollableSurface
	Scrollable kind of VirtualSurface. More...
class	VirtualSurface
	Container for Surface.Other surface (any class derived from Surface) may be attached to VirtualSurface, in a father-child relationship. Rendering is done automatically, using this VirtualSurface as an intermediate SDL_Surface, in a efficient way. More...
Enumerations
enum	eTextRenderMethod { eTextSolid, eTextShaded, eTextBlended }
	Text render method. More...

---

Detailed Description

Located in stechec/sdl directory.

This module basicly defines a wrapper in C++, but it turns out that this is an (almost) complete SDL engine. It provides:

• resouces (picture, fonts) loading and caching
• encapsulation of all basic SDL functions in C++ classes
• creation of a SDL Window described by an xml file
• hierachical handling of surfaces
• handling IOLoop, updating and rendering surfaces are done automatically
• provides more high-level functions (like sprite animation).

Thus, the module's user doesn't have to care with SDL low-level details. The downside is that does things quite differently than SDL (is does it the way this module writer wanted), and may contains lots of bugs. It is mainly targeted to do what is needed, but with little adaptation it can be used everywhere SDL drawing is required.

A more complete documentation is available (in french) in in propal.pdf. All sources and headers files are located in stechec/sdl

Some examples are available through this documentation, and there are some more working examples in stechec/sdl/test

---

Enumeration Type Documentation

enum eTextRenderMethod

Text render method.

Enumerator:

eTextSolid	Normal, not Anti-Alisased.
eTextShaded	AA, with a defined background (don't keep transparency).
eTextBlended	AA, keep transparency. Slower.