doc/user/defaults/index.xml

   1 <?xml version="1.0"?>
   2
   3 <!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V3.1.4//EN"
   4         "file:///usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd">
   5
   6 <chapter id="user-defaults">
   7   <title>Default Settings</title>
   8
   9 <p>ALE offers five different default settings, each of which emphasizes
  10 image quality, speed, or some other rendering characteristic, as follows:</p>
  11
  12 <ll>--q0              Low quality, high speed. [default]
  13 --qn              Low noise, moderate speed.
  14 --q1              Moderate quality and speed.
  15 --q2              High quality, low speed.
  16 --qr              Range-extended high quality.
  17 </ll>
  18
  19 <p>These settings specify defaults for other options: <l>--dchain</l>,
  20 <l>--achain</l>, <l>--3d-chain</l>, <l>--ips</l>, <l>--exp-extend</l>, and
  21 <l>--cx</l>.  For more information about these options, see <xref
  22 linkend="user-alignment"/>, <xref linkend="user-rendering"/>, and <xref
  23 linkend="user-3d"/>.  Details regarding these defaults are provided in the
  24 following sections.</p>
  25
  26 <s><t>High speed (--q0)</t>
  27
  28 <code>--q0</code> emphasizes speed over image quality.  This option is default, and
  29 sets other options' defaults as follows:
  30
  31 <ll>
  32    --dchain fine:box:1,triangle:2
  33    --achain triangle:2
  34    --ips 0
  35    --exp-noextend
  36    --no-cx
  37    --3d-chain fine:box:1,triangle:2
  38 </ll>
  39
  40 </s>
  41 <s><t>Low noise (--qn)</t>
  42
  43 <code>--qn</code> emphasizes low noise over resolution and rendering speed, and
  44 sets the following defaults:
  45
  46 <ll>
  47    --dchain sinc*lanc:6
  48    --achain sinc*lanc:6
  49    --ips 0
  50    --exp-noextend
  51    --no-cx
  52    --3d-chain sinc*lanc:6
  53 </ll>
  54
  55 </s>
  56
  57 <s><t>Balanced quality and speed (--q1)</t>
  58
  59 <code>--q1</code> balances image quality and rendering speed, offering higher
  60 resolution than <code>--qn</code>.  In versions 0.8.1 and later, this option
  61 uses median values, which can be very memory-intensive to calculate.
  62
  63 <ll>
  64    --dchain median:fine:sinc*lanc:8,triangle:2
  65    --achain triangle:2
  66    --ips 0
  67    --exp-noextend
  68    --no-cx
  69    --3d-chain median:fine:sinc*lanc:8,triangle:2
  70 </ll>
  71
  72 </s>
  73
  74 <s><t>High quality (--q2)</t>
  75
  76 <p><l>--q2</l> favors image quality over rendering speed, offering greater
  77 emphasis for high-frequency details than <l>--q0</l>, <l>--qn</l>,
  78 or <l>--q1</l>.  It depends on the <l>--lpsf</l> and
  79 <l>--nlpsf</l> options, which can be set indirectly via the
  80 <l>--device</l> option.  (More information about these options can be
  81 found in <xref linkend="user-psf"/> and <xref linkend="user-device"/>.)  <l>--q2</l>
  82 sets the following defaults:</p>
  83
  84 <ll>
  85    --dchain triangle:2
  86    --achain triangle:2
  87    --ips 4
  88    --exp-noextend
  89    --no-cx
  90    --3d-chain median:fine:sinc*lanc:8,triangle:2
  91 </ll>
  92
  93 </s>
  94
  95 <s><t>Range extension (--qr)</t>
  96
  97 <p><code>--qr</code> is similar to <code>--q2</code>, but offers improved
  98 rendering when input images have been taken with unequal exposures.  In other
  99 cases, it might exacerbate noise in light and dark regions, and so should not
 100 be used.  This option sets the following defaults:</p>
 101
 102 <ll>
 103    --dchain triangle:2
 104    --achain triangle:2
 105    --ips 6
 106    --exp-extend
 107    --cx 0.7
 108    --3d-chain median:fine:sinc*lanc:8,triangle:2
 109 </ll>
 110
 111 </s>
 112
 113
 114 </chapter>