---

DGAVCIndexNV 1.0.14 beta 11

---

What is DGAVCIndexNV?

File Menu
   Open
   Load Project
   Close
   Save Project
   Save Project and Demux Video
   Save BMP
   Preview, Play, Stop, Pause/Resume
   Exit

Stream Menu
   Detect PIDs: PAT/PMT
   Detect PIDs: Raw
   Set PIDs

Video Menu
   Field Operation
   YUV->RGB
   Enable PureVideo Deinterlacer
   Display HD Full Sized
   Disable Display
   Luminance Filter
   Cropping Filter
   Copy Frame to Clipboard

Audio Menu
   Audio Demux (Transport Streams)
   Audio Demux (Matroska Streams)

Options Menu
   Loop Playback
   Playback Speed
   Process Priority
   Use Full Paths
   AVS Template
   Enable Info Log

Help Menu
   SIMD
   DGAVCDecNV Quick Start Guide, DGAVCIndexNV User Manual, and DGDecodeNV User Manual

Display Window
   Navigation
   Selection
   Splash Screen

Information Panel
   Video Section
   Audio Section
   Status Section

Appendix A: DGA File Structure
Appendix B: Command-Line Interface
Appendix C: Auxiliary INI File Options

What is DGAVCIndexNV?

Table of Contents

DGAVCIndexNV, part of the DGAVCDecNV package, is primarily designed to create an index of an AVC (H.264) video stream, containing the location of each frame in the input stream, and some additional information about each frame. This index, or project file, is used by the companion Avisynth filter DGDecodeNV to provide frame-accurate serving of the video via an Avisynth script. DGAVCIndexNV is currently limited to opening elementary (raw 264), transport (TS and M2TS), and Matroska (MKV) AVC streams (MP4 files are not yet supported).

The "NV" in the name "DGAVCIndexNV" indicates that this version of the program is designed for use with the VP2 GPU decoder on some Nvidia video cards. Data is currently being compiled on which Nvidia cards work with this software and the data will be added to this document when available.

You can get the latest binaries of DGAVCDecNV at http://neuron2.net/dgavcdecnv/dgavcdecnv.html.

This document is a reference manual for DGAVCIndexNV. Please refer to the accompanying documents for quick start information, frequently asked questions, and guidance on actual usage of DGAVCIndexNV in typical scenarios.

File Menu

Table of Contents

Open	Table of Contents

Use this option to open the source AVC file(s) (elementary, transport, and Matroska streams only).

Clicking on File\Open causes one of two things to happen:

1. If no files have yet been selected, the Open dialog will appear.
   Click "Open" to proceed to the File List dialog.

2. If a file has already been selected, the File List dialog will open.
   

Files can also be loaded by dragging-and-dropping them onto the DGAVCIndexNV window. This causes the File List to be opened with the list containing the drag-and-dropped file.

Load Project

Table of Contents

Use this option to open existing DGAVCIndexNV (dga) project files.

When a project file is loaded, DGAVCIndexNV opens the project's source file and restores the following settings from the project file:

• Field Operation
• YUV -> RGB Scale
• Luminance Filter
• Cropping
• Timeline selection points
• Audio demux list

Close

Table of Contents

Use this option to close all open input files.

Save Project

Table of Contents

Use this option to generate a DGAVCIndexNV project file (dga file). The project file is used by DGDecodeNV to frame-serve the video via Avisynth.

DGAVCIndexNV builds a project file containing the path to the source file, the video settings, and AVC indexing information. For more information on the structure of dga files, refer to Appendix A.

Generation of the project file can take several minutes depending on the size of the project and the speed of your computer.

Save Project and Demux Video

Table of Contents

Use this option to generate a DGAVCIndexNV project file (dga file) as described in the section "Save Project" above, and at the same time demultiplex the video to a separate AVC elementary stream file (avc file). Elementary stream files are sometimes needed for use with other applications. DGAVCIndexNV provides this functionality as a convenient tool for the sophisticated user; it is not required for frame serving via DGDecodeNV.

The elementary stream file will be generated in the same directory as the project (dga) file, and its name will be created by concatenating the base name of the project file with ".demuxed.avc". For example, if the project file is named "movie.dga", the elementary stream file will be named "movie.demuxed.avc".

Save BMP

Table of Contents

Use this option to save the current frame on display in the DGAVCIndexNV window to a Windows BMP file. When this option is selected, a file dialog will open that allows you to specify the desired name and location for the BMP file.

Preview, Play, Stop, Pause/Resume

Table of Contents

Use these options to control video playback in the display window. Keyboard hotkeys are given in parentheses.

• Preview (F5) - Plays from the beginning to the end of the timeline.
• Play (F6) - Plays from the current position on the timeline.
• Stop (ESC) - Stops a running Play or Preview.
• Pause/Resume (SPACE) - Pauses/resumes a running Play or Preview.

