Console Configuration
The console can optionally be configured creating a txt file named "console.properties" in the ".deepnode" directory within your user home directory. Here is an example of contents (you MUST include the five timeLevel lines):
timeLevel1=10sec;20;10000
timeLevel2=5sec;40;5000
timeLevel3=2.5sec;50;2500
timeLevel4=.5sec;120;500
timeLevel5=.1sec;60;100
AUTOCONSOL_PARENT_THRESH=20
AUTOCONSOL_THRESH=12
AUTOCONSOL_LEAVES=100
TEXT_DISPLAY_DISTANCE=40
MAX_TEXT_SIZE=.5
ENABLE_JOYSTICK=false
MAX_MEM_MB=1024
MAX_CACHED_LIMBS=200
START_AI=false
The "timeLevel" lines are not optional; if you are going to create a console.properties, you MUST include these five lines. Each has three values, separated by semicolons. The first value is a label for the time level; the second is the number of time slices to include in the level; and the third is the number of milliseconds each time slice should be.
The other configuration items are all optional.
AUTOCONSOL_PARENT_THRESH sets the number of children a node in level 2 (child of a node that is child of root) can have before they all get consolidated into one node.
AUTOCONSOL_THRESH is the number of children a node in level 3 can have before they all get consolidated into one node.
AUTOCONSOL_LEAVES is the minimum number of leaf nodes the timewell must contain before any auto consolidation will happen.
TEXT_DISPLAY_DISTANCE controls how far away your camera is when the text label of a node, bot, or blip turns on.
MAX_TEXT_SIZE is the largest the text will get.
ENABLE_JOYSTICK allows you to turn off joystick (gamepad) detection - necessary on ubuntu, due to the joystick emulator wreaking havoc.
MAX_MEM_MB tells the console when to start discarding the oldest messages it has. Once the amount of memory used by the console reaches this point, it starts discarding old messages. Set to -1 to automatically use 75% of the memory available to the JVM. The default is -1. Any other value less than 512 will automatically be bumped up to 512.
MAX_CACHED_LIMBS tells the console how many pruned limb objects to keep before throwing the oldest away. If your well is small and you are doing lots of filtering and un-filtering etc., setting this high can increase performance. The drawback to setting it too high is if your well is very large, you can run out of vertex buffers and crash. :(
START_AI is false by default and only affects the PRO version. Set to true to automatically start up the AI pattern generator when the console starts.
Run Scripts from the Console
The HUD menu, displayed when a path is selected, is fully configurable. If you have a directory within your home directory (c:\users\<username> on windows, /home/<username> on *nix) named ".deepnode", the console will look in there for a menu configuration file named "scripts.txt". This file specifies the menu subitems for the "actions" line - underneath the 4-part description of the selected path. The actions line appears in the menu when you click on a path. Each line in the scripts.txt file results in one menu option. Here's an example line:
l tracert _h
(That first character is a lower case "L" which runs the command locally. Lowercase "R" would run the command within a remote feed, if the feed supports the command).
This runs tracert, the windows traceroute command, locally (that's what the "l" is for) with a target of the currently selected host. "_h" is a macro which always returns the currently selected host. The available macros are:
_k raw 4-level path
_h host portion of the path
_p 4-level path with spaces
_1 first level of path (network)
_2 second level of path (domain/subnet)
_3 third level of path (host)
_4 fourth level of path (port/service/message)