core/ISmmPluginExt.h
author Scott Ehlert <ds@alliedmods.net>
Mon Nov 17 00:57:17 2008 -0600 (2008-11-17)
changeset 557 0a8ad2b12708
parent 539 db914129ae01
child 637 b66489d8aedc
permissions -rw-r--r--
Added Windows support for loader, core, and core-legacy
     1 /*
     2  * vim: set ts=4 :
     3  * ======================================================
     4  * Metamod:Source
     5  * Copyright (C) 2004-2008 AlliedModders LLC and authors.
     6  * All rights reserved.
     7  * ======================================================
     8  *
     9  * This software is provided 'as-is', without any express or implied warranty.
    10  * In no event will the authors be held liable for any damages arising from 
    11  * the use of this software.
    12  * 
    13  * Permission is granted to anyone to use this software for any purpose, 
    14  * including commercial applications, and to alter it and redistribute it 
    15  * freely, subject to the following restrictions:
    16  *
    17  * 1. The origin of this software must not be misrepresented; you must not 
    18  * claim that you wrote the original software. If you use this software in a 
    19  * product, an acknowledgment in the product documentation would be 
    20  * appreciated but is not required.
    21  * 2. Altered source versions must be plainly marked as such, and must not be
    22  * misrepresented as being the original software.
    23  * 3. This notice may not be removed or altered from any source distribution.
    24  *
    25  * Version: $Id$
    26  */
    27 
    28 #ifndef _INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_
    29 #define _INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_
    30 
    31 #include <stddef.h>
    32 
    33 /**
    34  * @file ISmmPluginExt.h Provides an alternate method for loading plugins, 
    35  * without needing to include the default headers and all their Half-Life baggage.
    36  *
    37  * @brief Definitions for extended plugin loading.
    38  */
    39 
    40 #define SOURCE_ENGINE_UNKNOWN			0				/**< Could not determine the engine version */
    41 #define SOURCE_ENGINE_ORIGINAL			1				/**< Original Source Engine (used by The Ship) */
    42 #define SOURCE_ENGINE_EPISODEONE		2				/**< Episode 1 Source Engine (second major SDK) */
    43 #define SOURCE_ENGINE_ORANGEBOX			3				/**< Orange Box Source Engine (third major SDK) */
    44 #define SOURCE_ENGINE_LEFT4DEAD			4				/**< Left 4 Dead */
    45 
    46 #define METAMOD_PLAPI_VERSION			14				/**< Version of this header file */
    47 #define METAMOD_PLAPI_NAME				"ISmmPlugin"	/**< Name of the plugin interface */
    48 
    49 namespace SourceMM
    50 {
    51 	class ISmmPlugin;
    52 	class ISmmAPI;
    53 
    54 	/**
    55 	 * @brief Used to uniquely identify plugins.
    56 	 */
    57 	typedef int PluginId;
    58 
    59 	#define METAMOD_FAIL_API_V1			7				/**< Minimum API version to detect for V1 */
    60 	#define METAMOD_FAIL_API_V2			14				/**< Minimum API version to detect for V2 */
    61 
    62 	/**
    63 	 * Use this to instantiate a plugin that will always fail.
    64 	 * This class definition works against major API versions 1 and 2.
    65 	 */
    66 	class ISmmFailPlugin
    67 	{
    68 	public:
    69 		/**
    70 		 * @brief You must return METAMOD_FAIL_API_V1 or METAMOD_FAIL_API_V2 here, 
    71 		 * depending on which Metamod:Source version you detected.
    72 		 */
    73 		virtual int GetApiVersion() = 0;
    74 
    75 		/**
    76 		 * @brief Do not change.
    77 		 */
    78 		virtual ~ISmmFailPlugin()
    79 		{
    80 		}
    81 
    82 		/**
    83 		 * @brief Return false here -- fill in the error buffer appropriately.
    84 		 *
    85 		 * Do not ever return true.  If you do, MM:S will crash because the class layout is 
    86 		 * incomplete against ISmmPlugin.
    87 		 * 
    88 		 * @param id			Ignore.
    89 		 * @param ismm			Ignore.
    90 		 * @param error			Error buffer (must be filled).
    91 		 * @param maxlength		Maximum size of error buffer.
    92 		 * @param late			Ignore.
    93 		 * @return				Must return false.
    94 		 */
    95 		virtual bool Load(PluginId id, ISmmAPI *ismm, char *error, size_t maxlength, bool late) =0;
    96 	};
    97 }
    98 
    99 typedef SourceMM::ISmmPlugin METAMOD_PLUGIN;
   100 
   101 /**
   102  * @brief Contains version information.
   103  */
   104 struct MetamodVersionInfo
   105 {
   106 	int api_major;			/**< ISmmAPI major version */
   107 	int api_minor;			/**< ISmmAPI minor version */
   108 	int sh_iface;			/**< SourceHook interface version */
   109 	int sh_impl;			/**< SourceHook implementation version */
   110 	int pl_min;				/**< Plugin API minimum version */
   111 	int pl_max;				/**< Plugin API maximum version */
   112 	int source_engine;		/**< Source Engine version (SOURCE_* constants) */
   113 };
   114 
   115 /**
   116  * @brief Contains information about loading a plugin.
   117  */
   118 struct MetamodLoaderInfo
   119 {
   120 	const char *pl_file;	/**< File path to the plugin being loaded. */
   121 	const char *pl_path;	/**< Folder path containing the plugin. */
   122 };
   123 
   124 /**
   125  * @brief If a function of this type is exposed as "CreateInterface_MMS", then
   126  * Metamod:Source will attempt to call this function before calling 
   127  * CreateInterface.  If this function returns a valid ISmmPlugin pointer, then 
   128  * CreateInterface will not be called.
   129  *
   130  * This is useful for implementing a mini-loader plugin for multiple versions.
   131  *
   132  * @param mvi				MetamodVersionInfo structure.
   133  * @param mli				MetamodLoaderInfo structure.
   134  * @return					ISmmAPI pointer, or NULL if none.
   135  */
   136 typedef METAMOD_PLUGIN *(*METAMOD_FN_LOAD)(const MetamodVersionInfo *mvi, 
   137 										   const MetamodLoaderInfo *mli);
   138 
   139 /**
   140  * @brief If a function of this type is exposed as "UnloadInterface_MMS", then
   141  * Metamod:Source will attempt to call this function after calling 
   142  * ISmmAPI::Unload(), and before closing the library.  This lets loader plugins 
   143  * clean up before exiting.
   144  *
   145  * Note: This function will be ignored unless CreateInterfce_MMS was exposed.
   146  * It may be called even if ISmmAPI::Unload() could not be called.
   147  */
   148 typedef void (*METAMOD_FN_UNLOAD)();
   149 
   150 /**
   151  * @brief Original type of load function.  CreateInterfaceFn from Valve.
   152  * 
   153  * Plugins will expose this as "CreateInterface".
   154  */
   155 typedef void *(*METAMOD_FN_ORIG_LOAD)(const char *, int *);
   156 
   157 #endif //INCLUDE_METAMOD_SOURCE_PLUGIN_EXT_H_
   158