The Play/Preview commands decode and display all frames from the starting point, i.e., they do not suppress orphaned frames. if any, at the start of the GOP. So you may see macroblocking on the first few frames of a Play/Preview operation if your stream has open GOPs. Note that this is purely a display matter in DGAVCIndexNV; it never occurs in the frame-served video or in demultiplexed video files. While such frames could have been suppressed, DGAVCIndexNV is intended for analysis and not playback; it can be useful to operate this way because one can easily identify open GOPs in the stream. Note that when navigating on the timeline, orphaned frames are suppressed.

The video playback speed is controlled by the playback speed control options available via the Options/Playback Speed menu.

Play and Preview automatically pop up the Information Panel.

Exit	Table of Contents

Use this option to close the source file and terminate DGAVCIndexNV.

Stream Menu

Table of Contents

Detect PIDs: PAT/PMT

Table of Contents

DGAVCIndexNV can open transport streams. Transport streams can contain multiple programs, each of which contains audio and video streams. The Stream menu allows the user to list the programs and to select the desired program to be decoded. The stream menu is disabled if the input stream is not a transport stream. Transport streams periodically send data tables called the PAT/PMT tables that specify the programs and tags (PIDs) for the associated audio and video streams. By setting the PID for the desired video stream, you thereby select the desired program to decode. Note that only the video and PCR PIDs can be set in this menu. Use the "Audio/Audio Demux" option to set audio PIDs.

Use the "Detect PIDs: PAT/PMT" option to list the programs and their associated streams, and to select the desired video stream to be decoded. DGAVCIndexNV will parse the input file for the PAT/PMT tables and, if found, will display the programs and their PIDs in a list box. If PAT/PMT tables cannot be found, an error message will be shown instead, in which case the list box should be closed and the "Detect PIDs: Raw" option used instead.

To select the desired video stream, highlight it by selecting it with a mouse click. Then click on the "Set Video" button. To select the desired PCR stream, highlight it by selecting it with a mouse click. Then click on the "Set PCR" button. When you have selected your PIDs, click on the "Done" button to close the list box. The video should now be displayed in the DGAVCIndexNV window.

The PIDs are stored in the DGAVCIndexNV.ini file and so will be retained across DGAVCIndexNV sessions.

Note that selecting an audio stream as video will produce undefined operation and may crash DGAVCIndexNV. For that reason, the video PID comes up by default as 0x02, which is a reserved value. However, because the DGAVCIndexNV.ini file retains PIDs from a previous session, you may run into this. If you get strange behavior or crashing, then manually set the video PID to 0x02 using the "Set PIDs" option before loading your input file, and then detect and set your video PID normally.

Detect PIDs: Raw

Table of Contents

Rarely, a transport stream may lack PAT/PMT tables. In such cases, the PIDs of the audio and video streams can be displayed and selected using the "Detect PIDs: Raw" option. Because raw PID detection does not show which audio and video streams go together, some trial and error may be required to find which audio and video PIDs belong together (commonly encountered pairs of associated video/audio PIDs are 11/14, 21/24, and 31/34). For that reason "Detect PIDs: PAT/PMT" should always be tried first.

The operation of the "Detect PIDs: Raw" list box is the same as described above for the "Detect PIDs: PAT/PMT" list box.

Set PIDs

Table of Contents

Use this option to manually specify the video and PCR PIDs using hexadecimal notation, or to query the selected PIDs. If you use this dialog to specify your PIDs, DGAVCIndexNV will not detect PIDs and will simply use the specified PIDs to select the video and PCR streams. Note that only the video and PCR PIDs can be set in this menu. Use the "Audio/Audio Demux" option to set audio PIDs.

Note that selecting an audio stream as video will produce undefined operation and may crash DGAVCIndexNV. For that reason, the video PID comes up by default as 0x02, which is a reserved value. However, because the DGAVCIndexNV.ini file retains PIDs from a previous session, you may run into this. If you get strange behavior or crashing, then manually set the video PID to 0x02 using the "Set PIDs" option before loading your input file, and then detect and set your video PID normally.

Video Menu

Table of Contents

Field Operation

Table of Contents

AVC video provides a syntax element (picture timing SEIs) that allows a single field of any frame to be repeated automatically during display ("pulled down"). The extra fields do not occupy space in the AVC stream but are simply created by copying when the stream is decoded and displayed. This facility is most often used to display film rate clips (23.976 fps) at the NTSC rate (29.97 fps), a process called 3:2 pulldown. In practice, however, pulldown in various different patterns is commonly encountered. It can be used, for example, to display 25 fps PAL at the NTSC rate. You can learn about telecining and pulldown at this web site.

Understanding the theory and practice required to properly set this option for a given application is nontrivial. Here we can only define the operations and give some general guidance. There is ample additional material available in existing guides.

