/**

 * vim: set ts=4 :

 * ===============================================================

 * SourceMod, Copyright (C) 2004-2007 AlliedModders LLC. 

 * All rights reserved.

 * ===============================================================

 *

 *  This file is part of the SourceMod/SourcePawn SDK.  This file may only be 

 * used or modified under the Terms and Conditions of its License Agreement, 

 * which is found in public/licenses/LICENSE.txt.  As of this notice, derivative 

 * works must be licensed under the GNU General Public License (version 2 or 

 * greater).  A copy of the GPL is included under public/licenses/GPL.txt.

 * 

 * To view the latest information, see: http://www.sourcemod.net/license.php

 *

 * Version: $Id$

 */

#ifndef _INCLUDE_SOURCEMOD_EXTENSION_BASESDK_H_

#define _INCLUDE_SOURCEMOD_EXTENSION_BASESDK_H_

/**

 * @file smsdk_ext.h

 * @brief Contains wrappers for making Extensions easier to write.

 */

#include "smsdk_config.h"

#include <IExtensionSys.h>

#include <IHandleSys.h>

#include <sp_vm_api.h>

#include <sm_platform.h>

#include <ISourceMod.h>

#include <IForwardSys.h>

#if defined SMEXT_CONF_METAMOD

#include <ISmmPlugin.h>

#include <eiface.h>

#endif

using namespace SourceMod;

using namespace SourcePawn;

class SDKExtension : 

#if defined SMEXT_CONF_METAMOD

	public ISmmPlugin,

#endif

	public IExtensionInterface

{

public:

	/** Constructor */

	SDKExtension();

public:

	/**

	 * @brief This is called after the initial loading sequence has been processed.

	 *

	 * @param error		Error message buffer.

	 * @param maxlength	Size of error message buffer.

	 * @param late		Whether or not the module was loaded after map load.

	 * @return			True to succeed loading, false to fail.

	 */

	virtual bool SDK_OnLoad(char *error, size_t maxlength, bool late);

	/**

	 * @brief This is called right before the extension is unloaded.

	 */

	virtual void SDK_OnUnload();

	/**

	 * @brief This is called once all known extensions have been loaded.

	 */

	virtual void SDK_OnAllLoaded();

	/**

	 * @brief Called when the pause state is changed.

	 */

	virtual void SDK_OnPauseChange(bool paused);

#if defined SMEXT_CONF_METAMOD

	/**

	 * @brief Called when Metamod is attached, before the extension version is called.

	 *

	 * @param error			Error buffer.

	 * @param maxlength		Maximum size of error buffer.

	 * @param late			Whether or not Metamod considers this a late load.

	 * @return				True to succeed, false to fail.

	 */

	virtual bool SDK_OnMetamodLoad(ISmmAPI *ismm, char *error, size_t maxlength, bool late);

	/**

	 * @brief Called when Metamod is detaching, after the extension version is called.

	 * NOTE: By default this is blocked unless sent from SourceMod.

	 *

	 * @param error			Error buffer.

	 * @param maxlength		Maximum size of error buffer.

	 * @return				True to succeed, false to fail.

	 */

	virtual bool SDK_OnMetamodUnload(char *error, size_t maxlength);

	/**

	 * @brief Called when Metamod's pause state is changing.

	 * NOTE: By default this is blocked unless sent from SourceMod.

	 *

	 * @param paused		Pause state being set.

	 * @param error			Error buffer.

	 * @param maxlength		Maximum size of error buffer.

	 * @return				True to succeed, false to fail.

	 */

	virtual bool SDK_OnMetamodPauseChange(bool paused, char *error, size_t maxlength);

#endif

public: // IExtensionInterface

	virtual bool OnExtensionLoad(IExtension *me, IShareSys *sys, char *error, size_t maxlength, bool late);

	virtual void OnExtensionUnload();

	virtual void OnExtensionsAllLoaded();

	/** Returns whether or not this is a Metamod-based extension */

	virtual bool IsMetamodExtension();

	/**

	 * @brief Called when the pause state changes.

	 * 

	 * @param state			True if being paused, false if being unpaused.

	 */

	virtual void OnExtensionPauseChange(bool state);

	/** Returns name */

	virtual const char *GetExtensionName();

	/** Returns URL */

	virtual const char *GetExtensionURL();

	/** Returns log tag */

	virtual const char *GetExtensionTag();

	/** Returns author */

	virtual const char *GetExtensionAuthor();

	/** Returns version string */

	virtual const char *GetExtensionVerString();

	/** Returns description string */

	virtual const char *GetExtensionDescription();

	/** Returns date string */

	virtual const char *GetExtensionDateString();

#if defined SMEXT_CONF_METAMOD

public: // ISmmPlugin

	/** Called when the extension is attached to Metamod. */

	virtual bool Load(PluginId id, ISmmAPI *ismm, char *error, size_t maxlen, bool late);

	/** Returns the author to MM */

	virtual const char *GetAuthor();

	/** Returns the name to MM */

	virtual const char *GetName();

	/** Returns the description to MM */

	virtual const char *GetDescription();

	/** Returns the URL to MM */

	virtual const char *GetURL();

	/** Returns the license to MM */

	virtual const char *GetLicense();

	/** Returns the version string to MM */

	virtual const char *GetVersion();

	/** Returns the date string to MM */

	virtual const char *GetDate();

	/** Returns the logtag to MM */

	virtual const char *GetLogTag();

	/** Called on unload */

	virtual bool Unload(char *error, size_t maxlen);

	/** Called on pause */

	virtual bool Pause(char *error, size_t maxlen);

	/** Called on unpause */

	virtual bool Unpause(char *error, size_t maxlen);

private:

	bool m_SourceMMLoaded;

	bool m_WeAreUnloaded;

	bool m_WeGotPauseChange;

#endif

};

extern SDKExtension *g_pExtensionIface;

extern IShareSys *g_pShareSys;

extern IExtension *myself;

extern IHandleSys *g_pHandleSys;

extern ISourceMod *g_pSM;

extern IForwardManager *g_pForwards;

#if defined SMEXT_CONF_METAMOD

PLUGIN_GLOBALVARS();

extern IVEngineServer *engine;

extern IServerGameDLL *gamedll;

#endif

/** Creates a SourceMod interface macro pair */

#define SM_MKIFACE(name) SMINTERFACE_##name##_NAME, SMINTERFACE_##name##_VERSION

/** Automates retrieving SourceMod interfaces */

#define SM_GET_IFACE(prefix, addr) \

	if (!g_pShareSys->RequestInterface(SM_MKIFACE(prefix), myself, (SMInterface **)&addr)) \

	{ \

		if (error) \

		{ \

			snprintf(error, maxlength, "Could not find interface: %s", SMINTERFACE_##prefix##_NAME); \

			return false; \

		} \

	}

/** Automates retrieving SourceMod interfaces when needed outside of SDK_OnLoad() */

#define SM_GET_LATE_IFACE(prefix, addr) \

	g_pShareSys->RequestInterface(SM_MKIFACE(prefix), myself, (SMInterface **)&addr)

/** Validates a SourceMod interface pointer */

#define SM_CHECK_IFACE(prefix, addr) \

	if (!addr) \

	{ \

		if (error) \

		{ \

			snprintf(error, maxlength, "Could not find interface: %s", SMINTERFACE_##prefix##_NAME); \

			return false; \

		} \

	}

#endif // _INCLUDE_SOURCEMOD_EXTENSION_BASESDK_H_