Tactics - Learning Game AI Programming with Lua - page 542

Drawing influence maps
To display the current state of the influence map, you can call Sand-
box.DrawInfluenceMap . The influenceMapLayer function that is passed in de-
termines which of the 10 possible layers are to be drawn. As our influence maps support
both positive and negative influences, three different colors are used to draw the resulting
map:
Sandbox.DrawInfluenceMap(
sandbox,
influenceMapLayer,
positiveInfluenceColor,
neutralInfluenceColor,
negativeInfluenceColor);
Each color passed to DrawInfluenceMap is a Lua table that represents the red, green,
blue, and alpha properties of the color in the range of 0 to 1. In the earlier cases, the influ-
ence map was drawn with these settings:
Sandbox.DrawInfluenceMap(
sandbox,
0,
{ 0, 0, 1, 0.9 },
{ 0, 0, 0, 0.75 },
{ 1, 0, 0, 0.9 });
Note
Drawing the influence map only shows what the influence map looks like at that exact mo-
ment. The debug drawing of the influence map will not get updated on its own. Adding a
keyboard shortcut to manually refresh the debug influence map can be helpful in debug-
ging issues.
In order to hide or show the drawn influence map, you can call SetInfluenceMap ,
passing in whether to hide or show the previously drawn influence map. By default, draw-
ing the influence map is enabled:
Sandbox.SetInfluenceMap(sandbox, enabled);