AviDub

AviDub permits the user to easily process open source Avisynth (AVS) and VirtualDub (Vdub) filters.  The idea is simple. Select something from Vegas (an event, loop region, region or the entire project) that you want to filter.  Select a means of rendering from the timeline (frameserver or direct render).  Select the Avisynth and/or VirtualDub filters that you want to apply.  Select a VirtualDub rendering template.  Then render.  The result can be simply saved, added back to the timeline on a new track or added as a Take (only for event renders).  There is also an option for direct X264 rendering for Avisynth filters including GPU-assisted renders.  When AviDub first loads, there is a GPU check to see what assisted render options are available.  There are also a number of Deshaker scripts included as well as a GUI for changing deshaker parameters.

 

1. What to Render.

a. Events .  Multiple events may be selected from a single track. The rendered media file may be added back to the event as a Take, rendered to  New Track or just saved.

b. Loop region .  If selected, the loop region will be rendered to a New Track or just saved. 

c. Regions .  If selected, all regions will be rendered to a New Track or just saved.

d. Selected Regions.     Opens a dialog where the user may select which regions to render.  Region names may be directly entered or edited and will be saved in the project.

 

e. Project .  The entire project will be rendered to a new track or just saved.

f.   Launches Otter NavBar  which permits the user to navigate the timeline, select tracks and events, and set in and out points for render loop.

g. Same Track

(1) Unchecked.  Selected events or events within the loop, region or project will be copied a new temporary track where fades, video Fx, pan/crop settings, etc. will be removed unless checked in the What to Keep info box . 

(2) Checked.  No temporary track will be created and no events copied.   Video Fx, pan/crop settings, etc. will still be removed unless checked in the What to Keep info box.  This option is useful for pre-rendering certain Fx such as Mercalli stabilization where copying to a new track and maintaining those Fx are not possible.  During the render, selected track is Soloed, thus muting other video tracks.

(3) If this option is selected, the following warning appears.  The user may continue with the render or return to the GUI.  There is also a checkbox to disable this warning in the future.

h.  All Tracks .  This option is available only if Same Track is checked.  If checked, all tracks will be included in the render unless muted by the user prior to rendering.  It is useful for pre-rendering events or loops  where the user wants to add titles or other graphic Fx such as Hitfilm to the pre-rendered video.

2. What to Keep .

a. Event Fx .  If checked, event Fx will be kept

b. Pan/Crop Settings. If checked, pan/crop settings will be kept.

c. Audio.   If checked, the audio for the selected event will be rendered.  A copy will be made and all fades and FX removed.  If unchecked, audio may still be included by muting unwanted tracks.  No copy will be made and fades and FX will not be removed.

 3 . How to Save .

a. Add as Take.  This option is available only for Event renders.  If selected, the rendered media file's videostream will be added back to the original video event as a Take.   If Original Audio is checked in What to Keep (#2), the rendered file's audio stream will be added as a Take to the selected event's audio track.

b. Render to New Track. This options is available for all types of renders.  If selected, the rendered file's videostream  will be added to a new track entitled "Rendered Video".  If Original Audio is checked in What to Keep (#2), the rendered file's audio stream will be added to a new track entitled "Rendered Audio".

c. Save Only . If selected, the rendered media file will just be saved.  It will not be added back to the timeline. 

 

4. Render Options.  AviDub supports two methods of rendering the videostream from Vegas--frameserving and direct render, the default being frameserving.  The default is frameseerving.  A dummy avi file is created (fs.avi) which permits video from Vegas to be sent frame by frame to Avisynth and/or VirtualDub for processing.  Because of certain limitations, the frameserver is used only for processing the videostream.  Audio is always rendered directly.  .

a. Direct Render . The alternative to frameserving is a direct render to an intermediate.  The disadvantages of this approach are the added time for a separate render and the large file sizes that can be created if lossless codecs are used.  However, there are some advantages.   For one, 10bit intermediates such as MagicYUV or Magix Intermediate (ProRes) may be used to maintain a true 10bit pipeline.  Additionally, the temp file can be saved and re-used for quickly trying different Avisynth or VirtualDub filter settings.   If ticked, the AviDub GUI is expanded to include the following section.

(1) Render template selection

(a) Renderer .  Drop-down list of favorite renderers.

(b) Template . Drop-down list of favorite templates for each renderer.

(c)   Opens the Vegas render template selection dialog where render templates may be added to favorites.

(2) Temp File Options

(a). Delete.  If this option is selected, the temp file will be deleted after each run.  This is considered to be  the "normal" option.

(b). Save. If selected, the temp file will be saved so that it may be processed again without re-rendering from Vegas. 

(c). Use. This option is automatically selected following a run in which the save file option was selected.  The temp file will be processed repeatedly until the user selects another option.  Note that the option of creating and using a temp file is available only for a single event or loop region.

