Name | Type | is_array | initial_value |
//TESH.scrollpos=0
//TESH.alwaysfold=0
library ScaleSystem /*
Scale System v1.00
by Flux
Scale System provides a scaling system for units gradually changing the
scale of a unit instead of instantly. The system aims to replace
SetUnitScale which conflicts with itself if used in different parts
of the code.
NOTE:
Any SetUnitScale used before the system will be ignored.
CREDITS:
Bribe - Table
*/ requires /*
*/ optional Table /*
If not found, the system will use a hashtable. Hashtables are limited to 255 per map.
******************************************************************
API
******************************************************************
*/
//! novjass
struct Scale
static method create takes unit u, real addedScale returns thistype
//Create a Scale instance on a unit. Example:
local Scale s = Scale.create(<yourUnit>, 0.5)
//Will increase the scaling of <yourUnit> to 1.5 because 0.5 were added to it
public real speed
//Refers to how fast the Scale instance scales per second. Example:
local Scale s = Scale.create(<yourUnit>, 0.5)
set s.speed = 0.5
//This means that after 1 second, <yourUnit> have gained 0.5 scale
//Another example:
local Scale s = Scale.create(<yourUnit>, 1.0)
set s.speed = 0.5
//This means that it will take 2 seconds for the Scaling animation to finish
//because it can only scale 0.5 per second.
public real duration
//Refers to the duration of the scale instance. Example
local Scale s = Scale.create(<yourUnit>, 0.5)
set s.duration = 5.0
//After 5 seconds, <yourUnit> will start to decrease in scale.
static method get takes unit u returns real
//Returns the current scale of a unit. Returns 1.0 if the unit is currently unaffected
//by the Scale System.
method destroy takes nothing returns nothing
//Destroy a Scale instance. You mostly won't need this if the Scale instance
//has a duration.
//! endnovjass
globals
//Scaling Speed per second used as default.
private constant real DEFAULT_SPEED = 1.0
private constant real TIMEOUT = 0.05
endglobals
struct Scale
public real speed
public real duration
private unit u
private real add
private real subtract
private integer id
static if LIBRARY_Table then
private static Table tb
else
private static hashtable hash = InitHashtable()
endif
private static timer t = CreateTimer()
private thistype next
private thistype prev
method destroy takes nothing returns nothing
set this.duration = 0
endmethod
static method get takes unit u returns real
local integer id = GetHandleId(u)
static if LIBRARY_Table then
if thistype.tb.has(id) then
return thistype.tb.real[id]
endif
else
if HaveSavedReal(thistype.hash, id, 0) then
return LoadReal(thistype.hash, id, 0)
endif
endif
return 1.0
endmethod
private static method onPeriod takes nothing returns nothing
local thistype this = thistype(0).next
local real added
local real new
loop
exitwhen this == 0
set this.duration = this.duration - TIMEOUT
if this.duration > 0 then
if this.add != 0 then
if this.add > 0 then
set added = RMinBJ(this.add, this.speed*TIMEOUT)
else
set added = -RMinBJ(RAbsBJ(this.add), this.speed*TIMEOUT)
endif
set this.add = this.add - added
set this.subtract = this.subtract + added
static if LIBRARY_Table then
set new = thistype.tb.real[this.id] + added
set thistype.tb.real[this.id] = new
else
set new = LoadReal(thistype.hash, this.id, 0) + added
call SaveReal(thistype.hash, this.id, 0, new)
endif
call SetUnitScale(this.u, new, 0, 0)
endif
else
if this.subtract != 0 then
if this.subtract > 0 then
set added = RMinBJ(this.subtract, this.speed*TIMEOUT)
else
set added = -RMinBJ(RAbsBJ(this.subtract), this.speed*TIMEOUT)
endif
set this.subtract = this.subtract - added
static if LIBRARY_Table then
set new = thistype.tb.real[this.id] - added
set thistype.tb.real[this.id] = new
else
set new = LoadReal(thistype.hash, this.id, 0) - added
call SaveReal(thistype.hash, this.id, 0, new)
endif
call SetUnitScale(this.u, new, 0, 0)
else
static if LIBRARY_Table then
set thistype.tb[this.id] = thistype.tb[this.id] - 1
if thistype.tb[this.id] == 0 then
call thistype.tb.remove(this.id)
call thistype.tb.real.remove(this.id)
endif
else
call SaveInteger(thistype.hash, this.id, 0, LoadInteger(thistype.hash, this.id, 0) - 1)
if LoadInteger(thistype.hash, this.id, 0) == 0 then
call RemoveSavedInteger(thistype.hash, this.id, 0)
call RemoveSavedReal(thistype.hash, this.id, 0)
endif
endif
set this.next.prev = this.prev
set this.prev.next = this.next
if thistype(0).next == 0 then
call PauseTimer(thistype.t)
endif
set this.u = null
call this.deallocate()
endif
endif
set this = this.next
endloop
endmethod
static method create takes unit u, real addedScale returns thistype
local thistype this = thistype.allocate()
set this.u = u
set this.id = GetHandleId(u)
set this.speed = DEFAULT_SPEED
set this.add = addedScale
set this.subtract = 0
set this.duration = 0xFFFFFF
static if LIBRARY_Table then
if thistype.tb.real.has(this.id) then
set thistype.tb[this.id] = thistype.tb[this.id] + 1
else
set thistype.tb.real[this.id] = 1.0
set thistype.tb[this.id] = 1
endif
else
if HaveSavedReal(thistype.hash, this.id, 0) then
call SaveInteger(thistype.hash, this.id, 0, LoadInteger(thistype.hash, this.id, 0) + 1)
else
call SaveReal(thistype.hash, this.id, 0, 1.0)
call SaveInteger(thistype.hash, this.id, 0, 1)
endif
endif
set this.next = thistype(0)
set this.prev = thistype(0).prev
set this.prev.next = this
set this.next.prev = this
if this.prev == 0 then
call TimerStart(thistype.t, TIMEOUT, true, function thistype.onPeriod)
endif
return this
endmethod
static if LIBRARY_Table then
private static method onInit takes nothing returns nothing
set thistype.tb = Table.create()
endmethod
endif
endstruct
endlibrary
//TESH.scrollpos=23
//TESH.alwaysfold=0
library Table /* made by Bribe, special thanks to Vexorian & Nestharus, version 4.1.0.1.
One map, one hashtable. Welcome to NewTable 4.1.0.1
This newest iteration of Table introduces the new HashTable struct.
You can now instantiate HashTables which enables the use of large
parent and large child keys, just like a standard hashtable. Previously,
the user would have to instantiate a Table to do this on their own which -
while doable - is something the user should not have to do if I can add it
to this resource myself (especially if they are inexperienced).
This library was originally called NewTable so it didn't conflict with
the API of Table by Vexorian. However, the damage is done and it's too
late to change the library name now. To help with damage control, I
have provided an extension library called TableBC, which bridges all
the functionality of Vexorian's Table except for 2-D string arrays &
the ".flush(integer)" method. I use ".flush()" to flush a child hash-
table, because I wanted the API in NewTable to reflect the API of real
hashtables (I thought this would be more intuitive).
API
------------
struct Table
| static method create takes nothing returns Table
| create a new Table
|
| method destroy takes nothing returns nothing
| destroy it
|
| method flush takes nothing returns nothing
| flush all stored values inside of it
|
| method remove takes integer key returns nothing
| remove the value at index "key"
|
| method operator []= takes integer key, $TYPE$ value returns nothing
| assign "value" to index "key"
|
| method operator [] takes integer key returns $TYPE$
| load the value at index "key"
|
| method has takes integer key returns boolean
| whether or not the key was assigned
|
----------------
struct TableArray
| static method operator [] takes integer array_size returns TableArray
| create a new array of Tables of size "array_size"
|
| method destroy takes nothing returns nothing
| destroy it
|
| method flush takes nothing returns nothing
| flush and destroy it
|
| method operator size takes nothing returns integer
| returns the size of the TableArray
|
| method operator [] takes integer key returns Table
| returns a Table accessible exclusively to index "key"
*/
globals
private integer less = 0 //Index generation for TableArrays (below 0).
private integer more = 8190 //Index generation for Tables.
//Configure it if you use more than 8190 "key" variables in your map (this will never happen though).
private hashtable ht = InitHashtable()
private key sizeK
private key listK
endglobals
private struct dex extends array
static method operator size takes nothing returns Table
return sizeK
endmethod
static method operator list takes nothing returns Table
return listK
endmethod
endstruct
private struct handles extends array
method has takes integer key returns boolean
return HaveSavedHandle(ht, this, key)
endmethod
method remove takes integer key returns nothing
call RemoveSavedHandle(ht, this, key)
endmethod
endstruct
private struct agents extends array
method operator []= takes integer key, agent value returns nothing
call SaveAgentHandle(ht, this, key, value)
endmethod
endstruct
//! textmacro NEW_ARRAY_BASIC takes SUPER, FUNC, TYPE
private struct $TYPE$s extends array
method operator [] takes integer key returns $TYPE$
return Load$FUNC$(ht, this, key)
endmethod
method operator []= takes integer key, $TYPE$ value returns nothing
call Save$FUNC$(ht, this, key, value)
endmethod
method has takes integer key returns boolean
return HaveSaved$SUPER$(ht, this, key)
endmethod
method remove takes integer key returns nothing
call RemoveSaved$SUPER$(ht, this, key)
endmethod
endstruct
private module $TYPE$m
method operator $TYPE$ takes nothing returns $TYPE$s
return this
endmethod
endmodule
//! endtextmacro
//! textmacro NEW_ARRAY takes FUNC, TYPE
private struct $TYPE$s extends array
method operator [] takes integer key returns $TYPE$
return Load$FUNC$Handle(ht, this, key)
endmethod
method operator []= takes integer key, $TYPE$ value returns nothing
call Save$FUNC$Handle(ht, this, key, value)
endmethod
method has takes integer key returns boolean
return HaveSavedHandle(ht, this, key)
endmethod
method remove takes integer key returns nothing
call RemoveSavedHandle(ht, this, key)
endmethod
endstruct
private module $TYPE$m
method operator $TYPE$ takes nothing returns $TYPE$s
return this
endmethod
endmodule
//! endtextmacro
//Run these textmacros to include the entire hashtable API as wrappers.
//Don't be intimidated by the number of macros - Vexorian's map optimizer is
//supposed to kill functions which inline (all of these functions inline).
//! runtextmacro NEW_ARRAY_BASIC("Real", "Real", "real")
//! runtextmacro NEW_ARRAY_BASIC("Boolean", "Boolean", "boolean")
//! runtextmacro NEW_ARRAY_BASIC("String", "Str", "string")
//New textmacro to allow table.integer[] syntax for compatibility with textmacros that might desire it.
//! runtextmacro NEW_ARRAY_BASIC("Integer", "Integer", "integer")
//! runtextmacro NEW_ARRAY("Player", "player")
//! runtextmacro NEW_ARRAY("Widget", "widget")
//! runtextmacro NEW_ARRAY("Destructable", "destructable")
//! runtextmacro NEW_ARRAY("Item", "item")
//! runtextmacro NEW_ARRAY("Unit", "unit")
//! runtextmacro NEW_ARRAY("Ability", "ability")
//! runtextmacro NEW_ARRAY("Timer", "timer")
//! runtextmacro NEW_ARRAY("Trigger", "trigger")
//! runtextmacro NEW_ARRAY("TriggerCondition", "triggercondition")
//! runtextmacro NEW_ARRAY("TriggerAction", "triggeraction")
//! runtextmacro NEW_ARRAY("TriggerEvent", "event")
//! runtextmacro NEW_ARRAY("Force", "force")
//! runtextmacro NEW_ARRAY("Group", "group")
//! runtextmacro NEW_ARRAY("Location", "location")
//! runtextmacro NEW_ARRAY("Rect", "rect")
//! runtextmacro NEW_ARRAY("BooleanExpr", "boolexpr")
//! runtextmacro NEW_ARRAY("Sound", "sound")
//! runtextmacro NEW_ARRAY("Effect", "effect")
//! runtextmacro NEW_ARRAY("UnitPool", "unitpool")
//! runtextmacro NEW_ARRAY("ItemPool", "itempool")
//! runtextmacro NEW_ARRAY("Quest", "quest")
//! runtextmacro NEW_ARRAY("QuestItem", "questitem")
//! runtextmacro NEW_ARRAY("DefeatCondition", "defeatcondition")
//! runtextmacro NEW_ARRAY("TimerDialog", "timerdialog")
//! runtextmacro NEW_ARRAY("Leaderboard", "leaderboard")
//! runtextmacro NEW_ARRAY("Multiboard", "multiboard")
//! runtextmacro NEW_ARRAY("MultiboardItem", "multiboarditem")
//! runtextmacro NEW_ARRAY("Trackable", "trackable")
//! runtextmacro NEW_ARRAY("Dialog", "dialog")
//! runtextmacro NEW_ARRAY("Button", "button")
//! runtextmacro NEW_ARRAY("TextTag", "texttag")
//! runtextmacro NEW_ARRAY("Lightning", "lightning")
//! runtextmacro NEW_ARRAY("Image", "image")
//! runtextmacro NEW_ARRAY("Ubersplat", "ubersplat")
//! runtextmacro NEW_ARRAY("Region", "region")
//! runtextmacro NEW_ARRAY("FogState", "fogstate")
//! runtextmacro NEW_ARRAY("FogModifier", "fogmodifier")
//! runtextmacro NEW_ARRAY("Hashtable", "hashtable")
struct Table extends array
// Implement modules for intuitive syntax (tb.handle; tb.unit; etc.)
implement realm
implement integerm
implement booleanm
implement stringm
implement playerm
implement widgetm
implement destructablem
implement itemm
implement unitm
implement abilitym
implement timerm
implement triggerm
implement triggerconditionm
implement triggeractionm
implement eventm
implement forcem
implement groupm
implement locationm
implement rectm
implement boolexprm
implement soundm
implement effectm
implement unitpoolm
implement itempoolm
implement questm
implement questitemm
implement defeatconditionm
implement timerdialogm
implement leaderboardm
implement multiboardm
implement multiboarditemm
implement trackablem
implement dialogm
implement buttonm
implement texttagm
implement lightningm
implement imagem
implement ubersplatm
implement regionm
implement fogstatem
implement fogmodifierm
implement hashtablem
method operator handle takes nothing returns handles
return this
endmethod
method operator agent takes nothing returns agents
return this
endmethod
//set this = tb[GetSpellAbilityId()]
method operator [] takes integer key returns Table
return LoadInteger(ht, this, key) //return this.integer[key]
endmethod
//set tb[389034] = 8192
method operator []= takes integer key, Table tb returns nothing
call SaveInteger(ht, this, key, tb) //set this.integer[key] = tb
endmethod
//set b = tb.has(2493223)
method has takes integer key returns boolean
return HaveSavedInteger(ht, this, key) //return this.integer.has(key)
endmethod
//call tb.remove(294080)
method remove takes integer key returns nothing
call RemoveSavedInteger(ht, this, key) //call this.integer.remove(key)
endmethod
//Remove all data from a Table instance
method flush takes nothing returns nothing
call FlushChildHashtable(ht, this)
endmethod
//local Table tb = Table.create()
static method create takes nothing returns Table
local Table this = dex.list[0]
if this == 0 then
set this = more + 1
set more = this
else
set dex.list[0] = dex.list[this]
call dex.list.remove(this) //Clear hashed memory
endif
debug set dex.list[this] = -1
return this
endmethod
// Removes all data from a Table instance and recycles its index.
//
// call tb.destroy()
//
method destroy takes nothing returns nothing
debug if dex.list[this] != -1 then
debug call BJDebugMsg("Table Error: Tried to double-free instance: " + I2S(this))
debug return
debug endif
call this.flush()
set dex.list[this] = dex.list[0]
set dex.list[0] = this
endmethod
//! runtextmacro optional TABLE_BC_METHODS()
endstruct
//! runtextmacro optional TABLE_BC_STRUCTS()
struct TableArray extends array
//Returns a new TableArray to do your bidding. Simply use:
//
// local TableArray ta = TableArray[array_size]
//
static method operator [] takes integer array_size returns TableArray
local Table tb = dex.size[array_size] //Get the unique recycle list for this array size
local TableArray this = tb[0] //The last-destroyed TableArray that had this array size
debug if array_size <= 0 then
debug call BJDebugMsg("TypeError: Invalid specified TableArray size: " + I2S(array_size))
debug return 0
debug endif
if this == 0 then
set this = less - array_size
set less = this
else
set tb[0] = tb[this] //Set the last destroyed to the last-last destroyed
call tb.remove(this) //Clear hashed memory
endif
set dex.size[this] = array_size //This remembers the array size
return this
endmethod
//Returns the size of the TableArray
method operator size takes nothing returns integer
return dex.size[this]
endmethod
//This magic method enables two-dimensional[array][syntax] for Tables,
//similar to the two-dimensional utility provided by hashtables them-
//selves.
//
//ta[integer a].unit[integer b] = unit u
//ta[integer a][integer c] = integer d
//
//Inline-friendly when not running in debug mode
//
method operator [] takes integer key returns Table
static if DEBUG_MODE then
local integer i = this.size
if i == 0 then
call BJDebugMsg("IndexError: Tried to get key from invalid TableArray instance: " + I2S(this))
return 0
elseif key < 0 or key >= i then
call BJDebugMsg("IndexError: Tried to get key [" + I2S(key) + "] from outside TableArray bounds: " + I2S(i))
return 0
endif
endif
return this + key
endmethod
//Destroys a TableArray without flushing it; I assume you call .flush()
//if you want it flushed too. This is a public method so that you don't
//have to loop through all TableArray indices to flush them if you don't
//need to (ie. if you were flushing all child-keys as you used them).
//
method destroy takes nothing returns nothing
local Table tb = dex.size[this.size]
debug if this.size == 0 then
debug call BJDebugMsg("TypeError: Tried to destroy an invalid TableArray: " + I2S(this))
debug return
debug endif
if tb == 0 then
//Create a Table to index recycled instances with their array size
set tb = Table.create()
set dex.size[this.size] = tb
endif
call dex.size.remove(this) //Clear the array size from hash memory
set tb[this] = tb[0]
set tb[0] = this
endmethod
private static Table tempTable
private static integer tempEnd
//Avoids hitting the op limit
private static method clean takes nothing returns nothing
local Table tb = .tempTable
local integer end = tb + 0x1000
if end < .tempEnd then
set .tempTable = end
call ForForce(bj_FORCE_PLAYER[0], function thistype.clean)
else
set end = .tempEnd
endif
loop
call tb.flush()
set tb = tb + 1
exitwhen tb == end
endloop
endmethod
//Flushes the TableArray and also destroys it. Doesn't get any more
//similar to the FlushParentHashtable native than this.
//
method flush takes nothing returns nothing
debug if this.size == 0 then
debug call BJDebugMsg("TypeError: Tried to flush an invalid TableArray instance: " + I2S(this))
debug return
debug endif
set .tempTable = this
set .tempEnd = this + this.size
call ForForce(bj_FORCE_PLAYER[0], function thistype.clean)
call this.destroy()
endmethod
endstruct
//NEW: Added in Table 4.0. A fairly simple struct but allows you to do more
//than that which was previously possible.
struct HashTable extends array
//Enables myHash[parentKey][childKey] syntax.
//Basically, it creates a Table in the place of the parent key if
//it didn't already get created earlier.
method operator [] takes integer index returns Table
local Table t = Table(this)[index]
if t == 0 then
set t = Table.create()
set Table(this)[index] = t //whoops! Forgot that line. I'm out of practice!
endif
return t
endmethod
//You need to call this on each parent key that you used if you
//intend to destroy the HashTable or simply no longer need that key.
method remove takes integer index returns nothing
local Table t = Table(this)[index]
if t != 0 then
call t.destroy()
call Table(this).remove(index)
endif
endmethod
//Added in version 4.1
method has takes integer index returns boolean
return Table(this).has(index)
endmethod
//HashTables are just fancy Table indices.
method destroy takes nothing returns nothing
call Table(this).destroy()
endmethod
//Like I said above...
static method create takes nothing returns thistype
return Table.create()
endmethod
endstruct
endlibrary
//TESH.scrollpos=0
//TESH.alwaysfold=0
library ScaleTest initializer OnInit uses ScaleSystem
globals
private constant real SPEED = 0.5
private constant real DURATION = 3.0
endglobals
private function BeginTest takes nothing returns boolean
local string chat = GetEventPlayerChatString()
local real value = S2R(SubString(chat, 5, StringLength(chat)))
local Scale sc = Scale.create(gg_unit_hfoo_0000, value)
set sc.duration = DURATION
set sc.speed = SPEED
call BJDebugMsg("Added " + R2S(value) + " scaling to Footman for " + R2S(sc.duration) + " seconds with scaling speed of " + R2S(sc.speed))
return false
endfunction
private function OnInit takes nothing returns nothing
local trigger t = CreateTrigger()
local string s = "scale"
call TriggerRegisterPlayerChatEvent(t, Player(0), s, false)
call TriggerAddCondition(t, Condition(function BeginTest))
//Test Messages
call TriggerSleepAction(0.1)
call BJDebugMsg("Type '" + s + "???' in chat to add unit scaling to Footman")
endfunction
endlibrary