DI-Guy SDK Documentation  13.7.1
5.5 - Network Configuration Parameters for DI-Guy Scenario

The following table summarizes the network configuration parameters in /custom/config/diguy/scenario/network.cfg.

These parameters can be tuned to balance performance and fidelity. Be sure to save a copy of network.cfg if you modify it so that you can return to default settings if you encounter a problem.

Network Configuration Parameters
Name and default value Description
velocity_smoothing_period = 0 Time duration, in seconds, for character current velocity to match dead-reckoned velocity.
position_smoothing_period = 0.1 Time duration, in seconds, for character current position to match dead or live-reckoned position.
translation_threshold = 0.05 Permitted translation error, in meters, before DIS update is sent.
timeout_interval = 12 Time, in seconds, without packet traffic before an entity is assumed to be no longer on the network and is removed.
iguy_velocity_smoothing_period = 0.3 For characters not on a path, this time constant is used for smoothing their velocity before transmitting it.
detonation_range = 5 Range of lethality (kill radius) for incoming grenade or bomb detonation interactions not identified to the DI-Guy munition system. By default, this value is overridden by a more sophisticated detonation models using the DI-Guy munitions system, which essentially look up the type of munition and set values like detonation range programmatically.
dr_algorithm = 2

Identifies the dead-reckoning algorithm to be used for translation and rotation error calculation:

  • 0= Other
  • 1 = Static (Entity does not move.)
  • 2 = DRM(F, P, W)
  • 3 = DRM(R, P, W)
  • 4 = DRM(R, V, W)
  • 5 = DRM(F, V, W)
  • 6 = DRM(F, P, B)
  • 7 = DRM(R, P, B)
  • 8 = DRM(R, V, B)
  • 9 = DRM(F, V, B)

F = Fixed, R = Rotational Frame, P = Positional, V =Velocital Frame, W = World, B = Body Coordinates

per_tick_publish_limit = 25 Limit number of entities to publish during a single tick. Helps keep performance uniform. Next tick will start publishing from entity list where previous publish stopped.
DIS Only
dis_entity_custom_pdus = 1 Indicates whether DI-Guy custom PDUs are to be transmitted.
rotation_threshold = 0.2 Permitted rotation error, in radians, before DIS update is sent.
ip_address = 239.255.0.1 Address to which outgoing DIS traffic is sent. The default value indicates site multicast. In some situations, a value of 0.0.0.0 (broadcast) may work better, at the cost of affecting every machine on the network.
Port = 3000 Network port used for DIS networking.
exercise = 1 Exercise number.
site = 0 Site number.
host = 0 Host number.
sync_mode_enabled = 0 Indicates whether multi-screen network synchronization is enabled. In this mode, characters are neither broadcast nor received, but several machines running DI-Guy Scenario can be synchronized in their playback of scenarios.
sync_master = 0 Sync mode only. Indicates whether this machine will be the sync master. If nonzero, this machine will send custom PDUs to keep remote instances of DI-Guy Scenario in sync.
slaved_camera = 1 Sync mode only. Indicates whether the camera on this machine will be slaved to the camera on the master machine. If not, the camera will be free, while playback itself will be synchronized with playback on the master machine.
roll_for_sync_mode = 0 Sync mode only. With a slaved camera, this value (in degrees) indicates how the local camera is oriented with respect to the remote camera on the master machine. This value indicates the roll difference between the two cameras. On the sync master, this value visibly alters the camera position, but it does not change the nominal position that the slaves see the master camera to be in. Generally, to maintain screen contiguity, this roll value should be set the same on the master and on all the slaves.
yaw_for_sync_mode = 0 Sync mode only. With a slaved camera, this value (a percentage) indicates how the local camera is oriented with respect to the remote camera on the master machine. This value indicates the yaw difference between the two cameras. For example, a value of 100 means yaw a full field of view to the left. A value of -50 means yaw half a field of view to the right. On the sync master, this value visibly alters the camera position, but it does not change the nominal position that the slaves see the master camera to be in. So, for example, to achieve two-screen horizontal contiguity, you could set the master’s yaw to be 50, and the slave’s yaw to be negative 50, or vice versa.
pitch_for_sync_mode = 0 Sync mode only. With a slaved camera, this value (a percentage) indicates how the local camera is oriented with respect to the remote camera on the master machine. This value indicates the yaw difference between the two cameras. For example, a value of 100 means pitch a full field of view down. A value of -50 means pitch half a field of view up. On the sync master, this value visibly alters the camera position, but it does not change the nominal position that the slaves see the master camera to be in. So, for example, to achieve two-screen vertical contiguity, you could set the master’s pitch to be 50 and the slave’s pitch to be negative 50, or vice versa.
cust_pdu_kind = 220 A value from 220 to 255, used as the PDU kind ID for DI-Guy custom PDUs.
HLA Only
hla_diguy_fom = 1 Indicates whether DI-Guy custom entity attributes are to be transmitted and received.
hla_force_update = 5 Maximum number of seconds between the transmission of HLA entity state updates. If zero, HLA entity state updates are not transmitted unless the state changes.
hla_advisories = 0 Indicate whether to activate advisories. This value must agree with your RTI configuration file.
federation_name = DI-Guy HLA only. Name of the federation execution, as well as the base name of the FED file.

[<< Fire and Detonate Interactions in DI-Guy] [Home] [Top of Page] [Database Coordinates and DI-Guy Networking >>]