ApprovedSnapshots:
Wayback periodically saves the current state of a unit in a "snapshot", which is identified by a unique ID generated with GMUI (using the generic Recycle Key: 1). Because of the way snapshots are saved, advanced users can save their own data in a snapshot, allowing for more than just unit life, mana and position to be saved and restored.
Hashtable:
Unit Handle ID
0 -> timer
1 -> GLL List
2 -> snapshot counter
3 -> maximum snapshots (determines max rewind time = period * maximum snapshots)
Timer Handle ID
0 -> unit
(negative) Snapshot ID
0 -> unit HP
1 -> unit MP
2 -> unit X
3 -> unit Y
Wayback_Unit | The unit we wish to register in the system. |
Wayback_Time | The maximum time the unit will be able to return in time. |
Wayback_Precision | How precise the system will be (time between each snapshot) |
Actions
Set Wayback_Unit = YourUnit
Set Wayback_Time = YourMaxTime
Set Wayback_Precision = YourDesiredPrecision
Trigger - Run Wayback Main <gen> (ignoring conditions)
Wayback_Unit | The unit we wish to unregister from the system. |
Wayback_Time | We set this to a negative number when we want to unregister a unit. |
Actions
Set Wayback_Unit = YourUnit
Set Wayback_Time = -1
Trigger - Run Wayback Main <gen> (ignoring conditions)
Wayback_Unit | The unit we want to take back through time. |
Wayback_Time | The amount of time (in seconds) the unit will go back (0 for maximum). Use a non-negative number. |
Actions
Set Wayback_Unit = YourUnit
Set Wayback_Time = YourTime (non-negative, 0 for max)
Trigger - Run Wayback Main <gen> (checking conditions)
Wayback_Unit | The unit we want to take back through time. |
Wayback_Time | The amount of time (in seconds) the unit will go back. Use a negative number. |
Wayback_Precision | How much time the rewind should take. |
Actions
Set Wayback_Unit = YourUnit
Set Wayback_Time = YourTime (negative number)
Set Wayback_Precision = YourDuration
Trigger - Run Wayback Main <gen> (checking conditions)
//===========================================================================
// Easy Configuration
//===========================================================================
// Use the functions/textmacros defined here to change the behaviour of the system by changing
// what data is stored in a snapshot. You could, for example, store the unit's flying height as
// well by simply adding the commented out lines at the end of each function.
//! novjass
function StoreSnapshotData takes integer snapshot, unit whichUnit returns nothing
//! endnovjass
//! textmacro StoreSnapshotData
//Whenever a new snapshot of a unit is created, this code is run to store data.
//You can alter this function(JASS)/textmacro(vJASS) to store whatever values you need.
call SaveReal(udg_Wayback_Hashtable, snapshot, 0, GetUnitState(whichUnit, UNIT_STATE_LIFE))
call SaveReal(udg_Wayback_Hashtable, snapshot, 1, GetUnitState(whichUnit, UNIT_STATE_MANA))
call SaveReal(udg_Wayback_Hashtable, snapshot, 2, GetUnitX(whichUnit))
call SaveReal(udg_Wayback_Hashtable, snapshot, 3, GetUnitY(whichUnit))
// Example of user-defined data:
//call SaveReal(udg_Wayback_Hashtable, snapshot, 4, GetUnitFlyHeight(whichUnit))
//! endtextmacro
//! novjass
endfunction
//! endnovjass
//! novjass
function UnitLoadSnapshot takes integer snapshot, unit whichUnit returns nothing
//! endnovjass
//! textmacro UnitLoadSnapshot
//Whenever a new snapshot of a unit is created, this code is to restore the unit.
//You can alter this function(JASS)/textmacro(vJASS) to use any custom data you have added.
call SetUnitState(whichUnit, UNIT_STATE_LIFE, LoadReal(udg_Wayback_Hashtable, snapshot, 0))
call SetUnitState(whichUnit, UNIT_STATE_MANA, LoadReal(udg_Wayback_Hashtable, snapshot, 1))
call SetUnitX(whichUnit, LoadReal(udg_Wayback_Hashtable, snapshot, 2))
call SetUnitY(whichUnit, LoadReal(udg_Wayback_Hashtable, snapshot, 3))
// Example of user-defined data:
//call SetUnitFlyHeight(whichUnit, LoadReal(udg_Wayback_Hashtable, snapshot, 4))
//! endtextmacro
//! novjass
endfunction
//! endnovjass//===========================================================================
// Code and API
//===========================================================================
//=======
//Register Unit functions
//=======
//Registers a unit in the System, allowing you to specify a function for the periodic timer
function Wayback_RegisterUnitEx takes unit whichUnit, real period, integer maxSnapshots, code timerFunc returns nothing
endfunction
//Register unit with default timer function
function Wayback_RegisterUnit takes unit whichUnit, real period, integer maxSnapshots returns nothing
endfunction
//Register unit using a duration instead of maximum snapshots and using default timer function
function Wayback_RegisterUnitDuration takes unit whichUnit, real period, real duration, real period2 returns nothing
endfunction
//Register unit using a duration instead of maximum snapshots
function Wayback_RegisterUnitDurationEx takes unit whichUnit, real period, real duration, real period2, code timerFunc returns nothing
endfunction
//Unregisters a unit from the system, deleting all snapshot data and the timer
function Wayback_UnregisterUnit takes unit whichUnit returns nothing
endfunction
//=======
//Restoring and Rewinding functions
//=======
//Instantly restores a unit to their oldest snapshot
//Returns the ID of the snapshot for extended functionality
function Wayback_RestoreUnit takes unit whichUnit returns integer
endfunction
//Instantly moves unit "time" seconds back in time, up to their oldest snapshot
//Returns the ID of the snapshot for extended functionality
function Wayback_RestoreUnitEx takes unit whichUnit, real time returns integer
endfunction
//Instantly moves unit a single snapshot back in time
//The unit ID variable should be the unit's handle ID
//Returns the ID of the snapshot for extended functionality
function Wayback_RestoreUnitByIdOneStep takes unit whichUnit, integer unitID returns integer
endfunction
//Instantly moves unit a single snapshot back in time
//Returns the ID of the snapshot for extended functionality
function Wayback_RestoreUnitOneStep takes unit whichUnit returns integer
endfunction
//=======
//Takes a unit back in "time" seconds in time, snapshot-by-snapshot, over "duration" seconds
function Wayback_RewindUnit takes unit whichUnit, real time, real duration returns nothing
endfunction
////////////////////////////////////////////////////////////////////////////////////////////////////
//End of Wayback
////////////////////////////////////////////////////////////////////////////////////////////////////Command | Action |
unregister | Unregisters all units from the system |
register | Registers all units in the system |
wayback | returns a unit 1 second in time |
rewind | slowly rewinds a unit 2.5 seconds back in time |
Thanks for responding. I did all the step you listed in the 'How to Import', but now it has more script errors...
