/// <summary>Gets a Field-of-View for this board synchronously.</summary>
public static IFov GetFieldOfView(this IFovBoard <IHex> @this, HexCoords origin, FovTargetMode targetMode, int heightOfMan, int hexesPerMile)
{
Traces.FieldOfView.Trace("GetFieldOfView");
var fov = new ArrayFieldOfView(@this);
if (@this.IsPassable(origin))
{
ShadowCasting.ComputeFieldOfView(origin, @this, targetMode, coords => fov[coords] = true, heightOfMan, hexesPerMile);
}
return(fov);
}
/// <summary>Gets a Field-of-View for this board synchronously.</summary>
public static IShadingMask GetFieldOfView(this IFovBoard @this, HexCoords origin, int fovRadius, FovTargetMode targetMode, int heightOfMan, int hexesPerMile)
{
Tracing.FieldOfView.Trace("GetFieldOfView");
var fov = new ArrayFieldOfView(@this);
if (@this.IsOverseeable(origin))
{
ShadowCasting.ComputeFieldOfView(@this, origin, fovRadius, targetMode, coords => fov[coords] = true, heightOfMan, hexesPerMile);
}
return(fov);
}
/// <summary>Calculate Field-of-View from a specified TargetMode, assuming a spherical earth
/// and height measured in feet if <code>hexesPerMile</code> is not equal 0.</summary>
/// <param name="coordsObserver">Cordinates of observer;s hex.</param>
/// <param name="board">A reference to an IFovBoard {IHex} instance.</param>
/// <param name="targetMode">TargetMode value for determining target visibility.</param>
/// <param name="setFieldOfView">Sets a hex as visible in the Field-of-View.</param>
/// <param name="defaultHeight">Height used for observer and target when targetMode = EqualHeights/</param>
/// <param name="hexesPerMile">Number of hexes per mile (ie 1/4000 of planet radius).</param>
/// <remarks>Adjusts visibility for curvature of the Earth. This is the only version of
/// ComputeFieldOfView that is <b>not</b> scale invariant for height, and assumes that height
/// is measured in feet.
/// </remarks>
/// <a href="http://mathcentral.uregina.ca/qq/database/QQ.09.02/shirley3.html">Hidden by the Curvature of the Earth</a>
public static void ComputeFieldOfView(
HexCoords coordsObserver,
IFovBoard <IHex> board,
FovTargetMode targetMode,
Action <HexCoords> setFieldOfView,
int defaultHeight,
int hexesPerMile
)
{
int CalculationHeightUnits = UseMetric ? 5 // convert metres to cm for greater precision
: 12; // convert feet to inches for greater precision
Func <HexCoords, int> elevationTarget;
int elevationObserver;
switch (targetMode)
{
case FovTargetMode.TargetHeightEqualZero:
elevationTarget = coords => board.ElevationGroundASL(coords);
elevationObserver = board.ElevationObserverASL(coordsObserver);
break;
default:
case FovTargetMode.TargetHeightEqualActual:
elevationTarget = coords => board.ElevationTargetASL(coords);
elevationObserver = board.ElevationObserverASL(coordsObserver);
break;
case FovTargetMode.EqualHeights:
elevationTarget = coords => board.ElevationGroundASL(coords) + defaultHeight;
elevationObserver = elevationTarget(coordsObserver);
break;
}
Func <HexCoords, int> deltaHeight = GetDeltaHeight(coordsObserver, hexesPerMile, CalculationHeightUnits);
ShadowCasting.ComputeFieldOfView(
coordsObserver,
board.FovRadius - 1,
elevationObserver * CalculationHeightUnits,
board.IsOnboard,
coords => elevationTarget(coords) * CalculationHeightUnits - deltaHeight(coords),
(coords, hexside) => board.ElevationHexsideASL(coords, hexside) * CalculationHeightUnits - deltaHeight(coords),
setFieldOfView
);
}