Skip to content

Commit ab49bdd

Browse files
committed
draft panels docs
1 parent 2260d17 commit ab49bdd

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

docs/how_to_use.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,20 @@ QCTool's analysis methods depend on filters from FFmpeg's libavfilter library. T
3737

3838
Enabling all filters naturally provides more data, but results in a slower analysis and larger files. The EBU R.128 values represent perceived volume whereas the `astats` filters include metrics on actual volume (so the use of EBU R128 may not be considered essential if `astats` is in use). Additionally `PSNR` and `SSIM` both cover similar metrics by quantifying the difference between the two fields of the frame (the image of the odd-numbered lines vs the image of the even-numbered lines); `SSIM` is recommended.
3939

40+
### Panels
41+
42+
QCTools generates panels of images that are stacked horizontal to depict the timeline of audiovisual content in various ways. The panel tracks will reveal an image where the x-axis (viewing from left to right) will represent the timeline of the audiovisual content and the y-axis (viewing from top to bottom) is conditionally determined by the panel.
43+
44+
| filter name | track type | application in QCTools |
45+
| Tiled Center Column | video | This image shows the center column from each subsequent image of the video timeline. |
46+
| Tiled Center Column (Field Split) | video | Similar to 'Tiled Center Column'; however, the image is adjusted so that odd lines of video (the top field of an interlaced video) are shown at the top of the image and the even lines of video (the bottom field) are shown at the bottom. |
47+
| Tiled Center Row | video | This image shows the center row from each subsequent image of the video timeline. The images are rotated 90 degrees counter-clockwise in the panel viewer, so the left edge of the frame's central row is on the bottom of the panel image and the right edge is at the top. |
48+
| Horizontal Blur | video | Each column of this panel shows a variation of a Laplacian convolve of the image rotated 90 degrees counter clockwise. The lower part of the panel image depicts the left part of the source image and the top part of the panel image depicts the right part of the source image. In the panel image, brighter pixels depict content that is more in focus while darker pixels represent content that is flat or blurry. |
49+
| Audio Waveform (Linear) | audio | This is a visualization of the audio waveform on a linear plot, each channel of the track is stacked upon one another. |
50+
| Audio Waveform (Logarithmic) | audio | This is a visualization of the audio waveform on a logarithmic plot, each channel of the track is stacked upon one another. |
51+
| Audio Normalized Cross-correlation | audio | This image shows the normalized cross-correlation between two channels of the audio track. Very high values (in green) show highly correlated audio, whereas very low values show highly correlated audio that is out of phase, and values in the center show that the audio is not correlated. |
52+
| Audio Histogram | audio | A volume histogram for the audio track. |
53+
4054
### Tracks
4155

4256
The 'Tracks' Preference pane allows the user to set if they would like to analyze only the first track or all tracks of video and audio. Setting QCTools to analyze only the first track will result in a faster analyze but the other tracks would be ignored.

0 commit comments

Comments
 (0)