Latest update:
14 Jun 2005

UdpGraph v2.0.15
(195 kb)
Download

UpdGraph is a small utility that can be used to display and log real-time and calculated parameters of player's aircraft for IL-2 Forgotten Battles Ace Expansion Pack (patch 2.0.1 and higher). It uses DeviceLink interface introduced in patch 2.0.1 to allow third party application interact with game engine using UDP protocol. By default DeviceLink interface is disabled. To enable it you have to edit IL-2 conf.ini file and add [DeviceLink] section to it. It is advisable to read DeviceLink.txt carefully before you start using UdpGraph. It will help you to understand what parameters can be monitored with UdpGraph. You can find DeviceLink.txt in a folder where your copy of IL-2 is installed.
Note: DeviceLink cannot be used for on-line games, it is accessible for off-line only.

UdpGraph stores all current settings in UdpGraph.ini. To edit any of parameters just click right button on UdpGraph window and select Settings from context menu. Main window will appear:

Using Setting combo box you can select which section of settings to edit:

 * General settings
 * Window settings
 * Log settings
 * Graphs settings

General settings:

 Server specifies IP address of IL-2 PC. If you running IL-2 and UdpGraph on the same PC set this field to 127.0.0.1.
 Port specifies UDP port number on which IL-2 listens for incoming messages (these two parameters - server address and port must be the same as stated in [DeviceLink] section of IL-2 conf.ini file).
 Localhost to be filled in if you have more then one network card in your PC (at least I have ;)  and you want what network to use to connect to IL-2). By default just leave it as 127.0.0.1.
 Update Interval specifies how often UdpGraph polls IL-2 data. By default it set to 500 msec. Note: Actually this field specifies very average value for an interval and can vary from 450 to 600 msec on run-time if set to 500. To get precise value of time passed between two polls use global variable $DT.

Window settings:

 Show window title if set, window will have title with the name of currently active aircraft. It is handy if you play some multiple saved tracks at once. Note: if within the track multiple aircrafts can be active, for example if it is some demo track, only the very first aircraft will be identified.
 Colors specify background color for UdpGraph window and grid color for trend area.
 Style specifies how to display data - as a real-time Graph or as a  Text table.
When Graph style is selected then two other options are accessible:  Show scale will turn on scale at the right side of trend area. Dynamic scale will turn on dynamic positioning of scale labels.
 Display mask specifies length of scale labels. Note: if you set scale too short data can be truncated. For example if mask set to xxx and altitude is 1000then only 000 will be displayed.
 Font allows you select font style and size.

Log file settings:

 Log active if set UdpGraph writes to the log file all data marked for logging
 Log path specifies path where log files to be stored
 Hotkey specifies specifies combination of keys that activates/deactivates writing to the log. Note: hot key is useful for managing log without switching to UdpGraph window.
 Timestamp if set then first column of the log file will contain timestamp of data. All other settings specify format of timestamp. If Standard is selected then timestamp will be written in a HH:MM:SS format. Decimal specifies HH.XXXX format - hours with decimal thousandths. System time - current time of a PC running UdpGraph is used for time stamp. Time of day - time of day from IL-2 is used. Since start - time elapsed since log started. Use milliseconds - use millisecond resolution for time stamps.

Graphs settings:

 This window displays list of all graph items. Right click opens context menu with all operations available for selected item. Double click opens item properties window.

Properties:

 Name displays name of the current item. Can be changed for a new items only.
 Visible turns on/off visibility for the item on main UdpGraph window.
 Save to log if set item's data will be saved to the log file if logging is on. Note: newly created items wont be logged until next start of UdpGraph.
 Color allows to select color for the item.
 Precision specifies number of decimal digits used to display item's data on main UdpGraph window.
 DeviceLink key opens the combobox with a list of DeviceLink keys defined in dlkeys.ini file. Selected key will be inserted to the Function edit box.
 Function allows to enter function which used by UdpGraph to calculate item's value on each polling interval. Can be very simple - just a single DeviceLink key name, for example "altimeter"; or can be quite complicated and contain external functions call and global variables.
 Autorange specifies how UdpGraph displays data in Graph mode. If Autorange is set then UdpGraph will fit data to the plot area. If Autorange is not set then UdpGraph will use min and max value to truncate data if nessesary.

UdpGraph v2.0 supports following list of functions:

abs(), sqrt(), sin(), cos(), tan(), asin(), acos(), atan(), sinh(), cosh(), tanh(), log(), log2(), exp(), pow() Note: pow() can be replaced with '^' operator.

There are two special functions: cpu() and tas(). cpu() function takes no parameters  and return current CPU load. tas() takes four parameters: indicated speed (km/h), current altitude (meters), air pressure at see level (mm of mercury), air temperature (centigrades) and returns calculated TAS (m/s).
For example: tas(ispeed,altimeter,763,15)