The Field Operation setting allows the user to specify how the pulldown flags are to be handled. Note that this setting affects only the video served via DGDecodeNV. In DGAVCIndexNV, the video is always shown in the Ignore Pulldown Flags mode.

• Honor Pulldown Flags - The pulldown flags (if any) are obeyed and the fields are repeated. This means that the frame-served video will appear exactly as it is intended to appear on the final display device. Therefore, if you have a 3:2 pulled-down clip, you'll get the standard repeating pattern of 3 progressive frames followed by 2 interlaced frames. If you have PAL, you'll just get the encoded pictures with no repeated fields (because PAL has no pulldown flags to honor). The frame rate will always be the same as the display frame rate of the source.
• Ignore Pulldown Flags - The pulldown flags are ignored. This allows one to obtain the raw encoded AVC pictures, with no repeated fields. However, because repeated fields intended for display are ignored and not displayed, the resulting frame rate may differ from the source frame rate. It may even vary throughout the clip, due to irregular patterns of pulldown flags. If the pulldown is irregular, use of this option will cause the audio-video sync to change at different parts of the clip, and most likely sync will not be acceptable. This option is mostly intended for power users, who would use it as a diagnostic aid for inspecting the encoded AVC pictures. Although this option ignores the flags, they are still stored in the DGA file although DGDecodeNV will ignore them.
• Force Film - This option is intended for the special case of film content encoded at 23.976 fps but pulled down for display at 29.97 fps, i.e., 3:2 pulldown. This option will restore the 23.976 fps film rate while keeping audio and video in sync throughout the clip. This option works by ignoring pulldown flags and adjusting the frame rate back to the film rate. Do not use this option on non-3:2 pulled-down material, and, therefore, never use it on PAL. Currently, this option requires 3:2 pulldown throughout the stream, and so it cannot be used on hybrid film/video. For hybrid streams, use Honor Pulldown Flags and post-process as required.

The Field Operation is perhaps the most important option to understand when using DGAVCIndexNV. Most users should first preview the project and inspect the Information Panel. If the clip is 29.976fps, and the Field Repeats box in the Information Panel indicates field repeats consistent with 3:2 pulldown, then it is likely that the clip can be treated as 3:2 pulldown material, and so the Force Film option should be selected for generation of the DGA file.

Otherwise, then you should leave this option set to Honor Pulldown Flags for generation of the DGA file. If the result is combed (because the source is interlaced, hybrid interlaced/3:2, field blended, etc.), you may want to apply a deinterlacer or inverse telecine (IVTC) filter in your Avisynth script.

Almost invariably, if you know the source is not all 3:2 pulled-down NTSC, you will want to select Honor Pulldown Flags and then post-process as required. Keep in mind that if there are no pulldown flags, there is nothing to honor, so this option just delivers the encoded frames.

The Ignore Pulldown Flags option should be necessary only for advanced users who want to see just the exact coded pictures in the AVC stream. Currently this is just Force Film but without the frame rate modification. In a future version, Force Film will operate on hybrid material and will decimate frames as required in video sections to maintain the film rate. At that time the distinction between Force Film and Ignore Pulldown Flags will be more meaningful.

YUV->RGB

Table of Contents

For display in the DGAVCIndexNV window, the video is always converted to RGB. This option specifies how the colorspace conversion to RGB is to be performed.

• PC scale - Map output RGB to full range: YUV [16, 235(Y)/240(UV)] -> RGB [0, 255]
• TV scale - Map output RGB to clipped range: YUV [16, 235(Y)/240(UV)] -> RGB [16, 235]

This option affects only conversion to RGB for display in DGAVCIndexNV. It does not affect the the video sent to DGDecodeNV. For the served video, you can convert to RGB in your Avisynth script if needed.

Enable PureVideo Deinterlacer

Table of Contents

Use this option to enable/disable the Nvidia PureVideo deinterlacer. If you have HD video, you will have to enable the Display HD Full Sized option to see the effects of the deinterlacer in DGAVCIndexNV.

Check Single Rate to enable classical deinterlacing, where the number of output frames is the same as the number of input frames.

Check Double Rate to enable bobbing, where each field of an input frame generates a full frame in the output. Note 1: Double rate deinterlacing requires Windows XP Service Pack 3! Note 2: Double Rate deinterlacing here is intended only to show how the video will look when served with DGSource(deinterlace=2), so some of the Info dialog fields (such as frame rate and playback frame count) are not adjusted to reflect the double rate.

Check Use progressive_frame if you want the deinterlacing to honor NVCUVID's progressive_frame indication. If single or double rate deinterlacing is enabled and this option is checked, then only frames marked as progressive by NVCUVID will be deinterlaced. If single or double rate deinterlacing is enabled and this option is not checked, then all frames will be deinterlaced.


The option is stored in the INI file.

Display HD Full Sized