(3) Temp File Folder .  For frameserving, the temp file is very small and is always located in the AviDub folder.  However, for direct renders, the temp file can be very large and should be located elsewhere from the C drive.  A left-click on the folder icon opens the browse folder dialog where a the desired location can be selected or a new folder created.

b. Use Media Properties .  If checked, Vegas project settings will be temporarily changed to the settings of the media file for render.  If unchecked, project settings will be used for the render from Vegas.

c. No Check.  A template check is available only for direct renders from Vegas.  It compares the properties of the selected render template with the properties of the media file that is being rendered.  If there is a mis-match (For example, the media file is interlaced, but the render template is progressive) a warning is shown with options to abandon or continue the render.  There is a another check once the rendered file is added back to the timeline.  If checked, this template check will be by-passed altogether.

 

d. RGB32. If ticked, the DebugMode FrameServer will be set to RGB32 rather than the usual RGB24.  This enables the user to bypass the ConvertToRGB32() command in Avisynth required for certain filters such as defish.

5. Project Templates .  Project templates may be saved and loaded for later use.  A template consists of all current dialog settings at the time of creation. 

a. AviDub Project Templates .  Dropdown list of saved project templates.

b.   Saves current settings to a new template.  First, enter the name of the template and then click on the + button.

c.   Deletes the selected template.  First, select the template to be removed and then click on the X button.

6. Avisynth Filter Settings .  To apply an AVS filter, the following part of the GUI is used. 

a. Enable AVS Filtering.  First, the Use Avisynth Filter checkbox must be checked.  If unchecked, the remainder of the info box is disabled.

b. Select AVS Filter. Filters are selected from a drop-drop box.  If the icon   (transparent center) precedes the drop drop down box, the list will include all scripts found in the default Avisynth script folder.  If the icon  (white center) precedes the drop down box, the list will  include only those scripts defined as "Favorites".

c. Add/Remove from Favorites.  A script selected from the list found in the Avisynth script folder be designated a "Favorite" by left-clicking on the green plus  icon.  To delete a favorite, first select it from the drop down list of Favorites.  Then left-click on the   icon.   When adding or removing scripts from the Favorites list, a confirmation message box will appears.

d. Use "as is" .  If checked, the AVS script will be used "as is" without AviDub making checks to ensure accuracy and the correct temp file location.  Use cautiously.

e. Edit AVS Filter Script.  To edit an AVS Filter script, left click on the pencil icon  which will open your default text editor.  You must make sure that your default text editor is configured to open files with both  "avs" and "avsi" extensions.

f. Open Avisynth Scripts Folder.  To open the Avisynth scripts folder, click on the folder icon .

7. Avisynth Render Options.  To select render options, the following part of the GUI is used.

 

a.  Select Option.  A dropdown list provides render options from Avisynth.  These include a number of direct render using the MagicYUV and UtVideo  codecs, a direct render to X264 or a pass through to VirtualDub2.   If  Pass to VirtualDub2 is not selected,  the blue gear icon  becomes enabled which allows opening of the x264 Direct Render Configuration dialog from which a render template may be selected or designed.  A complete description of this dialog may be found in  x264 Render Template  .

 

b. Color Matrix .  Drop down list of the following options:   Auto - HOS attempts to maintain the same luminance and chrominance; None - Default with no conversion specified which is the same as the SD-TV option; HD-PC - PC.709 - HD coefficients, Full Range (0-255); SD-PC - PC.601 - SD coefficients, Full Range (0-255); HD-TV - Rec709 - HD coefficients, Limited Range (16-235); SD-TV - Rec601 - SD coefficients, Limited Range (16-235); RGB - Converts to 24bit RGB; and RGBA - Converts to 32 bit RGB for alpha channel;

8. VirtualDub Filter Settings. To apply a Vdub filter, the following part of the GUI is used.

 

a. Enable Vdub Filtering.  First, the Vdub Filter checkbox must be checked.  If unchecked, the remainder of the info box is disabled.

b. Select Vdub Filter.  Filters are selected from a drop-drop box.  If the icon   (transparent center) precedes the drop drop down box, the list will include all scripts found in the default VirtualDub Filter Settings folder.  If the icon  (white center) precedes the drop down box, the list will  include only those scripts defined as "Favorites".

c. Add/Remove from Favorites.  A script selected from the list found in the VirtualDub filter settings folder be designated a "Favorite" by left-clicking on the green plus  icon.  To delete a favorite, first select it from the drop down list of Favorites.  Then left-click on the   icon.   When adding or removing scripts from the Favorites list, a confirmation message box will appears.

d. Deshak Options .  If a Deshaker script is selected, three options are enabled.

(1)  Edit. If checked, the Deshaker Parameters dialog appears once the Render button is clicked.

(2) Use Last.  If checked, the last used deshaker settings will be used again.

