VoglReplay Trim Support
The functionality was already available to users via command line options to voglreplay, but getting there after making a trace file is not an obvious second step.
VoglEditor Trim Support
The command line above can now be executed interactively from within VoglEditor when a trace file is loaded. VoglEditor detects whether the trace contains "too many" frames, and will display the following prompt. Selecting 'No' will continue to load the selected trace; 'Yes' will bring up the Trim Trace dialog.
The dialog will ensure that valid frames are entered for 'trim_frame' and 'trim_len' - validating that the user selects a frame that actually exists in the loaded trace file, and that "too many" frames are not included in the trim file (as this would cause the same dialog to appear when loading the trimmed trace). A new trim filename and path can be directly typed into the dialog, or click the '...' button to open a typical FileSaveDialog.
Clicking 'OK' will confirm the file does not exist and prompt you to overwrite if it does (or cancel to return to the dialog and select a new file name). The trace file will be trimmed in another process, saved to disk, and then the user is prompted to open the newly trimmed trace.
As expected, 'Yes' will load the new trimmed file into VoglEditor; 'No' will cause the originally selected trace file to be loaded.
This same trimming functionality is also now made available on-demand using the new 'Trim Trace' toolbar button.
So... what constitutes as "too many" frames? You decide! (continue below)
VoglEditor Settings File
When implementing the automatic detection of "large traces" to prompt for trimming, it became clear that different users will have different definitions of "large" - in house we often look at multi-gigabyte trace files with hundreds of frames, and other systems may only be able to support a few hundred frames, or perhaps for debugging a particular issue only a handful of frames will be needed. In order to configure the definition of "large traces", a settings file was added.
To keep it easily readable, editable, and consistent with other vogl features, the settings file is stored in JSON. To stick with Linux standards, it is stored in one of the following paths:
$XDG_CONFIG_HOME/vogleditor_settings.json
or
$HOME/.config/vogleditor/vogleditor_settings.json
In addition to the number of frames at which to consider a trace "large", the initial implementation of the settings file also supports storing the window position and size.
Here are the contents of the default settings file, which will be automatically created when you first open vogleditor, and automatically resaved when the editor is closed.
{
"metadata" : {
"vogleditor_settings_file_format_version" : "0x1"
},
"settings" : {
"trim_large_trace_prompt_size" : 200,
"window_position_left" : 0,
"window_position_top" : 0,
"window_size_width" : 1024,
"window_size_height" : 768
}
}
Manually editing this file should be done while VoglEditor is closed, as any manual changes will be overwritten when the editor is closed.