Table of Contents

Use this option to display HD video at full size instead of shrunk by half. This can be useful for inspecting your video, because interlacing cannot be seen when video is shrunk by half.

The option is not stored in the INI file.

Disable Display

Table of Contents

This option is intended for getting an idea of the performance of the GPU's decoding engine. When this option is enabled, all display operations are disabled except for one: the FPS field of the Info dialog is updated. If you load your stream, select this option, and start a preview, the FPS field will show the raw decoding rate of the GPU decoder as implemented in DGAVCIndexNV. Note that the conversion from YV12 to RGB24 used when display is enabled is very CPU intensive. So if you want to assess the frame rate and CPU utilization of the GPU decoder, it is necessary to disable the display.

Luminance Filter

Table of Contents

Use this option to perform luminance adjustments.

Use the checkbox in the upper left corner to Enable or Disable this filter. Position the Gamma and Offset controls until desired results are achieved. DGAVCIndexNV stores the luminance adjustment settings in the DGA file and DGDecodeNV reads them and applies the same luminance adjustment to the served video, so that what you see in the DGAVCIndexNV window is what you get in the served video.

Gamma performs a non-linear adjustment, while offset just adds or subtracts luminance for all the pixels. It is beyond the scope of this manual to describe the concept of gamma. Google is your friend.

Cropping Filter

Table of Contents

Use this option to crop your video.

Use the checkbox in the upper left corner to Enable or Disable this filter. Position the Left, Right, Top, and Bottom controls until desired results are achieved. DGAVCIndexNV stores the cropping settings in the DGA file and DGDecodeNV reads them and applies the same cropping to the served video, so that what you see in the DGAVCIndexNV window is what you get in the served video.

Copy Frame to Clipboard

Table of Contents

Use this option to copy the frame on display to the clipboard. It may then be pasted into suitable graphics applications.

Audio Menu

Table of Contents

Audio Demux (Transport Streams)

Table of Contents

DGAVCIndexNV can open transport streams. Transport streams can contain multiple programs, each of which contains audio and video streams. The Audio Demux menu allows the user to select audio streams to be demultiplexed when a Save Project operation is performed. The following audio types are currently supported: MPEG audio, AAC ADTS audio, AAC LATM/LOAS, AC3 audio, DTS audio, and LPCM audio. Additional formats will be added as test streams are received.

The "Available audio streams" listbox lists the audio streams that were detected. To select an audio stream for demultiplexing, highlight it by selecting it with a mouse click. Then click on the "Set" button. The stream's PID will be added to the list in the "Audio streams to demux" listbox. To remove a stream from the list, highlight it and then click on the "Clear" button. Use the "Set All" and "Clear All" buttons to add or remove all the available audio streams, respectively. When you have selected your audio PIDs, click on the "Done" button to close the menu. Now subsequently, when you perform a Save Project operation, the selected audio streams will be demultiplexed. Also, if you do a Preview or Play operation, the detected audio streams will be listed on the Info dialog.

Demuxed audio files will be named after the project name and additional parameters of the audio format. For example: "bbc.hd PID 90f 2_0ch 384Kbps.ac3".

When LPCM is demuxed from a transport stream, usually an M2TS (Blu-Ray) stream, the raw PCM is stored in the output file. You can convert this to a standard wave file using the popular SOX audio processor tool, which you can get here:

http://sourceforge.net/projects/sox/

A typical command line would be as follows (although you need to check your audio parameters in the Info dialog to choose the correct SOX options):

sox -B -r48000 -t .raw -c 6 -2 -s "Blu-ray PCM PID 1101 DELAY 0ms.pcm" "out.wav"

A future version of DGAVCIndexNV may integrate WAV packaging functionality to eliminate the need for SOX.

It is possible that audio streams are declared in the PAT/PMT tables but are not actually present in the source file, in which case demultiplexing them will fail to produce demultiplexed files. You can test for the actual presence of declared streams by doing a Preview operation. If the streams are actually present they will be listed on the Info dialog.

The audio demultiplexing settings are not stored in the DGAVCIndexNV.ini file.

Audio Demux (Matroska Streams)

Table of Contents

DGAVCIndexNV can open Matroska streams. Transport streams can contain multiple audio tracks. The Audio Demux menu allows the user to select and demultiplex the desired audio track(s). The following audio types are currently supported: MPEG audio, AAC ADTS audio, AC3 audio, DTS audio, and FLAC audio. Additional formats will be added as test streams are received.

The "Available audio streams" listbox lists the audio tracks that were detected in the Matroska file. To select an audio stream for demultiplexing, highlight it by selecting it with a mouse click. Then click on the "Demux" button. You will prompted to specify the destination file to receive the demultiplexed audio. After you have specified the file, the audio track will be demultiplexed immediately. The progress of the operation is displayed by the progress bar.

