misc/tools/NexuizDemoRecorder/main/src/main/resources/help/html/apply_templates.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
   2
   3 <html>
   4   <head>
   5     <meta name="generator" content="HTML Tidy, see www.w3.org">
   6
   7     <title></title>
   8   </head>
   9
  10   <body>
  11 <H1>Applying templates</H1>
  12 <P>Since version 0.3 you are able to
  13 selectively apply settings from a template of your choice to any job
  14 you like. One reason might be that you want jobs that have already
  15 been recorded to be recorded using different config settings (e.g.
  16 other quality settings, resolution, etc.). If you wanted to do this
  17 for many jobs at once, it would be very tedious to edit each job
  18 manually, setting up changes.</P>
  19 <P>You can apply properties of templates
  20 very easily:</P>
  21 <UL>
  22         <LI><P>Select the template you want to
  23         use</P>
  24         <LI><P>Select the job(s) whose
  25         properties you want to be affected by the template</P>
  26         <LI><P>Right-click inside the jobs
  27         table and select &ldquo;Apply template&rdquo;</P>
  28         <LI><P>A new dialog will open where you
  29         will be able to select which one of the settings should be copied
  30         from the template to the job. Please, be aware that old settings of
  31         the job will be overwritten!</P>
  32         <LI><P>Usually the settings will be
  33         copied 1:1 from the template to the job. <B>There are 2 exceptions,
  34         though</B>:</P>
  35         <UL>
  36                 <LI><P><B>Demo directory:</B> Here
  37                 copying the value from the template to the job would not make
  38                 sense, because in a template you actually specified a <B>directory</B>,
  39                 <U>not</U> a <B>file</B>. However, a job needs to point at a <B>file</B>.
  40                 What will happen shall be demonstrated by the following example:
  41                 Let's say that the job's path to the demo file (before applying the
  42                 template) has been <B>C:\Nexuiz\data\demos\mydemo.dem</B>
  43                 and the path setup in the template has been pointing to the
  44                 directory<B> C:\Games\Nexuiz2.5.2\data\demos</B>.
  45                 The new demo file path, after the &ldquo;apply&rdquo; process is
  46                 done, would be <B>C:\Games\Nexuiz2.5.2\data\demos\mydemo.dem</B>;
  47                 this means that from the <B>job's</B>
  48                 demo path the program will just take the name of the demo by itself
  49                 (mydemo.dem), and put the path from the <B>template</B>
  50                 in front of it</P>
  51                 <LI><P><b>Video
  52                 destination:</b> Here the same thing happens like for the Demo
  53                 directory. The new video destination will be &lt;Directory set up
  54                 in the template&gt; + &lt;just the filename of the setting of the
  55                 job&gt;</P>
  56         </UL>
  57 </UL>
  58 <P>Another example of how this feature could be useful is this one: Suppose some
  59 movie maker was to create a community movie with frags from different
  60 people, or a movie maker was to continue or finish a movie from
  61 someone else. If one person creates a queue of jobs (which naturally
  62 includes the demo's names, start second and end second) and then
  63 decides not to record the frags herself but send it to some other
  64 movie maker, all that needs to be done is to save the job queue and
  65 send it to the other movie maker, together with the demos. The other
  66 movie maker can then copy the demos into his own demo directory and
  67 import the job queue. Of course the problem would then be that all
  68 these imported jobs could not really be executed right away, because
  69 all these paths might be incorrect, I mean, would simply not exist or
  70 match to the system of the movie maker who wants to record the jobs
  71 (e.g. path to Nexuiz engine or demo directory). But this can easily
  72 be fixed. The movie maker just needs to select the imported jobs and
  73 apply one of her own templates to them, and by doing so, fix all
  74 incorrect paths.</P>
  75   </body>
  76 </html>
  77