DataRefTool for X-Plane

DataRefTool: an X-plane plugin to find and explore datarefs and commands in X-Plane. Features:

• Search for datarefs and commands: use multiple search terms, including regular expressions and case sensitivity options
• Find changing dataref values with the Ch change detection
• Identify recently used commands with the Ch change detection
• Reload plugins, scenery, or aircraft on command. Plugins can be reloaded when the XPL file changes.

DRT is a work in progress; suggestions are welcome.

Features

• Read, write, and search for datarefs
• Search for and execute commands
• Case insensitive search
• Regex search
• Supports Windows/Linux/Mac on X-Plane 11 and 12
• Filter recently changed datarefs, and color datarefs that recently changed
• Displays all data types, including arrays
• Make it easy to deselect the search field (unlike DRE). Use enter, return, escape, or tab, or click elsewhere in the DRT window.
• Cut/copy/paste/select all in search field and for datarefs (uses standard keyboard shortcuts)

Search

Search features:

• Multiple search terms, separated by spaces
• Exclude terms starting with a minus sign
• Regular expressions: off .*, or on .* (Regex is a sequence of characters that describes a search pattern in text)
• Case sensitivity: off Aa, or on Aa
• Recently changed values / active commands: everything Ch, all changes ch, or only big changes CH
• Show: everything all, only commands com, or only datarefs dat

Coloring

DataRefTool uses different colors to indicate datarefs or commands in different states:

Reduce colors

In an attempt to be accessible to colorblind users, an alternate color scheme is selectable.

The colors are based on the Wong color palette (Figure 2).

Font and UI scaling

Bigger fonts are available in DRT through X-Plane's accessibility settings.

User Interface Size settings are useful for scaling the entire interface for high-DPI monitors, while Base Font Size is useful for increasing only the font size.

Sizes are only configurable through X-Plane settings.

Performance

DataRefTool reads datarefs every frame in order to detect changes to values. Other plugins and X-Plane take significant time to compute these values; DRT takes time to identify changing values. This extra work may lower your frame rate if you're CPU-limited.

Here are the best ways to make sure that DRT is having the smallest impact on your FPS:

1. Close DataRefTool windows when you aren't using them. DRT does stop reading datarefs completely when all windows are closed; you should not lose any FPS at all when all windows are closed.

2. Update values at a lower rate will lower the load on your system. You can configure this in the DataRefTool menu:

3. Ignore datarefs that are slow to read. Create a file called X-Plane 12/Resources/Plugins/drt_ignore.txt, and list the datarefs to ignore, one per line. Datarefs listed in this file will not be read by DataRefTool.

   Here are a few X-Plane datarefs which are known to be relatively slow:

    sim/airfoils/afl_cd
    sim/airfoils/afl_cm
    sim/airfoils/afl_cl
   

4. Buy a faster CPU! 😀 DRT is written in a highly optimized and efficient manner; however, it does a lot of work, and that work takes CPU time.

Finding every dataref

DataRefTool 2.2.0 and later use a new API for finding datarefs (when used with X-Plane 12.04 and later), and no longer rely on scanning every file for datarefs (though scanning is still used for commands).

Keyboard shortcuts

In general, normal text editing shortcuts are respected:

• Ctrl-X / ⌘X : cut
• Ctrl-C / ⌘C : copy
• Ctrl-V / ⌘V : paste
• Ctrl-A / ⌘A : select all

In the search window, there are some additional things you can do:

• Ctrl-N / ⌘N : open a new search window
• Ctrl-W / ⌘W : close current window
• Tab / Shift-Tab : switch between search field and results

Search field:

• Ctrl-F / ⌘F or Ctrl-L / ⌘L : go to the search field
• Ctrl-alt-C / ⌥⌘C : Toggle Change detection
• Ctrl-alt-I / ⌥⌘I : Toggle case-Insensitive search
• Ctrl-alt-R / ⌥⌘R : Toggle Regex search
• Ctrl-alt-S / ⌥⌘S : Toggle Source (dataref/command/all)

Search results:

• Enter or Return : open details window for the current dataref/command
• Ctrl-C or ⌘C : Copy currently-selected dataref name
• Ctrl-alt-C or ⌥⌘C : Copy currently-selected dataref value
• Type a number : Set new value for currently-selected scalar dataref (int/float/double only)
• Space : activate current command
• J / K or ▲ / ▼ : Go up or down in the list (like vim)

Additional keyboard shortcuts (to open a search window, for instance) can be added by searching for "datareftool" in X-Plane's keyboard settings.

Plugin developer notes

Adding custom datarefs: You can use DRT to display your plugin's custom datarefs or commands. Just send a message of type 0x01000000 with a pointer to the name as the payload. (This is exactly the same method that you use to add a custom dataref to Data Ref Editor.)

Searching DRT from another plugin: DRT provides an API to allow other plugins to search the dataref list. Learn more from the API documentation.

SDK addition wishlist

DRT would greatly benefit from some changes to the X-Plane SDK (Hello Laminar! 👋). Here is my SDK wishlist.

Author

DataRefTool is made by Lee C. Baker. If you benefitted from this plugin, please consider the PlaneCommand plugin, which provides a voice control for many command aircraft commands.