1

/* $Id$ */

     2

     3

/** @file driver.h Base for all drivers (video, sound, music, etc). */

     4

     5

#ifndef DRIVER_H

     6

#define DRIVER_H

     7

     8

#include "debug.h"

     9

#include "core/enum_type.hpp"

    10

#include "string_func.h"

    11

#include <map>

    12

    13

bool GetDriverParamBool(const char * const *parm, const char *name);

    14

int GetDriverParamInt(const char * const *parm, const char *name, int def);

    15

    16

class Driver {

    17

public:

    18

	virtual const char *Start(const char * const *parm) = 0;

    19

    20

	virtual void Stop() = 0;

    21

    22

	virtual ~Driver() { }

    23

    24

	enum Type {

    25

		DT_BEGIN = 0,

    26

		DT_SOUND = 0,

    27

		DT_MUSIC,

    28

		DT_VIDEO,

    29

		DT_END,

    30

	};

    31

};

    32

    33

DECLARE_POSTFIX_INCREMENT(Driver::Type);

    34

    35

    36

class DriverFactoryBase {

    37

private:

    38

	Driver::Type type;

    39

	const char *name;

    40

	int priority;

    41

    42

	struct StringCompare {

    43

		bool operator () (const char *a, const char *b) const

    44

		{

    45

			return strcmp(a, b) < 0;

    46

		}

    47

	};

    48

    49

	typedef std::map<const char *, DriverFactoryBase *, StringCompare> Drivers;

    50

    51

	static Drivers &GetDrivers()

    52

	{

    53

		static Drivers &s_drivers = *new Drivers();

    54

		return s_drivers;

    55

	}

    56

    57

	static Driver **GetActiveDriver(Driver::Type type)

    58

	{

    59

		static Driver *s_driver[3] = { NULL, NULL, NULL };

    60

		return &s_driver[type];

    61

	}

    62

    63

	static const char *GetDriverTypeName(Driver::Type type)

    64

	{

    65

		static const char *driver_type_name[] = { "sound", "music", "video" };

    66

		return driver_type_name[type];

    67

	}

    68

    69

protected:

    70

	void RegisterDriver(const char *name, Driver::Type type, int priority);

    71

    72

public:

    73

	DriverFactoryBase() :

    74

		name(NULL)

    75

	{}

    76

    77

	virtual ~DriverFactoryBase();

    78

    79

	/** Shuts down all active drivers

    80

	 */

    81

	static void ShutdownDrivers()

    82

	{

    83

		for (Driver::Type dt = Driver::DT_BEGIN; dt < Driver::DT_END; dt++) {

    84

			Driver *driver = *GetActiveDriver(dt);

    85

			if (driver != NULL) driver->Stop();

    86

		}

    87

	}

    88

    89

	static const Driver *SelectDriver(const char *name, Driver::Type type);

    90

	static char *GetDriversInfo(char *p, const char *last);

    91

    92

	/**

    93

	 * Get a nice description of the driver-class.

    94

	 */

    95

	virtual const char *GetDescription() = 0;

    96

    97

	/**

    98

	 * Create an instance of this driver-class.

    99

	 */

   100

	virtual Driver *CreateInstance() = 0;

   101

};

   102

   103

#endif /* DRIVER_H */