Jaysyn904 a6f6db7303 Initial commit
Initial commit.  Updated release archive.
2024-06-13 15:08:33 -04:00

138 lines
3.7 KiB
Plaintext

/// @addtogroup nwnx NWNX
/// @brief Functions for plugin developers.
/// @{
/// @file nwnx.nss
const string NWNX_Core = "NWNX_Core"; ///< @private
/// @brief Scripting interface to NWNX.
/// @param pluginName The plugin name.
/// @param functionName The function name (do not include NWNX_Plugin_).
void NWNX_CallFunction(string pluginName, string functionName);
/// @brief Pushes the specified type to the c++ side
/// @param value The value of specified type to push.
void NWNX_PushArgumentInt(int value);
/// @copydoc NWNX_PushArgumentInt()
void NWNX_PushArgumentFloat(float value);
/// @copydoc NWNX_PushArgumentInt()
void NWNX_PushArgumentObject(object value);
/// @copydoc NWNX_PushArgumentInt()
void NWNX_PushArgumentString(string value);
/// @copydoc NWNX_PushArgumentInt()
void NWNX_PushArgumentEffect(effect value);
/// @copydoc NWNX_PushArgumentInt()
void NWNX_PushArgumentItemProperty(itemproperty value);
/// @copydoc NWNX_PushArgumentInt()
void NWNX_PushArgumentJson(json value);
/// @brief Returns the specified type from the c++ side
/// @return The value of specified type.
int NWNX_GetReturnValueInt();
/// @copydoc NWNX_GetReturnValueInt()
float NWNX_GetReturnValueFloat();
/// @copydoc NWNX_GetReturnValueInt()
object NWNX_GetReturnValueObject();
/// @copydoc NWNX_GetReturnValueInt()
string NWNX_GetReturnValueString();
/// @copydoc NWNX_GetReturnValueInt()
effect NWNX_GetReturnValueEffect();
/// @copydoc NWNX_GetReturnValueInt()
itemproperty NWNX_GetReturnValueItemProperty();
/// @copydoc NWNX_GetReturnValueInt()
json NWNX_GetReturnValueJson();
/// @brief Determines if the given plugin exists and is enabled.
/// @param sPlugin The name of the plugin to check. This is the case sensitive plugin name as used by NWNX_CallFunction, NWNX_PushArgumentX
/// @note Example usage: NWNX_PluginExists("NWNX_Creature");
/// @return TRUE if the plugin exists and is enabled, otherwise FALSE.
int NWNX_PluginExists(string sPlugin);
/// @private
const string NWNX_PUSH = "NWNXEE!ABIv2!X!Y!PUSH";
const string NWNX_POP = "NWNXEE!ABIv2!X!Y!POP";
/// @}
void NWNX_CallFunction(string pluginName, string functionName)
{
PlaySound("NWNXEE!ABIv2!" + pluginName + "!" + functionName + "!CALL");
}
void NWNX_PushArgumentInt(int value)
{
SetLocalInt(OBJECT_INVALID, NWNX_PUSH, value);
}
void NWNX_PushArgumentFloat(float value)
{
SetLocalFloat(OBJECT_INVALID, NWNX_PUSH, value);
}
void NWNX_PushArgumentObject(object value)
{
SetLocalObject(OBJECT_INVALID, NWNX_PUSH, value);
}
void NWNX_PushArgumentString(string value)
{
SetLocalString(OBJECT_INVALID, NWNX_PUSH, value);
}
void NWNX_PushArgumentEffect(effect value)
{
TagEffect(value, NWNX_PUSH);
}
void NWNX_PushArgumentItemProperty(itemproperty value)
{
TagItemProperty(value, NWNX_PUSH);
}
void NWNX_PushArgumentJson(json value)
{
SetLocalJson(OBJECT_INVALID, NWNX_PUSH, value);
}
int NWNX_GetReturnValueInt()
{
return GetLocalInt(OBJECT_INVALID, NWNX_POP);
}
float NWNX_GetReturnValueFloat()
{
return GetLocalFloat(OBJECT_INVALID, NWNX_POP);
}
object NWNX_GetReturnValueObject()
{
return GetLocalObject(OBJECT_INVALID, NWNX_POP);
}
string NWNX_GetReturnValueString()
{
return GetLocalString(OBJECT_INVALID, NWNX_POP);
}
effect NWNX_GetReturnValueEffect()
{
effect e;
return TagEffect(e, NWNX_POP);
}
itemproperty NWNX_GetReturnValueItemProperty()
{
itemproperty ip;
return TagItemProperty(ip, NWNX_POP);
}
json NWNX_GetReturnValueJson()
{
return GetLocalJson(OBJECT_INVALID, NWNX_POP);
}
int NWNX_PluginExists(string sPlugin)
{
string sFunc = "PluginExists";
NWNX_PushArgumentString(sPlugin);
NWNX_CallFunction(NWNX_Core, sFunc);
return NWNX_GetReturnValueInt();
}