-<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">\r
-\r
-<html>\r
- <head>\r
- <meta name="generator" content="HTML Tidy, see www.w3.org">\r
-\r
- <title></title>\r
- </head>\r
-\r
- <body>\r
-<H1>VirtualDub plug-in</H1>\r
-<H2>Introduction</H2>\r
-<P><B><U>Important:</U> Make sure that\r
-you read this documentation carefully in order to avoid mistakes!</B></P>\r
-<P>The prerequisite for using this\r
-plug-in is that you already familiar with the “manual”\r
-process of encoding clips with VirtualDub (<A HREF="http://www.virtualdub.org/">www.virtualdub.org</A>).\r
-The great thing about VirtualDub is that it offers both a graphical\r
-user interface (GUI), accessible via <B>virtualdub.exe</B>, and a\r
-command line interface (CLI), accessible via <B>vdub.exe</B>.</P>\r
-<H2>Step 1: create VDub configuration\r
-files (VCF)</H2>\r
-<P>Let's say we had a clip that we\r
-wanted to encode not only once, but twice – into different\r
-formats. Let's say that the first goal is to encode it to a loss-less\r
-Huffyuv clip, and the second goal is to encode it to a quality-based\r
-1-pass XviD clip using MP3 sound.</P>\r
-<P>What you need to do first is to open\r
-VirtualDub, set up the settings for one of the goals (by going into\r
-the video compression and audio compression dialogs) and then click\r
-on File → Save processing settings (CTRL+S). You will end up\r
-with saving a .vcf file somewhere on your hard drive …\r
-remember where you put it! After that, you'd set up the settings for\r
-your second goal and save these processing settings as well, as a new\r
-.vcf file.</P>\r
-<H2>Step 2: Enable and set up the VDub\r
-plug-in</H2>\r
-<P>First we need to set up the global\r
-settings of the plug-in. Go into the preferences dialog and enable\r
-the plug-in.</P>\r
-<P><img src="images/preferences_global_vdub.gif"/></P>\r
-<P>Use the “...” button to\r
-specify the path to the vdub.exe file. The setting <B>max number of\r
-VCFs per job</B> is important, because the number you put in there\r
-will influence how many VCF files you will be able to select in the\r
-<B>job dialog</B> (the dialog where you create or edit a\r
-job/template). For our example we need to set it to 2, but it doesn't\r
-matter if you choose a higher value. Since VDub will encode <B>two</B>\r
-files for us, we will have to tell VDub under which filenames to save\r
-them. You can select which approach you want to use by configuring\r
-the setting <B>output as suffix(0) or file(1)</B>. If you <B>don't</B>\r
-check the checkbox this means that you will enter a small part of the\r
-file name, the <B>suffix</B>, that will be put at the end of the\r
-original file name. E.g. if your original filename was\r
-“C:\render\myVideoFile.avi”, and the suffix is\r
-“_huffyuv”, the resulting file would be\r
-“C:\render\myVideoFile_huffyuv.avi”. However, if you\r
-checked that checkbox, you would instead get a “...”\r
-button that allows you to specify the filename for the resulting file\r
-manually (this is handy if you wanted to save the file to another\r
-folder for example).</P>\r
-<P>The <B>show extra options</B> setting\r
-will be explained at the end of this page.</P>\r
-<P>Let's now have a look at the dialog\r
-when editing a job</P>\r
-<H2>Step 3: Set up the job-specific\r
-settings</H2>\r
-<P>Open the job dialog.</P>\r
-<P><img src="images/edit_job_vdub.gif" />/P>\r
-<P>Let's ignore the 2 checkboxes at the\r
-top for a moment. What you will need to do is to specify the path to\r
-the 2 .vcf files you created previously in VirtualDub in step 1. Then\r
-you need to specify the suffix (or the file using the file-chooser)\r
-so that VDub knows where to save the encoded videos.</P>\r
-<H2>Step 4: Run the plug-in</H2>\r
-<UL>\r
- <LI><P>If you had your job recorded\r
- (without using the plug-in) then the status of the job will already\r
- be “<B>done”</B> and you can right-click the job and run\r
- the VirtualDub plug-in</P>\r
- <LI><P>If the job has <B>not</B> been\r
- recorded yet, just click on Start processing and wait for the result</P>\r
-</UL>\r
-<H2>Additional information</H2>\r
-<H3>Empty VCF paths</H3>\r
-<P>As you know you can specify any\r
-number in the <B>preferences dialog</B> for the setting <B>max number\r
-of VCFs per job</B>. In case of our example that consists of 2 jobs,\r
-if you selected 3 (or more) as max. number, and then opened the <B>job\r
-dialog</B>, you would see 3 fields each for the <B>path to VCF file</B>\r
-and <B>output file</B> setting. This, however, is not a problem. The\r
-plug-in will only execute those VCF jobs for which both the path to\r
-the VCF and the output file fields are filled with proper\r
-information.</P>\r
-<H3>VDub job control</H3>\r
-<P>You still don't know what the 2\r
-checkboxes in the <B>job dialog</B> at the top of the VDub settings\r
-mean. What you need to know is that VirtualDub is having its own “job\r
-queue”, which, however, is called <B>“job control”</B>.</P>\r
-<P>The following scenarios can make\r
-sense:</P>\r
-<UL>\r
- <LI><P>Having <B>both</B> checkboxes\r
- <B>enabled</B>: Each time a new NDR job is executed which has\r
- VirtualDub jobs, the <B>job control</B> of VirtualDub will be\r
- cleared. This means that if you had other, old things in there\r
- (possibly when working with VirtualDub outside of the NDR) that\r
- these will be deleted from VirtualDub's job control, before the new\r
- jobs are added there. Checking the second checkbox means that after\r
- adding one of the VirtualDub jobs from within the the NDR,\r
- VirtualDub will actually encode them right away (which you will\r
- want, at least under normal circumstances).</P>\r
- <LI><P>Having <B>both</B> checkboxes\r
- <B>disabled</B>: In this case the only thing the NDR would do would\r
- be to add the two jobs to the job control of VirtualDub, but\r
- VirtualDub won't be encoding them. They are just put into the queue.\r
- This means that if you were to start the the graphical user\r
- interface of VirtualDub after the NDR completed processing, and open\r
- the Job Control (F4), you'd see these jobs “waiting”,\r
- and you could render them by pressing the Start button in Virtual\r
- Dub.</P>\r
-</UL>\r
-<P>The reason why these checkboxes exist\r
-is flexibility. I often want the NDR to record stuff over night,\r
-because during the recording process my PC is virtually unusable.\r
-However, encoding clips in VirtualDub is a task that, depending on\r
-the codec, can be done in the background and allows me to use the PC\r
-for other things. In this case I'd disable both checkboxes, have the\r
-NDR record all clips and add them to VirtualDub's job control, and\r
-then on the next day, I decide when and which jobs to encode into\r
-different formats from within the VirtualDub GUI.</P>\r
-<P>And btw, just to be clear, the <B>second</B>\r
-checkbox means that, <B>when enabled</B>, VirtualDub would actually\r
-start encoding <U><B>all</B></U> clips that have already been in\r
-VirtualDub's job control and that have not been encoded yet.</P>\r
-<H3>Extra options</H3>\r
-<P>If you selected the <B>show extra\r
-options</B> checkbox in the <B>preferences dialog</B>, you will\r
-notice that, in the <B>job dialog</B>, you got 2 additional\r
-settings/checkboxes for each VCF file. Their names are pretty much\r
-self-explanatory. I added these checkboxes because, after a scene was\r
-rendered, I usually have the clip encoded into a loss-less format\r
-(e.g. Huffyuv) right away. Since it is no problem to encode further\r
-things (e.g. compressed XviD movies) based on the Huffyuv clip\r
-(instead of always using the original avi file), enabling both these\r
-checkboxes for VCF 1 would mean that the 2<SUP>nd</SUP> (3<SUP>rd</SUP>,\r
-4<SUP>th</SUP> …) VCF jobs will be based on the\r
-huffyuv-encoded file, and I got rid of original, big video as well,\r
-saving hard disk space.</P>\r
-<H3>Trouble shooting</H3>\r
-<P>In case you suspect that the\r
-expected, encoded file(s) is somehow incorrect (or even missing),\r
-have a look at the <B>logs</B> directory in the NDR folder. You will\r
-see log-files with the following format:</P>\r
-<P>VirtualDub_NameOfTheJob_vcf1.log</P>\r
-<P>Instead of “vcf1” you\r
-might also find “vcf2”, “vcf3”... it\r
-specifies for which VCF file of that job the log file stands for.</P>\r
-<P><BR><BR>\r
-</P>\r
- </body>\r
-</html>\r
-\r
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
+
+<html>
+ <head>
+ <meta name="generator" content="HTML Tidy, see www.w3.org">
+
+ <title></title>
+ </head>
+
+ <body>
+<H1>VirtualDub plug-in</H1>
+<H2>Introduction</H2>
+<P><B><U>Important:</U> Make sure that
+you read this documentation carefully in order to avoid mistakes!</B></P>
+<P>The prerequisite for using this
+plug-in is that you already familiar with the “manual”
+process of encoding clips with VirtualDub (<A HREF="http://www.virtualdub.org/">www.virtualdub.org</A>).
+The great thing about VirtualDub is that it offers both a graphical
+user interface (GUI), accessible via <B>virtualdub.exe</B>, and a
+command line interface (CLI), accessible via <B>vdub.exe</B>.</P>
+<H2>Step 1: create VDub configuration
+files (VCF)</H2>
+<P>Let's say we had a clip that we
+wanted to encode not only once, but twice – into different
+formats. Let's say that the first goal is to encode it to a loss-less
+Huffyuv clip, and the second goal is to encode it to a quality-based
+1-pass XviD clip using MP3 sound.</P>
+<P>What you need to do first is to open
+VirtualDub, set up the settings for one of the goals (by going into
+the video compression and audio compression dialogs) and then click
+on File → Save processing settings (CTRL+S). You will end up
+with saving a .vcf file somewhere on your hard drive …
+remember where you put it! After that, you'd set up the settings for
+your second goal and save these processing settings as well, as a new
+.vcf file.</P>
+<H2>Step 2: Enable and set up the VDub
+plug-in</H2>
+<P>First we need to set up the global
+settings of the plug-in. Go into the preferences dialog and enable
+the plug-in.</P>
+<P><img src="images/preferences_global_vdub.gif"/></P>
+<P>Use the “...” button to
+specify the path to the vdub.exe file. The setting <B>max number of
+VCFs per job</B> is important, because the number you put in there
+will influence how many VCF files you will be able to select in the
+<B>job dialog</B> (the dialog where you create or edit a
+job/template). For our example we need to set it to 2, but it doesn't
+matter if you choose a higher value. Since VDub will encode <B>two</B>
+files for us, we will have to tell VDub under which filenames to save
+them. You can select which approach you want to use by configuring
+the setting <B>output as suffix(0) or file(1)</B>. If you <B>don't</B>
+check the checkbox this means that you will enter a small part of the
+file name, the <B>suffix</B>, that will be put at the end of the
+original file name. E.g. if your original filename was
+“C:\render\myVideoFile.avi”, and the suffix is
+“_huffyuv”, the resulting file would be
+“C:\render\myVideoFile_huffyuv.avi”. However, if you
+checked that checkbox, you would instead get a “...”
+button that allows you to specify the filename for the resulting file
+manually (this is handy if you wanted to save the file to another
+folder for example).</P>
+<P>The <B>show extra options</B> setting
+will be explained at the end of this page.</P>
+<P>Let's now have a look at the dialog
+when editing a job</P>
+<H2>Step 3: Set up the job-specific
+settings</H2>
+<P>Open the job dialog.</P>
+<P><img src="images/edit_job_vdub.gif" />/P>
+<P>Let's ignore the 2 checkboxes at the
+top for a moment. What you will need to do is to specify the path to
+the 2 .vcf files you created previously in VirtualDub in step 1. Then
+you need to specify the suffix (or the file using the file-chooser)
+so that VDub knows where to save the encoded videos.</P>
+<H2>Step 4: Run the plug-in</H2>
+<UL>
+ <LI><P>If you had your job recorded
+ (without using the plug-in) then the status of the job will already
+ be “<B>done”</B> and you can right-click the job and run
+ the VirtualDub plug-in</P>
+ <LI><P>If the job has <B>not</B> been
+ recorded yet, just click on Start processing and wait for the result</P>
+</UL>
+<H2>Additional information</H2>
+<H3>Empty VCF paths</H3>
+<P>As you know you can specify any
+number in the <B>preferences dialog</B> for the setting <B>max number
+of VCFs per job</B>. In case of our example that consists of 2 jobs,
+if you selected 3 (or more) as max. number, and then opened the <B>job
+dialog</B>, you would see 3 fields each for the <B>path to VCF file</B>
+and <B>output file</B> setting. This, however, is not a problem. The
+plug-in will only execute those VCF jobs for which both the path to
+the VCF and the output file fields are filled with proper
+information.</P>
+<H3>VDub job control</H3>
+<P>You still don't know what the 2
+checkboxes in the <B>job dialog</B> at the top of the VDub settings
+mean. What you need to know is that VirtualDub is having its own “job
+queue”, which, however, is called <B>“job control”</B>.</P>
+<P>The following scenarios can make
+sense:</P>
+<UL>
+ <LI><P>Having <B>both</B> checkboxes
+ <B>enabled</B>: Each time a new NDR job is executed which has
+ VirtualDub jobs, the <B>job control</B> of VirtualDub will be
+ cleared. This means that if you had other, old things in there
+ (possibly when working with VirtualDub outside of the NDR) that
+ these will be deleted from VirtualDub's job control, before the new
+ jobs are added there. Checking the second checkbox means that after
+ adding one of the VirtualDub jobs from within the the NDR,
+ VirtualDub will actually encode them right away (which you will
+ want, at least under normal circumstances).</P>
+ <LI><P>Having <B>both</B> checkboxes
+ <B>disabled</B>: In this case the only thing the NDR would do would
+ be to add the two jobs to the job control of VirtualDub, but
+ VirtualDub won't be encoding them. They are just put into the queue.
+ This means that if you were to start the the graphical user
+ interface of VirtualDub after the NDR completed processing, and open
+ the Job Control (F4), you'd see these jobs “waiting”,
+ and you could render them by pressing the Start button in Virtual
+ Dub.</P>
+</UL>
+<P>The reason why these checkboxes exist
+is flexibility. I often want the NDR to record stuff over night,
+because during the recording process my PC is virtually unusable.
+However, encoding clips in VirtualDub is a task that, depending on
+the codec, can be done in the background and allows me to use the PC
+for other things. In this case I'd disable both checkboxes, have the
+NDR record all clips and add them to VirtualDub's job control, and
+then on the next day, I decide when and which jobs to encode into
+different formats from within the VirtualDub GUI.</P>
+<P>And btw, just to be clear, the <B>second</B>
+checkbox means that, <B>when enabled</B>, VirtualDub would actually
+start encoding <U><B>all</B></U> clips that have already been in
+VirtualDub's job control and that have not been encoded yet.</P>
+<H3>Extra options</H3>
+<P>If you selected the <B>show extra
+options</B> checkbox in the <B>preferences dialog</B>, you will
+notice that, in the <B>job dialog</B>, you got 2 additional
+settings/checkboxes for each VCF file. Their names are pretty much
+self-explanatory. I added these checkboxes because, after a scene was
+rendered, I usually have the clip encoded into a loss-less format
+(e.g. Huffyuv) right away. Since it is no problem to encode further
+things (e.g. compressed XviD movies) based on the Huffyuv clip
+(instead of always using the original avi file), enabling both these
+checkboxes for VCF 1 would mean that the 2<SUP>nd</SUP> (3<SUP>rd</SUP>,
+4<SUP>th</SUP> …) VCF jobs will be based on the
+huffyuv-encoded file, and I got rid of original, big video as well,
+saving hard disk space.</P>
+<H3>Trouble shooting</H3>
+<P>In case you suspect that the
+expected, encoded file(s) is somehow incorrect (or even missing),
+have a look at the <B>logs</B> directory in the NDR folder. You will
+see log-files with the following format:</P>
+<P>VirtualDub_NameOfTheJob_vcf1.log</P>
+<P>Instead of “vcf1” you
+might also find “vcf2”, “vcf3”... it
+specifies for which VCF file of that job the log file stands for.</P>
+<P><BR><BR>
+</P>
+ </body>
+</html>
+
projects / xonotic / xonotic.git / blobdiff