The demultiplexing operation honors the project range settings made via the [ and ] buttons.

No audio delay value is reported because the video and audio are always demultiplexed starting at the same timecode in the Matroska file.

Options Menu

Table of Contents

Loop Playback

Table of Contents

When this option is selected and playback during a Preview or Play operation reaches the end of the timeline, playback will automatically start again at the beginning of the timeline.

Playback Speed

Table of Contents

Specify the playback speed for play and preview operations.

• Single Step - Step forward one frame at a time (see description below).
• Super Slow - 5 frames/sec.
• Slow - 10 frames/sec.
• Normal - The frame rate of the stream.
• Fast - Double the frame rate of the stream (two times Normal).
• Maximum - The fastest possible rate that your computer can perform.

The single step mode is controlled by the right arrow button (>) on the timeline. Note that during a single-stepping operation, you cannot navigate on the timeline. To single-step from a new location, first exit the play operation, then reposition on the timeline in the normal way, and restart the play operation. Finally, single-stepping does not give you per-frame granularity for cuts and timeline positioning; it just allows you to pace the playback so that individual frames can be examined.

Process Priority

Table of Contents

Specify what CPU usage priority Windows will assign to DGAVCIndexNV.

• High
• Normal
• Low

Use this option if you are running multiple applications at once, and want to prioritize (or de-prioritize) DGAVCIndexNV for CPU usage.

AVS Template

Table of Contents

DGAVCIndexNV can automatically generate an Avisynth script for serving your project. It requires you to specify a template file, such as the following one:

  loadplugin("...\DGDecodeNV.dll")
  loadplugin("...\Decomb.dll")
  dgsource("__vid__")
  fielddeinterlace()

