azerothcore/mod-ale
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #95 from Patman64/aura_documentation

Browse Source 
Aura documentation
- Remove GetCharges - already exists SetStackAmount
This commit is contained in:
Rochet2
2014-08-01 12:43:27 +03:00
parent f0bf49148f ddc9f9f46b
commit 57153d6c47
2 changed files with 81 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

75
AuraMethods.h
View File

@@ -9,12 +9,22 @@
namespace LuaAura
{
/**
* Returns the `Unit` that casted the `Spell` that caused this Aura to be applied.
*
* @return :Unit the `Unit` that casted this Aura
*/
int GetCaster(lua_State* L, Aura* aura)
{
Eluna::Push(L, aura->GetCaster());
return 1;
}
/**
* Returns the GUID of the `Unit` that casted the `Spell` that caused this Aura to be applied.
*
* @return :string the GUID of the `Unit` as a decimal string
*/
int GetCasterGUID(lua_State* L, Aura* aura)
{
#ifndef TRINITY
@@ -25,12 +35,22 @@ namespace LuaAura
return 1;
}
/**
* Returns the level of the `Unit` that casted the `Spell` that caused this Aura to be applied.
*
* @return :number the level of the `Unit`
*/
int GetCasterLevel(lua_State* L, Aura* aura)
{
Eluna::Push(L, aura->GetCaster()->getLevel());
return 1;
}
/**
* Returns the amount of time left until the Aura expires.
*
* @return :number amount of time left in milliseconds
*/
int GetDuration(lua_State* L, Aura* aura)
{
#ifndef TRINITY
@@ -41,18 +61,25 @@ namespace LuaAura
return 1;
}
int GetCharges(lua_State* L, Aura* aura)
{
Eluna::Push(L, aura->GetStackAmount());
return 1;
}
/**
* Returns the ID of the `Spell` that caused this Aura to be applied.
*
* @return :number the `Spell` ID
*/
int GetAuraId(lua_State* L, Aura* aura)
{
Eluna::Push(L, aura->GetId());
return 1;
}
/**
* Returns the amount of time this Aura lasts when applied.
*
* To determine how much time has passed since this Aura was applied,
* subtract the result of `GetDuration` from the result of this method.
*
* @return :number the maximum duration of the Aura, in milliseconds
*/
int GetMaxDuration(lua_State* L, Aura* aura)
{
#ifndef TRINITY
@@ -63,12 +90,24 @@ namespace LuaAura
return 1;
}
/**
* Returns the number of times the Aura has "stacked".
*
* This is the same as the number displayed on the Aura's icon in-game.
*
* @return :number how many times the Aura has stacked
*/
int GetStackAmount(lua_State* L, Aura* aura)
{
Eluna::Push(L, aura->GetStackAmount());
return 1;
}
/**
* Returns the `Unit` that the Aura has been applied to.
*
* @return :Unit who the Aura has been applied to
*/
int GetOwner(lua_State* L, Aura* aura)
{
#ifndef TRINITY
@@ -79,6 +118,11 @@ namespace LuaAura
return 1;
}
/**
* Change the amount of time before the Aura expires.
*
* @param duration :number the new duration of the Aura, in milliseconds
*/
int SetDuration(lua_State* L, Aura* aura)
{
int duration = Eluna::CHECKVAL<int>(L, 2);
@@ -90,6 +134,14 @@ namespace LuaAura
return 0;
}
/**
* Change the maximum amount of time before the Aura expires.
*
* This does not affect the current duration of the Aura, but if the Aura
* is reset to the maximum duration, it will instead change to `duration`.
*
* @param duration :number the new maximum duration of the Aura, in milliseconds
*/
int SetMaxDuration(lua_State* L, Aura* aura)
{
int duration = Eluna::CHECKVAL<int>(L, 2);
@@ -101,6 +153,14 @@ namespace LuaAura
return 0;
}
/**
* Change the amount of times the Aura has "stacked" on the `Unit`.
*
* If `amount` is greater than or equal to the current number of stacks,
* then the Aura has its duration reset to the maximum duration.
*
* @param amount :number the new stack amount for the Aura
*/
int SetStackAmount(lua_State* L, Aura* aura)
{
int amount = Eluna::CHECKVAL<int>(L, 2);
@@ -112,6 +172,9 @@ namespace LuaAura
return 0;
}
/**
* Remove this Aura from the `Unit` it is applied to.
*/
int Remove(lua_State* /*L*/, Aura* aura)
{
#ifndef TRINITY

25
LuaFunctions.cpp
View File

@@ -904,23 +904,22 @@ ElunaRegister<Item> ItemMethods[] =
ElunaRegister<Aura> AuraMethods[] =
{
// Getters
{ "GetCaster", &LuaAura::GetCaster }, // :GetCaster() - Returns caster as object
{ "GetCasterGUID", &LuaAura::GetCasterGUID }, // :GetCasterGUID() - Returns caster as GUID
{ "GetCasterLevel", &LuaAura::GetCasterLevel }, // :GetCasterLevel() - Returns casters level
{ "GetDuration", &LuaAura::GetDuration }, // :GetDuration() - Returns remaining duration
{ "GetMaxDuration", &LuaAura::GetMaxDuration }, // :GetMaxDuration() - Returns maximum duration
{ "GetCharges", &LuaAura::GetCharges }, // :GetCharges() - Returns remaining charges
{ "GetAuraId", &LuaAura::GetAuraId }, // :GetAuraId() - Returns aura ID
{ "GetStackAmount", &LuaAura::GetStackAmount }, // :GetStackAmount() - Returns current stack amount
{ "GetOwner", &LuaAura::GetOwner }, // :GetOwner() - Gets the unit wearing the aura
{ "GetCaster", &LuaAura::GetCaster },
{ "GetCasterGUID", &LuaAura::GetCasterGUID },
{ "GetCasterLevel", &LuaAura::GetCasterLevel },
{ "GetDuration", &LuaAura::GetDuration },
{ "GetMaxDuration", &LuaAura::GetMaxDuration },
{ "GetAuraId", &LuaAura::GetAuraId },
{ "GetStackAmount", &LuaAura::GetStackAmount },
{ "GetOwner", &LuaAura::GetOwner },
// Setters
{ "SetDuration", &LuaAura::SetDuration }, // :SetDuration(duration) - Sets remaining duration
{ "SetMaxDuration", &LuaAura::SetMaxDuration }, // :SetMaxDuration(duration) - Sets maximum duration
{ "SetStackAmount", &LuaAura::SetStackAmount }, // :SetStackAmount(amount) - Sets current stack amount
{ "SetDuration", &LuaAura::SetDuration },
{ "SetMaxDuration", &LuaAura::SetMaxDuration },
{ "SetStackAmount", &LuaAura::SetStackAmount },
// Other
{ "Remove", &LuaAura::Remove }, // :Remove() - Removes the aura
{ "Remove", &LuaAura::Remove },
{ NULL, NULL },
};