(3) Pass 2.  If checked, only the Pass 2 will be executed.

e. Use Vdub32.  The default is now the use of the 64bit version of VirtualDub.  If ticked, the 32 bit version will be used in the event you are using 32bit filters.  If at all possible, use of 64 bit filters is recommended.

f. Edit Vudb Filter Script.  To edit a Vudb Filter script, left click on the pencil icon  which will open VirtualDub and load the settings file.  Changes may be made and saved.

g. Open VirtualDub Filter Settings Folder.  To open the VirtualDub scripts folder, click on the folder icon .

9. VirtualDub Render Settings.  To select Vdub render settings, the following part of the GUI is used.

 

a. Select Render Template.    Render templates are selected from a drop-drop box.  If the icon   (transparent center) precedes the drop drop down box, the list will include all templates found in the default VirtualDub Render Settings folder.  If the icon  (white center) precedes the drop down box, the list will  include only those scripts defined as "Favorites".

b. Add/Remove from Favorites.  A template selected from the list found in the VirtualDub render settings folder be designated a "Favorite" by left-clicking on the green plus  icon.  To delete a favorite, first select it from the drop down list of Favorites.  Then left-click on the   icon.   When adding or removing scripts from the Favorites list, a confirmation message box will appears

c. Render Template Properties.  Once a render template is selected, the following properties will be displayed: (1) FourCC code; (2) Container; (3) Audio Encoder; and (4) Bitrate.

d. Edit Render Template.  To edit a Vudb render setting file, left click on the pencil icon  which will open VirtualDub and load the settings file.  Changes may be made and saved.

e. Open VirtualDub Render Settings Folder.  To open the VirtualDub scripts folder, click on the folder icon .

10. Where to Save . There are three options.

a. Specific Folder LocationRendered media files are stored in a specific folder selected by the user.  A left-click on the folder icon  opens the browse folder dialog from which the location is selected or a new folder created.  Previous saved folders are shown on a dropdown list.  To remove a saved folder, right-click and click on "Yes".   If "Create Project Name Sub-folder" is checked, a sub-folder will be created in that location with the name of the subfolder being the Project name.

b. Sub-folder of Project Folder. Rendered media files are stored in a sub-folder in the  folder where the Vegas project is located.  The name  of the sub-folder may be entered into the textbox on  the right.

c. Sub-folder of Media File Folder .  Rendered media files are stored in a sub-folder in the  folder where the media file is located.  The name of  the sub-folder may be entered into the textbox on the right.This option is available only for event renders.

d.   Opens the selected save folder in File Explorer.

e.  Opens the File Renaming Setup dialog where the user can customize the name of the rendered file.  Click  here   for detailed information.

f. Add File Tag .  If  "Add File Tag" is ticked, a file tag will be added which is any additional text that you want to  be included in the rendered events file name. A new name can be entered into the textbox.

1. Auto Fill.  If unchecked, the name shown in the textbox will be the file tag.  If checked, it permits auto file tag naming based upon the name of the AVS or Vdub filter settings file. 

2. Auto File Tag Setup   A left-click on the icon opens the following dialog where auto file tag pairs may be defined.  Two pair are already included.  A script name that contains "denoise" will have a "dnoise" added as its file tag whereas any script name that contains "deshake" will always have "dshak" as its file tag.  These may be changed and new pairs added.

11. After Render.

a. Show Render Stats. If checked, render statistics will be shown upon render completion.

 

b. Play. If checked, the rendered file will be opened in Media Player Classic - Home Cinema for immediate playback. A complete description of this dialog may be found in  OtterPlay .

 

c. Open Folder.  If checked, the rendered file folder will be opened and the file selected.

12. Processing Options

a. Set.  If checked, it enables the user to change Maximum Memory and the number of Threads that are used for Avisynth processing.  The MaxMemory and Thread settings for the included scripts are fairly conservative--1024kb of memory and 4 threads.  Since AVS processing can be very demanding, performance is highly dependent an individual's system capabilities.  Finding optimal performance for one's system is pretty much trial and error.  If unchecked, AviDub will use the memory and thread settings contained in the original script.  A drop down list contains common memory sizes.  If "Custom" is selected, the amount of memory can be entered in the Set Mem textbox.  Then left-click the green check mark.

b. Preview Frames.  The number of frames that will be rendered if the Preview button is clicked.  

13. Preview. The preview option enables the user to have a "quick-look" at just a few rendered frames beginning at the position of the cursor.  The number of frames rendered is controlled by the numeric up/down box in the Processing Options box.  A new track named "Preview" will be created which contains the rendered preview file.  The next time AviDub is launched, the Preview file and track will be removed from the project.

14. Render .  Starts the render.

15. Batch.  Saves the project and render settings and then adds them to the Batch Render queue for later processing.

16. Cancel.  Closes the GUI without rendering.