This is any normal AVS script, except that the DGA file name is replaced with __vid__ (that's two underscores before "vid" and two after). When DGAVCIndexNV creates the AVS script, it replaces __vid__ with the correct DGA file name.

To select and enable a template, use the Options/AVS Template pulldown menu item to set your template file as the active template file. After performing a Save Project operation, DGAVCIndexNV uses this file as a template and inserts the right file name whenever it sees __vid__.

You may also use the __aud__ specifier to generate the audio file name. Note that if you are generating more than one audio file, this specifier will refer to the first audio file that is opened. Therefore, to be sure to get the desired audio file, process just one audio stream.

You may also use the __del__ specifier to generate the delay value for use in DelayAudio(__del__).

DGAVCIndexNV creates the AVS script file only if it does not already exist. The script file is created in the same directory as the DGA file.

The AVS Template dialog box displays the current active template file. If no file is shown, then a template is not being used. The dialog box provides three possible actions:

Don't Use Template: Choose this action if you do not want DGAVCIndexNV to automatically create AVS scripts.

Change Template File: Choose this action to select your template file and make it the active template for AVS generation. This action pops up a file dialog which you use to select your template file.

Keep Current Template Choose this action if you want to keep the current template file.

This option setting is stored in the INI file and so is retained across DGAVCIndexNV invocations. When an INI file is not present, the AVS Template path defaults to a file named "template.avs" and located in the same directory as that of the executed DGAVCIndexNV.exe.

Use Full Paths

Table of Contents

DGA files and AVS files created via an AVS template contain references to files. This option controls whether they should be stored as relative paths or full paths. When this option is disabled, the DGA file and generated AVS scripts will suppress the full path information and provide just the relative paths; everything is relative to the location of the DGA file.

The option to continue using full paths was retained to provide backward compatibility to third-party applications.

This option setting is stored in the INI file and so is retained across DGAVCIndexNV invocations.

Enable Info Log

Table of Contents

When the Enable Info Log option is checked and the Information Panel is closed, either manually or automatically by DGAVCIndexNV, a log file is created that contains the information displayed in the Information Panel at the time of closure. The file name used is that of the input file with the extension changed to "log". The log file is created in the same directory as the input file. If this directory is not writable, then the log file is not created.

This option setting is stored in the INI file and so is retained across DGAVCIndexNV invocations.

Help Menu

Table of Contents

SIMD	Table of Contents

This is a read-only indicator displaying information about which SIMD optimizations were detected as available for this CPU.

DGAVCDecNV Quick Start Guide, DGAVCIndexNV User Manual, and DGDecodeNV User Manual

Table of Contents

These options open the respective documents in your browser. To work, the files "AVCQuickStart.html", "DGAVCIndexManual.html", "DGDecodeNVManual.html" that are included in the DGAVCDecNV package must be in the same directory as the "DGAVCIndexNV.exe" file. Do not rename these files.

Display Window

Table of Contents

Navigation

Table of Contents

Preview the video file and select the start/end points for the project.

Use the navigation slider, and these two buttons for navigation:

< - Seek to previous GOP (IDR frame or recovery point frame).
> - Seek to next GOP frame.



Currently, the display window displays only the first frame of a GOP in navigation mode (because they are possible selection points for cutting the video). This makes the video appear to jump when stepping, instead of moving smoothly. Of course, during play, preview, or frameserving, all frames are shown.

The mouse scrollwheel is supported. When you are not in play/preview mode, the scrollwheel will act as do the right and left arrow keys (< and >), i.e., it will effect GOP stepping. When you are in play/preview mode with single stepping enabled, the scrollwheel will act as does the right arrow key (>), i.e., it will effect frame stepping.

The video may in some cases appear stretched/squashed in the display window because DGAVCIndexNV displays the video as is it stored in the AVC stream, which may not be the same as the final display size. For an explanation, read Doom9's article on Aspect Ratios.

When a video is displayed that has a frame size that will not fit on a 1024x768 desktop, the video is reduced in size by a factor of two. Thus, high-definition (HD) videos can be previewed without requiring scrolling.

Selection

Table of Contents

Starting and ending points for the project may also be optionally specified.

[ button or HOME key - Mark selection start point.
] button or END key - Mark selection end point.


When doing Save Project or Preview, the operation will be applied only to the portion of the timeline between the selected start and end points.

By default, the entire timeline is automatically selected. Selection start/end point can be changed, but only one set of start/end point may be specified for a project (i.e.: multiple start/end points are not yet supported).

Splash Screen

Table of Contents

When no input file is loaded DGAVCIndexNV can display a splash screen. To enable this feature, place an appropriately sized windows BMP file called "dgavcindex.bmp" in the same directory as DGAVCIndexNV.exe. Several sample BMPs are available from the DGAVCDecNV home page.

Information Panel

Table of Contents

The Information Panel displays important statistics about the loaded video stream. Information displayed in this panel is often essential for correctly processing DGAVCIndexNV projects, especially when frameserving into third-party applications. The Information Panel is displayed when a project is saved or when using the Play/Preview commands. Note that when doing a Play/Preview operation, the information will apply only to the section actually played or previewed.

When the Enable Info Log option is checked and the Information Panel is closed, either manually or automatically by DGAVCIndexNV, a log file is created that contains the information displayed in the Information Panel at the time of closure. The file name used is that of the input file with the extension changed to "log". The log file is created in the same directory as the input file. If this directory is not writable, then the log file is not created.

Video Section

Table of Contents

Stream Type - Displays the stream type. Currently, DGAVCIndexNV is limited to AVC elementary streams, transport streams, and Matroska streams.

Profile - This field displays the AVC profile used to encode the currently loaded video.

Level - This field displays the AVC level used to encode the currently loaded video.

Coded Size - Displays the coded size of the frame in the currently displayed video. Note that this is the coded frame size, which may differ from the display frame size (see below).

SAR - Displays the sample aspect ratio specified in the AVC stream.

Display Size - Displays the display frame size that results from applying the SAR to the coded or cropped frame size. Here's how it works: Suppose you have a 1440x1080 video with a reported SAR of 4:3. You convert 4:3 to the fraction 4/3 and multiply that by 1440, giving a display width of 1920. Thus, the SAR field will show 4:3 and the Display Size field will show 1920x1080 as the display size.

Frame Rate - Displays the encoded playback frame rate of the currently loaded video.

Colorimetry - Displays the colorimetry scheme used by the stream. Note that if the stream does not declare the colorimetry, then ITU-R BT.709* is reported for HD video, and ITU-R BT.470-2* is reported for SD video. The * character indicates that the stream did not declare the colorimetry. The actual value read from the stream is shown in brackets.

Frame Struct - Displays the encoded structure of the current frame: Frame, Fields (TFF), Fields (BFF), or MBAFF.

Frame Type - Displays the type of the current frame: Intra (I), Predicted (P), or Bidirectional Predicted (B).

Coded # - Displays the total number of coded AVC frames encountered during the Save Project, Play, or Preview operation. If you Preview the stream from beginning to end, the coded count will be equal to the number of frames that libavcodec was able to decode, and it should match the frame count that DGDecodeNV reports via the Avisynth script. However, when you Save Project, the coded count may be a few frames higher, because all encoded frames are indexed, even if they are not decodable (frames are not decoded and displayed during a Save Project operation).

Playback # - Displays the total number of AVC frames displayed during the Save Project, Play, or Preview operation. This number can be greater than the Coded # if pulldown is present

Frame Rpts - Displays the total number of extra frames displayed due to frame repeat flags during the Save Project, Play, or Preview operation.

Field Rpts - Displays the total number of extra fields displayed due to field repeat flags encountered during the Save Project, Play, or Preview operation.

Bitrate - Displays a windowed video bitrate averaged over the last 30 frames.

Bitrate (Avg) - Displays the video bitrate averaged over all the displayed frames.

Bitrate (Max) - Displays the maximum video bitrate encountered over all the displayed frames.

Audio Section

Table of Contents

Displays the audio streams that were detected in the source stream.

Status Section

Table of Contents

Elapsed - Displays the time elapsed since starting the current Save Project, Play, or Preview operation.

Remain - Displays the time remaining for completion of the current Save Project, Play, or Preview operation.

FPS - Displays the frame rate achieved by DGAVCIndexNV's play/preview process. Note that this may not match the video frame rate of the stream, because the user can configure the playback speed, and because DGAVCIndexNV may not be able to decode the stream in real time.

Info - Displays video error information.

APPENDIX A: DGA File Structure

Table of Contents

This Appendix documents the syntax and semantics of the DGA file format. Normal users need not concern themselves with this information, as it is intended for developers and power users.

There are three sections to all DGA files: 1) the header section, 2) the settings section, and 3) the data section. These sections are described below.

