/// <summary>
/// Returns true, if ground is within DISTANCE _below_ you.
/// </summary>
/// <param name="location"></param>
/// <param name="distance"></param>
/// <returns>true, if ground is within DISTANCE _below_ you.</returns>
/// <remarks>17Apr2011-12:16UTC chinajade</remarks>
public static bool IsOverGround(this WoWPoint location, double distance)
{
QuestBehaviorBase.ContractRequires(distance >= 0.0, context => "distance >= 0.0");
return(GameWorld.TraceLine(location.Add(0.0, 0.0, 1.0),
location.Add(0.0, 0.0, -distance),
GameWorld.CGWorldFrameHitFlags.HitTestGroundAndStructures));
}
/// <summary>
/// <para>Finds another point near the destination. Useful when toon is 'waiting' for something
/// (e.g., boat, mob repops, etc). This allows multiple people running
/// the same profile to not stand on top of each other while waiting for
/// something.</para>
/// <para>Notes:<list type="bullet">
/// <item><description><para> * The returned WoWPoint is carefully chosen. The returned WoWPoint
/// will not cause you to fall off a boat dock or Zeppelin landing.</para></description></item>
/// </list></para>
/// </summary>
/// <param name="location"></param>
/// <param name="maxRadius"></param>
/// <returns></returns>
/// <remarks>17Apr2011-12:16UTC chinajade</remarks>
public static WoWPoint FanOutRandom(this WoWPoint location, double maxRadius)
{
QuestBehaviorBase.ContractRequires(maxRadius >= 0.0, context => "maxRadius >= 0.0");
const int CYLINDER_LINE_COUNT = 12;
const int MAX_TRIES = 50;
const double SAFE_DISTANCE_BUFFER = 1.75;
WoWPoint candidateDestination = location;
int tryCount;
// Most of the time we'll find a viable spot in less than 2 tries...
// However, if you're standing on a pier, or small platform a
// viable alternative may take 10-15 tries--its all up to the
// random number generator.
for (tryCount = MAX_TRIES; tryCount > 0; --tryCount)
{
WoWPoint circlePoint;
bool[] hitResults;
WoWPoint[] hitPoints;
int index;
WorldLine[] traceLines = new WorldLine[CYLINDER_LINE_COUNT + 1];
candidateDestination = location.AddPolarXY((TAU * _random.NextDouble()), (maxRadius * _random.NextDouble()), 0.0);
// Build set of tracelines that can evaluate the candidate destination --
// We build a cone of lines with the cone's base at the destination's 'feet',
// and the cone's point at maxRadius over the destination's 'head'. We also
// include the cone 'normal' as the first entry.
// 'Normal' vector
index = 0;
traceLines[index].Start = candidateDestination.Add(0.0, 0.0, maxRadius);
traceLines[index].End = candidateDestination.Add(0.0, 0.0, -maxRadius);
// Cylinder vectors
for (double turnFraction = 0.0; turnFraction < TAU; turnFraction += (TAU / CYLINDER_LINE_COUNT))
{
++index;
circlePoint = candidateDestination.AddPolarXY(turnFraction, SAFE_DISTANCE_BUFFER, 0.0);
traceLines[index].Start = circlePoint.Add(0.0, 0.0, maxRadius);
traceLines[index].End = circlePoint.Add(0.0, 0.0, -maxRadius);
}
// Evaluate the cylinder...
// The result for the 'normal' vector (first one) will be the location where the
// destination meets the ground. Before this MassTrace, only the candidateDestination's
// X/Y values were valid.
GameWorld.MassTraceLine(traceLines.ToArray(),
GameWorld.CGWorldFrameHitFlags.HitTestGroundAndStructures,
out hitResults,
out hitPoints);
candidateDestination = hitPoints[0]; // From 'normal', Destination with valid Z coordinate
// Sanity check...
// We don't want to be standing right on the edge of a drop-off (say we'e on
// a plaform or pier). If there is not solid ground all around us, we reject
// the candidate. Our test for validity is that the walking distance must
// not be more than 20% greater than the straight-line distance to the point.
int viableVectorCount = hitPoints.Sum(point => ((Me.Location.SurfacePathDistance(point) < (Me.Location.Distance(point) * 1.20))
? 1
: 0));
if (viableVectorCount < (CYLINDER_LINE_COUNT + 1))
{
continue;
}
// If new destination is 'too close' to our current position, try again...
if (Me.Location.Distance(candidateDestination) <= SAFE_DISTANCE_BUFFER)
{
continue;
}
break;
}
// If we exhausted our tries, just go with simple destination --
if (tryCount <= 0)
{
candidateDestination = location;
}
return(candidateDestination);
}