[Snippet] GetWidgetMeasures

*                     GEOMETRY MEASURES V1.1                      *

*                           By moyack                             *

*                              2012                               *

*              ===================================                *

*              Exclusive resource from wc3jass.com                *

*              ===================================                *

******************************************************************/

library GetWidgetMeasures requires GeometryLibBase

/*This is the first of a set of libraries focused in the usage of

proper geometry functions.

Here we'll aim to make the code as modular as possible so we can

reduce the code amount in map but offering the neccesary tools 

for modders

Here we offer some basic functions realated to widgets (units,

destructables and items):

GetWidgetsDistance: allows to calculate the distance between 2 widgets.

                    Here you can have any combination: unit-unit, unit-

                    destructable, item unit, etc.

GetWidgetsAngle: Gets the angle between 2 widgets. Like the previus

                 function, it allows to compare between units, unit-item,

                 unit-destructable, etc.

GetUnitsDistanceZ: Get the distance between 2 units, taking into account

                   their respectives locations and flyheights.

GetUnitsZAngle: Returns the elevation angle between unit a and unit b.

IMPORTANT NOTE: GetWidgetsAngle and GetUnitsZAngle returns angles in RADIANS.

*/