DGA Format - Header Section

Table of Contents

Following is a typical header section:

DGAVCIndexFileNV3
Y:\DGAVCDecNV\DGAVCIndexNV\Release\

Y:\don1.264 8192000
Y:\don2.264 8192000

The first line always begins with the string "DGAVCIndexFile" immediately followed by a DGA version string. This string is checked by DGDecodeNV and must match the version expected. This mechanism thus enforces the requirement that DGAVCIndexNV and DGDecodeNV must be used in matched pairs. If DGDecodeNV rejects your DGA file as "obsolete", be sure that you are using the correct version of DGDecodeNV. Sometimes one forgets that one has an older version in the Avisynth plugins folder, or one forgets to upgrade DGDecodeNV when upgrading DGAVCIndexNV.

The second line specifies the path to the DGAVCIndexNV executable that DGDecodeNV will use to find the license file. The third line is blank and the fourth line specifies the first input stream file. Additional input files are listed after the first. Each input file line also gives the size of the input file. The header section must then terminate with a blank line.

The source file reference consists of either a relative path and filename, if the Use Full Paths option is disabled; or the full absolute path of the referenced file, if the Use Full Paths option is enabled. If the Use Full Paths option is enabled and the referenced file is moved after creation of the DGA file, you must either edit the path to be correct, or you must regenerate your DGA file.

DGA Format - Settings Section

Table of Contents

The settings section consists of one-line specifiers. The following specifiers are defined:

STREAM 1


The number on this line is interpreted as follows: 0 = elementary stream, 1 = transport stream, 2 = Matroska stream.

PKTSIZ 188


This specifier appears only if the input file is a transport stream. The number on this line specifies the transport packet size in bytes.

VPID 68


This specifier appears only if the input file is a transport stream. The number on this line specifies the video PID that was selected in DGAVCIndexNV.

FO 2


The number on this line is interpreted as follows: 0 = Honor Pulldown Flags, 1 = Force Film, and 2 = Ignore Pulldown Flags.

YUVRGB 1


The number on this line is interpreted as follows: 0 = TV scale, 1 = PC scale.

LUMFILT 0 0


The first number on this line is the luminance filter gamma. The second number is the luminance filter offset.

CLIP 0 0 0 0


The first number on this line is the cropping left value. The second number is the cropping right value. The third number is the cropping top value. The fourth number is the cropping bottom value.

RANGE 0 0


For elementary and transport streams, the first number on this line is the offset in the source file corresponding to the left selection range value. The second number is the corresponding trackbar position (0 to 3000). The third number is the offset in the source file corresponding to the right selection range value. The fourth number is the corresponding trackbar position.

For Matroska streams, the first number on this line is the timecode in the source file corresponding to the left selection range value. The second number is the corresponding trackbar position (0 to 3000). The third number is the timecode in the source file corresponding to the right selection range value. The fourth number is the corresponding trackbar position. Note that the right timecode value of 18446744073709551615 (0xffffffffffffffff) is special; it denotes that a left range is not set, or in other words, the left range is the end of the file.

AUDIO 80,c0


The string on this line is the comma-separated list of audio id's to demux. This line will list no audio id's for elementary and Matroska streams.

DGA Format - Data Section

Table of Contents

The data section consists of one-line specifiers identified with an upper-case keyword. For example:

SPS 6
PPS 65 0
IDR 104
FRM 7 0
PIC 3
FRM 5 -2
PIC 5
FRM 5 -1
PIC 5
FRM 5 3
PIC 6
FRM 6 1
PIC 3
FRM 6 2
PIC 3
FRM 5 6
PIC 4
FRM 6 4
PIC 6
FRM 6 5
PIC 6
FRM 5 9
PIC 5
FRM 6 7
PIC 4
FRM 6 8

SIZ 1920 x 1088
FPS 60000 / 2002


The data section of a DGA file contains the indexing of the AVC video stream. The syntax for each keyword line is as follows:

