home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 275 / DPCS0111DVD.ISO / Toolkit / Audio-Visual / VirtualDub / Source / VirtualDub-1.9.10-src.7z / src / helpfile / source / root.lina < prev    next >
Encoding:
Text File  |  2009-09-14  |  12.4 KB  |  262 lines
  1. <root>
  2.     <lina:set-option name="output-dir" target="../../out/Helpfile"/>
  3.     <lina:set-option name="link-truncate" baseurl="" notruncate/>
  4.  
  5.     <lina:fireball src="source/layout.css" dst="layout.css"/>
  6.  
  7.     <lina:macro name="create">
  8.         <lina:tag name="lina:htmlhelp-addfile">
  9.             <lina:attrib name="file"><lina:arg name="file"/></lina:attrib>
  10.         </lina:tag>
  11.         <lina:tag name="lina:write">
  12.             <lina:attrib name="file"><lina:arg name="file"/></lina:attrib>
  13.             <html>
  14.                 <head>
  15.                     <link rel="stylesheet" href="layout.css" type="text/css"/>
  16.                     <title>
  17.                         <lina:if-not-arg name="title">VirtualDub help</lina:if-not-arg><lina:if-arg name="title"><lina:arg name="title"/></lina:if-arg>
  18.                     </title>
  19.                 </head>
  20.                 <body>
  21.                     <div class="pagetop">
  22.                                     VirtualDub help<lina:if-arg name="title"> - <lina:arg name="title"/></lina:if-arg>
  23.                     </div><div class="body">
  24.                         <lina:body/>
  25.                     </div>
  26.                 </body>
  27.             </html>
  28.         </lina:tag>
  29.     </lina:macro>
  30.  
  31.     <lina:create file="index.html">
  32.         <p>
  33.             Welcome to the new helpfile for VirtualDub 1.5+.
  34.         </p>
  35.  
  36.         <p>
  37.             The old help file used to have some general tips on how to create video, but I've come
  38.             to the conclusion that such a help file is too much effort to maintain and that my efforts
  39.             in this area are better spent explaining what the options do rather than how to use them.
  40.             So, currently, this help file currently consists of comprehensive explanations of what
  41.             various settings dialogs in VirtualDub do.
  42.         </p>
  43.     </lina:create>
  44.  
  45.     <lina:macro name="note">
  46.         <table border="0" cellpadding="0" cellspacing="0" style="padding: 1px; margin: 16px 0px">
  47.             <tr>
  48.                 <td style="padding-right: 20px"><span style="border: 0 solid red; border-bottom-width: 1px">Note</span></td>
  49.                 <td width="*"><lina:body/></td>
  50.             </tr>
  51.         </table>
  52.     </lina:macro>
  53.  
  54.     <lina:macro name="dt">
  55.         <dt><span class="dtitle"><lina:body/></span></dt>
  56.     </lina:macro>
  57.  
  58.     <lina:macro name="image">
  59.         <lina:tag name="lina:fireball">
  60.             <lina:attrib name="src">source/<lina:arg name="src"/></lina:attrib>
  61.             <lina:attrib name="dst"><lina:arg name="src"/></lina:attrib>
  62.         </lina:tag>
  63.         <lina:tag name="img">
  64.             <lina:attrib name="src"><lina:arg name="src"/></lina:attrib>
  65.             <lina:if-arg name="width"><lina:attrib name="width"><lina:arg name="width"/></lina:attrib></lina:if-arg>
  66.             <lina:if-arg name="height"><lina:attrib name="height"><lina:arg name="height"/></lina:attrib></lina:if-arg>
  67.         </lina:tag>
  68.     </lina:macro>
  69.  
  70.  
  71.     <lina:include file="source/dialogs.lina"/>
  72.     <lina:include file="source/videofilters.lina"/>
  73.     <lina:include file="source/audiofilters.lina"/>
  74.     <lina:include file="source/crash.lina"/>
  75.     <lina:include file="source/capture.lina"/>
  76.     <lina:include file="source/render.lina"/>
  77.     <lina:include file="source/fxvideo.lina"/>
  78.     <lina:include file="source/htmltoc.lina"/>
  79.     <lina:include file="source/avi.lina"/>
  80.  
  81.     <lina:include file="source/batch/distributed.lina" />
  82.  
  83.     <lina:create file="capwarn.html">
  84.         Below are listed some issues you may have with video capture drivers.  VirtualDub detects these
  85.         drivers by name and/or filename, and the particular version you have installed may not have
  86.         the problems listed.  These are intended as notices for behavior to watch out for.
  87.  
  88.         <h2>miro/Pinnacle capture driver issues</h2>
  89.         <p>
  90.             You may experience abnormally slow UI response with this driver when using overlay display
  91.             mode and dialogs or menus overlap the display window.  Switching to Preview mode will avoid
  92.             this.  Also, under <em>Preferences</em>, the <em>Disable preview/overlay for menus and dialogs</em>
  93.             option may be helpful, as it attempts to automatically disable video as appropriate.
  94.         </p>
  95.  
  96.         <h2>Zoran capture driver issues</h2>
  97.         <p>
  98.             Some versions of this driver round off frame rates to the nearest millisecond period.  For instance,
  99.             specifying 15 fps as the desired frame rate may result in an actual capture rate of 14.925 fps (67 ms/frame)
  100.             or 15.152 fps (66 ms/frame).  The capture settings dialog has a "round" button to help you
  101.             specify an attainable frame rate, avoiding frame drops that would otherwise occur due to the discrepancy.
  102.             The Quick FPS menu at the bottom right of the window also has frame rates pre-rounded to milliseconds
  103.             for convenience.
  104.         </p>
  105.  
  106.         <h2>Brooktree/Conexant BT8x8 driver issues</h2>
  107.         <p>
  108.             The BT8x8 series of video capture chips can't capture the same video data to both memory and
  109.             the display at the same time.  As a result, attempting to capture both fields (height >240 NTSC or >288 PAL)
  110.             while Overlay display is enabled may result in the overlay stopping or strange errors appearing.
  111.             Use Preview mode or disable display in order to capture both fields.
  112.         </p>
  113.         <p>
  114.             Note that this may not apply to you if the chip is integrated into your video card.
  115.         </p>
  116.     </lina:create>
  117.     
  118.     <lina:create file="non-admin.html" title="Running VirtualDub as non-administrator">
  119.         <p>
  120.             VirtualDub can be run from a Windows user account with limited privileges, but there are some
  121.             limitations to be aware of.
  122.         </p>
  123.         <h2>File layout</h2>
  124.         <p>
  125.             Currently, VirtualDub stores batch queue information in a writable file called VirtualDub.jobs, placed next to
  126.             the program file (VirtualDub.exe). If VirtualDub is located in a folder that is not writable by the current user,
  127.             the job queue will not be saved between sessions.
  128.         </p>
  129.         <h2>Operations that require elevated privileges</h2>
  130.         <p>
  131.             The "shutdown when finished" option in the Job Control dialog requires shutdown privileges.
  132.         </p>
  133.         <p>
  134.             Preallocating disk space in capture mode works differently depending on whether the "Manage Volume" privilege is available, which
  135.             is normally granted only to administrators. If this privilege is available, VirtualDub preallocates space very
  136.             quickly; if it is not available, then capture files can still be preallocated, but Windows will zero the entire file, which can
  137.             take some time.
  138.         </p>
  139.         <lina:note>
  140.             The turbo preallocation mode causes the capture file to contain whatever was previously on the disk, which may cause the contents
  141.             of previously deleted files to reappear until the capture finishes and the unused space is re-deleted. If you are on a shared
  142.             system, you may want to protect the directory with the capture file so that non-administrators cannot read the old data in the
  143.             capture file.
  144.         </lina:note>
  145.     </lina:create>
  146.     
  147.     <lina:create file="cmdline.html" title="Command-line operation">
  148.         <p>
  149.             It is possible to invoke VirtualDub in the background and control it in a limited fashion from other
  150.             programs.
  151.         </p>
  152.         
  153.         <h2>VirtualDub command-line options</h2>
  154.         <p>
  155.             First, specifying a filename on the command line causes VirtualDub to load it as a video file on startup.
  156.             This is the same as loading it using <em>File > Open video file...</em>, with the default autodetect-format
  157.             mode.
  158.         </p>
  159.         <blockquote><pre>virtualdub "My video.avi"</pre></blockquote>
  160.         <p>
  161.             The /s flag runs a script; its one argument is the filename of the script to run. Configuration files (.vcf) are
  162.             scripts. Note that the order of arguments is significant; some settings, such as the edit list, are reset when
  163.             a video file is opened.
  164.         </p>
  165.         <blockquote><pre>virtualdub /s mySettings.vcf myVideo.avi</pre></blockquote>
  166.         <p>
  167.             When /x is used, VirtualDub exits when it runs through the whole command line. Its position relative to other
  168.             options does not matter.
  169.         </p>
  170.         <blockquote><pre>virtualdub myVideo.avi /s reprocess.script /x</pre></blockquote>
  171.         <p>
  172.             The /p flag tells VirtualDub to add a batch job using the current settings and the given source and destination
  173.             filenames. The /b flag adds jobs to process an entire directory into another.
  174.         </p>
  175.         <blockquote><pre>virtualdub /s mySettings.vcf /p source.avi dest.avi /x</pre></blockquote>
  176.         <p>
  177.             /r causes VirtualDub to process the job queue; /c tells VirtualDub to clear it.
  178.         </p>
  179.         <blockquote><pre>virtualdub /s mySettings.vcf /c /b source dest /r /x</pre></blockquote>
  180.         <p>
  181.             /i invokes a script with arguments. All arguments following the script filename until the next switch are
  182.             passed to the script in the <tt>VirtualDub.params[]</tt> array.
  183.         </p>
  184.         <blockquote><pre>virtualdub /i process.script from.avi to.avi /x</pre></blockquote>
  185.         <p>
  186.             Finally, the <tt>/queryVersion</tt> flag causes VirtualDub to exit with its build number as the return code.
  187.             This can be used to programmatically adapt to multiple versions.
  188.         </p>
  189.         <blockquote><pre>virtualdub /queryVersion</pre></blockquote>
  190.         <p>
  191.             For the full list of supported command-line switches, run <tt>virtualdub /?</tt>.
  192.         </p>
  193.         
  194.         <h2>Invoking VirtualDub</h2>
  195.         <p>
  196.             The <tt>start</tt> command can be used to launch VirtualDub with lower
  197.             priority than usual for background operation.
  198.         </p>
  199.         <blockquote><pre>start /low virtualdub.exe</pre></blockquote>
  200.         <p>
  201.             Because <tt>virtualdub.exe</tt> and <tt>veedub64.exe</tt> are GUI programs, the command interpreter in Windows
  202.             will not wait for them to exit before returning. In addition, its main window will appear as usual. This can
  203.             be changed by using the <tt>vdub.exe</tt> or <tt>vdub64.exe</tt> front ends, which launch the main application
  204.             in a special command-line mode.
  205.         </p>
  206.         <blockquote><pre>vdub /i GetVideoLength.script foo.avi</pre></blockquote>
  207.         <p>
  208.             When the command line front end is used, VirtualDub automatically starts with its main window minimized (but not
  209.             hidden), and automatically exits when it has completed processing (implicit /x). In addition, log output is
  210.             diverted to standard output.
  211.         </p>
  212.         
  213.         <h2>Caveat: Using VirtualDub in unattended processes</h2>
  214.         <p>
  215.             If you integrate VirtualDub as part of an unattended process and need to track processes, you should remember
  216.             that <tt>vdub.exe</tt> and <tt>vdub64.exe</tt> are just front ends for <tt>VirtualDub.exe</tt> and
  217.             <tt>Veedub64.exe</tt>. This has implications for monitoring the VirtualDub process or forcibly killing it.
  218.             If you send a Ctrl+C event to the command-line driver, it will attempt to soft-stop the main process
  219.             via a WM_QUIT event. However, if you kill the command-line driver process outright, the main process will
  220.             continue to run. If you need to forcibly kill the VirtualDub process, you must kill the main GUI process;
  221.             killing the command-line driver process is optional as it will automatically exit anyway whenever the
  222.             GUI child terminates.
  223.         </p>
  224.  
  225.     </lina:create>
  226.  
  227.     <lina:create file="amd64.html" title="AMD64 version">
  228.         <p>
  229.             VirtualDub comes in two versions, the regular 32-bit x86 version, and a 64-bit version for processors that support
  230.             the AMD64 architecture. The AMD64 version has some differences from the 32-bit version.
  231.         </p>
  232.         <p>
  233.             There is currently no version for the 64-bit Intel Itanium architecture.
  234.         </p>
  235.         <h2>System requirements of VirtualDub for AMD64</h2>
  236.         <p>
  237.             In addition to the regular system requirements, the AMD64 version of VirtualDub also requires:
  238.         </p>
  239.         <ul>
  240.             <li>A CPU that supports executing AMD64 code. As of this writing, this includes the AMD Athlon 64, AMD Opteron, and
  241.                 Intel Xeons with EM64T.</li>
  242.             <li>Windows XP x64 Edition, Vista x64 Edition, or another version of Windows which natively runs in AMD64 long mode.</li>
  243.         </ul>
  244.         <p>
  245.             It is not possible to run the AMD64 version of VirtualDub on a 32-bit version of Windows even if the CPU is
  246.             64-bit capable.
  247.         </p>
  248.         <h2>Differences between the x86 and AMD64 versions</h2>
  249.         <p>
  250.             Not all functionality has been ported to 64-bit, so the selection of video filters is reduced compared to the
  251.             32-bit version. In addition, some functionality which is supported is not fully optimized compared to the 32-bit
  252.             equivalent, so the 64-bit version may or may not be faster than the 32-bit version for your scenario.
  253.         </p>
  254.         <p>
  255.             Due to an OS limitation, 64-bit programs cannot load 32-bit DLLs, and vice-versa. As a result, use of the 64-bit version
  256.             of VirtualDub requires 64-bit video codecs and 64-bit video filters; 32-bit video codecs will not show up in the video
  257.             codec list or be available for opening AVI files, and 32-bit video filters will not load. In addition, AVIFile drivers must
  258.             be 64-bit to be used on load; in particular, VirtualDub for AMD64 cannot be used with the regular 32-bit version of Avisynth.
  259.         </p>
  260.     </lina:create>
  261. </root>
  262.