XviD Stats Analyzer

version 0.1.2.0 (2005-10-07)
© 2005 Yuri Khan
http://stats-analyzer.gorodok.net/

This tool is intended to assist in understanding the bitrate distribution of an XviD encode.

Features

Load a first pass stats file and see a scrollable zoomable graph with relative frame sizes, average frame size, average bitrate and approximate bitrate distribution.
Add a video file (supposedly result of that pass), select a range of frames on the graph, and watch that fragment to see why it’s so freaking bitrate-consuming ;)

GUI usage

Start up the program and open files using File|Open and File|Video commands.
Opening a video file automatically attempts to load a stats file. The stats file must have the same name as the .avi; may have extensions of .pass or .stats, and must reside either in the same directory with the .avi, or in stats subdirectory of the parent directory of where the .avi lies, like in the illustration below:
```
L:
\_DVD
  \_Projects
    |_Last Exile
    \_Tenshi ni Narumon!
      |_pass1
      | |_Tenshi ni Narumon! - 01.avi
      | \_Tenshi ni Narumon! - 02.avi
      |_pass2
      \_stats
        |_Tenshi ni Narumon! - 01.stats
        \_Tenshi ni Narumon! - 02.stats
```

The Graph window

Can be displayed or hidden using View|Graph command on the main menu.
Displays the frame sizes in black, the average frame size as a yellow horizontal line, an auxiliary bitrate threshold as a red line, and the frame sizes averaged over a window of ±90 frames as a teal smooth area.
The auxiliary bitrate threshold line can be moved by entering a frame size in the corresponding edit box. Its function is to let you better identify which zones consume most bitrate.
The Go to edit box allows to find a frame by its 0-based number.
Graph colors can be configured by pressing the Options button. Also, the Options dialog allows to set the position of the bitrate threshold line, and the frame rate used in conversions between bytes per frame and kbits per second.
The zoom feature allows to see more of the graph in the window, although with less details.

The Video window

Can be toggled using View|Video command on the main menu.
The << < > >> buttons move 1 and 10 frames back and forward.

Mouse controls

Clicking in the Graph window positions the player on that frame.
Dragging in the Graph window selects a range of frames. A click on the Play button then plays just that range.
Clicking in the player window pauses/resumes playback.

Keyboard controls

These keys work in the Graph and Video windows:

Left/Right arrow keys move back/forward by one frame.
Shift+Left/Right move back/forward by ten frames.
Ctrl+Left/Right move to first/last frame.
[/] move to selection start/end.

The following keys work in the Graph window only:

Home/End mark selection start/end.
Ctrl+PgUp/PgDn move to the first/last frame displayed on the current page.
PgUp/PgDn scroll one page left/right.
Gray+/Gray− zoom in and out.

The following key works in the Video window:

Space pauses/resumes playback.

Command line usage

The program accepts file names in the command line. It then figures out their types depending on the extension and attempts to load them.
Load a video file:
```
C:\> StatsAnalyzer "test.avi"
```
Load a stats file:
```
C:\> StatsAnalyzer "video.pass"
```
Load both a video and a stats file:
```
C:\> StatsAnalyzer "test.avi" "video.pass"
```
The quotes are only required if file names contain special characters such as space or &, but it is a good habit to put them in any case.
The stats file corresponding to a video file can be autoloaded by using the /auto switch. The same search rules are used.
Load a video file and automatically look for an associated stats file:
```
C:\> StatsAnalyzer "test.avi" /auto
```

License

This is free software, distributed under the GNU Public License. See details in the enclosed license.txt file.

Links & Contact

The latest version of Stats Analyzer can be found at http://stats-analyzer.gorodok.net/.

Bug reports, feature requests, suggestions, ideas, patches can be sent by e-mail to stats-analyzer at gorodok dot net. Also, there’s a discussion thread at Doom9 forum.