• SPS n: A new Sequence Parameter Set (SPS) is located at offset n (decimal) in the source file. Note that repeated identical SPS's are not new and so are not indexed. For Matroska streams, SPS's are not indexed because they are stored in metadata in the Matroska file.
• PPS n i: A new Picture Parameter Set (PPS) with ID i (decimal) is located at offset n (decimal) in the source file. Note that repeated identical PPS's are not new and so are not indexed. For Matroska streams, PPS's are not indexed because they are stored in metadata in the Matroska file.
• IDR n: For elementary and transport streams, an Instantaneous Decoder Refresh (IDR) frame is located at offset n (decimal) in the source file. For Matroska streams, an IDR frame is located at timecode n (decimal) in the source file.
• I n: For elementary and transport streams, an I frame is located at offset n (decimal) in the source file. For Matroska streams, an I frame is located at timecode n (decimal) in the source file.
• FRM x y: A frame of type x (refer to slice types in the AVC specification) with POC/2 y is present in the source file.
• RPS x: A Recovery Point SEI (RPS) is located at offset n (decimal) in the source file.
• PIC x: A Picture Timing SEI with picture structure x is present in the source file (refer to picture structure types in the AVC specification).
• SIZ W x H: The video frames have a coded width of W and a coded height of H.
• FPS N / D: The frame rate of the video is N/D.
• CODED n: The number of coded frames in the project.
• PLAYBACK n: The number of playback frames in the project.

Command-Line Interface

Table of Contents

Parameters

Table of Contents

DGAVCIndexNV can also be executed via a command-line interface. This feature is intended for use in automated scripts and batch files, and for use by third-party applications. Following is the syntax and semantics for the command line interface. Note that options not included are controlled by DGAVCIndexNV defaults and the DGAVCIndexNV INI file.

Table 1: Command-Line parameters supported by DGAVCIndexNV

Parameter	Command-Line Flag	Definition/Comments
Input File	-i filename -i file1,file2, ...	Specify input file(s). If the specified file cannot be found, it is ignored. Each filename should be double quoted if it contains spaces.
Video PID	-v videoPID	Transport stream video PID, hex notation. (e.g., -v 11)
PCR PID	-p pcrPID	Transport stream PCR PID, hex notation. (e.g., -p 11)
Field Operation	-f operation	0=Honor Pulldown Flags, 1=Force Film, 2=Ignore Pulldown Flags
YUV->RGB	-y method	1=PC Scale, 2=TV Scale
Output File	-o filename	Name of output index file, including the .dga extension. The filename should be double quoted if it contains spaces.
Output File with Video Demux	-od filename	Name of output index file, including the .dga extension. The filename should be double quoted if it contains spaces. Same as -o but the video elementary stream is demuxed.
Demux Audio	-a	Demux all detected audio streams.
Exit	-e	Exits DGAVCIndexNV when project has been saved.
Hide	-h	Starts and runs DGAVCIndexNV in the hidden state and exits when the project has been saved (forces -e option).

Example

Table of Contents

This example:

DGAVCIndexNV -i d:\files\movie.avc -o d:\MyProject.dga -f 2 -e

will save a project file, specifying:

Input File = d:\files\movie.avc
Output File = d:\MyProject.dga
Field Operation = Ignore Pulldown Flags
Exit on end


This example does the same but uses a file name with embedded spaces:

DGAVCIndexNV -i "d:\files\my wedding day.avc" -o "d:\my wedding day.dga" -f 2 -e

These examples do the same but multiple input files are opened:

DGAVCIndexNV -i file1.264,file2.264 -o file.dga -f 2 -e

DGAVCIndexNV -i "d:\files\my wedding day.264","d:\files\my divorce day.264" -o "d:\my wedding day.dga" -f 2 -e

Note that quoting is supported only for the -i and -o options.

APPENDIX C: Auxiliary INI File Options

Table of Contents

Some aspects of DGAVCIndexNV's behavior can be modified via the INI file but not through the GUI, as described below. DGAVCIndexNV creates defaults for these settings, but you can modify these lines in the INI file as you wish.

AVC_Extension=string: The extension used on demultiplexed AVC video files will be string. For example: AVC_Extension=264 will create a file such as "myfile.264".

AlwaysBottomCrop=0/1: If set to 1, then if the stream specifies bottom cropping, the cropping will be honored without asking the user. Also, if the stream does not specify cropping, but the coded height is 1088, then 8 pixels will be cropped from the bottom without asking the user. If set to 0, the user will be prompted for what to do in both these cases. When invoked via the CLI, AlwaysCropBottom is assumed to be 1, i.e., no prompting is performed.

UseD3D=0/1: If set to 1, then CUDA will be initialized for dependence on Windows D3D. If set to 0, then D3D-less operation is used. It is preferable to use UseD3D=0 but some Nvidia mobile adapter drivers do not yet support this mode.